@av-pi-studio/protocol 0.0.1

package/dist/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,uEAAuE;AACvE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAMjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/messages.js

@@ -0,0 +1,372 @@
+import { z } from "zod";
+import { isoTimestampSchema } from "./validation.js";
+/**
+ * WebSocket wire schemas (architecture/websocket-protocol.md).
+ *
+ * The protocol mixes JSON text frames (these schemas) with a small binary framing for
+ * terminal/file streams (see `binary-frames/`). All schemas are append-only: new fields are
+ * optional with defaults, types are never narrowed, fields are never removed.
+ *
+ * Built up across sprint-002:
+ *  - task-001: top-level envelopes + handshake.
+ *  - task-003: the session message family union (agent / timeline / permission core).
+ */
+// ===========================================================================
+// Shared wire primitives
+// ===========================================================================
+/**
+ * A wire timestamp. Accepts either an epoch-millis number or an ISO-8601 string so the type is
+ * never narrowed across versions (append-only rule).
+ */
+export const wireTimestampSchema = z.union([z.number(), isoTimestampSchema]);
+// ===========================================================================
+// Handshake
+// ===========================================================================
+/** Client kinds that may connect. Desktop connects as `browser` (TODO(verify) MAIN-SCOPE). */
+export const clientTypeSchema = z.enum(["mobile", "browser", "cli", "mcp"]);
+/**
+ * Client → Server handshake. Must be the first frame on a connection. `capabilities` advertises
+ * the `CLIENT_CAPS.*` flags the client supports (a string→boolean map; see client-capabilities.ts).
+ */
+export const helloSchema = z.object({
+    type: z.literal("hello"),
+    clientId: z.string(),
+    clientType: clientTypeSchema,
+    protocolVersion: z.number(),
+    appVersion: z.string().optional(),
+    capabilities: z.record(z.string(), z.boolean()).optional(),
+});
+/**
+ * The `server_info` payload carried by the `status` envelope. There is no dedicated welcome
+ * message — the server emits this after accepting the hello, then begins streaming.
+ */
+export const serverInfoPayloadSchema = z.object({
+    status: z.literal("server_info"),
+    serverId: z.string(),
+    hostname: z.string().optional(),
+    version: z.string().optional(),
+    capabilities: z.record(z.string(), z.unknown()),
+    features: z.record(z.string(), z.unknown()),
+});
+/** Server → Client status envelope wrapping `server_info`. */
+export const statusSchema = z.object({
+    type: z.literal("status"),
+    payload: serverInfoPayloadSchema,
+});
+// ===========================================================================
+// Liveness (JSON ping/pong, NOT RFC6455 ping — browsers/RN cannot access protocol ping)
+// ===========================================================================
+export const pingSchema = z.object({
+    type: z.literal("ping"),
+    requestId: z.string(),
+    clientSentAt: wireTimestampSchema.optional(),
+});
+export const pongSchema = z.object({
+    type: z.literal("pong"),
+    requestId: z.string(),
+    clientSentAt: wireTimestampSchema.optional(),
+    serverReceivedAt: wireTimestampSchema,
+    serverSentAt: wireTimestampSchema,
+});
+/**
+ * Builds a dotted RPC name: `domain.provider.operation.direction`
+ * (e.g. `checkout.github.set_auto_merge.request`). Segments read left→right:
+ * domain → provider/subsystem → operation (a verb) → direction. New RPCs use this form; legacy
+ * flat names (e.g. `checkout_pr_merge_request`) remain *accepted* but must not be generated.
+ */
+export function rpcName(domain, providerOrSubsystem, operation, direction) {
+    return `${domain}.${providerOrSubsystem}.${operation}.${direction}`;
+}
+// ===========================================================================
+// Agent session config (create_agent_request)
+// ===========================================================================
+/** Status the daemon reports for an agent (architecture/persistence.md — `lastStatus`). */
+export const agentStatusEnum = z.enum(["initializing", "idle", "running", "error", "closed"]);
+export const imageAttachmentSchema = z
+    .object({ mimeType: z.string().optional(), data: z.string().optional() })
+    .passthrough();
+export const agentAttachmentsSchema = z
+    .object({
+    prs: z.array(z.unknown()).optional(),
+    issues: z.array(z.unknown()).optional(),
+})
+    .passthrough();
+/**
+ * `AgentSessionConfig` — provider/mode/model and run options for an agent. `provider`/`modeId`/
+ * `model`/`thinkingOptionId` are dynamic strings (discovered at runtime per agent-providers.md),
+ * not fixed enums, so they are not narrowed here.
+ */
+export const agentSessionConfigSchema = z.object({
+    provider: z.string(),
+    cwd: z.string(),
+    modeId: z.string().optional(),
+    model: z.string().optional(),
+    thinkingOptionId: z.string().optional(),
+    featureValues: z.record(z.string(), z.unknown()).optional(),
+    title: z.string().nullable().optional(),
+    approvalPolicy: z.string().optional(),
+    sandboxMode: z.string().optional(),
+    networkAccess: z.boolean().optional(),
+    webSearch: z.boolean().optional(),
+    extra: z.object({ pi: z.unknown().optional() }).passthrough().optional(),
+    systemPrompt: z.string().optional(),
+    mcpServers: z.record(z.string(), z.unknown()).optional(),
+});
+export const createAgentRequestSchema = z.object({
+    type: z.literal("create_agent_request"),
+    requestId: z.string(),
+    config: agentSessionConfigSchema,
+    env: z.record(z.string(), z.string()).optional(),
+    workspaceId: z.string().optional(),
+    worktreeName: z.string().optional(),
+    initialPrompt: z.string().optional(),
+    clientMessageId: z.string().optional(),
+    outputSchema: z.record(z.string(), z.unknown()).optional(),
+    images: z.array(imageAttachmentSchema).optional(),
+    attachments: agentAttachmentsSchema.optional(),
+    git: z.unknown().optional(),
+    worktree: z.unknown().optional(),
+    autoArchive: z.boolean().optional(),
+    labels: z.record(z.string(), z.string()).default({}),
+});
+export const createAgentResponseSchema = z.object({
+    type: z.literal("create_agent_response"),
+    requestId: z.string(),
+    payload: z.object({ agentId: z.string() }).passthrough(),
+});
+// ===========================================================================
+// Agent lifecycle messages
+// ===========================================================================
+export const agentUpdateSchema = z.object({
+    type: z.literal("agent_update"),
+    agentId: z.string(),
+    status: agentStatusEnum.optional(),
+    title: z.string().nullable().optional(),
+    labels: z.record(z.string(), z.string()).optional(),
+});
+export const agentStatusMessageSchema = z.object({
+    type: z.literal("agent_status"),
+    agentId: z.string(),
+    status: agentStatusEnum,
+});
+export const agentListSchema = z.object({
+    type: z.literal("agent_list"),
+    agents: z.array(z.object({ id: z.string() }).passthrough()),
+});
+export const agentDeletedSchema = z.object({
+    type: z.literal("agent_deleted"),
+    agentId: z.string(),
+});
+export const agentArchivedSchema = z.object({
+    type: z.literal("agent_archived"),
+    agentId: z.string(),
+    archivedAt: isoTimestampSchema.optional(),
+});
+// ===========================================================================
+// Tool-call details + stream events
+// ===========================================================================
+/** `ToolCallDetail` — normalized across providers, discriminated on `kind`. */
+export const toolCallDetailSchema = z.discriminatedUnion("kind", [
+    z.object({ kind: z.literal("shell"), command: z.string().optional(), output: z.string().optional() }),
+    z.object({ kind: z.literal("read"), path: z.string().optional(), output: z.string().optional() }),
+    z.object({
+        kind: z.literal("edit"),
+        path: z.string().optional(),
+        diff: z.string().optional(),
+        output: z.string().optional(),
+    }),
+    z.object({ kind: z.literal("write"), path: z.string().optional(), output: z.string().optional() }),
+    z.object({ kind: z.literal("search"), query: z.string().optional(), output: z.string().optional() }),
+    z.object({ kind: z.literal("fetch"), url: z.string().optional(), output: z.string().optional() }),
+    z.object({
+        kind: z.literal("task"),
+        description: z.string().optional(),
+        output: z.string().optional(),
+    }),
+]);
+/** `AgentStreamEvent` — discriminated on `kind`. */
+export const agentStreamEventSchema = z.discriminatedUnion("kind", [
+    z.object({
+        kind: z.literal("user_message"),
+        messageId: z.string().optional(),
+        text: z.string().optional(),
+        images: z.array(imageAttachmentSchema).optional(),
+    }),
+    z.object({
+        kind: z.literal("assistant_message"),
+        messageId: z.string().optional(),
+        text: z.string().optional(),
+    }),
+    z.object({ kind: z.literal("reasoning"), text: z.string().optional() }),
+    z.object({
+        kind: z.literal("tool_call"),
+        callId: z.string().optional(),
+        tool: toolCallDetailSchema,
+        status: z.string().optional(),
+    }),
+    z.object({ kind: z.literal("turn_started"), turnId: z.string().optional() }),
+    z.object({ kind: z.literal("turn_completed"), turnId: z.string().optional() }),
+    z.object({
+        kind: z.literal("turn_failed"),
+        turnId: z.string().optional(),
+        error: z.string().optional(),
+    }),
+    z.object({ kind: z.literal("turn_canceled"), turnId: z.string().optional() }),
+    z.object({ kind: z.literal("error"), message: z.string().optional() }),
+]);
+export const agentStreamSchema = z.object({
+    type: z.literal("agent_stream"),
+    agentId: z.string(),
+    seq: z.number().optional(),
+    timestamp: wireTimestampSchema.optional(),
+    event: agentStreamEventSchema,
+});
+// ===========================================================================
+// Timeline fetch (authoritative paged history)
+// ===========================================================================
+export const timelineDirectionEnum = z.enum(["before", "after"]);
+export const sourceSeqRangeSchema = z.object({ start: z.number(), end: z.number() });
+export const fetchAgentTimelineRequestSchema = z.object({
+    type: z.literal("fetch_agent_timeline_request"),
+    requestId: z.string(),
+    agentId: z.string(),
+    cursor: z.string().nullable().optional(),
+    direction: timelineDirectionEnum,
+    limit: z.number().optional(),
+});
+export const fetchAgentTimelineResponseSchema = z.object({
+    type: z.literal("fetch_agent_timeline_response"),
+    requestId: z.string(),
+    agentId: z.string().optional(),
+    items: z.array(z.unknown()),
+    seqStart: z.number(),
+    seqEnd: z.number(),
+    sourceSeqRanges: z.array(sourceSeqRangeSchema),
+    collapsed: z.boolean(),
+    hasNewer: z.boolean(),
+    startCursor: z.string().nullable().optional(),
+    endCursor: z.string().nullable().optional(),
+});
+// ===========================================================================
+// Tool-call permissions
+// ===========================================================================
+export const agentPermissionRequestSchema = z.object({
+    type: z.literal("agent_permission_request"),
+    requestId: z.string(),
+    agentId: z.string(),
+    toolName: z.string().optional(),
+    tool: toolCallDetailSchema.optional(),
+    action: z.unknown().optional(),
+    responses: z.array(z.string()).optional(),
+});
+export const agentPermissionResolvedSchema = z.object({
+    type: z.literal("agent_permission_resolved"),
+    requestId: z.string(),
+    agentId: z.string(),
+    decision: z.string().optional(),
+});
+/** respond-to-permission RPC (client → daemon), dotted name `agent.permission.respond.request`. */
+export const respondToPermissionRequestSchema = z.object({
+    type: z.literal("agent.permission.respond.request"),
+    requestId: z.string(),
+    permissionRequestId: z.string(),
+    response: z.unknown(),
+});
+export const respondToPermissionResponseSchema = z.object({
+    type: z.literal("agent.permission.respond.response"),
+    requestId: z.string(),
+    payload: z.object({ resolved: z.boolean() }).passthrough(),
+});
+/** Legacy flat name for the same operation — still accepted (parsed), never generated. */
+export const legacyRespondToPermissionSchema = z.object({
+    type: z.literal("respond_to_permission"),
+    requestId: z.string(),
+    permissionRequestId: z.string(),
+    response: z.unknown(),
+});
+// ===========================================================================
+// ===========================================================================
+// Rewind RPC (features/rewind.md) — additive, new in sprint-015
+// ===========================================================================
+export const rewindModeSchema = z.enum(["conversation", "files", "both"]);
+export const agentRewindRequestSchema = z.object({
+    type: z.literal("agent.rewind.request"),
+    requestId: z.string(),
+    agentId: z.string(),
+    messageId: z.string(),
+    mode: rewindModeSchema,
+}).passthrough();
+export const agentRewindResponseSchema = z.object({
+    type: z.literal("agent.rewind.response"),
+    requestId: z.string(),
+    payload: z.object({
+        agentId: z.string(),
+        messageId: z.string(),
+        mode: rewindModeSchema,
+        truncatedAt: z.string().optional(),
+    }).passthrough(),
+}).passthrough();
+// ===========================================================================
+// RPC error
+// ===========================================================================
+export const rpcErrorSchema = z.object({
+    type: z.literal("rpc_error"),
+    requestId: z.string(),
+    code: z.string().optional(),
+    message: z.string().optional(),
+    error: z.string().optional(),
+});
+// ===========================================================================
+// Session message union (agent / timeline / permission core)
+// ===========================================================================
+/**
+ * The discriminated union of session messages defined so far. Later feature sprints extend this
+ * union with workspace/git/terminal/chat/schedule/loop families.
+ */
+export const sessionMessageSchema = z.discriminatedUnion("type", [
+    createAgentRequestSchema,
+    createAgentResponseSchema,
+    agentUpdateSchema,
+    agentStatusMessageSchema,
+    agentListSchema,
+    agentDeletedSchema,
+    agentArchivedSchema,
+    agentStreamSchema,
+    fetchAgentTimelineRequestSchema,
+    fetchAgentTimelineResponseSchema,
+    agentPermissionRequestSchema,
+    agentPermissionResolvedSchema,
+    respondToPermissionRequestSchema,
+    respondToPermissionResponseSchema,
+    legacyRespondToPermissionSchema,
+    agentRewindRequestSchema,
+    agentRewindResponseSchema,
+    rpcErrorSchema,
+]);
+/**
+ * Structural fallback for any session message (carries a `type` discriminant). Unknown/future
+ * session types still parse here (append-only / "ignore unknown type per handler policy"), so the
+ * envelope accepts them and handlers validate per-family with the specific schema above.
+ */
+export const sessionMessageBaseSchema = z.object({ type: z.string() }).passthrough();
+// ===========================================================================
+// Session envelope + top-level union
+// ===========================================================================
+/**
+ * Envelope wrapping the rich session message union. Known message types validate strictly against
+ * `sessionMessageSchema`; unknown/future types fall back to the structural base so an older client
+ * still parses newer messages.
+ */
+export const sessionEnvelopeSchema = z.object({
+    type: z.literal("session"),
+    message: z.union([sessionMessageSchema, sessionMessageBaseSchema]),
+});
+/** Discriminated union of all top-level envelopes, keyed by `type`. */
+export const topLevelEnvelopeSchema = z.discriminatedUnion("type", [
+    helloSchema,
+    statusSchema,
+    pingSchema,
+    pongSchema,
+    sessionEnvelopeSchema,
+]);
+//# sourceMappingURL=messages.js.map

