@zhin.js/agent 1.1.13 → 1.1.14

package/lib/workroom/local-assignment-executor.js

@@ -0,0 +1,197 @@
+import { assertAssignmentExecutionEnvelope, validateAssignmentExecutionObservation, } from './assignment-executor.js';
+import { createWorkroomDeferredCapabilityPlan, } from '../plugin-runtime/deferred-capability-plan.js';
+/** Local transport adapter for the shared Assignment Executor lifecycle. */
+export class LocalAssignmentExecutor {
+    model;
+    capabilityProjection;
+    constructor(model, capabilityProjection) {
+        this.model = model;
+        this.capabilityProjection = capabilityProjection;
+    }
+    async *execute(envelope, signal) {
+        assertAssignmentExecutionEnvelope(envelope);
+        signal.throwIfAborted();
+        const projection = await awaitAbortable(() => this.capabilityProjection.resolve(envelope, signal), signal, 'Local capability projection cancelled', late => late.release());
+        let completion;
+        try {
+            signal.throwIfAborted();
+            const capabilityPlan = createWorkroomDeferredCapabilityPlan({
+                capabilities: projection.capabilities,
+                authority: Object.freeze({
+                    kind: 'workroom_assignment',
+                    envelope,
+                    capabilitySnapshot: projection.capabilitySnapshot,
+                    realization: projection.realization,
+                }),
+                sessionSnapshot: projection.sessionSnapshot,
+                config: projection.config,
+                platform: projection.platform,
+                persistSnapshot: projection.persistSnapshot,
+            });
+            const request = Object.freeze({
+                envelope,
+                capabilityPlan,
+                ...(projection.agentDefinitionId === undefined
+                    ? {}
+                    : { agentDefinitionId: projection.agentDefinitionId }),
+            });
+            completion = yield* executeLocalModel(this.model, request, signal);
+        }
+        finally {
+            projection.release();
+        }
+        signal.throwIfAborted();
+        yield completion;
+    }
+}
+async function* executeLocalModel(model, request, signal) {
+    let completion;
+    const seenEventIds = new Set();
+    const iterator = model.execute(request, signal)[Symbol.asyncIterator]();
+    let streamEnded = false;
+    try {
+        while (true) {
+            const next = await awaitAbortable(() => iterator.next(), signal, 'Local model execution cancelled');
+            if (next.done) {
+                streamEnded = true;
+                break;
+            }
+            signal.throwIfAborted();
+            if (seenEventIds.has(next.value.eventId)) {
+                throw new Error(`Local model execution repeated eventId ${next.value.eventId}`);
+            }
+            seenEventIds.add(next.value.eventId);
+            const observation = projectLocalModelEvent(request.envelope, next.value);
+            if (completion) {
+                throw new Error('Local model execution emitted an event after execution_completed');
+            }
+            if (observation.type === 'execution_completed') {
+                completion = observation;
+                continue;
+            }
+            yield observation;
+        }
+    }
+    finally {
+        if (!streamEnded)
+            stopIteratorWithoutWaiting(iterator);
+    }
+    if (!completion)
+        throw new Error('Local model execution ended without execution_completed');
+    return completion;
+}
+function projectLocalModelEvent(envelope, value) {
+    const event = requireEventRecord(value);
+    if (event.version !== 1) {
+        throw new Error('Local model execution event version is unsupported');
+    }
+    if (typeof event.eventId !== 'string'
+        || !/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/u.test(event.eventId)) {
+        throw new Error('Local model execution eventId is invalid');
+    }
+    const observationId = `local/${envelope.assignmentId}/${envelope.attempt}/${envelope.fence}/${event.eventId}`;
+    if (event.type === 'heartbeat') {
+        assertExactEventKeys(event, ['version', 'type', 'eventId']);
+        return validateAssignmentExecutionObservation(envelope, {
+            version: 1,
+            type: event.type,
+            observationId,
+            envelopeDigest: envelope.digest,
+        });
+    }
+    if (event.type === 'progress') {
+        assertExactEventKeys(event, ['version', 'type', 'eventId', 'progress']);
+        return validateAssignmentExecutionObservation(envelope, {
+            version: 1,
+            type: event.type,
+            observationId,
+            envelopeDigest: envelope.digest,
+            progress: event.progress,
+        });
+    }
+    if (event.type === 'checkpoint') {
+        assertExactEventKeys(event, ['version', 'type', 'eventId', 'checkpoint']);
+        return validateAssignmentExecutionObservation(envelope, {
+            version: 1,
+            type: event.type,
+            observationId,
+            envelopeDigest: envelope.digest,
+            checkpoint: event.checkpoint,
+        });
+    }
+    if (event.type !== 'execution_completed') {
+        throw new Error('Local model execution emitted an unsupported event type');
+    }
+    assertExactEventKeys(event, ['version', 'type', 'eventId', 'completion']);
+    return validateAssignmentExecutionObservation(envelope, {
+        version: 1,
+        type: event.type,
+        observationId,
+        envelopeDigest: envelope.digest,
+        completion: event.completion,
+    });
+}
+function requireEventRecord(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('Local model execution event must be an object');
+    }
+    return value;
+}
+function assertExactEventKeys(event, allowed) {
+    const forbidden = Object.keys(event).find((key) => !allowed.includes(key));
+    if (forbidden) {
+        throw new Error(`Local model execution event contains forbidden field ${forbidden}`);
+    }
+}
+function awaitAbortable(operation, signal, cancellationMessage, onLateResolve) {
+    signal.throwIfAborted();
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const finish = (operation) => {
+            if (settled)
+                return;
+            settled = true;
+            signal.removeEventListener('abort', onAbort);
+            operation();
+        };
+        const onAbort = () => {
+            finish(() => reject(signal.reason ?? new DOMException(cancellationMessage, 'AbortError')));
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+        if (signal.aborted) {
+            onAbort();
+            return;
+        }
+        let pending;
+        try {
+            pending = operation();
+        }
+        catch (error) {
+            finish(() => reject(error));
+            return;
+        }
+        Promise.resolve(pending).then((result) => {
+            if (settled) {
+                try {
+                    onLateResolve?.(result);
+                }
+                catch {
+                    // The caller already owns the abort outcome; late cleanup is best-effort.
+                }
+                return;
+            }
+            finish(() => resolve(result));
+        }, (error) => finish(() => reject(error)));
+    });
+}
+function stopIteratorWithoutWaiting(iterator) {
+    try {
+        const pending = iterator.return?.();
+        if (pending)
+            void Promise.resolve(pending).catch(() => undefined);
+    }
+    catch {
+        // Caller cancellation owns the public outcome; cleanup is best-effort.
+    }
+}
+//# sourceMappingURL=local-assignment-executor.js.map

