@github/copilot-sdk 1.0.15-preview.3 → 1.0.15-preview.4

package/dist/types.d.ts

@@ -4,14 +4,16 @@
 import type { Canvas } from "./canvas.js";
 import type { SessionFsProvider } from "./sessionFsProvider.js";
 import type { CopilotRequestHandler } from "./copilotRequestHandler.js";
+import type { InstallationConfirmationHandler } from "./installationConfirmation.js";
+export type { InstallationConfirmationHandler } from "./installationConfirmation.js";
 import type { AttachmentExtensionContext as GeneratedExtensionContextAttachment, AutoTier, PermissionRequest as GeneratedPermissionRequest, PermissionRequestedData as GeneratedPermissionRequestedData, PermissionRequestedEvent as GeneratedPermissionRequestedEvent, ReasoningSummary, SessionLimitsConfig, SessionEvent as GeneratedSessionEvent } from "./generated/session-events.js";
 import type { CopilotSession } from "./session.js";
-import type { FactoryJsonSchema, JsonValue } from "./factory.js";
+import type { JsonValue } from "./workflow.js";
 import type { ExtensionLaunchProviderHandler as GeneratedExtensionLaunchProvider, GitHubTokenAcquireRequest, GitHubTokenAcquireResult, GitHubTelemetryNotification, ModelBillingTokenPrices, DiagnosticsConfiguration, OpenCanvasInstance, RemoteSessionMode, CurrentToolMetadata } from "./generated/rpc.js";
 import type { ToolSet } from "./toolSet.js";
 export type { RemoteSessionMode } from "./generated/rpc.js";
 export type { CurrentToolMetadata } from "./generated/rpc.js";
-export type { ConnectorAccountRequest, ConnectorAvailability, ConnectorCapabilities, ConnectorCatalogEntry, ConnectorCatalogResult, ConnectorCatalogStatus, ConnectorConnectRequest, ConnectorConnectResult, ConnectorContinueRequest, ConnectorDisconnectResult, ConnectorMcpStatus, ConnectorReconcileRequest, ConnectorRuntimeStatus, ConnectorStatus, ExtensionLaunchProfile, ExtensionLaunchProviderResolveRequest, ExtensionLaunchProviderResolveResult, GitHubTokenAcquireReason, GitHubTokenAcquireResult, GitHubTelemetryNotification, GitHubTelemetryEvent, GitHubTelemetryClientInfo, } from "./generated/rpc.js";
+export type { ConnectorAccountRequest, ConnectorAvailability, ConnectorCapabilities, ConnectorCatalogEntry, ConnectorCatalogResult, ConnectorCatalogStatus, ConnectorConnectRequest, ConnectorConnectResult, ConnectorContinueRequest, ConnectorDisconnectResult, ConnectorMcpStatus, ConnectorReconcileRequest, ConnectorRuntimeStatus, ConnectorStatus, ExtensionLaunchProfile, ExtensionLaunchProviderResolveRequest, ExtensionLaunchProviderResolveResult, GitHubTokenAcquireReason, GitHubTokenAcquireResult, GitHubTelemetryNotification, GitHubTelemetryEvent, GitHubTelemetryClientInfo, InstallationConfirmationRequest, InstallationConfirmationResponse, InstallationDecision, InstallationReview, McpInstallationReview, } from "./generated/rpc.js";
 /**
  * Arguments passed to a session's {@link GitHubTokenProvider}.
  *
@@ -290,6 +292,12 @@ export interface CopilotClientOptions {
      * @experimental
      */
     extensionLaunchProvider?: ExtensionLaunchProvider;
+    /**
+     * Connection-global human review for experimental installation operations.
+     * Does not register or enable installation capabilities on the runtime.
+     * @experimental
+     */
+    installationConfirmationHandler?: InstallationConfirmationHandler;
     /**
      * Log level for the Copilot runtime. When omitted, the runtime uses its
      * own default (currently `"info"`).
@@ -1692,69 +1700,6 @@ export interface CanvasProviderIdentity {
     /** Optional display name surfaced as the canvas extension name. */
     name?: string;
 }
