@bermudi/pi-delegate 0.1.10 → 0.1.12

package/types.ts

@@ -41,10 +41,8 @@ export interface AgentConfig {
 
 // ── Tool parameter types — derived from the TypeBox schema ────────────────
 // `delegateArgumentsSchema` in schema.ts is the canonical provider-visible
-// shape. The public types add deprecated `action` aliases so existing TypeScript
-// callers remain source-compatible without advertising the overloaded fields to
-// models. The import is type-only, so the schema.ts ↔ types.ts cycle is erased
-// at compile time.
+// shape; these types are its `Static<>` projections. The import is type-only,
+// so the schema.ts ↔ types.ts cycle is erased at compile time.
 
 type CanonicalDelegateArguments = Static<typeof delegateArgumentsSchema>;
 type CanonicalTaskDef = NonNullable<
@@ -60,19 +58,9 @@ export type SessionAction = NonNullable<CanonicalTaskDef["sessionAction"]>;
 /** Filesystem mode: shared source tree or an ephemeral CoW scratch copy. */
 export type WorkspaceMode = NonNullable<CanonicalTaskDef["workspace"]>;
 
-export type TaskDef = CanonicalTaskDef & {
-  /** @deprecated Use `sessionAction` instead. Runtime normalization still accepts this alias. */
-  action?: SessionAction;
-};
+export type TaskDef = CanonicalTaskDef;
 
-export type DelegateArguments = Omit<CanonicalDelegateArguments, "tasks"> & {
-  /** @deprecated Use `ticketAction` instead. Runtime normalization still accepts this alias. */
-  action?: TicketAction;
-  tasks?: TaskDef[];
-};
-
-/** @deprecated Use `TicketAction` instead. */
-export type DelegateAction = TicketAction;
+export type DelegateArguments = CanonicalDelegateArguments;
 
 // ── Async Ticket Types ─────────────────────────────────────────────────────
 
@@ -111,8 +99,19 @@ export interface AsyncTicket {
   callRecord?: CallRecord;
   /** Runtime generation for rejecting shutdown writes from stale tickets. */
   telemetryGeneration?: number;
+  /** Telemetry config captured at dispatch; binds shutdown aggregate rows to the
+   *  same backend the call span wrote to. */
+  telemetryConfig?: import("./config.ts").TelemetryConfig;
   /** Resolves after every async worker has settled, including shutdown aborts. */
   completion?: Promise<void>;
+  /** False from admission until every worker has quiesced. Unlike `status`,
+   * this remains false during shutdown's early terminal transition. */
+  workersSettled?: boolean;
+  /** Batch-level warning attached to this dispatch, not to any one task. */
+  dispatchWarning?: string;
+  /** Immutable dispatch-scoped delegate.json snapshot used by async workers and
+   *  later result formatting. */
+  config?: import("./config.ts").DelegateConfig;
 }
 
 /** Live parent settings captured when a delegate call starts. The built-in
@@ -150,6 +149,11 @@ export interface ResolvedTask {
   warnings: string[];
   /** Explicit settings that must match a live pooled session on reuse. */
   reuseIntent?: ReuseIntent;
+  /** Stable signature of the provider-scoped extension allowlist for this task's
+   *  model provider. Pool reuse compares this to the frozen session value so a
+   *  revoked or reconfigured extension cannot continue executing in a reused
+   *  session. */
+  providerExtensionSources?: string;
 }
 
 export interface ToolActivity {
@@ -207,6 +211,8 @@ export interface DelegateDetails {
   /** Global overlap warning derived from result.attributedFiles, surfaced in both
    *  the textual content and the custom TUI. */
   overlapWarning?: string;
+  /** Warning that applies to the whole dispatch rather than an individual task. */
+  dispatchWarning?: string;
 }
 
 export interface TaskResult {
@@ -239,8 +245,58 @@ export interface TaskResult {
    *  for overlap detection so concurrent tasks in the same repo do not
    *  fabricate false conflicts from shared git snapshots. */
   attributedFiles?: string[];
+  /** Git-native proposal/reconciliation outcome for workspace:"isolated". */
+  integration?: TaskIntegration;
+}
+
+export type TaskIntegrationStatus =
+  | "applied_unverified"
+  | "no_changes"
+  | "conflict"
+  | "discarded"
+  | "apply_failed";
+
+interface TaskIntegrationFiles {
+  proposedFiles: string[];
+  appliedFiles: string[];
 }
 
+interface TaskIntegrationWithoutRecovery extends TaskIntegrationFiles {
+  conflicts?: never;
+  baselineRef?: never;
+  proposalRef?: never;
+  patchPath?: never;
+  worktreePath?: never;
+}
+
+export type TaskIntegration =
+  | (TaskIntegrationWithoutRecovery & {
+      status: "applied_unverified";
+    })
+  | (TaskIntegrationWithoutRecovery & {
+      status: "no_changes";
+    })
+  | (TaskIntegrationWithoutRecovery & {
+      status: "discarded";
+    })
+  | (TaskIntegrationFiles & {
+      status: "conflict";
+      conflicts: Array<{ path: string; reason: string }>;
+      baselineRef: string;
+      proposalRef: string;
+      patchPath: string;
+      worktreePath: string;
+    })
+  | (TaskIntegrationFiles & {
+      status: "apply_failed";
+      conflicts: Array<{ path: string; reason: string }>;
+      /** Recovery metadata exists when reconciliation reached a proposal. */
+      baselineRef?: string;
+      proposalRef?: string;
+      patchPath?: string;
+      worktreePath?: string;
+    });
+
 /** Single source of truth for a subagent's runtime configuration.
  *  Passed to `createAgentSession` as `model` / `thinkingLevel` / `tools` / `cwd`. */
 export interface AgentRunConfig {
@@ -277,8 +333,15 @@ export interface TaskRunEnv {
   telemetryCallId?: string;
   /** Runtime generation for rejecting writes from a stale shutdown worker. */
   telemetryGeneration?: number;
+  /** Telemetry config captured at dispatch; binds task rows to the same backend
+   *  as the call span. */
+  telemetryConfig?: import("./config.ts").TelemetryConfig;
   /** Whether this task is part of an async ticket. */
   async?: boolean;
+  /** Immutable dispatch-scoped delegate.json snapshot. Long-lived async workers
+   *  use this instead of the live singleton so retry/stall/output/provider
+   *  settings stay stable for the ticket's lifetime. */
+  config?: import("./config.ts").DelegateConfig;
 }
 
 /** Structural subset of Pi's `ExtensionContext` used by delegate's
@@ -300,6 +363,10 @@ export interface DelegateToolCtx {
     | undefined;
   /** Optional hook Pi exposes for extensions to read the live system prompt. */
   getSystemPrompt?: () => string | undefined;
+  /** Optional TUI notice boundary used for migration warnings. */
+  ui?: {
+    notify(message: string, level?: "info" | "warning" | "error"): void;
+  };
 }
 
 /** Shape returned by the delegate tool's `execute`. Mirrors Pi's