package/lib/workroom/local-assignment-executor.js.map

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

package/lib/workroom/local-assignment-issuance.d.ts

@@ -0,0 +1,68 @@
+import { type AssignmentExecutionEnvelope, type AssignmentExecutionFactAnchor, type AssignmentExecutionSnapshotReference, type AssignmentExecutionWorkspaceReference, type AssignmentExecutorRole } from './assignment-executor.js';
+import type { WorkroomAcceptanceContract } from './acceptance-policy.js';
+export interface WorkroomLocalAssignmentClaimRequest {
+    readonly operationId: string;
+    readonly projectId: string;
+    readonly runId: string;
+    readonly taskKey: string;
+    readonly agentDefinitionId: string;
+}
+export interface WorkroomLocalAssignmentAuthorityInput {
+    readonly projectId: string;
+    readonly runId: string;
+    readonly task: Readonly<{
+        key: string;
+        revision: number;
+        acceptanceContract: WorkroomAcceptanceContract;
+    }>;
+    readonly assignment: Readonly<{
+        id: string;
+        revision: number;
+        attempt: number;
+        fence: number;
+    }>;
+    readonly requestedAgentDefinitionId: string;
+    readonly factAnchor: AssignmentExecutionFactAnchor;
+}
+export interface WorkroomLocalAssignmentResolvedAuthority {
+    readonly principalId: string;
+    readonly role: AssignmentExecutorRole;
+    readonly agentDefinitionId: string;
+    readonly agentDefinition: AssignmentExecutionSnapshotReference;
+    readonly plan: AssignmentExecutionSnapshotReference;
+    readonly contextPolicy: AssignmentExecutionSnapshotReference;
+    readonly capabilitySnapshot: AssignmentExecutionSnapshotReference;
+    readonly policySnapshot: AssignmentExecutionSnapshotReference;
+    readonly workspace: AssignmentExecutionWorkspaceReference;
+    readonly contextView: Readonly<{
+        ref: string;
+        hash: string;
+    }>;
+    readonly capabilityGrantRef: string;
+}
+export interface WorkroomLocalAssignmentAuthorityPort {
+    resolveLocal(input: WorkroomLocalAssignmentAuthorityInput): Promise<WorkroomLocalAssignmentResolvedAuthority>;
+}
+export interface WorkroomLocalAssignmentIssuance {
+    readonly operationId: string;
+    readonly requestDigest: string;
+    readonly agentDefinitionId: string;
+    readonly issuedAt: number;
+    readonly envelope: AssignmentExecutionEnvelope;
+}
+export declare function normalizeWorkroomLocalAssignmentClaimRequest(value: WorkroomLocalAssignmentClaimRequest): WorkroomLocalAssignmentClaimRequest;
+export declare function workroomLocalAssignmentRequestDigest(request: WorkroomLocalAssignmentClaimRequest): string;
+export declare function workroomLocalAssignmentId(operationId: string): string;
+export declare function materializeWorkroomLocalAssignment(input: Readonly<{
+    request: WorkroomLocalAssignmentClaimRequest;
+    taskRevision: number;
+    assignmentId: string;
+    assignmentRevision: number;
+    attempt: number;
+    fence: number;
+    issuedAt: number;
+    factAnchor: AssignmentExecutionFactAnchor;
+    authority: WorkroomLocalAssignmentResolvedAuthority;
+}>): WorkroomLocalAssignmentIssuance;
+export declare function parseWorkroomLocalAssignmentIssuance(value: unknown): WorkroomLocalAssignmentIssuance;
+//# sourceMappingURL=local-assignment-issuance.d.ts.map

