import {z} from 'zod'

export type Scope = {org_id: string, user_id?: (string | null) | undefined, session_id?: (string | null) | undefined};

export type RecallRequest = {scope: string | Scope, session_id?: (string | null) | undefined, q: string, mode?: ('active' | 'deep') | undefined, top_k?: (number | null) | undefined, min_score?: (number | null) | undefined, include_timeline?: boolean | undefined, agent_id?: (string | null) | undefined, probable_answer?: boolean | undefined};

export type CreateApiRecallArgs = {body: RecallRequest};

export type CreateApiRecallOptions = {baseUrl: string, HTTPBearer?: string | undefined, fetch?: typeof fetch | undefined};

export const recallHit = z.object({id: z.string().nullable().optional(), text: z.string(), score: z.number(), kind: z.enum(["turn", "observation", "entity"]).optional(), timestamp: z.string().nullable().optional(), timestamp_ms: z.number().int().nullable().optional(), time_uncertain: z.boolean().optional()});

export const recallEntity = z.object({id: z.string().nullable().optional(), label: z.string(), score: z.number()});

export const recallHits = z.object({observations: z.array(recallHit).optional(), turns: z.array(recallHit).optional(), entities: z.array(recallEntity).optional()});

export const usage = z.object({tokens_in: z.number().int().optional(), tokens_out: z.number().int().optional()});

export const probableAnswerAlternative = z.object({id: z.string(), probability: z.number().gte(0).lte(1)});

export const probableAnswer = z.object({id: z.string(), text: z.string(), timestamp: z.string().nullable().optional(), probability: z.number().gte(0).lte(1), question_time: z.enum(["current", "past", "date", "ever", "future", "timeless"]), alternatives: z.array(probableAnswerAlternative).optional()});

export const recallResponse = z.object({hits: recallHits, timeline: z.string().nullable().optional(), confidence: z.number().gte(0).lte(1), mode: z.enum(["active", "deep"]), usage: usage.nullable().optional(), active_tier_error: z.string().nullable().optional(), deep_tier_error: z.string().nullable().optional(), probable_answer: probableAnswer.nullable().optional(), probable_answer_reason: z.enum(["no_memory_answers", "unavailable", "not_enabled"]).nullable().optional()});

export const validateResponse = async <Output>(
  schema: {
    readonly '~standard': {
      readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray<PropertyKey | { readonly key: PropertyKey }> | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray<PropertyKey | { readonly key: PropertyKey }> | undefined }> }>
    }
  },
  value: unknown
): Promise<Output> => {
  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
};

/**
 * Verb-shaped agent retrieval — active or deep mode
 * 
 * POST /recall
 */
export const createApiRecall = async (args: CreateApiRecallArgs, options: CreateApiRecallOptions) => {
const {baseUrl, fetch: fetchFn = fetch, HTTPBearer} = options ?? {}

const query = new URLSearchParams()
const headers = new Headers()
headers.set('content-type', "application/json")
headers.set('accept', "application/json")

if (HTTPBearer !== undefined) headers.set('authorization', `Bearer ${HTTPBearer}`)

const url = `${baseUrl.replace(/\/+$/, '')}/recall${query.size > 0 ? `?${query}` : ''}`

const res = await fetchFn(url, {method: "POST", headers, body: JSON.stringify(args.body)})

if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}})

return validateResponse(recallResponse, await res.json())
};