@agent-phonon/protocol 0.2.10 → 0.3.0

package/dist/schemas/workflow.d.ts.map

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

package/dist/schemas/workflow.js

@@ -0,0 +1,116 @@
+import { z } from "zod";
+import { AgentId, ProjectId, SessionId, Timestamp } from "./common.js";
+const ModelId = z.string().min(1);
+const TurnId = z.string().min(1);
+const ClientRequestId = z.string().min(1);
+export const WorkflowId = z.string().min(1);
+export const WorkflowNodeId = z.string().min(1);
+export const WorkflowEdgeId = z.string().min(1);
+export const WorkflowRoleId = z.string().min(1);
+export const WorkflowNode = z.object({
+    nodeId: WorkflowNodeId,
+    agent: AgentId,
+    model: ModelId,
+    role: WorkflowRoleId.optional(),
+    input: z.string().optional(),
+    systemPrompt: z.string().optional(),
+    dependsOn: z.array(WorkflowNodeId).optional(),
+    sessionId: SessionId.optional(),
+    agentConfig: z.record(z.unknown()).optional(),
+    metadata: z.record(z.unknown()).optional(),
+});
+export const WorkflowEdge = z.object({
+    edgeId: WorkflowEdgeId.optional(),
+    from: WorkflowNodeId,
+    to: WorkflowNodeId,
+    label: z.string().optional(),
+    condition: z.string().optional(),
+    metadata: z.record(z.unknown()).optional(),
+});
+export const WorkflowDagPlan = z.object({
+    mode: z.literal("dag"),
+    nodes: z.array(WorkflowNode).min(1),
+    edges: z.array(WorkflowEdge).optional(),
+    finalNodeId: WorkflowNodeId.optional(),
+});
+export const WorkflowCommunicationGraph = z.object({
+    edges: z.array(WorkflowEdge).default([]),
+    allowSelfLoop: z.boolean().default(false),
+    maxIterations: z.number().int().positive().default(12),
+});
+export const WorkflowGraphPlan = z.object({
+    mode: z.literal("graph"),
+    executor: z.object({
+        nodeId: WorkflowNodeId,
+        agent: AgentId,
+        model: ModelId,
+        role: z.literal("executor").default("executor"),
+        systemPrompt: z.string().optional(),
+        agentConfig: z.record(z.unknown()).optional(),
+    }),
+    workers: z.array(WorkflowNode).min(1),
+    communicationGraph: WorkflowCommunicationGraph,
+});
+export const WorkflowPlan = z.discriminatedUnion("mode", [WorkflowDagPlan, WorkflowGraphPlan]);
+export const WorkflowStatus = z.enum(["queued", "running", "completed", "failed", "cancelled", "timeout"]);
+export const WorkflowNodeStatus = z.enum(["pending", "ready", "running", "completed", "failed", "skipped", "cancelled"]);
+export const WorkflowRunParams = z.object({
+    project: ProjectId,
+    worktreeId: z.string().optional(),
+    plan: WorkflowPlan,
+    input: z.string().optional(),
+    clientRequestId: ClientRequestId.optional(),
+    metadata: z.record(z.unknown()).optional(),
+});
+export const WorkflowRunResult = z.object({
+    workflowId: WorkflowId,
+    status: WorkflowStatus,
+    createdAt: Timestamp,
+});
+export const WorkflowStatusParams = z.object({ workflowId: WorkflowId });
+export const WorkflowNodeRuntime = z.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: z.string().optional(),
+});
+export const WorkflowStatusResult = z.object({
+    workflowId: WorkflowId,
+    status: WorkflowStatus,
+    project: ProjectId,
+    mode: z.enum(["dag", "graph"]),
+    nodes: z.array(WorkflowNodeRuntime),
+    createdAt: Timestamp,
+    updatedAt: Timestamp,
+    completedAt: Timestamp.optional(),
+    error: z.string().optional(),
+});
+export const WorkflowCancelParams = z.object({ workflowId: WorkflowId, reason: z.string().optional() });
+export const WorkflowCancelResult = z.object({ workflowId: WorkflowId, status: z.literal("cancelled") });
+export const WorkflowListParams = z.object({
+    status: WorkflowStatus.optional(),
+    limit: z.number().int().positive().max(100).default(50).optional(),
+    cursor: z.string().optional(),
+});
+export const WorkflowListResult = z.object({ workflows: z.array(WorkflowStatusResult), nextCursor: z.string().optional() });
+export const WorkflowEvent = z.object({
+    workflowId: WorkflowId,
+    seq: z.number().int().nonnegative(),
+    type: z.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: z.union([WorkflowStatus, WorkflowNodeStatus]).optional(),
+    payload: z.record(z.unknown()).optional(),
+    timestamp: Timestamp,
+});
+//# sourceMappingURL=workflow.js.map