package/lib/workroom/local-assignment-issuance.d.ts.map

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

package/lib/workroom/local-assignment-issuance.js

@@ -0,0 +1,128 @@
+import { createAssignmentExecutionEnvelope, } from './assignment-executor.js';
+import { canonicalWorkroomJson, deepFreezeWorkroomValue as deepFreeze, digestCanonicalWorkroomValue as digest, } from './canonical-value.js';
+export function normalizeWorkroomLocalAssignmentClaimRequest(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('Local Assignment request must be an object');
+    }
+    const expected = [
+        'operationId', 'projectId', 'runId', 'taskKey', 'agentDefinitionId',
+    ].sort();
+    const keys = Object.keys(value).sort();
+    if (keys.length !== expected.length || keys.some((key, index) => key !== expected[index])) {
+        throw new Error('Local Assignment request contains forbidden identity or authority fields');
+    }
+    return deepFreeze({
+        operationId: text(value.operationId, 'operationId'),
+        projectId: text(value.projectId, 'projectId'),
+        runId: text(value.runId, 'runId'),
+        taskKey: text(value.taskKey, 'taskKey'),
+        agentDefinitionId: text(value.agentDefinitionId, 'agentDefinitionId'),
+    });
+}
+export function workroomLocalAssignmentRequestDigest(request) {
+    return digest({ version: 1, ...normalizeWorkroomLocalAssignmentClaimRequest(request) });
+}
+export function workroomLocalAssignmentId(operationId) {
+    return `local-assignment:v1:${encodeURIComponent(text(operationId, 'operationId'))}`;
+}
+export function materializeWorkroomLocalAssignment(input) {
+    const request = normalizeWorkroomLocalAssignmentClaimRequest(input.request);
+    positive(input.taskRevision, 'taskRevision');
+    positive(input.assignmentRevision, 'assignmentRevision');
+    positive(input.attempt, 'attempt');
+    positive(input.fence, 'fence');
+    timestamp(input.issuedAt, 'issuedAt');
+    if (input.authority.agentDefinitionId !== request.agentDefinitionId) {
+        throw new Error('Resolved Local Assignment Agent Definition does not match the request');
+    }
+    if (input.authority.role !== 'executor' && input.authority.role !== 'integration') {
+        throw new Error('Resolved Local Assignment role is not executable');
+    }
+    if (input.authority.workspace.fence !== input.fence) {
+        throw new Error('Resolved Local Assignment Workspace fence drift');
+    }
+    const envelope = createAssignmentExecutionEnvelope({
+        projectId: request.projectId,
+        runId: request.runId,
+        taskKey: request.taskKey,
+        taskRevision: input.taskRevision,
+        assignmentId: text(input.assignmentId, 'assignmentId'),
+        assignmentRevision: input.assignmentRevision,
+        attempt: input.attempt,
+        fence: input.fence,
+        principalId: text(input.authority.principalId, 'principalId'),
+        role: input.authority.role,
+        agentDefinition: input.authority.agentDefinition,
+        plan: input.authority.plan,
+        contextPolicy: input.authority.contextPolicy,
+        factAnchor: input.factAnchor,
+        capabilitySnapshot: input.authority.capabilitySnapshot,
+        policySnapshot: input.authority.policySnapshot,
+        workspace: input.authority.workspace,
+    });
+    return deepFreeze({
+        operationId: request.operationId,
+        requestDigest: workroomLocalAssignmentRequestDigest(request),
+        agentDefinitionId: request.agentDefinitionId,
+        issuedAt: input.issuedAt,
+        envelope,
+    });
+}
+export function parseWorkroomLocalAssignmentIssuance(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('Persisted Local Assignment issuance must be an object');
+    }
+    const record = value;
+    const expected = [
+        'operationId', 'requestDigest', 'agentDefinitionId', 'issuedAt', 'envelope',
+    ].sort();
+    const keys = Object.keys(record).sort();
+    if (keys.length !== expected.length || keys.some((key, index) => key !== expected[index])) {
+        throw new Error('Persisted Local Assignment issuance has invalid keys');
+    }
+    const operationId = text(record.operationId, 'operationId');
+    const agentDefinitionId = text(record.agentDefinitionId, 'agentDefinitionId');
+    if (!/^sha256:[a-f0-9]{64}$/u.test(record.requestDigest ?? '')) {
+        throw new Error('Persisted Local Assignment requestDigest is invalid');
+    }
+    const issuedAt = timestamp(record.issuedAt, 'issuedAt');
+    const persisted = record.envelope;
+    if (!persisted || typeof persisted !== 'object') {
+        throw new Error('Persisted Local Assignment Envelope is invalid');
+    }
+    const { version: _version, digest: persistedDigest, ...input } = persisted;
+    const envelope = createAssignmentExecutionEnvelope(input);
+    if (persistedDigest !== envelope.digest) {
+        throw new Error('Persisted Local Assignment Envelope digest drift');
+    }
+    const issuance = deepFreeze({
+        operationId,
+        requestDigest: record.requestDigest,
+        agentDefinitionId,
+        issuedAt,
+        envelope,
+    });
+    if (canonicalWorkroomJson(issuance) !== canonicalWorkroomJson(value)) {
+        throw new Error('Persisted Local Assignment issuance is not canonical');
+    }
+    return issuance;
+}
+function text(value, label) {
+    if (typeof value !== 'string' || !value.trim() || value !== value.trim()) {
+        throw new Error(`Local Assignment ${label} is required`);
+    }
+    return value;
+}
+function positive(value, label) {
+    if (!Number.isSafeInteger(value) || Number(value) < 1) {
+        throw new Error(`Local Assignment ${label} must be a positive safe integer`);
+    }
+    return Number(value);
+}
+function timestamp(value, label) {
+    if (!Number.isFinite(value) || Number(value) < 0) {
+        throw new Error(`Local Assignment ${label} must be a finite timestamp`);
+    }
+    return Number(value);
+}
+//# sourceMappingURL=local-assignment-issuance.js.map

