twinny 0.0.0-dev.260525150705

package/dist/codex/appserver.d.ts

@@ -0,0 +1,109 @@
+import { EventEmitter } from "node:events";
+import { type CodexThreadNameUpdate, type ProfileName } from "../types.js";
+import { CodexProtocolClient, type CodexNotificationMessage, type InitializeResponse } from "./protocol.js";
+import { type GoalResumeOptions, type GoalRunOptions, type ThreadGoal } from "./goal.js";
+import { type ThreadForkResponse, type ThreadResumeResponse, type ThreadStartResponse } from "./thread.js";
+import { type CodexTurnInput, type ThreadCompactStartOptions, type TurnStartOptions } from "./turn.js";
+export interface CodexAppServerOptions {
+    profile: ProfileName;
+    binary: string;
+    codexHome: string;
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    requestTimeoutMs?: number;
+    clientVersion?: string;
+    stopTimeoutMs?: number;
+}
+export interface ProfileCodexAppServerConfig {
+    profile: ProfileName;
+    codexHome: string;
+}
+export interface ProfileCodexAppServerPoolOptions {
+    binary: string;
+    profiles: Record<ProfileName, {
+        codexHome: string;
+    }>;
+    requestTimeoutMs?: number;
+    clientVersion?: string;
+    env?: NodeJS.ProcessEnv;
+}
+export interface CodexAppServerEvents {
+    stderr: [chunk: string];
+    notification: [message: CodexNotificationMessage];
+    threadNameUpdated: [update: CodexThreadNameUpdate];
+    exit: [code: number | null, signal: NodeJS.Signals | null];
+}
+export declare interface CodexAppServer {
+    on<K extends keyof CodexAppServerEvents>(event: K, listener: (...args: CodexAppServerEvents[K]) => void): this;
+    once<K extends keyof CodexAppServerEvents>(event: K, listener: (...args: CodexAppServerEvents[K]) => void): this;
+    off<K extends keyof CodexAppServerEvents>(event: K, listener: (...args: CodexAppServerEvents[K]) => void): this;
+    emit<K extends keyof CodexAppServerEvents>(event: K, ...args: CodexAppServerEvents[K]): boolean;
+}
+export declare class CodexAppServer extends EventEmitter {
+    private readonly options;
+    private child;
+    private protocolClient;
+    private initializeResponse;
+    private startPromise;
+    private codexVersion;
+    constructor(options: CodexAppServerOptions);
+    get protocol(): CodexProtocolClient;
+    get initialized(): InitializeResponse | undefined;
+    readCodexVersion(): string;
+    start(): Promise<InitializeResponse>;
+    private startFresh;
+    private attachProtocolNotifications;
+    startThread(cwd: string, options?: {
+        developerInstructions?: string;
+    }): Promise<ThreadStartResponse>;
+    resumeThread(threadId: string, cwd: string): Promise<ThreadResumeResponse>;
+    forkThread(threadId: string, cwd: string, options?: {
+        ephemeral?: boolean;
+        developerInstructions?: string;
+        model?: string;
+        effort?: string;
+    }): Promise<ThreadForkResponse>;
+    injectThreadItems(threadId: string, items: unknown[]): Promise<void>;
+    unsubscribeThread(threadId: string): Promise<void>;
+    setThreadName(threadId: string, name: string): Promise<void>;
+    startTurn(options: TurnStartOptions): Promise<import("../types.js").CodexTurnResult>;
+    compactThread(options: ThreadCompactStartOptions & {
+        cwd?: string;
+    }): Promise<import("../types.js").CodexTurnResult>;
+    steerTurn(options: {
+        threadId: string;
+        turnId: string;
+        text?: string;
+        input?: CodexTurnInput;
+    }): Promise<void>;
+    interruptTurn(options: {
+        threadId: string;
+        turnId: string;
+    }): Promise<void>;
+    readAccountRateLimits(): Promise<unknown>;
+    setThreadGoal(threadId: string, objective: string): Promise<ThreadGoal>;
+    getThreadGoal(threadId: string): Promise<ThreadGoal | null>;
+    clearThreadGoal(threadId: string): Promise<void>;
+    runGoal(options: GoalRunOptions): Promise<import("../types.js").CodexTurnResult>;
+    resumeGoal(options: GoalResumeOptions): Promise<import("../types.js").CodexTurnResult>;
+    stop(signal?: NodeJS.Signals): Promise<void>;
+    private prepareThreadWorkspace;
+    private profileName;
+    private readCodexBinaryVersionBestEffort;
+}
+export declare class ProfileCodexAppServerPool {
+    private readonly options;
+    private readonly servers;
+    constructor(options: ProfileCodexAppServerPoolOptions);
+    startAll(): Promise<Record<ProfileName, InitializeResponse>>;
+    get(profile: ProfileName): CodexAppServer;
+    listProfiles(): ProfileName[];
+    replace(profile: ProfileName, config: {
+        binary?: string;
+        codexHome: string;
+    }): CodexAppServer;
+    remove(profile: ProfileName, signal?: NodeJS.Signals): Promise<void>;
+    restart(profile: ProfileName): Promise<InitializeResponse>;
+    stopAll(signal?: NodeJS.Signals): Promise<void>;
+}
+export declare function buildCodexAppServerEnv(codexHome: string, source?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;

package/dist/codex/appserver.js

@@ -0,0 +1,308 @@
+import { spawn } from "node:child_process";
+import { EventEmitter } from "node:events";
+import path from "node:path";
+import { execa } from "execa";
+import { ensureGuestWorkspaceTrust, ensureProjectTrust } from "../profiles/index.js";
+import { GUEST_PROFILE_NAME } from "../types.js";
+import { CodexProtocolClient, createInitializeParams } from "./protocol.js";
+import { parseCodexThreadNameUpdatedNotification } from "./thread-name.js";
+import { clearCodexThreadGoal, getCodexThreadGoal, resumeCodexThreadGoal, runCodexThreadGoal, setCodexThreadGoal } from "./goal.js";
+import { forkCodexThread, injectCodexThreadItems, resumeCodexThread, setCodexThreadName, startCodexThread, unsubscribeCodexThread } from "./thread.js";
+import { compactCodexThread, interruptCodexTurn, startCodexTurn, steerCodexTurn } from "./turn.js";
+export class CodexAppServer extends EventEmitter {
+    options;
+    child;
+    protocolClient;
+    initializeResponse;
+    startPromise;
+    codexVersion;
+    constructor(options) {
+        super();
+        this.options = options;
+    }
+    get protocol() {
+        if (!this.protocolClient) {
+            throw new Error("Codex app-server is not started");
+        }
+        return this.protocolClient;
+    }
+    get initialized() {
+        return this.initializeResponse;
+    }
+    readCodexVersion() {
+        return this.codexVersion ?? "不可用";
+    }
+    async start() {
+        if (this.protocolClient && this.initializeResponse) {
+            return this.initializeResponse;
+        }
+        if (this.startPromise) {
+            return this.startPromise;
+        }
+        this.startPromise = this.startFresh();
+        try {
+            return await this.startPromise;
+        }
+        finally {
+            this.startPromise = undefined;
+        }
+    }
+    async startFresh() {
+        const codexVersion = await this.readCodexBinaryVersionBestEffort();
+        if (this.protocolClient) {
+            this.initializeResponse = await this.protocolClient.initialize(createInitializeParams(this.options.clientVersion));
+            this.codexVersion = codexVersion;
+            return this.initializeResponse;
+        }
+        const child = spawn(this.options.binary, ["app-server", "--listen", "stdio://"], {
+            cwd: this.options.cwd ?? process.cwd(),
+            env: buildCodexAppServerEnv(this.options.codexHome, this.options.env ?? process.env),
+            stdio: ["pipe", "pipe", "pipe"]
+        });
+        child.stderr.setEncoding("utf8");
+        child.stderr.on("data", (chunk) => this.emit("stderr", chunk));
+        const protocol = new CodexProtocolClient(child.stdout, child.stdin, {
+            requestTimeoutMs: this.options.requestTimeoutMs,
+            requestIdPrefix: `twinny-${this.profileName()}`
+        });
+        this.attachProtocolNotifications(protocol);
+        this.child = child;
+        this.protocolClient = protocol;
+        this.initializeResponse = undefined;
+        child.on("exit", (code, signal) => {
+            if (this.child === child) {
+                this.child = undefined;
+            }
+            if (this.protocolClient === protocol) {
+                this.protocolClient = undefined;
+                this.initializeResponse = undefined;
+            }
+            this.emit("exit", code, signal);
+        });
+        protocol.start();
+        this.initializeResponse = await protocol.initialize(createInitializeParams(this.options.clientVersion));
+        this.codexVersion = codexVersion;
+        return this.initializeResponse;
+    }
+    attachProtocolNotifications(protocol) {
+        protocol.on("notification", (message) => {
+            this.emit("notification", message);
+            const update = parseCodexThreadNameUpdatedNotification(message);
+            if (update) {
+                this.emit("threadNameUpdated", update);
+            }
+        });
+    }
+    async startThread(cwd, options = {}) {
+        await this.prepareThreadWorkspace(cwd);
+        return startCodexThread(this.protocol, { cwd, developerInstructions: options.developerInstructions });
+    }
+    async resumeThread(threadId, cwd) {
+        await this.prepareThreadWorkspace(cwd);
+        return resumeCodexThread(this.protocol, threadId, { cwd });
+    }
+    async forkThread(threadId, cwd, options = {}) {
+        await this.prepareThreadWorkspace(cwd);
+        return forkCodexThread(this.protocol, threadId, { cwd, ...options });
+    }
+    async injectThreadItems(threadId, items) {
+        await injectCodexThreadItems(this.protocol, { threadId, items });
+    }
+    async unsubscribeThread(threadId) {
+        await unsubscribeCodexThread(this.protocol, threadId);
+    }
+    async setThreadName(threadId, name) {
+        await setCodexThreadName(this.protocol, { threadId, name });
+    }
+    async startTurn(options) {
+        return startCodexTurn(this.protocol, options, { requestTimeoutMs: this.options.requestTimeoutMs });
+    }
+    async compactThread(options) {
+        if (options.cwd) {
+            await this.prepareThreadWorkspace(options.cwd);
+        }
+        return compactCodexThread(this.protocol, options, { requestTimeoutMs: this.options.requestTimeoutMs });
+    }
+    async steerTurn(options) {
+        await steerCodexTurn(this.protocol, options);
+    }
+    async interruptTurn(options) {
+        await interruptCodexTurn(this.protocol, options);
+    }
+    async readAccountRateLimits() {
+        return this.protocol.request("account/rateLimits/read");
+    }
+    async setThreadGoal(threadId, objective) {
+        return setCodexThreadGoal(this.protocol, { threadId, objective }, { requestTimeoutMs: this.options.requestTimeoutMs });
+    }
+    async getThreadGoal(threadId) {
+        return getCodexThreadGoal(this.protocol, threadId, { requestTimeoutMs: this.options.requestTimeoutMs });
+    }
+    async clearThreadGoal(threadId) {
+        await clearCodexThreadGoal(this.protocol, threadId, { requestTimeoutMs: this.options.requestTimeoutMs });
+    }
+    async runGoal(options) {
+        return runCodexThreadGoal(this.protocol, options, { requestTimeoutMs: this.options.requestTimeoutMs });
+    }
+    async resumeGoal(options) {
+        if (options.cwd) {
+            await this.prepareThreadWorkspace(options.cwd);
+        }
+        return resumeCodexThreadGoal(this.protocol, options, { requestTimeoutMs: this.options.requestTimeoutMs });
+    }
+    async stop(signal = "SIGTERM") {
+        const child = this.child;
+        this.protocolClient?.close();
+        this.protocolClient = undefined;
+        this.initializeResponse = undefined;
+        if (!child) {
+            return;
+        }
+        const gracefulExit = waitForChildExit(child, this.options.stopTimeoutMs ?? 3_000);
+        if (!hasExited(child) && !child.killed) {
+            child.kill(signal);
+        }
+        const stopped = await gracefulExit;
+        if (!stopped && !hasExited(child)) {
+            child.kill("SIGKILL");
+            await waitForChildExit(child, 2_000);
+        }
+        if (this.child === child) {
+            this.child = undefined;
+        }
+    }
+    async prepareThreadWorkspace(cwd) {
+        if (this.options.profile === GUEST_PROFILE_NAME) {
+            await ensureGuestWorkspaceTrust(this.options.codexHome, cwd);
+            return;
+        }
+        await ensureProjectTrust(this.options.codexHome, cwd);
+    }
+    profileName() {
+        return this.options.profile;
+    }
+    async readCodexBinaryVersionBestEffort() {
+        try {
+            const result = await execa(this.options.binary, ["--version"], {
+                env: buildCodexAppServerEnv(this.options.codexHome, this.options.env ?? process.env),
+                reject: false,
+                timeout: 1000
+            });
+            const version = result.stdout.trim() || result.stderr.trim();
+            return result.exitCode === 0 && version ? version : "不可用";
+        }
+        catch {
+            return "不可用";
+        }
+    }
+}
+export class ProfileCodexAppServerPool {
+    options;
+    servers = new Map();
+    constructor(options) {
+        this.options = options;
+        const profiles = options.profiles;
+        for (const profile of Object.keys(profiles)) {
+            this.servers.set(profile, new CodexAppServer({
+                profile,
+                binary: options.binary,
+                codexHome: profiles[profile].codexHome,
+                env: options.env,
+                requestTimeoutMs: options.requestTimeoutMs,
+                clientVersion: options.clientVersion
+            }));
+        }
+    }
+    async startAll() {
+        const entries = await Promise.all(Array.from(this.servers.entries(), async ([profile, server]) => [profile, await server.start()]));
+        return Object.fromEntries(entries);
+    }
+    get(profile) {
+        const server = this.servers.get(profile);
+        if (!server) {
+            throw new Error(`No Codex app-server configured for profile ${profile}`);
+        }
+        return server;
+    }
+    listProfiles() {
+        return [...this.servers.keys()];
+    }
+    replace(profile, config) {
+        const server = new CodexAppServer({
+            profile,
+            binary: config.binary ?? this.options.binary,
+            codexHome: config.codexHome,
+            env: this.options.env,
+            requestTimeoutMs: this.options.requestTimeoutMs,
+            clientVersion: this.options.clientVersion
+        });
+        this.servers.set(profile, server);
+        return server;
+    }
+    async remove(profile, signal = "SIGTERM") {
+        const server = this.servers.get(profile);
+        if (!server) {
+            return;
+        }
+        this.servers.delete(profile);
+        await server.stop(signal);
+    }
+    async restart(profile) {
+        const server = this.get(profile);
+        await server.stop();
+        return server.start();
+    }
+    async stopAll(signal = "SIGTERM") {
+        await Promise.all(Array.from(this.servers.values(), (server) => server.stop(signal)));
+    }
+}
+function hasExited(child) {
+    return child.exitCode !== null || child.signalCode !== null;
+}
+function waitForChildExit(child, timeoutMs) {
+    if (hasExited(child)) {
+        return Promise.resolve(true);
+    }
+    return new Promise((resolve) => {
+        const timeout = setTimeout(() => {
+            cleanup();
+            resolve(false);
+        }, timeoutMs);
+        timeout.unref?.();
+        const onExit = () => {
+            cleanup();
+            resolve(true);
+        };
+        const cleanup = () => {
+            clearTimeout(timeout);
+            child.off("exit", onExit);
+        };
+        child.once("exit", onExit);
+    });
+}
+export function buildCodexAppServerEnv(codexHome, source = process.env) {
+    const env = {};
+    copyEnv(source, env, "PATH");
+    copyEnv(source, env, "HOME");
+    copyEnv(source, env, "USER");
+    copyEnv(source, env, "LOGNAME");
+    copyEnv(source, env, "SHELL");
+    copyEnv(source, env, "TMPDIR");
+    copyEnv(source, env, "LANG");
+    copyEnv(source, env, "LC_ALL");
+    copyEnv(source, env, "LC_CTYPE");
+    copyEnv(source, env, "TERM");
+    env.PATH = env.PATH ?? defaultPath();
+    env.CODEX_HOME = path.resolve(codexHome);
+    env.NO_COLOR = source.NO_COLOR ?? "1";
+    return env;
+}
+function copyEnv(source, target, key) {
+    if (source[key] !== undefined) {
+        target[key] = source[key];
+    }
+}
+function defaultPath() {
+    return ["/opt/homebrew/bin", "/usr/local/bin", "/usr/bin", "/bin", "/usr/sbin", "/sbin"].join(":");
+}
+//# sourceMappingURL=appserver.js.map

package/dist/codex/appserver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appserver.js","sourceRoot":"","sources":["../../src/codex/appserver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAuC,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAgD,MAAM,aAAa,CAAC;AAC/F,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAA0D,MAAM,eAAe,CAAC;AACpI,OAAO,EAAE,uCAAuC,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAInB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EAIvB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,cAAc,EAIf,MAAM,WAAW,CAAC;AAiDnB,MAAM,OAAO,cAAe,SAAQ,YAAY;IAOjB;IANrB,KAAK,CAA6C;IAClD,cAAc,CAAkC;IAChD,kBAAkB,CAAiC;IACnD,YAAY,CAA0C;IACtD,YAAY,CAAqB;IAEzC,YAA6B,OAA8B;QACzD,KAAK,EAAE,CAAC;QADmB,YAAO,GAAP,OAAO,CAAuB;IAE3D,CAAC;IAED,IAAI,QAAQ;QACV,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAED,gBAAgB;QACd,OAAO,IAAI,CAAC,YAAY,IAAI,KAAK,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACnD,OAAO,IAAI,CAAC,kBAAkB,CAAC;QACjC,CAAC;QACD,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC,YAAY,CAAC;QAC3B,CAAC;QAED,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QACtC,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC;QACjC,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;QAChC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,UAAU;QACtB,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,gCAAgC,EAAE,CAAC;QAEnE,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,IAAI,CAAC,kBAAkB,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;YACnH,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;YACjC,OAAO,IAAI,CAAC,kBAAkB,CAAC;QACjC,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,YAAY,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE;YAC/E,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;YACtC,GAAG,EAAE,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;YACpF,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QAEH,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACjC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;QAEvE,MAAM,QAAQ,GAAG,IAAI,mBAAmB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE;YAClE,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAAC,gBAAgB;YAC/C,eAAe,EAAE,UAAU,IAAI,CAAC,WAAW,EAAE,EAAE;SAChD,CAAC,CAAC;QACH,IAAI,CAAC,2BAA2B,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,cAAc,GAAG,QAAQ,CAAC;QAC/B,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC;QACpC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YAChC,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;gBACzB,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;YACzB,CAAC;YACD,IAAI,IAAI,CAAC,cAAc,KAAK,QAAQ,EAAE,CAAC;gBACrC,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;gBAChC,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC;YACtC,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QACH,QAAQ,CAAC,KAAK,EAAE,CAAC;QAEjB,IAAI,CAAC,kBAAkB,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;QACxG,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAEO,2BAA2B,CAAC,QAA6B;QAC/D,QAAQ,CAAC,EAAE,CAAC,cAAc,EAAE,CAAC,OAAO,EAAE,EAAE;YACtC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;YACnC,MAAM,MAAM,GAAG,uCAAuC,CAAC,OAAO,CAAC,CAAC;YAChE,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;YACzC,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,GAAW,EAAE,UAA8C,EAAE;QAC7E,MAAM,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;QACvC,OAAO,gBAAgB,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,qBAAqB,EAAE,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC;IACxG,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,QAAgB,EAAE,GAAW;QAC9C,MAAM,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;QACvC,OAAO,iBAAiB,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,UAAU,CACd,QAAgB,EAChB,GAAW,EACX,UAAoG,EAAE;QAEtG,MAAM,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;QACvC,OAAO,eAAe,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,QAAgB,EAAE,KAAgB;QACxD,MAAM,sBAAsB,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,QAAgB;QACtC,MAAM,sBAAsB,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,QAAgB,EAAE,IAAY;QAChD,MAAM,kBAAkB,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAyB;QACvC,OAAO,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACrG,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAqD;QACvE,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAChB,MAAM,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,kBAAkB,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACzG,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAoF;QAClG,MAAM,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAA6C;QAC/D,MAAM,kBAAkB,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,qBAAqB;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,QAAgB,EAAE,SAAiB;QACrD,OAAO,kBAAkB,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACzH,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,QAAgB;QAClC,OAAO,kBAAkB,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC1G,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,QAAgB;QACpC,MAAM,oBAAoB,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC3G,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAuB;QACnC,OAAO,kBAAkB,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACzG,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAA0B;QACzC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAChB,MAAM,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,qBAAqB,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC5G,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAyB,SAAS;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,IAAI,CAAC,cAAc,EAAE,KAAK,EAAE,CAAC;QAC7B,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;QAChC,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC;QAEpC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;QACT,CAAC;QAED,MAAM,YAAY,GAAG,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa,IAAI,KAAK,CAAC,CAAC;QAClF,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC;QACnC,IAAI,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACtB,MAAM,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACzB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,sBAAsB,CAAC,GAAW;QAC9C,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,KAAK,kBAAkB,EAAE,CAAC;YAChD,MAAM,yBAAyB,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YAC7D,OAAO;QACT,CAAC;QACD,MAAM,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACxD,CAAC;IAEO,WAAW;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;IAC9B,CAAC;IAEO,KAAK,CAAC,gCAAgC;QAC5C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,EAAE;gBAC7D,GAAG,EAAE,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;gBACpF,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAC7D,OAAO,MAAM,CAAC,QAAQ,KAAK,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;QAC5D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF;AAED,MAAM,OAAO,yBAAyB;IAGP;IAFZ,OAAO,GAAG,IAAI,GAAG,EAA+B,CAAC;IAElE,YAA6B,OAAyC;QAAzC,YAAO,GAAP,OAAO,CAAkC;QACpE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QAClC,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5C,IAAI,CAAC,OAAO,CAAC,GAAG,CACd,OAAO,EACP,IAAI,cAAc,CAAC;gBACjB,OAAO;gBACP,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,SAAS;gBACtC,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;gBAC1C,aAAa,EAAE,OAAO,CAAC,aAAa;aACrC,CAAC,CACH,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,MAAM,CAAC,KAAK,EAAE,CAAU,CAAC,CAC1G,CAAC;QACF,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,GAAG,CAAC,OAAoB;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,8CAA8C,OAAO,EAAE,CAAC,CAAC;QAC3E,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,YAAY;QACV,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,CAAC,OAAoB,EAAE,MAA8C;QAC1E,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;YAChC,OAAO;YACP,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM;YAC5C,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG;YACrB,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAAC,gBAAgB;YAC/C,aAAa,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa;SAC1C,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAClC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAoB,EAAE,SAAyB,SAAS;QACnE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7B,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAoB;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACjC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,OAAO,MAAM,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,SAAyB,SAAS;QAC9C,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACxF,CAAC;CACF;AAED,SAAS,SAAS,CAAC,KAAqC;IACtD,OAAO,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;AAC9D,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAqC,EAAE,SAAiB;IAChF,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,EAAE,SAAS,CAAC,CAAC;QACd,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;QAElB,MAAM,MAAM,GAAG,GAAS,EAAE;YACxB,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC5B,CAAC,CAAC;QAEF,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,SAAiB,EAAE,SAA4B,OAAO,CAAC,GAAG;IAC/F,MAAM,GAAG,GAAsB,EAAE,CAAC;IAClC,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;IACjC,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAE7B,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,WAAW,EAAE,CAAC;IACrC,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACzC,GAAG,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,GAAG,CAAC;IACtC,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,OAAO,CAAC,MAAyB,EAAE,MAAyB,EAAE,GAAW;IAChF,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,SAAS,WAAW;IAClB,OAAO,CAAC,mBAAmB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACrG,CAAC"}

package/dist/codex/goal.d.ts

@@ -0,0 +1,64 @@
+import type { CodexAgentMessage, CodexRequestUserInputRequest, CodexThreadTokenUsageUpdate, CodexTurnResult } from "../types.js";
+import type { CodexDynamicToolCallResponse, CodexRequestUserInputResponder, CodexSetThreadNameToolRequest } from "./turn.js";
+import type { CodexProtocolClient } from "./protocol.js";
+import { type ThreadRuntimeOptions } from "./thread.js";
+export type ThreadGoalStatus = "active" | "paused" | "blocked" | "usageLimited" | "budgetLimited" | "complete";
+export interface ThreadGoal {
+    threadId: string;
+    objective: string;
+    status: ThreadGoalStatus;
+    tokenBudget: number | null;
+    tokensUsed: number;
+    timeUsedSeconds: number;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface ThreadGoalSetParams {
+    threadId: string;
+    objective?: string | null;
+    status?: ThreadGoalStatus | null;
+    tokenBudget?: number | null;
+}
+export interface ThreadGoalSetResponse {
+    goal: ThreadGoal;
+}
+export interface ThreadGoalGetParams {
+    threadId: string;
+}
+export interface ThreadGoalGetResponse {
+    goal: ThreadGoal | null;
+}
+export interface ThreadGoalClearParams {
+    threadId: string;
+}
+export interface GoalRunOptions {
+    threadId: string;
+    objective?: string;
+    onTurnStarted?: (turnId: string) => Promise<void> | void;
+    onAgentMessage?: (message: CodexAgentMessage) => Promise<void> | void;
+    onTokenUsage?: (usage: CodexThreadTokenUsageUpdate) => Promise<void> | void;
+    onGoalUpdated?: (goal: ThreadGoal, turnId: string | null) => Promise<void> | void;
+    onGoalCleared?: () => Promise<void> | void;
+    onRequestUserInput?: (request: CodexRequestUserInputRequest, responder: CodexRequestUserInputResponder) => Promise<void> | void;
+    onSetThreadName?: (request: CodexSetThreadNameToolRequest) => Promise<CodexDynamicToolCallResponse> | CodexDynamicToolCallResponse;
+}
+export interface GoalResumeOptions extends GoalRunOptions, ThreadRuntimeOptions {
+    objective?: undefined;
+}
+export interface GoalRequestOptions {
+    requestTimeoutMs?: number;
+    completionTimeoutMs?: number;
+}
+export declare function buildThreadGoalSetParams(options: {
+    threadId: string;
+    objective: string;
+}): ThreadGoalSetParams;
+export declare function setCodexThreadGoal(protocol: CodexProtocolClient, options: {
+    threadId: string;
+    objective: string;
+}, requestOptions?: GoalRequestOptions): Promise<ThreadGoal>;
+export declare function getCodexThreadGoal(protocol: CodexProtocolClient, threadId: string, requestOptions?: GoalRequestOptions): Promise<ThreadGoal | null>;
+export declare function clearCodexThreadGoal(protocol: CodexProtocolClient, threadId: string, requestOptions?: GoalRequestOptions): Promise<void>;
+export declare function runCodexThreadGoal(protocol: CodexProtocolClient, options: GoalRunOptions, requestOptions?: GoalRequestOptions): Promise<CodexTurnResult>;
+export declare function resumeCodexThreadGoal(protocol: CodexProtocolClient, options: GoalResumeOptions, requestOptions?: GoalRequestOptions): Promise<CodexTurnResult>;
+export declare function isThreadGoal(value: unknown): value is ThreadGoal;