@proposit/proposit-core 1.9.0 → 1.11.0

package/dist/extensions/openai/errors.d.ts

@@ -63,4 +63,27 @@ export declare class ToolLoopExhaustedError extends Error {
         rounds: number;
     });
 }
+/**
+ * Thrown by {@link retrieveResponse} (and the background poll loop) when
+ * a stored response is not found (HTTP 404). This typically means the
+ * ~10-minute retention window has elapsed. Callers should clear the
+ * stored id, settle the associated stage as failed, and surface a retry
+ * prompt.
+ *
+ * Extends {@link NonRetryableLlmError} so it inherits the fail-fast
+ * disposition: a 404 is deterministic — re-fetching the same aged-out id
+ * will 404 again — so the framework must not burn a retry. Inheriting the
+ * base (which carries **no** `retryReason` tag) means `llmStage`
+ * classifies it as `non_retryable`, exactly as the prior generic
+ * `NonRetryableLlmError` did when a 404 surfaced mid-poll — so this is a
+ * strictly more specific, behavior-preserving subclass. Callers that
+ * `instanceof NonRetryableLlmError` still match; callers wanting the
+ * aged-out signal specifically can `instanceof ResponseNotFoundError`.
+ */
+export declare class ResponseNotFoundError extends NonRetryableLlmError {
+    readonly responseId: string;
+    constructor(args: {
+        responseId: string;
+    });
+}
 //# sourceMappingURL=errors.d.ts.map

package/dist/extensions/openai/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/extensions/openai/errors.ts"],"names":[],"mappings":"AAyCA,qBAAa,iBAAkB,SAAQ,KAAK;IACxC,SAAgB,WAAW,EAAG,WAAW,CAAS;IAClD,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAA;gBAEnB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;CAKzD;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IACxC,SAAgB,WAAW,EAAG,YAAY,CAAS;IACnD,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAA;gBAEnB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;CAKzD;AAED;;;;;;;;GAQG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC7C,SAAgB,WAAW,EAAG,iBAAiB,CAAS;IACxD,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAA;gBAEnB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;CAKzD;AAED;;;;;;;;;GASG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IAC/C,SAAgB,WAAW,EAAG,WAAW,CAAS;IAClD,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAA;gBAEnB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;CAKzD;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAC3C,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAA;gBAEnB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;CAKzD;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC7C,SAAgB,MAAM,EAAE,MAAM,CAAA;gBAElB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAKxD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/extensions/openai/errors.ts"],"names":[],"mappings":"AAyCA,qBAAa,iBAAkB,SAAQ,KAAK;IACxC,SAAgB,WAAW,EAAG,WAAW,CAAS;IAClD,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAA;gBAEnB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;CAKzD;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IACxC,SAAgB,WAAW,EAAG,YAAY,CAAS;IACnD,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAA;gBAEnB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;CAKzD;AAED;;;;;;;;GAQG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC7C,SAAgB,WAAW,EAAG,iBAAiB,CAAS;IACxD,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAA;gBAEnB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;CAKzD;AAED;;;;;;;;;GASG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IAC/C,SAAgB,WAAW,EAAG,WAAW,CAAS;IAClD,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAA;gBAEnB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;CAKzD;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAC3C,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAA;gBAEnB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;CAKzD;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC7C,SAAgB,MAAM,EAAE,MAAM,CAAA;gBAElB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAKxD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,qBAAsB,SAAQ,oBAAoB;IAC3D,SAAgB,UAAU,EAAE,MAAM,CAAA;gBAEtB,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE;CAQ3C"}

package/dist/extensions/openai/errors.js

@@ -109,4 +109,32 @@ export class ToolLoopExhaustedError extends Error {
         this.rounds = args.rounds;
     }
 }
