@zhin.js/agent 1.1.13 → 1.1.14

package/lib/workroom/human-ingress-application.js

@@ -0,0 +1,414 @@
+import { canonicalWorkroomJson, deepFreezeWorkroomValue as deepFreeze, digestCanonicalWorkroomValue, } from './canonical-value.js';
+export class HumanIngressApplicationSequenceConflictError extends Error {
+    projectId;
+    expectedSequence;
+    actualSequence;
+    constructor(projectId, expectedSequence, actualSequence) {
+        super(`Human ingress application ${projectId} sequence conflict: expected ${expectedSequence}, actual ${actualSequence}`);
+        this.projectId = projectId;
+        this.expectedSequence = expectedSequence;
+        this.actualSequence = actualSequence;
+        this.name = 'HumanIngressApplicationSequenceConflictError';
+    }
+}
+export class HumanIngressApplicationReplayConflictError extends Error {
+    projectId;
+    constructor(projectId) {
+        super(`Human ingress application ${projectId} replay payload drift`);
+        this.projectId = projectId;
+        this.name = 'HumanIngressApplicationReplayConflictError';
+    }
+}
+export class MemoryHumanIngressApplicationRepository {
+    #events = new Map();
+    async read(projectId) {
+        const id = text(projectId, 'projectId');
+        return normalizeHistory(id, this.#events.get(id) ?? []);
+    }
+    async append(projectId, expectedSequence, drafts) {
+        const id = text(projectId, 'projectId');
+        const current = normalizeHistory(id, this.#events.get(id) ?? []);
+        const events = materializeAppend(id, current, expectedSequence, drafts);
+        const actualSequence = current.at(-1)?.sequence ?? -1;
+        if (events.some(event => event.sequence > actualSequence)) {
+            this.#events.set(id, normalizeHistory(id, [...current, ...events]));
+        }
+        return events;
+    }
+}
+/** Crash/restart-safe consumer for durable, content-free human proposals. */
+export class HumanIngressApplicationService {
+    options;
+    #now;
+    #claimLeaseMs;
+    #retryDelayMs;
+    constructor(options) {
+        this.options = options;
+        this.#now = options.now ?? Date.now;
+        this.#claimLeaseMs = positive(options.claimLeaseMs ?? 30_000, 'claimLeaseMs');
+        this.#retryDelayMs = positive(options.retryDelayMs ?? 5_000, 'retryDelayMs');
+    }
+    async runOnce(projectId) {
+        const id = text(projectId, 'projectId');
+        const proposals = (await this.options.proposals.read(id)).map(event => event.proposal);
+        if (proposals.length === 0)
+            return deepFreeze({ status: 'idle' });
+        let history = await this.options.applications.read(id);
+        const now = safeTime(this.#now(), 'now');
+        const proposal = proposals.find(candidate => isAvailable(candidate, history, now));
+        if (!proposal) {
+            const wakeAt = nextWakeAt(proposals, history, now);
+            return wakeAt === undefined
+                ? deepFreeze({ status: 'idle' })
+                : deepFreeze({ status: 'waiting', wakeAt });
+        }
+        const prior = history.filter(event => event.proposalId === proposal.id).at(-1);
+        const attempt = (prior?.attempt ?? 0) + 1;
+        const fence = (prior?.fence ?? 0) + 1;
+        const identity = applicationIdentity(proposal);
+        const claim = eventDraft(identity, now, attempt, fence, {
+            type: 'proposal.claimed',
+            leaseExpiresAt: now + this.#claimLeaseMs,
+        });
+        try {
+            await this.options.applications.append(id, history.at(-1)?.sequence ?? -1, [claim]);
+        }
+        catch (error) {
+            if (error instanceof HumanIngressApplicationSequenceConflictError) {
+                return deepFreeze({ status: 'idle' });
+            }
+            throw error;
+        }
+        history = await this.options.applications.read(id);
+        const request = deepFreeze({
+            version: 1,
+            kind: proposal.intent,
+            identity,
+            operationId: identity.operationId,
+            attempt,
+            fence,
+            proposal,
+        });
+        try {
+            const decision = normalizeDecision(await this.options.port.apply(request), request);
+            const terminal = decision.status === 'applied'
+                ? eventDraft(identity, safeTime(this.#now(), 'now'), attempt, fence, {
+                    type: 'proposal.applied',
+                    kind: decision.kind,
+                    receiptRef: decision.receiptRef,
+                    receiptDigest: decision.receiptDigest,
+                })
+                : eventDraft(identity, safeTime(this.#now(), 'now'), attempt, fence, {
+                    type: 'proposal.clarification_required',
+                    reason: decision.reason,
+                    candidateRefs: decision.candidateRefs,
+                });
+            await this.options.applications.append(id, history.at(-1)?.sequence ?? -1, [terminal]);
+            return decision.status === 'applied'
+                ? deepFreeze({
+                    status: 'applied',
+                    proposalId: proposal.id,
+                    kind: decision.kind,
+                    receiptRef: decision.receiptRef,
+                    receiptDigest: decision.receiptDigest,
+                })
+                : deepFreeze({
+                    status: 'clarification_required',
+                    proposalId: proposal.id,
+                    reason: decision.reason,
+                    candidateRefs: decision.candidateRefs,
+                });
+        }
+        catch (error) {
+            if (error instanceof HumanIngressApplicationSequenceConflictError
+                || error instanceof HumanIngressApplicationReplayConflictError)
+                throw error;
+            const retryAt = safeTime(this.#now(), 'now') + this.#retryDelayMs;
+            const retry = eventDraft(identity, safeTime(this.#now(), 'now'), attempt, fence, {
+                type: 'proposal.retry_scheduled',
+                reason: 'downstream_unavailable',
+                retryAt,
+            });
+            history = await this.options.applications.read(id);
+            await this.options.applications.append(id, history.at(-1)?.sequence ?? -1, [retry]);
+            return deepFreeze({
+                status: 'retry_scheduled',
+                proposalId: proposal.id,
+                retryAt,
+                reason: 'downstream_unavailable',
+            });
+        }
+    }
+    async drain(projectId, max = 128) {
+        positive(max, 'max');
+        const results = [];
+        for (let index = 0; index < max; index += 1) {
+            const result = await this.runOnce(projectId);
+            if (result.status === 'idle')
+                break;
+            results.push(result);
+            if (result.status === 'retry_scheduled' || result.status === 'waiting')
+                break;
+        }
+        return deepFreeze(results);
+    }
+}
+function applicationIdentity(proposal) {
+    return deepFreeze({
+        projectId: proposal.projectId,
+        proposalId: proposal.id,
+        proposalDigest: proposal.digest,
+        operationId: `human-ingress-application:${proposal.id}`,
+    });
+}
+function isAvailable(proposal, history, now) {
+    const latest = history.filter(event => event.proposalId === proposal.id).at(-1);
+    if (!latest)
+        return true;
+    if (latest.proposalDigest !== proposal.digest) {
+        throw new HumanIngressApplicationReplayConflictError(proposal.projectId);
+    }
+    if (latest.type === 'proposal.applied' || latest.type === 'proposal.clarification_required')
+        return false;
+    if (latest.type === 'proposal.retry_scheduled')
+        return latest.retryAt <= now;
+    return latest.leaseExpiresAt <= now;
+}
+function nextWakeAt(proposals, history, now) {
+    const wakeTimes = proposals.flatMap(proposal => {
+        const latest = history.filter(event => event.proposalId === proposal.id).at(-1);
+        if (!latest
+            || latest.type === 'proposal.applied'
+            || latest.type === 'proposal.clarification_required')
+            return [];
+        const wakeAt = latest.type === 'proposal.claimed' ? latest.leaseExpiresAt : latest.retryAt;
+        return wakeAt > now ? [wakeAt] : [];
+    });
+    return wakeTimes.length === 0 ? undefined : Math.min(...wakeTimes);
+}
+function normalizeDecision(value, request) {
+    const snapshot = structuredClone(value);
+    if (!snapshot || typeof snapshot !== 'object')
+        throw new Error('Human ingress application decision is invalid');
+    assertExactKeys(snapshot, snapshot.status === 'applied'
+        ? ['projectId', 'proposalId', 'proposalDigest', 'operationId', 'status', 'kind', 'receiptRef', 'receiptDigest']
+        : ['projectId', 'proposalId', 'proposalDigest', 'operationId', 'status', 'reason', 'candidateRefs'], 'decision');
+    if (snapshot.projectId !== request.identity.projectId
+        || snapshot.proposalId !== request.identity.proposalId
+        || snapshot.proposalDigest !== request.identity.proposalDigest
+        || snapshot.operationId !== request.identity.operationId) {
+        throw new Error('Human ingress application decision is stale');
+    }
+    if (snapshot.status === 'applied') {
+        const expected = {
+            discussion: 'discussion_recorded',
+            work_request: 'plan_proposal_submitted',
+            control: 'control_proposal_submitted',
+        };
+        if (snapshot.kind !== expected[request.kind]) {
+            throw new Error('Human ingress application decision crosses intent authority');
+        }
+        text(snapshot.receiptRef, 'receiptRef');
+        sha256(snapshot.receiptDigest, 'receiptDigest');
+    }
+    else if (snapshot.status === 'clarification_required') {
+        if (![
+            'ambiguous_intent', 'missing_work_scope', 'missing_control_target',
+            'planning_unavailable', 'planning_disclosure_unavailable', 'unauthorized_control', 'stale_target',
+        ].includes(snapshot.reason))
+            throw new Error('Human ingress clarification reason is invalid');
+        uniqueTexts(snapshot.candidateRefs, 'candidateRefs');
+    }
+    else {
+        throw new Error('Human ingress application decision status is invalid');
+    }
+    return deepFreeze(snapshot);
+}
+function eventDraft(identity, occurredAt, attempt, fence, value) {
+    return deepFreeze({
+        ...identity,
+        eventId: `${identity.operationId}:${attempt}:${value.type}`,
+        occurredAt,
+        attempt,
+        fence,
+        ...value,
+    });
+}
+function materializeAppend(projectId, current, expectedSequence, drafts) {
+    sequence(expectedSequence, 'expectedSequence');
+    if (!Array.isArray(drafts) || drafts.length === 0)
+        throw new Error('Human ingress application append requires events');
+    const actualSequence = current.at(-1)?.sequence ?? -1;
+    const candidate = deepFreeze(drafts.map((draft, index) => materializeEvent(projectId, expectedSequence + index + 1, draft)));
+    if (expectedSequence < actualSequence) {
+        const replay = current.slice(expectedSequence + 1, expectedSequence + 1 + candidate.length);
+        if (replay.length === candidate.length && canonicalWorkroomJson(replay) === canonicalWorkroomJson(candidate)) {
+            return replay;
+        }
+        throw new HumanIngressApplicationReplayConflictError(projectId);
+    }
+    if (expectedSequence !== actualSequence) {
+        throw new HumanIngressApplicationSequenceConflictError(projectId, expectedSequence, actualSequence);
+    }
+    return candidate;
+}
+function materializeEvent(projectId, sequenceValue, draft) {
+    const content = deepFreeze({
+        ...structuredClone(draft),
+        version: 1,
+        projectId,
+        sequence: sequenceValue,
+    });
+    validateEvent(content);
+    return deepFreeze({ ...content, digest: digestCanonicalWorkroomValue(content) });
+}
+function normalizeHistory(projectId, values) {
+    const snapshots = deepFreeze(structuredClone(values));
+    const seenEventIds = new Set();
+    const latestByProposal = new Map();
+    snapshots.forEach((event, index) => {
+        if (event.sequence !== index)
+            throw new Error('Human ingress application history has a sequence gap');
+        const { digest, ...content } = event;
+        validateEvent(content);
+        if (event.projectId !== projectId || digest !== digestCanonicalWorkroomValue(content)) {
+            throw new Error('Human ingress application history is corrupt');
+        }
+        if (seenEventIds.has(event.eventId))
+            throw new Error('Human ingress application eventId is duplicated');
+        seenEventIds.add(event.eventId);
+        const prior = latestByProposal.get(event.proposalId);
+        if (!prior) {
+            if (event.type !== 'proposal.claimed' || event.attempt !== 1 || event.fence !== 1) {
+                throw new Error('Human ingress application lifecycle must begin with its first claim');
+            }
+        }
+        else {
+            if (prior.proposalDigest !== event.proposalDigest
+                || prior.operationId !== event.operationId) {
+                throw new Error('Human ingress application proposal identity drift');
+            }
+            if (prior.type === 'proposal.applied' || prior.type === 'proposal.clarification_required') {
+                throw new Error('Human ingress application terminal lifecycle cannot continue');
+            }
+            if (event.type === 'proposal.claimed') {
+                if (event.attempt !== prior.attempt + 1 || event.fence !== prior.fence + 1) {
+                    throw new Error('Human ingress application takeover attempt/fence is invalid');
+                }
+            }
+            else if (prior.type !== 'proposal.claimed'
+                || event.attempt !== prior.attempt
+                || event.fence !== prior.fence) {
+                throw new Error('Human ingress application outcome does not match its claim');
+            }
+        }
+        latestByProposal.set(event.proposalId, event);
+    });
+    return snapshots;
+}
+function validateEvent(value) {
+    const variantKeys = value.type === 'proposal.claimed'
+        ? ['leaseExpiresAt']
+        : value.type === 'proposal.applied'
+            ? ['kind', 'receiptRef', 'receiptDigest']
+            : value.type === 'proposal.clarification_required'
+                ? ['reason', 'candidateRefs']
+                : value.type === 'proposal.retry_scheduled'
+                    ? ['reason', 'retryAt']
+                    : [];
+    assertExactKeys(value, [
+        'version', 'projectId', 'sequence', 'eventId', 'proposalId',
+        'proposalDigest', 'operationId', 'occurredAt', 'attempt', 'fence',
+        'type', ...variantKeys,
+    ], 'event');
+    if (value.version !== 1)
+        throw new Error('Human ingress application event version is unsupported');
+    text(value.projectId, 'projectId');
+    sequence(value.sequence, 'sequence', false);
+    text(value.eventId, 'eventId');
+    text(value.proposalId, 'proposalId');
+    sha256(value.proposalDigest, 'proposalDigest');
+    text(value.operationId, 'operationId');
+    if (value.operationId !== `human-ingress-application:${value.proposalId}`) {
+        throw new Error('Human ingress application operationId does not bind the proposal');
+    }
+    if (value.eventId !== `${value.operationId}:${value.attempt}:${value.type}`) {
+        throw new Error('Human ingress application eventId does not bind its lifecycle identity');
+    }
+    safeTime(value.occurredAt, 'occurredAt');
+    positive(value.attempt, 'attempt');
+    positive(value.fence, 'fence');
+    if (value.type === 'proposal.claimed') {
+        safeTime(value.leaseExpiresAt, 'leaseExpiresAt');
+        if (value.leaseExpiresAt <= value.occurredAt)
+            throw new Error('Human ingress application claim lease must be in the future');
+    }
+    else if (value.type === 'proposal.applied') {
+        if (!['discussion_recorded', 'plan_proposal_submitted', 'control_proposal_submitted'].includes(value.kind)) {
+            throw new Error('Human ingress applied kind is invalid');
+        }
+        text(value.receiptRef, 'receiptRef');
+        sha256(value.receiptDigest, 'receiptDigest');
+    }
+    else if (value.type === 'proposal.clarification_required') {
+        if (![
+            'ambiguous_intent', 'missing_work_scope', 'missing_control_target',
+            'planning_unavailable', 'planning_disclosure_unavailable', 'unauthorized_control', 'stale_target',
+        ].includes(value.reason))
+            throw new Error('Human ingress clarification reason is invalid');
+        uniqueTexts(value.candidateRefs, 'candidateRefs');
+    }
+    else if (value.type === 'proposal.retry_scheduled') {
+        if (value.reason !== 'downstream_unavailable')
+            throw new Error('Human ingress retry reason is invalid');
+        safeTime(value.retryAt, 'retryAt');
+        if (value.retryAt <= value.occurredAt)
+            throw new Error('Human ingress retry must be scheduled in the future');
+    }
+    else
+        throw new Error('Human ingress application event type is invalid');
+}
+function uniqueTexts(values, field) {
+    if (!Array.isArray(values))
+        throw new Error(`${field} must be an array`);
+    const canonical = values.map(value => text(value, field));
+    if (new Set(canonical).size !== canonical.length)
+        throw new Error(`${field} contains duplicates`);
+}
+function assertExactKeys(value, allowed, field) {
+    const expected = new Set(allowed);
+    const unexpected = Object.keys(value).find(key => !expected.has(key));
+    if (unexpected)
+        throw new Error(`Human ingress application ${field} contains forbidden field ${unexpected}`);
+    const missing = allowed.find(key => !(key in value));
+    if (missing)
+        throw new Error(`Human ingress application ${field} is missing field ${missing}`);
+}
+function text(value, field) {
+    if (typeof value !== 'string' || !value.trim() || value !== value.trim()) {
+        throw new Error(`${field} must be canonical text`);
+    }
+    return value;
+}
+function sha256(value, field) {
+    if (typeof value !== 'string' || !/^sha256:[a-f0-9]{64}$/u.test(value)) {
+        throw new Error(`${field} must be a canonical SHA-256 digest`);
+    }
+}
+function positive(value, field) {
+    if (!Number.isSafeInteger(value) || value < 1)
+        throw new Error(`${field} must be a positive safe integer`);
+    return value;
+}
+function safeTime(value, field) {
+    if (!Number.isSafeInteger(value) || value < 0)
+        throw new Error(`${field} must be a non-negative safe integer`);
+    return value;
+}
+function sequence(value, field, allowMinusOne = true) {
+    if (!Number.isSafeInteger(value) || value < (allowMinusOne ? -1 : 0)) {
+        throw new Error(`${field} is invalid`);
+    }
+    return value;
+}
+//# sourceMappingURL=human-ingress-application.js.map

package/lib/workroom/human-ingress-application.js.map

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

package/lib/workroom/human-ingress-orchestrator.d.ts

@@ -0,0 +1,99 @@
+import type { HumanIngressApplicationDecision, HumanIngressApplicationRequest, HumanIngressOrchestratorProposalPort } from './human-ingress-application.js';
+import type { CanonicalHumanIngressSource, HumanIngressSourceReaderPort } from './human-ingress-source-reader.js';
+import type { HumanIngressProjectionReplyProof, HumanIngressProposal } from './human-ingress.js';
+import type { WorkroomKernel, WorkroomPlanAdmissionReceipt } from './workroom-kernel.js';
+import { type WorkflowPlanProposal } from './workflow-plan-builder.js';
+export interface HumanIngressProjectAuthoritySnapshot {
+    readonly orchestratorAgentDefinitionId: string;
+    readonly projectRevision: string;
+    readonly projectDigest: string;
+    readonly orchestratorAuthorityDigest: string;
+}
+export interface HumanIngressPlanningInput {
+    readonly version: 1;
+    readonly operationId: string;
+    readonly projectId: string;
+    readonly projectRevision: string;
+    readonly projectDigest: string;
+    readonly orchestratorAgentDefinitionId: string;
+    readonly orchestratorAuthorityDigest: string;
+    readonly principalId: string;
+    readonly source: CanonicalHumanIngressSource;
+    readonly projectionReply?: HumanIngressProjectionReplyProof;
+}
+export interface HumanIngressPlanningPort {
+    propose(input: HumanIngressPlanningInput): WorkflowPlanProposal | Promise<WorkflowPlanProposal>;
+}
+/** Typed fail-closed planning outcome persisted by HumanIngressApplication. */
+export declare class WorkroomPlanningClarificationError extends Error {
+    readonly reason: Extract<HumanIngressApplicationDecision, {
+        status: 'clarification_required';
+    }>['reason'] & ('planning_unavailable' | 'planning_disclosure_unavailable');
+    constructor(reason: Extract<HumanIngressApplicationDecision, {
+        status: 'clarification_required';
+    }>['reason'] & ('planning_unavailable' | 'planning_disclosure_unavailable'));
+}
+export interface HumanIngressDiscussionProposalInput extends HumanIngressPlanningInput {
+    readonly authority: 'non_authoritative';
+    readonly text: string;
+}
+export interface HumanIngressDiscussionProposalPort {
+    propose(input: HumanIngressDiscussionProposalInput): Promise<Readonly<{
+        receiptRef: string;
+        receiptDigest: string;
+    }>> | Readonly<{
+        receiptRef: string;
+        receiptDigest: string;
+    }>;
+}
+export interface HumanIngressTypedControlInput extends HumanIngressPlanningInput {
+    readonly authorityRequirement: 'workroom_control' | 'typed_sponsor_control';
+    readonly text: string;
+}
+export type HumanIngressTypedControlDecision = Readonly<{
+    status: 'authorized';
+    receiptRef: string;
+    receiptDigest: string;
+}> | Readonly<{
+    status: 'clarification_required';
+    reason: 'missing_control_target' | 'unauthorized_control' | 'stale_target';
+    candidateRefs: readonly string[];
+}>;
+export interface HumanIngressTypedControlPort {
+    apply(input: HumanIngressTypedControlInput): HumanIngressTypedControlDecision | Promise<HumanIngressTypedControlDecision>;
+}
+export interface ProductionHumanIngressOrchestratorPortOptions {
+    readonly sources: HumanIngressSourceReaderPort;
+    readonly kernel: WorkroomKernel;
+    readonly resolveProject: (projectId: string) => HumanIngressProjectAuthoritySnapshot | null | Promise<HumanIngressProjectAuthoritySnapshot | null>;
+    readonly authorizeProjectSource: (input: Readonly<{
+        projectId: string;
+        proposal: HumanIngressProposal;
+        source: CanonicalHumanIngressSource;
+    }>) => boolean | Promise<boolean>;
+    readonly planning?: HumanIngressPlanningPort;
+    readonly discussions?: HumanIngressDiscussionProposalPort;
+    readonly controls?: HumanIngressTypedControlPort;
+    /** Kernel-owned post-admission writer; never exposed to the planner/model. */
+    readonly afterPlanAdmission?: (input: Readonly<{
+        operationId: string;
+        projectId: string;
+        plan: WorkflowPlanProposal;
+        receipt: WorkroomPlanAdmissionReceipt;
+    }>) => void | Promise<void>;
+}
+/**
+ * Production proposal boundary: resolve immutable source + current Catalog
+ * authority, then route to a typed proposal/authority port. It never exposes a
+ * generic Kernel command to a model.
+ */
+export declare class ProductionHumanIngressOrchestratorPort implements HumanIngressOrchestratorProposalPort {
+    readonly options: ProductionHumanIngressOrchestratorPortOptions;
+    constructor(options: ProductionHumanIngressOrchestratorPortOptions);
+    apply(request: HumanIngressApplicationRequest): Promise<HumanIngressApplicationDecision>;
+}
+/** Content-free receipt; durable application journal owns exact replay state. */
+export declare function createContentFreeDiscussionProposalPort(): HumanIngressDiscussionProposalPort;
+/** Strict human control grammar; all mutable scope is re-read from Kernel facts. */
+export declare function createPlanGateHumanIngressControlPort(kernel: WorkroomKernel): HumanIngressTypedControlPort;
+//# sourceMappingURL=human-ingress-orchestrator.d.ts.map

package/lib/workroom/human-ingress-orchestrator.d.ts.map

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