agent-phonon 0.2.10 → 0.3.0

package/dist/cli.js

@@ -940,7 +940,7 @@ var init_project = __esm({
 
 // ../protocol/dist/schemas/skill.js
 import { z as z10 } from "zod";
-var SkillScope, SkillSource, SkillDescriptor, SkillInstallParams, SkillInstallResult, SkillUninstallParams, SkillUninstallResult, SkillListParams, SkillListResult;
+var SkillScope, SkillSource, SkillDescriptor, SkillInstallParams, SkillInstallResult, SkillUninstallParams, SkillUninstallResult, SkillListParams, SkillListResult, SkillDirsParams, SkillDirectoryDescriptor, SkillDirsResult;
 var init_skill = __esm({
   "../protocol/dist/schemas/skill.js"() {
     "use strict";
@@ -1028,6 +1028,29 @@ var init_skill = __esm({
     SkillListResult = z10.object({
       skills: z10.array(SkillDescriptor)
     });
+    SkillDirsParams = z10.object({
+      /** 可选：global scope 的目标 agent。 */
+      agent: AgentId.optional(),
+      /** 可选：project scope 的目标项目。 */
+      projectId: ProjectId.optional(),
+      /** 可选：只查 global 或 project；不传时按 agent/projectId 返回可查范围。 */
+      scope: SkillScope.optional()
+    });
+    SkillDirectoryDescriptor = z10.object({
+      /** skill 目录名。 */
+      name: z10.string().min(1),
+      scope: SkillScope,
+      agent: AgentId.optional(),
+      projectId: ProjectId.optional(),
+      /** scope 根目录（global skill root 或 <project>/.agent/skills）。 */
+      rootPath: z10.string().min(1),
+      /** skill 目录真实本机路径。 */
+      path: z10.string().min(1),
+      exists: z10.boolean()
+    });
+    SkillDirsResult = z10.object({
+      directories: z10.array(SkillDirectoryDescriptor)
+    });
   }
 });
 
@@ -1311,43 +1334,166 @@ var init_env = __esm({
   }
 });
 
-// ../protocol/dist/schemas/jsonrpc.js
+// ../protocol/dist/schemas/workflow.js
 import { z as z16 } from "zod";
+var ModelId, TurnId, ClientRequestId, WorkflowId, WorkflowNodeId, WorkflowEdgeId, WorkflowRoleId, WorkflowNode, WorkflowEdge, WorkflowDagPlan, WorkflowCommunicationGraph, WorkflowGraphPlan, WorkflowPlan, WorkflowStatus, WorkflowNodeStatus, WorkflowRunParams, WorkflowRunResult, WorkflowStatusParams, WorkflowNodeRuntime, WorkflowStatusResult, WorkflowCancelParams, WorkflowCancelResult, WorkflowListParams, WorkflowListResult, WorkflowEvent;
+var init_workflow = __esm({
+  "../protocol/dist/schemas/workflow.js"() {
+    "use strict";
+    init_common();
+    ModelId = z16.string().min(1);
+    TurnId = z16.string().min(1);
+    ClientRequestId = z16.string().min(1);
+    WorkflowId = z16.string().min(1);
+    WorkflowNodeId = z16.string().min(1);
+    WorkflowEdgeId = z16.string().min(1);
+    WorkflowRoleId = z16.string().min(1);
+    WorkflowNode = z16.object({
+      nodeId: WorkflowNodeId,
+      agent: AgentId,
+      model: ModelId,
+      role: WorkflowRoleId.optional(),
+      input: z16.string().optional(),
+      systemPrompt: z16.string().optional(),
+      dependsOn: z16.array(WorkflowNodeId).optional(),
+      sessionId: SessionId.optional(),
+      agentConfig: z16.record(z16.unknown()).optional(),
+      metadata: z16.record(z16.unknown()).optional()
+    });
+    WorkflowEdge = z16.object({
+      edgeId: WorkflowEdgeId.optional(),
+      from: WorkflowNodeId,
+      to: WorkflowNodeId,
+      label: z16.string().optional(),
+      condition: z16.string().optional(),
+      metadata: z16.record(z16.unknown()).optional()
+    });
+    WorkflowDagPlan = z16.object({
+      mode: z16.literal("dag"),
+      nodes: z16.array(WorkflowNode).min(1),
+      edges: z16.array(WorkflowEdge).optional(),
+      finalNodeId: WorkflowNodeId.optional()
+    });
+    WorkflowCommunicationGraph = z16.object({
+      edges: z16.array(WorkflowEdge).default([]),
+      allowSelfLoop: z16.boolean().default(false),
+      maxIterations: z16.number().int().positive().default(12)
+    });
+    WorkflowGraphPlan = z16.object({
+      mode: z16.literal("graph"),
+      executor: z16.object({
+        nodeId: WorkflowNodeId,
+        agent: AgentId,
+        model: ModelId,
+        role: z16.literal("executor").default("executor"),
+        systemPrompt: z16.string().optional(),
+        agentConfig: z16.record(z16.unknown()).optional()
+      }),
+      workers: z16.array(WorkflowNode).min(1),
+      communicationGraph: WorkflowCommunicationGraph
+    });
+    WorkflowPlan = z16.discriminatedUnion("mode", [WorkflowDagPlan, WorkflowGraphPlan]);
+    WorkflowStatus = z16.enum(["queued", "running", "completed", "failed", "cancelled", "timeout"]);
+    WorkflowNodeStatus = z16.enum(["pending", "ready", "running", "completed", "failed", "skipped", "cancelled"]);
+    WorkflowRunParams = z16.object({
+      project: ProjectId,
+      worktreeId: z16.string().optional(),
+      plan: WorkflowPlan,
+      input: z16.string().optional(),
+      clientRequestId: ClientRequestId.optional(),
+      metadata: z16.record(z16.unknown()).optional()
+    });
+    WorkflowRunResult = z16.object({
+      workflowId: WorkflowId,
+      status: WorkflowStatus,
+      createdAt: Timestamp
+    });
+    WorkflowStatusParams = z16.object({ workflowId: WorkflowId });
+    WorkflowNodeRuntime = z16.object({
+      nodeId: WorkflowNodeId,
+      status: WorkflowNodeStatus,
+      agent: AgentId,
+      model: ModelId,
+      role: WorkflowRoleId.optional(),
+      sessionId: SessionId.optional(),
+      turnId: TurnId.optional(),
+      startedAt: Timestamp.optional(),
+      completedAt: Timestamp.optional(),
+      error: z16.string().optional()
+    });
+    WorkflowStatusResult = z16.object({
+      workflowId: WorkflowId,
+      status: WorkflowStatus,
+      project: ProjectId,
+      mode: z16.enum(["dag", "graph"]),
+      nodes: z16.array(WorkflowNodeRuntime),
+      createdAt: Timestamp,
+      updatedAt: Timestamp,
+      completedAt: Timestamp.optional(),
+      error: z16.string().optional()
+    });
+    WorkflowCancelParams = z16.object({ workflowId: WorkflowId, reason: z16.string().optional() });
+    WorkflowCancelResult = z16.object({ workflowId: WorkflowId, status: z16.literal("cancelled") });
+    WorkflowListParams = z16.object({
+      status: WorkflowStatus.optional(),
+      limit: z16.number().int().positive().max(100).default(50).optional(),
+      cursor: z16.string().optional()
+    });
+    WorkflowListResult = z16.object({ workflows: z16.array(WorkflowStatusResult), nextCursor: z16.string().optional() });
+    WorkflowEvent = z16.object({
+      workflowId: WorkflowId,
+      seq: z16.number().int().nonnegative(),
+      type: z16.enum(["workflow.status", "node.status", "node.stream", "edge.route", "executor.decision"]),
+      nodeId: WorkflowNodeId.optional(),
+      sessionId: SessionId.optional(),
+      turnId: TurnId.optional(),
+      agent: AgentId.optional(),
+      model: ModelId.optional(),
+      role: WorkflowRoleId.optional(),
+      status: z16.union([WorkflowStatus, WorkflowNodeStatus]).optional(),
+      payload: z16.record(z16.unknown()).optional(),
+      timestamp: Timestamp
+    });
+  }
+});
+
+// ../protocol/dist/schemas/jsonrpc.js
+import { z as z17 } from "zod";
 var JsonRpcVersion, JsonRpcId, JsonRpcRequest, JsonRpcNotification, JsonRpcSuccess, JsonRpcErrorObject, JsonRpcError, JsonRpcMessage, JSON_RPC_CODES;
 var init_jsonrpc = __esm({
   "../protocol/dist/schemas/jsonrpc.js"() {
     "use strict";
     init_common();
-    JsonRpcVersion = z16.literal("2.0");
-    JsonRpcId = z16.union([z16.string(), z16.number()]);
-    JsonRpcRequest = z16.object({
+    JsonRpcVersion = z17.literal("2.0");
+    JsonRpcId = z17.union([z17.string(), z17.number()]);
+    JsonRpcRequest = z17.object({
       jsonrpc: JsonRpcVersion,
       id: JsonRpcId,
-      method: z16.string(),
-      params: z16.unknown().optional()
+      method: z17.string(),
+      params: z17.unknown().optional()
     });
-    JsonRpcNotification = z16.object({
+    JsonRpcNotification = z17.object({
       jsonrpc: JsonRpcVersion,
-      method: z16.string(),
-      params: z16.unknown().optional()
+      method: z17.string(),
+      params: z17.unknown().optional()
     });
-    JsonRpcSuccess = z16.object({
+    JsonRpcSuccess = z17.object({
       jsonrpc: JsonRpcVersion,
       id: JsonRpcId,
-      result: z16.unknown()
+      result: z17.unknown()
     });
-    JsonRpcErrorObject = z16.object({
+    JsonRpcErrorObject = z17.object({
       /** JSON-RPC 传输级 code（-32700..-32600 保留；应用错误用 data.appCode 判别）。 */
-      code: z16.number().int(),
-      message: z16.string(),
+      code: z17.number().int(),
+      message: z17.string(),
       data: PhononErrorData.optional()
     });
-    JsonRpcError = z16.object({
+    JsonRpcError = z17.object({
       jsonrpc: JsonRpcVersion,
       id: JsonRpcId.nullable(),
       error: JsonRpcErrorObject
     });
-    JsonRpcMessage = z16.union([
+    JsonRpcMessage = z17.union([
       JsonRpcRequest,
       JsonRpcNotification,
       JsonRpcSuccess,
@@ -1366,7 +1512,7 @@ var init_jsonrpc = __esm({
 });
 
 // ../protocol/dist/schemas/methods.js
-import { z as z17 } from "zod";
+import { z as z18 } from "zod";
 function parseParams(method, data) {
   return METHODS[method].params.parse(data);
 }
@@ -1386,7 +1532,8 @@ var init_methods = __esm({
     init_device();
     init_file();
     init_env();
-    z_void = z17.undefined();
+    init_workflow();
+    z_void = z18.undefined();
     METHODS = {
       // --- 握手（phonon 拨出后先发）---
       "connect.hello": {
@@ -1664,6 +1811,43 @@ var init_methods = __esm({
         kind: "request",
         params: SkillListParams,
         result: SkillListResult
+      },
+      "skill.dirs": {
+        direction: "s2p",
+        kind: "request",
+        params: SkillDirsParams,
+        result: SkillDirsResult
+      },
+      // --- L3 workflow orchestration (DAG / executor graph) ---
+      "workflow.run": {
+        direction: "s2p",
+        kind: "request",
+        params: WorkflowRunParams,
+        result: WorkflowRunResult
+      },
+      "workflow.status": {
+        direction: "s2p",
+        kind: "request",
+        params: WorkflowStatusParams,
+        result: WorkflowStatusResult
+      },
+      "workflow.cancel": {
+        direction: "s2p",
+        kind: "request",
+        params: WorkflowCancelParams,
+        result: WorkflowCancelResult
+      },
+      "workflow.list": {
+        direction: "s2p",
+        kind: "request",
+        params: WorkflowListParams,
+        result: WorkflowListResult
+      },
+      "workflow.event": {
+        direction: "p2s",
+        kind: "notification",
+        params: WorkflowEvent,
+        result: z_void
       }
     };
     METHOD_NAMES = Object.keys(METHODS);
@@ -1689,6 +1873,7 @@ var init_dist = __esm({
     init_device();
     init_file();
     init_env();
+    init_workflow();
     init_jsonrpc();
     init_methods();
   }
@@ -1725,12 +1910,12 @@ var init_rpc = __esm({
       requestRaw(method, params, timeoutMs = 12e4) {
         const id = this.nextId++;
         const msg = { jsonrpc: "2.0", id, method, params };
-        return new Promise((resolve5, reject) => {
+        return new Promise((resolve6, reject) => {
           const timer = timeoutMs > 0 ? setTimeout(() => {
             this.pending.delete(id);
             reject(new PhononError("errInternal", `RPC timeout: ${method}`));
           }, timeoutMs) : void 0;
-          this.pending.set(id, { resolve: resolve5, reject, timer });
+          this.pending.set(id, { resolve: resolve6, reject, timer });
           this.transport.send(JSON.stringify(msg));
         });
       }
@@ -2186,8 +2371,8 @@ var SessionEngine = class {
       this.interactionWaiters.delete(requestId);
     }
   }
-  registerInteractionWaiter(requestId, resolve5) {
-    this.interactionWaiters.set(requestId, resolve5);
+  registerInteractionWaiter(requestId, resolve6) {
+    this.interactionWaiters.set(requestId, resolve6);
   }
   list(tenantId, filter) {
     const all = [];
@@ -2438,7 +2623,7 @@ var ProjectManager = class {
 
 // ../core/dist/skill-manager.js
 init_rpc();
-import { mkdir as mkdir2, rm as rm2, writeFile, readdir as readdir2, stat as stat2, mkdtemp, lstat } from "node:fs/promises";
+import { mkdir as mkdir2, rm as rm2, writeFile, readdir as readdir2, stat as stat2, mkdtemp, lstat, realpath } from "node:fs/promises";
 import { existsSync as existsSync2 } from "node:fs";
 import { join as join2, resolve as resolve2, sep } from "node:path";
 import { tmpdir } from "node:os";
@@ -2541,6 +2726,36 @@ var SkillManager = class {
       return true;
     });
   }
+  async dirs(filter) {
+    const rows = [];
+    if (filter?.scope !== "project" && filter?.agent) {
+      const adapter = this.registry.resolve(filter.agent);
+      const root = adapter?.globalSkillDir?.(filter.agent);
+      if (root)
+        rows.push(...await this.listDirs(root, { scope: "global", agent: filter.agent }));
+    }
+    if (filter?.scope !== "global" && filter?.projectId) {
+      const projPath = this.resolveProjectPath(filter.projectId);
+      if (!projPath)
+        throw new PhononError("errProjectNotFound", `project ${filter.projectId} not found`);
+      rows.push(...await this.listDirs(join2(projPath, ".agent", "skills"), { scope: "project", projectId: filter.projectId }));
+    }
+    return rows;
+  }
+  async listDirs(root, base) {
+    const rootPath = existsSync2(root) ? await realpath(root) : resolve2(root);
+    if (!existsSync2(root))
+      return [];
+    const entries = await readdir2(root, { withFileTypes: true });
+    const rows = [];
+    for (const e of entries) {
+      if (!e.isDirectory())
+        continue;
+      const full = join2(root, e.name);
+      rows.push({ name: e.name, ...base, rootPath, path: await realpath(full), exists: true });
+    }
+    return rows.sort((a, b) => a.name.localeCompare(b.name));
+  }
   async installArchive(source, dest) {
     if (source.format !== "tar.gz")
       throw new PhononError("errSkillInstallFailed", `unsupported archive format: ${source.format}`);
@@ -3142,7 +3357,7 @@ var PhononStore = class {
 
 // ../core/dist/file-manager.js
 init_rpc();
-import { mkdir as mkdir3, readFile, readdir as readdir3, lstat as lstat2, realpath, writeFile as writeFile2 } from "node:fs/promises";
+import { mkdir as mkdir3, readFile, readdir as readdir3, lstat as lstat2, realpath as realpath2, writeFile as writeFile2 } from "node:fs/promises";
 import { basename as basename2, dirname as dirname3, join as join4, resolve as resolve4, sep as sep2 } from "node:path";
 var FileManager = class {
   resolver;
@@ -3159,7 +3374,7 @@ var FileManager = class {
     let cur = abs;
     for (; ; ) {
       try {
-        const real = await realpath(cur);
+        const real = await realpath2(cur);
         return suffix.length ? resolve4(real, ...suffix) : real;
       } catch (e) {
         if (e?.code !== "ENOENT")
@@ -3365,6 +3580,190 @@ async function commandExists(cmd2) {
   }
 }
 
+// ../core/dist/workflow-engine.js
+init_rpc();
+var WorkflowEngine = class {
+  opts;
+  runs = /* @__PURE__ */ new Map();
+  sessionToNode = /* @__PURE__ */ new Map();
+  idSeq = 1;
+  constructor(opts) {
+    this.opts = opts;
+  }
+  async run(params) {
+    const workflowId = `wf-${Date.now()}-${this.idSeq++}`;
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const nodes = this.initialNodes(params.plan);
+    const run = { workflowId, tenantId: this.opts.tenantId, project: params.project, worktreeId: params.worktreeId, mode: params.plan.mode, plan: params.plan, input: params.input, status: "queued", nodes, createdAt: now, updatedAt: now, seq: 0 };
+    this.runs.set(workflowId, run);
+    this.emit(run, { type: "workflow.status", status: "queued" });
+    void this.execute(run).catch((err) => this.fail(run, err));
+    return { workflowId, status: run.status, createdAt: run.createdAt };
+  }
+  status(workflowId) {
+    const run = this.get(workflowId);
+    return this.toStatus(run);
+  }
+  list(filter) {
+    const limit = filter?.limit ?? 50;
+    const rows = [...this.runs.values()].filter((r) => !filter?.status || r.status === filter.status).slice(-limit).reverse();
+    return { workflows: rows.map((r) => this.toStatus(r)) };
+  }
+  async cancel(workflowId, reason) {
+    const run = this.get(workflowId);
+    run.status = "cancelled";
+    run.completedAt = (/* @__PURE__ */ new Date()).toISOString();
+    run.updatedAt = run.completedAt;
+    for (const n of run.nodes) {
+      if (n.sessionId && (n.status === "running" || n.status === "ready" || n.status === "pending")) {
+        n.status = "cancelled";
+        try {
+          await this.opts.engine.terminate(this.opts.tenantId, n.sessionId);
+        } catch {
+        }
+      }
+    }
+    this.emit(run, { type: "workflow.status", status: "cancelled", payload: { reason } });
+    return { workflowId, status: "cancelled" };
+  }
+  onStreamEvent(ev) {
+    const sessionId = ev.sessionId;
+    if (!sessionId)
+      return;
+    const m = this.sessionToNode.get(sessionId);
+    if (!m)
+      return;
+    const run = this.runs.get(m.workflowId);
+    const node = run?.nodes.find((n) => n.nodeId === m.nodeId);
+    if (!run || !node)
+      return;
+    this.emit(run, {
+      type: "node.stream",
+      nodeId: node.nodeId,
+      sessionId,
+      turnId: ev.turnId,
+      agent: node.agent,
+      model: node.model,
+      role: node.role,
+      payload: ev
+    });
+  }
+  async execute(run) {
+    run.status = "running";
+    run.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+    this.emit(run, { type: "workflow.status", status: "running" });
+    if (run.plan.mode === "dag")
+      await this.executeDag(run);
+    else
+      await this.executeGraph(run);
+    if (!["cancelled", "failed"].includes(run.status)) {
+      run.status = "completed";
+      run.completedAt = (/* @__PURE__ */ new Date()).toISOString();
+      run.updatedAt = run.completedAt;
+      this.emit(run, { type: "workflow.status", status: "completed" });
+    }
+  }
+  async executeDag(run) {
+    const plan = run.plan.mode === "dag" ? run.plan : void 0;
+    if (!plan)
+      return;
+    const deps = /* @__PURE__ */ new Map();
+    for (const n of plan.nodes)
+      deps.set(n.nodeId, new Set(n.dependsOn ?? []));
+    for (const e of plan.edges ?? [])
+      deps.get(e.to)?.add(e.from);
+    const done = /* @__PURE__ */ new Set();
+    while (done.size < plan.nodes.length) {
+      const ready = plan.nodes.filter((n) => !done.has(n.nodeId) && [...deps.get(n.nodeId) ?? []].every((d) => done.has(d)));
+      if (ready.length === 0)
+        throw new PhononError("errInvalidParams", "workflow DAG has a cycle or missing dependency");
+      await Promise.all(ready.map((n) => this.executeNode(run, n.nodeId, n.agent, n.model, n.role, n.input ?? run.input ?? "", n.agentConfig)));
+      for (const n of ready)
+        done.add(n.nodeId);
+    }
+  }
+  async executeGraph(run) {
+    const plan = run.plan.mode === "graph" ? run.plan : void 0;
+    if (!plan)
+      return;
+    const prompt = [
+      "You are the executor for a multi-agent graph workflow.",
+      `Input: ${run.input ?? ""}`,
+      `Workers: ${JSON.stringify(plan.workers.map((w) => ({ nodeId: w.nodeId, role: w.role, agent: w.agent, model: w.model })))}`,
+      `Communication graph: ${JSON.stringify(plan.communicationGraph)}`,
+      "Produce the first routing decision and final summary for this initial implementation."
+    ].join("\n\n");
+    await this.executeNode(run, plan.executor.nodeId, plan.executor.agent, plan.executor.model, plan.executor.role, prompt, plan.executor.agentConfig);
+    this.emit(run, { type: "executor.decision", nodeId: plan.executor.nodeId, payload: { initialImplementation: true } });
+  }
+  async executeNode(run, nodeId, agent, model, role, input, agentConfig) {
+    const node = run.nodes.find((n) => n.nodeId === nodeId) ?? this.addNode(run, { nodeId, agent, model, role });
+    node.status = "running";
+    node.startedAt = (/* @__PURE__ */ new Date()).toISOString();
+    run.updatedAt = node.startedAt;
+    this.emit(run, { type: "node.status", nodeId, agent, model, role, status: "running" });
+    try {
+      const cwd = this.opts.resolveCwd(run.project, run.worktreeId);
+      const created = await this.opts.engine.create({ tenantId: run.tenantId, project: run.project, worktreeId: run.worktreeId, cwd, agent, model, verbosity: "messages", agentConfig });
+      node.sessionId = created.sessionId;
+      this.sessionToNode.set(created.sessionId, { workflowId: run.workflowId, nodeId });
+      const sent = await this.opts.engine.send(run.tenantId, created.sessionId, input, { environment: this.opts.env.resolveForExecution({ projectId: run.project, agent }) });
+      node.turnId = sent.turnId;
+      await this.waitIdle(run.tenantId, created.sessionId);
+      node.status = "completed";
+      node.completedAt = (/* @__PURE__ */ new Date()).toISOString();
+      run.updatedAt = node.completedAt;
+      this.emit(run, { type: "node.status", nodeId, sessionId: node.sessionId, turnId: node.turnId, agent, model, role, status: "completed" });
+    } catch (err) {
+      node.status = "failed";
+      node.completedAt = (/* @__PURE__ */ new Date()).toISOString();
+      node.error = err?.message ?? String(err);
+      run.updatedAt = node.completedAt;
+      this.emit(run, { type: "node.status", nodeId, agent, model, role, status: "failed", payload: { error: node.error } });
+      throw err;
+    }
+  }
+  async waitIdle(tenantId, sessionId) {
+    for (; ; ) {
+      const s = await this.opts.engine.status(tenantId, sessionId);
+      if (s.status === "idle" || s.status === "terminated" || s.status === "paused")
+        return;
+      await new Promise((r) => setTimeout(r, 250));
+    }
+  }
+  initialNodes(plan) {
+    const nodes = plan.mode === "dag" ? plan.nodes : [plan.executor, ...plan.workers];
+    return nodes.map((n) => ({ nodeId: n.nodeId, status: "pending", agent: n.agent, model: n.model, role: n.role }));
+  }
+  addNode(run, n) {
+    const node = { ...n, status: "pending" };
+    run.nodes.push(node);
+    return node;
+  }
+  get(workflowId) {
+    const run = this.runs.get(workflowId);
+    if (!run)
+      throw new PhononError("errInvalidParams", `workflow ${workflowId} not found`);
+    return run;
+  }
+  fail(run, err) {
+    if (run.status === "cancelled")
+      return;
+    run.status = "failed";
+    run.error = err?.message ?? String(err);
+    run.completedAt = (/* @__PURE__ */ new Date()).toISOString();
+    run.updatedAt = run.completedAt;
+    this.emit(run, { type: "workflow.status", status: "failed", payload: { error: run.error } });
+  }
+  toStatus(run) {
+    return { workflowId: run.workflowId, status: run.status, project: run.project, mode: run.mode, nodes: run.nodes, createdAt: run.createdAt, updatedAt: run.updatedAt, completedAt: run.completedAt, error: run.error };
+  }
+  emit(run, partial) {
+    const ev = { workflowId: run.workflowId, seq: run.seq++, timestamp: (/* @__PURE__ */ new Date()).toISOString(), ...partial };
+    this.opts.emit(ev);
+  }
+};
+
 // ../core/dist/env-manager.js
 init_rpc();
 function redact(value) {
@@ -3762,7 +4161,7 @@ ${message}`;
     return void 0;
   }
   run(args2, signal, environment) {
-    return new Promise((resolve5, reject) => {
+    return new Promise((resolve6, reject) => {
       const child = spawn2("openclaw", args2, { cwd: this.cwd, env: { ...process.env, ...environment ?? {} } });
       this.current = child;
       let out = "";
@@ -3780,9 +4179,9 @@ ${message}`;
         signal?.removeEventListener("abort", onAbort);
         this.current = void 0;
         if (killed)
-          return resolve5(null);
+          return resolve6(null);
         if (code === 0)
-          resolve5(out);
+          resolve6(out);
         else
           reject(new Error(`openclaw exited ${code}: ${err.slice(0, 500)}`));
       });
@@ -3834,12 +4233,12 @@ var OpenClawAdapter = class {
     return new OpenClawSession(params.sessionId, params.model, params.cwd, openclawAgent);
   }
   probeVersion() {
-    return new Promise((resolve5) => {
+    return new Promise((resolve6) => {
       const child = spawn2("openclaw", ["--version"]);
       let out = "";
       child.stdout.on("data", (d) => out += d.toString());
-      child.on("error", () => resolve5(null));
-      child.on("close", (code) => resolve5(code === 0 ? out.trim() : null));
+      child.on("error", () => resolve6(null));
+      child.on("close", (code) => resolve6(code === 0 ? out.trim() : null));
     });
   }
 };
@@ -3872,7 +4271,7 @@ var GatewayClient = class {
     return this.connectPromise;
   }
   doConnect() {
-    return new Promise((resolve5, reject) => {
+    return new Promise((resolve6, reject) => {
       const wsUrl = this.config.baseUrl.replace(/^http/, "ws");
       const ws = new WebSocket(wsUrl);
       this.ws = ws;
@@ -3903,7 +4302,7 @@ var GatewayClient = class {
           } else if (frame.type === "res" && frame.ok && frame.payload?.type === "hello-ok") {
             handshakeDone = true;
             this.connected = true;
-            resolve5();
+            resolve6();
           } else if (frame.type === "res" && !frame.ok) {
             reject(new Error(`handshake failed: ${JSON.stringify(frame.error)}`));
           }
@@ -3949,13 +4348,13 @@ var GatewayClient = class {
   async rpc(method, params, timeoutMs = 12e4) {
     if (!this.connected)
       await this.connect();
-    return new Promise((resolve5, reject) => {
+    return new Promise((resolve6, reject) => {
       const id = randomUUID();
       const timer = setTimeout(() => {
         this.pending.delete(id);
         reject(new Error(`RPC timeout: ${method}`));
       }, timeoutMs);
-      this.pending.set(id, { resolve: resolve5, reject, timer });
+      this.pending.set(id, { resolve: resolve6, reject, timer });
       this.ws.send(JSON.stringify({ type: "req", id, method, params }));
     });
   }
@@ -4082,14 +4481,14 @@ var GatewaySession = class {
 
 ${input}`;
     }
-    await new Promise((resolve5) => {
+    await new Promise((resolve6) => {
       let settled = false;
       const finish = () => {
         if (settled)
           return;
         settled = true;
         clearTimeout(guard);
-        resolve5();
+        resolve6();
       };
       this.activeTurn = { turnId, emit, verbosity: opts.verbosity, done: finish, acc: "" };
       this.gw.rpc("chat.send", {
@@ -4350,7 +4749,7 @@ var PhononClient = class {
   }
   /** 连接并完成握手，resolve 后即可接收 server 的 session.* 下发。 */
   connect() {
-    return new Promise((resolve5, reject) => {
+    return new Promise((resolve6, reject) => {
       const ws = new WebSocket2(this.serverUrl);
       this.ws = ws;
       const transport = {
@@ -4392,7 +4791,7 @@ var PhononClient = class {
           if (wAck && wAck.length > 0) {
             conn.replayPending(wAck.map((a) => ({ sessionId: a.sessionId, fromSeq: a.lastSeq })));
           }
-          resolve5({ tenantId: welcome.tenantId });
+          resolve6({ tenantId: welcome.tenantId });
         } catch (err) {
           reject(err);
         }
@@ -4462,12 +4861,12 @@ var HookBridge = class {
     this.token = opts?.token;
   }
   listen(port = 4318, host = "127.0.0.1") {
-    return new Promise((resolve5) => {
+    return new Promise((resolve6) => {
       const server = createServer((req, res) => this.onRequest(req, res));
       this.server = server;
       server.listen(port, host, () => {
         const addr = server.address();
-        resolve5(typeof addr === "object" && addr ? addr.port : port);
+        resolve6(typeof addr === "object" && addr ? addr.port : port);
       });
     });
   }
@@ -4520,10 +4919,10 @@ var HookBridge = class {
     });
   }
   close() {
-    return new Promise((resolve5) => {
+    return new Promise((resolve6) => {
       if (!this.server)
-        return resolve5();
-      this.server.close(() => resolve5());
+        return resolve6();
+      this.server.close(() => resolve6());
     });
   }
 };
@@ -4708,7 +5107,7 @@ function normalizeOpenAiModels(data) {
   return out;
 }
 function fetchJson(url, headers) {
-  return new Promise((resolve5, reject) => {
+  return new Promise((resolve6, reject) => {
     const u = new URL(url);
     const req = (u.protocol === "http:" ? import("node:http") : import("node:https")).then((mod) => mod.request(url, { method: "GET", headers, timeout: 5e3 }, (res) => {
       let body = "";
@@ -4720,7 +5119,7 @@ function fetchJson(url, headers) {
           return;
         }
         try {
-          resolve5(JSON.parse(body));
+          resolve6(JSON.parse(body));
         } catch (e) {
           reject(e);
         }
@@ -4782,7 +5181,7 @@ ${prompt}`;
     await this.run(args2, prompt, turnId, emit, opts);
   }
   run(args2, stdin, turnId, emit, opts) {
-    return new Promise((resolve5) => {
+    return new Promise((resolve6) => {
       const child = spawn3(this.env.binPath ?? "codex", args2, {
         cwd: this.cwd,
         shell: process.platform === "win32",
@@ -4803,7 +5202,7 @@ ${prompt}`;
         } else {
           emit({ type: "result", sessionId: this.sessionId, turnId, seq: 0, at: (/* @__PURE__ */ new Date()).toISOString(), text, status, final: true });
         }
-        resolve5();
+        resolve6();
       };
       const guard = setTimeout(() => finish("timeout", acc), 18e5);
       opts.signal?.addEventListener("abort", () => {
@@ -4935,12 +5334,12 @@ var CodexAdapter = class {
     return base.length > 0 ? base : CODEX_FALLBACK_MODELS;
   }
   probeVersion() {
-    return new Promise((resolve5) => {
+    return new Promise((resolve6) => {
       const child = spawn3(this.env.binPath ?? "codex", ["--version"], { shell: process.platform === "win32" });
       let out = "";
       child.stdout.on("data", (d) => out += d.toString());
-      child.on("error", () => resolve5(null));
-      child.on("close", (code) => resolve5(code === 0 ? out.trim() : null));
+      child.on("error", () => resolve6(null));
+      child.on("close", (code) => resolve6(code === 0 ? out.trim() : null));
     });
   }
 };
@@ -5016,7 +5415,7 @@ ${message}`;
     await this.run(args2, turnId, emit, opts);
   }
   run(args2, turnId, emit, opts) {
-    return new Promise((resolve5) => {
+    return new Promise((resolve6) => {
       const child = spawn4(this.bin, args2, { cwd: this.cwd, stdio: ["ignore", "pipe", "pipe"], env: { ...process.env, ...opts.environment ?? {} } });
       this.current = child;
       let buf = "";
@@ -5033,7 +5432,7 @@ ${message}`;
         } else {
           emit({ type: "result", sessionId: this.sessionId, turnId, seq: 0, at: (/* @__PURE__ */ new Date()).toISOString(), text, status, final: true });
         }
-        resolve5();
+        resolve6();
       };
       const guard = setTimeout(() => finish("timeout", acc), 18e5);
       opts.signal?.addEventListener("abort", () => {
@@ -5164,12 +5563,12 @@ var OpenCodeAdapter = class {
     return new OpenCodeSession(params.sessionId, model, params.cwd, this.bin);
   }
   probeVersion() {
-    return new Promise((resolve5) => {
+    return new Promise((resolve6) => {
       const child = spawn4(this.bin, ["--version"]);
       let out = "";
       child.stdout.on("data", (d) => out += d.toString());
-      child.on("error", () => resolve5(null));
-      child.on("close", (code) => resolve5(code === 0 ? out.trim() : null));
+      child.on("error", () => resolve6(null));
+      child.on("close", (code) => resolve6(code === 0 ? out.trim() : null));
     });
   }
 };
@@ -5234,7 +5633,7 @@ function parseHermesConfig(configPath = join9(homedir7(), ".hermes", "config.yam
   return { defaultModel, provider, catalogUrl };
 }
 function fetchHermesCatalogModels(url, provider) {
-  return new Promise((resolve5) => {
+  return new Promise((resolve6) => {
     const u = new URL(url);
     const reqMod = u.protocol === "http:" ? import("node:http") : import("node:https");
     reqMod.then((mod) => {
@@ -5248,21 +5647,21 @@ function fetchHermesCatalogModels(url, provider) {
             const providers = data.providers ?? {};
             const rows = provider ? providers[provider]?.models ?? [] : Object.values(providers).flatMap((p) => p.models ?? []);
             const seen = /* @__PURE__ */ new Set();
-            resolve5(rows.flatMap((m) => {
+            resolve6(rows.flatMap((m) => {
               if (!m.id || seen.has(m.id))
                 return [];
               seen.add(m.id);
               return [{ id: m.id, ...m.description ? { displayName: m.description } : {}, available: true }];
             }));
           } catch {
-            resolve5([]);
+            resolve6([]);
           }
         });
       });
       req.on("timeout", () => req.destroy());
-      req.on("error", () => resolve5([]));
+      req.on("error", () => resolve6([]));
       req.end();
-    }, () => resolve5([]));
+    }, () => resolve6([]));
   });
 }
 var HermesSession = class {
@@ -5310,7 +5709,7 @@ ${prompt}`;
     await this.run(args2, turnId, emit, opts);
   }
   run(args2, turnId, emit, opts) {
-    return new Promise((resolve5) => {
+    return new Promise((resolve6) => {
       const child = spawn5(this.env.binPath ?? "hermes", args2, {
         cwd: this.cwd,
         shell: process.platform === "win32",
@@ -5333,7 +5732,7 @@ ${prompt}`;
             emit({ type: "message", sessionId: this.sessionId, turnId, seq: 0, at: (/* @__PURE__ */ new Date()).toISOString(), role: "assistant", text, delta: false });
           emit({ type: "result", sessionId: this.sessionId, turnId, seq: 0, at: (/* @__PURE__ */ new Date()).toISOString(), text, status, final: true });
         }
-        resolve5();
+        resolve6();
       };
       const guard = setTimeout(() => finish("timeout", out), 18e5);
       opts.signal?.addEventListener("abort", () => {
@@ -5493,11 +5892,11 @@ var HermesAdapter = class {
   }
   /** 枚举 Hermes profile（去 ANSI 色解析 profile list）。 */
   listProfiles() {
-    return new Promise((resolve5) => {
+    return new Promise((resolve6) => {
       const child = spawn5(this.env.binPath ?? "hermes", ["profile", "list"], { shell: process.platform === "win32" });
       let out = "";
       child.stdout.on("data", (d) => out += d.toString());
-      child.on("error", () => resolve5([{ name: this.defaultProfile }]));
+      child.on("error", () => resolve6([{ name: this.defaultProfile }]));
       child.on("close", () => {
         const clean = out.replace(/\u001b\[[0-9;]*m/g, "");
         const names = [];
@@ -5508,17 +5907,17 @@ var HermesAdapter = class {
             names.push({ name: m[1], model: rest[0] || void 0 });
           }
         }
-        resolve5(names.length > 0 ? names : [{ name: this.defaultProfile }]);
+        resolve6(names.length > 0 ? names : [{ name: this.defaultProfile }]);
       });
     });
   }
   probeVersion() {
-    return new Promise((resolve5) => {
+    return new Promise((resolve6) => {
       const child = spawn5(this.env.binPath ?? "hermes", ["--version"], { shell: process.platform === "win32" });
       let out = "";
       child.stdout.on("data", (d) => out += d.toString());
-      child.on("error", () => resolve5(null));
-      child.on("close", (code) => resolve5(code === 0 ? out.trim().split("\n")[0] ?? "hermes" : null));
+      child.on("error", () => resolve6(null));
+      child.on("close", (code) => resolve6(code === 0 ? out.trim().split("\n")[0] ?? "hermes" : null));
     });
   }
 };
@@ -5741,7 +6140,7 @@ ${prompt}`;
     await this.run(args2, envelope, turnId, emit, opts);
   }
   run(args2, stdin, turnId, emit, opts) {
-    return new Promise((resolve5) => {
+    return new Promise((resolve6) => {
       const childEnv = {};
       for (const [k, v] of Object.entries(process.env)) {
         if (k === "CLAUDECODE" || k.startsWith("CLAUDECODE_") || k.startsWith("CLAUDE_CODE_"))
@@ -5773,7 +6172,7 @@ ${prompt}`;
         } else {
           emit({ type: "result", sessionId: this.sessionId, turnId, seq: 0, at: (/* @__PURE__ */ new Date()).toISOString(), text, status, final: true });
         }
-        resolve5();
+        resolve6();
       };
       const guard = setTimeout(() => finish("timeout", acc), 18e5);
       opts.signal?.addEventListener("abort", () => {
@@ -5890,12 +6289,12 @@ var ClaudeCodeAdapter = class {
     return new ClaudeCodeSession(params.sessionId, params.model, params.cwd, this.env);
   }
   probeVersion() {
-    return new Promise((resolve5) => {
+    return new Promise((resolve6) => {
       const child = spawn6(this.env.binPath ?? "claude", ["--version"], { shell: process.platform === "win32" });
       let out = "";
       child.stdout.on("data", (d) => out += d.toString());
-      child.on("error", () => resolve5(null));
-      child.on("close", (code) => resolve5(code === 0 ? out.trim() : null));
+      child.on("error", () => resolve6(null));
+      child.on("close", (code) => resolve6(code === 0 ? out.trim() : null));
     });
   }
 };
@@ -5914,7 +6313,9 @@ var MUTATING_METHODS = /* @__PURE__ */ new Set([
   "file.write",
   "file.mkdir",
   "env.set",
-  "env.delete"
+  "env.delete",
+  "workflow.run",
+  "workflow.cancel"
 ]);
 var PhononConnection = class {
   tenantId;
@@ -5930,6 +6331,7 @@ var PhononConnection = class {
   files;
   env;
   obs;
+  workflows;
   /** 该 tenant 绑定的默认项目工作目录解析器（v0 简化：projectId 即绝对路径或映射）。 */
   resolveProjectCwd;
   constructor(opts) {
@@ -5940,6 +6342,7 @@ var PhononConnection = class {
     this.idempotency = new IdempotencyStore({ store: this.store });
     this.outbox = new Outbox({ store: this.store, tenantId: opts.tenantId });
     this.engine = new SessionEngine(opts.registry, (event) => {
+      this.workflows?.onStreamEvent(event);
       this.outbox.enqueue(event);
       this.peer.notifyRaw("stream.event", event);
     }, opts.obs, this.store);
@@ -5969,6 +6372,13 @@ var PhononConnection = class {
     this.env = new EnvManager(this.store, { allowReveal: () => this.policy.allowEnvReveal() });
     this.resolveProjectCwd = opts.resolveProjectCwd ?? ((p) => this.projects.resolveCwd(p));
     this.peer = new RpcPeer(opts.transport, (method, params) => this.dispatch(method, params));
+    this.workflows = new WorkflowEngine({
+      tenantId: this.tenantId,
+      engine: this.engine,
+      resolveCwd: (projectId, worktreeId) => this.projects.resolveCwd(projectId, worktreeId),
+      env: this.env,
+      emit: (event) => this.peer.notifyRaw("workflow.event", event)
+    });
   }
   /** 喂入收到的文本。 */
   handle(data) {
@@ -6210,6 +6620,17 @@ var PhononConnection = class {
       }
       case "skill.list":
         return { skills: this.skills.list({ agent: p.agent, scope: p.scope, projectId: p.projectId }) };
+      case "skill.dirs":
+        return { directories: await this.skills.dirs({ agent: p.agent, scope: p.scope, projectId: p.projectId }) };
+      // ---- L3 workflow orchestration ----
+      case "workflow.run":
+        return this.workflows.run({ project: p.project, worktreeId: p.worktreeId, plan: p.plan, input: p.input, metadata: p.metadata });
+      case "workflow.status":
+        return this.workflows.status(p.workflowId);
+      case "workflow.cancel":
+        return this.workflows.cancel(p.workflowId, p.reason);
+      case "workflow.list":
+        return this.workflows.list(p);
       // ---- 连接/可靠性（s2p） ----
       case "stream.ack": {
         this.outbox.ack(p.sessionId, p.lastSeq);
@@ -6301,9 +6722,9 @@ function readOpenClawGatewayToken() {
 
 // src/commands.ts
 import { spawnSync } from "node:child_process";
-import { existsSync as existsSync12, cpSync, mkdirSync as mkdirSync4, rmSync as rmSync3, writeFileSync as writeFileSync4, readFileSync as readFileSync7 } from "node:fs";
+import { existsSync as existsSync12, cpSync, mkdirSync as mkdirSync4, rmSync as rmSync3, writeFileSync as writeFileSync4, readFileSync as readFileSync7, chmodSync as chmodSync3 } from "node:fs";
 import { homedir as homedir10, platform as platform2 } from "node:os";
-import { join as join12, dirname as dirname5, delimiter } from "node:path";
+import { join as join12, dirname as dirname5, delimiter, resolve as resolve5 } from "node:path";
 import { fileURLToPath } from "node:url";
 function probe(bin, args2 = ["--version"]) {
   const r = spawnSync(bin, args2, { timeout: 8e3, shell: platform2() === "win32" });
@@ -6483,6 +6904,75 @@ function cmdAdapterList() {
     console.log(`- ${a.type}${a.defaultAgent ? ` (agent: ${a.defaultAgent})` : ""}${auto}`);
   }
 }
+function systemctlUser(args2) {
+  const r = spawnSync("systemctl", ["--user", ...args2], { stdio: "inherit" });
+  if (r.status !== 0) fail(`systemctl --user ${args2.join(" ")} failed`);
+}
+function serviceUnitPath() {
+  return join12(homedir10(), ".config", "systemd", "user", "agent-phonon.service");
+}
+function serviceUnitContent() {
+  const node = process.execPath;
+  const cli = resolve5(process.argv[1] ?? fileURLToPath(import.meta.url));
+  return `[Unit]
+Description=agent-phonon device daemon
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+ExecStart=${node} ${cli} start
+Restart=always
+RestartSec=5
+MemoryMax=256M
+
+[Install]
+WantedBy=default.target
+`;
+}
+function cmdService(sub, opts = {}) {
+  if (platform2() !== "linux") {
+    fail(`service ${sub ?? ""} is currently implemented for Linux systemd --user only (platform=${platform2()})`);
+  }
+  const unit = serviceUnitPath();
+  switch (sub) {
+    case "install": {
+      if (existsSync12(unit) && !opts.force) fail(`${unit} already exists (use --force to overwrite)`);
+      mkdirSync4(dirname5(unit), { recursive: true });
+      writeFileSync4(unit, serviceUnitContent(), { mode: 420 });
+      chmodSync3(unit, 420);
+      systemctlUser(["daemon-reload"]);
+      systemctlUser(["enable", "agent-phonon.service"]);
+      console.log(`installed systemd user service \u2192 ${unit}`);
+      console.log("start it with: agent-phonon service start");
+      if (!existsSync12(join12(homedir10(), ".agent-phonon", "config.json"))) console.log("config not found yet; run: agent-phonon init");
+      break;
+    }
+    case "start":
+      systemctlUser(["start", "agent-phonon.service"]);
+      console.log("started agent-phonon.service");
+      break;
+    case "stop":
+      systemctlUser(["stop", "agent-phonon.service"]);
+      console.log("stopped agent-phonon.service");
+      break;
+    case "restart":
+      systemctlUser(["restart", "agent-phonon.service"]);
+      console.log("restarted agent-phonon.service");
+      break;
+    case "status":
+      systemctlUser(["status", "agent-phonon.service", "--no-pager"]);
+      break;
+    case "uninstall":
+      systemctlUser(["disable", "--now", "agent-phonon.service"]);
+      rmSync3(unit, { force: true });
+      systemctlUser(["daemon-reload"]);
+      console.log(`removed ${unit}`);
+      break;
+    default:
+      fail("usage: agent-phonon service install|start|stop|restart|status|uninstall [--force]");
+  }
+}
 function cmdPluginInstall(which) {
   if (which !== "openclaw") return fail(`plugin install supports: openclaw (got: ${which})`);
   const here = dirname5(fileURLToPath(import.meta.url));
@@ -6521,13 +7011,13 @@ var ObsServer = class {
     deps.bus.onEvent((e) => this.broadcast(e));
   }
   listen(port = 4319, host = "127.0.0.1") {
-    return new Promise((resolve5) => {
+    return new Promise((resolve6) => {
       const server = createServer2((req, res) => this.handle(req, res));
       this.server = server;
       server.listen(port, host, () => {
         const addr = server.address();
         this.actualPort = typeof addr === "object" && addr ? addr.port : port;
-        resolve5(this.actualPort);
+        resolve6(this.actualPort);
       });
     });
   }
@@ -6605,11 +7095,11 @@ var ObsServer = class {
     return this.actualPort;
   }
   close() {
-    return new Promise((resolve5) => {
+    return new Promise((resolve6) => {
       for (const c of this.sseClients) c.end();
       this.sseClients.clear();
-      if (!this.server) return resolve5();
-      this.server.close(() => resolve5());
+      if (!this.server) return resolve6();
+      this.server.close(() => resolve6());
     });
   }
 };
@@ -6835,6 +7325,10 @@ async function main() {
       }
       break;
     }
+    case "service": {
+      cmdService(args[0], { force: flag("force") });
+      break;
+    }
     case "plugin": {
       const sub = args[0];
       if (sub === "install") cmdPluginInstall(args[1] ?? "");
@@ -6852,6 +7346,7 @@ async function main() {
       console.log("  adapter add <type> [opts]     configure an adapter override (auto-detect covers common local agents)");
       console.log("  adapter list                  list configured + auto-detected adapters");
       console.log("  plugin install openclaw       install OpenClaw HITL plugin");
+      console.log("  service install|start|status  manage Linux systemd --user service");
       console.log("  server add <url> [--trust-local] [--device-key <k>]");
       console.log("  server list");
       console.log("  config [--show-secrets]       show config (redacted by default)");