@endora-commerce/contracts 0.100.0

package/dist/prompt-actions.d.ts

@@ -0,0 +1,582 @@
+import { z } from 'zod';
+export declare const PROMPT_ACTION_STATUSES: readonly ["interpreting", "awaiting_confirmation", "needs_clarification", "unsupported", "refused", "failed", "executing", "completed", "completed_with_errors", "cancelled", "expired"];
+export declare const PromptActionStatusSchema: z.ZodEnum<{
+    completed: "completed";
+    cancelled: "cancelled";
+    failed: "failed";
+    expired: "expired";
+    interpreting: "interpreting";
+    awaiting_confirmation: "awaiting_confirmation";
+    needs_clarification: "needs_clarification";
+    unsupported: "unsupported";
+    refused: "refused";
+    executing: "executing";
+    completed_with_errors: "completed_with_errors";
+}>;
+export type PromptActionStatus = z.infer<typeof PromptActionStatusSchema>;
+export declare const PromptActionsProviderSchema: z.ZodEnum<{
+    google: "google";
+    anthropic: "anthropic";
+    openai: "openai";
+}>;
+export type PromptActionsProvider = z.infer<typeof PromptActionsProviderSchema>;
+/** Minutes a plan stays confirmable after interpretation (lazy expiry). */
+export declare const PROMPT_ACTION_PLAN_TTL_MINUTES = 10;
+export declare const OperationPreviewSchema: z.ZodObject<{
+    headline: z.ZodString;
+    current: z.ZodOptional<z.ZodUnknown>;
+    affectedCount: z.ZodNumber;
+    sample: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type OperationPreview = z.infer<typeof OperationPreviewSchema>;
+export declare const PlanOperationSchema: z.ZodObject<{
+    toolId: z.ZodString;
+    moduleId: z.ZodString;
+    params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    requiredPermission: z.ZodString;
+    preview: z.ZodObject<{
+        headline: z.ZodString;
+        current: z.ZodOptional<z.ZodUnknown>;
+        affectedCount: z.ZodNumber;
+        sample: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type PlanOperation = z.infer<typeof PlanOperationSchema>;
+export declare const PromptActionPlanSchema: z.ZodObject<{
+    summary: z.ZodString;
+    operations: z.ZodArray<z.ZodObject<{
+        toolId: z.ZodString;
+        moduleId: z.ZodString;
+        params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        requiredPermission: z.ZodString;
+        preview: z.ZodObject<{
+            headline: z.ZodString;
+            current: z.ZodOptional<z.ZodUnknown>;
+            affectedCount: z.ZodNumber;
+            sample: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    bulkLimit: z.ZodNumber;
+}, z.core.$strip>;
+export type PromptActionPlan = z.infer<typeof PromptActionPlanSchema>;
+export declare const PromptActionClarificationSchema: z.ZodObject<{
+    question: z.ZodString;
+    kind: z.ZodEnum<{
+        entity_choice: "entity_choice";
+        free_text: "free_text";
+    }>;
+    candidates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        hint: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type PromptActionClarification = z.infer<typeof PromptActionClarificationSchema>;
+export declare const ResultOperationSchema: z.ZodObject<{
+    toolId: z.ZodString;
+    status: z.ZodEnum<{
+        failed: "failed";
+        succeeded: "succeeded";
+        delegated: "delegated";
+    }>;
+    message: z.ZodOptional<z.ZodString>;
+    bulkOperationId: z.ZodOptional<z.ZodUUID>;
+    summary: z.ZodOptional<z.ZodObject<{
+        total: z.ZodNumber;
+        succeeded: z.ZodNumber;
+        failed: z.ZodNumber;
+        failures: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+            reason: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ResultOperation = z.infer<typeof ResultOperationSchema>;
+export declare const PromptActionResultSchema: z.ZodObject<{
+    outcome: z.ZodEnum<{
+        completed: "completed";
+        failed: "failed";
+        completed_with_errors: "completed_with_errors";
+    }>;
+    operations: z.ZodArray<z.ZodObject<{
+        toolId: z.ZodString;
+        status: z.ZodEnum<{
+            failed: "failed";
+            succeeded: "succeeded";
+            delegated: "delegated";
+        }>;
+        message: z.ZodOptional<z.ZodString>;
+        bulkOperationId: z.ZodOptional<z.ZodUUID>;
+        summary: z.ZodOptional<z.ZodObject<{
+            total: z.ZodNumber;
+            succeeded: z.ZodNumber;
+            failed: z.ZodNumber;
+            failures: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+                reason: z.ZodString;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PromptActionResult = z.infer<typeof PromptActionResultSchema>;
+export declare const PromptActionsCapabilitySchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        ready: "ready";
+        disabled: "disabled";
+        not_configured: "not_configured";
+    }>;
+    bulkLimit: z.ZodNumber;
+}, z.core.$strip>;
+export type PromptActionsCapability = z.infer<typeof PromptActionsCapabilitySchema>;
+export declare const SubmitPromptRequestSchema: z.ZodObject<{
+    prompt: z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>;
+}, z.core.$strip>;
+export type SubmitPromptRequest = z.infer<typeof SubmitPromptRequestSchema>;
+export declare const ClarifyRequestSchema: z.ZodUnion<readonly [z.ZodObject<{
+    selectedCandidateId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    text: z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>;
+}, z.core.$strip>]>;
+export type ClarifyRequest = z.infer<typeof ClarifyRequestSchema>;
+export declare const PromptActionRequestDtoSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    status: z.ZodEnum<{
+        completed: "completed";
+        cancelled: "cancelled";
+        failed: "failed";
+        expired: "expired";
+        interpreting: "interpreting";
+        awaiting_confirmation: "awaiting_confirmation";
+        needs_clarification: "needs_clarification";
+        unsupported: "unsupported";
+        refused: "refused";
+        executing: "executing";
+        completed_with_errors: "completed_with_errors";
+    }>;
+    prompt: z.ZodString;
+    plan: z.ZodNullable<z.ZodObject<{
+        summary: z.ZodString;
+        operations: z.ZodArray<z.ZodObject<{
+            toolId: z.ZodString;
+            moduleId: z.ZodString;
+            params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            requiredPermission: z.ZodString;
+            preview: z.ZodObject<{
+                headline: z.ZodString;
+                current: z.ZodOptional<z.ZodUnknown>;
+                affectedCount: z.ZodNumber;
+                sample: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    label: z.ZodString;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+        bulkLimit: z.ZodNumber;
+    }, z.core.$strip>>;
+    clarification: z.ZodNullable<z.ZodObject<{
+        question: z.ZodString;
+        kind: z.ZodEnum<{
+            entity_choice: "entity_choice";
+            free_text: "free_text";
+        }>;
+        candidates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            hint: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    result: z.ZodNullable<z.ZodObject<{
+        outcome: z.ZodEnum<{
+            completed: "completed";
+            failed: "failed";
+            completed_with_errors: "completed_with_errors";
+        }>;
+        operations: z.ZodArray<z.ZodObject<{
+            toolId: z.ZodString;
+            status: z.ZodEnum<{
+                failed: "failed";
+                succeeded: "succeeded";
+                delegated: "delegated";
+            }>;
+            message: z.ZodOptional<z.ZodString>;
+            bulkOperationId: z.ZodOptional<z.ZodUUID>;
+            summary: z.ZodOptional<z.ZodObject<{
+                total: z.ZodNumber;
+                succeeded: z.ZodNumber;
+                failed: z.ZodNumber;
+                failures: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    label: z.ZodOptional<z.ZodString>;
+                    reason: z.ZodString;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    error: z.ZodNullable<z.ZodString>;
+    bulkOperationId: z.ZodNullable<z.ZodUUID>;
+    expiresAt: z.ZodNullable<z.ZodISODateTime>;
+    seenAt: z.ZodNullable<z.ZodISODateTime>;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strip>;
+export type PromptActionRequestDto = z.infer<typeof PromptActionRequestDtoSchema>;
+export declare const PromptActionRequestResponseSchema: z.ZodObject<{
+    data: z.ZodObject<{
+        id: z.ZodUUID;
+        status: z.ZodEnum<{
+            completed: "completed";
+            cancelled: "cancelled";
+            failed: "failed";
+            expired: "expired";
+            interpreting: "interpreting";
+            awaiting_confirmation: "awaiting_confirmation";
+            needs_clarification: "needs_clarification";
+            unsupported: "unsupported";
+            refused: "refused";
+            executing: "executing";
+            completed_with_errors: "completed_with_errors";
+        }>;
+        prompt: z.ZodString;
+        plan: z.ZodNullable<z.ZodObject<{
+            summary: z.ZodString;
+            operations: z.ZodArray<z.ZodObject<{
+                toolId: z.ZodString;
+                moduleId: z.ZodString;
+                params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                requiredPermission: z.ZodString;
+                preview: z.ZodObject<{
+                    headline: z.ZodString;
+                    current: z.ZodOptional<z.ZodUnknown>;
+                    affectedCount: z.ZodNumber;
+                    sample: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        id: z.ZodString;
+                        label: z.ZodString;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+            bulkLimit: z.ZodNumber;
+        }, z.core.$strip>>;
+        clarification: z.ZodNullable<z.ZodObject<{
+            question: z.ZodString;
+            kind: z.ZodEnum<{
+                entity_choice: "entity_choice";
+                free_text: "free_text";
+            }>;
+            candidates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                hint: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>;
+        result: z.ZodNullable<z.ZodObject<{
+            outcome: z.ZodEnum<{
+                completed: "completed";
+                failed: "failed";
+                completed_with_errors: "completed_with_errors";
+            }>;
+            operations: z.ZodArray<z.ZodObject<{
+                toolId: z.ZodString;
+                status: z.ZodEnum<{
+                    failed: "failed";
+                    succeeded: "succeeded";
+                    delegated: "delegated";
+                }>;
+                message: z.ZodOptional<z.ZodString>;
+                bulkOperationId: z.ZodOptional<z.ZodUUID>;
+                summary: z.ZodOptional<z.ZodObject<{
+                    total: z.ZodNumber;
+                    succeeded: z.ZodNumber;
+                    failed: z.ZodNumber;
+                    failures: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        id: z.ZodString;
+                        label: z.ZodOptional<z.ZodString>;
+                        reason: z.ZodString;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        error: z.ZodNullable<z.ZodString>;
+        bulkOperationId: z.ZodNullable<z.ZodUUID>;
+        expiresAt: z.ZodNullable<z.ZodISODateTime>;
+        seenAt: z.ZodNullable<z.ZodISODateTime>;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const PromptActionListQuerySchema: z.ZodObject<{
+    unseen: z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"true">, z.ZodLiteral<"false">]>>, z.ZodTransform<boolean, "true" | "false" | undefined>>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export declare const PromptActionListResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodUUID;
+        status: z.ZodEnum<{
+            completed: "completed";
+            cancelled: "cancelled";
+            failed: "failed";
+            expired: "expired";
+            interpreting: "interpreting";
+            awaiting_confirmation: "awaiting_confirmation";
+            needs_clarification: "needs_clarification";
+            unsupported: "unsupported";
+            refused: "refused";
+            executing: "executing";
+            completed_with_errors: "completed_with_errors";
+        }>;
+        prompt: z.ZodString;
+        plan: z.ZodNullable<z.ZodObject<{
+            summary: z.ZodString;
+            operations: z.ZodArray<z.ZodObject<{
+                toolId: z.ZodString;
+                moduleId: z.ZodString;
+                params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                requiredPermission: z.ZodString;
+                preview: z.ZodObject<{
+                    headline: z.ZodString;
+                    current: z.ZodOptional<z.ZodUnknown>;
+                    affectedCount: z.ZodNumber;
+                    sample: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        id: z.ZodString;
+                        label: z.ZodString;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+            bulkLimit: z.ZodNumber;
+        }, z.core.$strip>>;
+        clarification: z.ZodNullable<z.ZodObject<{
+            question: z.ZodString;
+            kind: z.ZodEnum<{
+                entity_choice: "entity_choice";
+                free_text: "free_text";
+            }>;
+            candidates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                hint: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>;
+        result: z.ZodNullable<z.ZodObject<{
+            outcome: z.ZodEnum<{
+                completed: "completed";
+                failed: "failed";
+                completed_with_errors: "completed_with_errors";
+            }>;
+            operations: z.ZodArray<z.ZodObject<{
+                toolId: z.ZodString;
+                status: z.ZodEnum<{
+                    failed: "failed";
+                    succeeded: "succeeded";
+                    delegated: "delegated";
+                }>;
+                message: z.ZodOptional<z.ZodString>;
+                bulkOperationId: z.ZodOptional<z.ZodUUID>;
+                summary: z.ZodOptional<z.ZodObject<{
+                    total: z.ZodNumber;
+                    succeeded: z.ZodNumber;
+                    failed: z.ZodNumber;
+                    failures: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        id: z.ZodString;
+                        label: z.ZodOptional<z.ZodString>;
+                        reason: z.ZodString;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        error: z.ZodNullable<z.ZodString>;
+        bulkOperationId: z.ZodNullable<z.ZodUUID>;
+        expiresAt: z.ZodNullable<z.ZodISODateTime>;
+        seenAt: z.ZodNullable<z.ZodISODateTime>;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const SearchProductsParamsSchema: z.ZodObject<{
+    q: z.ZodString;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type SearchProductsParams = z.infer<typeof SearchProductsParamsSchema>;
+export declare const SearchCategoriesParamsSchema: z.ZodObject<{
+    q: z.ZodString;
+}, z.core.$strip>;
+export type SearchCategoriesParams = z.infer<typeof SearchCategoriesParamsSchema>;
+export declare const SearchWarehousesParamsSchema: z.ZodObject<{
+    q: z.ZodString;
+}, z.core.$strip>;
+export type SearchWarehousesParams = z.infer<typeof SearchWarehousesParamsSchema>;
+export declare const SetStockLevelParamsSchema: z.ZodObject<{
+    productId: z.ZodUUID;
+    warehouseId: z.ZodUUID;
+    quantity: z.ZodNumber;
+}, z.core.$strip>;
+export type SetStockLevelParams = z.infer<typeof SetStockLevelParamsSchema>;
+export declare const AssignProductsToCategoryParamsSchema: z.ZodObject<{
+    productIds: z.ZodArray<z.ZodUUID>;
+    categoryId: z.ZodUUID;
+}, z.core.$strip>;
+export type AssignProductsToCategoryParams = z.infer<typeof AssignProductsToCategoryParamsSchema>;
+export declare const RemoveProductsFromCategoryParamsSchema: z.ZodObject<{
+    productIds: z.ZodArray<z.ZodUUID>;
+    categoryId: z.ZodUUID;
+}, z.core.$strip>;
+export type RemoveProductsFromCategoryParams = z.infer<typeof RemoveProductsFromCategoryParamsSchema>;
+export declare const SearchOrdersParamsSchema: z.ZodObject<{
+    q: z.ZodString;
+}, z.core.$strip>;
+export type SearchOrdersParams = z.infer<typeof SearchOrdersParamsSchema>;
+export declare const SetProductStatusParamsSchema: z.ZodObject<{
+    productIds: z.ZodArray<z.ZodUUID>;
+    status: z.ZodEnum<{
+        active: "active";
+        inactive: "inactive";
+        draft: "draft";
+    }>;
+}, z.core.$strip>;
+export type SetProductStatusParams = z.infer<typeof SetProductStatusParamsSchema>;
+export declare const SetProductsVisibilityParamsSchema: z.ZodObject<{
+    productIds: z.ZodArray<z.ZodUUID>;
+    visibility: z.ZodEnum<{
+        public: "public";
+        logged_in_only: "logged_in_only";
+        organization_restricted: "organization_restricted";
+    }>;
+}, z.core.$strip>;
+export type SetProductsVisibilityParams = z.infer<typeof SetProductsVisibilityParamsSchema>;
+export declare const SetOrderStatusParamsSchema: z.ZodObject<{
+    orderId: z.ZodUUID;
+    toStatusCode: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SetOrderStatusParams = z.infer<typeof SetOrderStatusParamsSchema>;
+export declare const BulkSetOrderStatusParamsSchema: z.ZodObject<{
+    orderIds: z.ZodArray<z.ZodUUID>;
+    toStatusCode: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type BulkSetOrderStatusParams = z.infer<typeof BulkSetOrderStatusParamsSchema>;
+/** Who is running a tool, for the audit entry the mutation writes. */
+export interface ToolAuditContext {
+    ipAddress?: string | null;
+    userAgent?: string | null;
+    requestId?: string | null;
+}
+/** The tool as the LLM is told about it. Derived from the tool's `paramsSchema`. */
+export interface LlmToolDefinition {
+    name: string;
+    description: string;
+    /** JSON Schema for the tool arguments. */
+    inputSchema: Record<string, unknown>;
+}
+/**
+ * What decides whether a tool is offered at all: the caller's permissions and
+ * the module's presence.
+ *
+ * Both questions, not one. A tool whose module is switched off must not be
+ * advertised even to an admin who holds its permission — Constitution XVII
+ * rule 5 — and a tool whose module is present must not be advertised to
+ * somebody who would get a 403 running it.
+ */
+export interface ToolVisibilityContext {
+    hasPermission(permission: string): Promise<boolean>;
+    isModuleInstalled(moduleId: string): Promise<boolean>;
+}
+/**
+ * What a tool is told about the operator running it (D-75).
+ *
+ * Three fields, and no unit of work: a preview reads committed rows through the
+ * contributing module's own `emFactory`, and an execution goes through that
+ * module's own audited service. `requestId` is the prompt request's id, which a
+ * tool uses for correlation and never to load the row.
+ */
+export interface ToolContext {
+    adminUserId: string;
+    requestId: string;
+    auditCtx: ToolAuditContext;
+}
+/**
+ * A tool a module contributes to the assistant's catalogue.
+ *
+ * `paramsSchema` is a Zod schema and stays one: `zod` is this package's only
+ * dependency, and the schema is the single source both for validating what the
+ * model proposed and for the provider-facing JSON Schema.
+ *
+ * Registration rules, enforced by the host at `register`: `id` is
+ * `<moduleId>.<snake_case_name>` and unique, `requiredPermission` mirrors the
+ * permission guarding the equivalent manual admin route, and a mutation MUST
+ * implement `preview()` — a confirmable plan renders server-computed facts
+ * only.
+ */
+export interface PromptActionTool<P = unknown> {
+    /** `<moduleId>.<snake_case_name>` */
+    id: string;
+    moduleId: string;
+    kind: 'resolver' | 'mutation';
+    /** English, action-oriented — this is the LLM's only documentation. */
+    description: string;
+    requiredPermission: string;
+    paramsSchema: z.ZodType<P>;
+    /** Resolvers run during interpretation; mutations only at confirm time. */
+    execute(params: P, ctx: ToolContext): Promise<unknown>;
+    /** Mutations only: server-computed preview shown in the confirmable plan. */
+    preview?(params: P, ctx: ToolContext): Promise<OperationPreview>;
+}
+/**
+ * Container name: `promptActionToolRegistry`. Owner: `prompt_actions`.
+ *
+ * The **contribution** shape, in the idiom `GatewayRefundRegistryPort` and
+ * `PaymentAdapterRegistryPort` already use: the host keeps the class, a
+ * contributor names the interface. That is what lets `catalog`, `inventory` and
+ * `orders` type their cradle entry without importing `prompt_actions`.
+ *
+ * Deliberately **not** a gated port. A contributor pushes from its own boot
+ * hook, and gating the push would turn an operator's deactivation into an entry
+ * missing until the next restart; the presence question is answered by the host
+ * at enumeration, keyed on the module recorded with each tool.
+ */
+export interface PromptActionToolRegistryPort {
+    register<P>(tool: PromptActionTool<P>): void;
+}
+/**
+ * What a long-running bulk operation has done so far, as its owner reports it
+ * (D-76).
+ *
+ * Data out, and nothing else. The previous shape handed the contributor
+ * `prompt_actions`' request entity and let it write `row.status`, `row.error`
+ * and `row.result`: whether a prompt request is `completed`, `failed` or
+ * `completed_with_errors` is the host's state machine, and what a bulk
+ * operation did is the contributor's fact. This is the fact.
+ */
+export interface BulkProgressSnapshot {
+    total: number;
+    succeeded: number;
+    failed: number;
+    failures: Array<{
+        id: string;
+        reason: string;
+    }>;
+    /** `null` while the run is still going. */
+    terminal: 'completed' | 'failed' | null;
+    error?: string | null;
+}
+/** Reads live progress for one bulk operation, or `null` when it knows none. */
+export type BulkProgressReader = (bulkOperationId: string) => Promise<BulkProgressSnapshot | null>;
+/**
+ * Container name: `promptActionBulkProgressRegistry`. Owner: `prompt_actions`.
+ *
+ * The same contribution idiom as {@link PromptActionToolRegistryPort}, and
+ * ungated for the same reason. The host states its absent-owner policy at the
+ * class: an absent contributor's reader is skipped, so the request reports no
+ * progress — which is exactly what a deployment shipping no contributor has
+ * always seen.
+ */
+export interface PromptActionBulkProgressRegistryPort {
+    register(moduleId: string, read: BulkProgressReader): void;
+}
+//# sourceMappingURL=prompt-actions.d.ts.map

package/dist/prompt-actions.d.ts.map

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