@fastagent-sh/fastagent 0.24.3 → 0.25.0

package/dist/http/contract.d.ts

@@ -0,0 +1,541 @@
+import * as Schema from "effect/Schema";
+import { HttpApi, HttpApiEndpoint, HttpApiGroup, HttpApiMiddleware, HttpApiSchema, HttpApiSecurity } from "effect/http-api";
+import { AgentError, AgentErrorData, AgentInfo, Entry, Message, Session, Usage } from "../agent-api.ts";
+export declare const API_PREFIX = "/v1";
+/** The status a refusal answers with (§7). */
+export declare function statusOf(error: AgentErrorData): number;
+/** A refusal's body, `{ error }`, as the `AgentError` it carries: what a client reads at any status. */
+export declare const Refusal: Schema.decodeTo<Schema.declare<AgentError, AgentError>, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.String;
+        readonly message: Schema.String;
+        readonly retryable: Schema.Boolean;
+        readonly details: Schema.optionalKey<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    }>;
+}>, never, never>;
+declare const Authorization_base: HttpApiMiddleware.ServiceClass<Authorization, "fastagent/Authorization", {
+    requires: never;
+    provides: never;
+    error: Schema.decodeTo<Schema.declare<AgentError, AgentError>, Schema.Struct<{
+        readonly error: Schema.Struct<{
+            readonly code: Schema.String;
+            readonly message: Schema.String;
+            readonly retryable: Schema.Boolean;
+            readonly details: Schema.optionalKey<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+        }>;
+    }>, never, never>;
+    clientError: never;
+    requiredForClient: false;
+    security: {
+        readonly bearer: HttpApiSecurity.Http;
+    };
+}, HttpApiMiddleware.HttpApiMiddlewareSecurity<{
+    readonly bearer: HttpApiSecurity.Http;
+}, never, Schema.decodeTo<Schema.declare<AgentError, AgentError>, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.String;
+        readonly message: Schema.String;
+        readonly retryable: Schema.Boolean;
+        readonly details: Schema.optionalKey<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    }>;
+}>, never, never>, never>>;
+export declare class Authorization extends Authorization_base {
+}
+declare const Malformed_base: HttpApiMiddleware.ServiceClass<Malformed, "fastagent/Malformed", {
+    requires: never;
+    provides: never;
+    error: Schema.decodeTo<Schema.declare<AgentError, AgentError>, Schema.Struct<{
+        readonly error: Schema.Struct<{
+            readonly code: Schema.String;
+            readonly message: Schema.String;
+            readonly retryable: Schema.Boolean;
+            readonly details: Schema.optionalKey<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+        }>;
+    }>, never, never>;
+    clientError: never;
+    requiredForClient: false;
+    security: never;
+}, HttpApiMiddleware.HttpApiMiddleware<never, Schema.decodeTo<Schema.declare<AgentError, AgentError>, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.String;
+        readonly message: Schema.String;
+        readonly retryable: Schema.Boolean;
+        readonly details: Schema.optionalKey<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    }>;
+}>, never, never>, never>>;
+/** A request the contract cannot read (a path, query, header or body), refused `invalid_request`. */
+export declare class Malformed extends Malformed_base {
+}
+/** The event types this version defines; a Caller ignores any other (§7.1). */
+export declare const SESSION_EVENT_TYPES: ReadonlySet<string>;
+export declare const MESSAGE_STREAM_EVENT_TYPES: ReadonlySet<string>;
+export declare const SessionEventFrame: Schema.decodeTo<Schema.Union<readonly [Schema.toType<Schema.Union<readonly [Schema.Struct<{
+    readonly type: Schema.Literal<"entry">;
+    readonly entry: typeof Entry;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"state">;
+    readonly session: typeof Session;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"delta">;
+    readonly channel: Schema.Literals<readonly ["text", "thinking"]>;
+    readonly text: Schema.String;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"tool_started">;
+    readonly toolCallId: Schema.String;
+    readonly name: Schema.String;
+    readonly args: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"tool_progress">;
+    readonly toolCallId: Schema.String;
+    readonly text: Schema.String;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"retrying">;
+    readonly attempt: Schema.Number;
+    readonly maxAttempts: Schema.Number;
+    readonly delayMs: Schema.Number;
+    readonly reason: Schema.String;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"done">;
+    readonly message: typeof Message;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"stream_error">;
+    readonly error: Schema.Struct<{
+        readonly code: Schema.String;
+        readonly message: Schema.String;
+        readonly retryable: Schema.Boolean;
+        readonly details: Schema.optionalKey<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    }>;
+}>]>>, Schema.Struct<{
+    readonly type: Schema.String;
+}>]>, Schema.Struct<{
+    readonly id: Schema.optional<Schema.String>;
+    readonly event: Schema.String;
+    readonly data: Schema.String;
+}>, never, never>;
+export declare const MessageStreamEventFrame: Schema.decodeTo<Schema.Union<readonly [Schema.toType<Schema.Union<readonly [Schema.Struct<{
+    readonly type: Schema.Literal<"message">;
+    readonly message: typeof Message;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"entry">;
+    readonly entry: typeof Entry;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"state">;
+    readonly session: typeof Session;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"delta">;
+    readonly channel: Schema.Literals<readonly ["text", "thinking"]>;
+    readonly text: Schema.String;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"tool_started">;
+    readonly toolCallId: Schema.String;
+    readonly name: Schema.String;
+    readonly args: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"tool_progress">;
+    readonly toolCallId: Schema.String;
+    readonly text: Schema.String;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"retrying">;
+    readonly attempt: Schema.Number;
+    readonly maxAttempts: Schema.Number;
+    readonly delayMs: Schema.Number;
+    readonly reason: Schema.String;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"done">;
+    readonly message: typeof Message;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"stream_error">;
+    readonly error: Schema.Struct<{
+        readonly code: Schema.String;
+        readonly message: Schema.String;
+        readonly retryable: Schema.Boolean;
+        readonly details: Schema.optionalKey<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    }>;
+}>]>>, Schema.Struct<{
+    readonly type: Schema.String;
+}>]>, Schema.Struct<{
+    readonly id: Schema.optional<Schema.String>;
+    readonly event: Schema.String;
+    readonly data: Schema.String;
+}>, never, never>;
+declare const AgentHttpApi_base: HttpApi.HttpApi<"fastagent", HttpApiGroup.HttpApiGroup<"agent", HttpApiEndpoint.HttpApiEndpoint<"attachment", "GET", "/v1/sessions/:sessionId/attachments/:ref", Schema.toCodecStringTree<Schema.Struct<{
+    sessionId: Schema.String;
+    ref: Schema.String;
+}>>, never, never, never, Schema.toCodecJson<Schema.Uint8Array>, Schema.toCodecJson<Schema.decodeTo<Schema.declare<AgentError, AgentError>, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.String;
+        readonly message: Schema.String;
+        readonly retryable: Schema.Boolean;
+        readonly details: Schema.optionalKey<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    }>;
+}>, never, never>>, Authorization | Malformed, never> | HttpApiEndpoint.HttpApiEndpoint<"cancel", "POST", "/v1/sessions/:sessionId/cancel", Schema.toCodecStringTree<Schema.Struct<{
+    sessionId: Schema.String;
+}>>, never, never, never, Schema.toCodecJson<Schema.Struct<{
+    readonly stopped: Schema.$Array<Schema.String>;
+}>>, Schema.toCodecJson<Schema.decodeTo<Schema.declare<AgentError, AgentError>, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.String;
+        readonly message: Schema.String;
+        readonly retryable: Schema.Boolean;
+        readonly details: Schema.optionalKey<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    }>;
+}>, never, never>>, Authorization | Malformed, never> | HttpApiEndpoint.HttpApiEndpoint<"compact", "POST", "/v1/sessions/:sessionId/compact", Schema.toCodecStringTree<Schema.Struct<{
+    sessionId: Schema.String;
+}>>, never, Schema.toCodecJson<Schema.Null | Schema.Struct<{
+    readonly instructions: Schema.optional<Schema.String>;
+}>>, never, Schema.toCodecJson<HttpApiSchema.Accepted>, Schema.toCodecJson<Schema.decodeTo<Schema.declare<AgentError, AgentError>, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.String;
+        readonly message: Schema.String;
+        readonly retryable: Schema.Boolean;
+        readonly details: Schema.optionalKey<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    }>;
+}>, never, never>>, Authorization | Malformed, never> | HttpApiEndpoint.HttpApiEndpoint<"createSession", "POST", "/v1/sessions", never, never, Schema.toCodecJson<Schema.Null | Schema.Struct<{
+    readonly model: Schema.optional<Schema.Struct<{
+        readonly provider: Schema.String;
+        readonly modelId: Schema.String;
+    }>> | Schema.optionalKey<Schema.Struct<{
+        readonly provider: Schema.String;
+        readonly modelId: Schema.String;
+    }>>;
+    readonly thinkingLevel: Schema.optional<Schema.Literals<readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"]>> | Schema.optionalKey<Schema.Literals<readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"]>>;
+    readonly instructions: Schema.optional<Schema.String> | Schema.optionalKey<Schema.String>;
+    readonly tools: Schema.optional<Schema.$Array<Schema.String>> | Schema.optionalKey<Schema.$Array<Schema.String>>;
+    readonly forkFrom: Schema.optional<Schema.Struct<{
+        readonly sessionId: Schema.String;
+        readonly entryId: Schema.optional<Schema.String>;
+    }>>;
+}>>, never, Schema.toCodecJson<Schema.Struct<{
+    readonly model: Schema.optional<Schema.Struct<{
+        readonly provider: Schema.String;
+        readonly modelId: Schema.String;
+    }>> | Schema.optionalKey<Schema.Struct<{
+        readonly provider: Schema.String;
+        readonly modelId: Schema.String;
+    }>>;
+    readonly thinkingLevel: Schema.optional<Schema.Literals<readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"]>> | Schema.optionalKey<Schema.Literals<readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"]>>;
+    readonly instructions: Schema.optional<Schema.String> | Schema.optionalKey<Schema.String>;
+    readonly tools: Schema.optional<Schema.$Array<Schema.String>> | Schema.optionalKey<Schema.$Array<Schema.String>>;
+    readonly id: Schema.String;
+    readonly status: Schema.Codec<"idle" | "running" | (string & {}), string, never, never>;
+    readonly reply: Schema.optionalKey<Schema.Struct<{
+        readonly text: Schema.String;
+        readonly thinking: Schema.optionalKey<Schema.String>;
+    }>>;
+    readonly usage: typeof Usage;
+}>>, Schema.toCodecJson<Schema.decodeTo<Schema.declare<AgentError, AgentError>, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.String;
+        readonly message: Schema.String;
+        readonly retryable: Schema.Boolean;
+        readonly details: Schema.optionalKey<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    }>;
+}>, never, never>>, Authorization | Malformed, never> | HttpApiEndpoint.HttpApiEndpoint<"entries", "GET", "/v1/sessions/:sessionId/entries", Schema.toCodecStringTree<Schema.Struct<{
+    sessionId: Schema.String;
+}>>, Schema.toCodecStringTree<Schema.Struct<{
+    readonly after: Schema.optional<Schema.String>;
+    readonly before: Schema.optional<Schema.String>;
+    readonly limit: Schema.optional<Schema.Int>;
+}>>, never, never, Schema.toCodecJson<Schema.Struct<{
+    readonly data: Schema.$Array<typeof Entry>;
+    readonly next: Schema.optionalKey<Schema.String>;
+    readonly prev: Schema.optionalKey<Schema.String>;
+}>>, Schema.toCodecJson<Schema.decodeTo<Schema.declare<AgentError, AgentError>, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.String;
+        readonly message: Schema.String;
+        readonly retryable: Schema.Boolean;
+        readonly details: Schema.optionalKey<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    }>;
+}>, never, never>>, Authorization | Malformed, never> | HttpApiEndpoint.HttpApiEndpoint<"events", "GET", "/v1/sessions/:sessionId/events", Schema.toCodecStringTree<Schema.Struct<{
+    sessionId: Schema.String;
+}>>, Schema.toCodecStringTree<Schema.Struct<{
+    after: Schema.optional<Schema.String>;
+}>>, never, Schema.toCodecStringTree<Schema.Struct<{
+    "last-event-id": Schema.optional<Schema.String>;
+}>>, HttpApiSchema.StreamSse<Schema.decodeTo<Schema.Union<readonly [Schema.toType<Schema.Union<readonly [Schema.Struct<{
+    readonly type: Schema.Literal<"entry">;
+    readonly entry: typeof Entry;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"state">;
+    readonly session: typeof Session;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"delta">;
+    readonly channel: Schema.Literals<readonly ["text", "thinking"]>;
+    readonly text: Schema.String;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"tool_started">;
+    readonly toolCallId: Schema.String;
+    readonly name: Schema.String;
+    readonly args: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"tool_progress">;
+    readonly toolCallId: Schema.String;
+    readonly text: Schema.String;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"retrying">;
+    readonly attempt: Schema.Number;
+    readonly maxAttempts: Schema.Number;
+    readonly delayMs: Schema.Number;
+    readonly reason: Schema.String;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"done">;
+    readonly message: typeof Message;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"stream_error">;
+    readonly error: Schema.Struct<{
+        readonly code: Schema.String;
+        readonly message: Schema.String;
+        readonly retryable: Schema.Boolean;
+        readonly details: Schema.optionalKey<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    }>;
+}>]>>, Schema.Struct<{
+    readonly type: Schema.String;
+}>]>, Schema.Struct<{
+    readonly id: Schema.optional<Schema.String>;
+    readonly event: Schema.String;
+    readonly data: Schema.String;
+}>, never, never>, Schema.Never, {
+    readonly type: "entry";
+    readonly entry: Entry;
+} | {
+    readonly type: "state";
+    readonly session: Session;
+} | {
+    readonly type: "delta";
+    readonly channel: "text" | "thinking";
+    readonly text: string;
+} | {
+    readonly type: "tool_started";
+    readonly toolCallId: string;
+    readonly name: string;
+    readonly args: Schema.Json;
+} | {
+    readonly type: "tool_progress";
+    readonly toolCallId: string;
+    readonly text: string;
+} | {
+    readonly type: "retrying";
+    readonly attempt: number;
+    readonly maxAttempts: number;
+    readonly delayMs: number;
+    readonly reason: string;
+} | {
+    readonly type: "done";
+    readonly message: Message;
+} | {
+    readonly type: "stream_error";
+    readonly error: {
+        readonly code: string;
+        readonly message: string;
+        readonly retryable: boolean;
+        readonly details?: Schema.Json | undefined;
+    };
+} | {
+    readonly type: string;
+}>, Schema.toCodecJson<Schema.decodeTo<Schema.declare<AgentError, AgentError>, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.String;
+        readonly message: Schema.String;
+        readonly retryable: Schema.Boolean;
+        readonly details: Schema.optionalKey<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    }>;
+}>, never, never>>, Authorization | Malformed, never> | HttpApiEndpoint.HttpApiEndpoint<"getMessage", "GET", "/v1/sessions/:sessionId/messages/:messageId", Schema.toCodecStringTree<Schema.Struct<{
+    sessionId: Schema.String;
+    messageId: Schema.String;
+}>>, Schema.toCodecStringTree<Schema.Struct<{
+    wait: Schema.optional<Schema.NumberFromString>;
+}>>, never, never, Schema.toCodecJson<typeof Message>, Schema.toCodecJson<Schema.decodeTo<Schema.declare<AgentError, AgentError>, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.String;
+        readonly message: Schema.String;
+        readonly retryable: Schema.Boolean;
+        readonly details: Schema.optionalKey<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    }>;
+}>, never, never>>, Authorization | Malformed, never> | HttpApiEndpoint.HttpApiEndpoint<"getMessageByKey", "GET", "/v1/sessions/:sessionId/messages/by-key/:idempotencyKey", Schema.toCodecStringTree<Schema.Struct<{
+    sessionId: Schema.String;
+    idempotencyKey: Schema.String;
+}>>, Schema.toCodecStringTree<Schema.Struct<{
+    wait: Schema.optional<Schema.NumberFromString>;
+}>>, never, never, Schema.toCodecJson<typeof Message>, Schema.toCodecJson<Schema.decodeTo<Schema.declare<AgentError, AgentError>, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.String;
+        readonly message: Schema.String;
+        readonly retryable: Schema.Boolean;
+        readonly details: Schema.optionalKey<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    }>;
+}>, never, never>>, Authorization | Malformed, never> | HttpApiEndpoint.HttpApiEndpoint<"getSession", "GET", "/v1/sessions/:sessionId", Schema.toCodecStringTree<Schema.Struct<{
+    sessionId: Schema.String;
+}>>, never, never, never, Schema.toCodecJson<typeof Session>, Schema.toCodecJson<Schema.decodeTo<Schema.declare<AgentError, AgentError>, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.String;
+        readonly message: Schema.String;
+        readonly retryable: Schema.Boolean;
+        readonly details: Schema.optionalKey<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    }>;
+}>, never, never>>, Authorization | Malformed, never> | HttpApiEndpoint.HttpApiEndpoint<"info", "GET", "/v1/agent", never, never, never, never, Schema.toCodecJson<typeof AgentInfo>, Schema.toCodecJson<Schema.decodeTo<Schema.declare<AgentError, AgentError>, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.String;
+        readonly message: Schema.String;
+        readonly retryable: Schema.Boolean;
+        readonly details: Schema.optionalKey<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    }>;
+}>, never, never>>, Authorization | Malformed, never> | HttpApiEndpoint.HttpApiEndpoint<"listSessions", "GET", "/v1/sessions", never, Schema.toCodecStringTree<Schema.Struct<{
+    readonly limit: Schema.optional<Schema.Int>;
+    readonly after: Schema.optional<Schema.String>;
+}>>, never, never, Schema.toCodecJson<Schema.Struct<{
+    readonly data: Schema.$Array<typeof Session>;
+    readonly next: Schema.optionalKey<Schema.String>;
+    readonly prev: Schema.optionalKey<Schema.String>;
+}>>, Schema.toCodecJson<Schema.decodeTo<Schema.declare<AgentError, AgentError>, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.String;
+        readonly message: Schema.String;
+        readonly retryable: Schema.Boolean;
+        readonly details: Schema.optionalKey<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    }>;
+}>, never, never>>, Authorization | Malformed, never> | HttpApiEndpoint.HttpApiEndpoint<"openapi", "GET", "/v1/openapi.json", never, never, never, never, Schema.toCodecJson<Schema.Codec<Schema.Json, Schema.Json, never, never>>, Schema.toCodecJson<Schema.decodeTo<Schema.declare<AgentError, AgentError>, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.String;
+        readonly message: Schema.String;
+        readonly retryable: Schema.Boolean;
+        readonly details: Schema.optionalKey<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    }>;
+}>, never, never>>, Authorization | Malformed, never> | HttpApiEndpoint.HttpApiEndpoint<"send", "POST", "/v1/sessions/:sessionId/messages", Schema.toCodecStringTree<Schema.Struct<{
+    sessionId: Schema.String;
+}>>, never, Schema.toCodecJson<Schema.Struct<{
+    readonly content: Schema.Union<readonly [Schema.String, Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+        readonly type: Schema.Literal<"text">;
+        readonly text: Schema.String;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"image">;
+        readonly mimeType: Schema.String;
+        readonly data: Schema.String;
+    }>]>>]>;
+    readonly whenBusy: Schema.optional<Schema.Literals<readonly ["queue", "steer", "reject"]>>;
+    readonly wait: Schema.optional<Schema.Number>;
+    /** `messages.stream`: the answer is the message's events. */
+    readonly stream: Schema.optional<Schema.Boolean>;
+}>>, Schema.toCodecStringTree<Schema.Struct<{
+    "idempotency-key": Schema.optional<Schema.decodeTo<Schema.String, Schema.String, never, never>>;
+}>>, HttpApiSchema.StreamSse<Schema.decodeTo<Schema.Union<readonly [Schema.toType<Schema.Union<readonly [Schema.Struct<{
+    readonly type: Schema.Literal<"message">;
+    readonly message: typeof Message;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"entry">;
+    readonly entry: typeof Entry;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"state">;
+    readonly session: typeof Session;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"delta">;
+    readonly channel: Schema.Literals<readonly ["text", "thinking"]>;
+    readonly text: Schema.String;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"tool_started">;
+    readonly toolCallId: Schema.String;
+    readonly name: Schema.String;
+    readonly args: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"tool_progress">;
+    readonly toolCallId: Schema.String;
+    readonly text: Schema.String;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"retrying">;
+    readonly attempt: Schema.Number;
+    readonly maxAttempts: Schema.Number;
+    readonly delayMs: Schema.Number;
+    readonly reason: Schema.String;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"done">;
+    readonly message: typeof Message;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"stream_error">;
+    readonly error: Schema.Struct<{
+        readonly code: Schema.String;
+        readonly message: Schema.String;
+        readonly retryable: Schema.Boolean;
+        readonly details: Schema.optionalKey<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    }>;
+}>]>>, Schema.Struct<{
+    readonly type: Schema.String;
+}>]>, Schema.Struct<{
+    readonly id: Schema.optional<Schema.String>;
+    readonly event: Schema.String;
+    readonly data: Schema.String;
+}>, never, never>, Schema.Never, {
+    readonly type: "entry";
+    readonly entry: Entry;
+} | {
+    readonly type: "state";
+    readonly session: Session;
+} | {
+    readonly type: "delta";
+    readonly channel: "text" | "thinking";
+    readonly text: string;
+} | {
+    readonly type: "tool_started";
+    readonly toolCallId: string;
+    readonly name: string;
+    readonly args: Schema.Json;
+} | {
+    readonly type: "tool_progress";
+    readonly toolCallId: string;
+    readonly text: string;
+} | {
+    readonly type: "retrying";
+    readonly attempt: number;
+    readonly maxAttempts: number;
+    readonly delayMs: number;
+    readonly reason: string;
+} | {
+    readonly type: "done";
+    readonly message: Message;
+} | {
+    readonly type: "stream_error";
+    readonly error: {
+        readonly code: string;
+        readonly message: string;
+        readonly retryable: boolean;
+        readonly details?: Schema.Json | undefined;
+    };
+} | {
+    readonly type: "message";
+    readonly message: Message;
+} | {
+    readonly type: string;
+}> | Schema.toCodecJson<typeof Message>, Schema.toCodecJson<Schema.decodeTo<Schema.declare<AgentError, AgentError>, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.String;
+        readonly message: Schema.String;
+        readonly retryable: Schema.Boolean;
+        readonly details: Schema.optionalKey<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    }>;
+}>, never, never>>, Authorization | Malformed, never> | HttpApiEndpoint.HttpApiEndpoint<"updateSession", "PATCH", "/v1/sessions/:sessionId", Schema.toCodecStringTree<Schema.Struct<{
+    sessionId: Schema.String;
+}>>, never, Schema.toCodecJson<Schema.Struct<{
+    readonly model: Schema.optional<Schema.NullOr<Schema.Struct<{
+        readonly provider: Schema.String;
+        readonly modelId: Schema.String;
+    }>>>;
+    readonly thinkingLevel: Schema.optional<Schema.NullOr<Schema.Literals<readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"]>>>;
+    readonly instructions: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly tools: Schema.optional<Schema.NullOr<Schema.$Array<Schema.String>>>;
+}>>, never, Schema.toCodecJson<typeof Session>, Schema.toCodecJson<Schema.decodeTo<Schema.declare<AgentError, AgentError>, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.String;
+        readonly message: Schema.String;
+        readonly retryable: Schema.Boolean;
+        readonly details: Schema.optionalKey<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    }>;
+}>, never, never>>, Authorization | Malformed, never> | HttpApiEndpoint.HttpApiEndpoint<"usage", "GET", "/v1/usage", never, never, never, never, Schema.toCodecJson<typeof Usage>, Schema.toCodecJson<Schema.decodeTo<Schema.declare<AgentError, AgentError>, Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly code: Schema.String;
+        readonly message: Schema.String;
+        readonly retryable: Schema.Boolean;
+        readonly details: Schema.optionalKey<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    }>;
+}>, never, never>>, Authorization | Malformed, never>, false>>;
+export declare class AgentHttpApi extends AgentHttpApi_base {
+}
+export {};