@beeos-ai/device-agent 0.9.13 → 0.10.1

package/dist/config/schema.js

@@ -8,18 +8,12 @@
  *
  * The agent runs as a two-layer system by default:
  *
- *   - **outer** orchestrator     — text LLM via pi-coding-agent
- *                                  (default `moonshotai/kimi-k2.6` on ARouter)
- *   - **mobileUse** inner VLM    — vision-language device control loop
- *                                  (default `AutoGLM-Phone-9B-Q4_K_M.gguf` with
- *                                  the `autoglm` adapter)
- *   - **grounder** visual ground — coordinate grounding tool used by the outer
- *                                  layer when it needs precise tap targets.
- *                                  Defaults to mirroring `mobileUse` so a
- *                                  fully self-hosted setup still works.
+ *   - **outer** orchestrator  — text LLM via pi-coding-agent
+ *                               (default `moonshotai/kimi-k2.6` on ARouter)
+ *   - **vlm** inner VLM       — vision-language device control loop
+ *                               (default `AutoGLM-Phone-9B-Q4_K_M.gguf` with
+ *                               the `autoglm` adapter)
  *
- * The legacy single-layer mode is still available via `legacyInner: true`
- * (or `--legacy-inner`) — that path drives `vlm-inner-loop.ts` directly.
  */
 import { z } from "zod";
 export const RuntimeMode = z.enum(["android", "desktop"]);
@@ -44,7 +38,7 @@ export const DEFAULT_AROUTER_BASE_URL = "https://api.arouter.ai";
 /** Default outer orchestrator model when nothing is configured. */
 export const DEFAULT_OUTER_MODEL = "moonshotai/kimi-k2.6";
 /**
- * Default inner mobile_use VLM model when nothing is configured.
+ * Default inner VLM model when nothing is configured.
  *
  * The `llama/` prefix is the ARouter **provider** route — without it, the
  * gateway falls back to `openai/...` and the request is shipped to
@@ -52,20 +46,27 @@ export const DEFAULT_OUTER_MODEL = "moonshotai/kimi-k2.6";
  * surfaces the upstream error as a hollow `502 status code (no body)`.
  * See `docs/adr/` and the agent-runtime README for the full routing table.
  */
-export const DEFAULT_MOBILE_USE_MODEL = "llama/AutoGLM-Phone-9B-Q4_K_M.gguf";
-/** Default mobile_use adapter (forwarded to OpenAIClient when constructing the inner loop). */
-export const DEFAULT_MOBILE_USE_PROVIDER = "autoglm";
+export const DEFAULT_VLM_MODEL = "llama/AutoGLM-Phone-9B-Q4_K_M.gguf";
+/**
+ * Default VLM adapter. Intentionally EMPTY: an unset provider means
+ * "auto-detect the adapter from the model name" (`detectAdapter`), which
+ * already falls back to `autoglm` when no pattern matches. Forcing
+ * `autoglm` here would short-circuit detection and mis-parse e.g.
+ * `general` models whose name carries no detectable pattern. Set a
+ * non-empty `vlmProvider` (config / `VLM_PROVIDER` / `--vlm-provider`)
+ * to override.
+ */
+export const DEFAULT_VLM_PROVIDER = "";
 /**
  * Group-specific defaults exported for `loader.ts` to perform a
  * post-merge `applyGroupDefaults` pass.
  *
  * Why exported (and why loader does the backfill rather than zod):
  *   `zod.default(v)` only fires when the input field is `undefined`.
- *   When `loader` ends up producing `mobileUse: { apiKey: "x" }` (e.g.
- *   from the legacy `vlm_api_key` mirror, or from `GUI_AGENT_API_KEY`
- *   alone), zod sees the object and skips the whole `.default(...)` —
- *   then `LlmSection`'s inner `model: z.string().default("")` fills
- *   the missing field with empty string. Net result: `mobileUse.model`
+ *   When `loader` ends up producing `vlm: { apiKey: "x" }` (e.g. from
+ *   `VLM_API_KEY` alone), zod sees the object and skips the whole
+ *   `.default(...)` — then `LlmSection`'s inner `model: z.string().default("")`
+ *   fills the missing field with empty string. Net result: `vlm.model`
  *   silently becomes `""` and the agent boots without a model.
  *
  *   Loader is the right place to express "deep-merge group defaults"
@@ -82,19 +83,13 @@ export const OUTER_DEFAULTS = {
     model: DEFAULT_OUTER_MODEL,
     provider: "",
 };
-export const MOBILE_USE_DEFAULTS = {
+export const VLM_DEFAULTS = {
     baseUrl: DEFAULT_AROUTER_BASE_URL,
-    model: DEFAULT_MOBILE_USE_MODEL,
-    provider: DEFAULT_MOBILE_USE_PROVIDER,
-};
-export const GROUNDER_DEFAULTS = {
-    baseUrl: DEFAULT_AROUTER_BASE_URL,
-    model: DEFAULT_MOBILE_USE_MODEL,
-    provider: DEFAULT_MOBILE_USE_PROVIDER,
+    model: DEFAULT_VLM_MODEL,
+    provider: DEFAULT_VLM_PROVIDER,
 };
 const outerDefaults = LlmSection.parse({ ...OUTER_DEFAULTS });
-const mobileUseDefaults = LlmSection.parse({ ...MOBILE_USE_DEFAULTS });
-const grounderDefaults = LlmSection.parse({ ...GROUNDER_DEFAULTS });
+const vlmDefaults = LlmSection.parse({ ...VLM_DEFAULTS });
 export const Config = z
     .object({
     /** Standalone mode: skip Bridge handshake, only run HTTP/CLI. */
