import {z} from 'zod' export type GetApiV1ChatForecastArgs = {query: string, lookback?: number | undefined, articles_to_use?: number | undefined, method?: 'kw' | undefined, model?: ('gpt-4o' | 'gpt-4o-mini' | 'gpt-4.1-2025-04-14' | 'claude-3-5-sonnet-latest' | 'claude-3-5-sonnet-20240620' | 'claude-sonnet-4-20250514' | 'claude-opus-4-20250514' | 'claude-sonnet-4-5-20250929' | 'claude-opus-4-6' | 'claude-sonnet-4-6' | 'claude-sonnet-5' | 'o1-mini' | 'o3-mini' | 'o3') | undefined, cutoff_date?: (string | null) | undefined, use_reddit?: boolean | undefined, additional_context?: (string | null) | undefined, web_search?: boolean | undefined, expert?: ('general' | 'sports') | undefined}; export type GetApiV1ChatForecastOptions = {baseUrl?: string | undefined, APIKey?: string | undefined, fetch?: typeof fetch | undefined}; export const entities = z.object({Person: z.array(z.string()).optional(), Organization: z.array(z.string()).optional(), Location: z.array(z.string()).optional(), Nationality: z.array(z.string()).optional(), Date: z.array(z.string()).optional(), Event: z.array(z.string()).optional(), Money: z.array(z.string()).optional(), Law: z.array(z.string()).optional(), Quantity: z.array(z.string()).optional(), Time: z.array(z.string()).optional(), Sports: z.array(z.string()).optional(), Politics: z.array(z.string()).optional(), Title: z.array(z.string()).optional(), Number: z.array(z.string()).optional(), Arms: z.array(z.string()).optional(), Product: z.array(z.string()).optional(), Media: z.array(z.string()).optional(), Transportation: z.array(z.string()).optional(), Religion: z.array(z.string()).optional(), Technology: z.array(z.string()).optional(), Space: z.array(z.string()).optional(), Medicine: z.array(z.string()).optional(), Language: z.array(z.string()).optional(), Science: z.array(z.string()).optional()}); export const asknewsApiSchemaV1CommonGraphRelationships = z.object({nodes: z.array(z.record(z.string(), z.string())).optional(), edges: z.array(z.record(z.string(), z.string())).optional()}); export const geoCoordinate = z.object({latitude: z.number(), longitude: z.number(), metadata: z.record(z.string(), z.unknown())}); export const assets = z.object({images: z.array(z.string()).nullable().optional(), videos: z.array(z.string()).nullable().optional()}); export const author = z.object({email: z.string().nullable().optional(), name: z.string().nullable().optional(), url: z.string().nullable().optional()}); export const wikidataEntity = z.object({title: z.string(), qid: z.string(), relevance: z.number(), description: z.string().nullable().optional(), source_mention: z.string().nullable().optional(), source_mentions: z.array(z.string()).nullable().optional()}); export const searchResponseDictItem = z.object({article_url: z.string().min(1).max(2083), article_id: z.string(), classification: z.union([z.array(z.string()), z.string()]), country: z.string(), source_id: z.string(), page_rank: z.number().int(), domain_url: z.string(), eng_title: z.string(), entities: entities, image_url: z.string().nullable().optional(), keywords: z.array(z.string()), language: z.string(), pub_date: z.string(), summary: z.string(), key_points: z.array(z.string()).nullable().optional(), title: z.string(), sentiment: z.number().int(), centroid_distance: z.number().nullable().optional(), cluster_probability: z.number().nullable().optional(), markdown_citation: z.string().optional(), provocative: z.enum(["unknown", "low", "medium", "high"]).optional(), reporting_voice: z.union([z.enum(["Objective", "Subjective", "Investigative", "Narrative", "Analytical", "Advocacy", "Conversational", "Satirical", "Emotive", "Explanatory", "UnknownPersuasive", "Sensational"]), z.string()]).optional(), entity_relation_graph: asknewsApiSchemaV1CommonGraphRelationships.nullable().optional(), geo_coordinates: z.record(z.string(), geoCoordinate).nullable().optional(), continent: z.enum(["Africa", "Asia", "Europe", "Middle East", "North America", "South America", "Oceania"]).nullable().optional(), assets: assets.nullable().optional(), social_embeds: z.array(z.string()).nullable().optional(), bias: z.enum(["Political", "Gender", "Cultural", "Age", "Religious", "Statement", "Illogical Claims", "Slant", "Source Selection", "Omission of Source Attribution", "Spin", "Sensationalism", "Negativity", "Subjective Adjectives", "Ad Hominem", "Mind Reading", "Opinion-as-Fact", "None", "Unknown"]).nullable().optional(), authors: z.array(author).nullable().optional(), wikidata_entities: z.record(z.string(), z.array(wikidataEntity)).nullable().optional(), full_text: z.string().nullable().optional(), original_language_summary: z.string().nullable().optional(), image_description: z.string().nullable().optional(), crawl_date: z.string().nullable().optional(), content_type: z.enum(["news", "opinion", "analysis", "review", "listicle", "guide", "interview", "profile", "forum", "liveblog", "fact-check", "press_release", "obituary", "data_journalism"]).nullable().optional(), as_string_key: z.string()}); export const webSearchResult = z.object({title: z.string(), url: z.string().min(1).max(2083), source: z.string(), published: z.string(), key_points: z.array(z.string()), raw_text: z.string().optional(), as_string_key: z.string().nullable().optional()}); export const keyPerson = z.object({name: z.string(), role: z.string()}); export const forecastResponse = z.object({forecast: z.string(), resolution_criteria: z.string(), date: z.string(), reasoning: z.string(), sources: z.array(searchResponseDictItem), timeline: z.array(z.string()), opposite_request: z.string(), confidence: z.number(), choice: z.union([z.boolean(), z.string()]), llm_confidence: z.number().int(), model_used: z.string(), likelihood: z.string(), probability: z.number().int(), web_search_results: z.array(webSearchResult), summary: z.string(), key_people: z.array(keyPerson), key_facets: z.array(z.string()), reconciled_information: z.string(), candidate_models: z.array(z.string()), unique_information: z.string(), expert_information: z.record(z.string(), z.unknown()).optional()}); export const validateResponse = async ( schema: { readonly '~standard': { readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }> } }, value: unknown ): Promise => { const result = await schema['~standard'].validate(value) if (result.issues !== undefined) { const detail = result.issues .map(({ message, path }) => path?.length ? `${path.map((segment) => String(typeof segment === 'object' ? segment.key : segment)).join('.')}: ${message}` : message ) .join('; ') throw new Error(`Response does not match the schema: ${detail}`, { cause: { issues: result.issues } }) } return result.value }; /** * Make an expert forecast for a news event. * * GET /v1/chat/forecast */ export const getApiV1ChatForecast = async (args: GetApiV1ChatForecastArgs, options?: GetApiV1ChatForecastOptions) => { const {baseUrl = "https://api.asknews.app", fetch: fetchFn = fetch, APIKey} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args.query != null) query.append("query", String(args.query)) if (args.lookback != null) query.append("lookback", String(args.lookback)) if (args.articles_to_use != null) query.append("articles_to_use", String(args.articles_to_use)) if (args.method != null) query.append("method", String(args.method)) if (args.model != null) query.append("model", String(args.model)) if (args.cutoff_date != null) query.append("cutoff_date", String(args.cutoff_date)) if (args.use_reddit != null) query.append("use_reddit", String(args.use_reddit)) if (args.additional_context != null) query.append("additional_context", String(args.additional_context)) if (args.web_search != null) query.append("web_search", String(args.web_search)) if (args.expert != null) query.append("expert", String(args.expert)) if (APIKey !== undefined) headers.set("Authorization", APIKey) const url = `${baseUrl.replace(/\/+$/, '')}/v1/chat/forecast${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "GET", headers}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(forecastResponse, await res.json()) };