botmux 2.111.0 → 2.112.0

package/dist/workflows/v3/distillation-store.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Durable private store for Workflow v3 parameter-distillation proposals.
+ *
+ * The model-authored suggestion never reaches this module.  `proposal.json`
+ * contains only the host-compiled, parsed proposal body.  Immutable proposal
+ * material and mutable lifecycle state are deliberately separate so a state
+ * transition can never rewrite the object the user reviewed.
+ *
+ * Lock order is always identity-index -> proposal state.  The durable
+ * `replacing` index entry makes supersession recoverable without ever leaving
+ * two proposals eligible for approval.
+ */
+import { V3_DISTILLATION_COMPILER_VERSION, type V3DistillationCompiledBodyV1 } from './distillation-schema.js';
+declare const PREPARED_SCHEMA_VERSION: 1;
+declare const PROPOSAL_SCHEMA_VERSION: 1;
+declare const STATE_SCHEMA_VERSION: 1;
+export declare const V3_DISTILLATION_PROPOSAL_ID_RE: RegExp;
+export type V3DistillationStoreErrorCode = 'INVALID_ARGUMENT' | 'PROPOSAL_NOT_FOUND' | 'STORE_CORRUPT' | 'CONTENT_CONFLICT' | 'STATE_CONFLICT' | 'IDENTITY_BUSY' | 'STALE_PROPOSAL';
+/** Fixed-message error: private paths, values, and parser output are never reflected. */
+export declare class V3DistillationStoreError extends Error {
+    readonly code: V3DistillationStoreErrorCode;
+    constructor(code: V3DistillationStoreErrorCode);
+}
+export interface V3DistillationSourceIdentityV1 {
+    runId: string;
+    runEnvelopeSha256: string;
+    dagSha256: string;
+    specSha256: string;
+    botSnapshotsSha256: string;
+    baselineRevisionSha256: string;
+    ownerOpenId: string;
+    larkAppId: string;
+    chatId: string;
+}
+export interface V3DistillationPreparedBodyV1 {
+    schemaVersion: typeof PREPARED_SCHEMA_VERSION;
+    proposalId: string;
+    requestKey: string;
+    liveKey: string;
+    compilerVersion: typeof V3_DISTILLATION_COMPILER_VERSION;
+    sourceIdentity: V3DistillationSourceIdentityV1;
+    replyTarget: V3DistillationReplyTargetV1;
+    displayName: string;
+}
+export type V3DistillationReplyTargetV1 = {
+    kind: 'chat';
+    chatId: string;
+} | {
+    kind: 'thread';
+    rootMessageId: string;
+};
+export interface V3DistillationProposalBodyV1 {
+    schemaVersion: typeof PROPOSAL_SCHEMA_VERSION;
+    proposalId: string;
+    proposalHash: string;
+    liveKey: string;
+    compilerVersion: typeof V3_DISTILLATION_COMPILER_VERSION;
+    sourceIdentity: V3DistillationSourceIdentityV1;
+    displayName: string;
+    createdAt: string;
+    compiled: V3DistillationCompiledBodyV1;
+}
+export interface V3DistillationApprovalV1 {
+    operatorOpenId: string;
+    larkAppId: string;
+    chatId: string;
+    acceptedAt: string;
+}
+export interface V3DistillationRejectionV1 {
+    operatorOpenId: string;
+    larkAppId: string;
+    chatId: string;
+    rejectedAt: string;
+}
+export interface V3DistillationCommitAllocationV1 {
+    workflowId: string;
+    createdAt: string;
+    startedAt: string;
+}
+export interface V3DistillationCommitResultV1 {
+    workflowId: string;
+    revisionId: string;
+    revisionContentHash?: string;
+    committedAt: string;
+}
+interface StateBase {
+    schemaVersion: typeof STATE_SCHEMA_VERSION;
+    proposalId: string;
+    liveKey: string;
+    preparedAt: string;
+    updatedAt: string;
+}
+export type V3DistillationProposalStateV1 = (StateBase & {
+    state: 'prepared';
+}) | (StateBase & {
+    state: 'proposed';
+    proposalHash: string;
+    proposedAt: string;
+}) | (StateBase & {
+    state: 'accepted';
+    proposalHash: string;
+    proposedAt: string;
+    approval: V3DistillationApprovalV1;
+}) | (StateBase & {
+    state: 'committing';
+    proposalHash: string;
+    proposedAt: string;
+    approval: V3DistillationApprovalV1;
+    commit: V3DistillationCommitAllocationV1;
+}) | (StateBase & {
+    state: 'committed';
+    proposalHash: string;
+    proposedAt: string;
+    approval: V3DistillationApprovalV1;
+    commit: V3DistillationCommitAllocationV1;
+    result: V3DistillationCommitResultV1;
+}) | (StateBase & {
+    state: 'rejected';
+    proposalHash: string;
+    proposedAt: string;
+    rejection: V3DistillationRejectionV1;
+}) | (StateBase & {
+    state: 'superseded';
+    proposalHash: string;
+    proposedAt: string;
+    supersededByProposalId: string;
+    supersededAt: string;
+});
+export interface LoadedV3DistillationProposal {
+    prepared: V3DistillationPreparedBodyV1;
+    proposal?: V3DistillationProposalBodyV1;
+    state: V3DistillationProposalStateV1;
+}
+export interface PrepareV3DistillationProposalInput {
+    /** Stable per inbound Lark event/message; duplicate delivery reuses the allocation. */
+    requestKey: string;
+    sourceIdentity: V3DistillationSourceIdentityV1;
+    replyTarget: V3DistillationReplyTargetV1;
+    displayName: string;
+    compilerVersion: typeof V3_DISTILLATION_COMPILER_VERSION;
+    now?: Date;
+}
+export interface PublishV3DistillationProposalInput {
+    compiled: V3DistillationCompiledBodyV1;
+    now?: Date;
+}
+export interface ActOnV3DistillationProposalInput {
+    proposalHash: string;
+    operatorOpenId: string;
+    larkAppId: string;
+    chatId: string;
+    now?: Date;
+}
+export interface BeginV3DistillationCommitInput {
+    proposalHash: string;
+    workflowId: string;
+    /** Timestamp frozen into the final Saved Workflow revision allocation. */
+    createdAt: string;
+    now?: Date;
+}
+export interface MarkV3DistillationCommittedInput {
+    proposalHash: string;
+    workflowId: string;
+    revisionId: string;
+    revisionContentHash?: string;
+    now?: Date;
+}
+export declare function computeV3DistillationLiveKey(sourceIdentity: V3DistillationSourceIdentityV1, compilerVersion: typeof V3_DISTILLATION_COMPILER_VERSION): string;
+export declare function v3DistillationStoreRoot(dataDir: string): string;
+export declare function v3DistillationProposalDir(dataDir: string, proposalId: string): string;
+/** Prepare or idempotently recover a per-request proposal allocation. */
+export declare function prepareProposal(dataDir: string, input: PrepareV3DistillationProposalInput): LoadedV3DistillationProposal;
+/** Publish the immutable host-compiled proposal and enter `proposed`. */
+export declare function publishProposal(dataDir: string, proposalId: string, input: PublishV3DistillationProposalInput): LoadedV3DistillationProposal;
+export declare function acceptProposal(dataDir: string, proposalId: string, input: ActOnV3DistillationProposalInput): LoadedV3DistillationProposal;
+export declare function rejectProposal(dataDir: string, proposalId: string, input: ActOnV3DistillationProposalInput): LoadedV3DistillationProposal;
+export declare function beginCommit(dataDir: string, proposalId: string, input: BeginV3DistillationCommitInput): LoadedV3DistillationProposal;
+export declare function markCommitted(dataDir: string, proposalId: string, input: MarkV3DistillationCommittedInput): LoadedV3DistillationProposal;
+export declare function loadProposal(dataDir: string, proposalId: string): LoadedV3DistillationProposal;
+/** Strict startup inventory for crash recovery. Unknown entries fail closed. */
+export declare function listV3DistillationProposals(dataDir: string): LoadedV3DistillationProposal[];
+/** Current active allocations only; used by daemon cold recovery. */
+export declare function listActiveV3DistillationProposals(dataDir: string): LoadedV3DistillationProposal[];
+export {};
+//# sourceMappingURL=distillation-store.d.ts.map

package/dist/workflows/v3/distillation-store.d.ts.map

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