@@ -144,21 +139,10 @@ export const Config = z
      */
     outer: LlmSection.default(outerDefaults),
     /**
-     * Inner mobile_use VLM. Performs the screenshot→reason→act loop.
-     * Maps from `GUI_AGENT_*` env / `--mobile-use-*` flags.
-     */
-    mobileUse: LlmSection.default(mobileUseDefaults),
-    /**
-     * Visual grounder used by the outer layer for precise coordinate
-     * grounding. Maps from `GROUNDER_*` env / `--grounder-*` flags.
-     */
-    grounder: LlmSection.default(grounderDefaults),
-    /**
-     * Force the legacy single-layer adapter (vlm-inner-loop) instead of
-     * the v0.3.0 default `AgentRunnerCore`. Maps from `--legacy-inner`
-     * / `BEEOS_LEGACY_INNER`. Default `false`.
+     * Inner VLM. Performs the screenshot→reason→act loop.
+     * Maps from `VLM_*` env / `--vlm-*` flags.
      */
-    legacyInner: z.boolean().default(false),
+    vlm: LlmSection.default(vlmDefaults),
     /**
      * Enable OrchestratorAgent (OpenAI tool-calling outer loop + inner
      * mobile_use VLM) instead of the default `AgentRunnerCore`. Maps from
@@ -177,26 +161,15 @@ export const Config = z
      * → reuse `mobileUse.model`. Maps from `--planner-model`.
      */
     plannerModel: z.string().default(""),
-    /** Optional planner base URL. Empty → reuse `mobileUse.baseUrl`. */
+    /** Optional planner base URL. Empty → reuse `vlm.baseUrl`. */
     plannerBaseUrl: z.string().default(""),
-    /** Optional planner API key. Empty → reuse `mobileUse.apiKey`. */
+    /** Optional planner API key. Empty → reuse `vlm.apiKey`. */
     plannerApiKey: z.string().default(""),
     // ── Plugin toggles ────────────────────────────────────────────────────
     /** Disable the ACP plugin (Bridge WS). Maps from `--no-acp`. */
     disableAcp: z.boolean().default(false),
     /** Disable the HTTP debug plugin. Maps from `--no-http`. */
     disableHttp: z.boolean().default(false),
-    // ── Backward-compat top-level VLM fields ─────────────────────────────
-    /**
-     * @deprecated since the two-layer split — mirrored to `mobileUse.apiKey`
-     * by the loader. New configs should use `mobileUse.apiKey` (and/or
-     * `outer.apiKey` / `grounder.apiKey`) instead.
-     */
-    vlmApiKey: z.string().default(""),
-    /** @deprecated mirrored to `mobileUse.baseUrl`. */
-    vlmBaseUrl: z.string().default(DEFAULT_AROUTER_BASE_URL),
-    /** @deprecated mirrored to `mobileUse.model`. */
-    vlmModel: z.string().default(""),
     httpEnabled: z.boolean().default(false),
     httpHost: z.string().default("127.0.0.1"),
     httpPort: z.coerce.number().int().positive().default(9090),

