@vercel/factory 0.0.13 → 0.0.14

package/dist/index.d.mts

@@ -1,7 +1,173 @@
-import { a as StoredEntry, i as StoreDriver, n as RecordExistsError, o as StoredRecord, r as RecordNotFoundError, s as VersionConflictError, t as CollectionName } from "./driver-BJutB0PE.mjs";
+import { a as DispatchRefusedError, c as AgentRouteInput, d as defineAgentRoutes, i as DispatchOptions, l as AgentRouteRegistry, n as DEFAULT_MAX_LAUNCH_ATTEMPTS, o as dispatchTask, r as DispatchBudget, s as AgentRoute, t as BudgetExhaustedError, u as agentRouteSchema } from "./dispatch-BaZS3PT8.mjs";
+import { $ as Change, $t as outboxIdSchema, A as standardSignalSources, At as coordinationRepositoryIdsSchema, B as costSchema, Bt as taskStateSchema, C as createStores, Ct as answerEventSchema, D as signalOutcomeSchema, Dt as TaskKind, E as SignalSource, Et as TaskApproval, F as Cost, Ft as taskExecutionRepositoryIdsSchema, G as standardReceiptKinds, Gt as OutboxId, H as receiptPhaseSchema, Ht as AnswerId, I as Receipt, It as taskKindSchema, J as OutboxMessage, Jt as SignalId, K as standardReceiptPhases, Kt as ReceiptId, L as ReceiptKind, Lt as taskOriginSchema, M as RepositorySlug, Mt as harnessSchema, N as repositorySchema, Nt as standardTaskKinds, O as signalSchema, Ot as TaskState, P as repositorySlugSchema, Pt as taskApprovalSchema, Q as outboxStateSchema, Qt as factoryIdSchema, R as ReceiptPhase, Rt as taskQuestionSchema, S as TaskTransitionOptions, St as AnswerEvent, T as SignalOutcome, Tt as Task, U as receiptSchema, Ut as ChangeId, V as receiptKindSchema, Vt as taskUsageSchema, W as receiptStateSchema, Wt as FactoryId, X as outboxMessageSchema, Xt as answerIdSchema, Y as OutboxQueue, Yt as TaskId, Z as outboxQueueSchema, Zt as changeIdSchema, _ as SessionConflictError, _t as usdSchema, a as ApprovalError, an as Budget, at as changeStateSchema, b as StepUsage, bt as agentSessionIdSchema, c as ChangeTransitionOptions, cn as budgetMonthSchema, ct as CommunicationOutcome, d as CreateStoresOptions, dt as communicationOutcomes, en as receiptIdSchema, et as ChangeEvidence, f as CreateTaskInput, ft as ReplyTo, g as OutboxEventConflictError, gt as schemaVersionSchema, h as FactoryStores, ht as replyToSchema, i as ApprovalDecision, in as taskIdSchema, it as changeSchema, j as Repository, jt as executionReferenceSchema, k as signalSourceSchema, kt as TaskUsage, l as CreateChangeInput, ln as budgetSchema, lt as communicationEventSchema, m as EnsureBudgetInput, mt as isoDateTimeSchema, n as AnswerQuestionInput, nn as repositoryIdsSchema, nt as Level, o as ChangeAssociationError, on as BudgetLimits, ot as levelSchema, p as DecideSignalOptions, pt as SCHEMA_VERSION, q as standardReceiptStates, qt as RepositoryId, r as AppendReceiptInput, rn as signalIdSchema, rt as changeEvidenceSchema, s as ChangePatch, sn as budgetLimitsSchema, st as CommunicationEvent, t as AnswerEventConflictError, tn as repositoryIdSchema, tt as ChangeState, u as CreateSignalInput, ut as communicationOutcomeSchema, v as SettleTaskOptions, vt as vocabularySchema, w as Signal, wt as ExecutionReference, x as TaskPatch, xt as agentSessionSchema, y as SettlementError, yt as AgentSession, z as ReceiptState, zt as taskSchema } from "./engine-DFHU2Pe-.mjs";
+import { a as StoredEntry, i as StoreDriver, n as RecordExistsError, o as StoredRecord, r as RecordNotFoundError, s as VersionConflictError, t as CollectionName } from "./driver-BC0Mt5KG.mjs";
 import { a as defineFactory, c as factoryConfigSchema, i as defaultExecutionPolicy, n as FactoryConfig, o as executionPolicySchema, r as FactoryConfigInput, s as factoryConfigRepositorySchema, t as ExecutionPolicy } from "./factory-config-D2yU3G0c.mjs";
