@mearl/agent-runtime 0.0.0-stage → 2.22.0

package/README.md

@@ -1,3 +1,9 @@
-# Temporary Holding Version
+# @mearl/agent-runtime
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+本机 Codex app-server 与 Qoder ACP 的共享 Provider，以及受管理的一次性模型执行适配。
+
+侧边栏会话由 native-host 持有；后台模型由 client 的独立执行器持有。此包从 browser-core 生成独立协议，只依赖 daemon-core 和 Provider SDK，不依赖 client、setup 或 native-host，避免安装器与执行宿主形成运行时依赖环。
+
+生成协议集中在 `src/generated/`，由根目录 `pnpm run generate:client-action-protocol` 同步；修改协议时更新 browser-core 源文件。
+
+`runCodexModel` 每次拥有独立 Provider 进程，只提供 capabilities 中声明的只读 Agent 模式；宿主负责结构化结果校验、任务持久化和进程树终止。纯生成模式需 Provider 提供可靠的无工具执行能力后才能加入。

package/dist/capabilities.d.ts

@@ -0,0 +1,2 @@
+import type { PluginModelCapability } from './generated/plugin-models.js';
+export declare const CODEX_MODEL_CAPABILITY: PluginModelCapability;

package/dist/capabilities.js

@@ -0,0 +1,8 @@
+export const CODEX_MODEL_CAPABILITY = {
+    provider: 'codex',
+    modes: ['agent'],
+    permissions: ['read-only'],
+    structuredOutput: true,
+    streaming: true,
+    cancellation: true,
+};

package/dist/codex-provider.d.ts

@@ -0,0 +1,73 @@
+import type { PluginModelOption } from './generated/plugin-models.js';
+import type { AgentInstalledSkill } from './generated/agent-skills.js';
+import type { AgentChatImageInput, AgentChatModelInfo, AgentChatProviderDescriptor } from './generated/agent-chat.js';
+import type { AgentProvider, AgentProviderEvent, AgentProviderListSessionsOptions, AgentProviderListSessionsResult, AgentProviderResumeResult, AgentProviderSessionOptions, AgentProviderTurnOptions } from './provider.js';
+interface CodexExecutableCandidateOptions {
+    env?: NodeJS.ProcessEnv;
+    homedir?: () => string;
+    platform?: NodeJS.Platform;
+    processExecPath?: string;
+    readdirSync?: typeof import('node:fs').readdirSync;
+}
+export declare function normalizeCodexVersion(value: unknown): string | null;
+export declare function compareCodexVersions(leftValue: string, rightValue: string): number;
+export declare function codexAppExecutableCandidatePaths(options?: Pick<CodexExecutableCandidateOptions, 'env' | 'homedir' | 'platform'>): string[];
+export declare function codexExecutableCandidatePaths(options?: CodexExecutableCandidateOptions): string[];
+export declare function codexThreadUrl(providerSessionId: string): string;
+export declare function codexWorkspaceUrl(directory: string): string;
+export declare function externalOpenCommand(url: string, platform?: NodeJS.Platform): {
+    command: string;
+    args: string[];
+};
+export declare class CodexAgentProvider implements AgentProvider {
+    private readonly log;
+    private readonly clientVersion;
+    private readonly mearlSocketPath?;
+    readonly id = "codex";
+    private process;
+    private initialized;
+    private lifecycle;
+    private modelRuntime?;
+    private startPromise;
+    private nextRequestId;
+    private pendingRequests;
+    private listeners;
+    private knownThreadIds;
+    private sessionModels;
+    private readonly executableResolver;
+    constructor(log: (...args: any[]) => void, clientVersion: string, mearlSocketPath?: string | undefined);
+    getDescriptor(): Promise<AgentChatProviderDescriptor>;
+    prepare(): Promise<void>;
+    listModels(): Promise<PluginModelOption[]>;
+    onEvent(listener: (event: AgentProviderEvent) => void): () => void;
+    listSessions(options: AgentProviderListSessionsOptions): Promise<AgentProviderListSessionsResult>;
+    listSkills(cwd?: string): Promise<AgentInstalledSkill[]>;
+    startSession(options: AgentProviderSessionOptions): Promise<string>;
+    private modelExecutionConfig;
+    resumeSession(providerSessionId: string, options: AgentProviderSessionOptions): Promise<AgentProviderResumeResult>;
+    getSessionModel(providerSessionId: string): AgentChatModelInfo | undefined;
+    sendMessage(providerSessionId: string, message: string, images?: AgentChatImageInput[], options?: AgentProviderTurnOptions): Promise<{
+        turnId: string;
+    }>;
+    interrupt(providerSessionId: string, turnId: string): Promise<void>;
+    closeSession(providerSessionId: string): Promise<void>;
+    openSession(providerSessionId: string): Promise<void>;
+    openWorkspace(cwd: string): Promise<void>;
+    respondToRequest(requestId: string | number, result: unknown): void;
+    dispose(): void;
+    private ensureStarted;
+    private start;
+    private handleLine;
+    private request;
+    private write;
+    private handleExit;
+    private rejectPending;
+    private modelDiagnostic;
+    private emit;
+    private extractThreadId;
+    private probeExecutable;
+    private readExecutableVersion;
+    private resolveExecutable;
+    private resolveExecutableCandidates;
+}
+export {};