package/lib/workroom/local-assignment-issuance.js.map

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

package/lib/workroom/plan-approval-control.d.ts

@@ -0,0 +1,52 @@
+export type WorkroomPlanGateDecision = 'approve' | 'reject' | 'request_changes' | 'cancel';
+export interface WorkroomPlanGateDecisionInput {
+    readonly operationId: string;
+    readonly projectId: string;
+    readonly runId: string;
+    readonly taskKey: string;
+    readonly taskRevision: number;
+    readonly gateId: string;
+    readonly expectedSequence: number;
+    readonly decision: WorkroomPlanGateDecision;
+    readonly reason: string;
+    readonly sponsorPrincipalId: string;
+    readonly sponsorAuthorityRef: string;
+}
+/** Exact Kernel-derived scope presented to a trusted Sponsor authority port. */
+export interface WorkroomPlanGateAuthorizationInput extends WorkroomPlanGateDecisionInput {
+    readonly version: 1;
+    readonly planProposalId: string;
+    readonly planDigest: string;
+    readonly projectRevision: string;
+    readonly projectDigest: string;
+    readonly sourceParameterDigest: string;
+    readonly profileRevisionId: string;
+    readonly profileDigest: string;
+    readonly policyRevisionId: string;
+    readonly policyDigest: string;
+    readonly gateOwner: string;
+    readonly gateDeadline: number;
+}
+export type WorkroomPlanGateAuthorizationDecision = Readonly<{
+    authorized: true;
+    principalId: string;
+    authorizationRef: string;
+}> | Readonly<{
+    authorized: false;
+    reason: string;
+}>;
+export interface WorkroomPlanGateAuthorityPort {
+    authorize(input: WorkroomPlanGateAuthorizationInput): WorkroomPlanGateAuthorizationDecision | Promise<WorkroomPlanGateAuthorizationDecision>;
+}
+export interface WorkroomPlanGateDecisionReceipt {
+    readonly status: 'committed' | 'duplicate';
+    readonly operationId: string;
+    readonly receiptRef: string;
+    readonly receiptDigest: string;
+    readonly state: import('./kernel-contracts.js').WorkroomRunState;
+}
+export declare class WorkroomPlanGateUnauthorizedError extends Error {
+    readonly reason: string;
+    constructor(reason: string);
+}
+//# sourceMappingURL=plan-approval-control.d.ts.map