-import { a as signalSchema, c as ReplyTo, d as replyToSchema, f as schemaVersionSchema, i as signalOutcomeSchema, l as SCHEMA_VERSION, m as vocabularySchema, n as SignalOutcome, o as signalSourceSchema, p as usdSchema, r as SignalSource, s as standardSignalSources, t as Signal, u as isoDateTimeSchema } from "./signal-CHVEmzvI.mjs";
-import { $ as Cost, $t as taskSchema, A as AppendReceiptInput, At as TaskId, B as DecideSignalOptions, Bt as TaskApproval, C as findingCategorySchema, Ct as budgetMonthSchema, D as findingVerificationLevelSchema, Dt as ReceiptId, E as findingSchema, Et as FactoryId, F as ChangeTransitionOptions, Ft as repositoryIdsSchema, G as StepUsage, Gt as executionReferenceSchema, H as FactoryStores, Ht as TaskState, I as CreateChangeInput, It as signalIdSchema, J as createStores, Jt as taskApprovalSchema, K as TaskPatch, Kt as harnessSchema, L as CreateSignalInput, Lt as taskIdSchema, M as ApprovalError, Mt as factoryIdSchema, N as ChangeAssociationError, Nt as receiptIdSchema, O as findingVerificationMethodSchema, Ot as RepositoryId, P as ChangePatch, Pt as repositoryIdSchema, Q as repositorySlugSchema, Qt as taskQuestionSchema, R as CreateStoresOptions, Rt as ExecutionReference, S as FindingVerification, St as budgetLimitsSchema, T as findingPrioritySchema, Tt as ChangeId, U as SettleTaskOptions, Ut as TaskUsage, V as EnsureBudgetInput, Vt as TaskKind, W as SettlementError, Wt as coordinationRepositoryIdsSchema, X as RepositorySlug, Xt as taskKindSchema, Y as Repository, Yt as taskExecutionRepositoryIdsSchema, Z as repositorySchema, Zt as taskOriginSchema, _ as defaultApprovalPolicy, _t as changeSchema, a as DispatchRefusedError, at as receiptKindSchema, b as FindingCategory, bt as Budget, c as AgentRouteInput, ct as receiptStateSchema, d as defineAgentRoutes, dt as standardReceiptStates, en as taskStateSchema, et as Receipt, f as ApprovalPolicy, ft as Change, g as approvalRuleSchema, gt as changeEvidenceSchema, h as approvalPolicySchema, ht as Level, i as DispatchOptions, it as costSchema, j as ApprovalDecision, jt as changeIdSchema, k as findingVerificationSchema, kt as SignalId, l as AgentRouteRegistry, lt as standardReceiptKinds, m as ApprovalSubject, mt as ChangeState, n as DEFAULT_MAX_LAUNCH_ATTEMPTS, nt as ReceiptPhase, o as dispatchTask, ot as receiptPhaseSchema, p as ApprovalRule, pt as ChangeEvidence, q as TaskTransitionOptions, qt as standardTaskKinds, r as DispatchBudget, rt as ReceiptState, s as AgentRoute, st as receiptSchema, t as BudgetExhaustedError, tn as taskUsageSchema, tt as ReceiptKind, u as agentRouteSchema, ut as standardReceiptPhases, v as requiresApproval, vt as changeStateSchema, w as findingFingerprint, wt as budgetSchema, x as FindingPriority, xt as BudgetLimits, y as Finding, yt as levelSchema, z as CreateTaskInput, zt as Task } from "./dispatch-B77cuPxh.mjs";
+import { z } from "zod";
+//#region src/schema/finding.d.ts
+declare const findingPrioritySchema: z.ZodEnum<{
+  P0: "P0";
+  P1: "P1";
+  P2: "P2";
+  P3: "P3";
+}>;
+declare const findingCategorySchema: z.ZodEnum<{
+  security: "security";
+  correctness: "correctness";
+  reliability: "reliability";
+  performance: "performance";
+  compatibility: "compatibility";
+  accessibility: "accessibility";
+  documentation: "documentation";
+  maintainability: "maintainability";
+  testing: "testing";
+  usability: "usability";
+}>;
+declare const findingVerificationLevelSchema: z.ZodEnum<{
+  unverified: "unverified";
+  supported: "supported";
+  confirmed: "confirmed";
+}>;
+declare const findingVerificationMethodSchema: z.ZodEnum<{
+  documentation: "documentation";
+  code_inspection: "code_inspection";
+  static_analysis: "static_analysis";
+  manual_reproduction: "manual_reproduction";
+  unit_test: "unit_test";
+  integration_test: "integration_test";
+  e2e_test: "e2e_test";
+  runtime_observation: "runtime_observation";
+}>;
+/**
+ * What was done to check the finding. Forces a reporter to distinguish "I
+ * think this is a problem" from "I demonstrated it", which is the axis a human
+ * approving fixes cares about most.
+ */
+declare const findingVerificationSchema: z.ZodObject<{
+  level: z.ZodEnum<{
+    unverified: "unverified";
+    supported: "supported";
+    confirmed: "confirmed";
+  }>;
+  method: z.ZodEnum<{
+    documentation: "documentation";
+    code_inspection: "code_inspection";
+    static_analysis: "static_analysis";
+    manual_reproduction: "manual_reproduction";
+    unit_test: "unit_test";
+    integration_test: "integration_test";
+    e2e_test: "e2e_test";
+    runtime_observation: "runtime_observation";
+  }>;
+  summary: z.ZodString;
+  limitations: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/** A single problem found in a repository, as a scanner or agent reports it. */
+declare const findingSchema: z.ZodObject<{
+  title: z.ZodString;
+  body: z.ZodString;
+  path: z.ZodOptional<z.ZodString>;
+  line: z.ZodOptional<z.ZodNumber>;
+  endLine: z.ZodOptional<z.ZodNumber>;
+  priority: z.ZodEnum<{
+    P0: "P0";
+    P1: "P1";
+    P2: "P2";
+    P3: "P3";
+  }>;
+  category: z.ZodEnum<{
+    security: "security";
+    correctness: "correctness";
+    reliability: "reliability";
+    performance: "performance";
+    compatibility: "compatibility";
+    accessibility: "accessibility";
+    documentation: "documentation";
+    maintainability: "maintainability";
+    testing: "testing";
+    usability: "usability";
+  }>;
+  verification: z.ZodObject<{
+    level: z.ZodEnum<{
+      unverified: "unverified";
+      supported: "supported";
+      confirmed: "confirmed";
+    }>;
+    method: z.ZodEnum<{
+      documentation: "documentation";
+      code_inspection: "code_inspection";
+      static_analysis: "static_analysis";
+      manual_reproduction: "manual_reproduction";
+      unit_test: "unit_test";
+      integration_test: "integration_test";
+      e2e_test: "e2e_test";
+      runtime_observation: "runtime_observation";
+    }>;
+    summary: z.ZodString;
+    limitations: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>;
+  tool: z.ZodOptional<z.ZodString>;
+  ruleId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type FindingPriority = z.infer<typeof findingPrioritySchema>;
+type FindingCategory = z.infer<typeof findingCategorySchema>;
+type FindingVerification = z.infer<typeof findingVerificationSchema>;
+type Finding = z.infer<typeof findingSchema>;
+/**
+ * Stable identity of a finding across scans, used as the signal's delivery id
+ * so re-reporting is a no-op instead of a second task. A scanner finding is
+ * the same problem when the same tool reports the same rule on the same file;
+ * its title is model-written prose and changes between runs, so it is left
+ * out. Without a rule id the title is all there is, normalised.
+ */
+declare function findingFingerprint(repositoryId: string, finding: Finding): string;
+//#endregion
+//#region src/approval.d.ts
+/**
+ * One approval rule. Every listed field must match for the rule to apply;
+ * absent fields match anything. Rules are evaluated first-match.
+ */
+declare const approvalRuleSchema: z.ZodObject<{
+  source: z.ZodOptional<z.ZodString>;
+  kind: z.ZodOptional<z.ZodString>;
+  priority: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+    P0: "P0";
+    P1: "P1";
+    P2: "P2";
+    P3: "P3";
+  }>>>;
+  require: z.ZodBoolean;
+}, z.core.$strict>;
+declare const approvalPolicySchema: z.ZodArray<z.ZodObject<{
+  source: z.ZodOptional<z.ZodString>;
+  kind: z.ZodOptional<z.ZodString>;
+  priority: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+    P0: "P0";
+    P1: "P1";
+    P2: "P2";
+    P3: "P3";
+  }>>>;
+  require: z.ZodBoolean;
+}, z.core.$strict>>;
+type ApprovalRule = z.infer<typeof approvalRuleSchema>;
+type ApprovalPolicy = z.infer<typeof approvalPolicySchema>;
+/**
+ * The default: fixes for security findings wait for a human; everything else
+ * runs as it always has. Handoffs between agents (verification) never wait,
+ * because a human already approved the work they continue.
+ */
+declare const defaultApprovalPolicy: ApprovalPolicy;
+interface ApprovalSubject {
+  source?: string;
+  kind: string;
+  priority?: FindingPriority;
+}
+/**
+ * Decide at task-creation time whether a task needs approval. Pure: the answer
+ * is stamped on the task and never re-evaluated, so a later policy change
+ * cannot silently release work a human was expecting to see.
+ */
+declare function requiresApproval(policy: ApprovalPolicy, subject: ApprovalSubject): boolean;
+//#endregion
 //#region src/briefs.d.ts
 /** The finding behind a task, when its signal carries one. */
 declare function findingForTask(stores: FactoryStores, task: Task): Promise<Finding | null>;
@@ -193,6 +359,8 @@ interface HealthOptions {
   now?: Date;
   /** Open-change cap from factory configuration; omitted disables that check. */
   maxOpenChanges?: number;
+  /** Minutes an eligible executable task may remain queued before health turns yellow. Default 5. */
+  maxQueuedMinutes?: number;
 }
 interface RepositoryHealth {
   color: HealthColor;
@@ -278,15 +446,17 @@ interface SweepOptions {
   launchers: Readonly<Record<string, TaskLauncher>>;
   /** Reserve-before-execution limits, passed through to every dispatch. */
   budget?: DispatchBudget;
+  /** Maximum task launches attempted in one pass; omitted means no limit. */
+  maxDispatches?: number;
 }
 interface SweepResult {
   dispatched: string[];
-  /** Tasks left in the queue and why: awaiting approval, no launcher, missing repository. */
+  /** Tasks left in the queue because a declared gate may become eligible later. */
   skipped: {
     taskId: string;
     reason: string;
   }[];
-  /** Tasks whose launch threw; dispatchTask has already recorded them as failed. */
+  /** Tasks whose routing is invalid or whose launch threw. */
   failed: {
     taskId: string;
     reason: string;
@@ -310,5 +480,5 @@ interface VerificationTaskSweep {
 /** Ensure every recorded code change has exactly one durable verification task. */
 declare function ensureVerificationTasks(stores: FactoryStores): Promise<VerificationTaskSweep>;
 //#endregion
-export { AdoptPullRequestInput, AgentRoute, AgentRouteInput, AgentRouteRegistry, AppendReceiptInput, ApprovalDecision, ApprovalError, ApprovalPolicy, ApprovalRule, ApprovalSubject, Budget, BudgetExhaustedError, BudgetLimits, BudgetNotice, BudgetStatus, BudgetSweepOptions, BudgetSweepResult, Change, ChangeAssociationError, ChangeEvidence, ChangeId, ChangePatch, ChangeState, ChangeTransitionOptions, CollectionName, CoordinationPlan, CoordinationReconciliation, Cost, CreateChangeInput, CreateCoordinationInput, CreateSignalInput, CreateStoresOptions, CreateTaskInput, DEFAULT_MAX_LAUNCH_ATTEMPTS, DecideSignalOptions, DispatchBudget, DispatchOptions, DispatchRefusedError, EnsureBudgetInput, ExecutionPolicy, ExecutionReference, FactoryConfig, FactoryConfigInput, FactoryId, FactoryStores, Finding, FindingCategory, FindingPriority, FindingVerification, HealthColor, HealthOptions, InvalidTransitionError, LedgerMetrics, LedgerRows, Level, MetricsOptions, Receipt, ReceiptId, ReceiptKind, ReceiptPhase, ReceiptState, ReconcileCoordinationOptions, RecordExistsError, RecordNotFoundError, ReplyTo, Repository, RepositoryHealth, RepositoryId, RepositorySlug, ReviewBucket, SCHEMA_VERSION, SettleSweepOptions, SettleSweepResult, SettleTaskOptions, SettlementError, Signal, SignalCreator, SignalId, SignalOutcome, SignalSource, StallSweepOptions, StallSweepResult, StepUsage, StoreDriver, StoredEntry, StoredRecord, SweepOptions, SweepResult, Task, TaskApproval, TaskId, TaskKind, TaskLauncher, TaskPatch, TaskState, TaskTransitionOptions, TaskUsage, Transition, TransitionActor, VerificationTaskSweep, VersionConflictError, adoptPullRequest, agentRouteSchema, approvalPolicySchema, approvalRuleSchema, assertTransition, budgetLimitsSchema, budgetMonthOf, budgetMonthSchema, budgetSchema, budgetStatus, canReserve, changeEvidenceSchema, changeIdSchema, changeInitialState, changeSchema, changeStateSchema, changeTransitions, computeLedgerMetrics, computeMonthSpendUsd, computeRepositoryHealth, coordinationRepositoryIdsSchema, costSchema, createCoordination, createInMemoryDriver, createSignalCreator, createStores, defaultApprovalPolicy, defaultExecutionPolicy, defineAgentRoutes, defineFactory, deriveFactoryId, dispatchTask, ensureVerificationTasks, executionPolicySchema, executionReferenceSchema, factoryConfigRepositorySchema, factoryConfigSchema, factoryIdSchema, findingCategorySchema, findingFingerprint, findingForTask, findingPrioritySchema, findingSchema, findingVerificationLevelSchema, findingVerificationMethodSchema, findingVerificationSchema, fixBrief, harnessSchema, isTransitionAllowed, isoDateTimeSchema, legalNextStates, levelSchema, receiptIdSchema, receiptKindSchema, receiptPhaseSchema, receiptSchema, receiptStateSchema, reconcileCoordination, replyToSchema, repositoryIdSchema, repositoryIdsSchema, repositorySchema, repositorySlugSchema, requiresApproval, reviewBucket, scanBrief, schemaVersionSchema, signalIdSchema, signalInitialOutcome, signalOutcomeSchema, signalOutcomeTransitions, signalSchema, signalSourceSchema, stallWindowMinutes, standardReceiptKinds, standardReceiptPhases, standardReceiptStates, standardSignalSources, standardTaskKinds, sweepBudget, sweepQueued, sweepSettlements, sweepStalled, taskApprovalSchema, taskExecutionRepositoryIdsSchema, taskIdSchema, taskInitialState, taskKindSchema, taskOriginSchema, taskQuestionSchema, taskSchema, taskStateSchema, taskTransitions, taskUsageSchema, terminalStates, usdSchema, verificationBrief, vocabularySchema };
+export { AdoptPullRequestInput, AgentRoute, AgentRouteInput, AgentRouteRegistry, AgentSession, AnswerEvent, AnswerEventConflictError, AnswerId, AnswerQuestionInput, AppendReceiptInput, ApprovalDecision, ApprovalError, ApprovalPolicy, ApprovalRule, ApprovalSubject, Budget, BudgetExhaustedError, BudgetLimits, BudgetNotice, BudgetStatus, BudgetSweepOptions, BudgetSweepResult, Change, ChangeAssociationError, ChangeEvidence, ChangeId, ChangePatch, ChangeState, ChangeTransitionOptions, CollectionName, CommunicationEvent, CommunicationOutcome, CoordinationPlan, CoordinationReconciliation, Cost, CreateChangeInput, CreateCoordinationInput, CreateSignalInput, CreateStoresOptions, CreateTaskInput, DEFAULT_MAX_LAUNCH_ATTEMPTS, DecideSignalOptions, DispatchBudget, DispatchOptions, DispatchRefusedError, EnsureBudgetInput, ExecutionPolicy, ExecutionReference, FactoryConfig, FactoryConfigInput, FactoryId, FactoryStores, Finding, FindingCategory, FindingPriority, FindingVerification, HealthColor, HealthOptions, InvalidTransitionError, LedgerMetrics, LedgerRows, Level, MetricsOptions, OutboxEventConflictError, OutboxId, OutboxMessage, OutboxQueue, Receipt, ReceiptId, ReceiptKind, ReceiptPhase, ReceiptState, ReconcileCoordinationOptions, RecordExistsError, RecordNotFoundError, ReplyTo, Repository, RepositoryHealth, RepositoryId, RepositorySlug, ReviewBucket, SCHEMA_VERSION, SessionConflictError, SettleSweepOptions, SettleSweepResult, SettleTaskOptions, SettlementError, Signal, SignalCreator, SignalId, SignalOutcome, SignalSource, StallSweepOptions, StallSweepResult, StepUsage, StoreDriver, StoredEntry, StoredRecord, SweepOptions, SweepResult, Task, TaskApproval, TaskId, TaskKind, TaskLauncher, TaskPatch, TaskState, TaskTransitionOptions, TaskUsage, Transition, TransitionActor, VerificationTaskSweep, VersionConflictError, adoptPullRequest, agentRouteSchema, agentSessionIdSchema, agentSessionSchema, answerEventSchema, answerIdSchema, approvalPolicySchema, approvalRuleSchema, assertTransition, budgetLimitsSchema, budgetMonthOf, budgetMonthSchema, budgetSchema, budgetStatus, canReserve, changeEvidenceSchema, changeIdSchema, changeInitialState, changeSchema, changeStateSchema, changeTransitions, communicationEventSchema, communicationOutcomeSchema, communicationOutcomes, computeLedgerMetrics, computeMonthSpendUsd, computeRepositoryHealth, coordinationRepositoryIdsSchema, costSchema, createCoordination, createInMemoryDriver, createSignalCreator, createStores, defaultApprovalPolicy, defaultExecutionPolicy, defineAgentRoutes, defineFactory, deriveFactoryId, dispatchTask, ensureVerificationTasks, executionPolicySchema, executionReferenceSchema, factoryConfigRepositorySchema, factoryConfigSchema, factoryIdSchema, findingCategorySchema, findingFingerprint, findingForTask, findingPrioritySchema, findingSchema, findingVerificationLevelSchema, findingVerificationMethodSchema, findingVerificationSchema, fixBrief, harnessSchema, isTransitionAllowed, isoDateTimeSchema, legalNextStates, levelSchema, outboxIdSchema, outboxMessageSchema, outboxQueueSchema, outboxStateSchema, receiptIdSchema, receiptKindSchema, receiptPhaseSchema, receiptSchema, receiptStateSchema, reconcileCoordination, replyToSchema, repositoryIdSchema, repositoryIdsSchema, repositorySchema, repositorySlugSchema, requiresApproval, reviewBucket, scanBrief, schemaVersionSchema, signalIdSchema, signalInitialOutcome, signalOutcomeSchema, signalOutcomeTransitions, signalSchema, signalSourceSchema, stallWindowMinutes, standardReceiptKinds, standardReceiptPhases, standardReceiptStates, standardSignalSources, standardTaskKinds, sweepBudget, sweepQueued, sweepSettlements, sweepStalled, taskApprovalSchema, taskExecutionRepositoryIdsSchema, taskIdSchema, taskInitialState, taskKindSchema, taskOriginSchema, taskQuestionSchema, taskSchema, taskStateSchema, taskTransitions, taskUsageSchema, terminalStates, usdSchema, verificationBrief, vocabularySchema };
 //# sourceMappingURL=index.d.mts.map