@playcraft/common 0.0.57 → 0.0.58

package/dist/cloud-workspace/runtime/agent-mutation.d.ts

@@ -0,0 +1,197 @@
+import { z } from 'zod';
+export declare const agentMutationRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    settledOnly: z.ZodOptional<z.ZodBoolean>;
+    toolName: z.ZodLiteral<"write">;
+    input: z.ZodObject<{
+        path: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strict>;
+    kind: z.ZodEnum<{
+        manager: "manager";
+        execution: "execution";
+    }>;
+    sessionId: z.ZodString;
+    workspaceId: z.ZodString;
+    runId: z.ZodString;
+    executionId: z.ZodOptional<z.ZodString>;
+    issueId: z.ZodOptional<z.ZodString>;
+    triggeredByMessageId: z.ZodNullable<z.ZodString>;
+    claimToken: z.ZodString;
+    writerEpoch: z.ZodNumber;
+    ledgerId: z.ZodString;
+    toolCallId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    settledOnly: z.ZodOptional<z.ZodBoolean>;
+    toolName: z.ZodLiteral<"edit">;
+    input: z.ZodObject<{
+        path: z.ZodString;
+        oldText: z.ZodString;
+        newText: z.ZodString;
+    }, z.core.$strict>;
+    kind: z.ZodEnum<{
+        manager: "manager";
+        execution: "execution";
+    }>;
+    sessionId: z.ZodString;
+    workspaceId: z.ZodString;
+    runId: z.ZodString;
+    executionId: z.ZodOptional<z.ZodString>;
+    issueId: z.ZodOptional<z.ZodString>;
+    triggeredByMessageId: z.ZodNullable<z.ZodString>;
+    claimToken: z.ZodString;
+    writerEpoch: z.ZodNumber;
+    ledgerId: z.ZodString;
+    toolCallId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    settledOnly: z.ZodOptional<z.ZodBoolean>;
+    toolName: z.ZodLiteral<"write_context">;
+    input: z.ZodObject<{
+        path: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strict>;
+    kind: z.ZodEnum<{
+        manager: "manager";
+        execution: "execution";
+    }>;
+    sessionId: z.ZodString;
+    workspaceId: z.ZodString;
+    runId: z.ZodString;
+    executionId: z.ZodOptional<z.ZodString>;
+    issueId: z.ZodOptional<z.ZodString>;
+    triggeredByMessageId: z.ZodNullable<z.ZodString>;
+    claimToken: z.ZodString;
+    writerEpoch: z.ZodNumber;
+    ledgerId: z.ZodString;
+    toolCallId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    settledOnly: z.ZodOptional<z.ZodBoolean>;
+    toolName: z.ZodLiteral<"create_iteration">;
+    input: z.ZodObject<{
+        number: z.ZodOptional<z.ZodNumber>;
+        title: z.ZodOptional<z.ZodString>;
+        goal: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodEnum<{
+            active: "active";
+            planned: "planned";
+            cancelled: "cancelled";
+            done: "done";
+        }>>;
+        phase: z.ZodOptional<z.ZodEnum<{
+            generate: "generate";
+            done: "done";
+            creative: "creative";
+            context_build: "context_build";
+            optimize: "optimize";
+            wrapup: "wrapup";
+        }>>;
+        createContainer: z.ZodOptional<z.ZodBoolean>;
+        containerTitle: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    content: z.ZodString;
+    kind: z.ZodEnum<{
+        manager: "manager";
+        execution: "execution";
+    }>;
+    sessionId: z.ZodString;
+    workspaceId: z.ZodString;
+    runId: z.ZodString;
+    executionId: z.ZodOptional<z.ZodString>;
+    issueId: z.ZodOptional<z.ZodString>;
+    triggeredByMessageId: z.ZodNullable<z.ZodString>;
+    claimToken: z.ZodString;
+    writerEpoch: z.ZodNumber;
+    ledgerId: z.ZodString;
+    toolCallId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    settledOnly: z.ZodOptional<z.ZodBoolean>;
+    toolName: z.ZodLiteral<"workflow_advance">;
+    input: z.ZodObject<{
+        toPhase: z.ZodOptional<z.ZodEnum<{
+            generate: "generate";
+            done: "done";
+            creative: "creative";
+            context_build: "context_build";
+            optimize: "optimize";
+            wrapup: "wrapup";
+        }>>;
+        openNext: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>;
+    content: z.ZodString;
+    kind: z.ZodEnum<{
+        manager: "manager";
+        execution: "execution";
+    }>;
+    sessionId: z.ZodString;
+    workspaceId: z.ZodString;
+    runId: z.ZodString;
+    executionId: z.ZodOptional<z.ZodString>;
+    issueId: z.ZodOptional<z.ZodString>;
+    triggeredByMessageId: z.ZodNullable<z.ZodString>;
+    claimToken: z.ZodString;
+    writerEpoch: z.ZodNumber;
+    ledgerId: z.ZodString;
+    toolCallId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    settledOnly: z.ZodOptional<z.ZodBoolean>;
+    toolName: z.ZodLiteral<"write_verdict">;
+    input: z.ZodObject<{
+        content: z.ZodString;
+    }, z.core.$strict>;
+    kind: z.ZodEnum<{
+        manager: "manager";
+        execution: "execution";
+    }>;
+    sessionId: z.ZodString;
+    workspaceId: z.ZodString;
+    runId: z.ZodString;
+    executionId: z.ZodOptional<z.ZodString>;
+    issueId: z.ZodOptional<z.ZodString>;
+    triggeredByMessageId: z.ZodNullable<z.ZodString>;
+    claimToken: z.ZodString;
+    writerEpoch: z.ZodNumber;
+    ledgerId: z.ZodString;
+    toolCallId: z.ZodString;
+}, z.core.$strict>], "toolName">;
+export declare const agentMutationOutputSchema: z.ZodObject<{
+    result: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodLiteral<true>>;
+}, z.core.$strict>;
+export declare const agentMutationResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    outcome: z.ZodLiteral<"settled">;
+    output: z.ZodObject<{
+        result: z.ZodString;
+        path: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodLiteral<true>>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    outcome: z.ZodLiteral<"uncertain">;
+    error: z.ZodString;
+}, z.core.$strict>], "outcome">;
+export declare const agentMutationResponseSchema: z.ZodObject<{
+    ledgerId: z.ZodString;
+    toolCallId: z.ZodString;
+    toolName: z.ZodEnum<{
+        write: "write";
+        edit: "edit";
+        write_context: "write_context";
+        create_iteration: "create_iteration";
+        workflow_advance: "workflow_advance";
+        write_verdict: "write_verdict";
+    }>;
+    inputHash: z.ZodString;
+    result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        outcome: z.ZodLiteral<"settled">;
+        output: z.ZodObject<{
+            result: z.ZodString;
+            path: z.ZodOptional<z.ZodString>;
+            error: z.ZodOptional<z.ZodLiteral<true>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        outcome: z.ZodLiteral<"uncertain">;
+        error: z.ZodString;
+    }, z.core.$strict>], "outcome">;
+}, z.core.$strict>;
+export type AgentMutationRequest = z.infer<typeof agentMutationRequestSchema>;
+export type AgentMutationOutput = z.infer<typeof agentMutationOutputSchema>;
+//# sourceMappingURL=agent-mutation.d.ts.map