package/lib/workroom/plan-approval-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-approval-control.d.ts","sourceRoot":"","sources":["../../src/workroom/plan-approval-control.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,QAAQ,GAAG,iBAAiB,GAAG,QAAQ,CAAC;AAE3F,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAED,gFAAgF;AAChF,MAAM,WAAW,kCAAmC,SAAQ,6BAA6B;IACvF,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,MAAM,qCAAqC,GAC7C,QAAQ,CAAC;IACP,UAAU,EAAE,IAAI,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC,GACF,QAAQ,CAAC;IAAE,UAAU,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEpD,MAAM,WAAW,6BAA6B;IAC5C,SAAS,CACP,KAAK,EAAE,kCAAkC,GACxC,qCAAqC,GAAG,OAAO,CAAC,qCAAqC,CAAC,CAAC;CAC3F;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAAC;IAC3C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,uBAAuB,EAAE,gBAAgB,CAAC;CAClE;AAED,qBAAa,iCAAkC,SAAQ,KAAK;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM;CAIpC"}

package/lib/workroom/plan-approval-control.js

@@ -0,0 +1,9 @@
+export class WorkroomPlanGateUnauthorizedError extends Error {
+    reason;
+    constructor(reason) {
+        super(`Plan Sponsor Gate decision is unauthorized: ${reason}`);
+        this.reason = reason;
+        this.name = 'WorkroomPlanGateUnauthorizedError';
+    }
+}
+//# sourceMappingURL=plan-approval-control.js.map

