@playcraft/common 0.0.56 → 0.0.58

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

@@ -0,0 +1,130 @@
+import { z } from 'zod';
+export declare const agentCommandRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    toolName: z.ZodLiteral<"bash">;
+    input: z.ZodObject<{
+        command: z.ZodString;
+        cwd: z.ZodOptional<z.ZodString>;
+        raw: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>;
+    action: z.ZodEnum<{
+        settled: "settled";
+        observe: "observe";
+        start: "start";
+        cancel: "cancel";
+    }>;
+    timeoutMs: z.ZodNumber;
+    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<{
+    toolName: z.ZodLiteral<"inspector-bash">;
+    input: z.ZodObject<{
+        command: z.ZodString;
+        cwd: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    action: z.ZodEnum<{
+        settled: "settled";
+        observe: "observe";
+        start: "start";
+        cancel: "cancel";
+    }>;
+    timeoutMs: z.ZodNumber;
+    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<{
+    toolName: z.ZodLiteral<"generate_replica_variants">;
+    input: z.ZodObject<{
+        suggestionIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    action: z.ZodEnum<{
+        settled: "settled";
+        observe: "observe";
+        start: "start";
+        cancel: "cancel";
+    }>;
+    timeoutMs: z.ZodNumber;
+    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 agentCommandOutputSchema: z.ZodObject<{
+    stdout: z.ZodString;
+    stderr: z.ZodString;
+    exitCode: z.ZodNumber;
+    truncated: z.ZodBoolean;
+}, z.core.$strict>;
+export declare const agentCommandResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    outcome: z.ZodLiteral<"running">;
+}, z.core.$strict>, z.ZodObject<{
+    outcome: z.ZodLiteral<"uncertain">;
+    error: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    outcome: z.ZodLiteral<"settled">;
+    output: z.ZodObject<{
+        stdout: z.ZodString;
+        stderr: z.ZodString;
+        exitCode: z.ZodNumber;
+        truncated: z.ZodBoolean;
+    }, z.core.$strict>;
+}, z.core.$strict>], "outcome">;
+export declare const agentCommandResponseSchema: z.ZodObject<{
+    ledgerId: z.ZodString;
+    toolCallId: z.ZodString;
+    toolName: z.ZodEnum<{
+        bash: "bash";
+        "inspector-bash": "inspector-bash";
+        generate_replica_variants: "generate_replica_variants";
+    }>;
+    inputHash: z.ZodString;
+    result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        outcome: z.ZodLiteral<"running">;
+    }, z.core.$strict>, z.ZodObject<{
+        outcome: z.ZodLiteral<"uncertain">;
+        error: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        outcome: z.ZodLiteral<"settled">;
+        output: z.ZodObject<{
+            stdout: z.ZodString;
+            stderr: z.ZodString;
+            exitCode: z.ZodNumber;
+            truncated: z.ZodBoolean;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "outcome">;
+}, z.core.$strict>;
+export type AgentCommandRequest = z.infer<typeof agentCommandRequestSchema>;
+export type AgentCommandOutput = z.infer<typeof agentCommandOutputSchema>;
+//# sourceMappingURL=agent-command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-command.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/agent-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCA4CoD,CAAC;AAE3F,eAAO,MAAM,wBAAwB;;;;;kBAO1B,CAAC;AACZ,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;+BAInC,CAAC;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;kBAQ5B,CAAC;AACZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

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

@@ -0,0 +1,75 @@
+import { z } from 'zod';
+import { agentToolClaimShape } from './agent-tool-claim.js';
+const commandClaim = {
+    ...agentToolClaimShape,
+    action: z.enum(['start', 'observe', 'settled', 'cancel']),
+    timeoutMs: z.number().int().min(1).max(600_000),
+};
+const commandText = z.string().min(1).max(40_000);
+const commandCwd = z.string().min(1).max(4096).optional();
+export const agentCommandRequestSchema = z
+    .discriminatedUnion('toolName', [
+    z
+        .object({
+        ...commandClaim,
+        toolName: z.literal('bash'),
+        input: z
+            .object({
+            command: commandText,
+            cwd: commandCwd,
+            raw: z.boolean().optional(),
+        })
+            .strict(),
+    })
+        .strict(),
+    z
+        .object({
+        ...commandClaim,
+        toolName: z.literal('inspector-bash'),
+        input: z
+            .object({
+            command: commandText,
+            cwd: commandCwd,
+        })
+            .strict(),
+    })
+        .strict(),
+    z
+        .object({
+        ...commandClaim,
+        toolName: z.literal('generate_replica_variants'),
+        input: z
+            .object({
+            suggestionIds: z.array(z.string().min(1)).min(1).max(10),
+        })
+            .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 agentCommandOutputSchema = z
+    .object({
+    stdout: z.string().max(65_536),
+    stderr: z.string().max(65_536),
+    exitCode: z.number().int(),
+    truncated: z.boolean(),
+})
+    .strict();
+export const agentCommandResultSchema = z.discriminatedUnion('outcome', [
+    z.object({ outcome: z.literal('running') }).strict(),
+    z.object({ outcome: z.literal('uncertain'), error: z.string().max(128) }).strict(),
+    z.object({ outcome: z.literal('settled'), output: agentCommandOutputSchema }).strict(),
+]);
+export const agentCommandResponseSchema = z
+    .object({
+    ledgerId: z.string().uuid(),
+    toolCallId: z.string(),
+    toolName: z.enum(['bash', 'inspector-bash', 'generate_replica_variants']),
+    inputHash: z.string().regex(/^[a-f0-9]{64}$/),
+    result: agentCommandResultSchema,
+})
+    .strict();
+//# sourceMappingURL=agent-command.js.map

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

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

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

@@ -0,0 +1,76 @@
+import { z } from 'zod';
+export declare const agentConnectionActions: readonly ["ensure_opencode", "ensure_preview", "sync_model", "settled"];
+export declare const agentConnectionKinds: readonly ["session", "manager", "execution"];
+export declare const agentConnectionRequestSchema: z.ZodObject<{
+    action: z.ZodEnum<{
+        settled: "settled";
+        ensure_opencode: "ensure_opencode";
+        ensure_preview: "ensure_preview";
+        sync_model: "sync_model";
+    }>;
+    sessionId: z.ZodString;
+    requestId: z.ZodString;
+    writerEpoch: z.ZodNumber;
+    workspaceId: z.ZodString;
+    kind: z.ZodEnum<{
+        session: "session";
+        manager: "manager";
+        execution: "execution";
+    }>;
+    runId: z.ZodOptional<z.ZodString>;
+    executionId: z.ZodOptional<z.ZodString>;
+    issueId: z.ZodOptional<z.ZodString>;
+    claimToken: z.ZodOptional<z.ZodString>;
+    settledOnly: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const agentConnectionResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    outcome: z.ZodLiteral<"running">;
+}, z.core.$strict>, z.ZodObject<{
+    outcome: z.ZodLiteral<"uncertain">;
+    error: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    outcome: z.ZodLiteral<"settled">;
+    status: z.ZodEnum<{
+        failed: "failed";
+        completed: "completed";
+        skipped: "skipped";
+    }>;
+    sandboxId: z.ZodNullable<z.ZodString>;
+    alreadyRunning: z.ZodBoolean;
+    skipped: z.ZodBoolean;
+    previewReady: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>], "outcome">;
+export declare const agentConnectionResponseSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    operationId: z.ZodString;
+    action: z.ZodEnum<{
+        settled: "settled";
+        ensure_opencode: "ensure_opencode";
+        ensure_preview: "ensure_preview";
+        sync_model: "sync_model";
+    }>;
+    inputHash: z.ZodString;
+    result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        outcome: z.ZodLiteral<"running">;
+    }, z.core.$strict>, z.ZodObject<{
+        outcome: z.ZodLiteral<"uncertain">;
+        error: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        outcome: z.ZodLiteral<"settled">;
+        status: z.ZodEnum<{
+            failed: "failed";
+            completed: "completed";
+            skipped: "skipped";
+        }>;
+        sandboxId: z.ZodNullable<z.ZodString>;
+        alreadyRunning: z.ZodBoolean;
+        skipped: z.ZodBoolean;
+        previewReady: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>], "outcome">;
+}, z.core.$strict>;
+export type AgentConnectionRequest = z.infer<typeof agentConnectionRequestSchema>;
+export type AgentConnectionResult = z.infer<typeof agentConnectionResultSchema>;
+export type AgentConnectionResponse = z.infer<typeof agentConnectionResponseSchema>;
+//# sourceMappingURL=agent-connection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-connection.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/agent-connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,sBAAsB,yEAKzB,CAAC;AACX,eAAO,MAAM,oBAAoB,8CAA+C,CAAC;AAEjF,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;kBAsBiD,CAAC;AAE3F,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;+BActC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAQ/B,CAAC;AAEZ,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC"}

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

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+const identity = z.string().min(1).max(128);
+const sessionId = z.string().regex(/^[a-zA-Z0-9_-]{1,128}$/);
+const uuid = z.string().uuid();
+export const agentConnectionActions = [
+    'ensure_opencode',
+    'ensure_preview',
+    'sync_model',
+    'settled',
+];
+export const agentConnectionKinds = ['session', 'manager', 'execution'];
+export const agentConnectionRequestSchema = z
+    .object({
+    action: z.enum(agentConnectionActions),
+    sessionId,
+    requestId: uuid,
+    writerEpoch: z.number().int().positive().max(2_147_483_647),
+    workspaceId: identity,
+    kind: z.enum(agentConnectionKinds),
+    runId: uuid.optional(),
+    executionId: uuid.optional(),
+    issueId: uuid.optional(),
+    claimToken: identity.optional(),
+    settledOnly: z.boolean().default(false),
+})
+    .strict()
+    .refine((value) => {
+    if (value.kind === 'session')
+        return !value.runId && !value.executionId && !value.issueId && !value.claimToken;
+    if (value.kind === 'manager')
+        return Boolean(value.runId && value.claimToken) && !value.executionId && !value.issueId;
+    return Boolean(value.runId && value.executionId && value.issueId && value.claimToken);
+})
+    .refine((value) => new TextEncoder().encode(JSON.stringify(value)).byteLength <= 16_384);
+export const agentConnectionResultSchema = z.discriminatedUnion('outcome', [
+    z.object({ outcome: z.literal('running') }).strict(),
+    z.object({ outcome: z.literal('uncertain'), error: z.string().max(128) }).strict(),
+    z
+        .object({
+        outcome: z.literal('settled'),
+        status: z.enum(['completed', 'skipped', 'failed']),
+        sandboxId: z.string().min(1).max(128).nullable(),
+        alreadyRunning: z.boolean(),
+        skipped: z.boolean(),
+        previewReady: z.boolean(),
+        error: z.string().max(128).optional(),
+    })
+        .strict(),
+]);
+export const agentConnectionResponseSchema = z
+    .object({
+    requestId: uuid,
+    operationId: uuid,
+    action: z.enum(agentConnectionActions),
+    inputHash: z.string().regex(/^[a-f0-9]{64}$/),
+    result: agentConnectionResultSchema,
+})
+    .strict();
+//# sourceMappingURL=agent-connection.js.map

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

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

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

@@ -0,0 +1,85 @@
+import { z } from 'zod';
+export declare const agentLifecycleActions: readonly ["allocate", "renew", "recycle", "prepare", "settled"];
+export declare const agentLifecycleKinds: readonly ["session", "manager", "execution"];
+export declare const agentLifecycleRequestSchema: z.ZodObject<{
+    action: z.ZodEnum<{
+        prepare: "prepare";
+        settled: "settled";
+        allocate: "allocate";
+        renew: "renew";
+        recycle: "recycle";
+    }>;
+    sessionId: z.ZodString;
+    requestId: z.ZodString;
+    writerEpoch: z.ZodNumber;
+    workspaceId: z.ZodString;
+    kind: z.ZodEnum<{
+        session: "session";
+        manager: "manager";
+        execution: "execution";
+    }>;
+    runId: z.ZodOptional<z.ZodString>;
+    executionId: z.ZodOptional<z.ZodString>;
+    issueId: z.ZodOptional<z.ZodString>;
+    claimToken: z.ZodOptional<z.ZodString>;
+    recycleReason: z.ZodOptional<z.ZodString>;
+    settledOnly: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const agentLifecycleSettledOutputSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        completed: "completed";
+        skipped: "skipped";
+    }>;
+    sandboxId: z.ZodNullable<z.ZodString>;
+    reused: z.ZodBoolean;
+    prepared: z.ZodBoolean;
+    recycled: z.ZodBoolean;
+}, z.core.$strict>;
+export declare const agentLifecycleResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    outcome: z.ZodLiteral<"running">;
+}, z.core.$strict>, z.ZodObject<{
+    outcome: z.ZodLiteral<"uncertain">;
+    error: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    outcome: z.ZodLiteral<"settled">;
+    status: z.ZodEnum<{
+        completed: "completed";
+        skipped: "skipped";
+    }>;
+    sandboxId: z.ZodNullable<z.ZodString>;
+    reused: z.ZodBoolean;
+    prepared: z.ZodBoolean;
+    recycled: z.ZodBoolean;
+}, z.core.$strict>], "outcome">;
+export declare const agentLifecycleResponseSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    operationId: z.ZodString;
+    action: z.ZodEnum<{
+        prepare: "prepare";
+        settled: "settled";
+        allocate: "allocate";
+        renew: "renew";
+        recycle: "recycle";
+    }>;
+    inputHash: z.ZodString;
+    result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        outcome: z.ZodLiteral<"running">;
+    }, z.core.$strict>, z.ZodObject<{
+        outcome: z.ZodLiteral<"uncertain">;
+        error: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        outcome: z.ZodLiteral<"settled">;
+        status: z.ZodEnum<{
+            completed: "completed";
+            skipped: "skipped";
+        }>;
+        sandboxId: z.ZodNullable<z.ZodString>;
+        reused: z.ZodBoolean;
+        prepared: z.ZodBoolean;
+        recycled: z.ZodBoolean;
+    }, z.core.$strict>], "outcome">;
+}, z.core.$strict>;
+export type AgentLifecycleRequest = z.infer<typeof agentLifecycleRequestSchema>;
+export type AgentLifecycleResult = z.infer<typeof agentLifecycleResultSchema>;
+export type AgentLifecycleResponse = z.infer<typeof agentLifecycleResponseSchema>;
+//# sourceMappingURL=agent-lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-lifecycle.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/agent-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,qBAAqB,iEAMxB,CAAC;AACX,eAAO,MAAM,mBAAmB,8CAA+C,CAAC;AAEhF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;kBAwBkD,CAAC;AAE3F,eAAO,MAAM,iCAAiC;;;;;;;;;kBAQnC,CAAC;AAEZ,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;+BAarC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAQ9B,CAAC;AAEZ,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC"}

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

