agent-phonon 0.2.11 → 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();
   }
@@ -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) {
@@ -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);