@zhin.js/agent 1.1.13 → 1.1.14

package/lib/workroom/assignment-authority-grant-repository.js

@@ -0,0 +1,387 @@
+import { readFile, readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { canonicalWorkroomJson, deepFreezeWorkroomValue as deepFreeze, digestCanonicalWorkroomValue as digest, } from './canonical-value.js';
+import { DurableFileStore } from './durable-file-store.js';
+export class ActivatableAssignmentAuthorityGrantRepository {
+    #delegate;
+    activate(delegate) {
+        if (this.#delegate)
+            throw new Error('Assignment Authority Grant storage is already active');
+        this.#delegate = delegate;
+    }
+    read(assignmentKey) {
+        return this.#require().read(assignmentKey);
+    }
+    append(record, expectedDigest) {
+        return this.#require().append(record, expectedDigest);
+    }
+    #require() {
+        if (!this.#delegate)
+            throw new Error('Assignment Authority Grant storage is not active');
+        return this.#delegate;
+    }
+}
+export class AssignmentAuthorityGrantSequenceConflictError extends Error {
+    assignmentKey;
+    expectedDigest;
+    actualDigest;
+    constructor(assignmentKey, expectedDigest, actualDigest) {
+        super(`Assignment Authority Grant CAS conflict for ${assignmentKey}`);
+        this.assignmentKey = assignmentKey;
+        this.expectedDigest = expectedDigest;
+        this.actualDigest = actualDigest;
+        this.name = 'AssignmentAuthorityGrantSequenceConflictError';
+    }
+}
+export function assignmentAuthorityGrantKey(input) {
+    return `assignment-grant:v1:${digest({
+        version: 1,
+        generation: positive(input.generation, 'generation'),
+        projectId: input.projectId,
+        runId: input.runId,
+        taskKey: input.taskKey,
+        taskRevision: input.taskRevision,
+        assignmentId: input.assignmentId,
+        assignmentRevision: input.assignmentRevision,
+        attempt: input.attempt,
+        fence: input.fence,
+        agentDefinitionId: input.requestedAgentDefinitionId,
+        ...(input.requestedEndpointId === undefined ? {} : { endpointId: input.requestedEndpointId }),
+    }).slice('sha256:'.length)}`;
+}
+export function createAssignmentAuthorityGrantRecord(input) {
+    validateRecordInput(input);
+    const projection = deepFreeze({ version: 1, ...structuredClone(input) });
+    return deepFreeze({ ...projection, digest: digest(projection) });
+}
+/** Contract fixture. Production composition uses File or Database storage. */
+export class MemoryAssignmentAuthorityGrantRepository {
+    #records = new Map();
+    async read(assignmentKey) {
+        return this.#records.get(requiredText(assignmentKey, 'assignmentKey'));
+    }
+    async append(record, expectedDigest) {
+        const canonical = parseAssignmentAuthorityGrantRecord(record);
+        const current = this.#records.get(canonical.assignmentKey);
+        if (current?.digest === canonical.digest) {
+            return Object.freeze({ status: 'replayed', record: current });
+        }
+        assertAppend(current, canonical, expectedDigest);
+        this.#records.set(canonical.assignmentKey, canonical);
+        return Object.freeze({ status: 'created', record: canonical });
+    }
+}
+/** Immutable revision files: the revision pathname is the create-only CAS slot. */
+export class FileAssignmentAuthorityGrantRepository {
+    directory;
+    #tail = Promise.resolve();
+    #store;
+    constructor(directory) {
+        this.directory = directory;
+        this.#store = new DurableFileStore(directory);
+    }
+    async read(assignmentKey) {
+        const key = keyDigest(requiredText(assignmentKey, 'assignmentKey'));
+        const names = await readdir(this.directory).catch((error) => {
+            if (error.code === 'ENOENT')
+                return [];
+            throw error;
+        });
+        const prefix = `${key}.`;
+        const revisions = names.flatMap(name => {
+            if (!name.startsWith(prefix) || name.endsWith('.tmp'))
+                return [];
+            const match = new RegExp(`^${key}\\.([1-9][0-9]*)\\.json$`, 'u').exec(name);
+            if (!match)
+                throw new Error('Assignment Authority Grant durable revision filename is invalid');
+            const revision = Number(match[1]);
+            if (!Number.isSafeInteger(revision)) {
+                throw new Error('Assignment Authority Grant durable revision filename overflows');
+            }
+            return [revision];
+        }).sort((left, right) => left - right);
+        if (new Set(revisions).size !== revisions.length) {
+            throw new Error('Assignment Authority Grant durable revision is duplicated');
+        }
+        let latest;
+        for (const [index, revision] of revisions.entries()) {
+            if (revision !== index + 1) {
+                throw new Error('Assignment Authority Grant durable revision chain has a gap');
+            }
+            const raw = await readFile(join(this.directory, `${key}.${revision}.json`), 'utf8');
+            const current = parseAssignmentAuthorityGrantRecord(JSON.parse(raw));
+            if (current.assignmentKey !== assignmentKey || current.revision !== revision) {
+                throw new Error('Assignment Authority Grant durable revision scope drift');
+            }
+            if ((revision === 1 && current.previousDigest !== undefined)
+                || (revision > 1 && current.previousDigest !== latest?.digest)) {
+                throw new Error('Assignment Authority Grant durable chain drift');
+            }
+            latest = current;
+        }
+        if (latest)
+            await this.#store.syncLeaf();
+        return latest;
+    }
+    append(record, expectedDigest) {
+        const run = this.#tail.then(() => this.#append(record, expectedDigest));
+        this.#tail = run.catch(() => undefined);
+        return run;
+    }
+    async #append(record, expectedDigest) {
+        const canonical = parseAssignmentAuthorityGrantRecord(record);
+        await this.#store.ensureDurableLeaf('Assignment Authority Grant repository');
+        const current = await this.read(canonical.assignmentKey);
+        if (current?.digest === canonical.digest) {
+            await this.#store.syncLeaf();
+            return Object.freeze({ status: 'replayed', record: current });
+        }
+        assertAppend(current, canonical, expectedDigest);
+        const target = join(this.directory, `${keyDigest(canonical.assignmentKey)}.${canonical.revision}.json`);
+        const published = await this.#store.publishCreateOnly({
+            target,
+            content: canonicalWorkroomJson(canonical),
+            createdValue: canonical,
+            onConflict: async () => {
+                const winner = parseAssignmentAuthorityGrantRecord(JSON.parse(await readFile(target, 'utf8')));
+                if (winner.digest !== canonical.digest) {
+                    throw new AssignmentAuthorityGrantSequenceConflictError(canonical.assignmentKey, expectedDigest, winner.digest);
+                }
+                return winner;
+            },
+        });
+        return Object.freeze({ status: published.status, record: published.value });
+    }
+}
+export class DatabaseAssignmentAuthorityGrantRepository {
+    database;
+    model;
+    constructor(database, model) {
+        this.database = database;
+        this.model = model;
+    }
+    async read(assignmentKey) {
+        return latestDatabaseRecord(await this.model.select().where({
+            assignment_key: requiredText(assignmentKey, 'assignmentKey'),
+        }));
+    }
+    async append(record, expectedDigest) {
+        const canonical = parseAssignmentAuthorityGrantRecord(record);
+        try {
+            return await this.database.transaction(async (transaction) => {
+                const rows = await transaction.select('workroom_assignment_authority_grants')
+                    .where({ assignment_key: canonical.assignmentKey });
+                const current = latestDatabaseRecord(rows);
+                if (current?.digest === canonical.digest) {
+                    return Object.freeze({ status: 'replayed', record: current });
+                }
+                assertAppend(current, canonical, expectedDigest);
+                await transaction.insertMany('workroom_assignment_authority_grants', [{
+                        id: `${keyDigest(canonical.assignmentKey)}:${canonical.revision}`,
+                        assignment_key: canonical.assignmentKey,
+                        revision: canonical.revision,
+                        digest: canonical.digest,
+                        record_json: canonicalWorkroomJson(canonical),
+                        created_at: canonical.createdAt,
+                    }]);
+                return Object.freeze({ status: 'created', record: canonical });
+            }, { isolationLevel: 'SERIALIZABLE' });
+        }
+        catch (error) {
+            if (!isDatabaseCasLoser(error))
+                throw error;
+            const winner = await this.read(canonical.assignmentKey);
+            if (winner?.digest === canonical.digest) {
+                return Object.freeze({ status: 'replayed', record: winner });
+            }
+            throw new AssignmentAuthorityGrantSequenceConflictError(canonical.assignmentKey, expectedDigest, winner?.digest);
+        }
+    }
+}
+export const WORKROOM_ASSIGNMENT_AUTHORITY_GRANT_MODEL = {
+    id: { type: 'text', primary: true, nullable: false },
+    assignment_key: { type: 'text', nullable: false },
+    revision: { type: 'integer', nullable: false },
+    digest: { type: 'text', nullable: false },
+    record_json: { type: 'text', nullable: false },
+    created_at: { type: 'integer', nullable: false },
+};
+export function createDurableWorkroomAssignmentAuthorityGrantProvider(options) {
+    positive(options.generation, 'generation');
+    const now = options.now ?? Date.now;
+    return Object.freeze({
+        resolve: async (request) => {
+            const record = await options.repository.read(assignmentAuthorityGrantKey({
+                ...request,
+                generation: options.generation,
+            }));
+            if (!record || record.status !== 'ready' || !record.grant)
+                return undefined;
+            if (record.generation !== options.generation || record.expiresAt <= now())
+                return undefined;
+            if (!recordMatchesRequest(record, request))
+                return undefined;
+            if (!grantMatchesRecord(record.grant, record))
+                return undefined;
+            return record.grant;
+        },
+    });
+}
+export function parseAssignmentAuthorityGrantRecord(value) {
+    if (!isRecord(value))
+        throw new Error('Assignment Authority Grant record must be an object');
+    const { digest: actualDigest, version, ...input } = value;
+    if (version !== 1 || typeof actualDigest !== 'string') {
+        throw new Error('Assignment Authority Grant record version or digest is invalid');
+    }
+    const canonical = createAssignmentAuthorityGrantRecord(input);
+    if (canonical.digest !== actualDigest)
+        throw new Error('Assignment Authority Grant record digest drift');
+    return canonical;
+}
+function assertAppend(current, candidate, expectedDigest) {
+    if (current?.digest !== expectedDigest
+        || candidate.revision !== (current?.revision ?? 0) + 1
+        || candidate.previousDigest !== expectedDigest) {
+        throw new AssignmentAuthorityGrantSequenceConflictError(candidate.assignmentKey, expectedDigest, current?.digest);
+    }
+    for (const field of [
+        'assignmentKey', 'generation', 'projectId', 'runId', 'taskKey', 'taskRevision',
+        'assignmentId', 'assignmentRevision', 'attempt', 'fence', 'operationId',
+        'agentDefinitionId', 'endpointId', 'profileRevisionId', 'profileDigest',
+    ]) {
+        if (current && current[field] !== candidate[field]) {
+            throw new Error(`Assignment Authority Grant immutable ${field} drift`);
+        }
+    }
+}
+function validateRecordInput(input) {
+    const expected = [
+        'assignmentKey', 'revision', 'previousDigest', 'generation', 'projectId', 'runId',
+        'taskKey', 'taskRevision', 'assignmentId', 'assignmentRevision', 'attempt', 'fence',
+        'operationId', 'agentDefinitionId', 'endpointId', 'profileRevisionId', 'profileDigest',
+        'factAnchor', 'createdAt', 'expiresAt', 'status', 'blocker', 'grant',
+    ];
+    const unexpected = Object.keys(input).find(key => !expected.includes(key));
+    if (unexpected)
+        throw new Error(`Assignment Authority Grant record has unexpected ${unexpected}`);
+    for (const field of [
+        'assignmentKey', 'projectId', 'runId', 'taskKey', 'assignmentId', 'operationId',
+        'agentDefinitionId', 'endpointId', 'profileRevisionId', 'profileDigest',
+    ])
+        requiredText(input[field], field);
+    for (const field of [
+        'revision', 'generation', 'taskRevision', 'assignmentRevision', 'attempt', 'fence',
+    ])
+        positive(input[field], field);
+    nonNegative(input.createdAt, 'createdAt');
+    nonNegative(input.expiresAt, 'expiresAt');
+    if (input.expiresAt <= input.createdAt)
+        throw new Error('Assignment Authority Grant must expire after creation');
+    if ((input.revision === 1) !== (input.previousDigest === undefined)) {
+        throw new Error('Assignment Authority Grant previous digest/revision mismatch');
+    }
+    if (input.status === 'ready') {
+        if (!input.grant || input.blocker)
+            throw new Error('Ready Assignment Authority Grant record is invalid');
+    }
+    else if (input.status === 'blocked') {
+        if (!input.blocker || input.grant)
+            throw new Error('Blocked Assignment Authority Grant record is invalid');
+        if (input.blocker.kind !== 'capability' && input.blocker.kind !== 'disclosure') {
+            throw new Error('Assignment Authority Grant blocker kind is invalid');
+        }
+        requiredText(input.blocker.owner, 'blocker.owner');
+        requiredText(input.blocker.reason, 'blocker.reason');
+        nonNegative(input.blocker.deadline, 'blocker.deadline');
+    }
+    else {
+        throw new Error('Assignment Authority Grant status is invalid');
+    }
+    requiredText(input.factAnchor.ref, 'factAnchor.ref');
+    nonNegative(input.factAnchor.sequence, 'factAnchor.sequence');
+    requiredText(input.factAnchor.digest, 'factAnchor.digest');
+}
+function recordMatchesRequest(record, request) {
+    return record.projectId === request.projectId
+        && record.runId === request.runId
+        && record.taskKey === request.taskKey
+        && record.taskRevision === request.taskRevision
+        && record.assignmentId === request.assignmentId
+        && record.assignmentRevision === request.assignmentRevision
+        && record.attempt === request.attempt
+        && record.fence === request.fence
+        && record.agentDefinitionId === request.requestedAgentDefinitionId
+        && record.endpointId === request.requestedEndpointId;
+}
+function grantMatchesRecord(grant, record) {
+    return grant.generation === record.generation
+        && grant.projectId === record.projectId
+        && grant.runId === record.runId
+        && grant.taskKey === record.taskKey
+        && grant.taskRevision === record.taskRevision
+        && grant.assignmentId === record.assignmentId
+        && grant.assignmentRevision === record.assignmentRevision
+        && grant.attempt === record.attempt
+        && grant.fence === record.fence
+        && grant.agentDefinitionId === record.agentDefinitionId
+        && grant.endpointId === record.endpointId
+        && grant.profileRevisionId === record.profileRevisionId
+        && grant.profileDigest === record.profileDigest;
+}
+function latestDatabaseRecord(rows) {
+    const parsed = rows.map(row => {
+        if (typeof row.record_json !== 'string')
+            throw new Error('Assignment Authority Grant database row is invalid');
+        const record = parseAssignmentAuthorityGrantRecord(JSON.parse(row.record_json));
+        if (row.assignment_key !== record.assignmentKey
+            || Number(row.revision) !== record.revision
+            || row.digest !== record.digest) {
+            throw new Error('Assignment Authority Grant database row scope drift');
+        }
+        return record;
+    }).sort((left, right) => left.revision - right.revision);
+    for (let index = 0; index < parsed.length; index += 1) {
+        const current = parsed[index];
+        const previous = parsed[index - 1];
+        if (current.revision !== index + 1 || current.previousDigest !== previous?.digest) {
+            throw new Error('Assignment Authority Grant database chain drift');
+        }
+    }
+    return parsed.at(-1);
+}
+function keyDigest(value) {
+    return digest({ assignmentKey: value }).slice('sha256:'.length);
+}
+function requiredText(value, field) {
+    if (typeof value !== 'string' || !value.trim() || value !== value.trim()) {
+        throw new Error(`Assignment Authority Grant ${field} is required`);
+    }
+    return value;
+}
+function positive(value, field) {
+    if (!Number.isSafeInteger(value) || Number(value) < 1) {
+        throw new Error(`Assignment Authority Grant ${field} must be a positive integer`);
+    }
+    return Number(value);
+}
+function nonNegative(value, field) {
+    if (!Number.isSafeInteger(value) || Number(value) < 0) {
+        throw new Error(`Assignment Authority Grant ${field} must be a non-negative integer`);
+    }
+    return Number(value);
+}
+function isRecord(value) {
+    return Boolean(value && typeof value === 'object' && !Array.isArray(value));
+}
+function isDatabaseCasLoser(error) {
+    if (!error || typeof error !== 'object')
+        return false;
+    const code = 'code' in error ? String(error.code) : '';
+    return code === '23505'
+        || code === '40001'
+        || code === 'SQLITE_CONSTRAINT'
+        || code === 'SQLITE_CONSTRAINT_PRIMARYKEY'
+        || code === 'SQLITE_BUSY_SNAPSHOT';
+}
+//# sourceMappingURL=assignment-authority-grant-repository.js.map