package/dist/schemas/workflow.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-phonon/protocol",
-  "version": "0.2.10",
+  "version": "0.3.0",
   "description": "Wire protocol (zod schemas + types) for agent-phonon — the single source of truth contract between phonon devices and servers.",
   "license": "MIT",
   "type": "module",

package/src/index.ts

@@ -20,5 +20,6 @@ export * from "./schemas/connect.js";
 export * from "./schemas/device.js";
 export * from "./schemas/file.js";
 export * from "./schemas/env.js";
+export * from "./schemas/workflow.js";
 export * from "./schemas/jsonrpc.js";
 export * from "./schemas/methods.js";

package/src/schemas/methods.ts

@@ -68,6 +68,8 @@ import {
   SkillUninstallResult,
   SkillListParams,
   SkillListResult,
+  SkillDirsParams,
+  SkillDirsResult,
 } from "./skill.js";
 import { DeviceInfoParams, DeviceInfoResult, DeviceResourcesParams, DeviceResourcesResult } from "./device.js";
 import {
@@ -83,6 +85,17 @@ import {
   FileMkdirResult,
 } from "./file.js";
 import { EnvSetParams, EnvSetResult, EnvListParams, EnvListResult, EnvDeleteParams, EnvDeleteResult } from "./env.js";
+import {
+  WorkflowRunParams,
+  WorkflowRunResult,
+  WorkflowStatusParams,
+  WorkflowStatusResult,
+  WorkflowCancelParams,
+  WorkflowCancelResult,
+  WorkflowListParams,
+  WorkflowListResult,
+  WorkflowEvent,
+} from "./workflow.js";
 
 /**
  * 方法注册表（design 全协议的单一事实来源）。
@@ -384,6 +397,44 @@ export const METHODS = {
     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,
+  },
 } as const;
 
 export type MethodName = keyof typeof METHODS;

package/src/schemas/skill.ts

@@ -119,3 +119,33 @@ export const SkillListResult = z.object({
   skills: z.array(SkillDescriptor),
 });
 export type SkillListResult = z.infer<typeof SkillListResult>;
+
+// --- skill.dirs ---
+export const SkillDirsParams = z.object({
+  /** 可选：global scope 的目标 agent。 */
+  agent: AgentId.optional(),
+  /** 可选：project scope 的目标项目。 */
+  projectId: ProjectId.optional(),
+  /** 可选：只查 global 或 project；不传时按 agent/projectId 返回可查范围。 */
+  scope: SkillScope.optional(),
+});
+export type SkillDirsParams = z.infer<typeof SkillDirsParams>;
+
+export const SkillDirectoryDescriptor = z.object({
+  /** skill 目录名。 */
+  name: z.string().min(1),
+  scope: SkillScope,
+  agent: AgentId.optional(),
+  projectId: ProjectId.optional(),
+  /** scope 根目录（global skill root 或 <project>/.agent/skills）。 */
+  rootPath: z.string().min(1),
+  /** skill 目录真实本机路径。 */
+  path: z.string().min(1),
+  exists: z.boolean(),
+});
+export type SkillDirectoryDescriptor = z.infer<typeof SkillDirectoryDescriptor>;
+
+export const SkillDirsResult = z.object({
+  directories: z.array(SkillDirectoryDescriptor),
+});
+export type SkillDirsResult = z.infer<typeof SkillDirsResult>;

package/src/schemas/workflow.ts