package/dist/cloud-workspace/runtime/agent-mutation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-mutation.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/agent-mutation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA8BxB,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCA0DmD,CAAC;AAE3F,eAAO,MAAM,yBAAyB;;;;kBAM3B,CAAC;AACZ,eAAO,MAAM,yBAAyB;;;;;;;;;;+BAGpC,CAAC;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;kBAe7B,CAAC;AACZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/cloud-workspace/runtime/agent-mutation.js

@@ -0,0 +1,114 @@
+import { z } from 'zod';
+import { agentToolClaimShape } from './agent-tool-claim.js';
+const path = z.string().min(1).max(4096);
+const text = z.string().max(60_000);
+const workflowPhase = z.enum([
+    'creative',
+    'context_build',
+    'generate',
+    'optimize',
+    'wrapup',
+    'done',
+]);
+const createIterationInput = z
+    .object({
+    number: z.number().int().positive().optional(),
+    title: z.string().optional(),
+    goal: z.string().optional(),
+    status: z.enum(['planned', 'active', 'done', 'cancelled']).optional(),
+    phase: workflowPhase.optional(),
+    createContainer: z.boolean().optional(),
+    containerTitle: z.string().optional(),
+})
+    .strict();
+const workflowAdvanceInput = z
+    .object({
+    toPhase: workflowPhase.optional(),
+    openNext: z.boolean().optional(),
+})
+    .strict();
+export const agentMutationRequestSchema = z
+    .discriminatedUnion('toolName', [
+    z
+        .object({
+        ...agentToolClaimShape,
+        settledOnly: z.boolean().optional(),
+        toolName: z.literal('write'),
+        input: z.object({ path, content: text }).strict(),
+    })
+        .strict(),
+    z
+        .object({
+        ...agentToolClaimShape,
+        settledOnly: z.boolean().optional(),
+        toolName: z.literal('edit'),
+        input: z.object({ path, oldText: text, newText: text }).strict(),
+    })
+        .strict(),
+    z
+        .object({
+        ...agentToolClaimShape,
+        settledOnly: z.boolean().optional(),
+        toolName: z.literal('write_context'),
+        input: z.object({ path, content: text }).strict(),
+    })
+        .strict(),
+    z
+        .object({
+        ...agentToolClaimShape,
+        settledOnly: z.boolean().optional(),
+        toolName: z.literal('create_iteration'),
+        input: createIterationInput,
+        content: text,
+    })
+        .strict(),
+    z
+        .object({
+        ...agentToolClaimShape,
+        settledOnly: z.boolean().optional(),
+        toolName: z.literal('workflow_advance'),
+        input: workflowAdvanceInput,
+        content: text,
+    })
+        .strict(),
+    z
+        .object({
+        ...agentToolClaimShape,
+        settledOnly: z.boolean().optional(),
+        toolName: z.literal('write_verdict'),
+        input: z.object({ content: text }).strict(),
+    })
+        .strict(),
+])
+    .refine((value) => value.kind === 'execution'
+    ? Boolean(value.executionId && value.issueId)
+    : !value.executionId && !value.issueId)
+    .refine((value) => new TextEncoder().encode(JSON.stringify(value)).byteLength <= 60_000);
+export const agentMutationOutputSchema = z
+    .object({
+    result: z.string().max(8192),
+    path: z.string().max(4096).optional(),
+    error: z.literal(true).optional(),
+})
+    .strict();
+export const agentMutationResultSchema = z.discriminatedUnion('outcome', [
+    z.object({ outcome: z.literal('settled'), output: agentMutationOutputSchema }).strict(),
+    z.object({ outcome: z.literal('uncertain'), error: z.string().max(128) }).strict(),
+]);
+export const agentMutationResponseSchema = z
+    .object({
+    ledgerId: z.string().uuid(),
+    toolCallId: z.string(),
+    toolName: z.enum([
+        'write',
+        'edit',
+        'write_context',
+        'create_iteration',
+        'workflow_advance',
+        'write_verdict',
+    ]),
+    inputHash: z.string().regex(/^[a-f0-9]{64}$/),
+    result: agentMutationResultSchema,
+})
+    .strict();
+//# sourceMappingURL=agent-mutation.js.map