+/**
+ * Thrown by {@link retrieveResponse} (and the background poll loop) when
+ * a stored response is not found (HTTP 404). This typically means the
+ * ~10-minute retention window has elapsed. Callers should clear the
+ * stored id, settle the associated stage as failed, and surface a retry
+ * prompt.
+ *
+ * Extends {@link NonRetryableLlmError} so it inherits the fail-fast
+ * disposition: a 404 is deterministic — re-fetching the same aged-out id
+ * will 404 again — so the framework must not burn a retry. Inheriting the
+ * base (which carries **no** `retryReason` tag) means `llmStage`
+ * classifies it as `non_retryable`, exactly as the prior generic
+ * `NonRetryableLlmError` did when a 404 surfaced mid-poll — so this is a
+ * strictly more specific, behavior-preserving subclass. Callers that
+ * `instanceof NonRetryableLlmError` still match; callers wanting the
+ * aged-out signal specifically can `instanceof ResponseNotFoundError`.
+ */
+export class ResponseNotFoundError extends NonRetryableLlmError {
+    responseId;
+    constructor(args) {
+        super({
+            message: `OpenAI response "${args.responseId}" was not found (404). The ~10-minute retention window may have elapsed.`,
+            status: 404,
+        });
+        this.name = "ResponseNotFoundError";
+        this.responseId = args.responseId;
+    }
+}
 //# sourceMappingURL=errors.js.map

package/dist/extensions/openai/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/extensions/openai/errors.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,EAAE;AACF,qEAAqE;AACrE,8DAA8D;AAC9D,+DAA+D;AAC/D,sEAAsE;AACtE,0CAA0C;AAC1C,EAAE;AACF,mDAAmD;AACnD,mDAAmD;AACnD,EAAE;AACF,4DAA4D;AAC5D,8DAA8D;AAC9D,sBAAsB;AACtB,mEAAmE;AACnE,gDAAgD;AAChD,sEAAsE;AACtE,4CAA4C;AAC5C,mEAAmE;AACnE,gEAAgE;AAChE,sEAAsE;AACtE,qEAAqE;AACrE,qEAAqE;AACrE,6DAA6D;AAC7D,mEAAmE;AACnE,+CAA+C;AAC/C,6DAA6D;AAC7D,gEAAgE;AAChE,iEAAiE;AACjE,yBAAyB;AACzB,+DAA+D;AAC/D,qDAAqD;AACrD,4DAA4D;AAC5D,yBAAyB;AACzB,mEAAmE;AACnE,2CAA2C;AAC3C,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,oEAAoE;AAEpE,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACxB,WAAW,GAAG,WAAoB,CAAA;IAClC,MAAM,CAAS;IAE/B,YAAY,IAA0C;QAClD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACnB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;QAC/B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;IAC7B,CAAC;CACJ;AAED,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACxB,WAAW,GAAG,YAAqB,CAAA;IACnC,MAAM,CAAS;IAE/B,YAAY,IAA0C;QAClD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACnB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;QAC/B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;IAC7B,CAAC;CACJ;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC7B,WAAW,GAAG,iBAA0B,CAAA;IACxC,MAAM,CAAS;IAE/B,YAAY,IAA0C;QAClD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACnB,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAA;QACpC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;IAC7B,CAAC;CACJ;AAED;;;;;;;;;GASG;AACH,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IAC/B,WAAW,GAAG,WAAoB,CAAA;IAClC,MAAM,CAAS;IAE/B,YAAY,IAA0C;QAClD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACnB,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAA;QACtC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;IAC7B,CAAC;CACJ;AAED,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC3B,MAAM,CAAS;IAE/B,YAAY,IAA0C;QAClD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACnB,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;QAClC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;IAC7B,CAAC;CACJ;AAED,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC7B,MAAM,CAAQ;IAE9B,YAAY,IAAyC;QACjD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACnB,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAA;QACpC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;IAC7B,CAAC;CACJ"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/extensions/openai/errors.ts"],"names":[],"mappings":"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"}

package/dist/extensions/openai/index.d.ts

@@ -1,7 +1,7 @@
-export { createOpenAiResponsesProvider } from "./provider.js";
-export type { TCreateOpenAiResponsesProviderOptions } from "./provider.js";
+export { createOpenAiResponsesProvider, retrieveResponse, reconnectStream, cancelResponse, submitBackgroundResponse, } from "./provider.js";
+export type { TCreateOpenAiResponsesProviderOptions, TRetrievedResponse, TResponseStatus, } from "./provider.js";
 export type { TOpenAiFetch } from "./types.js";
