@mearl/agent-runtime 3.0.0-beta.8 → 3.0.0

package/README.en.md

@@ -0,0 +1,11 @@
+# @mearl/agent-runtime
+
+[简体中文](README.md) | [English](README.en.md)
+
+Local Codex app-server integration, generic Agent Provider contracts, and managed one-shot model execution. Qoder ACP is supplied by the optional [`@mearl/plugin-qoder`](../plugin-qoder/README.en.md).
+
+This package provides independently usable local Agent adapters, model calls, and sessions. It depends on daemon-core, browser-core's protocol-only contracts, and public Provider SDKs, without depending on the browser extension, installer, or browser execution host.
+
+Model, session, and Skill type contracts are maintained by browser-core and imported through protocol-only subpaths. This package also publicly exports them. Browser UIs and other consumers should reuse the public contracts instead of maintaining duplicate definitions.
+
+Each `runCodexModel` call owns an independent Provider process and exposes only the read-only Agent mode declared in its capabilities. The host validates structured results, persists tasks, and terminates process trees. A pure generation mode requires a Provider with reliable tool-free execution support.

package/README.md

@@ -1,5 +1,7 @@
 # @mearl/agent-runtime
 
+[简体中文](README.md) | [English](README.en.md)
+
 本机 Codex app-server、通用 Agent Provider 合同与受管理的一次性模型执行适配。Qoder ACP 由可选的 [`@mearl/plugin-qoder`](../plugin-qoder/README.md) 提供。
 
 此包提供可独立使用的本地 Agent 适配、模型调用和会话能力，依赖 daemon-core、browser-core 的纯协议合同和公开 Provider SDK，不依赖浏览器扩展、安装器或浏览器执行宿主。

package/dist/execution.d.ts

@@ -1,2 +1,3 @@
 export * from './executable-resolver.js';
 export * from './process-env.js';
+export * from './qoder-executable.js';

package/dist/execution.js

@@ -1,2 +1,3 @@
 export * from './executable-resolver.js';
 export * from './process-env.js';
+export * from './qoder-executable.js';

package/dist/qoder-executable.d.ts

@@ -0,0 +1,10 @@
+import fs from 'node:fs';
+interface QoderExecutableCandidateOptions {
+    env?: NodeJS.ProcessEnv;
+    homedir?: () => string;
+    platform?: NodeJS.Platform;
+    processExecPath?: string;
+    readdirSync?: typeof fs.readdirSync;
+}
+export declare function qoderExecutableCandidatePaths(options?: QoderExecutableCandidateOptions): string[];
+export {};

package/dist/qoder-executable.js

@@ -0,0 +1,35 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { agentExecutableCandidatePaths } from './executable-resolver.js';
+function qoderManagedExecutableCandidates(home, readdirSync = fs.readdirSync) {
+    const directory = path.join(home, '.qoder', 'bin', 'qodercli');
+    try {
+        return readdirSync(directory, { withFileTypes: true })
+            .filter(entry => entry.isFile() && entry.name.startsWith('qodercli-'))
+            .sort((left, right) => right.name.localeCompare(left.name, undefined, { numeric: true }))
+            .map(entry => path.join(directory, entry.name));
+    }
+    catch {
+        return [];
+    }
+}
+export function qoderExecutableCandidatePaths(options = {}) {
+    const env = options.env ?? process.env;
+    const home = (options.homedir ?? os.homedir)();
+    const platform = options.platform ?? process.platform;
+    const executableNames = platform === 'win32' ? ['qodercli.exe', 'qodercli.cmd'] : ['qodercli'];
+    return agentExecutableCandidatePaths({
+        executableNames,
+        configuredPath: env.MEARL_QODER_PATH,
+        env,
+        extraUserCandidates: [
+            ...qoderManagedExecutableCandidates(home, options.readdirSync),
+            ...executableNames.map(name => path.join(home, '.qoder', 'bin', name)),
+        ],
+        home,
+        platform,
+        processExecPath: options.processExecPath,
+        readdirSync: options.readdirSync,
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mearl/agent-runtime",
-  "version": "3.0.0-beta.8",
+  "version": "3.0.0",
   "description": "Shared local agent provider runtimes for Mearl",
   "type": "module",
   "main": "dist/index.js",
@@ -24,6 +24,7 @@
     }
   },
   "files": [
+    "README.en.md",
     "dist",
     "!dist/**/*.map"
   ],
@@ -35,8 +36,8 @@
     "registry": "https://registry.npmjs.org"
   },
   "dependencies": {
-    "@mearl/daemon-core": "3.0.0-beta.8",
-    "@mearl/browser-core": "3.0.0-beta.8"
+    "@mearl/daemon-core": "3.0.0",
+    "@mearl/browser-core": "3.0.0"
   },
   "devDependencies": {
     "@types/node": "^24.9.1",