package/lib/workroom/plan-approval-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-approval-control.js","sourceRoot":"","sources":["../../src/workroom/plan-approval-control.ts"],"names":[],"mappings":"AAsDA,MAAM,OAAO,iCAAkC,SAAQ,KAAK;IACrC;IAArB,YAAqB,MAAc;QACjC,KAAK,CAAC,+CAA+C,MAAM,EAAE,CAAC,CAAC;QAD5C,WAAM,GAAN,MAAM,CAAQ;QAEjC,IAAI,CAAC,IAAI,GAAG,mCAAmC,CAAC;IAClD,CAAC;CACF"}

package/lib/workroom/plan-revision.d.ts

@@ -0,0 +1,44 @@
+import { type WorkflowPlanProposal, type WorkflowPlanTaskProposal } from './workflow-plan-builder.js';
+export interface WorkflowPlanRevisionProvenance {
+    readonly sourceRef: string;
+    readonly sourceDigest: string;
+}
+export interface WorkflowPlanRevisionDiff {
+    readonly added: readonly WorkflowPlanTaskProposal[];
+    readonly replaced: readonly Readonly<{
+        taskKey: string;
+        expectedTaskRevision: number;
+        task: WorkflowPlanTaskProposal;
+    }>[];
+    readonly removed: readonly Readonly<{
+        taskKey: string;
+        expectedTaskRevision: number;
+    }>[];
+}
+export interface WorkflowPlanRevisionCandidateInput {
+    readonly proposalId: string;
+    readonly projectId: string;
+    readonly runId: string;
+    readonly expectedSequence: number;
+    readonly basePlanRevision: number;
+    readonly basePlanDigest: string;
+    readonly baseTaskRevisions: Readonly<Record<string, number>>;
+    readonly provenance: WorkflowPlanRevisionProvenance;
+    readonly reason: string;
+    readonly basePlan: WorkflowPlanProposal;
+    readonly nextPlan: WorkflowPlanProposal;
+}
+export interface WorkflowPlanRevisionCandidate extends Omit<WorkflowPlanRevisionCandidateInput, 'basePlan'> {
+    readonly version: 1;
+    readonly type: 'plan_revision';
+    readonly diff: WorkflowPlanRevisionDiff;
+    readonly digest: string;
+}
+/**
+ * Canonical proposal constructor. This object deliberately carries no
+ * principal or authority claim; only WorkroomKernel may admit it.
+ */
+export declare function createWorkflowPlanRevisionCandidate(input: WorkflowPlanRevisionCandidateInput): WorkflowPlanRevisionCandidate;
+export declare function assertWorkflowPlanRevisionCandidate(value: WorkflowPlanRevisionCandidate): void;
+export declare function computeWorkflowPlanRevisionDiff(basePlan: WorkflowPlanProposal, nextPlan: WorkflowPlanProposal, baseTaskRevisions: Readonly<Record<string, number>>): WorkflowPlanRevisionDiff;
+//# sourceMappingURL=plan-revision.d.ts.map

package/lib/workroom/plan-revision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-revision.d.ts","sourceRoot":"","sources":["../../src/workroom/plan-revision.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC9B,MAAM,4BAA4B,CAAC;AAEpC,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,KAAK,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACpD,QAAQ,CAAC,QAAQ,EAAE,SAAS,QAAQ,CAAC;QACnC,OAAO,EAAE,MAAM,CAAC;QAChB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,IAAI,EAAE,wBAAwB,CAAC;KAChC,CAAC,EAAE,CAAC;IACL,QAAQ,CAAC,OAAO,EAAE,SAAS,QAAQ,CAAC;QAClC,OAAO,EAAE,MAAM,CAAC;QAChB,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC,EAAE,CAAC;CACN;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7D,QAAQ,CAAC,UAAU,EAAE,8BAA8B,CAAC;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;CACzC;AAED,MAAM,WAAW,6BACjB,SAAQ,IAAI,CAAC,kCAAkC,EAAE,UAAU,CAAC;IAC1D,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,kCAAkC,GACxC,6BAA6B,CAwC/B;AAED,wBAAgB,mCAAmC,CAAC,KAAK,EAAE,6BAA6B,GAAG,IAAI,CAmB9F;AAED,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,oBAAoB,EAC9B,QAAQ,EAAE,oBAAoB,EAC9B,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAClD,wBAAwB,CA2B1B"}