-/**
- * Static resource ceilings declared by a factory before it runs.
- *
- * @experimental Part of the experimental Agent Factories surface and may
- * change or be removed in future SDK or CLI releases.
- */
-export interface FactoryLimits {
-    /** Maximum number of factory subagents that may run concurrently. Must be positive when present. */
-    maxConcurrentSubagents?: number;
-    /** Maximum total number of factory subagents that may be spawned. Must be positive when present. */
-    maxTotalSubagents?: number;
-    /** Maximum AI credits consumed by factory subagents and descendants. This post-paid ceiling is soft. */
-    maxAiCredits?: number;
-    /**
-     * Maximum accumulated active-execution time, in seconds. Active execution includes the entire extension body,
-     * subprocess waits, queued-agent waits, and sleeps. The limit is armed from the remaining headroom when a run
-     * resumes; time between attempts is not counted. Must be finite and positive when present.
-     */
-    timeoutSeconds?: number;
-}
-/**
- * Registration metadata for an extension-authored factory.
- *
- * @experimental Part of the experimental Agent Factories surface and may
- * change or be removed in future SDK or CLI releases.
- */
-export interface FactoryMeta {
-    /** Stable factory name used for invocation. */
-    name: string;
-    /** Human-readable factory description. */
-    description: string;
-    /** Display metadata for the progress phases the factory may report. */
-    phases: Array<{
-        title: string;
-        detail?: string;
-    }>;
-    /**
-     * Optional declared shape of the arguments this factory expects as `ctx.args`.
-     *
-     * Declaring one is strongly recommended for any factory that reads `ctx.args`.
-     * When the model invokes the factory through the `run_factory` tool, the CLI
-     * validates `args` against this declaration **before** the run starts, so a
-     * malformed call is rejected with a correction hint and retried without ever
-     * creating a run row, prompting the user for permission, or spending credits. A
-     * factory that declares nothing is never validated: a malformed call starts,
-     * takes an approval, spends credits, and then fails inside the factory body.
-     * `factories_manage` with `operation: "inspect"` reports the declared shape so an
-     * agent can read it before invoking.
-     *
-     * This covers the model's `run_factory` path only. `session.factory.run(...)` is
-     * not validated against the declaration, so a factory should still check
-     * `ctx.args` rather than assume the declared shape held.
-     *
-     * Enforcement covers structure — types, required properties, and enum/const
-     * values. Finer constraints such as `minLength`, `pattern`, and
-     * `additionalProperties` are recorded in the declaration but not enforced. See
-     * {@link FactoryJsonSchema} for the accepted subset. A declaration outside that
-     * subset is rejected at registration.
-     */
-    argsSchema?: FactoryJsonSchema;
-    /** Optional resource ceilings presented to the user before execution. */
-    limits?: FactoryLimits;
-}
 /**
  * Provider-scoped options for the Copilot API (CAPI).
  *

package/dist/workflow.d.ts

@@ -1,8 +1,11 @@
 import type { WorkflowGetRunProgressRequest, WorkflowListRunsRequest, WorkflowListRunsResult, WorkflowProgressPage, WorkflowRunDetail, WorkflowRunResult, WorkflowRunStatus, WorkflowRunSummary } from "./generated/rpc.js";
 import type { ContextTier } from "./generated/session-events.js";
 import type { CopilotSession } from "./session.js";
-import type { JsonValue } from "./factory.js";
 export type { WorkflowRunResult };
+/** A value that can be represented losslessly on the SDK JSON wire. */
+export type JsonValue = null | boolean | number | string | JsonValue[] | {
+    [key: string]: JsonValue;
+};
 export type { WorkflowAgentSummary, WorkflowPhaseStatus, WorkflowPhaseObservation, WorkflowProgressLine, WorkflowProgressPage, WorkflowRunDetail, WorkflowRunStatus, WorkflowRunSummary, } from "./generated/rpc.js";
 /**
  * Options for paging durable workflow runs.
@@ -311,7 +314,7 @@ export interface SessionWorkflowApi {
      * snapshot: resuming the same durable run can later change the envelope
      * returned by {@link SessionWorkflowApi.getRun}.
      *
-     * This watches the runtime's `factory.run_updated` compatibility event and
+     * This watches the runtime's `workflow.run_updated` event and
      * periodically re-reads the durable envelope so a missed event cannot
      * leave the wait hanging. Pass a `signal` to stop waiting; aborting rejects
      * and has no effect on the run itself, which keeps executing. Use

package/docs/extensions.md

@@ -78,5 +78,4 @@ An approved extension can pass a granted value to anything it starts, so ask onl
 
 - `examples.md` — Practical code examples for tools, hooks, events, and complete extensions
 - `workflows.md` — Authoring, running, resuming, and observing Dynamic Workflows
-- `factories.md`: Authoring, running, resuming, and observing Agent Factories
 - `agent-author.md` — Step-by-step workflow for agents authoring extensions programmatically

package/docs/workflows.md

@@ -2,8 +2,6 @@
 
 Dynamic Workflows are extension-authored, session-scoped workflows that coordinate subagents and durable steps. The API is experimental.
 
-Use Dynamic Workflows for new extension-authored orchestration. Existing Agent Factory extensions remain supported during the transition, but one `joinSession` call must register either `workflows` or `factories`, never both.
-
 ## Define and register a workflow
 
 Use `defineWorkflow` and pass the returned handle to `joinSession`:
@@ -242,7 +240,7 @@ if (settled.status === "completed") {
 }
 ```
 
-It watches the runtime's `factory.run_updated` compatibility event and re-reads the durable envelope on each invalidation, collapsing a burst of events into a single in-flight read. A low-frequency periodic re-read runs alongside the subscription, so a dropped or missing invalidation degrades into a slightly late resolution rather than an unbounded wait. Pass a `signal` to stop waiting:
+It watches `workflow.run_updated` and re-reads the durable envelope on each invalidation, collapsing a burst of events into a single in-flight read. A low-frequency periodic re-read runs alongside the subscription, so a dropped or missing invalidation degrades into a slightly late resolution rather than an unbounded wait. Pass a `signal` to stop waiting:
 
 ```ts
 const controller = new AbortController();
@@ -252,6 +250,6 @@ const settled = await session.workflow.waitForRun(runId, { signal: controller.si
 
 Aborting rejects the wait and has no effect on the run, which keeps executing—use `pause(runId)` or `cancel(runId)` to stop it. The resolved object is a snapshot of that settled attempt. If its status is `paused`, a later resume updates the durable envelope under the same run ID. Call `getRun(runId)` to read the latest envelope. `isWorkflowRunTerminal(status)` exposes the same current-attempt settlement test for callers driving their own loop.
 
-Listen for the ephemeral `factory.run_updated` compatibility event. Its `{ runId, revision }` payload is an invalidation signal. Re-read the desired API when a newer monotonic revision arrives.
+Listen for the ephemeral `workflow.run_updated` event. Its `{ runId, revision }` payload is an invalidation signal. Re-read the desired API when a newer monotonic revision arrives.
 
 Revisions cover durable lifecycle, accounting, phase, agent, and progress changes. Continuous read-time fields can change without a new revision. These include `observedAt`, active-time calculations, live counts, and a live agent's status or prompt-safe activity text. Workflow prompts are never exposed by these APIs. A run is visible only through the session that owns it.

package/package.json

@@ -4,8 +4,8 @@
         "type": "git",
         "url": "https://github.com/github/copilot-sdk.git"
     },
-    "version": "1.0.15-preview.3",
-    "copilotCliVersion": "1.0.89-3",
+    "version": "1.0.15-preview.4",
+    "copilotCliVersion": "1.0.89-7",
     "description": "TypeScript SDK for programmatic control of GitHub Copilot CLI via JSON-RPC",
     "main": "./dist/cjs/index.js",
     "types": "./dist/index.d.ts",
@@ -101,13 +101,13 @@
         "README.md"
     ],
     "optionalDependencies": {
-        "@github/copilot-sdk-darwin-arm64": "1.0.15-preview.3",
-        "@github/copilot-sdk-darwin-x64": "1.0.15-preview.3",
-        "@github/copilot-sdk-linux-arm64": "1.0.15-preview.3",
-        "@github/copilot-sdk-linux-x64": "1.0.15-preview.3",
-        "@github/copilot-sdk-linuxmusl-arm64": "1.0.15-preview.3",
-        "@github/copilot-sdk-linuxmusl-x64": "1.0.15-preview.3",
-        "@github/copilot-sdk-win32-arm64": "1.0.15-preview.3",
-        "@github/copilot-sdk-win32-x64": "1.0.15-preview.3"
+        "@github/copilot-sdk-darwin-arm64": "1.0.15-preview.4",
+        "@github/copilot-sdk-darwin-x64": "1.0.15-preview.4",
+        "@github/copilot-sdk-linux-arm64": "1.0.15-preview.4",
+        "@github/copilot-sdk-linux-x64": "1.0.15-preview.4",
+        "@github/copilot-sdk-linuxmusl-arm64": "1.0.15-preview.4",
+        "@github/copilot-sdk-linuxmusl-x64": "1.0.15-preview.4",
+        "@github/copilot-sdk-win32-arm64": "1.0.15-preview.4",
+        "@github/copilot-sdk-win32-x64": "1.0.15-preview.4"
     }
 }

package/dist/cjs/factory.js

@@ -1,134 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var factory_exports = {};
-__export(factory_exports, {
-  FACTORY_AGENT_OPTION_KEYS: () => FACTORY_AGENT_OPTION_KEYS,
-  FactoryResumeError: () => FactoryResumeError,
-  defineFactory: () => defineFactory,
-  getFactoryDefinition: () => getFactoryDefinition,
-  isFactoryRunTerminal: () => isFactoryRunTerminal
-});
-module.exports = __toCommonJS(factory_exports);
-const FACTORY_TERMINAL_STATUSES = /* @__PURE__ */ new Set([
-  "completed",
-  "halted",
-  "paused",
-  "cancelled",
-  "error"
-]);
-function isFactoryRunTerminal(status) {
-  return FACTORY_TERMINAL_STATUSES.has(status);
-}
-const FACTORY_AGENT_OPTION_KEYS = [
-  "label",
-  "schema",
-  "model",
-  "reasoningEffort",
-  "contextTier",
-  "agent"
-];
-class FactoryResumeError extends Error {
-  constructor(code, message) {
-    super(message);
-    this.code = code;
-    this.name = "FactoryResumeError";
-  }
-  code;
-}
-const factoryHandles = /* @__PURE__ */ new WeakMap();
-const MAX_FACTORY_TIMEOUT_SECONDS = 2147483647e-3;
-const NANO_AIU_PER_AIU = 1e9;
-function deepFreeze(value) {
-  if (value !== null && typeof value === "object" && !Object.isFrozen(value)) {
-    Object.freeze(value);
-    for (const nested of Object.values(value)) {
-      deepFreeze(nested);
-    }
-  }
-  return value;
-}
-function validateLimits(meta) {
-  const limits = meta.limits;
-  if (!limits) {
-    return;
-  }
-  for (const field of ["maxConcurrentSubagents", "maxTotalSubagents"]) {
-    const value = limits[field];
-    if (value !== void 0 && (!Number.isInteger(value) || value <= 0)) {
-      throw new Error(`Factory limit "${field}" must be a positive integer`);
-    }
-  }
-  if (limits.timeoutSeconds !== void 0 && (!Number.isFinite(limits.timeoutSeconds) || limits.timeoutSeconds <= 0)) {
-    throw new Error(
-      'Factory limit "timeoutSeconds" must be a positive, finite number of seconds'
-    );
-  }
-  if (limits.timeoutSeconds !== void 0 && limits.timeoutSeconds > MAX_FACTORY_TIMEOUT_SECONDS) {
-    throw new Error(
-      `Factory limit "timeoutSeconds" must not exceed ${MAX_FACTORY_TIMEOUT_SECONDS} seconds`
-    );
-  }
-  if (limits.maxAiCredits !== void 0) {
-    const maxNanoAiu = Math.round(limits.maxAiCredits * NANO_AIU_PER_AIU);
-    if (!Number.isFinite(limits.maxAiCredits) || limits.maxAiCredits <= 0 || !Number.isSafeInteger(maxNanoAiu) || maxNanoAiu < 1) {
-      throw new Error(
-        'Factory limit "maxAiCredits" must be a positive, finite number that rounds to a safe positive integer nano-AIU ceiling'
-      );
-    }
-  }
-}
-function validatePhases(meta) {
-  const titles = /* @__PURE__ */ new Set();
-  for (const phase of meta.phases) {
-    if (phase.title.trim().length === 0) {
-      throw new Error("Factory phase titles must not be empty");
-    }
-    if (titles.has(phase.title)) {
-      throw new Error(`Factory phase title "${phase.title}" is declared more than once`);
-    }
-    titles.add(phase.title);
-  }
-}
-function defineFactory(definition) {
-  const meta = deepFreeze(structuredClone(definition.meta));
-  validateLimits(meta);
-  validatePhases(meta);
-  const stored = {
-    meta,
-    run: definition.run
-  };
-  const handle = Object.freeze({ meta });
-  factoryHandles.set(handle, stored);
-  return handle;
-}
-function getFactoryDefinition(handle) {
-  const definition = factoryHandles.get(handle);
-  if (!definition) {
-    throw new Error("Invalid factory handle");
-  }
-  return definition;
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  FACTORY_AGENT_OPTION_KEYS,
-  FactoryResumeError,
-  defineFactory,
-  getFactoryDefinition,
-  isFactoryRunTerminal
-});