@@ -0,0 +1,70 @@
+import { z } from 'zod';
+const identity = z.string().min(1).max(128);
+const sessionId = z.string().regex(/^[a-zA-Z0-9_-]{1,128}$/);
+const uuid = z.string().uuid();
+export const agentLifecycleActions = [
+    'allocate',
+    'renew',
+    'recycle',
+    'prepare',
+    'settled',
+];
+export const agentLifecycleKinds = ['session', 'manager', 'execution'];
+export const agentLifecycleRequestSchema = z
+    .object({
+    action: z.enum(agentLifecycleActions),
+    sessionId,
+    requestId: uuid,
+    writerEpoch: z.number().int().positive().max(2_147_483_647),
+    workspaceId: identity,
+    kind: z.enum(agentLifecycleKinds),
+    runId: uuid.optional(),
+    executionId: uuid.optional(),
+    issueId: uuid.optional(),
+    claimToken: identity.optional(),
+    recycleReason: z.string().min(1).max(128).optional(),
+    settledOnly: z.boolean().default(false),
+})
+    .strict()
+    .refine((value) => {
+    if (value.kind === 'session')
+        return !value.runId && !value.executionId && !value.issueId && !value.claimToken;
+    if (value.kind === 'manager')
+        return Boolean(value.runId && value.claimToken) && !value.executionId && !value.issueId;
+    return Boolean(value.runId && value.executionId && value.issueId && value.claimToken);
+})
+    .refine((value) => value.action === 'recycle' || value.recycleReason === undefined)
+    .refine((value) => new TextEncoder().encode(JSON.stringify(value)).byteLength <= 16_384);
+export const agentLifecycleSettledOutputSchema = z
+    .object({
+    status: z.enum(['completed', 'skipped']),
+    sandboxId: z.string().min(1).max(128).nullable(),
+    reused: z.boolean(),
+    prepared: z.boolean(),
+    recycled: z.boolean(),
+})
+    .strict();
+export const agentLifecycleResultSchema = z.discriminatedUnion('outcome', [
+    z.object({ outcome: z.literal('running') }).strict(),
+    z.object({ outcome: z.literal('uncertain'), error: z.string().max(128) }).strict(),
+    z
+        .object({
+        outcome: z.literal('settled'),
+        status: z.enum(['completed', 'skipped']),
+        sandboxId: z.string().min(1).max(128).nullable(),
+        reused: z.boolean(),
+        prepared: z.boolean(),
+        recycled: z.boolean(),
+    })
+        .strict(),
+]);
+export const agentLifecycleResponseSchema = z
+    .object({
+    requestId: uuid,
+    operationId: uuid,
+    action: z.enum(agentLifecycleActions),
+    inputHash: z.string().regex(/^[a-f0-9]{64}$/),
+    result: agentLifecycleResultSchema,
+})
+    .strict();
+//# sourceMappingURL=agent-lifecycle.js.map

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

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