package/lib/workroom/assignment-authority-grant-repository.js.map

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

package/lib/workroom/assignment-executor.d.ts

@@ -0,0 +1,110 @@
+import type { WorkroomExecutionRole } from './kernel-contracts.js';
+export type AssignmentExecutorRole = Extract<WorkroomExecutionRole, 'executor' | 'integration'>;
+export interface AssignmentExecutionSnapshotReference {
+    readonly ref: string;
+    readonly revision: number;
+    readonly digest: string;
+}
+export interface AssignmentExecutionWorkspaceReference {
+    readonly leaseRef: string;
+    readonly mountRef: string;
+    readonly baseRevision: string;
+    readonly fence: number;
+}
+export interface AssignmentExecutionFactAnchor {
+    readonly ref: string;
+    readonly sequence: number;
+    readonly digest: string;
+}
+export interface AssignmentExecutionEnvelopeInput {
+    readonly projectId: string;
+    readonly runId: string;
+    readonly taskKey: string;
+    readonly taskRevision: number;
+    readonly assignmentId: string;
+    readonly assignmentRevision: number;
+    readonly attempt: number;
+    readonly fence: number;
+    readonly principalId: string;
+    readonly role: AssignmentExecutorRole;
+    readonly agentDefinition: AssignmentExecutionSnapshotReference;
+    readonly plan: AssignmentExecutionSnapshotReference;
+    readonly contextPolicy: AssignmentExecutionSnapshotReference;
+    readonly factAnchor: AssignmentExecutionFactAnchor;
+    readonly capabilitySnapshot: AssignmentExecutionSnapshotReference;
+    readonly policySnapshot: AssignmentExecutionSnapshotReference;
+    readonly workspace: AssignmentExecutionWorkspaceReference;
+}
+export interface AssignmentExecutionEnvelope extends AssignmentExecutionEnvelopeInput {
+    readonly version: 1;
+    readonly digest: string;
+}
+export interface AssignmentProgressObservation {
+    readonly version: 1;
+    readonly type: 'progress';
+    readonly observationId: string;
+    readonly envelopeDigest: string;
+    readonly progress: Readonly<{
+        summary: string;
+        completedUnits?: number;
+        totalUnits?: number;
+    }>;
+}
+export interface AssignmentHeartbeatObservation {
+    readonly version: 1;
+    readonly type: 'heartbeat';
+    readonly observationId: string;
+    readonly envelopeDigest: string;
+}
+export interface AssignmentCheckpointObservation {
+    readonly version: 1;
+    readonly type: 'checkpoint';
+    readonly observationId: string;
+    readonly envelopeDigest: string;
+    readonly checkpoint: Readonly<{
+        ref: string;
+        digest: string;
+    }>;
+}
+export interface AssignmentExecutionCompletedObservation {
+    readonly version: 1;
+    readonly type: 'execution_completed';
+    readonly observationId: string;
+    readonly envelopeDigest: string;
+    readonly completion: Readonly<{
+        report: Readonly<{
+            ref: string;
+            digest: string;
+        }>;
+        candidate: Readonly<{
+            ref: string;
+            hash: string;
+        }>;
+        completionReceiptDigest?: string;
+    }>;
+}
+export type AssignmentExecutionObservation = AssignmentProgressObservation | AssignmentHeartbeatObservation | AssignmentCheckpointObservation | AssignmentExecutionCompletedObservation;
+/** Transport adapters receive no mutable Workroom state or command surface. */
+export interface AssignmentExecutorPort {
+    /** The adapter must stop its transport/sandbox when the trusted caller aborts. */
+    execute(envelope: AssignmentExecutionEnvelope, signal: AbortSignal): AsyncIterable<AssignmentExecutionObservation>;
+}
+/**
+ * Materializes the exact role-scoped authority a trusted Workroom issuer gives
+ * one Assignment attempt. Executors may consume this value, but never widen it.
+ */
+export declare function createAssignmentExecutionEnvelope(input: AssignmentExecutionEnvelopeInput): AssignmentExecutionEnvelope;
+/**
+ * Caller-owned execution boundary. Cancellation is checked before transport
+ * dispatch and before any observation escapes toward a trusted Kernel adapter.
+ */
+export declare function executeAssignment(port: AssignmentExecutorPort, envelope: AssignmentExecutionEnvelope, signal: AbortSignal): AsyncIterable<AssignmentExecutionObservation>;
+/**
+ * Validates an Executor observation before any trusted adapter may translate
+ * it into a Kernel proposal. The observation itself carries no target scope;
+ * its exact Project/Run/Task/Assignment authority is the Envelope digest.
+ */
+export declare function validateAssignmentExecutionObservation(envelope: AssignmentExecutionEnvelope, value: unknown): AssignmentExecutionObservation;
+/** Guards the trusted local boundary against corrupted or mutable Envelopes. */
+export declare function assertAssignmentExecutionEnvelope(value: unknown): asserts value is AssignmentExecutionEnvelope;
+//# sourceMappingURL=assignment-executor.d.ts.map

package/lib/workroom/assignment-executor.d.ts.map

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