package/dist/config/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;AAG1D;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC;KACxB,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC7B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CACjC,CAAC;KACD,WAAW,EAAE,CAAC;AAGjB;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,wBAAwB,CAAC;AACjE,mEAAmE;AACnE,MAAM,CAAC,MAAM,mBAAmB,GAAG,sBAAsB,CAAC;AAC1D;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,oCAAoC,CAAC;AACtE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,wBAAwB;IACjC,KAAK,EAAE,mBAAmB;IAC1B,QAAQ,EAAE,EAAE;CACJ,CAAC;AACX,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,OAAO,EAAE,wBAAwB;IACjC,KAAK,EAAE,iBAAiB;IACxB,QAAQ,EAAE,oBAAoB;CACtB,CAAC;AACX,MAAM,aAAa,GAAG,UAAU,CAAC,KAAK,CAAC,EAAE,GAAG,cAAc,EAAE,CAAC,CAAC;AAC9D,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,EAAE,GAAG,YAAY,EAAE,CAAC,CAAC;AAE1D,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC;KACpB,MAAM,CAAC;IACN,iEAAiE;IACjE,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAEtC;;;OAGG;IACH,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACjC,2CAA2C;IAC3C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACxC,6EAA6E;IAC7E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAE9B;;;OAGG;IACH,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,2BAA2B,CAAC;IAChE,iEAAiE;IACjE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAE9B,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC;IACpC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC;IACxC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAEzD;;;;;;OAMG;IACH,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9B;;;;OAIG;IACH,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACxC,qEAAqE;IACrE,gBAAgB,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAChE,0DAA0D;IAC1D,sBAAsB,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;IAEvE,wEAAwE;IACxE;;;OAGG;IACH,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,aAAa,CAAC;IAExC;;;OAGG;IACH,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC;IAEpC;;;;OAIG;IACH,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAExC;;;;;OAKG;IACH,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IAE7D;;;OAGG;IACH,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACpC,8DAA8D;IAC9D,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACtC,4DAA4D;IAC5D,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAErC,yEAAyE;IACzE,gEAAgE;IAChE,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACtC,4DAA4D;IAC5D,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAEvC,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACvC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC;IACzC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAC1D,6DAA6D;IAC7D,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAEvC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;IACpC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAExD;;;;;;;;;;;;;;;OAeG;IACH,iBAAiB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IACvE;;;;;OAKG;IACH,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAAC;IACzD;;;;;;;OAOG;IACH,gBAAgB,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;IAE1E,yEAAyE;IACzE;;;;;OAKG;IACH,yBAAyB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACpD;;;;OAIG;IACH,0BAA0B,EAAE,CAAC,CAAC,MAAM;SACjC,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,OAAO,CAAC,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;IAC5B;;;OAGG;IACH,2BAA2B,EAAE,CAAC,CAAC,MAAM;SAClC,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,OAAO,CAAC,MAAM,CAAC;IAClB;;;;OAIG;IACH,gCAAgC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC;IAClE;;;;OAIG;IACH,+BAA+B,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAE1D,uEAAuE;IACvE;;;;;;OAMG;IACH,qBAAqB,EAAE,CAAC;SACrB,IAAI,CAAC,CAAC,WAAW,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;SACxC,OAAO,CAAC,WAAW,CAAC;IACvB;;;;OAIG;IACH,8BAA8B,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;IAC3D;;;OAGG;IACH,sCAAsC,EAAE,CAAC,CAAC,MAAM;SAC7C,MAAM,EAAE;SACR,GAAG,EAAE;SACL,WAAW,EAAE;SACb,OAAO,CAAC,EAAE,CAAC;IACd;;;OAGG;IACH,qCAAqC,EAAE,CAAC,CAAC,MAAM;SAC5C,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,OAAO,CAAC,CAAC,CAAC;IACb;;;;OAIG;IACH,8BAA8B,EAAE,CAAC,CAAC,MAAM;SACrC,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,OAAO,CAAC,EAAE,CAAC;IACd;;;OAGG;IACH,8BAA8B,EAAE,CAAC,CAAC,MAAM;SACrC,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,OAAO,CAAC,GAAG,CAAC;IACf;;;;OAIG;IACH,mCAAmC,EAAE,CAAC,CAAC,MAAM;SAC1C,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,OAAO,CAAC,GAAG,CAAC;IAEf,wEAAwE;IACxE;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,UAAU,EAAE,CAAC;SACV,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QAClC;;;;;;WAMG;QACH,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;QACrC;;;;;;WAMG;QACH,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3C;;;;;;;;;WASG;QACH,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QACzC;;;;;;;;;;;;WAYG;QACH,eAAe,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;KACnE,CAAC;SACD,OAAO,CAAC;QACP,OAAO,EAAE,IAAI;QACb,aAAa,EAAE,EAAE;QACjB,mBAAmB,EAAE,EAAE;QACvB,cAAc,EAAE,IAAI;QACpB,eAAe,EAAE,EAAE;KACpB,CAAC;IAEJ,wEAAwE;IACxE;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,0BAA0B,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAClD;;;;;;;;;OASG;IACH,2BAA2B,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1E;;;;;;;;OAQG;IACH,2BAA2B,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAE7E,wEAAwE;IACxE;;;;;;OAMG;IACH,qBAAqB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAChD;;;;OAIG;IACH,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CAC1C,CAAC;KACD,WAAW,EAAE,CAAC"}

