codex-chatgpt-control 0.5.1-alpha.2 → 0.5.1-alpha.3

package/dist/src/client.d.ts

@@ -6,6 +6,12 @@ import type { ChatGPTAgent, ChatGPTAgentConfig, ChatGPTResponse, ChatGPTRunner,
 import { type ChatGPTResponsesCreateArgs } from "./runner/responses.js";
 import { type ReportRedactionOptions } from "./safety/report-redaction.js";
 import { type BlockerExplanation, type ExplainBlockerOptions } from "./diagnostics/blockers.js";
+import { type OperationAdapterFactory, type OperationControlAdapterFactory, type OperationClientCollectOptions, type OperationClientControlOptions, type OperationClientRunOptions, type OperationClientSubmitOptions, type OperationHandleAdapterFactory } from "./operations/client.js";
+import { type OperationBrowserAdapter } from "./operations/service.js";
+import type { OperationControlRequestV1, OperationHandleV1, OperationSubmitRequestV1 } from "./operations/types.js";
+import type { CollectorResult } from "./operations/collector.js";
+import type { ControlResult } from "./operations/control.js";
+import type { OperationInspectResult, OperationRunResult, OperationSubmitResult } from "./operations/service.js";
 export type ChatGPTClientOptions = RuntimeEnv & {
     defaults?: {
         experience?: Exclude<ChatGPTExperience, "unknown">;
@@ -18,7 +24,36 @@ export type ChatGPTClientOptions = RuntimeEnv & {
     };
     limits?: Partial<RunLimits>;
     reporting?: RunReportOptions;
+    /** Additive transactional operation surface. Construction remains synchronous; journal opening is lazy. */
+    operations?: ChatGPTOperationsOptions;
 };
+/**
+ * Configuration for the additive transactional operation surface.
+ *
+ * The default state root is the platform application-state directory owned by
+ * `OperationJournal`. Set `stateRoot` explicitly when multiple cooperating
+ * clients must share a project-local journal. Browser adapters are opt-in:
+ * without one, durable inspection still works but browser-touching calls fail
+ * closed with an adapter blocker.
+ */
+export type ChatGPTOperationsOptions = Readonly<{
+    stateRoot?: string;
+    adapter?: OperationBrowserAdapter;
+    adapterFactory?: OperationAdapterFactory;
+    handleAdapterFactory?: OperationHandleAdapterFactory;
+    /** Fresh request-local adapter for Stop or Work steer; never cached. */
+    controlAdapterFactory?: OperationControlAdapterFactory;
+    maxCachedAdapters?: number;
+    maxCasRetries?: number;
+}>;
+/** Stable, lazily initialized facade exposed as `chatgpt.operations`. */
+export type ChatGPTOperations = Readonly<{
+    submit(request: OperationSubmitRequestV1, options?: OperationClientSubmitOptions): Promise<OperationSubmitResult>;
+    collect(handle: OperationHandleV1, options?: OperationClientCollectOptions): Promise<CollectorResult>;
+    inspect(handle: OperationHandleV1): Promise<OperationInspectResult>;
+    control(request: OperationControlRequestV1, options?: OperationClientControlOptions): Promise<ControlResult>;
+    run(request: OperationSubmitRequestV1, options?: OperationClientRunOptions): Promise<OperationRunResult>;
+}>;
 export type RunLimits = {
     maxPromptsPerRun: number;
     maxThreadsOpenedPerRun: number;
@@ -58,6 +93,8 @@ export type FileInput = string | {
 };
 export type AskWorkflowArgs = {
     prompt: string;
+    /** Caller-owned durable identity. Supplying it opts this invocation into the transactional operation path. */
+    operationId?: string;
     thread?: WorkflowThread;
     existingTab?: BootstrapArgs["existingTab"];
     preferExistingTab?: boolean;
@@ -107,6 +144,7 @@ export type ChatGPTClient = {
     agent<TOutput = string>(config: ChatGPTAgentConfig<TOutput>): ChatGPTAgent<TOutput>;
     run<TOutput = string>(agent: ChatGPTAgent<TOutput>, input: ChatGPTRunInput): Promise<ChatGPTRunResult<TOutput>>;
     runner: ChatGPTRunner;
+    operations: ChatGPTOperations;
     responses: {
         create(args: ChatGPTResponsesCreateArgs | Record<string, unknown>): Promise<ChatGPTResponse>;
     };