@finalai/agent-protocol 0.1.0

package/dist/modules/agent-platform/sessions.d.mts

@@ -0,0 +1,494 @@
+import * as z from 'zod';
+import { AcpFrameDirection, AcpPreviewKind, AgentSessionState, AgentTurnPolicy, PendingEventState, PendingRequestKind } from "./enums.mjs";
+/**
+ * One ACP session config option (model, thought level, mode, ...). ACP v2 keys
+ * options by `configId`; `id` is the older spelling. Every other field (type,
+ * category, options) is kept loosely for clients to read.
+ */
+export declare const sessionConfigOptionSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    configId: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    currentValue: z.ZodOptional<z.ZodType<import("./index.mjs").JsonValue, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonValue, unknown>>>;
+}, z.core.$loose>;
+export declare const sessionSchema: z.ZodObject<{
+    id: z.ZodString;
+    organizationId: z.ZodString;
+    agentId: z.ZodString;
+    revisionId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    ownerUserId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    conversationId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    participantId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    state: z.ZodUnion<readonly [z.ZodEnum<typeof AgentSessionState>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<import("./index.mjs").WireFallback, unknown>>]>;
+    turnPolicy: z.ZodUnion<readonly [z.ZodEnum<typeof AgentTurnPolicy>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<import("./index.mjs").WireFallback, unknown>>]>;
+    title: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    headSeq: z.ZodDefault<z.ZodNumber>;
+    configOptions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        configId: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        currentValue: z.ZodOptional<z.ZodType<import("./index.mjs").JsonValue, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonValue, unknown>>>;
+    }, z.core.$loose>>>;
+    lastPromptAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    closedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type AgentSessionIface = z.infer<typeof sessionSchema>;
+/**
+ * `GET /v1/sessions/:id/manifest`: what the session was given: the
+ * revision's manifest with its dynamic slots resolved, and the resolver
+ * report (each slot's resolved value, compatibility notes). Null fields
+ * before the session's first open resolved them.
+ */
+export declare const sessionManifestSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    revisionId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    resolvedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    manifest: z.ZodDefault<z.ZodNullable<z.ZodType<import("./index.mjs").JsonObjectIface, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonObjectIface, unknown>>>>;
+    report: z.ZodDefault<z.ZodNullable<z.ZodType<import("./index.mjs").JsonObjectIface, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonObjectIface, unknown>>>>;
+}, z.core.$strip>;
+export type SessionManifestIface = z.infer<typeof sessionManifestSchema>;
+export declare const turnSchema: z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    promptMessageId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    startedAt: z.ZodString;
+    endedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    stopReason: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    fromSeq: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    toSeq: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    inputTokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    outputTokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+export type AgentTurnIface = z.infer<typeof turnSchema>;
+/** A prompt the session accepted (ACP insertion semantics: not the end of the turn). */
+export declare const promptAcceptedSchema: z.ZodObject<{
+    messageId: z.ZodString;
+    turnId: z.ZodString;
+    fromSeq: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+export type PromptAcceptedIface = z.infer<typeof promptAcceptedSchema>;
+/** One logged ACP frame: the `acp.frame` realtime payload and a replay row. */
+export declare const acpFrameEventSchema: z.ZodObject<{
+    seq: z.ZodNumber;
+    frame: z.ZodObject<{
+        jsonrpc: z.ZodOptional<z.ZodString>;
+        id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>;
+        method: z.ZodOptional<z.ZodString>;
+        params: z.ZodOptional<z.ZodType<import("./index.mjs").JsonValue, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonValue, unknown>>>;
+        result: z.ZodOptional<z.ZodType<import("./index.mjs").JsonValue, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonValue, unknown>>>;
+        error: z.ZodOptional<z.ZodObject<{
+            code: z.ZodNumber;
+            message: z.ZodString;
+            data: z.ZodOptional<z.ZodType<import("./index.mjs").JsonValue, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonValue, unknown>>>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>;
+    direction: z.ZodUnion<readonly [z.ZodEnum<typeof AcpFrameDirection>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<import("./index.mjs").WireFallback, unknown>>]>;
+    at: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    pendingId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type AcpFrameEventIface = z.infer<typeof acpFrameEventSchema>;
+/** Provisional full frame; `streamId` scopes its seq until the durable stream confirms it. */
+export declare const acpLiveFrameEventSchema: z.ZodObject<{
+    seq: z.ZodNumber;
+    frame: z.ZodObject<{
+        jsonrpc: z.ZodOptional<z.ZodString>;
+        id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>;
+        method: z.ZodOptional<z.ZodString>;
+        params: z.ZodOptional<z.ZodType<import("./index.mjs").JsonValue, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonValue, unknown>>>;
+        result: z.ZodOptional<z.ZodType<import("./index.mjs").JsonValue, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonValue, unknown>>>;
+        error: z.ZodOptional<z.ZodObject<{
+            code: z.ZodNumber;
+            message: z.ZodString;
+            data: z.ZodOptional<z.ZodType<import("./index.mjs").JsonValue, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonValue, unknown>>>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>;
+    direction: z.ZodUnion<readonly [z.ZodEnum<typeof AcpFrameDirection>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<import("./index.mjs").WireFallback, unknown>>]>;
+    at: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    pendingId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    streamId: z.ZodString;
+}, z.core.$strip>;
+export type AcpLiveFrameEventIface = z.infer<typeof acpLiveFrameEventSchema>;
+/** Discard provisional state after a lost writer/stream; null means the durable head is unknown. */
+export declare const acpLiveResetEventSchema: z.ZodObject<{
+    streamId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    throughSeq: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    reason: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type AcpLiveResetEventIface = z.infer<typeof acpLiveResetEventSchema>;
+/** `acp.preview`: low-latency text ahead of the durable frames (voice, typing previews). */
+export declare const acpPreviewEventSchema: z.ZodObject<{
+    seq: z.ZodNumber;
+    text: z.ZodString;
+    previewKind: z.ZodDefault<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<typeof AcpPreviewKind>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<import("./index.mjs").WireFallback, unknown>>]>>>;
+    messageId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    turnId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type AcpPreviewEventIface = z.infer<typeof acpPreviewEventSchema>;
+export declare const permissionOptionSchema: z.ZodObject<{
+    optionId: z.ZodString;
+    name: z.ZodString;
+    kind: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type PermissionOptionIface = z.infer<typeof permissionOptionSchema>;
+export declare const pendingRequestDetailSchema: z.ZodObject<{
+    title: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    body: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    options: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        optionId: z.ZodString;
+        name: z.ZodString;
+        kind: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+    schema: z.ZodDefault<z.ZodNullable<z.ZodType<import("./index.mjs").JsonValue, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonValue, unknown>>>>;
+    mode: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    url: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    toolCall: z.ZodDefault<z.ZodNullable<z.ZodType<import("./index.mjs").JsonValue, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonValue, unknown>>>>;
+}, z.core.$strip>;
+export declare const pendingRequestSchema: z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    turnId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    conversationId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    kind: z.ZodUnion<readonly [z.ZodEnum<typeof PendingRequestKind>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<import("./index.mjs").WireFallback, unknown>>]>;
+    request: z.ZodObject<{
+        title: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        body: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        options: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            optionId: z.ZodString;
+            name: z.ZodString;
+            kind: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>>;
+        schema: z.ZodDefault<z.ZodNullable<z.ZodType<import("./index.mjs").JsonValue, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonValue, unknown>>>>;
+        mode: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        url: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        toolCall: z.ZodDefault<z.ZodNullable<z.ZodType<import("./index.mjs").JsonValue, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonValue, unknown>>>>;
+    }, z.core.$strip>;
+    audienceParticipantIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    audienceUserIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    logSeq: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    createdAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    expiresAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    resolvedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    resolvedByUserId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    outcome: z.ZodDefault<z.ZodNullable<z.ZodType<import("./index.mjs").JsonValue, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonValue, unknown>>>>;
+}, z.core.$strip>;
+export type PendingRequestIface = z.infer<typeof pendingRequestSchema>;
+export declare const acpPendingEventSchema: z.ZodObject<{
+    pending: z.ZodObject<{
+        id: z.ZodString;
+        sessionId: z.ZodString;
+        turnId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        conversationId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        kind: z.ZodUnion<readonly [z.ZodEnum<typeof PendingRequestKind>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<import("./index.mjs").WireFallback, unknown>>]>;
+        request: z.ZodObject<{
+            title: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            body: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            options: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                optionId: z.ZodString;
+                name: z.ZodString;
+                kind: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>>;
+            schema: z.ZodDefault<z.ZodNullable<z.ZodType<import("./index.mjs").JsonValue, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonValue, unknown>>>>;
+            mode: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            url: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            toolCall: z.ZodDefault<z.ZodNullable<z.ZodType<import("./index.mjs").JsonValue, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonValue, unknown>>>>;
+        }, z.core.$strip>;
+        audienceParticipantIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        audienceUserIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        logSeq: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        createdAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        expiresAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        resolvedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        resolvedByUserId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        outcome: z.ZodDefault<z.ZodNullable<z.ZodType<import("./index.mjs").JsonValue, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonValue, unknown>>>>;
+    }, z.core.$strip>;
+    state: z.ZodUnion<readonly [z.ZodEnum<typeof PendingEventState>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<import("./index.mjs").WireFallback, unknown>>]>;
+}, z.core.$strip>;
+export type AcpPendingEventIface = z.infer<typeof acpPendingEventSchema>;
+export declare const sessionStateEventSchema: z.ZodObject<{
+    state: z.ZodUnion<readonly [z.ZodEnum<typeof AgentSessionState>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<import("./index.mjs").WireFallback, unknown>>]>;
+    turnId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    stopReason: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type SessionStateEventIface = z.infer<typeof sessionStateEventSchema>;
+export declare const createSessionResponseSchema: z.ZodObject<{
+    session: z.ZodObject<{
+        id: z.ZodString;
+        organizationId: z.ZodString;
+        agentId: z.ZodString;
+        revisionId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        ownerUserId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        conversationId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        participantId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        state: z.ZodUnion<readonly [z.ZodEnum<typeof AgentSessionState>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<import("./index.mjs").WireFallback, unknown>>]>;
+        turnPolicy: z.ZodUnion<readonly [z.ZodEnum<typeof AgentTurnPolicy>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<import("./index.mjs").WireFallback, unknown>>]>;
+        title: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        headSeq: z.ZodDefault<z.ZodNumber>;
+        configOptions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            configId: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            category: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            currentValue: z.ZodOptional<z.ZodType<import("./index.mjs").JsonValue, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonValue, unknown>>>;
+        }, z.core.$loose>>>;
+        lastPromptAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        closedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>;
+    turn: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        messageId: z.ZodString;
+        turnId: z.ZodString;
+        fromSeq: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type CreateSessionResponseIface = z.infer<typeof createSessionResponseSchema>;
+/** Seq of a session's first logged frame; the log is dense from here. */
+export declare const FIRST_ACP_FRAME_SEQ = 1;
+/**
+ * `GET /sessions/:id/frames?fromSeq&limit`: `fromSeq` is inclusive and clamped
+ * to `FIRST_ACP_FRAME_SEQ`; `hasMore` is set while the page is full and ends
+ * before `headSeq`.
+ */
+export declare const sessionFramesPageSchema: z.ZodObject<{
+    frames: z.ZodArray<z.ZodObject<{
+        seq: z.ZodNumber;
+        frame: z.ZodObject<{
+            jsonrpc: z.ZodOptional<z.ZodString>;
+            id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>;
+            method: z.ZodOptional<z.ZodString>;
+            params: z.ZodOptional<z.ZodType<import("./index.mjs").JsonValue, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonValue, unknown>>>;
+            result: z.ZodOptional<z.ZodType<import("./index.mjs").JsonValue, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonValue, unknown>>>;
+            error: z.ZodOptional<z.ZodObject<{
+                code: z.ZodNumber;
+                message: z.ZodString;
+                data: z.ZodOptional<z.ZodType<import("./index.mjs").JsonValue, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonValue, unknown>>>;
+            }, z.core.$loose>>;
+        }, z.core.$loose>;
+        direction: z.ZodUnion<readonly [z.ZodEnum<typeof AcpFrameDirection>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<import("./index.mjs").WireFallback, unknown>>]>;
+        at: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        pendingId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    headSeq: z.ZodDefault<z.ZodNumber>;
+    hasMore: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type SessionFramesPageIface = z.infer<typeof sessionFramesPageSchema>;
+export declare const pendingRequestListSchema: z.ZodObject<{
+    pending: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        sessionId: z.ZodString;
+        turnId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        conversationId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        kind: z.ZodUnion<readonly [z.ZodEnum<typeof PendingRequestKind>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<import("./index.mjs").WireFallback, unknown>>]>;
+        request: z.ZodObject<{
+            title: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            body: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            options: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                optionId: z.ZodString;
+                name: z.ZodString;
+                kind: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>>;
+            schema: z.ZodDefault<z.ZodNullable<z.ZodType<import("./index.mjs").JsonValue, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonValue, unknown>>>>;
+            mode: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            url: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            toolCall: z.ZodDefault<z.ZodNullable<z.ZodType<import("./index.mjs").JsonValue, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonValue, unknown>>>>;
+        }, z.core.$strip>;
+        audienceParticipantIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        audienceUserIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        logSeq: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        createdAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        expiresAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        resolvedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        resolvedByUserId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        outcome: z.ZodDefault<z.ZodNullable<z.ZodType<import("./index.mjs").JsonValue, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonValue, unknown>>>>;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type PendingRequestListIface = z.infer<typeof pendingRequestListSchema>;
+export declare const respondPendingResponseSchema: z.ZodObject<{
+    resolved: z.ZodBoolean;
+}, z.core.$strip>;
+export type RespondPendingResponseIface = z.infer<typeof respondPendingResponseSchema>;
+export declare const createSessionRequestSchema: z.ZodObject<{
+    agent: z.ZodString;
+    revisionId: z.ZodOptional<z.ZodString>;
+    message: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+        _meta: z.ZodOptional<z.ZodType<import("./index.mjs").JsonObjectIface, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonObjectIface, unknown>>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"image">;
+        data: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodString;
+        uri: z.ZodOptional<z.ZodString>;
+        _meta: z.ZodOptional<z.ZodType<import("./index.mjs").JsonObjectIface, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonObjectIface, unknown>>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"audio">;
+        data: z.ZodString;
+        mimeType: z.ZodString;
+        _meta: z.ZodOptional<z.ZodType<import("./index.mjs").JsonObjectIface, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonObjectIface, unknown>>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"resource_link">;
+        uri: z.ZodString;
+        name: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+        _meta: z.ZodOptional<z.ZodType<import("./index.mjs").JsonObjectIface, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonObjectIface, unknown>>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"resource">;
+        resource: z.ZodObject<{
+            uri: z.ZodString;
+            mimeType: z.ZodOptional<z.ZodString>;
+            text: z.ZodOptional<z.ZodString>;
+            blob: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        _meta: z.ZodOptional<z.ZodType<import("./index.mjs").JsonObjectIface, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonObjectIface, unknown>>>;
+    }, z.core.$strict>], "type">>]>>;
+    turnPolicy: z.ZodOptional<z.ZodEnum<typeof AgentTurnPolicy>>;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    meta: z.ZodOptional<z.ZodType<import("./index.mjs").JsonObjectIface, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonObjectIface, unknown>>>;
+    clientSubmittedAtMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type CreateSessionRequestIface = z.infer<typeof createSessionRequestSchema>;
+export declare const forkSessionRequestSchema: z.ZodObject<{
+    idempotencyKey: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ForkSessionRequestIface = z.infer<typeof forkSessionRequestSchema>;
+export declare const promptSessionRequestSchema: z.ZodObject<{
+    content: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+        _meta: z.ZodOptional<z.ZodType<import("./index.mjs").JsonObjectIface, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonObjectIface, unknown>>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"image">;
+        data: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodString;
+        uri: z.ZodOptional<z.ZodString>;
+        _meta: z.ZodOptional<z.ZodType<import("./index.mjs").JsonObjectIface, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonObjectIface, unknown>>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"audio">;
+        data: z.ZodString;
+        mimeType: z.ZodString;
+        _meta: z.ZodOptional<z.ZodType<import("./index.mjs").JsonObjectIface, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonObjectIface, unknown>>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"resource_link">;
+        uri: z.ZodString;
+        name: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+        _meta: z.ZodOptional<z.ZodType<import("./index.mjs").JsonObjectIface, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonObjectIface, unknown>>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"resource">;
+        resource: z.ZodObject<{
+            uri: z.ZodString;
+            mimeType: z.ZodOptional<z.ZodString>;
+            text: z.ZodOptional<z.ZodString>;
+            blob: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        _meta: z.ZodOptional<z.ZodType<import("./index.mjs").JsonObjectIface, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonObjectIface, unknown>>>;
+    }, z.core.$strict>], "type">>]>;
+    turnPolicy: z.ZodOptional<z.ZodEnum<typeof AgentTurnPolicy>>;
+    idempotencyKey: z.ZodString;
+    meta: z.ZodOptional<z.ZodType<import("./index.mjs").JsonObjectIface, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonObjectIface, unknown>>>;
+    clientSubmittedAtMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type PromptSessionRequestIface = z.infer<typeof promptSessionRequestSchema>;
+export declare const observeSessionRequestSchema: z.ZodObject<{
+    content: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+        _meta: z.ZodOptional<z.ZodType<import("./index.mjs").JsonObjectIface, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonObjectIface, unknown>>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"image">;
+        data: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodString;
+        uri: z.ZodOptional<z.ZodString>;
+        _meta: z.ZodOptional<z.ZodType<import("./index.mjs").JsonObjectIface, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonObjectIface, unknown>>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"audio">;
+        data: z.ZodString;
+        mimeType: z.ZodString;
+        _meta: z.ZodOptional<z.ZodType<import("./index.mjs").JsonObjectIface, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonObjectIface, unknown>>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"resource_link">;
+        uri: z.ZodString;
+        name: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+        _meta: z.ZodOptional<z.ZodType<import("./index.mjs").JsonObjectIface, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonObjectIface, unknown>>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"resource">;
+        resource: z.ZodObject<{
+            uri: z.ZodString;
+            mimeType: z.ZodOptional<z.ZodString>;
+            text: z.ZodOptional<z.ZodString>;
+            blob: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        _meta: z.ZodOptional<z.ZodType<import("./index.mjs").JsonObjectIface, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonObjectIface, unknown>>>;
+    }, z.core.$strict>], "type">>]>;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
+    meta: z.ZodOptional<z.ZodType<import("./index.mjs").JsonObjectIface, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonObjectIface, unknown>>>;
+}, z.core.$strict>;
+export declare const cancelRequestSchema: z.ZodObject<{
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const cancelConversationRequestSchema: z.ZodObject<{
+    reason: z.ZodOptional<z.ZodString>;
+    throughMessageSeq: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+/** ACP outcomes: `session/request_permission` and `elicitation/create` responses. */
+export declare const pendingOutcomeInputSchema: z.ZodUnion<readonly [z.ZodObject<{
+    outcome: z.ZodLiteral<"selected">;
+    optionId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    outcome: z.ZodLiteral<"cancelled">;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"accept">;
+    content: z.ZodOptional<z.ZodType<import("./index.mjs").JsonObjectIface, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonObjectIface, unknown>>>;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"decline">;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"cancel">;
+}, z.core.$strict>]>;
+export type PendingOutcomeInput = z.infer<typeof pendingOutcomeInputSchema>;
+export declare const respondPendingRequestSchema: z.ZodObject<{
+    pendingId: z.ZodString;
+    outcome: z.ZodUnion<readonly [z.ZodObject<{
+        outcome: z.ZodLiteral<"selected">;
+        optionId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        outcome: z.ZodLiteral<"cancelled">;
+    }, z.core.$strict>, z.ZodObject<{
+        action: z.ZodLiteral<"accept">;
+        content: z.ZodOptional<z.ZodType<import("./index.mjs").JsonObjectIface, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonObjectIface, unknown>>>;
+    }, z.core.$strict>, z.ZodObject<{
+        action: z.ZodLiteral<"decline">;
+    }, z.core.$strict>, z.ZodObject<{
+        action: z.ZodLiteral<"cancel">;
+    }, z.core.$strict>]>;
+}, z.core.$strict>;
+export type RespondPendingRequestIface = z.infer<typeof respondPendingRequestSchema>;
+export declare const setConfigOptionRequestSchema: z.ZodObject<{
+    configId: z.ZodString;
+    value: z.ZodType<import("./index.mjs").JsonValue, unknown, z.core.$ZodTypeInternals<import("./index.mjs").JsonValue, unknown>>;
+}, z.core.$strict>;
+/** `GET /pending`: newest first; `cursor` is a previous page's `nextCursor`. */
+export declare const listPendingQuerySchema: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strict>;
+export declare const sessionFramesQuerySchema: z.ZodObject<{
+    fromSeq: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strict>;