package/dist/factory.d.ts

@@ -1,327 +0,0 @@
-import type { FactoryGetRunProgressRequest, FactoryListRunsRequest, FactoryListRunsResult, FactoryProgressPage, FactoryRunDetail, FactoryRunResult, FactoryRunStatus, FactoryRunSummary } from "./generated/rpc.js";
-import type { ContextTier } from "./generated/session-events.js";
-import type { CopilotSession } from "./session.js";
-import type { FactoryMeta } from "./types.js";
-export type { FactoryRunResult };
-export type { FactoryAgentSummary, FactoryPhaseStatus, FactoryPhaseObservation, FactoryProgressLine, FactoryProgressPage, FactoryRunDetail, FactoryRunStatus, FactoryRunSummary, } from "./generated/rpc.js";
-/**
- * Options for paging durable factory runs.
- *
- * @experimental Part of the experimental Agent Factories surface and may
- * change or be removed in future SDK or CLI releases.
- */
-export type FactoryListRunsOptions = FactoryListRunsRequest;
-/**
- * A page of durable factory runs and its paging metadata.
- *
- * @experimental Part of the experimental Agent Factories surface and may
- * change or be removed in future SDK or CLI releases.
- */
-export type FactoryRunsPage = FactoryListRunsResult;
-/**
- * Whether a factory run status is terminal.
- *
- * @experimental Part of the experimental Agent Factories surface and may
- * change or be removed in future SDK or CLI releases.
- */
-export declare function isFactoryRunTerminal(status: FactoryRunStatus): boolean;
-declare const factoryHandleBrand: unique symbol;
-/** A value that can be represented losslessly on the SDK JSON wire. */
-export type JsonValue = null | boolean | number | string | JsonValue[] | {
-    [key: string]: JsonValue;
-};
-/**
- * Conservative JSON shape language accepted by the Agent Factories surface, for
- * both structured factory agent output and a factory's declared `argsSchema`.
- *
- * This is a best-effort structural guard — used to decide whether a subagent's
- * structured output should be accepted or retried, and whether a caller's
- * factory `args` match the declared shape — **not** a full JSON Schema
- * validator. Only these keywords are honored: `type`, `required`, `enum`,
- * `const`, recursive `properties`/`items`, and `anyOf`/`oneOf`/`allOf`. A `type`
- * is one of `null`, `boolean`, `integer`, `number`, `string`, `array`, or
- * `object`, or a non-empty array of those (for example `["object", "null"]`).
- *
- * Everything else is **ignored, not enforced**. In particular, string
- * constraints (`pattern`, `minLength`, `maxLength`, `format`), numeric ranges
- * (`minimum`, `maximum`), `additionalProperties`, and boolean (`true`/`false`)
- * schemas do not reject non-conforming output. `oneOf` is treated like `anyOf`
- * (at least one branch must match) rather than strict exactly-one. Author
- * schemas within this subset; do not rely on unsupported constraints for
- * correctness.
- *
- * @experimental Part of the experimental Agent Factories surface and may
- * change or be removed in future SDK or CLI releases.
- */
-export type FactoryJsonSchema = {
-    [key: string]: JsonValue;
-};
-/**
- * Options for one factory-scoped subagent call.
- *
- * @experimental Part of the experimental Agent Factories surface and may
- * change or be removed in future SDK or CLI releases.
- */
-export interface FactoryAgentOptions {
-    label?: string;
-    schema?: FactoryJsonSchema;
-    model?: string;
-    reasoningEffort?: string;
-    contextTier?: ContextTier;
-    agent?: string;
-}
-export declare const FACTORY_AGENT_OPTION_KEYS: readonly ["label", "schema", "model", "reasoningEffort", "contextTier", "agent"];
-/**
- * Options for a durable factory step.
- *
- * @experimental Part of the experimental Agent Factories surface and may
- * change or be removed in future SDK or CLI releases.
- */
-export interface FactoryStepOptions {
-    /** Skip the journal and always invoke the producer. */
-    volatile?: boolean;
-}
-/**
- * Per-invocation factory resource ceiling overrides.
- *
- * An omitted field preserves the existing/default ceiling, a number replaces
- * it, and `null` explicitly makes that dimension unlimited.
- *
- * @experimental Part of the experimental Agent Factories surface and may
- * change or be removed in future SDK or CLI releases.
- */
-export interface FactoryLimitOverrides {
-    maxConcurrentSubagents?: number | null;
-    maxTotalSubagents?: number | null;
-    maxAiCredits?: number | null;
-    timeoutSeconds?: number | null;
-}
-/**
- * One stage in a per-item factory pipeline.
- *
- * @experimental Part of the experimental Agent Factories surface and may
- * change or be removed in future SDK or CLI releases.
- */
-export type FactoryPipelineStage<TInput = unknown, TResult = unknown> = (previous: TInput, item: unknown, index: number) => Promise<TResult> | TResult;
-/**
- * Context passed to an extension-authored factory body.
- *
- * @experimental Part of the experimental Agent Factories surface and may
- * change or be removed in future SDK or CLI releases.
- */
-export interface FactoryContext<TArgs extends JsonValue = JsonValue> {
-    /** Stable identifier for the current factory run. */
-    readonly runId: string;
-    /** Spawn and await one factory-scoped subagent. */
-    agent(prompt: string, options?: FactoryAgentOptions): Promise<unknown>;
-    /** Memoize an arbitrary producer under a stable author-supplied key. */
-    step(key: string, producer: () => Promise<JsonValue> | JsonValue, options?: FactoryStepOptions): Promise<JsonValue>;
-    /**
-     * Pause this run at a durable, one-shot checkpoint.
-     *
-     * The first attempt to reach a key pauses and aborts cooperatively. A
-     * resumed attempt returns from the same key and continues.
-     */
-    pause(key: string): Promise<void>;
-    /**
-     * Run thunks concurrently and await all of them.
-     *
-     * A thunk that throws becomes `null` in the result array, so one failed
-     * item does not lose the rest. Cancellation and hard runtime failures
-     * (`ResponseError`, `ConnectionError`) are the exception: those propagate
-     * and reject the whole call, because they mean the run itself is in
-     * trouble rather than one item having failed.
-     */
-    parallel<TResult>(thunks: Array<() => Promise<TResult> | TResult>): Promise<Array<TResult | null>>;
-    /**
-     * Run each item through every stage without barriers between stages.
-     *
-     * A stage that throws drops that item to `null` and skips its remaining
-     * stages. As with {@link FactoryContext.parallel}, cancellation and hard
-     * runtime failures propagate instead of being recorded per item.
-     */
-    pipeline(items: unknown[], ...stages: FactoryPipelineStage[]): Promise<unknown[]>;
-    /** Start a named factory progress phase. */
-    phase(title: string): void;
-    /** Emit a factory progress line. */
-    log(message: string): void;
-    /** Reject because nested factories are not supported. */
-    factory(name: string, args?: JsonValue): Promise<JsonValue | void>;
-    /** Caller-supplied input, forwarded verbatim. */
-    args: TArgs;
-    /**
-     * The session instance returned by `joinSession`. It refuses calls that
-     * start, resume, or pause a factory run.
-     */
-    session: CopilotSession;
-    /** Cooperative cancellation signal for the current factory run. */
-    signal: AbortSignal;
-}
-/**
- * Definition accepted by {@link defineFactory}.
- *
- * @experimental Part of the experimental Agent Factories surface and may
- * change or be removed in future SDK or CLI releases.
- */
-export interface FactoryDefinition<TArgs extends JsonValue = JsonValue, TResult extends JsonValue | void = JsonValue | void> {
-    meta: FactoryMeta;
-    run(context: FactoryContext<TArgs>): Promise<TResult>;
-}
-/**
- * A deeply immutable view of a value.
- *
- * `defineFactory` deep-freezes the metadata it stores, so the handle's view of
- * it has to be readonly all the way down or `handle.meta.name = "..."` and
- * `handle.meta.phases.push(...)` would compile and then throw at runtime.
- */
-type DeepReadonly<T> = T extends (infer U)[] ? readonly DeepReadonly<U>[] : T extends object ? {
-    readonly [K in keyof T]: DeepReadonly<T[K]>;
-} : T;
-/**
- * Opaque reusable reference to a defined factory.
- *
- * @experimental Part of the experimental Agent Factories surface and may
- * change or be removed in future SDK or CLI releases.
- */
-export interface FactoryHandle<TArgs extends JsonValue = JsonValue, TResult extends JsonValue | void = JsonValue | void> {
-    readonly meta: DeepReadonly<FactoryMeta>;
-    readonly [factoryHandleBrand]: {
-        readonly args: TArgs;
-        readonly result: TResult;
-    };
-}
-/**
- * Options for invoking a factory.
- *
- * @experimental Part of the experimental Agent Factories surface and may
- * change or be removed in future SDK or CLI releases.
- */
-export interface RunOptions<TArgs extends JsonValue = JsonValue> {
-    /** Input surfaced as `context.args`. */
-    args?: TArgs;
-    /** Optional per-invocation resource ceiling overrides. */
-    limits?: FactoryLimitOverrides;
-    /** Whether to notify the originating session when the factory completes. */
-    notifyOnComplete?: boolean;
-    /** Whether to emit factory phase names to the session transcript. */
-    logPhaseNames?: boolean;
-    /**
-     * Prior run whose persisted identity, arguments, journal, and accounting should be resumed.
-     *
-     * @deprecated Use {@link SessionFactoryApi.resume} instead.
-     */
-    resumeFromRunId?: string;
-}
-/**
- * Options for resuming a factory run by ID.
- *
- * @experimental Part of the experimental Agent Factories surface and may
- * change or be removed in future SDK or CLI releases.
- */
-export interface ResumeOptions {
-    /** Optional per-invocation resource ceiling overrides. */
-    limits?: FactoryLimitOverrides;
-    /** Whether to notify the originating session when the factory completes. */
-    notifyOnComplete?: boolean;
-    /** Whether to emit factory phase names to the session transcript. */
-    logPhaseNames?: boolean;
-}
-/**
- * Machine-readable pre-execution factory resume failure.
- *
- * @experimental Part of the experimental Agent Factories surface and may
- * change or be removed in future SDK or CLI releases.
- */
-export type FactoryResumeErrorCode = "not_found" | "non_resumable" | "already_active" | "factory_already_running" | "factory_limits_invalid" | "factory_session_disposed" | "factory_storage_unavailable" | "factory_storage_corrupt";
-/**
- * Friendly factory API exposed on a session.
- *
- * @experimental Part of the experimental Agent Factories surface and may
- * change or be removed in future SDK or CLI releases.
- */
-export interface SessionFactoryApi {
-    /**
-     * Run a registered factory and resolve with its run envelope.
-     *
-     * The envelope is returned for every outcome, including `error`, `halted`,
-     * `paused`, and `cancelled` — inspect `status` and read `result` only when
-     * the run completed. `paused` settles the current attempt, but the same
-     * durable run can later resume under its existing run ID. SDK-initiated
-     * runs do not request permission, so they have no declined outcome. The
-     * model's `run_factory` tool requests permission before a durable row
-     * exists; declining it creates no run row. Failures that occur before a run
-     * exists (such as an unknown factory or attempting to start a run while the
-     * session is at its active top-level run limit) still reject.
-     */
-    run(name: string, options?: RunOptions): Promise<FactoryRunResult>;
-    run<TArgs extends JsonValue>(factory: FactoryHandle<TArgs, JsonValue | void>, options?: RunOptions<TArgs>): Promise<FactoryRunResult>;
-    /**
-     * Resume a run from its persisted factory name, arguments, journal, and accounting.
-     *
-     * Resolves with the run envelope like {@link SessionFactoryApi.run}.
-     * SDK-initiated resumes do not request permission. A pre-execution failure
-     * with a documented resume code rejects with {@link FactoryResumeError}.
-     */
-    resume(runId: string, options?: ResumeOptions): Promise<FactoryRunResult>;
-    /** Read the latest durable envelope for a factory run. */
-    getRun(runId: string): Promise<FactoryRunResult>;
-    /**
-     * Wait for the current attempt to settle and resolve with its envelope.
-     *
-     * Resolves as soon as the run reaches `completed`, `error`, `halted`,
-     * `paused`, or `cancelled`, and resolves immediately when the current
-     * attempt has already settled. A `paused` envelope is an attempt-level
-     * snapshot: resuming the same durable run can later change the envelope
-     * returned by {@link SessionFactoryApi.getRun}.
-     *
-     * This watches the run's `factory.run_updated` invalidation events and
-     * periodically re-reads the durable envelope so a missed event cannot
-     * leave the wait hanging. Pass a `signal` to stop waiting; aborting rejects
-     * and has no effect on the run itself, which keeps executing. Use
-     * {@link SessionFactoryApi.cancel} to actually stop it.
-     */
-    waitForRun(runId: string, options?: {
-        signal?: AbortSignal;
-    }): Promise<FactoryRunResult>;
-    /**
-     * List the newest default page of this session's durable factory runs.
-     *
-     * This backwards-compatible overload returns only the runs array. Pass
-     * paging options to receive the full page, including its cursors and
-     * truncation metadata.
-     */
-    listRuns(): Promise<FactoryRunSummary[]>;
-    /**
-     * Page this session's durable factory runs.
-     *
-     * `afterSeq` and `beforeSeq` are exclusive cursors. The result includes
-     * `oldestSeq`, `newestSeq`, `hasMoreNewer`, and `omittedOlder` so callers
-     * can continue paging without using the raw RPC client.
-     */
-    listRuns(options: FactoryListRunsOptions): Promise<FactoryRunsPage>;
-    /** Read durable phases, direct agents, and the latest progress tail for a run. */
-    getRunDetail(runId: string): Promise<FactoryRunDetail>;
-    /** Page durable progress forward, backward, or from the latest tail. */
-    getRunProgress(runId: string, options?: Omit<FactoryGetRunProgressRequest, "runId">): Promise<FactoryProgressPage>;
-    /** Pause a running factory attempt and return its `paused` envelope. */
-    pause(runId: string): Promise<FactoryRunResult>;
-    /** Cancel a factory run and return its terminal envelope. */
-    cancel(runId: string): Promise<FactoryRunResult>;
-}
-/**
- * Error thrown when a factory cannot be resumed before execution begins.
- *
- * @experimental Part of the experimental Agent Factories surface and may
- * change or be removed in future SDK or CLI releases.
- */
-export declare class FactoryResumeError extends Error {
-    readonly code: FactoryResumeErrorCode;
-    constructor(code: FactoryResumeErrorCode, message: string);
-}
-/**
- * Defines an extension-authored factory and returns an opaque registration handle.
- *
- * @experimental Part of the experimental Agent Factories surface and may
- * change or be removed in future SDK or CLI releases.
- */
-export declare function defineFactory<TArgs extends JsonValue = JsonValue, TResult extends JsonValue | void = JsonValue | void>(definition: FactoryDefinition<TArgs, TResult>): FactoryHandle<TArgs, TResult>;