@tickernelz/paperclip-pro-shared 2026.925.0

package/dist/types/document-annotation.d.ts

@@ -0,0 +1,223 @@
+import type { DocumentAnnotationAnchorConfidence, DocumentAnnotationAnchorState, DocumentAnnotationThreadStatus, IssueCommentAuthorType, IssueThreadInteractionContinuationPolicy, IssueThreadInteractionKind, IssueThreadInteractionStatus } from "../constants.js";
+export interface DocumentTextPosition {
+    sourceStart: number;
+    sourceEnd: number;
+}
+export interface DocumentTextProjection {
+    source: string;
+    text: string;
+    positions: DocumentTextPosition[];
+}
+export interface DocumentTextRange {
+    text: string;
+    normalizedStart: number;
+    normalizedEnd: number;
+    markdownStart: number;
+    markdownEnd: number;
+}
+export interface DocumentAnnotationTextQuoteSelector {
+    exact: string;
+    prefix: string;
+    suffix: string;
+}
+export interface DocumentAnnotationTextPositionSelector {
+    normalizedStart: number;
+    normalizedEnd: number;
+    markdownStart: number;
+    markdownEnd: number;
+}
+export interface DocumentAnnotationAnchorSelector {
+    quote: DocumentAnnotationTextQuoteSelector;
+    position: DocumentAnnotationTextPositionSelector;
+}
+export interface DocumentAnnotationAnchorSnapshot {
+    selectedText: string;
+    prefixText: string;
+    suffixText: string;
+    normalizedStart: number;
+    normalizedEnd: number;
+    markdownStart: number;
+    markdownEnd: number;
+}
+export interface DocumentAnnotationThread {
+    id: string;
+    companyId: string;
+    issueId: string | null;
+    routineId?: string | null;
+    caseId?: string | null;
+    documentId: string;
+    documentKey: string;
+    status: DocumentAnnotationThreadStatus;
+    anchorState: DocumentAnnotationAnchorState;
+    anchorConfidence: DocumentAnnotationAnchorConfidence;
+    originalRevisionId: string | null;
+    originalRevisionNumber: number;
+    currentRevisionId: string | null;
+    currentRevisionNumber: number;
+    selectedText: string;
+    prefixText: string;
+    suffixText: string;
+    normalizedStart: number;
+    normalizedEnd: number;
+    markdownStart: number;
+    markdownEnd: number;
+    anchorSelector: DocumentAnnotationAnchorSelector;
+    createdByAgentId: string | null;
+    createdByUserId: string | null;
+    resolvedByAgentId: string | null;
+    resolvedByUserId: string | null;
+    resolvedAt: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface DocumentAnnotationComment {
+    id: string;
+    companyId: string;
+    threadId: string;
+    issueId: string | null;
+    routineId?: string | null;
+    caseId?: string | null;
+    documentId: string;
+    body: string;
+    authorType: IssueCommentAuthorType;
+    authorAgentId: string | null;
+    authorUserId: string | null;
+    createdByRunId: string | null;
+    issueCommentId?: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface DocumentAnnotationAnchorRemapSnapshot {
+    id: string;
+    companyId: string;
+    threadId: string;
+    documentId: string;
+    fromRevisionId: string | null;
+    fromRevisionNumber: number | null;
+    toRevisionId: string | null;
+    toRevisionNumber: number;
+    previousAnchor: DocumentAnnotationAnchorSnapshot;
+    nextAnchor: DocumentAnnotationAnchorSnapshot | null;
+    anchorState: DocumentAnnotationAnchorState;
+    anchorConfidence: DocumentAnnotationAnchorConfidence;
+    failureReason: string | null;
+    createdAt: Date;
+}
+export interface DocumentAnnotationThreadWithComments extends DocumentAnnotationThread {
+    comments: DocumentAnnotationComment[];
+}
+export interface CreateDocumentAnnotationThreadRequest {
+    baseRevisionId: string;
+    baseRevisionNumber: number;
+    selector: DocumentAnnotationAnchorSelector;
+    body: string;
+    issueCommentId?: string | null;
+}
+export interface CreateDocumentAnnotationCommentRequest {
+    body: string;
+    issueCommentId?: string | null;
+}
+export interface UpdateDocumentAnnotationThreadRequest {
+    status?: DocumentAnnotationThreadStatus;
+}
+export interface PlanReviewContextAuthor {
+    type: IssueCommentAuthorType;
+    id: string | null;
+}
+export interface PlanReviewContextComment {
+    id: string;
+    threadId: string;
+    body: string;
+    bodyTruncated: boolean;
+    author: PlanReviewContextAuthor;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface PlanReviewContextThread {
+    id: string;
+    documentKey: string;
+    documentId: string;
+    status: DocumentAnnotationThreadStatus;
+    revisionId: string | null;
+    revisionNumber: number;
+    anchorState: DocumentAnnotationAnchorState;
+    anchorConfidence: DocumentAnnotationAnchorConfidence;
+    selectedText: string;
+    selectedTextTruncated: boolean;
+    prefixText: string;
+    prefixTextTruncated: boolean;
+    suffixText: string;
+    suffixTextTruncated: boolean;
+    author: PlanReviewContextAuthor;
+    commentCount: number;
+    comments: PlanReviewContextComment[];
+    commentsTruncated: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface PlanReviewInteractionTargetContext {
+    issueId: string;
+    documentId: string | null;
+    key: string;
+    revisionId: string | null;
+    revisionNumber: number | null;
+}
+export interface PlanReviewInteractionResultContext {
+    outcome: string | null;
+    reason: string | null;
+    commentId: string | null;
+}
+export interface PlanReviewInteractionContext {
+    id: string;
+    kind: IssueThreadInteractionKind | string;
+    status: IssueThreadInteractionStatus | string;
+    continuationPolicy: IssueThreadInteractionContinuationPolicy | string;
+    sourceCommentId: string | null;
+    sourceRunId: string | null;
+    target: PlanReviewInteractionTargetContext | null;
+    acceptedTargetRevision: PlanReviewInteractionTargetContext | null;
+    result: PlanReviewInteractionResultContext | null;
+    resolvedAt: string | null;
+}
+export interface PlanReviewContext {
+    documentKey: "plan";
+    issueId: string;
+    latestRevisionId: string | null;
+    latestRevisionNumber: number | null;
+    threads: PlanReviewContextThread[];
+    interaction: PlanReviewInteractionContext | null;
+    totals: {
+        openThreadCount: number;
+        includedThreadCount: number;
+        omittedThreadCount: number;
+        commentCount: number;
+        includedCommentCount: number;
+        omittedCommentCount: number;
+    };
+    limits: {
+        maxThreads: number;
+        maxComments: number;
+        maxBodyChars: number;
+        maxTotalBodyChars: number;
+        maxAnchorTextChars: number;
+    };
+    truncated: boolean;
+}
+export interface DocumentReviewContextDocument {
+    documentKey: string;
+    documentId: string;
+    title: string | null;
+    latestRevisionId: string | null;
+    latestRevisionNumber: number | null;
+    threads: PlanReviewContextThread[];
+    totals: PlanReviewContext["totals"];
+    truncated: boolean;
+}
+export interface DocumentReviewContext {
+    issueId: string;
+    documents: DocumentReviewContextDocument[];
+    totals: PlanReviewContext["totals"];
+    limits: PlanReviewContext["limits"];
+    truncated: boolean;
+}
+//# sourceMappingURL=document-annotation.d.ts.map

package/dist/types/document-annotation.d.ts.map

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

package/dist/types/document-annotation.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=document-annotation.js.map

package/dist/types/document-annotation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-annotation.js","sourceRoot":"","sources":["../../src/types/document-annotation.ts"],"names":[],"mappings":""}

package/dist/types/email.d.ts

@@ -0,0 +1,50 @@
+export interface EmailEnvelope {
+    from: string;
+    to: string[];
+    cc?: string[];
+    bcc?: string[];
+    replyTo?: string[];
+    subject: string;
+}
+export type EmailDeliveryOutcome = "queued" | "sent" | "delivered" | "failed" | "uncertain";
+export interface EmailMessage extends EmailEnvelope {
+    id: string;
+    providerMessageId: string;
+    direction: "inbound" | "outbound";
+    text: string;
+    fullText: string;
+    commentId: string | null;
+    attachmentIds: string[];
+    timestamp: string;
+    automatic: boolean;
+}
+export interface EmailEndpointSummary {
+    id: string;
+    companyId: string;
+    connectionId: string;
+    assignedAgentId: string;
+    address: string | null;
+    status: string;
+    receiveMode: "websocket" | "webhook";
+    lastError: string | null;
+    lastSyncAt: string | null;
+}
+export interface EmailPublicationSummary {
+    request?: import("../validators/email.js").EmailSendInput;
+    createdAt?: string;
+    id: string;
+    issueId: string;
+    conversationId: string;
+    outcome: EmailDeliveryOutcome;
+    error: string | null;
+    providerMessageId: string | null;
+}
+export interface EmailThreadSummary {
+    conversationId: string;
+    issueId: string;
+    endpoint: EmailEndpointSummary;
+    subject: string;
+    messages: EmailMessage[];
+    publications: EmailPublicationSummary[];
+}
+//# sourceMappingURL=email.d.ts.map

package/dist/types/email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../src/types/email.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,MAAM,oBAAoB,GAC5B,QAAQ,GACR,MAAM,GACN,WAAW,GACX,QAAQ,GACR,WAAW,CAAC;AAChB,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,SAAS,GAAG,UAAU,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB;AACD,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,WAAW,GAAG,SAAS,CAAC;IACrC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AACD,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,OAAO,wBAAwB,EAAE,cAAc,CAAC;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AACD,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,YAAY,EAAE,uBAAuB,EAAE,CAAC;CACzC"}

package/dist/types/email.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=email.js.map

package/dist/types/email.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.js","sourceRoot":"","sources":["../../src/types/email.ts"],"names":[],"mappings":""}

package/dist/types/environment.d.ts

@@ -0,0 +1,150 @@
+import type { EnvironmentDriver, EnvironmentLeaseCleanupStatus, EnvironmentLeasePolicy, EnvironmentLeaseStatus, EnvironmentStatus } from "../constants.js";
+import type { AgentEnvConfig, EnvSecretRefBinding } from "./secrets.js";
+export interface LocalEnvironmentConfig {
+    [key: string]: unknown;
+}
+export interface SshEnvironmentConfig {
+    host: string;
+    port: number;
+    username: string;
+    remoteWorkspacePath: string;
+    privateKey: string | null;
+    privateKeySecretRef: EnvSecretRefBinding | null;
+    knownHosts: string | null;
+    strictHostKeyChecking: boolean;
+}
+export type SandboxEnvironmentProvider = "fake" | (string & {});
+export interface FakeSandboxEnvironmentConfig {
+    provider: "fake";
+    image: string;
+    reuseLease: boolean;
+    /** Stream agent CLI stdout/stderr during sandbox runs (bridge log-tail loop). */
+    streamRunLogs?: boolean;
+    /** Override the paperclip_runner lifecycle for this environment. */
+    runnerLifecycleMode?: "inherit" | "per_turn" | "warm";
+    /** Warm runner idle timeout in milliseconds when runnerLifecycleMode is warm. */
+    runnerIdleTimeoutMs?: number;
+    /**
+     * Archive the sandbox on lease release instead of deleting it, so operators
+     * can inspect it from the provider dashboard. Injected by test/probe paths;
+     * providers without archive support delete as usual.
+     */
+    archiveOnRelease?: boolean;
+}
+export interface PluginSandboxEnvironmentConfig {
+    provider: SandboxEnvironmentProvider;
+    reuseLease: boolean;
+    timeoutMs?: number;
+    /** Stream agent CLI stdout/stderr during sandbox runs (bridge log-tail loop). */
+    streamRunLogs?: boolean;
+    /** Override the paperclip_runner lifecycle for this environment. */
+    runnerLifecycleMode?: "inherit" | "per_turn" | "warm";
+    /** Warm runner idle timeout in milliseconds when runnerLifecycleMode is warm. */
+    runnerIdleTimeoutMs?: number;
+    /**
+     * Archive the sandbox on lease release instead of deleting it, so operators
+     * can inspect it from the provider dashboard. Injected by test/probe paths;
+     * providers without archive support delete as usual.
+     */
+    archiveOnRelease?: boolean;
+    [key: string]: unknown;
+}
+export type SandboxEnvironmentConfig = FakeSandboxEnvironmentConfig | PluginSandboxEnvironmentConfig;
+export interface PluginEnvironmentConfig {
+    pluginKey: string;
+    driverKey: string;
+    driverConfig: Record<string, unknown>;
+}
+export interface EnvironmentProbeResult {
+    ok: boolean;
+    driver: EnvironmentDriver;
+    summary: string;
+    details: Record<string, unknown> | null;
+}
+export interface Environment {
+    id: string;
+    name: string;
+    description: string | null;
+    driver: EnvironmentDriver;
+    status: EnvironmentStatus;
+    config: Record<string, unknown>;
+    envVars: AgentEnvConfig;
+    metadata: Record<string, unknown> | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export type EnvironmentDeleteBlockedReason = "managed_local" | "instance_default" | "reusable_sandbox_lease" | "pending_sandbox_cleanup";
+/**
+ * One reusable sandbox lease that blocks an environment delete, with the
+ * workspace/issue that holds it. Closing the workspace (or removing the issue)
+ * lets Paperclip destroy the sandbox and release the lease. The workspace and
+ * issue references are nullable because the lease FKs use `on delete set null`.
+ */
+export interface EnvironmentDeleteReusableLeaseHolder {
+    leaseId: string;
+    executionWorkspaceId: string | null;
+    executionWorkspaceName: string | null;
+    issueId: string | null;
+    issueIdentifier: string | null;
+    issueTitle: string | null;
+}
+export interface EnvironmentDeleteBlastRadius {
+    environmentId: string;
+    canDelete: boolean;
+    deleteBlockedReasons: EnvironmentDeleteBlockedReason[];
+    staticReferences: {
+        isManagedLocal: boolean;
+        isInstanceDefault: boolean;
+        agentDefaultCount: number;
+        executionWorkspaceSelectionCount: number;
+        issueSelectionCount: number;
+        projectSelectionCount: number;
+        secretBindingCount: number;
+    };
+    activeRuntimeUse: {
+        activeLeaseCount: number;
+        activeCustomImageSetupSessionCount: number;
+        hasActiveRuntimeUse: boolean;
+    };
+    /**
+     * Count of leases in the terminal `pending_cleanup` state. Each such lease
+     * holds the only durable provider reference for a sandbox that a teardown
+     * retry must destroy. A delete or a provider change must not remove this
+     * reference, so a count above zero blocks the delete.
+     */
+    pendingCleanupLeaseCount: number;
+    /**
+     * Count of reusable sandbox leases whose provider resource is still live.
+     * Deleting the environment would remove the context used by their normal
+     * release and destroy paths, so these leases block deletion.
+     */
+    reusableSandboxLeaseCount: number;
+    /**
+     * One entry per lease behind `reusableSandboxLeaseCount`, so a client can
+     * name the blocking workspaces/issues instead of reporting a bare count.
+     * Several leases can share one workspace.
+     */
+    reusableSandboxLeaseHolders: EnvironmentDeleteReusableLeaseHolder[];
+}
+export interface EnvironmentLease {
+    id: string;
+    companyId: string;
+    environmentId: string | null;
+    executionWorkspaceId: string | null;
+    issueId: string | null;
+    heartbeatRunId: string | null;
+    status: EnvironmentLeaseStatus;
+    leasePolicy: EnvironmentLeasePolicy;
+    provider: string | null;
+    providerLeaseId: string | null;
+    acquiredAt: Date;
+    lastUsedAt: Date;
+    expiresAt: Date | null;
+    releasedAt: Date | null;
+    failureReason: string | null;
+    cleanupStatus: EnvironmentLeaseCleanupStatus | null;
+    metadata: Record<string, unknown> | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+//# sourceMappingURL=environment.d.ts.map

package/dist/types/environment.d.ts.map

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

package/dist/types/environment.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=environment.js.map

package/dist/types/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../src/types/environment.ts"],"names":[],"mappings":""}

package/dist/types/execution-continuation.d.ts

@@ -0,0 +1,67 @@
+/** Server-authored context. Each message retains its author and trust boundary. */
+export interface ExecutionContinuationEnvelope {
+    version: 1;
+    companyId: string;
+    issueId: string;
+    trigger: {
+        reason: string;
+        interactionId: string | null;
+        sourceRunId: string | null;
+    };
+    originCommentIds: string[];
+    objective: string;
+    messages: Array<{
+        id: string;
+        authorType: string;
+        authorId: string | null;
+        /** Run-authored Local CLI comments retain user attribution but are not human direction. */
+        createdByRunId?: string | null;
+        body: string;
+        createdAt: string;
+        updatedAt: string;
+        deleted: boolean;
+        sourceTrust: unknown;
+    }>;
+    /** Only direct human resolutions, projected from server-owned resolver columns. */
+    humanResponses?: Array<{
+        id: string;
+        kind: string;
+        status: string;
+        resolvedByUserId: string;
+        resolvedAt: string;
+        result: unknown;
+    }>;
+    interactionOutcomes: Array<{
+        id: string;
+        kind: string;
+        status: string;
+        result: unknown;
+    }>;
+    /** Only valid when resuming the provider session associated with this run. */
+    resumeDelta?: {
+        baseRunId: string;
+        messages: ExecutionContinuationEnvelope["messages"];
+    };
+    recoveryOutcomes?: Array<{
+        recoveryActionId: string;
+        decision: unknown;
+    }>;
+    completedWork: string | null;
+    /** Start a new turn from history; never replay prior tool calls automatically. */
+    interruptedRunId?: string;
+    /** Completed mutations are context, never instructions to replay them. */
+    completedActions?: Array<{
+        runId: string;
+        receiptId: string;
+        operationId: string;
+        result: unknown;
+    }>;
+    unresolvedInteractionIds: string[];
+    coverage: {
+        kind: "full_task_history" | "task_history_delta";
+        baseRunId?: string;
+        throughCommentId: string | null;
+        summaryThroughCommentId: null;
+    };
+}
+//# sourceMappingURL=execution-continuation.d.ts.map

package/dist/types/execution-continuation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-continuation.d.ts","sourceRoot":"","sources":["../../src/types/execution-continuation.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B,CAAC;IACF,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,2FAA2F;QAC3F,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,WAAW,EAAE,OAAO,CAAC;KACtB,CAAC,CAAC;IACH,mFAAmF;IACnF,cAAc,CAAC,EAAE,KAAK,CAAC;QACrB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,gBAAgB,EAAE,MAAM,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC,CAAC;IACH,mBAAmB,EAAE,KAAK,CAAC;QACzB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC,CAAC;IACH,8EAA8E;IAC9E,WAAW,CAAC,EAAE;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,6BAA6B,CAAC,UAAU,CAAC,CAAC;KACrD,CAAC;IACF,gBAAgB,CAAC,EAAE,KAAK,CAAC;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC1E,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,kFAAkF;IAClF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,KAAK,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC,CAAC;IACH,wBAAwB,EAAE,MAAM,EAAE,CAAC;IACnC,QAAQ,EAAE;QACR,IAAI,EAAE,mBAAmB,GAAG,oBAAoB,CAAC;QACjD,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;QAChC,uBAAuB,EAAE,IAAI,CAAC;KAC/B,CAAC;CACH"}

package/dist/types/execution-continuation.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=execution-continuation.js.map

package/dist/types/execution-continuation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-continuation.js","sourceRoot":"","sources":["../../src/types/execution-continuation.ts"],"names":[],"mappings":""}

package/dist/types/execution-projection.d.ts

@@ -0,0 +1,33 @@
+export interface ExecutionBlocker {
+    /** Null when live execution authority itself blocks continuation. */
+    recoveryActionId: string | null;
+    runId: string | null;
+    agentId: string | null;
+    cause: string;
+    nextAction: string;
+}
+/** Presentation of existing execution records, not a second task status machine. */
+export interface ExecutionProjection {
+    phase: "working" | "reconnecting" | "retry_scheduled" | "finishing" | "recovery_needed" | "waiting_for_access" | "waiting_for_answer" | "queued" | "completed" | "failed";
+    label: string;
+    cause: string | null;
+    lastConfirmedActivityAt: string | null;
+    retryAt: string | null;
+    attempt: number;
+    maxAttempts: number;
+    recoveryOwner: "agent" | "board" | null;
+    nextAction: string | null;
+    permittedActions: Array<"inspect_run" | "inspect_recovery">;
+    predecessorRunId: string | null;
+    successorRunId: string | null;
+}
+/** These incidents require an explicit reconciliation, never a generic Retry. */
+export declare const EXECUTION_RECONCILIATION_CAUSES: readonly ["uncertain_provider_action", "uncertain_external_action", "uncertain_control_plane_action", "completed_action_context_missing", "continuation_evidence_incomplete", "execution_finalization_deadline_exceeded", "execution_recovery_budget_exhausted", "provider_effect_inventory_unavailable", "provider_failure_meaning_unverified", "provider_ownership_unverified", "native_provider_terminal_failed", "native_event_replay_conflict", "native_session_cleanup_quarantined", "native_session_retry_exhausted", "native_restart_recovery_blocked", "native_continuation_requires_reconciliation", "legacy_execution_requires_reconciliation"];
+export declare function requiresExecutionReconciliation(cause: string | null | undefined): boolean;
+export interface ExecutionReconciliation {
+    runId: string;
+    providerStopped: true;
+    actionOutcome: "completed" | "not_performed" | "mixed";
+    outcomeEvidence: string;
+}
+//# sourceMappingURL=execution-projection.d.ts.map

package/dist/types/execution-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-projection.d.ts","sourceRoot":"","sources":["../../src/types/execution-projection.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,oFAAoF;AACpF,MAAM,WAAW,mBAAmB;IAClC,KAAK,EACD,SAAS,GACT,cAAc,GACd,iBAAiB,GACjB,WAAW,GACX,iBAAiB,GACjB,oBAAoB,GACpB,oBAAoB,GACpB,QAAQ,GACR,WAAW,GACX,QAAQ,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC;IACxC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gBAAgB,EAAE,KAAK,CAAC,aAAa,GAAG,kBAAkB,CAAC,CAAC;IAC5D,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,iFAAiF;AACjF,eAAO,MAAM,+BAA+B,YAC1C,2BAA2B,EAC3B,2BAA2B,EAC3B,gCAAgC,EAChC,kCAAkC,EAClC,kCAAkC,EAClC,0CAA0C,EAC1C,qCAAqC,EACrC,uCAAuC,EACvC,qCAAqC,EACrC,+BAA+B,EAC/B,iCAAiC,EACjC,8BAA8B,EAC9B,oCAAoC,EACpC,gCAAgC,EAChC,iCAAiC,EACjC,6CAA6C,EAC7C,0CAA0C,CAClC,CAAC;AACX,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,OAAO,CAET;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,IAAI,CAAC;IACtB,aAAa,EAAE,WAAW,GAAG,eAAe,GAAG,OAAO,CAAC;IACvD,eAAe,EAAE,MAAM,CAAC;CACzB"}

package/dist/types/execution-projection.js

@@ -0,0 +1,24 @@
+/** These incidents require an explicit reconciliation, never a generic Retry. */
+export const EXECUTION_RECONCILIATION_CAUSES = [
+    "uncertain_provider_action",
+    "uncertain_external_action",
+    "uncertain_control_plane_action",
+    "completed_action_context_missing",
+    "continuation_evidence_incomplete",
+    "execution_finalization_deadline_exceeded",
+    "execution_recovery_budget_exhausted",
+    "provider_effect_inventory_unavailable",
+    "provider_failure_meaning_unverified",
+    "provider_ownership_unverified",
+    "native_provider_terminal_failed",
+    "native_event_replay_conflict",
+    "native_session_cleanup_quarantined",
+    "native_session_retry_exhausted",
+    "native_restart_recovery_blocked",
+    "native_continuation_requires_reconciliation",
+    "legacy_execution_requires_reconciliation",
+];
+export function requiresExecutionReconciliation(cause) {
+    return EXECUTION_RECONCILIATION_CAUSES.some((value) => value === cause);
+}
+//# sourceMappingURL=execution-projection.js.map

package/dist/types/execution-projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-projection.js","sourceRoot":"","sources":["../../src/types/execution-projection.ts"],"names":[],"mappings":"AAmCA,iFAAiF;AACjF,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC7C,2BAA2B;IAC3B,2BAA2B;IAC3B,gCAAgC;IAChC,kCAAkC;IAClC,kCAAkC;IAClC,0CAA0C;IAC1C,qCAAqC;IACrC,uCAAuC;IACvC,qCAAqC;IACrC,+BAA+B;IAC/B,iCAAiC;IACjC,8BAA8B;IAC9B,oCAAoC;IACpC,gCAAgC;IAChC,iCAAiC;IACjC,6CAA6C;IAC7C,0CAA0C;CAClC,CAAC;AACX,MAAM,UAAU,+BAA+B,CAC7C,KAAgC;IAEhC,OAAO,+BAA+B,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;AAC1E,CAAC"}