@playcraft/common 0.1.54 → 0.1.56-beta

package/dist/cloud-workspace/runtime/operations.js

@@ -0,0 +1,300 @@
+import { createHash } from 'node:crypto';
+import { z } from 'zod';
+import { workspacePermissionModeSchema } from './permissions.js';
+import { checkpointKindSchema } from './checkpoints.js';
+import { workspaceSessionScopeSchema } from './workspace-directories.js';
+import { workspaceWorkModeSchema, workspaceComposerContextSchema } from './composer-context.js';
+import { workspaceReviewTargetSchema } from './turn-control.js';
+import { workspaceRemixReferenceSchema, workspaceRemixReferenceExportSchema } from './remix-references.js';
+import { workspaceAssetLibraryImportResultSchema, workspaceAssetLibraryImportTransportSchema } from './asset-library-import.js';
+import { parameterAgentTaskRecordSchema } from './parameter-agent.js';
+export const reasoningEffortSchema = z.enum(['low', 'medium', 'high', 'max']);
+export const OPERATION_KINDS = [
+    'runtime.ensure',
+    'runtime.destroy',
+    'session.create',
+    'session.turn',
+    'session.review',
+    'session.compact',
+    'session.steer',
+    'session.interrupt',
+    'session.approval.respond',
+    'file.write',
+    'file.binary.write',
+    'directory.create',
+    'directory.rename',
+    'directory.delete',
+    'asset.library.import',
+    'asset.bundle.save',
+    'git.commit',
+    'git.push',
+    'git.pull',
+    'git.merge.abort',
+    'git.stage',
+    'git.unstage',
+    'git.discard',
+    'workspace.save',
+    'workspace.references.import',
+    'terminal.create',
+    'parameter.patch',
+    'parameter.verify',
+    'skills.update',
+    'preview.publish',
+    'delivery.build',
+    'delivery.cancel',
+    'checkpoint.create',
+    'checkpoint.restore',
+];
+export const operationKindSchema = z.enum(OPERATION_KINDS);
+export const OPERATION_EFFECTS = {
+    'runtime.ensure': { mutatesWorkspace: false, executionSlot: false },
+    'runtime.destroy': { mutatesWorkspace: false, executionSlot: false },
+    // A new conversation writes no files; the first turn queues on the ledger instead.
+    'session.create': { mutatesWorkspace: false, executionSlot: false },
+    'session.turn': { mutatesWorkspace: true, executionSlot: true },
+    'session.review': { mutatesWorkspace: false, executionSlot: true },
+    'session.compact': { mutatesWorkspace: false, executionSlot: true },
+    'session.steer': { mutatesWorkspace: false, executionSlot: false },
+    'session.interrupt': { mutatesWorkspace: false, executionSlot: false },
+    'session.approval.respond': { mutatesWorkspace: false, executionSlot: false },
+    'file.write': { mutatesWorkspace: true, executionSlot: false },
+    'file.binary.write': { mutatesWorkspace: true, executionSlot: false },
+    'directory.create': { mutatesWorkspace: true, executionSlot: false },
+    'directory.rename': { mutatesWorkspace: true, executionSlot: false },
+    'directory.delete': { mutatesWorkspace: true, executionSlot: false },
+    'asset.library.import': { mutatesWorkspace: true, executionSlot: false },
+    'asset.bundle.save': { mutatesWorkspace: true, executionSlot: false },
+    'git.commit': { mutatesWorkspace: true, executionSlot: false },
+    'git.push': { mutatesWorkspace: true, executionSlot: false },
+    'git.pull': { mutatesWorkspace: true, executionSlot: false },
+    'git.merge.abort': { mutatesWorkspace: true, executionSlot: false },
+    'git.stage': { mutatesWorkspace: true, executionSlot: false },
+    'git.unstage': { mutatesWorkspace: true, executionSlot: false },
+    'git.discard': { mutatesWorkspace: true, executionSlot: false },
+    'workspace.save': { mutatesWorkspace: true, executionSlot: false },
+    'workspace.references.import': { mutatesWorkspace: true, executionSlot: false },
+    // Creating a terminal grants a write channel; the channel itself rechecks every message.
+    'terminal.create': { mutatesWorkspace: true, executionSlot: false },
+    'parameter.patch': { mutatesWorkspace: true, executionSlot: false },
+    'parameter.verify': { mutatesWorkspace: true, executionSlot: false },
+    'skills.update': { mutatesWorkspace: true, executionSlot: false },
+    'preview.publish': { mutatesWorkspace: true, executionSlot: true },
+    'delivery.build': { mutatesWorkspace: true, executionSlot: false },
+    'delivery.cancel': { mutatesWorkspace: false, executionSlot: false },
+    'checkpoint.create': { mutatesWorkspace: true, executionSlot: false },
+    'checkpoint.restore': { mutatesWorkspace: true, executionSlot: false },
+};
+/** Unknown kinds are treated as directory writes so a new kind can never bypass the gate. */
+const UNKNOWN_OPERATION_EFFECT = { mutatesWorkspace: true, executionSlot: false };
+export function operationEffect(kind) {
+    return OPERATION_EFFECTS[kind] ?? UNKNOWN_OPERATION_EFFECT;
+}
+/** Kinds that steer a running turn; they touch neither workspace content nor the runtime itself. */
+export const TURN_CONTROL_OPERATION_KINDS = [
+    'session.interrupt',
+    'session.approval.respond',
+    'session.steer',
+];
+/** Kinds that steer the runtime or a running turn without changing workspace content. */
+export const CONTROL_OPERATION_KINDS = OPERATION_KINDS.filter((kind) => !OPERATION_EFFECTS[kind].mutatesWorkspace);
+export function isTurnControl(kind) {
+    return TURN_CONTROL_OPERATION_KINDS.includes(kind);
+}
+export function isWorkspaceMutation(kind) {
+    return operationEffect(kind).mutatesWorkspace;
+}
+/** Takes the directory for the whole execution and is serialized per directory. */
+export function takesExecutionSlot(kind) {
+    return operationEffect(kind).executionSlot;
+}
+/**
+ * Classifies an operation that changes files without queueing behind the ledger. Runtime does not
+ * refuse those while another execution holds the directory any more (concurrent writers are
+ * allowed), so this is a description of the operation, not an admission rule.
+ */
+export function needsExclusiveDirectory(kind) {
+    const effect = operationEffect(kind);
+    return effect.mutatesWorkspace && !effect.executionSlot;
+}
+/** True when the operation needs the directory free of batch runs and other executions. */
+export function takesWorkspaceDirectory(kind) {
+    const effect = operationEffect(kind);
+    return effect.mutatesWorkspace || effect.executionSlot;
+}
+export const OPERATION_STATUSES = [
+    'queued',
+    'dispatched',
+    'accepted',
+    'completed',
+    'failed',
+    'interrupted',
+    'uncertain',
+];
+export const operationStatusSchema = z.enum(OPERATION_STATUSES);
+export const TERMINAL_OPERATION_STATUSES = ['completed', 'failed', 'interrupted'];
+const OPERATION_TRANSITIONS = {
+    queued: ['dispatched', 'failed', 'interrupted', 'uncertain'],
+    dispatched: ['accepted', 'failed', 'interrupted', 'uncertain'],
+    accepted: ['completed', 'failed', 'interrupted', 'uncertain'],
+    completed: [],
+    failed: [],
+    interrupted: [],
+    // accepted is only for unique native evidence via recoverUncertainOperation.
+    // A probe that merely finds an activity must not complete the operation.
+    uncertain: ['accepted', 'completed', 'failed', 'interrupted', 'uncertain'],
+};
+export function canTransitionOperation(from, to) {
+    return OPERATION_TRANSITIONS[from].includes(to);
+}
+export function assertOperationTransition(from, to) {
+    if (!canTransitionOperation(from, to)) {
+        throw new Error(`illegal_operation_transition:${from}:${to}`);
+    }
+}
+export const logTailSchema = z
+    .object({
+    text: z.string().max(2_100_000),
+    size: z.number().int().nonnegative(),
+    offset: z.number().int().nonnegative(),
+})
+    .strict();
+export const operationLogSchema = logTailSchema;
+export const operationAcceptRequestSchema = z
+    .object({
+    clientRequestId: z.string().trim().min(1).max(128),
+    kind: operationKindSchema,
+    workspaceId: z.string().trim().min(1).max(128).optional(),
+    directoryName: workspaceSessionScopeSchema.optional(),
+    sessionId: z.string().trim().min(1).max(128).optional(),
+    expectedRevision: z.number().int().nonnegative().optional(),
+    payload: z.unknown(),
+    /** Trusted transport data, excluded from the operation's stable payload hash and receipt. */
+    remixReferenceSnapshot: workspaceRemixReferenceExportSchema.optional(),
+    /** Library exports supplied by the trusted dispatcher; browser selections stay in payload. */
+    libraryAssetImports: workspaceAssetLibraryImportTransportSchema.optional(),
+    /**
+     * Sent with a turn on a session whose native thread was lost, letting the sandbox resume or
+     * replace that thread. Kept outside the payload: the session's history keeps growing, and a
+     * retry must still hash as the same request.
+     */
+    sessionRecovery: z
+        .object({
+        context: z.string().max(64_000),
+        /** Original thread mapping supplied by the trusted runtime server, never browser input. */
+        nativeThreadId: z.string().trim().min(1).max(128).optional(),
+        modelConfigId: z.string().uuid().optional(),
+        reasoningEffort: reasoningEffortSchema.optional(),
+        permissionMode: workspacePermissionModeSchema.optional(),
+    })
+        .strict()
+        .optional(),
+})
+    .strict().refine(value => !value.remixReferenceSnapshot || value.kind === 'workspace.references.import', 'unexpected_remix_reference_snapshot').refine(value => !value.libraryAssetImports || value.kind === 'asset.library.import', 'unexpected_library_asset_imports');
+/**
+ * Why a turn failed because its session has no usable Codex thread. Each is decided before the
+ * message reaches Codex, so the same turn may be sent again with a `sessionRecovery`.
+ */
+export const LOST_THREAD_ERRORS = ['native_not_recoverable', 'unknown_session', 'unknown_thread'];
+export function isLostThreadError(error) {
+    return LOST_THREAD_ERRORS.includes(error);
+}
+export const operationRecordSchema = z
+    .object({
+    operationId: z.string().min(1).max(128),
+    environment: z.string().min(1).max(64),
+    userId: z.string().min(1).max(128),
+    clientRequestId: z.string().min(1).max(128),
+    kind: operationKindSchema,
+    status: operationStatusSchema,
+    payloadHash: z.string().length(64),
+    workspaceId: z.string().min(1).max(128).optional(),
+    directoryName: workspaceSessionScopeSchema.optional(),
+    sessionId: z.string().min(1).max(128).optional(),
+    expectedRevision: z.number().int().nonnegative().optional(),
+    generation: z.number().int().nonnegative().optional(),
+    runtimeEpoch: z.number().int().nonnegative().optional(),
+    leaseFence: z.number().int().nonnegative().optional(),
+    nativeRequestId: z.string().min(1).max(128).optional(),
+    nativeThreadId: z.string().min(1).max(128).optional(),
+    nativeTurnId: z.string().min(1).max(128).optional(),
+    modelConfigId: z.string().uuid().optional(),
+    reasoningEffort: reasoningEffortSchema.optional(),
+    permissionMode: workspacePermissionModeSchema.optional(),
+    workMode: workspaceWorkModeSchema.optional(),
+    context: workspaceComposerContextSchema.optional(),
+    remixReference: workspaceRemixReferenceSchema.optional(),
+    result: z.union([workspaceAssetLibraryImportResultSchema, parameterAgentTaskRecordSchema]).optional(),
+    userText: z.string().optional(),
+    reviewTarget: workspaceReviewTargetSchema.optional(),
+    expectedTurnId: z.string().min(1).max(128).optional(),
+    nativeApprovalId: z.string().min(1).max(128).optional(),
+    sandboxOperationId: z.string().min(1).max(128).optional(),
+    checkpointId: z.string().min(1).max(128).optional(),
+    checkpointKind: checkpointKindSchema.optional(),
+    checkpointConsistent: z.boolean().optional(),
+    snapshotManifestKey: z.string().min(1).max(512).optional(),
+    snapshotChecksum: z.string().length(64).optional(),
+    snapshotStatus: z.enum(['complete', 'incomplete']).optional(),
+    terminalId: z.string().min(1).max(128).optional(),
+    cwd: z.string().max(512).optional(),
+    error: z.string().min(1).max(256).optional(),
+    createdAt: z.string().min(1),
+    updatedAt: z.string().min(1),
+})
+    .strict();
+export function operationScopeKey(input) {
+    return [
+        input.environment,
+        input.userId,
+        input.workspaceId ?? '-',
+        input.directoryName ?? 'basic',
+        input.sessionId ?? '-',
+        input.kind,
+        input.clientRequestId,
+    ].join(':');
+}
+export function hashOperationPayload(payload) {
+    return createHash('sha256').update(stableStringify(payload)).digest('hex');
+}
+export function resolveIdempotentAccept(existing, payloadHash) {
+    if (!existing)
+        return { action: 'create' };
+    if (existing.payloadHash === payloadHash)
+        return { action: 'reuse', operation: existing };
+    return { action: 'conflict', operation: existing };
+}
+export function transitionOperation(operation, to, patch = {}) {
+    assertOperationTransition(operation.status, to);
+    return operationRecordSchema.parse({
+        ...operation,
+        ...patch,
+        status: to,
+        updatedAt: new Date().toISOString(),
+    });
+}
+export function recoverUncertainOperation(operation, evidence) {
+    if (operation.status !== 'uncertain') {
+        throw new Error('uncertain_recovery_requires_uncertain');
+    }
+    const nativeThreadId = evidence.nativeThreadId.trim();
+    const nativeTurnId = evidence.nativeTurnId.trim();
+    if (!nativeThreadId || !nativeTurnId) {
+        throw new Error('native_evidence_required');
+    }
+    const to = evidence.kind === 'running' ? 'accepted' : evidence.status;
+    return transitionOperation(operation, to, { nativeThreadId, nativeTurnId });
+}
+export function stableStringify(value) {
+    return JSON.stringify(sortValue(value));
+}
+function sortValue(value) {
+    if (Array.isArray(value))
+        return value.map(sortValue);
+    if (value && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, nested]) => [key, sortValue(nested)]));
+    }
+    return value;
+}
+//# sourceMappingURL=operations.js.map

