server for rowboatx

apps/cli/src/entities/example.ts

@@ -0,0 +1,12 @@
+import z from "zod"
+import { Agent } from "../agents/agents.js"
+import { McpServerDefinition } from "../mcp/mcp.js";
+
+export const Example = z.object({
+    id: z.string(),
+    instructions: z.string().optional(),
+    description: z.string().optional(),
+    entryAgent: z.string().optional(),
+    agents: z.array(Agent).optional(),
+    mcpServers: z.record(z.string(), McpServerDefinition).optional(),
+});

apps/cli/src/entities/llm-step-events.ts

@@ -0,0 +1,63 @@
+import { z } from "zod";
+import { ProviderOptions } from "./message.js";
+
+const BaseEvent = z.object({
+    providerOptions: ProviderOptions.optional(),
+})
+
+export const LlmStepStreamReasoningStartEvent = BaseEvent.extend({
+    type: z.literal("reasoning-start"),
+});
+
+export const LlmStepStreamReasoningDeltaEvent = BaseEvent.extend({
+    type: z.literal("reasoning-delta"),
+    delta: z.string(),
+});
+
+export const LlmStepStreamReasoningEndEvent = BaseEvent.extend({
+    type: z.literal("reasoning-end"),
+});
+
+export const LlmStepStreamTextStartEvent = BaseEvent.extend({
+    type: z.literal("text-start"),
+});
+
+export const LlmStepStreamTextDeltaEvent = BaseEvent.extend({
+    type: z.literal("text-delta"),
+    delta: z.string(),
+});
+
+export const LlmStepStreamTextEndEvent = BaseEvent.extend({
+    type: z.literal("text-end"),
+});
+
+export const LlmStepStreamToolCallEvent = BaseEvent.extend({
+    type: z.literal("tool-call"),
+    toolCallId: z.string(),
+    toolName: z.string(),
+    input: z.any(),
+});
+
+export const LlmStepStreamFinishStepEvent = z.object({
+    type: z.literal("finish-step"),
+    finishReason: z.enum(["stop", "tool-calls", "length", "content-filter", "error", "other", "unknown"]),
+    usage: z.object({
+        inputTokens: z.number().optional(),
+        outputTokens: z.number().optional(),
+        totalTokens: z.number().optional(),
+        reasoningTokens: z.number().optional(),
+        cachedInputTokens: z.number().optional(),
+    }),
+    providerOptions: ProviderOptions.optional(),
+});
+
+export const LlmStepStreamEvent = z.union([
+    LlmStepStreamReasoningStartEvent,
+    LlmStepStreamReasoningDeltaEvent,
+    LlmStepStreamReasoningEndEvent,
+    LlmStepStreamTextStartEvent,
+    LlmStepStreamTextDeltaEvent,
+    LlmStepStreamTextEndEvent,
+    LlmStepStreamToolCallEvent,
+    LlmStepStreamFinishStepEvent,
+]);

apps/cli/src/entities/message.ts

@@ -0,0 +1,67 @@
+import { z } from "zod";
+
+export const ProviderOptions = z.record(z.string(), z.record(z.string(), z.json()));
+
+export const TextPart = z.object({
+    type: z.literal("text"),
+    text: z.string(),
+    providerOptions: ProviderOptions.optional(),
+});
+
+export const ReasoningPart = z.object({
+    type: z.literal("reasoning"),
+    text: z.string(),
+    providerOptions: ProviderOptions.optional(),
+});
+
+export const ToolCallPart = z.object({
+    type: z.literal("tool-call"),
+    toolCallId: z.string(),
+    toolName: z.string(),
+    arguments: z.any(),
+    providerOptions: ProviderOptions.optional(),
+});
+
+export const AssistantContentPart = z.union([
+    TextPart,
+    ReasoningPart,
+    ToolCallPart,
+]);
+
+export const UserMessage = z.object({
+    role: z.literal("user"),
+    content: z.string(),
+    providerOptions: ProviderOptions.optional(),
+});
+
+export const AssistantMessage = z.object({
+    role: z.literal("assistant"),
+    content: z.union([
+        z.string(),
+        z.array(AssistantContentPart),
+    ]),
+    providerOptions: ProviderOptions.optional(),
+});
+
+export const SystemMessage = z.object({
+    role: z.literal("system"),
+    content: z.string(),
+    providerOptions: ProviderOptions.optional(),
+});
+
+export const ToolMessage = z.object({
+    role: z.literal("tool"),
+    content: z.string(),
+    toolCallId: z.string(),
+    toolName: z.string(),
+    providerOptions: ProviderOptions.optional(),
+});
+
+export const Message = z.discriminatedUnion("role", [
+    AssistantMessage,
+    SystemMessage,
+    ToolMessage,
+    UserMessage,
+]);
+
+export const MessageList = z.array(Message);

apps/cli/src/entities/run-events.ts

@@ -0,0 +1,85 @@
+import { LlmStepStreamEvent } from "./llm-step-events.js";
+import { Message, ToolCallPart } from "./message.js";
+import z from "zod";
+
+const BaseRunEvent = z.object({
+    runId: z.string(),
+    ts: z.iso.datetime().optional(),
+    subflow: z.array(z.string()),
+});
+
+export const StartEvent = BaseRunEvent.extend({
+    type: z.literal("start"),
+    agentName: z.string(),
+});
+
+export const SpawnSubFlowEvent = BaseRunEvent.extend({
+    type: z.literal("spawn-subflow"),
+    agentName: z.string(),
+    toolCallId: z.string(),
+});
+
+export const LlmStreamEvent = BaseRunEvent.extend({
+    type: z.literal("llm-stream-event"),
+    event: LlmStepStreamEvent,
+});
+
+export const MessageEvent = BaseRunEvent.extend({
+    type: z.literal("message"),
+    messageId: z.string(),
+    message: Message,
+});
+
+export const ToolInvocationEvent = BaseRunEvent.extend({
+    type: z.literal("tool-invocation"),
+    toolName: z.string(),
+    input: z.string(),
+});
+
+export const ToolResultEvent = BaseRunEvent.extend({
+    type: z.literal("tool-result"),
+    toolName: z.string(),
+    result: z.any(),
+});
+
+export const AskHumanRequestEvent = BaseRunEvent.extend({
+    type: z.literal("ask-human-request"),
+    toolCallId: z.string(),
+    query: z.string(),
+});
+
+export const AskHumanResponseEvent = BaseRunEvent.extend({
+    type: z.literal("ask-human-response"),
+    toolCallId: z.string(),
+    response: z.string(),
+});
+
+export const ToolPermissionRequestEvent = BaseRunEvent.extend({
+    type: z.literal("tool-permission-request"),
+    toolCall: ToolCallPart,
+});
+
+export const ToolPermissionResponseEvent = BaseRunEvent.extend({
+    type: z.literal("tool-permission-response"),
+    toolCallId: z.string(),
+    response: z.enum(["approve", "deny"]),
+});
+
+export const RunErrorEvent = BaseRunEvent.extend({
+    type: z.literal("error"),
+    error: z.string(),
+});
+
+export const RunEvent = z.union([
+    StartEvent,
+    SpawnSubFlowEvent,
+    LlmStreamEvent,
+    MessageEvent,
+    ToolInvocationEvent,
+    ToolResultEvent,
+    AskHumanRequestEvent,
+    AskHumanResponseEvent,
+    ToolPermissionRequestEvent,
+    ToolPermissionResponseEvent,
+    RunErrorEvent,
+]);