-export { NonRetryableLlmError, QuotaExhaustedLlmError, RateLimitLlmError, SchemaValidationLlmError, ToolLoopExhaustedError, TransientLlmError, } from "./errors.js";
+export { NonRetryableLlmError, QuotaExhaustedLlmError, RateLimitLlmError, ResponseNotFoundError, SchemaValidationLlmError, ToolLoopExhaustedError, TransientLlmError, } from "./errors.js";
 export { typeboxToOpenAiSchema } from "./structured-output.js";
 export type { TOpenAiJsonSchema } from "./structured-output.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/extensions/openai/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensions/openai/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAA;AAC7D,YAAY,EAAE,qCAAqC,EAAE,MAAM,eAAe,CAAA;AAC1E,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EACH,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,GACpB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensions/openai/index.ts"],"names":[],"mappings":"AAQA,OAAO,EACH,6BAA6B,EAC7B,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,wBAAwB,GAC3B,MAAM,eAAe,CAAA;AACtB,YAAY,EACR,qCAAqC,EACrC,kBAAkB,EAClB,eAAe,GAClB,MAAM,eAAe,CAAA;AACtB,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EACH,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,GACpB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/extensions/openai/index.js

@@ -3,8 +3,9 @@
 // Public surface consumed by `proposit-server`, the CLI, and other
 // callers: the provider constructor + caller-facing config types +
 // the error classes that callers may want to `instanceof`-match for
-// finer-grained observability.
-export { createOpenAiResponsesProvider } from "./provider.js";
-export { NonRetryableLlmError, QuotaExhaustedLlmError, RateLimitLlmError, SchemaValidationLlmError, ToolLoopExhaustedError, TransientLlmError, } from "./errors.js";
+// finer-grained observability + the response retrieval / reconnect /
+// cancel API for resync.
+export { createOpenAiResponsesProvider, retrieveResponse, reconnectStream, cancelResponse, submitBackgroundResponse, } from "./provider.js";
+export { NonRetryableLlmError, QuotaExhaustedLlmError, RateLimitLlmError, ResponseNotFoundError, SchemaValidationLlmError, ToolLoopExhaustedError, TransientLlmError, } from "./errors.js";
 export { typeboxToOpenAiSchema } from "./structured-output.js";
 //# sourceMappingURL=index.js.map

package/dist/extensions/openai/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/openai/index.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,EAAE;AACF,mEAAmE;AACnE,mEAAmE;AACnE,oEAAoE;AACpE,+BAA+B;AAE/B,OAAO,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAA;AAG7D,OAAO,EACH,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,GACpB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/openai/index.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,EAAE;AACF,mEAAmE;AACnE,mEAAmE;AACnE,oEAAoE;AACpE,qEAAqE;AACrE,yBAAyB;AAEzB,OAAO,EACH,6BAA6B,EAC7B,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,wBAAwB,GAC3B,MAAM,eAAe,CAAA;AAOtB,OAAO,EACH,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,GACpB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/extensions/openai/provider.d.ts

