@lssm/lib.companyos-spec 3.0.2

package/dist/types/execution.d.ts

@@ -0,0 +1,498 @@
+import { z } from 'zod';
+export declare const CompanyOsExecutionLifecycleStateSchema: z.ZodEnum<{
+    approval_required: "approval_required";
+    blocked: "blocked";
+    cancelled: "cancelled";
+    claimed: "claimed";
+    dispatch_ready: "dispatch_ready";
+    dispatched: "dispatched";
+    dry_run_required: "dry_run_required";
+    failed: "failed";
+    planned: "planned";
+    policy_gated: "policy_gated";
+    running: "running";
+    succeeded: "succeeded";
+}>;
+export type CompanyOsExecutionLifecycleState = z.infer<typeof CompanyOsExecutionLifecycleStateSchema>;
+export declare const CompanyOsExecutionDispatchLaneSchema: z.ZodEnum<{
+    agent: "agent";
+    dry_run: "dry_run";
+    human: "human";
+    integration: "integration";
+    job: "job";
+    manual_record: "manual_record";
+}>;
+export type CompanyOsExecutionDispatchLane = z.infer<typeof CompanyOsExecutionDispatchLaneSchema>;
+export declare const CompanyOsExecutionClaimSchema: z.ZodObject<{
+    id: z.ZodString;
+    executionPlanId: z.ZodString;
+    workItemId: z.ZodString;
+    claimantPrincipalId: z.ZodString;
+    accountableOwnerPrincipalId: z.ZodString;
+    leaseId: z.ZodString;
+    leaseExpiresAt: z.ZodString;
+    status: z.ZodEnum<{
+        active: "active";
+        cancelled: "cancelled";
+        expired: "expired";
+        released: "released";
+    }>;
+    scope: z.ZodString;
+    claimedAt: z.ZodString;
+    sourceRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        connectorCapability: z.ZodString;
+        providerKey: z.ZodOptional<z.ZodString>;
+        externalId: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        observedAt: z.ZodString;
+        metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type CompanyOsExecutionClaim = z.infer<typeof CompanyOsExecutionClaimSchema>;
+export declare const CompanyOsExecutionIdempotencySchema: z.ZodObject<{
+    key: z.ZodString;
+    dedupeKey: z.ZodString;
+    strategy: z.ZodEnum<{
+        append_attempt: "append_attempt";
+        reject_duplicate: "reject_duplicate";
+        reuse_receipt: "reuse_receipt";
+    }>;
+    firstSeenAt: z.ZodString;
+    duplicateOfExecutionPlanId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CompanyOsExecutionIdempotency = z.infer<typeof CompanyOsExecutionIdempotencySchema>;
+export declare const CompanyOsRetryPolicyRefSchema: z.ZodObject<{
+    id: z.ZodString;
+    maxAttempts: z.ZodNumber;
+    backoff: z.ZodEnum<{
+        exponential: "exponential";
+        fixed: "fixed";
+        none: "none";
+    }>;
+    deadLetterRef: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CompanyOsRetryPolicyRef = z.infer<typeof CompanyOsRetryPolicyRefSchema>;
+export declare const CompanyOsPolicyGateRequestSchema: z.ZodObject<{
+    id: z.ZodString;
+    executionPlanId: z.ZodString;
+    workItemId: z.ZodString;
+    operation: z.ZodString;
+    requestedByPrincipalId: z.ZodString;
+    autonomyDecisionId: z.ZodString;
+    authorityEvidenceRefIds: z.ZodArray<z.ZodString>;
+    rbacEvidenceRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    riskEvidenceRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    budgetEvidenceRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    toolEvidenceRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    dryRunRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    sourceRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        connectorCapability: z.ZodString;
+        providerKey: z.ZodOptional<z.ZodString>;
+        externalId: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        observedAt: z.ZodString;
+        metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type CompanyOsPolicyGateRequest = z.infer<typeof CompanyOsPolicyGateRequestSchema>;
+export declare const CompanyOsPolicyGateDecisionSchema: z.ZodObject<{
+    id: z.ZodString;
+    requestId: z.ZodString;
+    autonomyDecision: z.ZodObject<{
+        id: z.ZodString;
+        operation: z.ZodString;
+        proposedLevel: z.ZodEnum<{
+            draft_only: "draft_only";
+            execute_with_approval: "execute_with_approval";
+            execute_within_limits: "execute_within_limits";
+            fully_autonomous_bounded: "fully_autonomous_bounded";
+            observe_only: "observe_only";
+            recommend: "recommend";
+            reserved_human_only: "reserved_human_only";
+        }>;
+        approvedLevel: z.ZodEnum<{
+            draft_only: "draft_only";
+            execute_with_approval: "execute_with_approval";
+            execute_within_limits: "execute_within_limits";
+            fully_autonomous_bounded: "fully_autonomous_bounded";
+            observe_only: "observe_only";
+            recommend: "recommend";
+            reserved_human_only: "reserved_human_only";
+        }>;
+        customerFacing: z.ZodDefault<z.ZodBoolean>;
+        requiredApprovalIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        accountableOwnerPrincipalId: z.ZodString;
+        sourceRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            connectorCapability: z.ZodString;
+            providerKey: z.ZodOptional<z.ZodString>;
+            externalId: z.ZodOptional<z.ZodString>;
+            url: z.ZodOptional<z.ZodString>;
+            observedAt: z.ZodString;
+            metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>>;
+        reasoning: z.ZodString;
+    }, z.core.$strip>;
+    authorityStatus: z.ZodEnum<{
+        allowed: "allowed";
+        missing_owner: "missing_owner";
+        missing_principal: "missing_principal";
+        no_matching_grant: "no_matching_grant";
+        requires_approval: "requires_approval";
+    }>;
+    verdict: z.ZodEnum<{
+        allow: "allow";
+        approval_required: "approval_required";
+        denied: "denied";
+        dry_run_required: "dry_run_required";
+        reserved_human_only: "reserved_human_only";
+    }>;
+    approvedDispatchLane: z.ZodOptional<z.ZodEnum<{
+        agent: "agent";
+        dry_run: "dry_run";
+        human: "human";
+        integration: "integration";
+        job: "job";
+        manual_record: "manual_record";
+    }>>;
+    requiredApprovalIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    evidenceRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    reasons: z.ZodArray<z.ZodString>;
+    decidedAt: z.ZodString;
+}, z.core.$strip>;
+export type CompanyOsPolicyGateDecision = z.infer<typeof CompanyOsPolicyGateDecisionSchema>;
+export declare const CompanyOsExecutionDispatchSchema: z.ZodObject<{
+    id: z.ZodString;
+    executionPlanId: z.ZodString;
+    lane: z.ZodEnum<{
+        agent: "agent";
+        dry_run: "dry_run";
+        human: "human";
+        integration: "integration";
+        job: "job";
+        manual_record: "manual_record";
+    }>;
+    status: z.ZodEnum<{
+        cancelled: "cancelled";
+        completed: "completed";
+        dispatched: "dispatched";
+        failed: "failed";
+        queued: "queued";
+    }>;
+    targetRef: z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    idempotencyKey: z.ZodString;
+    requiresReceipt: z.ZodDefault<z.ZodBoolean>;
+    dispatchedAt: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type CompanyOsExecutionDispatch = z.infer<typeof CompanyOsExecutionDispatchSchema>;
+export declare const CompanyOsSourceEvidenceRefSchema: z.ZodObject<{
+    id: z.ZodString;
+    connectorCapability: z.ZodString;
+    providerKey: z.ZodOptional<z.ZodString>;
+    externalId: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    observedAt: z.ZodString;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    evidenceRole: z.ZodEnum<{
+        command_intent: "command_intent";
+        dry_run_output: "dry_run_output";
+        operator_decision: "operator_decision";
+        outcome_observation: "outcome_observation";
+        policy_input: "policy_input";
+        source_observation: "source_observation";
+    }>;
+    authorizationAuthority: z.ZodDefault<z.ZodLiteral<false>>;
+    sourceTraceId: z.ZodOptional<z.ZodString>;
+    agenticInteractionPacketId: z.ZodOptional<z.ZodString>;
+    commandInboxItemId: z.ZodOptional<z.ZodString>;
+    asOf: z.ZodString;
+}, z.core.$strip>;
+export type CompanyOsSourceEvidenceRef = z.infer<typeof CompanyOsSourceEvidenceRefSchema>;
+export declare const CompanyOsDispatchAuthorizationFailureSchema: z.ZodObject<{
+    code: z.ZodEnum<{
+        lane_not_authorized: "lane_not_authorized";
+        missing_accountable_owner: "missing_accountable_owner";
+        missing_dry_run_proof: "missing_dry_run_proof";
+        missing_policy_gate_decision: "missing_policy_gate_decision";
+        missing_required_approval: "missing_required_approval";
+        policy_verdict_denied: "policy_verdict_denied";
+        replay_not_deterministic: "replay_not_deterministic";
+        source_evidence_only: "source_evidence_only";
+    }>;
+    message: z.ZodString;
+    evidenceRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    sourceEvidenceRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type CompanyOsDispatchAuthorizationFailure = z.infer<typeof CompanyOsDispatchAuthorizationFailureSchema>;
+export declare const CompanyOsExecutionDispatchAuthorizationSchema: z.ZodObject<{
+    id: z.ZodString;
+    executionPlanId: z.ZodString;
+    executionClaimId: z.ZodString;
+    dispatchId: z.ZodOptional<z.ZodString>;
+    policyGateRequestId: z.ZodString;
+    policyGateDecisionId: z.ZodString;
+    authorizedLane: z.ZodEnum<{
+        agent: "agent";
+        dry_run: "dry_run";
+        human: "human";
+        integration: "integration";
+        job: "job";
+        manual_record: "manual_record";
+    }>;
+    verdict: z.ZodEnum<{
+        allow: "allow";
+        denied: "denied";
+        dry_run_only: "dry_run_only";
+        operator_approval_required: "operator_approval_required";
+    }>;
+    accountableOwnerPrincipalId: z.ZodString;
+    authorizedByPrincipalId: z.ZodOptional<z.ZodString>;
+    requiredApprovalIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    dryRunProofRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    sourceEvidenceRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    failure: z.ZodOptional<z.ZodObject<{
+        code: z.ZodEnum<{
+            lane_not_authorized: "lane_not_authorized";
+            missing_accountable_owner: "missing_accountable_owner";
+            missing_dry_run_proof: "missing_dry_run_proof";
+            missing_policy_gate_decision: "missing_policy_gate_decision";
+            missing_required_approval: "missing_required_approval";
+            policy_verdict_denied: "policy_verdict_denied";
+            replay_not_deterministic: "replay_not_deterministic";
+            source_evidence_only: "source_evidence_only";
+        }>;
+        message: z.ZodString;
+        evidenceRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        sourceEvidenceRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    authorizedAt: z.ZodString;
+    asOf: z.ZodString;
+    expiresAt: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type CompanyOsExecutionDispatchAuthorization = z.infer<typeof CompanyOsExecutionDispatchAuthorizationSchema>;
+export declare const CompanyOsOperatorInboxRouteSchema: z.ZodObject<{
+    id: z.ZodString;
+    executionPlanId: z.ZodString;
+    authorizationId: z.ZodOptional<z.ZodString>;
+    routeKind: z.ZodEnum<{
+        approval_required: "approval_required";
+        blocked: "blocked";
+        dry_run_review: "dry_run_review";
+        operator_review: "operator_review";
+    }>;
+    requiredPrincipalIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    reason: z.ZodString;
+    sourceEvidenceRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    createdAt: z.ZodString;
+    asOf: z.ZodString;
+}, z.core.$strip>;
+export type CompanyOsOperatorInboxRoute = z.infer<typeof CompanyOsOperatorInboxRouteSchema>;
+export declare const CompanyOsPolicyReplayPacketSchema: z.ZodObject<{
+    id: z.ZodString;
+    executionPlanId: z.ZodString;
+    policyGateRequestId: z.ZodString;
+    policyGateDecisionId: z.ZodOptional<z.ZodString>;
+    authorizationId: z.ZodOptional<z.ZodString>;
+    sourceEvidenceRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        connectorCapability: z.ZodString;
+        providerKey: z.ZodOptional<z.ZodString>;
+        externalId: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        observedAt: z.ZodString;
+        metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        evidenceRole: z.ZodEnum<{
+            command_intent: "command_intent";
+            dry_run_output: "dry_run_output";
+            operator_decision: "operator_decision";
+            outcome_observation: "outcome_observation";
+            policy_input: "policy_input";
+            source_observation: "source_observation";
+        }>;
+        authorizationAuthority: z.ZodDefault<z.ZodLiteral<false>>;
+        sourceTraceId: z.ZodOptional<z.ZodString>;
+        agenticInteractionPacketId: z.ZodOptional<z.ZodString>;
+        commandInboxItemId: z.ZodOptional<z.ZodString>;
+        asOf: z.ZodString;
+    }, z.core.$strip>>>;
+    decisionRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    inputHash: z.ZodString;
+    outputHash: z.ZodString;
+    deterministic: z.ZodDefault<z.ZodLiteral<true>>;
+    createdAt: z.ZodString;
+    asOf: z.ZodString;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type CompanyOsPolicyReplayPacket = z.infer<typeof CompanyOsPolicyReplayPacketSchema>;
+export declare const CompanyOsReplayDeterminismCaseSchema: z.ZodObject<{
+    id: z.ZodString;
+    replayPacketId: z.ZodString;
+    executionPlanId: z.ZodString;
+    inputHash: z.ZodString;
+    expectedOutputHash: z.ZodString;
+    actualOutputHash: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<{
+        fail: "fail";
+        not_run: "not_run";
+        pass: "pass";
+    }>;
+    varianceReason: z.ZodOptional<z.ZodString>;
+    checkedAt: z.ZodOptional<z.ZodString>;
+    asOf: z.ZodString;
+    sourceEvidenceRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type CompanyOsReplayDeterminismCase = z.infer<typeof CompanyOsReplayDeterminismCaseSchema>;
+export declare const CompanyOsOutcomeLinkageSchema: z.ZodObject<{
+    id: z.ZodString;
+    executionPlanId: z.ZodString;
+    dispatchId: z.ZodOptional<z.ZodString>;
+    receiptIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    outcomeReceiptId: z.ZodString;
+    objectiveIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    reviewOutputPlanIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    sourceEvidenceRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    status: z.ZodEnum<{
+        blocked: "blocked";
+        linked: "linked";
+        partial: "partial";
+    }>;
+    linkedAt: z.ZodString;
+    asOf: z.ZodString;
+}, z.core.$strip>;
+export type CompanyOsOutcomeLinkage = z.infer<typeof CompanyOsOutcomeLinkageSchema>;
+export declare const CompanyOsWorkExecutionPlanSchema: z.ZodObject<{
+    id: z.ZodString;
+    workItemId: z.ZodString;
+    operation: z.ZodString;
+    lifecycleState: z.ZodEnum<{
+        approval_required: "approval_required";
+        blocked: "blocked";
+        cancelled: "cancelled";
+        claimed: "claimed";
+        dispatch_ready: "dispatch_ready";
+        dispatched: "dispatched";
+        dry_run_required: "dry_run_required";
+        failed: "failed";
+        planned: "planned";
+        policy_gated: "policy_gated";
+        running: "running";
+        succeeded: "succeeded";
+    }>;
+    accountableOwnerPrincipalId: z.ZodString;
+    claimId: z.ZodOptional<z.ZodString>;
+    idempotency: z.ZodObject<{
+        key: z.ZodString;
+        dedupeKey: z.ZodString;
+        strategy: z.ZodEnum<{
+            append_attempt: "append_attempt";
+            reject_duplicate: "reject_duplicate";
+            reuse_receipt: "reuse_receipt";
+        }>;
+        firstSeenAt: z.ZodString;
+        duplicateOfExecutionPlanId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    retryPolicy: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        maxAttempts: z.ZodNumber;
+        backoff: z.ZodEnum<{
+            exponential: "exponential";
+            fixed: "fixed";
+            none: "none";
+        }>;
+        deadLetterRef: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    policyGateRequestId: z.ZodString;
+    policyGateDecisionId: z.ZodOptional<z.ZodString>;
+    dispatchIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    receiptIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    outcomeReceiptIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    checkpointRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    replayRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    cancellationRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    sourceRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        connectorCapability: z.ZodString;
+        providerKey: z.ZodOptional<z.ZodString>;
+        externalId: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        observedAt: z.ZodString;
+        metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type CompanyOsWorkExecutionPlan = z.infer<typeof CompanyOsWorkExecutionPlanSchema>;
+export declare const CompanyOsExecutionReceiptSchema: z.ZodObject<{
+    id: z.ZodString;
+    executionPlanId: z.ZodString;
+    dispatchId: z.ZodString;
+    lane: z.ZodEnum<{
+        agent: "agent";
+        dry_run: "dry_run";
+        human: "human";
+        integration: "integration";
+        job: "job";
+        manual_record: "manual_record";
+    }>;
+    status: z.ZodEnum<{
+        blocked: "blocked";
+        cancelled: "cancelled";
+        dispatched: "dispatched";
+        dry_run_completed: "dry_run_completed";
+        failed: "failed";
+        succeeded: "succeeded";
+    }>;
+    idempotencyKey: z.ZodString;
+    startedAt: z.ZodString;
+    completedAt: z.ZodOptional<z.ZodString>;
+    outputRef: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    errorSummary: z.ZodOptional<z.ZodString>;
+    evidenceRefIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type CompanyOsExecutionReceipt = z.infer<typeof CompanyOsExecutionReceiptSchema>;
+export declare const CompanyOsOutcomeReceiptSchema: z.ZodObject<{
+    id: z.ZodString;
+    executionPlanId: z.ZodString;
+    workItemId: z.ZodString;
+    status: z.ZodEnum<{
+        achieved: "achieved";
+        no_change: "no_change";
+        partial: "partial";
+        regressed: "regressed";
+        unknown: "unknown";
+    }>;
+    summary: z.ZodString;
+    objectiveIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    memorySnapshotIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    cadenceIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    receiptIds: z.ZodArray<z.ZodString>;
+    observedAt: z.ZodString;
+    sourceRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        connectorCapability: z.ZodString;
+        providerKey: z.ZodOptional<z.ZodString>;
+        externalId: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        observedAt: z.ZodString;
+        metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type CompanyOsOutcomeReceipt = z.infer<typeof CompanyOsOutcomeReceiptSchema>;

package/dist/types/execution.js

@@ -0,0 +1,2 @@
+// @bun
+import{z as e}from"zod";import{z as n}from"zod";import{z as t}from"zod";var a=t.record(t.string(),t.unknown()),i=t.object({id:t.string().min(1),connectorCapability:t.string().min(1),providerKey:t.string().min(1).optional(),externalId:t.string().min(1).optional(),url:t.string().url().optional(),observedAt:t.string().min(1),metadata:a.default({})}),x=t.object({default:t.string().min(1),translations:t.record(t.string(),t.string()).default({})}),m=t.object({id:t.string().min(1),type:t.string().min(1),label:t.string().min(1).optional()});import{z as r}from"zod";var s=r.enum(["observe_only","draft_only","recommend","execute_with_approval","execute_within_limits","fully_autonomous_bounded","reserved_human_only"]),C=r.enum(["human","agent","service","external_party"]),_=r.enum(["communication","work_tracking","code_repository","knowledge_source","document_store","crm","analytics","identity","calendar","meeting_recorder","support_desk","messaging_channel"]),S=r.enum(["proposed","accepted","in_progress","blocked","done","cancelled"]),R=r.enum(["approval_required","customer_commitment","risky_reply","blocked_work","contract_proposal","operating_review_item"]);var A=n.object({id:n.string().min(1),defaultLevel:s.default("draft_only"),maxCustomerFacingLevel:s.default("execute_with_approval"),reservedHumanOnlyOperations:n.array(n.string().min(1)).default([]),approvalRequiredOperations:n.array(n.string().min(1)).default([]),emergencyStopPrincipalIds:n.array(n.string().min(1)).min(1)}),d=n.object({id:n.string().min(1),operation:n.string().min(1),proposedLevel:s,approvedLevel:s,customerFacing:n.boolean().default(!1),requiredApprovalIds:n.array(n.string().min(1)).default([]),accountableOwnerPrincipalId:n.string().min(1),sourceRefs:n.array(i).default([]),reasoning:n.string().min(1)}),E=n.object({id:n.string().min(1),agentPrincipalId:n.string().min(1),operation:n.string().min(1),targetType:n.string().min(1),targetRefId:n.string().min(1),draftOnly:n.boolean().default(!0),autonomyDecisionId:n.string().min(1)});var y=e.enum(["planned","claimed","policy_gated","dry_run_required","approval_required","dispatch_ready","dispatched","running","succeeded","failed","cancelled","blocked"]),c=e.enum(["agent","job","integration","human","dry_run","manual_record"]),j=e.object({id:e.string().min(1),executionPlanId:e.string().min(1),workItemId:e.string().min(1),claimantPrincipalId:e.string().min(1),accountableOwnerPrincipalId:e.string().min(1),leaseId:e.string().min(1),leaseExpiresAt:e.string().min(1),status:e.enum(["active","released","expired","cancelled"]),scope:e.string().min(1),claimedAt:e.string().min(1),sourceRefs:e.array(i).default([])}),u=e.object({key:e.string().min(1),dedupeKey:e.string().min(1),strategy:e.enum(["reject_duplicate","reuse_receipt","append_attempt"]),firstSeenAt:e.string().min(1),duplicateOfExecutionPlanId:e.string().min(1).optional()}),l=e.object({id:e.string().min(1),maxAttempts:e.number().int().min(1),backoff:e.enum(["none","fixed","exponential"]),deadLetterRef:m.optional()}),q=e.object({id:e.string().min(1),executionPlanId:e.string().min(1),workItemId:e.string().min(1),operation:e.string().min(1),requestedByPrincipalId:e.string().min(1),autonomyDecisionId:e.string().min(1),authorityEvidenceRefIds:e.array(e.string().min(1)).min(1),rbacEvidenceRefIds:e.array(e.string().min(1)).default([]),riskEvidenceRefIds:e.array(e.string().min(1)).default([]),budgetEvidenceRefIds:e.array(e.string().min(1)).default([]),toolEvidenceRefIds:e.array(e.string().min(1)).default([]),dryRunRefIds:e.array(e.string().min(1)).default([]),sourceRefs:e.array(i).default([])}),G=e.object({id:e.string().min(1),requestId:e.string().min(1),autonomyDecision:d,authorityStatus:e.enum(["allowed","requires_approval","missing_principal","missing_owner","no_matching_grant"]),verdict:e.enum(["allow","dry_run_required","approval_required","reserved_human_only","denied"]),approvedDispatchLane:c.optional(),requiredApprovalIds:e.array(e.string().min(1)).default([]),evidenceRefIds:e.array(e.string().min(1)).default([]),reasons:e.array(e.string().min(1)).min(1),decidedAt:e.string().min(1)}),K=e.object({id:e.string().min(1),executionPlanId:e.string().min(1),lane:c,status:e.enum(["queued","dispatched","completed","failed","cancelled"]),targetRef:m,idempotencyKey:e.string().min(1),requiresReceipt:e.boolean().default(!0),dispatchedAt:e.string().min(1).optional(),metadata:a.default({})}),f=i.extend({evidenceRole:e.enum(["source_observation","command_intent","policy_input","dry_run_output","operator_decision","outcome_observation"]),authorizationAuthority:e.literal(!1).default(!1),sourceTraceId:e.string().min(1).optional(),agenticInteractionPacketId:e.string().min(1).optional(),commandInboxItemId:e.string().min(1).optional(),asOf:e.string().min(1)}),g=e.object({code:e.enum(["missing_policy_gate_decision","policy_verdict_denied","lane_not_authorized","missing_accountable_owner","missing_required_approval","missing_dry_run_proof","source_evidence_only","replay_not_deterministic"]),message:e.string().min(1),evidenceRefIds:e.array(e.string().min(1)).default([]),sourceEvidenceRefIds:e.array(e.string().min(1)).default([])}),H=e.object({id:e.string().min(1),executionPlanId:e.string().min(1),executionClaimId:e.string().min(1),dispatchId:e.string().min(1).optional(),policyGateRequestId:e.string().min(1),policyGateDecisionId:e.string().min(1),authorizedLane:c,verdict:e.enum(["allow","dry_run_only","operator_approval_required","denied"]),accountableOwnerPrincipalId:e.string().min(1),authorizedByPrincipalId:e.string().min(1).optional(),requiredApprovalIds:e.array(e.string().min(1)).default([]),dryRunProofRefIds:e.array(e.string().min(1)).default([]),sourceEvidenceRefIds:e.array(e.string().min(1)).default([]),failure:g.optional(),authorizedAt:e.string().min(1),asOf:e.string().min(1),expiresAt:e.string().min(1).optional(),metadata:a.default({})}).superRefine((o,p)=>{if(o.verdict==="dry_run_only"&&o.authorizedLane!=="dry_run")p.addIssue({code:e.ZodIssueCode.custom,message:"dry_run_only authorizations must use the dry_run lane.",path:["authorizedLane"]});if(o.verdict==="allow"&&o.authorizedLane!=="dry_run"&&o.dryRunProofRefIds.length===0)p.addIssue({code:e.ZodIssueCode.custom,message:"Non-dry-run dispatch authorization requires dry-run proof refs.",path:["dryRunProofRefIds"]})}),W=e.object({id:e.string().min(1),executionPlanId:e.string().min(1),authorizationId:e.string().min(1).optional(),routeKind:e.enum(["approval_required","operator_review","dry_run_review","blocked"]),requiredPrincipalIds:e.array(e.string().min(1)).default([]),reason:e.string().min(1),sourceEvidenceRefIds:e.array(e.string().min(1)).default([]),createdAt:e.string().min(1),asOf:e.string().min(1)}),F=e.object({id:e.string().min(1),executionPlanId:e.string().min(1),policyGateRequestId:e.string().min(1),policyGateDecisionId:e.string().min(1).optional(),authorizationId:e.string().min(1).optional(),sourceEvidenceRefs:e.array(f).default([]),decisionRefIds:e.array(e.string().min(1)).default([]),inputHash:e.string().min(1),outputHash:e.string().min(1),deterministic:e.literal(!0).default(!0),createdAt:e.string().min(1),asOf:e.string().min(1),metadata:a.default({})}),T=e.object({id:e.string().min(1),replayPacketId:e.string().min(1),executionPlanId:e.string().min(1),inputHash:e.string().min(1),expectedOutputHash:e.string().min(1),actualOutputHash:e.string().min(1).optional(),status:e.enum(["pass","fail","not_run"]),varianceReason:e.string().min(1).optional(),checkedAt:e.string().min(1).optional(),asOf:e.string().min(1),sourceEvidenceRefIds:e.array(e.string().min(1)).default([])}),B=e.object({id:e.string().min(1),executionPlanId:e.string().min(1),dispatchId:e.string().min(1).optional(),receiptIds:e.array(e.string().min(1)).default([]),outcomeReceiptId:e.string().min(1),objectiveIds:e.array(e.string().min(1)).default([]),reviewOutputPlanIds:e.array(e.string().min(1)).optional(),sourceEvidenceRefIds:e.array(e.string().min(1)).default([]),status:e.enum(["linked","partial","blocked"]),linkedAt:e.string().min(1),asOf:e.string().min(1)}),M=e.object({id:e.string().min(1),workItemId:e.string().min(1),operation:e.string().min(1),lifecycleState:y,accountableOwnerPrincipalId:e.string().min(1),claimId:e.string().min(1).optional(),idempotency:u,retryPolicy:l.optional(),policyGateRequestId:e.string().min(1),policyGateDecisionId:e.string().min(1).optional(),dispatchIds:e.array(e.string().min(1)).default([]),receiptIds:e.array(e.string().min(1)).default([]),outcomeReceiptIds:e.array(e.string().min(1)).default([]),checkpointRefIds:e.array(e.string().min(1)).default([]),replayRefIds:e.array(e.string().min(1)).default([]),cancellationRefIds:e.array(e.string().min(1)).default([]),sourceRefs:e.array(i).default([])}),Z=e.object({id:e.string().min(1),executionPlanId:e.string().min(1),dispatchId:e.string().min(1),lane:c,status:e.enum(["dry_run_completed","dispatched","succeeded","failed","cancelled","blocked"]),idempotencyKey:e.string().min(1),startedAt:e.string().min(1),completedAt:e.string().min(1).optional(),outputRef:m.optional(),errorSummary:e.string().min(1).optional(),evidenceRefIds:e.array(e.string().min(1)).default([])}),N=e.object({id:e.string().min(1),executionPlanId:e.string().min(1),workItemId:e.string().min(1),status:e.enum(["achieved","partial","no_change","regressed","unknown"]),summary:e.string().min(1),objectiveIds:e.array(e.string().min(1)).default([]),memorySnapshotIds:e.array(e.string().min(1)).default([]),cadenceIds:e.array(e.string().min(1)).default([]),receiptIds:e.array(e.string().min(1)).min(1),observedAt:e.string().min(1),sourceRefs:e.array(i).default([])});export{g as CompanyOsDispatchAuthorizationFailureSchema,j as CompanyOsExecutionClaimSchema,H as CompanyOsExecutionDispatchAuthorizationSchema,c as CompanyOsExecutionDispatchLaneSchema,K as CompanyOsExecutionDispatchSchema,u as CompanyOsExecutionIdempotencySchema,y as CompanyOsExecutionLifecycleStateSchema,Z as CompanyOsExecutionReceiptSchema,W as CompanyOsOperatorInboxRouteSchema,B as CompanyOsOutcomeLinkageSchema,N as CompanyOsOutcomeReceiptSchema,G as CompanyOsPolicyGateDecisionSchema,q as CompanyOsPolicyGateRequestSchema,F as CompanyOsPolicyReplayPacketSchema,T as CompanyOsReplayDeterminismCaseSchema,l as CompanyOsRetryPolicyRefSchema,f as CompanyOsSourceEvidenceRefSchema,M as CompanyOsWorkExecutionPlanSchema};

package/dist/types/governed-action-state.d.ts

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+/**
+ * The 7 primitive lifecycle states for a CompanyOS governed action.
+ *
+ * Scope: companyos-spec (Phase 1, G-01-CONTRACTS-LIFECYCLE).
+ *
+ * Terminal states: executed | rejected | escalated
+ * Initial state:  proposed
+ *
+ * The 3 derived view states (linked_to_outcome | replayed | receipt_generated)
+ * are intentionally excluded here — they belong to module.companyos (Phase 2,
+ * G-03-MODULE-DERIVED-STATES).
+ *
+ * @kind reference
+ * @visibility public
+ */
+export declare const CompanyOsGovernedActionStateSchema: z.ZodEnum<{
+    approved: "approved";
+    blocked: "blocked";
+    escalated: "escalated";
+    executed: "executed";
+    needs_approval: "needs_approval";
+    proposed: "proposed";
+    rejected: "rejected";
+}>;
+export type CompanyOsGovernedActionState = z.infer<typeof CompanyOsGovernedActionStateSchema>;
+/**
+ * The full ordered set of primitive governed-action states as a readonly tuple.
+ * Use for compile-time exhaustiveness checks and iteration.
+ */
+export declare const COMPANYOS_GOVERNED_ACTION_STATES: readonly ["proposed", "blocked", "needs_approval", "approved", "rejected", "escalated", "executed"];
+/**
+ * Terminal states — no further transitions are permitted after these.
+ */
+export declare const COMPANYOS_GOVERNED_ACTION_TERMINAL_STATES: readonly ["executed", "rejected", "escalated"];
+/**
+ * Schema for a single lifecycle transition between governed-action states.
+ *
+ * - `from`: the state being left
+ * - `to`:   the state being entered
+ * - `reason`: optional human-readable rationale
+ * - `at`:   ISO-8601 timestamp of the transition
+ */
+export declare const CompanyOsGovernedActionLifecycleTransitionSchema: z.ZodObject<{
+    from: z.ZodEnum<{
+        approved: "approved";
+        blocked: "blocked";
+        escalated: "escalated";
+        executed: "executed";
+        needs_approval: "needs_approval";
+        proposed: "proposed";
+        rejected: "rejected";
+    }>;
+    to: z.ZodEnum<{
+        approved: "approved";
+        blocked: "blocked";
+        escalated: "escalated";
+        executed: "executed";
+        needs_approval: "needs_approval";
+        proposed: "proposed";
+        rejected: "rejected";
+    }>;
+    reason: z.ZodOptional<z.ZodString>;
+    at: z.ZodString;
+}, z.core.$strip>;
+export type CompanyOsGovernedActionLifecycleTransition = z.infer<typeof CompanyOsGovernedActionLifecycleTransitionSchema>;

package/dist/types/governed-action-state.js

@@ -0,0 +1,2 @@
+// @bun
+import{z as e}from"zod";var o=e.enum(["proposed","blocked","needs_approval","approved","rejected","escalated","executed"]),n=["proposed","blocked","needs_approval","approved","rejected","escalated","executed"],a=["executed","rejected","escalated"],c=e.object({from:o,to:o,reason:e.string().min(1).optional(),at:e.string().min(1)});export{n as COMPANYOS_GOVERNED_ACTION_STATES,a as COMPANYOS_GOVERNED_ACTION_TERMINAL_STATES,c as CompanyOsGovernedActionLifecycleTransitionSchema,o as CompanyOsGovernedActionStateSchema};