@@ -0,0 +1,151 @@
+import { z } from "zod";
+import { AgentId, ProjectId, SessionId, Timestamp } from "./common.js";
+
+const ModelId = z.string().min(1);
+const TurnId = z.string().min(1);
+const ClientRequestId = z.string().min(1);
+
+export const WorkflowId = z.string().min(1);
+export const WorkflowNodeId = z.string().min(1);
+export const WorkflowEdgeId = z.string().min(1);
+export const WorkflowRoleId = z.string().min(1);
+
+export const WorkflowNode = z.object({
+  nodeId: WorkflowNodeId,
+  agent: AgentId,
+  model: ModelId,
+  role: WorkflowRoleId.optional(),
+  input: z.string().optional(),
+  systemPrompt: z.string().optional(),
+  dependsOn: z.array(WorkflowNodeId).optional(),
+  sessionId: SessionId.optional(),
+  agentConfig: z.record(z.unknown()).optional(),
+  metadata: z.record(z.unknown()).optional(),
+});
+export type WorkflowNode = z.infer<typeof WorkflowNode>;
+
+export const WorkflowEdge = z.object({
+  edgeId: WorkflowEdgeId.optional(),
+  from: WorkflowNodeId,
+  to: WorkflowNodeId,
+  label: z.string().optional(),
+  condition: z.string().optional(),
+  metadata: z.record(z.unknown()).optional(),
+});
+export type WorkflowEdge = z.infer<typeof WorkflowEdge>;
+
+export const WorkflowDagPlan = z.object({
+  mode: z.literal("dag"),
+  nodes: z.array(WorkflowNode).min(1),
+  edges: z.array(WorkflowEdge).optional(),
+  finalNodeId: WorkflowNodeId.optional(),
+});
+export type WorkflowDagPlan = z.infer<typeof WorkflowDagPlan>;
+
+export const WorkflowCommunicationGraph = z.object({
+  edges: z.array(WorkflowEdge).default([]),
+  allowSelfLoop: z.boolean().default(false),
+  maxIterations: z.number().int().positive().default(12),
+});
+export type WorkflowCommunicationGraph = z.infer<typeof WorkflowCommunicationGraph>;
+
+export const WorkflowGraphPlan = z.object({
+  mode: z.literal("graph"),
+  executor: z.object({
+    nodeId: WorkflowNodeId,
+    agent: AgentId,
+    model: ModelId,
+    role: z.literal("executor").default("executor"),
+    systemPrompt: z.string().optional(),
+    agentConfig: z.record(z.unknown()).optional(),
+  }),
+  workers: z.array(WorkflowNode).min(1),
+  communicationGraph: WorkflowCommunicationGraph,
+});
+export type WorkflowGraphPlan = z.infer<typeof WorkflowGraphPlan>;
+
+export const WorkflowPlan = z.discriminatedUnion("mode", [WorkflowDagPlan, WorkflowGraphPlan]);
+export type WorkflowPlan = z.infer<typeof WorkflowPlan>;
+
+export const WorkflowStatus = z.enum(["queued", "running", "completed", "failed", "cancelled", "timeout"]);
+export type WorkflowStatus = z.infer<typeof WorkflowStatus>;
+
+export const WorkflowNodeStatus = z.enum(["pending", "ready", "running", "completed", "failed", "skipped", "cancelled"]);
+export type WorkflowNodeStatus = z.infer<typeof WorkflowNodeStatus>;
+
+export const WorkflowRunParams = z.object({
+  project: ProjectId,
+  worktreeId: z.string().optional(),
+  plan: WorkflowPlan,
+  input: z.string().optional(),
+  clientRequestId: ClientRequestId.optional(),
+  metadata: z.record(z.unknown()).optional(),
+});
+export type WorkflowRunParams = z.infer<typeof WorkflowRunParams>;
+
+export const WorkflowRunResult = z.object({
+  workflowId: WorkflowId,
+  status: WorkflowStatus,
+  createdAt: Timestamp,
+});
+export type WorkflowRunResult = z.infer<typeof WorkflowRunResult>;
+
+export const WorkflowStatusParams = z.object({ workflowId: WorkflowId });
+export type WorkflowStatusParams = z.infer<typeof WorkflowStatusParams>;
+
+export const WorkflowNodeRuntime = z.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: z.string().optional(),
+});
+export type WorkflowNodeRuntime = z.infer<typeof WorkflowNodeRuntime>;
+
+export const WorkflowStatusResult = z.object({
+  workflowId: WorkflowId,
+  status: WorkflowStatus,
+  project: ProjectId,
+  mode: z.enum(["dag", "graph"]),
+  nodes: z.array(WorkflowNodeRuntime),
+  createdAt: Timestamp,
+  updatedAt: Timestamp,
+  completedAt: Timestamp.optional(),
+  error: z.string().optional(),
+});
+export type WorkflowStatusResult = z.infer<typeof WorkflowStatusResult>;
+
+export const WorkflowCancelParams = z.object({ workflowId: WorkflowId, reason: z.string().optional() });
+export type WorkflowCancelParams = z.infer<typeof WorkflowCancelParams>;
+export const WorkflowCancelResult = z.object({ workflowId: WorkflowId, status: z.literal("cancelled") });
+export type WorkflowCancelResult = z.infer<typeof WorkflowCancelResult>;
+
+export const WorkflowListParams = z.object({
+  status: WorkflowStatus.optional(),
+  limit: z.number().int().positive().max(100).default(50).optional(),
+  cursor: z.string().optional(),
+});
+export type WorkflowListParams = z.infer<typeof WorkflowListParams>;
+export const WorkflowListResult = z.object({ workflows: z.array(WorkflowStatusResult), nextCursor: z.string().optional() });
+export type WorkflowListResult = z.infer<typeof WorkflowListResult>;
+
+export const WorkflowEvent = z.object({
+  workflowId: WorkflowId,
+  seq: z.number().int().nonnegative(),
+  type: z.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: z.union([WorkflowStatus, WorkflowNodeStatus]).optional(),
+  payload: z.record(z.unknown()).optional(),
+  timestamp: Timestamp,
+});
+export type WorkflowEvent = z.infer<typeof WorkflowEvent>;