package/dist/cloud-workspace/runtime/operations.js.map

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

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

@@ -0,0 +1,255 @@
+import { z } from 'zod';
+export declare const parameterAgentTaskRequestSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    taskId: z.ZodString;
+    action: z.ZodEnum<{
+        discover: "discover";
+        add: "add";
+        admit: "admit";
+    }>;
+    goal: z.ZodOptional<z.ZodString>;
+    sourceFingerprint: z.ZodOptional<z.ZodString>;
+    candidate: z.ZodOptional<z.ZodObject<{
+        taskId: z.ZodString;
+        candidateId: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ParameterAgentTaskRequest = z.infer<typeof parameterAgentTaskRequestSchema>;
+export declare const parameterAgentEvidenceSchema: z.ZodObject<{
+    path: z.ZodString;
+    line: z.ZodOptional<z.ZodNumber>;
+    summary: z.ZodString;
+}, z.core.$strict>;
+export declare const parameterAgentCandidateSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    fieldPath: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    origins: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        summary: z.ZodString;
+    }, z.core.$strict>>;
+    consumers: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        summary: z.ZodString;
+    }, z.core.$strict>>;
+    status: z.ZodEnum<{
+        candidate: "candidate";
+        implemented: "implemented";
+        blocked: "blocked";
+    }>;
+    missing: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type ParameterAgentCandidate = z.infer<typeof parameterAgentCandidateSchema>;
+export declare const parameterAgentReportSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    taskId: z.ZodString;
+    sources: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        sha256: z.ZodString;
+    }, z.core.$strict>>;
+    candidates: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        fieldPath: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        origins: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            line: z.ZodOptional<z.ZodNumber>;
+            summary: z.ZodString;
+        }, z.core.$strict>>;
+        consumers: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            line: z.ZodOptional<z.ZodNumber>;
+            summary: z.ZodString;
+        }, z.core.$strict>>;
+        status: z.ZodEnum<{
+            candidate: "candidate";
+            implemented: "implemented";
+            blocked: "blocked";
+        }>;
+        missing: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ParameterAgentReport = z.infer<typeof parameterAgentReportSchema>;
+export declare const PARAMETER_AGENT_TASK_STATUSES: readonly ["running", "reported", "candidates", "checking", "verified", "needs-verification", "missing", "failed", "stale", "invalid", "uncertain", "interrupted"];
+export declare const parameterAgentCheckSchema: z.ZodObject<{
+    script: z.ZodEnum<{
+        "test:parameters": "test:parameters";
+        build: "build";
+        typecheck: "typecheck";
+    }>;
+    code: z.ZodNullable<z.ZodNumber>;
+    timedOut: z.ZodBoolean;
+    canceled: z.ZodOptional<z.ZodBoolean>;
+    logDigest: z.ZodString;
+    startedAt: z.ZodString;
+    finishedAt: z.ZodString;
+}, z.core.$strict>;
+export type ParameterAgentCheck = z.infer<typeof parameterAgentCheckSchema>;
+export declare const parameterAgentTaskRecordSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    taskId: z.ZodString;
+    action: z.ZodEnum<{
+        discover: "discover";
+        add: "add";
+        admit: "admit";
+    }>;
+    goal: z.ZodOptional<z.ZodString>;
+    workspaceId: z.ZodString;
+    directoryName: z.ZodString;
+    sessionId: z.ZodString;
+    generation: z.ZodNumber;
+    runtimeEpoch: z.ZodNumber;
+    status: z.ZodEnum<{
+        failed: "failed";
+        missing: "missing";
+        invalid: "invalid";
+        candidates: "candidates";
+        running: "running";
+        reported: "reported";
+        checking: "checking";
+        verified: "verified";
+        "needs-verification": "needs-verification";
+        stale: "stale";
+        uncertain: "uncertain";
+        interrupted: "interrupted";
+    }>;
+    reportPath: z.ZodString;
+    report: z.ZodOptional<z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        taskId: z.ZodString;
+        sources: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            sha256: z.ZodString;
+        }, z.core.$strict>>;
+        candidates: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            fieldPath: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            origins: z.ZodArray<z.ZodObject<{
+                path: z.ZodString;
+                line: z.ZodOptional<z.ZodNumber>;
+                summary: z.ZodString;
+            }, z.core.$strict>>;
+            consumers: z.ZodArray<z.ZodObject<{
+                path: z.ZodString;
+                line: z.ZodOptional<z.ZodNumber>;
+                summary: z.ZodString;
+            }, z.core.$strict>>;
+            status: z.ZodEnum<{
+                candidate: "candidate";
+                implemented: "implemented";
+                blocked: "blocked";
+            }>;
+            missing: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    checks: z.ZodArray<z.ZodObject<{
+        script: z.ZodEnum<{
+            "test:parameters": "test:parameters";
+            build: "build";
+            typecheck: "typecheck";
+        }>;
+        code: z.ZodNullable<z.ZodNumber>;
+        timedOut: z.ZodBoolean;
+        canceled: z.ZodOptional<z.ZodBoolean>;
+        logDigest: z.ZodString;
+        startedAt: z.ZodString;
+        finishedAt: z.ZodString;
+    }, z.core.$strict>>;
+    sourceDigest: z.ZodOptional<z.ZodString>;
+    receiptId: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strict>;
+export type ParameterAgentTaskRecord = z.infer<typeof parameterAgentTaskRecordSchema>;
+export declare const parameterAgentTaskListSchema: z.ZodObject<{
+    tasks: z.ZodArray<z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        taskId: z.ZodString;
+        action: z.ZodEnum<{
+            discover: "discover";
+            add: "add";
+            admit: "admit";
+        }>;
+        goal: z.ZodOptional<z.ZodString>;
+        workspaceId: z.ZodString;
+        directoryName: z.ZodString;
+        sessionId: z.ZodString;
+        generation: z.ZodNumber;
+        runtimeEpoch: z.ZodNumber;
+        status: z.ZodEnum<{
+            failed: "failed";
+            missing: "missing";
+            invalid: "invalid";
+            candidates: "candidates";
+            running: "running";
+            reported: "reported";
+            checking: "checking";
+            verified: "verified";
+            "needs-verification": "needs-verification";
+            stale: "stale";
+            uncertain: "uncertain";
+            interrupted: "interrupted";
+        }>;
+        reportPath: z.ZodString;
+        report: z.ZodOptional<z.ZodObject<{
+            version: z.ZodLiteral<1>;
+            taskId: z.ZodString;
+            sources: z.ZodArray<z.ZodObject<{
+                path: z.ZodString;
+                sha256: z.ZodString;
+            }, z.core.$strict>>;
+            candidates: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                fieldPath: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                origins: z.ZodArray<z.ZodObject<{
+                    path: z.ZodString;
+                    line: z.ZodOptional<z.ZodNumber>;
+                    summary: z.ZodString;
+                }, z.core.$strict>>;
+                consumers: z.ZodArray<z.ZodObject<{
+                    path: z.ZodString;
+                    line: z.ZodOptional<z.ZodNumber>;
+                    summary: z.ZodString;
+                }, z.core.$strict>>;
+                status: z.ZodEnum<{
+                    candidate: "candidate";
+                    implemented: "implemented";
+                    blocked: "blocked";
+                }>;
+                missing: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        checks: z.ZodArray<z.ZodObject<{
+            script: z.ZodEnum<{
+                "test:parameters": "test:parameters";
+                build: "build";
+                typecheck: "typecheck";
+            }>;
+            code: z.ZodNullable<z.ZodNumber>;
+            timedOut: z.ZodBoolean;
+            canceled: z.ZodOptional<z.ZodBoolean>;
+            logDigest: z.ZodString;
+            startedAt: z.ZodString;
+            finishedAt: z.ZodString;
+        }, z.core.$strict>>;
+        sourceDigest: z.ZodOptional<z.ZodString>;
+        receiptId: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const parameterAgentVerifyPayloadSchema: z.ZodObject<{
+    taskId: z.ZodString;
+}, z.core.$strict>;
+export type ParameterAgentVerifyPayload = z.infer<typeof parameterAgentVerifyPayloadSchema>;
+//# sourceMappingURL=parameter-agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parameter-agent.d.ts","sourceRoot":"","sources":["../../../src/cloud-workspace/runtime/parameter-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;kBAW1C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,eAAO,MAAM,4BAA4B;;;;kBAI9B,CAAC;AACZ,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;kBAS/B,CAAC;AACZ,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AACpF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAUrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,6BAA6B,mKAEhC,CAAC;AACX,eAAO,MAAM,yBAAyB;;;;;;;;;;;;kBAQ3B,CAAC;AACZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmBhC,CAAC;AACZ,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AACtF,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAiF,CAAC;AAC3H,eAAO,MAAM,iCAAiC;;kBAAmD,CAAC;AAClG,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC"}

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

@@ -0,0 +1,82 @@
+import { z } from 'zod';
+import { parameterFieldPathSchema } from './parameters.js';
+import { workspaceRelativePathSchema } from './files.js';
+const digestSchema = z.string().regex(/^[a-f0-9]{64}$/);
+const candidateIdSchema = z.string().min(1).max(128).regex(/^[A-Za-z0-9][A-Za-z0-9._-]*$/);
+export const parameterAgentTaskRequestSchema = z.object({
+    version: z.literal(1),
+    taskId: z.string().uuid(),
+    action: z.enum(['discover', 'add', 'admit']),
+    goal: z.string().trim().min(1).max(4000).optional(),
+    sourceFingerprint: digestSchema.optional(),
+    candidate: z.object({ taskId: z.string().uuid(), candidateId: candidateIdSchema }).strict().optional(),
+}).strict().superRefine((value, context) => {
+    if (value.action === 'add' && !value.goal)
+        context.addIssue({ code: 'custom', message: 'parameter_goal_required', path: ['goal'] });
+    if (value.action === 'admit' && !value.candidate)
+        context.addIssue({ code: 'custom', message: 'parameter_candidate_required', path: ['candidate'] });
+    if (value.action !== 'admit' && value.candidate)
+        context.addIssue({ code: 'custom', message: 'parameter_candidate_unexpected', path: ['candidate'] });
+});
+export const parameterAgentEvidenceSchema = z.object({
+    path: workspaceRelativePathSchema,
+    line: z.number().int().positive().max(1_000_000).optional(),
+    summary: z.string().trim().min(1).max(2000),
+}).strict();
+export const parameterAgentCandidateSchema = z.object({
+    id: candidateIdSchema,
+    title: z.string().trim().min(1).max(256),
+    description: z.string().max(4000).optional(),
+    fieldPath: parameterFieldPathSchema.optional(),
+    origins: z.array(parameterAgentEvidenceSchema).min(1).max(32),
+    consumers: z.array(parameterAgentEvidenceSchema).max(32),
+    status: z.enum(['candidate', 'implemented', 'blocked']),
+    missing: z.array(z.string().min(1).max(1000)).max(32),
+}).strict();
+export const parameterAgentReportSchema = z.object({
+    version: z.literal(1),
+    taskId: z.string().uuid(),
+    sources: z.array(z.object({ path: workspaceRelativePathSchema, sha256: digestSchema }).strict()).min(1).max(2048),
+    candidates: z.array(parameterAgentCandidateSchema).max(128),
+}).strict().superRefine((value, context) => {
+    for (const key of ['sources', 'candidates']) {
+        const identities = value[key].map(item => 'path' in item ? item.path : item.id);
+        if (new Set(identities).size !== identities.length)
+            context.addIssue({ code: 'custom', message: 'parameter_report_duplicate', path: [key] });
+    }
+});
+export const PARAMETER_AGENT_TASK_STATUSES = [
+    'running', 'reported', 'candidates', 'checking', 'verified', 'needs-verification', 'missing', 'failed', 'stale', 'invalid', 'uncertain', 'interrupted',
+];
+export const parameterAgentCheckSchema = z.object({
+    script: z.enum(['test:parameters', 'build', 'typecheck']),
+    code: z.number().int().nullable(),
+    timedOut: z.boolean(),
+    canceled: z.boolean().optional(),
+    logDigest: digestSchema,
+    startedAt: z.string().min(1),
+    finishedAt: z.string().min(1),
+}).strict();
+export const parameterAgentTaskRecordSchema = z.object({
+    version: z.literal(1),
+    taskId: z.string().uuid(),
+    action: z.enum(['discover', 'add', 'admit']),
+    goal: z.string().max(4000).optional(),
+    workspaceId: z.string().min(1).max(128),
+    directoryName: z.string().min(1).max(128),
+    sessionId: z.string().min(1).max(128),
+    generation: z.number().int().nonnegative(),
+    runtimeEpoch: z.number().int().nonnegative(),
+    status: z.enum(PARAMETER_AGENT_TASK_STATUSES),
+    reportPath: workspaceRelativePathSchema,
+    report: parameterAgentReportSchema.optional(),
+    checks: z.array(parameterAgentCheckSchema).max(3),
+    sourceDigest: digestSchema.optional(),
+    receiptId: z.string().uuid().optional(),
+    error: z.string().min(1).max(256).optional(),
+    createdAt: z.string().min(1),
+    updatedAt: z.string().min(1),
+}).strict();
+export const parameterAgentTaskListSchema = z.object({ tasks: z.array(parameterAgentTaskRecordSchema).max(256) }).strict();
+export const parameterAgentVerifyPayloadSchema = z.object({ taskId: z.string().uuid() }).strict();
+//# sourceMappingURL=parameter-agent.js.map