package/dist/core/task-outcome.d.ts

@@ -0,0 +1,32 @@
+export type AgentBayTaskStatus = "running" | "completed" | "failed" | "cancelled" | "unsupported";
+export type AgentTaskReason = "done" | "fail" | "call_for_user" | "step_budget" | "timeout" | "reflection_veto" | "cancelled" | "error";
+export interface AgentCoreTaskOutcomeFields {
+    taskStatus: AgentBayTaskStatus;
+    taskReason: AgentTaskReason;
+    taskAction?: string;
+    taskProduct?: string;
+    taskError?: string;
+}
+export interface AgentTaskOutcome extends AgentCoreTaskOutcomeFields {
+    taskId: string;
+}
+export declare function deriveTaskOutcome(args: {
+    taskId: string;
+    result: {
+        finalMessage: string;
+        cancelled: boolean;
+        taskStatus?: AgentBayTaskStatus;
+        taskReason?: AgentTaskReason;
+        taskAction?: string;
+        taskProduct?: string;
+        taskError?: string;
+    };
+    error?: string;
+}): AgentTaskOutcome;
+export declare function taskOutcomeFromTerminator(args: {
+    terminator: string;
+    finalMessage?: string;
+    taskAction?: string;
+    taskError?: string;
+}): AgentCoreTaskOutcomeFields;
+export declare function toAgentBayTaskPayload(outcome: AgentTaskOutcome | AgentCoreTaskOutcomeFields): Record<string, unknown>;

package/dist/core/task-outcome.js