package/dist/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"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"}

package/dist/provider-manifest.d.ts

@@ -0,0 +1,176 @@
+import { z } from "zod";
+/**
+ * Provider manifest types (features/agent-providers.md § Registration surface, § Capability flags).
+ *
+ * The manifest is UI scaffolding only — actual models/modes/features are discovered at runtime via
+ * the provider RPC. These types express provider definitions, mode metadata (icon + colorTier), and
+ * the `AgentCapabilityFlags` shape.
+ */
+/** Provider ids must match `/^[a-z][a-z0-9-]*$/` (agent-providers.md). */
+export declare const providerIdSchema: z.ZodString;
+/** Mode danger/intent tier driving UI color. */
+export declare const colorTierSchema: z.ZodEnum<["safe", "moderate", "dangerous", "planning"]>;
+export type ColorTier = z.infer<typeof colorTierSchema>;
+/** Per-provider capability flags. */
+export declare const agentCapabilityFlagsSchema: z.ZodObject<{
+    supportsStreaming: z.ZodBoolean;
+    supportsSessionPersistence: z.ZodBoolean;
+    supportsDynamicModes: z.ZodBoolean;
+    supportsMcpServers: z.ZodBoolean;
+    supportsReasoningStream: z.ZodBoolean;
+    supportsToolInvocations: z.ZodBoolean;
+    supportsRewindConversation: z.ZodOptional<z.ZodBoolean>;
+    supportsRewindFiles: z.ZodOptional<z.ZodBoolean>;
+    supportsRewindBoth: z.ZodOptional<z.ZodBoolean>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    supportsStreaming: z.ZodBoolean;
+    supportsSessionPersistence: z.ZodBoolean;
+    supportsDynamicModes: z.ZodBoolean;
+    supportsMcpServers: z.ZodBoolean;
+    supportsReasoningStream: z.ZodBoolean;
+    supportsToolInvocations: z.ZodBoolean;
+    supportsRewindConversation: z.ZodOptional<z.ZodBoolean>;
+    supportsRewindFiles: z.ZodOptional<z.ZodBoolean>;
+    supportsRewindBoth: z.ZodOptional<z.ZodBoolean>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    supportsStreaming: z.ZodBoolean;
+    supportsSessionPersistence: z.ZodBoolean;
+    supportsDynamicModes: z.ZodBoolean;
+    supportsMcpServers: z.ZodBoolean;
+    supportsReasoningStream: z.ZodBoolean;
+    supportsToolInvocations: z.ZodBoolean;
+    supportsRewindConversation: z.ZodOptional<z.ZodBoolean>;
+    supportsRewindFiles: z.ZodOptional<z.ZodBoolean>;
+    supportsRewindBoth: z.ZodOptional<z.ZodBoolean>;
+}, z.ZodTypeAny, "passthrough">>;
+export type AgentCapabilityFlags = z.infer<typeof agentCapabilityFlagsSchema>;
+/** UI metadata for a provider mode (plan/default/full-access/...). */
+export declare const providerModeSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    colorTier: z.ZodEnum<["safe", "moderate", "dangerous", "planning"]>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    colorTier: "safe" | "moderate" | "dangerous" | "planning";
+    description?: string | undefined;
+    label?: string | undefined;
+    icon?: string | undefined;
+}, {
+    id: string;
+    colorTier: "safe" | "moderate" | "dangerous" | "planning";
+    description?: string | undefined;
+    label?: string | undefined;
+    icon?: string | undefined;
+}>;
+export type ProviderMode = z.infer<typeof providerModeSchema>;
+/** A provider manifest definition. `extends` marks a custom Pi-compatible profile. */
+export declare const providerDefinitionSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    extends: z.ZodOptional<z.ZodString>;
+    modes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        icon: z.ZodOptional<z.ZodString>;
+        colorTier: z.ZodEnum<["safe", "moderate", "dangerous", "planning"]>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        colorTier: "safe" | "moderate" | "dangerous" | "planning";
+        description?: string | undefined;
+        label?: string | undefined;
+        icon?: string | undefined;
+    }, {
+        id: string;
+        colorTier: "safe" | "moderate" | "dangerous" | "planning";
+        description?: string | undefined;
+        label?: string | undefined;
+        icon?: string | undefined;
+    }>, "many">;
+    capabilities: z.ZodObject<{
+        supportsStreaming: z.ZodBoolean;
+        supportsSessionPersistence: z.ZodBoolean;
+        supportsDynamicModes: z.ZodBoolean;
+        supportsMcpServers: z.ZodBoolean;
+        supportsReasoningStream: z.ZodBoolean;
+        supportsToolInvocations: z.ZodBoolean;
+        supportsRewindConversation: z.ZodOptional<z.ZodBoolean>;
+        supportsRewindFiles: z.ZodOptional<z.ZodBoolean>;
+        supportsRewindBoth: z.ZodOptional<z.ZodBoolean>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        supportsStreaming: z.ZodBoolean;
+        supportsSessionPersistence: z.ZodBoolean;
+        supportsDynamicModes: z.ZodBoolean;
+        supportsMcpServers: z.ZodBoolean;
+        supportsReasoningStream: z.ZodBoolean;
+        supportsToolInvocations: z.ZodBoolean;
+        supportsRewindConversation: z.ZodOptional<z.ZodBoolean>;
+        supportsRewindFiles: z.ZodOptional<z.ZodBoolean>;
+        supportsRewindBoth: z.ZodOptional<z.ZodBoolean>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        supportsStreaming: z.ZodBoolean;
+        supportsSessionPersistence: z.ZodBoolean;
+        supportsDynamicModes: z.ZodBoolean;
+        supportsMcpServers: z.ZodBoolean;
+        supportsReasoningStream: z.ZodBoolean;
+        supportsToolInvocations: z.ZodBoolean;
+        supportsRewindConversation: z.ZodOptional<z.ZodBoolean>;
+        supportsRewindFiles: z.ZodOptional<z.ZodBoolean>;
+        supportsRewindBoth: z.ZodOptional<z.ZodBoolean>;
+    }, z.ZodTypeAny, "passthrough">>;
+}, "strip", z.ZodTypeAny, {
+    capabilities: {
+        supportsStreaming: boolean;
+        supportsSessionPersistence: boolean;
+        supportsDynamicModes: boolean;
+        supportsMcpServers: boolean;
+        supportsReasoningStream: boolean;
+        supportsToolInvocations: boolean;
+        supportsRewindConversation?: boolean | undefined;
+        supportsRewindFiles?: boolean | undefined;
+        supportsRewindBoth?: boolean | undefined;
+    } & {
+        [k: string]: unknown;
+    };
+    id: string;
+    label: string;
+    modes: {
+        id: string;
+        colorTier: "safe" | "moderate" | "dangerous" | "planning";
+        description?: string | undefined;
+        label?: string | undefined;
+        icon?: string | undefined;
+    }[];
+    description?: string | undefined;
+    extends?: string | undefined;
+}, {
+    capabilities: {
+        supportsStreaming: boolean;
+        supportsSessionPersistence: boolean;
+        supportsDynamicModes: boolean;
+        supportsMcpServers: boolean;
+        supportsReasoningStream: boolean;
+        supportsToolInvocations: boolean;
+        supportsRewindConversation?: boolean | undefined;
+        supportsRewindFiles?: boolean | undefined;
+        supportsRewindBoth?: boolean | undefined;
+    } & {
+        [k: string]: unknown;
+    };
+    id: string;
+    label: string;
+    modes: {
+        id: string;
+        colorTier: "safe" | "moderate" | "dangerous" | "planning";
+        description?: string | undefined;
+        label?: string | undefined;
+        icon?: string | undefined;
+    }[];
+    description?: string | undefined;
+    extends?: string | undefined;
+}>;
+export type ProviderDefinition = z.infer<typeof providerDefinitionSchema>;
+//# sourceMappingURL=provider-manifest.d.ts.map

