@zhin.js/agent 1.1.13 → 1.1.14

package/lib/plugin-runtime/workroom-acceptance-production-composition.d.ts

@@ -0,0 +1,175 @@
+import type { Scope } from '@zhin.js/plugin-runtime';
+import type { WorkroomAcceptedReportReader } from '../workroom/accepted-source-memory-application.js';
+import { type WorkroomEffectIntent, type WorkroomEffectJournal } from '../workroom/effect-ledger.js';
+import type { ProjectProfileRegistry } from '../workroom/profile-registry.js';
+import type { WorkroomCatalog } from '../workroom/catalog.js';
+import type { WorkroomRunState } from '../workroom/kernel-contracts.js';
+import { type WorkroomContextReleaseConsumerPort, type WorkroomGovernedAcceptanceProjectionPort, type WorkroomKernelRiskHeaderPort, type WorkroomTypedAcceptanceCheck } from './workroom-acceptance-provider-composition.js';
+import { PinnedWorkroomAcceptancePolicy } from './workroom-risk-acceptance-runtime.js';
+import { type WorkroomPersistedEffectAuthorizationFacts, type WorkroomPersistedEffectAuthorizationFactsPort } from './workroom-effect-production.js';
+export interface WorkroomEffectSponsorDecisionBinding {
+    readonly effectIntentId: string;
+    readonly effectIntentDigest: string;
+    readonly candidateHash: string;
+    readonly assignmentAttempt: number;
+    readonly workspaceFence: number;
+    readonly workspaceRef: string;
+    readonly workspaceDigest: string;
+    readonly preconditionsDigest: string;
+    readonly risk: WorkroomEffectIntent['risk'];
+    readonly policy: Readonly<{
+        id: string;
+        revision: number;
+        digest: string;
+    }>;
+    readonly deadline: number;
+}
+export type WorkroomEffectSponsorDecisionReasonCode = 'approved_as_requested' | 'rejected_policy' | 'rejected_scope' | 'rejected_risk' | 'rejected_by_sponsor';
+export interface WorkroomEffectSponsorDecisionCommand {
+    readonly version: 2;
+    readonly operationId: string;
+    readonly projectId: string;
+    readonly runId: string;
+    readonly effectIntentId: string;
+    readonly effectIntentDigest: string;
+    readonly principalId: string;
+    readonly decision: 'approve' | 'reject';
+    /** Closed, content-free code. Human rationale belongs in a governed payload, never this repository. */
+    readonly reasonCode: WorkroomEffectSponsorDecisionReasonCode;
+    readonly decidedAt: number;
+}
+interface WorkroomEffectSponsorDecisionRequest extends WorkroomEffectSponsorDecisionCommand {
+    readonly digest: string;
+}
+export type WorkroomEffectSponsorDecisionAuthorityResult = Readonly<{
+    authorized: true;
+    authorizedBy: string;
+    catalogRevision: string;
+    projectDigest: string;
+    profileRef: string;
+    profileDigest: string;
+    profileRevision: number;
+    binding: WorkroomEffectSponsorDecisionBinding;
+    requestDigest: string;
+}> | Readonly<{
+    authorized: false;
+    requestDigest: string;
+    reason: string;
+}>;
+export interface WorkroomEffectSponsorDecisionAuthorityPort {
+    authorize(request: WorkroomEffectSponsorDecisionRequest): Promise<WorkroomEffectSponsorDecisionAuthorityResult>;
+}
+export interface WorkroomEffectSponsorDecisionScopePort {
+    resolve(input: Readonly<{
+        request: WorkroomEffectSponsorDecisionRequest;
+        intent: WorkroomEffectIntent;
+    }>): Promise<WorkroomEffectSponsorDecisionBinding | null>;
+}
+export interface WorkroomEffectSponsorDecisionRecord extends WorkroomEffectSponsorDecisionCommand {
+    readonly binding: WorkroomEffectSponsorDecisionBinding;
+    readonly authorizedBy: string;
+    readonly catalogRevision: string;
+    readonly projectDigest: string;
+    readonly profileRef: string;
+    readonly profileDigest: string;
+    readonly profileRevision: number;
+    readonly requestDigest: string;
+    readonly digest: string;
+}
+export interface WorkroomEffectAuthorizationPolicyPort {
+    authorize(input: Readonly<{
+        projectId: string;
+        intent: WorkroomEffectIntent;
+        candidateHash: string;
+        acceptancePolicy: WorkroomEffectSponsorDecisionBinding['policy'];
+        sponsorDecision: WorkroomEffectSponsorDecisionRecord;
+    }>): Promise<Readonly<{
+        approved: true;
+        policy: WorkroomEffectSponsorDecisionBinding['policy'];
+        expiresAt: number;
+        policyDecisionRef: string;
+        policyDecisionDigest: string;
+    }> | null>;
+}
+export interface WorkroomEffectSponsorDecisionControlPort {
+    decide(command: WorkroomEffectSponsorDecisionCommand): Promise<WorkroomEffectSponsorDecisionRecord>;
+}
+export interface SponsorDecisionWorkroomEffectAuthorizationProjectorOptions {
+    readonly directory: string;
+    readonly effectJournal: WorkroomEffectJournal;
+    readonly sponsorAuthority: WorkroomEffectSponsorDecisionAuthorityPort;
+    readonly policy: WorkroomEffectAuthorizationPolicyPort;
+}
+/**
+ * Dedicated Effect approval plane. It never reads discussion or Acceptance
+ * Sponsor Gate events and it has no Task/Assignment writer.
+ */
+export declare class SponsorDecisionWorkroomEffectAuthorizationProjector implements WorkroomPersistedEffectAuthorizationFactsPort {
+    #private;
+    readonly options: SponsorDecisionWorkroomEffectAuthorizationProjectorOptions;
+    readonly control: WorkroomEffectSponsorDecisionControlPort;
+    constructor(options: SponsorDecisionWorkroomEffectAuthorizationProjectorOptions);
+    drainProject(projectId: string): Promise<number>;
+    resolve(input: Parameters<WorkroomPersistedEffectAuthorizationFactsPort['resolve']>[0]): Promise<WorkroomPersistedEffectAuthorizationFacts | null>;
+}
+export interface InstallWorkroomAcceptanceResourcesOptions {
+    readonly projectRoot: string;
+    readonly generation: number;
+    readonly signal: AbortSignal;
+    readonly resources: Pick<Scope, 'has' | 'provide'>;
+    readonly profiles: Pick<ProjectProfileRegistry, 'read'>;
+    readonly catalog: Pick<WorkroomCatalog, 'read'>;
+    readonly projections?: WorkroomGovernedAcceptanceProjectionPort;
+    readonly reports: WorkroomAcceptedReportReader;
+    readonly riskHeaders?: WorkroomKernelRiskHeaderPort;
+    readonly checks?: readonly WorkroomTypedAcceptanceCheck[];
+    readonly contextConsumer?: WorkroomContextReleaseConsumerPort;
+    readonly effectJournal: WorkroomEffectJournal;
+    readonly runState: Readonly<{
+        read(projectId: string, runId: string): Promise<WorkroomRunState>;
+    }>;
+    readonly effectAuthorizationPolicy?: WorkroomEffectAuthorizationPolicyPort;
+    readonly effectSponsorDecisionScopes?: WorkroomEffectSponsorDecisionScopePort;
+    /** Exact Project ids owned by this generation; enables restart-safe Effect fact projection. */
+    readonly projects?: Readonly<{
+        listProjectIds(): Promise<readonly string[]>;
+    }>;
+    readonly projectorIntervalMs?: number;
+    readonly onProjectorError?: (error: unknown) => void;
+}
+export interface WorkroomAcceptanceProductionComposition {
+    readonly policy: PinnedWorkroomAcceptancePolicy;
+    readonly effectAuthorizations: SponsorDecisionWorkroomEffectAuthorizationProjector;
+    readonly projectorRuntime: WorkroomEffectAuthorizationProjectionRuntime;
+    /** Root-private authenticated Effect Sponsor control; never publish as a model Resource. */
+    readonly effectSponsorControl: WorkroomEffectSponsorDecisionControlPort;
+}
+/** Generation lifecycle for the durable Sponsor decision -> P8 authorization fact projector. */
+export declare class WorkroomEffectAuthorizationProjectionRuntime {
+    #private;
+    readonly options: Readonly<{
+        signal: AbortSignal;
+        projects?: Readonly<{
+            listProjectIds(): Promise<readonly string[]>;
+        }>;
+        projector: SponsorDecisionWorkroomEffectAuthorizationProjector;
+        intervalMs?: number;
+        onError?: (error: unknown) => void;
+    }>;
+    constructor(options: Readonly<{
+        signal: AbortSignal;
+        projects?: Readonly<{
+            listProjectIds(): Promise<readonly string[]>;
+        }>;
+        projector: SponsorDecisionWorkroomEffectAuthorizationProjector;
+        intervalMs?: number;
+        onError?: (error: unknown) => void;
+    }>);
+    start(): void;
+    drain(): Promise<number>;
+    dispose(): Promise<void>;
+}
+/** Standard resource graph. Every published port is generation-abort guarded. */
+export declare function installWorkroomAcceptanceResources(options: InstallWorkroomAcceptanceResourcesOptions): WorkroomAcceptanceProductionComposition;
+export {};
+//# sourceMappingURL=workroom-acceptance-production-composition.d.ts.map

package/lib/plugin-runtime/workroom-acceptance-production-composition.d.ts.map

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