@@ -0,0 +1,68 @@
+export function deriveTaskOutcome(args) {
+    const { taskId, result, error } = args;
+    const taskStatus = result.taskStatus ?? (error
+        ? "failed"
+        : result.cancelled
+            ? "cancelled"
+            : "completed");
+    const taskReason = result.taskReason ?? (error
+        ? result.cancelled
+            ? "cancelled"
+            : "error"
+        : result.cancelled
+            ? "cancelled"
+            : "done");
+    const taskProduct = result.taskProduct ?? (result.finalMessage || undefined);
+    const taskError = result.taskError ?? error;
+    return {
+        taskId,
+        taskStatus,
+        taskReason,
+        ...(result.taskAction ? { taskAction: result.taskAction } : {}),
+        ...(taskProduct ? { taskProduct } : {}),
+        ...(taskError ? { taskError } : {}),
+    };
+}
+export function taskOutcomeFromTerminator(args) {
+    const { terminator, finalMessage, taskAction, taskError } = args;
+    const base = {
+        ...(taskAction ? { taskAction } : {}),
+        ...(finalMessage ? { taskProduct: finalMessage } : {}),
+        ...(taskError ? { taskError } : {}),
+    };
+    switch (terminator) {
+        case "done":
+            return { taskStatus: "completed", taskReason: "done", ...base };
+        case "cancelled":
+            return { taskStatus: "cancelled", taskReason: "cancelled", ...base };
+        case "call_for_user":
+            return { taskStatus: "failed", taskReason: "call_for_user", ...base };
+        case "step_budget":
+            return { taskStatus: "failed", taskReason: "step_budget", ...base };
+        case "timeout":
+            return { taskStatus: "failed", taskReason: "timeout", ...base };
+        case "reflection_veto":
+            return { taskStatus: "failed", taskReason: "reflection_veto", ...base };
+        case "fail":
+            return { taskStatus: "failed", taskReason: "fail", ...base };
+        case "error":
+        default:
+            return { taskStatus: "failed", taskReason: "error", ...base };
+    }
+}
+export function toAgentBayTaskPayload(outcome) {
+    const payload = {
+        task_status: outcome.taskStatus,
+        task_reason: outcome.taskReason,
+    };
+    if ("taskId" in outcome)
+        payload.task_id = outcome.taskId;
+    if (outcome.taskAction)
+        payload.task_action = outcome.taskAction;
+    if (outcome.taskProduct)
+        payload.task_product = outcome.taskProduct;
+    if (outcome.taskError)
+        payload.task_error = outcome.taskError;
+    return payload;
+}
+//# sourceMappingURL=task-outcome.js.map

package/dist/core/task-outcome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-outcome.js","sourceRoot":"","sources":["../../src/core/task-outcome.ts"],"names":[],"mappings":"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"}