package/dist/provider-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-manifest.d.ts","sourceRoot":"","sources":["../src/provider-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;GAMG;AAEH,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,aAA+D,CAAC;AAE7F,gDAAgD;AAChD,eAAO,MAAM,eAAe,0DAAwD,CAAC;AACrF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,qCAAqC;AACrC,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAWvB,CAAC;AACjB,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,sEAAsE;AACtE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;EAM7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,sFAAsF;AACtF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/provider-manifest.js

@@ -0,0 +1,43 @@
+import { z } from "zod";
+/**
+ * Provider manifest types (features/agent-providers.md § Registration surface, § Capability flags).
+ *
+ * The manifest is UI scaffolding only — actual models/modes/features are discovered at runtime via
+ * the provider RPC. These types express provider definitions, mode metadata (icon + colorTier), and
+ * the `AgentCapabilityFlags` shape.
+ */
+/** Provider ids must match `/^[a-z][a-z0-9-]*$/` (agent-providers.md). */
+export const providerIdSchema = z.string().regex(/^[a-z][a-z0-9-]*$/, "invalid provider id");
+/** Mode danger/intent tier driving UI color. */
+export const colorTierSchema = z.enum(["safe", "moderate", "dangerous", "planning"]);
+/** Per-provider capability flags. */
+export const agentCapabilityFlagsSchema = z.object({
+    supportsStreaming: z.boolean(),
+    supportsSessionPersistence: z.boolean(),
+    supportsDynamicModes: z.boolean(),
+    supportsMcpServers: z.boolean(),
+    supportsReasoningStream: z.boolean(),
+    supportsToolInvocations: z.boolean(),
+    // Rewind capability flags (features/rewind.md) — additive, optional, old clients ignore.
+    supportsRewindConversation: z.boolean().optional(),
+    supportsRewindFiles: z.boolean().optional(),
+    supportsRewindBoth: z.boolean().optional(),
+}).passthrough();
+/** UI metadata for a provider mode (plan/default/full-access/...). */
+export const providerModeSchema = z.object({
+    id: z.string(),
+    label: z.string().optional(),
+    description: z.string().optional(),
+    icon: z.string().optional(),
+    colorTier: colorTierSchema,
+});
+/** A provider manifest definition. `extends` marks a custom Pi-compatible profile. */
+export const providerDefinitionSchema = z.object({
+    id: providerIdSchema,
+    label: z.string(),
+    description: z.string().optional(),
+    extends: z.string().optional(),
+    modes: z.array(providerModeSchema),
+    capabilities: agentCapabilityFlagsSchema,
+});
+//# sourceMappingURL=provider-manifest.js.map

package/dist/provider-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-manifest.js","sourceRoot":"","sources":["../src/provider-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;GAMG;AAEH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAmB,EAAE,qBAAqB,CAAC,CAAC;AAE7F,gDAAgD;AAChD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC;AAGrF,qCAAqC;AACrC,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE;IAC9B,0BAA0B,EAAE,CAAC,CAAC,OAAO,EAAE;IACvC,oBAAoB,EAAE,CAAC,CAAC,OAAO,EAAE;IACjC,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE;IAC/B,uBAAuB,EAAE,CAAC,CAAC,OAAO,EAAE;IACpC,uBAAuB,EAAE,CAAC,CAAC,OAAO,EAAE;IACpC,yFAAyF;IACzF,0BAA0B,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAClD,mBAAmB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC3C,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAC,WAAW,EAAE,CAAC;AAGjB,sEAAsE;AACtE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,SAAS,EAAE,eAAe;CAC3B,CAAC,CAAC;AAGH,sFAAsF;AACtF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,EAAE,EAAE,gBAAgB;IACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC;IAClC,YAAY,EAAE,0BAA0B;CACzC,CAAC,CAAC"}