@@ -1,4 +1,4 @@
-import type { TLlmProvider } from "../../lib/llm/types.js";
+import type { TLlmProvider, TLlmRequest } from "../../lib/llm/types.js";
 import type { TOpenAiFetch } from "./types.js";
 export type TCreateOpenAiResponsesProviderOptions = {
     apiKey: string;
@@ -38,6 +38,25 @@ export type TCreateOpenAiResponsesProviderOptions = {
      * `NonRetryableLlmError`.
      */
     backgroundMode?: boolean;
+    /**
+     * Combine OpenAI **background mode** with **live SSE streaming**:
+     * the request is submitted with `{ background: true, stream: true,
+     * store: true }` so it keeps generating server-side even if the
+     * connection drops, and the SSE stream is consumed live while it
+     * runs. This is independent of the `stream` option (foreground-
+     * only streaming) and `backgroundMode` (poll-only).
+     *
+     * When `true`, `backgroundMode` is ignored for this provider
+     * instance. `stream` is also ignored (SSE is always used in this
+     * mode). V1 supports the **no-tools path only**: a request that
+     * sets `backgroundStreamMode` and carries `tools` throws
+     * `NonRetryableLlmError`.
+     *
+     * The response id is surfaced immediately from the submit POST
+     * body (before any SSE bytes), making it available for durable
+     * persistence by the caller. Defaults to **`false`**.
+     */
+    backgroundStreamMode?: boolean;
     /**
      * Poll interval (ms) for the background submit-then-poll loop.
      * Defaults to 2000. Ignored unless `backgroundMode` is `true`.
@@ -45,4 +64,151 @@ export type TCreateOpenAiResponsesProviderOptions = {
     backgroundPollIntervalMs?: number;
 };
 export declare function createOpenAiResponsesProvider(options: TCreateOpenAiResponsesProviderOptions): TLlmProvider;
+/**
+ * The status values the OpenAI Responses API reports for a stored
+ * response. `completed` / `failed` / `incomplete` / `cancelled` are
+ * terminal; `queued` / `in_progress` are transient.
+ */
+export type TResponseStatus = "queued" | "in_progress" | "completed" | "failed" | "incomplete" | "cancelled";
+/**
+ * The structured result of a `retrieveResponse` call. All fields
+ * except `status` and `rawResponseId` are absent for non-terminal
+ * or failed responses.
+ */
+export type TRetrievedResponse = {
+    /** Current status of the stored response. */
+    status: TResponseStatus;
+    /**
+     * Parsed text output, present when `status === "completed"` and
+     * the response carried a `message` output item.
+     */
+    output?: string;
+    /** Token usage reported by OpenAI, when available. */
+    tokenUsage?: import("../../lib/llm/types.js").TLlmTokenUsage;
+    /** The OpenAI response id that was retrieved. */
+    rawResponseId: string;
+    /**
+     * The envelope's `incomplete_details.reason`, present when
+     * `status === "incomplete"` (e.g. `max_output_tokens`,
+     * `content_filter`). Lets a completion-side consumer classify an
+     * incomplete response without re-deriving it. Additive (since
+     * v1.11.0).
+     */
+    incompleteReason?: string;
+    /**
+     * The envelope's `error.message`, present when `status === "failed"`.
+     * Additive (since v1.11.0).
+     */
+    errorMessage?: string;
+};
+/**
+ * Retrieve a stored OpenAI response by id. Surfaces the current
+ * status, output text (when completed), and token usage.
+ *
+ * Throws {@link ResponseNotFoundError} when the response is not found
+ * (HTTP 404), which typically means the ~10-minute retention window
+ * has elapsed. Callers should clear the stored id, settle the
+ * associated stage as failed, and surface a retry prompt.
+ *
+ * @param id - The OpenAI response id to retrieve.
+ * @param options - Provider configuration (apiKey, optional baseUrl and fetch).
+ */
+export declare function retrieveResponse(id: string, options: {
+    apiKey: string;
+    baseUrl?: string;
+    fetch?: TOpenAiFetch;
+    signal?: AbortSignal;
+}): Promise<TRetrievedResponse>;
+/**
+ * Reconnect to a stored, still-generating background response and
+ * **stream it to completion**. This is what actually drives a dropped
+ * background response forward: a passive `retrieveResponse` GET only
+ * reads the current state and leaves a `queued` / `in_progress`
+ * response sitting where it is, whereas reconnecting with `stream=true`
+ * resumes consumption so the response reaches a terminal status.
+ *
+ * Issues `GET /responses/{id}?stream=true&starting_after=<cursor>` and
+ * consumes the SSE stream to its terminal event, returning the same
+ * {@link TRetrievedResponse} shape as {@link retrieveResponse}.
+ *
+ * Throws {@link ResponseNotFoundError} when the response is not found
+ * (HTTP 404 — typically the ~10-minute retention window elapsed).
+ * Honors `signal`: an abort propagates as an `AbortError` from the
+ * underlying stream read.
+ *
+ * @param id - The OpenAI response id to reconnect to.
+ * @param options - `apiKey`, optional `startingAfter` SSE cursor
+ *   (defaults to 0 — replay from the start of the stored stream),
+ *   optional `baseUrl`, `fetch`, and `signal`.
+ */
+export declare function reconnectStream(id: string, options: {
+    apiKey: string;
+    startingAfter?: number;
+    baseUrl?: string;
+    fetch?: TOpenAiFetch;
+    signal?: AbortSignal;
+}): Promise<TRetrievedResponse>;
+/**
+ * Cancel a stored, in-flight OpenAI response. Issues
+ * `POST /responses/{id}/cancel` and returns the resulting
+ * {@link TRetrievedResponse} (typically `status: "cancelled"`).
+ *
+ * Cancel is **idempotent** per the Responses API: cancelling twice, or
+ * cancelling an already-terminal response, simply returns the final
+ * `Response` object rather than erroring — so callers do not need to
+ * guard against double-cancel.
+ *
+ * Throws {@link ResponseNotFoundError} when the response is not found
+ * (HTTP 404 — typically the ~10-minute retention window elapsed).
+ * Honors `signal` (an abort propagates as an `AbortError`).
+ *
+ * Use this to stop an in-flight background response when a stage is
+ * abandoned (resync timeout) or an import is cancelled, so generation
+ * does not keep running (and billing) server-side after the consumer
+ * has given up on it.
+ *
+ * @param id - The OpenAI response id to cancel.
+ * @param options - `apiKey`, optional `baseUrl`, `fetch`, and `signal`.
+ */
+export declare function cancelResponse(id: string, options: {
+    apiKey: string;
+    baseUrl?: string;
+    fetch?: TOpenAiFetch;
+    signal?: AbortSignal;
+}): Promise<TRetrievedResponse>;
+/**
+ * Submit a background OpenAI response and return its `responseId` +
+ * submit-time `status` **without polling or streaming to completion**.
+ *
+ * This is the submit-only half of the existing `backgroundMode`
+ * (`runBackground`): it POSTs `{ background: true, store: true }`, parses
+ * the submit envelope, and returns immediately — the caller drives the
+ * response to completion later via {@link retrieveResponse} (typically
+ * after a durable suspend keyed on the returned `responseId`). It is the
+ * provider capability the pipeline's `launchStage` needs.
+ *
+ * **Terminal-on-submit fast-path:** a small/cached request can come back
+ * already terminal (`completed`/`failed`/`incomplete`/`cancelled`) on the
+ * submit POST. This function still returns `{ responseId, status }` for
+ * that case (no throw, no poll); the caller proceeds to
+ * `retrieveResponse(responseId)`, which sees the terminal state
+ * immediately.
+ *
+ * **No-tools precondition:** background mode does not support function
+ * tools in V1 — a tool-bearing request throws {@link NonRetryableLlmError},
+ * matching `respond`'s background guard.
+ *
+ * @param req - The structured-output request (system/user prompts +
+ *   `outputSchema` + model knobs). Tools are rejected.
+ * @param options - `apiKey`, optional `baseUrl`, `fetch`, and `signal`.
+ */
+export declare function submitBackgroundResponse<T>(req: TLlmRequest<T>, options: {
+    apiKey: string;
+    baseUrl?: string;
+    fetch?: TOpenAiFetch;
+    signal?: AbortSignal;
+}): Promise<{
+    responseId: string;
+    status: TResponseStatus;
+}>;
 //# sourceMappingURL=provider.d.ts.map

package/dist/extensions/openai/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/extensions/openai/provider.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EACR,YAAY,EAKf,MAAM,wBAAwB,CAAA;AAe/B,OAAO,KAAK,EACR,YAAY,EAMf,MAAM,YAAY,CAAA;AAOnB,MAAM,MAAM,qCAAqC,GAAG;IAChD,MAAM,EAAE,MAAM,CAAA;IACd,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;OAGG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAA;CACpC,CAAA;AAED,wBAAgB,6BAA6B,CACzC,OAAO,EAAE,qCAAqC,GAC/C,YAAY,CAuSd"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/extensions/openai/provider.ts"],"names":[],"mappings":"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"}