package/dist/cloud-workspace/runtime/agent-mutation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-mutation.js","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/agent-mutation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACzC,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACpC,MAAM,aAAa,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3B,UAAU;IACV,eAAe;IACf,UAAU;IACV,UAAU;IACV,QAAQ;IACR,MAAM;CACP,CAAC,CAAC;AACH,MAAM,oBAAoB,GAAG,CAAC;KAC3B,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC9C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE;IACrE,KAAK,EAAE,aAAa,CAAC,QAAQ,EAAE;IAC/B,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACvC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACtC,CAAC;KACD,MAAM,EAAE,CAAC;AACZ,MAAM,oBAAoB,GAAG,CAAC;KAC3B,MAAM,CAAC;IACN,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE;IACjC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,MAAM,EAAE,CAAC;AACZ,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC;KACxC,kBAAkB,CAAC,UAAU,EAAE;IAC9B,CAAC;SACE,MAAM,CAAC;QACN,GAAG,mBAAmB;QACtB,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QACnC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;QAC5B,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;KAClD,CAAC;SACD,MAAM,EAAE;IACX,CAAC;SACE,MAAM,CAAC;QACN,GAAG,mBAAmB;QACtB,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QACnC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;KACjE,CAAC;SACD,MAAM,EAAE;IACX,CAAC;SACE,MAAM,CAAC;QACN,GAAG,mBAAmB;QACtB,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QACnC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;QACpC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;KAClD,CAAC;SACD,MAAM,EAAE;IACX,CAAC;SACE,MAAM,CAAC;QACN,GAAG,mBAAmB;QACtB,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QACnC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC;QACvC,KAAK,EAAE,oBAAoB;QAC3B,OAAO,EAAE,IAAI;KACd,CAAC;SACD,MAAM,EAAE;IACX,CAAC;SACE,MAAM,CAAC;QACN,GAAG,mBAAmB;QACtB,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QACnC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC;QACvC,KAAK,EAAE,oBAAoB;QAC3B,OAAO,EAAE,IAAI;KACd,CAAC;SACD,MAAM,EAAE;IACX,CAAC;SACE,MAAM,CAAC;QACN,GAAG,mBAAmB;QACtB,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QACnC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;QACpC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;KAC5C,CAAC;SACD,MAAM,EAAE;CACZ,CAAC;KACD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAChB,KAAK,CAAC,IAAI,KAAK,WAAW;IACxB,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,OAAO,CAAC;IAC7C,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,OAAO,CACzC;KACA,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,IAAI,MAAM,CAAC,CAAC;AAE3F,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC;KACvC,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IACrC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;CAClC,CAAC;KACD,MAAM,EAAE,CAAC;AACZ,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,kBAAkB,CAAC,SAAS,EAAE;IACvE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,yBAAyB,EAAE,CAAC,CAAC,MAAM,EAAE;IACvF,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;CACnF,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC;KACzC,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC3B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC;QACf,OAAO;QACP,MAAM;QACN,eAAe;QACf,kBAAkB;QAClB,kBAAkB;QAClB,eAAe;KAChB,CAAC;IACF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC;IAC7C,MAAM,EAAE,yBAAyB;CAClC,CAAC;KACD,MAAM,EAAE,CAAC"}

