@jungjaehoon/mama-os 0.53.1 → 0.57.0

package/dist/agent/codex-app-server-process.d.ts

@@ -1,257 +0,0 @@
-import { type HostToolBridge, type PromptResult, type SessionPolicyStatus } from './model-runner.js';
-import type { PromptCallbacks } from './types.js';
-export interface CodexAppServerProcessOptions {
-    sessionKey: string;
-    model: string;
-    systemPrompt: string;
-    cwd: string;
-    sandbox: 'read-only' | 'workspace-write' | 'danger-full-access';
-    command?: string;
-    requestTimeout?: number;
-    codexHome?: string;
-    isolatedHome?: string;
-    registryRoot?: string;
-    mcpConfigPath?: string;
-    /** Managed `model_reasoning_effort`; unset means the built-in default, unknown values throw. */
-    effort?: string;
-    /** Stable identity/rules fingerprint; dynamic conversation context must be excluded. */
-    policyFingerprint?: string;
-    /** Observability sink for Codex-native subagent threads spawned by a parent turn. */
-    onSubagentEvent?: (event: SubagentEvent) => void;
-    /**
-     * Host factory for a CHILD-SCOPED authority. A child outlives the parent turn, so it
-     * must never inherit the parent's snapshot bridge (whose envelope expires with the
-     * parent wall). Called once per announced child; the child's tool calls are queued
-     * until it resolves. `null` (or no factory at all) means the child has no authority
-     * and every call it makes is refused with `subagent authority unavailable`.
-     */
-    createSubagentBridge?: (info: SubagentBridgeRequest) => Promise<SubagentBridge | null>;
-    /**
-     * Grace after the PARENT announced a child completed before the child's missing own
-     * `turn/completed` is reported as `unknown`. Test seam; the default is 5s.
-     */
-    subagentGraceMs?: number;
-    /** Bounded life of a registered child; a child Codex killed must not leak. */
-    subagentTtlMs?: number;
-}
-/** What the host is asked for when Codex announces a child thread. */
-export interface SubagentBridgeRequest {
-    /** The PARENT's session key; a child never owns a session of its own. */
-    sessionKey: string;
-    parentThreadId: string;
-    agentThreadId: string;
-    agentPath: string;
-}
-/**
- * One child's own authority: its tools and the release that closes its run.
- *
- * `release` is called exactly once per child, with the terminal status the process
- * observed. `unknown` means the parent announced a completion the child's own
- * `turn/completed` never confirmed - it is not success.
- */
-export interface SubagentBridge {
-    bridge: HostToolBridge;
-    release: (outcome: {
-        status: 'completed' | 'failed' | 'interrupted' | 'unknown';
-        error?: string;
-    }) => Promise<void>;
-}
-/**
- * One Codex-native subagent thread, observed from the parent thread.
- *
- * Codex announces children on the PARENT thread as `subAgentActivity` items and then
- * drives the child on ITS OWN thread id - including after the parent turn completed.
- * These events only report that; they never gate the child.
- */
-export interface SubagentEvent {
-    kind: 'started' | 'completed';
-    /** The PARENT's session key; a child never owns a session of its own. */
-    sessionKey: string;
-    parentThreadId: string;
-    agentThreadId: string;
-    /** Codex agent path, e.g. "/root/board". */
-    agentPath: string;
-    /**
-     * Completion events only. `unknown` is the honest verdict when the parent announced a
-     * completion and the child's own `turn/completed` never arrived: no result, no failure
-     * either. It must never be rendered as success.
-     */
-    status?: 'completed' | 'failed' | 'interrupted' | 'unknown';
-    /** Last `final_answer` agentMessage text seen on the child thread, bounded. */
-    finalText?: string;
-    /** Redacted failure message; failed child turns only. */
-    error?: string;
-}
-export interface CodexAppServerPromptOptions {
-    /**
-     * Per-run counted-token budget (input + output; codex reports input INCLUSIVE of cache,
-     * so cache reads are not added again). A codex turn is a whole
-     * agentic loop of model calls, so the budget is checked on every usage event INSIDE the
-     * turn and the turn is interrupted when it crosses; AgentLoop's per-turn check would only
-     * see the total after the turn ended (0.43.0 stopped board runs one turn too late).
-     */
-    runTokenBudget?: number;
-    sessionKey?: string;
-    model?: string;
-    systemPrompt?: string;
-    cwd?: string;
-    sandbox?: 'read-only' | 'workspace-write' | 'danger-full-access';
-    requestTimeout?: number;
-    policyFingerprint?: string;
-    resumeSession?: boolean;
-    hostToolBridge?: HostToolBridge;
-    /**
-     * Full instructions to re-supply when this call has to resume a durable thread.
-     * `thread/resume` accepts `baseInstructions` (ThreadResumeParams), so a rehydrated
-     * thread can be re-anchored through the protocol instead of the turn-text
-     * `<system-reminder>` workaround. Lazy on purpose: rebuilding the composed prompt
-     * costs an embedding search, and a live thread never resumes - the callback runs
-     * only inside the resume branch. Omit it to keep the legacy bootstrap behaviour.
-     */
-    resumeInstructions?: () => Promise<string>;
-    /** Measurement only: host lane and brief state for the per-turn [prompt] log line. */
-    promptTelemetry?: {
-        kind: string;
-        brief: 'sent' | 'omitted';
-    };
-}
-export declare class CodexAppServerProcess {
-    private readonly options;
-    private readonly registry;
-    private child;
-    private stdout;
-    private stderr;
-    private nextId;
-    private pending;
-    private lateTurnStarts;
-    private turnStartReconciliations;
-    private turns;
-    private readonly subagents;
-    /**
-     * Child threads that already reported a terminal status. The SAME `started`
-     * announcement arrives as both an item/started and an item/completed view, and the
-     * second view can land after the child's own turn/completed - `subagents.has` no longer
-     * dedupes it then, so it would mint a second authority and a second completion for a
-     * dead child. Bounded FIFO: identity of recent children, not a growing ledger.
-     */
-    private readonly finishedSubagents;
-    private readonly threadContexts;
-    private sessions;
-    private sessionQueues;
-    private connectionQueue;
-    private startPromise;
-    private shutdownPromise;
-    private stopped;
-    private stderrTail;
-    private secrets;
-    private authFingerprint;
-    private authFingerprintInitialized;
-    private authSourceSignature;
-    private managedConfigFingerprint;
-    private managedConfigSignature;
-    private secretLaunchFingerprint;
-    private secretLaunchFingerprintInitialized;
-    private killTimer;
-    private finalKillTimer;
-    constructor(options: CodexAppServerProcessOptions);
-    prompt(text: string, callbacks?: PromptCallbacks, overrides?: CodexAppServerPromptOptions): Promise<PromptResult>;
-    reset(sessionKey?: string): Promise<void>;
-    getSessionPolicyStatus(overrides?: CodexAppServerPromptOptions): SessionPolicyStatus;
-    stop(): Promise<void>;
-    executeSandboxedCommand(command: string, cwd: string, roots: readonly string[], signal?: AbortSignal): Promise<{
-        exitCode: number;
-        stdout: string;
-        stderr: string;
-    }>;
-    getThreadId(sessionKey?: string): string | undefined;
-    getStatus(): {
-        running: boolean;
-        childPid?: number;
-        pendingRequestCount: number;
-        hasActiveTurn: boolean;
-        stdoutListenerCount: number;
-        stderrListenerCount: number;
-        shutdownTimerActive: boolean;
-    };
-    private resolveSessionPolicy;
-    private enqueueSession;
-    private prepareConnection;
-    private assertRegistryPolicy;
-    private registryPolicyMatches;
-    private prepareManagedFiles;
-    private ensureStarted;
-    private start;
-    private openThread;
-    private policyFingerprint;
-    private validateInstructionMetadata;
-    private validateResponsePolicy;
-    private startTurn;
-    private request;
-    private requestOnce;
-    private notify;
-    private handleLine;
-    private handleNotification;
-    private resolveTurn;
-    /** Returns true when this notification belongs to the subagent surface and was consumed. */
-    private handleSubagentNotification;
-    private subagentFinalText;
-    /** A working child keeps the parent's idle timeout alive (the parent may be in wait_agent). */
-    private refreshParentTurnIdleTimeout;
-    /** Drop every thread context this session left behind on a previous thread id. */
-    private pruneThreadContexts;
-    private knownThreadIds;
-    private registerSubagent;
-    /**
-     * The parent says a child finished. That is an announcement, not a result: it can win
-     * the race against the child's own `turn/completed`, which is what carries status and
-     * final text. Wait a bounded grace for the real event, then report `unknown`.
-     */
-    private observeParentSideCompletion;
-    /**
-     * Emits exactly one completion per child thread and releases its authority with the
-     * same terminal status. Grandchildren keep their own entries.
-     */
-    private finishSubagent;
-    /** FIFO-bounded identity of finished children; the oldest id is forgotten first. */
-    private rememberFinishedSubagent;
-    private clearSubagentTimers;
-    private emitSubagentEvent;
-    /** Every live child is reported interrupted and its authority released. */
-    private terminateSubagents;
-    /** A reset/restart drops the thread's context and interrupts its children. */
-    private discardSessionThreadState;
-    private handleSubagentToolRequest;
-    private dispatchSubagentToolCall;
-    private reportSubagentToolComplete;
-    private isSubagentToolActive;
-    private handleServerRequest;
-    private handleDynamicToolRequest;
-    private failToolProtocol;
-    private requiredToolString;
-    private dispatchDynamicToolCall;
-    private isToolTurnActive;
-    private toolResult;
-    private replyDisabledTool;
-    private replyToolError;
-    private reply;
-    private handleStderr;
-    private redact;
-    private toError;
-    private refreshTurnIdleTimeout;
-    private failTurn;
-    /** Interrupt a turn whose counted usage crossed its run budget; the loop reports stoppedBy. */
-    private enforceTurnBudget;
-    private timeoutTurn;
-    private getOrCreateTurnStartReconciliation;
-    private completeTurnStartReconciliation;
-    private reconcileAcknowledgedTurn;
-    private handleLateTurnStartResponse;
-    private clearTurnCallbacks;
-    private failAll;
-    private failProcess;
-    private restart;
-    private shutdown;
-    private performShutdown;
-    private detach;
-}
-//# sourceMappingURL=codex-app-server-process.d.ts.map

package/dist/agent/codex-app-server-process.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"codex-app-server-process.d.ts","sourceRoot":"","sources":["../../src/agent/codex-app-server-process.ts"],"names":[],"mappings":"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"}