package/dist/fleet/adapters/process/in-process-manager.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Adapter — `IProcessManager` that hosts the device-agent DAEMON in-process.
+ *
+ * This is the production "one process controls many devices" path. The fleet
+ * supervisor and its pure FSM are UNCHANGED: they still believe they are
+ * spawning a daemon child per device. This adapter intercepts only the daemon
+ * lifecycle and redirects it to an in-process {@link MultiDeviceHost}, while
+ * delegating EVERYTHING else (mcp + scrcpy spawn/kill, liveness, pid) to a
+ * real {@link NodeProcessManager}.
+ *
+ * Topology this produces:
+ *
+ *   device-agent fleet start --in-process   (this OS process)
+ *     ├── device-mcp-server   (one shared child, via delegate)   ← still a child
+ *     ├── scrcpy-bridge × N   (per device, via delegate)         ← still children
+ *     └── MultiDeviceHost     (the N device-agent daemons, in-process)
+ *
+ * So the N ~50 MB agent daemons collapse into one process (deduplicated
+ * module/runtime baseline), but live video (scrcpy) and the shared MCP keep
+ * their own processes exactly as before.
+ *
+ * Why wrap instead of edit the supervisor: keeping `supervisor.ts` /
+ * `node-process-manager.ts` byte-identical to upstream means zero merge
+ * friction and the daemon's failover / activeAdbSerial / vlm-config logic is
+ * reused verbatim — `spawnDaemon` already receives the post-failover active
+ * transport in `opts.adbSerial` and the instance id for the per-device VLM
+ * config in `opts.instanceId`.
+ */
+import type { IProcessManager, ManagedProcess, ProcessEventListener, SpawnOptions, SpawnScrcpyOptions } from "../../ports/process-manager.js";
+import { NodeProcessManager } from "./node-process-manager.js";
+import type { Config } from "../../../config/schema.js";
+import type { Logger } from "../../../logger/index.js";
+export interface InProcessProcessManagerOptions {
+    /** Real process manager that owns the mcp + scrcpy children. */
+    delegate: NodeProcessManager;
+    /** Pino logger; the hosted MultiDeviceHost derives per-device children from it. */
+    logger: Logger;
+    /** Fallback Agent Gateway URL for bindings without a per-device override. */
+    defaultAgentGatewayUrl?: string;
+    /** Shared fleet-wide base config (vlm/outer/planMode/…) applied to every runtime. */
+    baseConfig?: Partial<Config>;
+    /** Bind host of the shared mcp (default 127.0.0.1, matches NodeProcessManager). */
+    mcpHost?: string;
+}
+export declare class InProcessProcessManager implements IProcessManager {
+    private readonly delegate;
+    private readonly log;
+    private readonly defaultAgentGatewayUrl;
+    private readonly baseConfig;
+    private readonly mcpHost;
+    /** Lazily built on the first spawnDaemon. */
+    private host;
+    private readonly listeners;
+    constructor(opts: InProcessProcessManagerOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    spawnMcp(opts: SpawnOptions): Promise<void>;
+    killMcp(serial: string, opts?: {
+        expected?: boolean;
+    }): Promise<void>;
+    spawnScrcpy(opts: SpawnScrcpyOptions): Promise<void>;
+    killScrcpy(serial: string, opts?: {
+        expected?: boolean;
+    }): Promise<void>;
+    spawnDaemon(opts: SpawnOptions): Promise<void>;
+    killDaemon(serial: string, opts?: {
+        expected?: boolean;
+    }): Promise<void>;
+    isAlive(serial: string, which: ManagedProcess): boolean;
+    pid(serial: string, which: ManagedProcess): number | null;
+    on(listener: ProcessEventListener): () => void;
+    private ensureHost;
+    private emit;
+}

package/dist/fleet/adapters/process/in-process-manager.js

@@ -0,0 +1,212 @@
+/**
+ * Adapter — `IProcessManager` that hosts the device-agent DAEMON in-process.
+ *
+ * This is the production "one process controls many devices" path. The fleet
+ * supervisor and its pure FSM are UNCHANGED: they still believe they are
+ * spawning a daemon child per device. This adapter intercepts only the daemon
+ * lifecycle and redirects it to an in-process {@link MultiDeviceHost}, while
+ * delegating EVERYTHING else (mcp + scrcpy spawn/kill, liveness, pid) to a
+ * real {@link NodeProcessManager}.
+ *
+ * Topology this produces:
+ *
+ *   device-agent fleet start --in-process   (this OS process)
+ *     ├── device-mcp-server   (one shared child, via delegate)   ← still a child
+ *     ├── scrcpy-bridge × N   (per device, via delegate)         ← still children
+ *     └── MultiDeviceHost     (the N device-agent daemons, in-process)
+ *
+ * So the N ~50 MB agent daemons collapse into one process (deduplicated
+ * module/runtime baseline), but live video (scrcpy) and the shared MCP keep
+ * their own processes exactly as before.
+ *
+ * Why wrap instead of edit the supervisor: keeping `supervisor.ts` /
+ * `node-process-manager.ts` byte-identical to upstream means zero merge
+ * friction and the daemon's failover / activeAdbSerial / vlm-config logic is
+ * reused verbatim — `spawnDaemon` already receives the post-failover active
+ * transport in `opts.adbSerial` and the instance id for the per-device VLM
+ * config in `opts.instanceId`.
+ */
+import * as path from "node:path";
+import * as fs from "node:fs";
+import { materializeInlineAgentConfig } from "./node-process-manager.js";
+import { MultiDeviceHost } from "../../../app/multi-device-host.js";
+import { getBeeosHome } from "../../../config/paths.js";
+export class InProcessProcessManager {
+    delegate;
+    log;
+    defaultAgentGatewayUrl;
+    baseConfig;
+    mcpHost;
+    /** Lazily built on the first spawnDaemon. */
+    host = null;
+    listeners = new Set();
+    constructor(opts) {
+        this.delegate = opts.delegate;
+        this.log = opts.logger;
+        this.defaultAgentGatewayUrl = opts.defaultAgentGatewayUrl;
+        this.baseConfig = opts.baseConfig;
+        this.mcpHost = opts.mcpHost ?? "127.0.0.1";
+    }
+    async start() {
+        await this.delegate.start();
+    }
+    async stop() {
+        // Tear down hosted runtimes first (closes their WS + flushes sessions),
+        // then the mcp/scrcpy children the delegate owns.
+        if (this.host)
+            await this.host.stop().catch(() => { });
+        await this.delegate.stop();
+    }
+    // ── mcp / scrcpy: delegated verbatim (still real child processes) ─────────
+    spawnMcp(opts) {
+        // Deliberately NO port caching here. The singleton's real listening port
+        // lives on the delegate (`globalMcpPort`) and can change across mcp
+        // restarts — it adopts the sticky port of whichever device re-boots it.
+        // spawnDaemon reads the live port from the delegate on every call, exactly
+        // like classic NodeProcessManager.spawnDaemon. (Caching the first
+        // `opts.mcpPort` here was the bug that left runtimes dialing a dead port
+        // after an mcp restart on a different device's sticky port.)
+        return this.delegate.spawnMcp(opts);
+    }
+    killMcp(serial, opts) {
+        return this.delegate.killMcp(serial, opts);
+    }
+    spawnScrcpy(opts) {
+        return this.delegate.spawnScrcpy(opts);
+    }
+    killScrcpy(serial, opts) {
+        return this.delegate.killScrcpy(serial, opts);
+    }
+    // ── daemon: hosted in-process ────────────────────────────────────────────
+    async spawnDaemon(opts) {
+        // Always route the runtime at the LIVE singleton mcp port — mirrors classic
+        // NodeProcessManager.spawnDaemon (`globalMcpPort > 0 ? globalMcpPort :
+        // opts.mcpPort`). `opts.mcpPort` is only the per-device sticky fallback for
+        // the device that first boots the singleton; once it is up, and after any
+        // mcp restart that landed it on a different device's sticky port, the
+        // actual port differs and every runtime must follow it.
+        const mcpUrl = `http://${this.mcpHost}:${this.delegate.effectiveMcpPort(opts.mcpPort)}`;
+        const host = this.ensureHost(mcpUrl);
+        // Per-instance VLM/orchestrator config: materialise the same file the
+        // spawned daemon would read via `--vlm-config-file`, then fall back to the
+        // legacy `~/.beeos/<instanceId>.config.json` if present.
+        let configFile;
+        if (opts.instanceId) {
+            const fromState = await materializeInlineAgentConfig(opts.instanceId);
+            if (fromState) {
+                configFile = fromState;
+            }
+            else {
+                const legacy = path.join(getBeeosHome(), `${opts.instanceId}.config.json`);
+                if (await fileExists(legacy))
+                    configFile = legacy;
+            }
+        }
+        await host.addDevice(spawnOptionsToBinding(opts), { configFile, mcpUrl });
+        // Translate boot outcome into the lifecycle events the FSM expects. A
+        // boot failure is fault-isolated inside the host (no throw), so we must
+        // detect it via `has()` and report `daemon_exited` (unexpected) — that
+        // drives the FSM's backoff + respawn exactly like a crashed child.
+        if (host.has(opts.serial)) {
+            this.emit({ kind: "daemon_started", serial: opts.serial, pid: process.pid });
+        }
+        else {
+            this.emit({
+                kind: "daemon_exited",
+                serial: opts.serial,
+                code: 1,
+                signal: null,
+                expected: false,
+            });
+        }
+    }
+    async killDaemon(serial, opts) {
+        const wasRunning = this.host?.has(serial) ?? false;
+        if (this.host)
+            await this.host.removeDevice(serial);
+        if (wasRunning) {
+            this.emit({
+                kind: "daemon_exited",
+                serial,
+                code: null,
+                signal: "SIGTERM",
+                expected: opts?.expected ?? true,
+            });
+        }
+    }
+    // ── introspection ────────────────────────────────────────────────────────
+    isAlive(serial, which) {
+        if (which === "daemon")
+            return this.host?.has(serial) ?? false;
+        return this.delegate.isAlive(serial, which);
+    }
+    pid(serial, which) {
+        // Hosted daemons share THIS process — report our own pid when present.
+        if (which === "daemon")
+            return this.host?.has(serial) ? process.pid : null;
+        return this.delegate.pid(serial, which);
+    }
+    on(listener) {
+        // Fan in BOTH the delegate's mcp/scrcpy events and our synthetic daemon
+        // events. The delegate never emits daemon events (we never call its
+        // spawnDaemon), so there is no duplication.
+        const offDelegate = this.delegate.on(listener);
+        this.listeners.add(listener);
+        return () => {
+            offDelegate();
+            this.listeners.delete(listener);
+        };
+    }
+    // ── internals ─────────────────────────────────────────────────────────────
+    ensureHost(defaultMcpUrl) {
+        if (this.host)
+            return this.host;
+        this.host = new MultiDeviceHost({
+            // Fallback only — spawnDaemon passes a per-device `mcpUrl` override on
+            // every addDevice (computed from the live singleton port), so this
+            // constructor default is never actually used to route a runtime.
+            mcpUrl: defaultMcpUrl,
+            defaultAgentGatewayUrl: this.defaultAgentGatewayUrl,
+            ...(this.baseConfig ? { baseConfig: this.baseConfig } : {}),
+            logger: this.log,
+        });
+        return this.host;
+    }
+    emit(event) {
+        for (const l of this.listeners) {
+            try {
+                l(event);
+            }
+            catch (e) {
+                this.log.warn({ err: e.message }, "in-process manager: listener threw");
+            }
+        }
+    }
+}
+/**
+ * Project a supervisor-built `SpawnOptions` onto the `DeviceBinding` the host
+ * consumes. `opts.adbSerial` is already the post-failover ACTIVE transport, so
+ * the in-process runtime targets the same device the spawned daemon would.
+ */
+function spawnOptionsToBinding(opts) {
+    return {
+        serial: opts.serial,
+        adbSerial: opts.adbSerial,
+        name: opts.name ?? opts.serial,
+        instanceId: opts.instanceId ?? null,
+        keyFile: opts.keyFile,
+        agentGatewayUrl: opts.agentGatewayUrl,
+        backend: opts.backend,
+        // httpPort intentionally dropped — MultiDeviceHost forces HTTP debug off.
+    };
+}
+async function fileExists(p) {
+    try {
+        await fs.promises.access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=in-process-manager.js.map

package/dist/fleet/adapters/process/in-process-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-process-manager.js","sourceRoot":"","sources":["../../../../src/fleet/adapters/process/in-process-manager.ts"],"names":[],"mappings":"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"}

package/dist/fleet/adapters/process/node-process-manager.d.ts

@@ -241,6 +241,15 @@ export declare class NodeProcessManager implements IProcessManager {
      * A no-op when the singleton is already gone.
      */
     private killGlobalMcp;
+    /**
+     * The port a daemon's `--mcp-url` must target: the live singleton
+     * `globalMcpPort` when the shared mcp is up, else the supplied per-device
+     * fallback (`opts.mcpPort`) for direct/test invocations with no prior
+     * `spawnMcp`. Exposed so `InProcessProcessManager` can route its in-process
+     * runtimes at the SAME live port classic daemons use — and follow it across
+     * mcp restarts instead of caching a stale port.
+     */
+    effectiveMcpPort(fallback: number): number;
     spawnDaemon(opts: SpawnOptions): Promise<void>;
     spawnScrcpy(opts: SpawnScrcpyOptions): Promise<void>;
     killMcp(serial: string, opts?: {
@@ -257,3 +266,22 @@ export declare class NodeProcessManager implements IProcessManager {
     private killChild;
     private emit;
 }
+/**
+ * Read `state.json` and, if a `kind=device` agent with the given
+ * `instance_id` carries an inline `agent_config`, materialise it to a
+ * stable path under `~/.beeos/runtime/agent-config/<instance_id>.json`
+ * and return that path. Returns `null` when state.json is absent /
+ * malformed / forward-versioned / has no inline payload — caller then
+ * falls back to the legacy `~/.beeos/<instance_id>.config.json`.
+ *
+ * Why a temp file (rather than a `--vlm-config-json '<payload>'`
+ * flag) — keeping the existing CLI flag interface unchanged means
+ * the dual-write Step 3 doesn't have to ship in lockstep with a
+ * device-agent flag-parser change. The file lives under a stable
+ * path so successive spawns are idempotent (the FSM may respawn
+ * many times before the operator next runs `beeos device attach`).
+ *
+ * Round 5: shape parsing delegated to the shared `readStateJson`
+ * helper; this function just projects + materialises.
+ */
+export declare function materializeInlineAgentConfig(instanceId: string): Promise<string | null>;