@zhin.js/workroom 0.0.0 → 0.0.1

package/lib/workroom/workflow-plan-builder.js

@@ -0,0 +1,232 @@
+import { createHash } from 'node:crypto';
+import { compareCanonicalWorkroomText } from './canonical-value.js';
+import { assertWorkroomSchedulerPolicySnapshot, } from './workroom-scheduler.js';
+/** Revalidates untrusted planner output against the same canonical builder. */
+export function assertWorkflowPlanProposal(value) {
+    if (!value || typeof value !== 'object' || value.version !== 1 || !Array.isArray(value.tasks)) {
+        throw new Error('Workflow Plan proposal shape is invalid');
+    }
+    let builder = WorkflowPlanBuilder.create({
+        proposalId: value.proposalId,
+        projectId: value.projectId,
+        strategy: value.strategy,
+        parameterDigest: value.parameterDigest,
+        authority: value.authority,
+        budget: value.budget,
+        schedulerPolicy: value.schedulerPolicy,
+    });
+    for (const task of value.tasks)
+        builder = builder.addTask(task);
+    const rebuilt = builder.build();
+    if (stableJson(rebuilt) !== stableJson(value)) {
+        throw new Error('Workflow Plan proposal is not canonical or its digest does not match');
+    }
+}
+/**
+ * Persistent, I/O-free graph builder. It can only produce a versioned proposal;
+ * applying, scheduling and executing that proposal remain Kernel-owned concerns.
+ */
+export class WorkflowPlanBuilder {
+    #metadata;
+    #tasks;
+    constructor(metadata, tasks) {
+        this.#metadata = metadata;
+        this.#tasks = tasks;
+        Object.freeze(this);
+    }
+    static create(metadata) {
+        requireText(metadata.proposalId, 'proposalId');
+        requireText(metadata.projectId, 'projectId');
+        requireText(metadata.strategy.id, 'strategy.id');
+        requireText(metadata.strategy.version, 'strategy.version');
+        requireText(metadata.strategy.digest, 'strategy.digest');
+        requireText(metadata.parameterDigest, 'parameterDigest');
+        normalizeAuthority(metadata.authority);
+        normalizeBudget(metadata.budget);
+        assertWorkroomSchedulerPolicySnapshot(metadata.schedulerPolicy, 1);
+        return new WorkflowPlanBuilder(deepFreeze({
+            ...metadata,
+            strategy: { ...metadata.strategy },
+            authority: { ...metadata.authority },
+            budget: { ...metadata.budget },
+            schedulerPolicy: structuredClone(metadata.schedulerPolicy),
+        }), Object.freeze([]));
+    }
+    addTask(input) {
+        if (this.#tasks.some((task) => task.key === input.key)) {
+            throw new Error(`Workflow Plan Task ${input.key} already exists`);
+        }
+        const task = normalizeTask(input);
+        return new WorkflowPlanBuilder(this.#metadata, Object.freeze([...this.#tasks, task]));
+    }
+    build() {
+        if (this.#tasks.length === 0)
+            throw new Error('Workflow Plan requires at least one Task');
+        const tasks = [...this.#tasks].sort((left, right) => compareCanonicalWorkroomText(left.key, right.key));
+        if (!tasks.some(task => task.required))
+            throw new Error('Workflow Plan requires at least one required Task');
+        assertDependencyGraph(tasks);
+        if (tasks.length > this.#metadata.budget.maxTasks) {
+            throw new Error('Workflow Plan Task count exceeds the authorized budget');
+        }
+        if (tasks.reduce((total, task) => total + task.maxAttempts, 0) > this.#metadata.budget.maxTotalAttempts) {
+            throw new Error('Workflow Plan total attempts exceed the authorized budget');
+        }
+        const projection = {
+            version: 1,
+            ...this.#metadata,
+            tasks,
+        };
+        return deepFreeze({ ...projection, digest: digest(projection) });
+    }
+}
+function normalizeTask(input) {
+    requireText(input.key, 'task.key');
+    requireText(input.title, 'task.title');
+    requireText(input.role, 'task.role');
+    if (!Number.isSafeInteger(input.maxAttempts) || input.maxAttempts < 1) {
+        throw new Error('Workflow Plan Task maxAttempts must be a positive integer');
+    }
+    if (typeof input.required !== 'boolean') {
+        throw new Error('Workflow Plan Task required must be a boolean');
+    }
+    const dependsOn = normalizeNames(input.dependsOn, 'task.dependsOn');
+    if (dependsOn.includes(input.key))
+        throw new Error(`Workflow Plan Task ${input.key} cannot depend on itself`);
+    const approvalGate = input.approvalGate ? normalizeApprovalGate(input.approvalGate, input.key) : undefined;
+    return deepFreeze({
+        key: input.key,
+        title: input.title,
+        role: input.role,
+        required: input.required,
+        maxAttempts: input.maxAttempts,
+        dependsOn,
+        requires: {
+            tools: normalizeNames(input.requires.tools ?? [], 'task.requires.tools'),
+            skills: normalizeNames(input.requires.skills ?? [], 'task.requires.skills'),
+            integrations: normalizeNames(input.requires.integrations ?? [], 'task.requires.integrations'),
+            authorities: normalizeNames(input.requires.authorities ?? [], 'task.requires.authorities'),
+        },
+        scheduler: normalizeTaskScheduler(input.scheduler, input.key),
+        ...(approvalGate ? { approvalGate } : {}),
+    });
+}
+function normalizeAuthority(input) {
+    requireText(input.projectRevision, 'authority.projectRevision');
+    requireDigest(input.projectDigest, 'authority.projectDigest');
+    requireText(input.profileRevisionId, 'authority.profileRevisionId');
+    requireDigest(input.profileDigest, 'authority.profileDigest');
+    requireText(input.planningPolicyRevisionId, 'authority.planningPolicyRevisionId');
+    requireDigest(input.planningPolicyDigest, 'authority.planningPolicyDigest');
+    requireText(input.orchestratorAgentDefinitionId, 'authority.orchestratorAgentDefinitionId');
+    requireDigest(input.orchestratorAuthorityDigest, 'authority.orchestratorAuthorityDigest');
+    return input;
+}
+function normalizeBudget(input) {
+    positiveInteger(input.maxTasks, 'budget.maxTasks');
+    positiveInteger(input.maxTotalAttempts, 'budget.maxTotalAttempts');
+    return input;
+}
+function normalizeApprovalGate(input, taskKey) {
+    requireText(input.id, 'task.approvalGate.id');
+    if (input.id !== `approval:${taskKey}`) {
+        throw new Error(`Workflow Plan Task ${taskKey} approval gate identity is not canonical`);
+    }
+    if (input.kind !== 'sponsor')
+        throw new Error('Workflow Plan approval gate kind is invalid');
+    requireText(input.owner, 'task.approvalGate.owner');
+    positiveInteger(input.decisionTimeoutMs, 'task.approvalGate.decisionTimeoutMs');
+    finiteTime(input.deadline, 'task.approvalGate.deadline');
+    requireText(input.policyRevisionId, 'task.approvalGate.policyRevisionId');
+    requireDigest(input.policyDigest, 'task.approvalGate.policyDigest');
+    return deepFreeze({
+        ...input,
+        allowedActions: ['approve', 'reject', 'replan', 'cancel'],
+    });
+}
+function normalizeTaskScheduler(input, taskKey) {
+    if (!['urgent', 'high', 'normal', 'low'].includes(input.sponsorLane)) {
+        throw new Error(`Workflow Plan Task ${taskKey} Sponsor lane is invalid`);
+    }
+    if (!Number.isSafeInteger(input.localRank) || input.localRank < 0) {
+        throw new Error(`Workflow Plan Task ${taskKey} local rank must be a non-negative safe integer`);
+    }
+    finiteTime(input.enqueuedAt, `task.${taskKey}.scheduler.enqueuedAt`);
+    finiteTime(input.deadline, `task.${taskKey}.scheduler.deadline`);
+    if (input.deadline <= input.enqueuedAt) {
+        throw new Error(`Workflow Plan Task ${taskKey} deadline must follow enqueue time`);
+    }
+    if (input.preemptibility !== 'checkpointable' && input.preemptibility !== 'atomic') {
+        throw new Error(`Workflow Plan Task ${taskKey} preemptibility is invalid`);
+    }
+    return deepFreeze({ ...input });
+}
+function assertDependencyGraph(tasks) {
+    const byKey = new Map(tasks.map((task) => [task.key, task]));
+    for (const task of tasks) {
+        for (const dependency of task.dependsOn) {
+            if (!byKey.has(dependency)) {
+                throw new Error(`Workflow Plan Task ${task.key} has unknown dependency ${dependency}`);
+            }
+        }
+    }
+    const visiting = new Set();
+    const visited = new Set();
+    const visit = (key) => {
+        if (visiting.has(key))
+            throw new Error(`Workflow Plan contains a dependency cycle at ${key}`);
+        if (visited.has(key))
+            return;
+        visiting.add(key);
+        for (const dependency of byKey.get(key)?.dependsOn ?? [])
+            visit(dependency);
+        visiting.delete(key);
+        visited.add(key);
+    };
+    for (const task of tasks)
+        visit(task.key);
+}
+function normalizeNames(values, label) {
+    for (const value of values)
+        requireText(value, label);
+    return Object.freeze([...new Set(values)].sort(compareCanonicalWorkroomText));
+}
+function requireText(value, label) {
+    if (typeof value !== 'string' || !value.trim())
+        throw new Error(`${label} requires non-empty text`);
+}
+function requireDigest(value, label) {
+    if (typeof value !== 'string' || !/^sha256:[a-f0-9]{64}$/u.test(value)) {
+        throw new Error(`${label} requires a canonical SHA-256 digest`);
+    }
+}
+function positiveInteger(value, label) {
+    if (!Number.isSafeInteger(value) || value < 1)
+        throw new Error(`${label} must be a positive safe integer`);
+}
+function finiteTime(value, label) {
+    if (!Number.isSafeInteger(value) || value < 0)
+        throw new Error(`${label} must be a non-negative safe integer`);
+}
+function digest(value) {
+    return `sha256:${createHash('sha256').update(stableJson(value)).digest('hex')}`;
+}
+function stableJson(value) {
+    if (Array.isArray(value))
+        return `[${value.map(stableJson).join(',')}]`;
+    if (value && typeof value === 'object') {
+        return `{${Object.entries(value)
+            .sort(([left], [right]) => compareCanonicalWorkroomText(left, right))
+            .map(([key, item]) => `${JSON.stringify(key)}:${stableJson(item)}`)
+            .join(',')}}`;
+    }
+    return JSON.stringify(value);
+}
+function deepFreeze(value) {
+    if (!value || typeof value !== 'object' || Object.isFrozen(value))
+        return value;
+    for (const item of Object.values(value))
+        deepFreeze(item);
+    return Object.freeze(value);
+}
+//# sourceMappingURL=workflow-plan-builder.js.map

package/lib/workroom/workflow-plan-builder.js.map

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

package/lib/workroom/workroom-assignment-knowledge-context.d.ts

@@ -0,0 +1,102 @@
+import type { ProjectKnowledgeRegistry } from './project-knowledge-registry.js';
+import type { ProjectProfileRegistry } from './profile-registry.js';
+export interface WorkroomAssignmentKnowledgeContextRequest {
+    readonly projectId: string;
+    readonly runId: string;
+    readonly taskKey: string;
+    readonly role: string;
+    readonly profileRevisionId: string;
+    readonly profileDigest: string;
+}
+export interface WorkroomAssignmentKnowledgeHandle {
+    readonly knowledgeId: string;
+    readonly kind: 'memory' | 'glossary';
+    readonly governedContent: Readonly<{
+        ref: string;
+        digest: string;
+    }>;
+    readonly schema: Readonly<{
+        ref: string;
+        digest: string;
+    }>;
+    readonly sensitivity: 'standard' | 'restricted' | 'high';
+    readonly entryDigest: string;
+}
+export interface WorkroomAssignmentKnowledgeProjection {
+    readonly version: 1;
+    readonly projectId: string;
+    readonly runId: string;
+    readonly taskKey: string;
+    readonly role: string;
+    readonly profileRevisionId: string;
+    readonly profileDigest: string;
+    readonly knowledgeRevision: number;
+    readonly handles: readonly WorkroomAssignmentKnowledgeHandle[];
+    readonly digest: string;
+}
+export interface WorkroomGovernedKnowledgeContentReadInput {
+    readonly purpose: 'assignment-context';
+    readonly projectId: string;
+    readonly assignmentId: string;
+    readonly principalId: string;
+    readonly taskKey: string;
+    readonly role: string;
+    readonly profileRevisionId: string;
+    readonly profileDigest: string;
+    readonly knowledgeRevision: number;
+    readonly handle: WorkroomAssignmentKnowledgeHandle;
+    readonly projectionDigest: string;
+}
+export interface WorkroomGovernedKnowledgeContent {
+    readonly body: unknown;
+    readonly contentDigest: string;
+    readonly authorizationDigest: string;
+}
+/** P12-owned reader. It must reauthorize every exact Assignment read. */
+export interface WorkroomGovernedKnowledgeContentReader {
+    read(input: WorkroomGovernedKnowledgeContentReadInput): Promise<WorkroomGovernedKnowledgeContent | undefined>;
+}
+export interface WorkroomEphemeralAssignmentContextPublisher {
+    publish(input: Readonly<{
+        assignmentId: string;
+        principalId: string;
+        projection: WorkroomAssignmentKnowledgeProjection;
+        contents: readonly Readonly<{
+            knowledgeId: string;
+            body: unknown;
+            contentDigest: string;
+            authorizationDigest: string;
+        }>[];
+        expectedHash: string;
+    }>): Promise<Readonly<{
+        ref: string;
+        hash: string;
+    }>>;
+}
+export declare class WorkroomAssignmentKnowledgeContextProjector {
+    readonly options: Readonly<{
+        profiles: Pick<ProjectProfileRegistry, 'read'>;
+        knowledge: Pick<ProjectKnowledgeRegistry, 'read'>;
+        contentReader?: WorkroomGovernedKnowledgeContentReader;
+        publisher?: WorkroomEphemeralAssignmentContextPublisher;
+    }>;
+    constructor(options: Readonly<{
+        profiles: Pick<ProjectProfileRegistry, 'read'>;
+        knowledge: Pick<ProjectKnowledgeRegistry, 'read'>;
+        contentReader?: WorkroomGovernedKnowledgeContentReader;
+        publisher?: WorkroomEphemeralAssignmentContextPublisher;
+    }>);
+    project(request: WorkroomAssignmentKnowledgeContextRequest): Promise<WorkroomAssignmentKnowledgeProjection>;
+    materialize(input: Readonly<{
+        request: WorkroomAssignmentKnowledgeContextRequest;
+        assignmentId: string;
+        principalId: string;
+    }>): Promise<Readonly<{
+        projection: WorkroomAssignmentKnowledgeProjection;
+        contextView: Readonly<{
+            ref: string;
+            hash: string;
+        }>;
+    }>>;
+}
+//# sourceMappingURL=workroom-assignment-knowledge-context.d.ts.map

package/lib/workroom/workroom-assignment-knowledge-context.d.ts.map

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

package/lib/workroom/workroom-assignment-knowledge-context.js

@@ -0,0 +1,127 @@
+import { compareCanonicalWorkroomText, canonicalWorkroomJson, deepFreezeWorkroomValue as deepFreeze, digestCanonicalWorkroomValue as digest, } from './canonical-value.js';
+export class WorkroomAssignmentKnowledgeContextProjector {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async project(request) {
+        requestHeader(request);
+        const [profiles, knowledge] = await Promise.all([
+            this.options.profiles.read(request.projectId),
+            this.options.knowledge.read(request.projectId),
+        ]);
+        const pin = profiles.runPins[request.runId];
+        const revision = profiles.revisions[request.profileRevisionId];
+        if (!pin || pin.profileRevisionId !== request.profileRevisionId || pin.profileDigest !== request.profileDigest
+            || !revision || revision.compiledDigest !== request.profileDigest
+            || revision.compiledProfile.digest !== request.profileDigest) {
+            throw new Error('Assignment Knowledge requires the exact persisted Run Profile pin');
+        }
+        const selected = [
+            ...revision.compiledProfile.memories.map(definition => ({ kind: 'memory', definition })),
+            ...revision.compiledProfile.glossaries.map(definition => ({ kind: 'glossary', definition })),
+        ].filter(({ definition }) => definition.allowedRoles.includes(request.role)
+            && (definition.taskKeys.length === 0 || definition.taskKeys.includes(request.taskKey)));
+        const byId = new Map(knowledge.entries.map(entry => [entry.knowledgeId, entry]));
+        const handles = selected.map(({ kind, definition }) => {
+            const entry = byId.get(definition.id);
+            if (!entry || entry.projectId !== request.projectId || entry.kind !== kind || entry.digest !== definition.digest) {
+                throw new Error(`Assignment Knowledge ${kind} ${definition.id} is unavailable or stale`);
+            }
+            return knowledgeHandle(entry);
+        }).sort((left, right) => compareCanonicalWorkroomText(`${left.kind}:${left.knowledgeId}`, `${right.kind}:${right.knowledgeId}`));
+        const body = deepFreeze({
+            version: 1,
+            projectId: request.projectId,
+            runId: request.runId,
+            taskKey: request.taskKey,
+            role: request.role,
+            profileRevisionId: request.profileRevisionId,
+            profileDigest: request.profileDigest,
+            knowledgeRevision: knowledge.revision,
+            handles,
+        });
+        return deepFreeze({ ...body, digest: digest(body) });
+    }
+    async materialize(input) {
+        const reader = this.options.contentReader;
+        const publisher = this.options.publisher;
+        if (!reader || !publisher)
+            throw new Error('Assignment Knowledge P12 reader/publisher is unavailable');
+        const assignmentId = text(input.assignmentId, 'Assignment Knowledge assignmentId');
+        const principalId = text(input.principalId, 'Assignment Knowledge principalId');
+        const projection = await this.project(input.request);
+        const contents = await Promise.all(projection.handles.map(async (handle) => {
+            const governed = await reader.read({
+                purpose: 'assignment-context',
+                projectId: projection.projectId,
+                assignmentId,
+                principalId,
+                taskKey: projection.taskKey,
+                role: projection.role,
+                profileRevisionId: projection.profileRevisionId,
+                profileDigest: projection.profileDigest,
+                knowledgeRevision: projection.knowledgeRevision,
+                handle,
+                projectionDigest: projection.digest,
+            });
+            if (!governed || governed.contentDigest !== handle.governedContent.digest) {
+                throw new Error(`Assignment Knowledge P12 read denied or stale for ${handle.knowledgeId}`);
+            }
+            requiredDigest(governed.authorizationDigest, 'Assignment Knowledge authorization digest');
+            return deepFreeze({
+                knowledgeId: handle.knowledgeId,
+                body: governed.body,
+                contentDigest: governed.contentDigest,
+                authorizationDigest: governed.authorizationDigest,
+            });
+        }));
+        const expectedHash = digest({
+            projectionDigest: projection.digest,
+            assignmentId,
+            principalId,
+            contents: contents.map(({ body: _body, ...authority }) => authority),
+        });
+        const contextView = await publisher.publish({
+            assignmentId, principalId, projection, contents, expectedHash,
+        });
+        if (contextView.hash !== expectedHash)
+            throw new Error('Assignment Knowledge ephemeral Context hash drift');
+        text(contextView.ref, 'Assignment Knowledge Context ref');
+        return deepFreeze({ projection, contextView: { ...contextView } });
+    }
+}
+function knowledgeHandle(entry) {
+    return deepFreeze({
+        knowledgeId: entry.knowledgeId,
+        kind: entry.kind,
+        governedContent: { ...entry.governedContent },
+        schema: { ...entry.schema },
+        sensitivity: entry.sensitivity,
+        entryDigest: entry.digest,
+    });
+}
+function requestHeader(request) {
+    const keys = ['projectId', 'runId', 'taskKey', 'role', 'profileRevisionId', 'profileDigest'];
+    if (canonicalWorkroomJson(Object.keys(request).sort()) !== canonicalWorkroomJson(keys.sort())) {
+        throw new Error('Assignment Knowledge request keys are invalid');
+    }
+    text(request.projectId, 'Assignment Knowledge projectId');
+    text(request.runId, 'Assignment Knowledge runId');
+    text(request.taskKey, 'Assignment Knowledge taskKey');
+    text(request.role, 'Assignment Knowledge role');
+    text(request.profileRevisionId, 'Assignment Knowledge Profile revisionId');
+    requiredDigest(request.profileDigest, 'Assignment Knowledge Profile digest');
+}
+function text(value, label) {
+    if (typeof value !== 'string' || !value.trim() || value !== value.trim())
+        throw new Error(`${label} is invalid`);
+    return value;
+}
+function requiredDigest(value, label) {
+    const result = text(value, label);
+    if (!result.startsWith('sha256:'))
+        throw new Error(`${label} is invalid`);
+    return result;
+}
+//# sourceMappingURL=workroom-assignment-knowledge-context.js.map

package/lib/workroom/workroom-assignment-knowledge-context.js.map

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

package/lib/workroom/workroom-kernel.d.ts

@@ -0,0 +1,157 @@
+import type { WorkroomCommand, WorkroomRunState } from './kernel-contracts.js';
+import { type WorkroomJournal } from './journal/index.js';
+import { type AssignmentExecutionEnvelope, type AssignmentExecutionObservation } from './assignment-executor.js';
+import { type WorkflowPlanProposal } from './workflow-plan-builder.js';
+import { type WorkflowPlanRevisionCandidate } from './plan-revision.js';
+import { type WorkroomAcceptancePolicyDecisionPort } from './acceptance-policy.js';
+import { type ReviewerVerdict, type WorkroomAcceptanceAuthorityPort, type WorkroomSponsorDecision } from './acceptance-control.js';
+import { type WorkroomRemoteAssignmentAuthorityPort, type WorkroomRemoteAssignmentClaimRequest, type WorkroomRemoteAssignmentIssuance } from './remote-assignment-issuance.js';
+import { type WorkroomLocalAssignmentAuthorityPort, type WorkroomLocalAssignmentClaimRequest, type WorkroomLocalAssignmentIssuance } from './local-assignment-issuance.js';
+import { type WorkroomPriorityChangeProposal, type WorkroomScheduleDecision } from './workroom-scheduler.js';
+import { type WorkroomPriorityAuthorityPort } from './scheduler-priority-control.js';
+import { type WorkroomPlanGateAuthorityPort, type WorkroomPlanGateDecisionInput, type WorkroomPlanGateDecisionReceipt } from './plan-approval-control.js';
+import { type WorkroomRunControlAuthorityPort, type WorkroomRunControlCommand, type WorkroomRunControlReceipt } from './workroom-run-control.js';
+export interface CreateWorkroomRunInput {
+    readonly runId?: string;
+    readonly projectId: string;
+    readonly title: string;
+}
+export interface WorkroomKernelOptions {
+    readonly journal: WorkroomJournal;
+    readonly now?: () => number;
+    readonly createId?: () => string;
+    readonly acceptancePolicy?: WorkroomAcceptancePolicyDecisionPort;
+    readonly acceptanceAuthority?: WorkroomAcceptanceAuthorityPort;
+    readonly assignmentHeartbeatLeaseMs?: number;
+    /** Current-generation Profile/Capability/Agent/Endpoint authority resolver. */
+    readonly remoteAssignmentAuthority?: WorkroomRemoteAssignmentAuthorityPort;
+    /** Current-generation Profile/Capability/Agent/Workspace authority resolver. */
+    readonly localAssignmentAuthority?: WorkroomLocalAssignmentAuthorityPort;
+    readonly planGateAuthority?: WorkroomPlanGateAuthorityPort;
+    readonly priorityAuthority?: WorkroomPriorityAuthorityPort;
+    readonly runControlAuthority?: WorkroomRunControlAuthorityPort;
+}
+export interface WorkroomRemoteAssignmentIssuanceReceipt extends WorkroomRemoteAssignmentIssuance {
+    readonly state: WorkroomRunState;
+}
+export interface WorkroomLocalAssignmentIssuanceReceipt extends WorkroomLocalAssignmentIssuance {
+    readonly state: WorkroomRunState;
+}
+export interface WorkroomAssignmentIssuancePreview {
+    readonly version: 1;
+    readonly kind: 'local' | 'remote';
+    readonly assignmentRef: string;
+    readonly claimDigest: string;
+    readonly taskRevision: number;
+    readonly kernelSequence: number;
+    readonly kernelStateDigest: string;
+    readonly previewDigest: string;
+}
+export interface WorkroomPlanAdmissionInput {
+    readonly operationId: string;
+    readonly projectId: string;
+    readonly title: string;
+    readonly sourceEventRef: string;
+    readonly sourceEventDigest: string;
+    readonly orchestratorAgentDefinitionId: string;
+    readonly plan: WorkflowPlanProposal;
+}
+export interface WorkroomPlanAdmissionReceipt {
+    readonly runId: string;
+    readonly receiptRef: string;
+    readonly receiptDigest: string;
+    readonly state: WorkroomRunState;
+}
+export interface WorkroomPlanAdmissionReplay {
+    readonly operationId: string;
+    readonly sourceEventRef: string;
+    readonly sourceEventDigest: string;
+    readonly orchestratorAgentDefinitionId: string;
+    readonly plan: WorkflowPlanProposal;
+    readonly receipt: WorkroomPlanAdmissionReceipt;
+}
+export interface WorkroomSchedulerCommitReceipt {
+    readonly status: 'committed' | 'duplicate';
+    readonly decisionId: string;
+    readonly sequence: number;
+}
+export type WorkroomPlanRevisionAdmissionReceipt = Readonly<{
+    status: 'applied';
+    planRevision: number;
+    duplicate: boolean;
+    state: WorkroomRunState;
+}> | Readonly<{
+    status: 'stale';
+    planRevision: number;
+    actualSequence: number;
+    actualPlanDigest: string;
+}> | Readonly<{
+    status: 'preemption_required';
+    planRevision: number;
+    taskKeys: readonly string[];
+}> | Readonly<{
+    status: 'rejected';
+    planRevision: number;
+    reason: string;
+}>;
+export interface WorkroomPriorityCommitReceipt {
+    readonly status: 'committed' | 'duplicate';
+    readonly proposalId: string;
+    readonly sequence: number;
+}
+/** The sole command and state-transition authority for Workroom Run facts. */
+export declare class WorkroomKernel {
+    #private;
+    constructor(options: WorkroomKernelOptions);
+    createRun(input: CreateWorkroomRunInput): Promise<WorkroomRunState>;
+    /**
+     * Atomic, exact-replay admission of an Orchestrator proposal. The model can
+     * only provide a validated WorkflowPlanProposal; this Kernel method is the
+     * sole writer that materializes Run and Task facts.
+     */
+    admitWorkflowPlan(input: WorkroomPlanAdmissionInput): Promise<WorkroomPlanAdmissionReceipt>;
+    /** Exact persisted admission lookup used to finish a crash-interrupted application replay. */
+    readWorkflowPlanAdmission(operationId: string): Promise<WorkroomPlanAdmissionReplay | undefined>;
+    /** Kernel CAS admission for a non-authoritative, complete Plan Revision proposal. */
+    admitPlanRevision(candidate: WorkflowPlanRevisionCandidate): Promise<WorkroomPlanRevisionAdmissionReceipt>;
+    /** Exact authority verification followed by one Scheduler priority Journal fact. */
+    commitPriorityChange(value: WorkroomPriorityChangeProposal): Promise<WorkroomPriorityCommitReceipt>;
+    /** Typed pre-execution Sponsor decision; generic blocker resolution is forbidden for approval gates. */
+    decidePlanApprovalGate(input: WorkroomPlanGateDecisionInput): Promise<WorkroomPlanGateDecisionReceipt>;
+    /** Kernel-owned CAS commit for one exact deterministic Scheduler selection. */
+    commitSchedulerDecision(decision: WorkroomScheduleDecision): Promise<WorkroomSchedulerCommitReceipt>;
+    execute(projectId: string, runId: string, command: WorkroomCommand): Promise<WorkroomRunState>;
+    /** Sponsor-authorized, exact-sequence Run cancellation or durable replan request. */
+    controlRun(command: WorkroomRunControlCommand, authenticatedPrincipal: Readonly<{
+        principalId: string;
+    }>): Promise<WorkroomRunControlReceipt>;
+    /** Atomically persists the local Assignment claim and its exact Envelope. */
+    previewLocalAssignment(input: WorkroomLocalAssignmentClaimRequest): Promise<WorkroomAssignmentIssuancePreview>;
+    findLocalAssignment(input: WorkroomLocalAssignmentClaimRequest): Promise<WorkroomLocalAssignmentIssuanceReceipt | undefined>;
+    issueLocalAssignment(input: WorkroomLocalAssignmentClaimRequest): Promise<WorkroomLocalAssignmentIssuanceReceipt>;
+    /**
+     * Atomically persists the Kernel claim and its exact Remote Dispatch intent.
+     * A caller names only the desired definition/endpoint; the current-generation
+     * authority port supplies every executable snapshot and grant.
+     */
+    previewRemoteAssignment(input: WorkroomRemoteAssignmentClaimRequest): Promise<WorkroomAssignmentIssuancePreview>;
+    findRemoteAssignment(input: WorkroomRemoteAssignmentClaimRequest): Promise<WorkroomRemoteAssignmentIssuanceReceipt | undefined>;
+    issueRemoteAssignment(input: WorkroomRemoteAssignmentClaimRequest): Promise<WorkroomRemoteAssignmentIssuanceReceipt>;
+    applyAssignmentObservation(envelope: AssignmentExecutionEnvelope, value: AssignmentExecutionObservation, expectedSequence: number): Promise<WorkroomRunState>;
+    evaluateTaskAcceptance(projectId: string, runId: string, taskKey: string): Promise<WorkroomRunState>;
+    pinTaskAcceptance(projectId: string, runId: string, taskKey: string): Promise<WorkroomRunState>;
+    claimReviewerAssignment(projectId: string, runId: string, assignmentId: string, principalId: string): Promise<WorkroomRunState>;
+    submitReviewerVerdict(projectId: string, runId: string, assignmentId: string, principalId: string, verdict: ReviewerVerdict): Promise<WorkroomRunState>;
+    decideSponsorGate(projectId: string, runId: string, gateId: string, principalId: string, input: Readonly<{
+        candidateHash: string;
+        decision: WorkroomSponsorDecision;
+        reason: string;
+    }>): Promise<WorkroomRunState>;
+    read(projectId: string, runId: string): Promise<WorkroomRunState>;
+    list(projectId: string): Promise<readonly WorkroomRunState[]>;
+    /** Durable remote dispatch intents used by the generation recovery projector. */
+    listLocalAssignmentIssuances(): Promise<readonly WorkroomLocalAssignmentIssuanceReceipt[]>;
+    /** Durable remote dispatch intents used by the generation recovery projector. */
+    listRemoteAssignmentIssuances(): Promise<readonly WorkroomRemoteAssignmentIssuanceReceipt[]>;
+}
+//# sourceMappingURL=workroom-kernel.d.ts.map