package/dist/cloud-workspace/runtime/agent-opencode-gateway.d.ts

@@ -0,0 +1,156 @@
+import { z } from 'zod';
+export declare const agentOpenCodeGatewayActions: readonly ["session_create", "session_list", "session_get", "session_delete", "message_list", "message_send", "prompt_async", "abort", "command_list", "settled"];
+export declare const agentOpenCodeGatewayFamilies: readonly ["session_create", "session_list", "session_get", "session_delete", "message_list", "message_send", "prompt_async", "abort", "command_list"];
+export declare function agentOpenCodeGatewayFamily(action: (typeof agentOpenCodeGatewayActions)[number]): (typeof agentOpenCodeGatewayFamilies)[number];
+export declare function agentOpenCodeGatewayIsMutating(action: (typeof agentOpenCodeGatewayActions)[number]): boolean;
+export declare const agentOpenCodeGatewayRequestSchema: z.ZodObject<{
+    action: z.ZodEnum<{
+        abort: "abort";
+        settled: "settled";
+        session_create: "session_create";
+        session_list: "session_list";
+        session_get: "session_get";
+        session_delete: "session_delete";
+        message_list: "message_list";
+        message_send: "message_send";
+        prompt_async: "prompt_async";
+        command_list: "command_list";
+    }>;
+    requestId: z.ZodString;
+    writerEpoch: z.ZodNumber;
+    projectId: z.ZodString;
+    branchName: z.ZodString;
+    settledOnly: z.ZodDefault<z.ZodBoolean>;
+    openCodeSessionId: z.ZodOptional<z.ZodString>;
+    body: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strict>;
+export declare const agentOpenCodeGatewayResultSchema: z.ZodUnion<readonly [z.ZodObject<{
+    outcome: z.ZodLiteral<"uncertain">;
+    error: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    outcome: z.ZodLiteral<"settled">;
+    kind: z.ZodLiteral<"upstream_error">;
+    status: z.ZodLiteral<"failed">;
+    upstreamStatus: z.ZodNumber;
+    body: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strict>, z.ZodObject<{
+    outcome: z.ZodLiteral<"settled">;
+    kind: z.ZodLiteral<"session">;
+    status: z.ZodEnum<{
+        failed: "failed";
+        completed: "completed";
+    }>;
+    payload: z.ZodOptional<z.ZodUnknown>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    outcome: z.ZodLiteral<"settled">;
+    kind: z.ZodLiteral<"sessions">;
+    status: z.ZodEnum<{
+        failed: "failed";
+        completed: "completed";
+    }>;
+    payload: z.ZodOptional<z.ZodUnknown>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    outcome: z.ZodLiteral<"settled">;
+    kind: z.ZodLiteral<"messages">;
+    status: z.ZodEnum<{
+        failed: "failed";
+        completed: "completed";
+    }>;
+    payload: z.ZodOptional<z.ZodUnknown>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    outcome: z.ZodLiteral<"settled">;
+    kind: z.ZodLiteral<"commands">;
+    status: z.ZodEnum<{
+        failed: "failed";
+        completed: "completed";
+    }>;
+    payload: z.ZodOptional<z.ZodUnknown>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    outcome: z.ZodLiteral<"settled">;
+    kind: z.ZodLiteral<"ack">;
+    status: z.ZodEnum<{
+        failed: "failed";
+        completed: "completed";
+    }>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>]>;
+export declare const agentOpenCodeGatewayResponseSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    operationId: z.ZodString;
+    action: z.ZodEnum<{
+        abort: "abort";
+        settled: "settled";
+        session_create: "session_create";
+        session_list: "session_list";
+        session_get: "session_get";
+        session_delete: "session_delete";
+        message_list: "message_list";
+        message_send: "message_send";
+        prompt_async: "prompt_async";
+        command_list: "command_list";
+    }>;
+    inputHash: z.ZodString;
+    result: z.ZodUnion<readonly [z.ZodObject<{
+        outcome: z.ZodLiteral<"uncertain">;
+        error: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        outcome: z.ZodLiteral<"settled">;
+        kind: z.ZodLiteral<"upstream_error">;
+        status: z.ZodLiteral<"failed">;
+        upstreamStatus: z.ZodNumber;
+        body: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strict>, z.ZodObject<{
+        outcome: z.ZodLiteral<"settled">;
+        kind: z.ZodLiteral<"session">;
+        status: z.ZodEnum<{
+            failed: "failed";
+            completed: "completed";
+        }>;
+        payload: z.ZodOptional<z.ZodUnknown>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        outcome: z.ZodLiteral<"settled">;
+        kind: z.ZodLiteral<"sessions">;
+        status: z.ZodEnum<{
+            failed: "failed";
+            completed: "completed";
+        }>;
+        payload: z.ZodOptional<z.ZodUnknown>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        outcome: z.ZodLiteral<"settled">;
+        kind: z.ZodLiteral<"messages">;
+        status: z.ZodEnum<{
+            failed: "failed";
+            completed: "completed";
+        }>;
+        payload: z.ZodOptional<z.ZodUnknown>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        outcome: z.ZodLiteral<"settled">;
+        kind: z.ZodLiteral<"commands">;
+        status: z.ZodEnum<{
+            failed: "failed";
+            completed: "completed";
+        }>;
+        payload: z.ZodOptional<z.ZodUnknown>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        outcome: z.ZodLiteral<"settled">;
+        kind: z.ZodLiteral<"ack">;
+        status: z.ZodEnum<{
+            failed: "failed";
+            completed: "completed";
+        }>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>;
+}, z.core.$strict>;
+export type AgentOpenCodeGatewayAction = (typeof agentOpenCodeGatewayActions)[number];
+export type AgentOpenCodeGatewayRequest = z.infer<typeof agentOpenCodeGatewayRequestSchema>;
+export type AgentOpenCodeGatewayResult = z.infer<typeof agentOpenCodeGatewayResultSchema>;
+export type AgentOpenCodeGatewayResponse = z.infer<typeof agentOpenCodeGatewayResponseSchema>;
+//# sourceMappingURL=agent-opencode-gateway.d.ts.map

package/dist/cloud-workspace/runtime/agent-opencode-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-opencode-gateway.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/agent-opencode-gateway.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsBxB,eAAO,MAAM,2BAA2B,kKAW9B,CAAC;AAEX,eAAO,MAAM,4BAA4B,uJAU/B,CAAC;AAsBX,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,GACnD,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,CAAC,CAG/C;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,GACnD,OAAO,CAET;AAED,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;kBAwB1C,CAAC;AAwBL,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAe3C,CAAC;AAEH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAQpC,CAAC;AAEZ,MAAM,MAAM,0BAA0B,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AACtF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAC5F,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAC1F,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC"}

package/dist/cloud-workspace/runtime/agent-opencode-gateway.js

@@ -0,0 +1,141 @@
+import { z } from 'zod';
+/**
+ * Remix 编辑器 Code Agent 面板的 OpenCode 网关协议（R3.13）。
+ *
+ * 与 `agent-opencode.ts` 的区别：那一份服务平台 Agent 的 `dispatch_code_agent`（后端进程内
+ * 派发一次任务），这一份服务浏览器发起的交互式会话，动作对应
+ * `SandboxHttpPassthroughBase` 原先直连沙箱的 HTTP 方法。
+ *
+ * 调用方只能声明动作与会话标识，不能传 sandboxId、slot、令牌或沙箱内路径；目标沙箱由
+ * Runtime 依据 projectId + branchName 从 `branch_sandboxes` 推导。
+ */
+const uuid = z.string().uuid();
+const branchName = z
+    .string()
+    .min(1)
+    .max(200)
+    .refine((value) => !/[\x00-\x1f]/.test(value));
+/** OpenCode 会话标识，原样取自上游；仅限安全字符，避免拼进沙箱内路径时越界。 */
+const openCodeSessionId = z.string().regex(/^[a-zA-Z0-9_-]{1,128}$/);
+export const agentOpenCodeGatewayActions = [
+    'session_create',
+    'session_list',
+    'session_get',
+    'session_delete',
+    'message_list',
+    'message_send',
+    'prompt_async',
+    'abort',
+    'command_list',
+    'settled',
+];
+export const agentOpenCodeGatewayFamilies = [
+    'session_create',
+    'session_list',
+    'session_get',
+    'session_delete',
+    'message_list',
+    'message_send',
+    'prompt_async',
+    'abort',
+    'command_list',
+];
+/** 需要回执去重的动作；其余是只读查询，重复执行无副作用。 */
+const MUTATING_ACTIONS = new Set([
+    'session_create',
+    'session_delete',
+    'message_send',
+    'prompt_async',
+    'abort',
+]);
+const SESSION_REQUIRED = new Set([
+    'session_get',
+    'session_delete',
+    'message_list',
+    'message_send',
+    'prompt_async',
+    'abort',
+]);
+const BODY_ALLOWED = new Set(['message_send', 'prompt_async']);
+export function agentOpenCodeGatewayFamily(action) {
+    if (action === 'settled')
+        return 'session_list';
+    return action;
+}
+export function agentOpenCodeGatewayIsMutating(action) {
+    return MUTATING_ACTIONS.has(action);
+}
+export const agentOpenCodeGatewayRequestSchema = z
+    .object({
+    action: z.enum(agentOpenCodeGatewayActions),
+    requestId: uuid,
+    writerEpoch: z.number().int().positive().max(2_147_483_647),
+    projectId: uuid,
+    branchName,
+    settledOnly: z.boolean().default(false),
+    openCodeSessionId: openCodeSessionId.optional(),
+    /** `message_send` / `prompt_async` 的请求体，原样转交上游。 */
+    body: z.unknown().optional(),
+})
+    .strict()
+    .refine((value) => {
+    if (value.action === 'settled')
+        return true;
+    if (SESSION_REQUIRED.has(value.action) && !value.openCodeSessionId)
+        return false;
+    if (!SESSION_REQUIRED.has(value.action) && value.openCodeSessionId)
+        return false;
+    if (value.body !== undefined && !BODY_ALLOWED.has(value.action))
+        return false;
+    return true;
+})
+    .refine((value) => {
+    // 提示词可带附件引用，给足余量；其余动作按控制面请求限制。
+    const limit = BODY_ALLOWED.has(value.action) ? 262_144 : 16_384;
+    return new TextEncoder().encode(JSON.stringify(value)).byteLength <= limit;
+});
+/** 上游业务错误：保留原状态码与响应体，网关据此还原 HttpException，不吞成 200。 */
+const upstreamFailure = z
+    .object({
+    outcome: z.literal('settled'),
+    kind: z.literal('upstream_error'),
+    status: z.literal('failed'),
+    upstreamStatus: z.number().int().min(400).max(599),
+    body: z.unknown().optional(),
+})
+    .strict();
+const payloadResult = (kind) => z
+    .object({
+    outcome: z.literal('settled'),
+    kind: z.literal(kind),
+    status: z.enum(['completed', 'failed']),
+    payload: z.unknown().optional(),
+    error: z.string().max(128).optional(),
+})
+    .strict();
+export const agentOpenCodeGatewayResultSchema = z.union([
+    z.object({ outcome: z.literal('uncertain'), error: z.string().max(128) }).strict(),
+    upstreamFailure,
+    payloadResult('session'),
+    payloadResult('sessions'),
+    payloadResult('messages'),
+    payloadResult('commands'),
+    z
+        .object({
+        outcome: z.literal('settled'),
+        kind: z.literal('ack'),
+        status: z.enum(['completed', 'failed']),
+        error: z.string().max(128).optional(),
+    })
+        .strict(),
+]);
+export const agentOpenCodeGatewayResponseSchema = z
+    .object({
+    requestId: uuid,
+    operationId: uuid,
+    action: z.enum(agentOpenCodeGatewayActions),
+    inputHash: z.string().regex(/^[a-f0-9]{64}$/),
+    result: agentOpenCodeGatewayResultSchema,
+})
+    .strict();
+//# sourceMappingURL=agent-opencode-gateway.js.map

package/dist/cloud-workspace/runtime/agent-opencode-gateway.js.map

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