feat: add tool payload schemas

bun.lock

@@ -158,9 +158,6 @@
     "packages/freya-agent-protocol": {
       "name": "@freya/agent-protocol",
       "version": "0.0.0",
-      "dependencies": {
-        "@freya/core": "workspace:*",
-      },
     },
     "packages/freya-components": {
       "name": "@freya/components",

packages/freya-agent-protocol/package.json

@@ -6,8 +6,5 @@
 	"types": "src/index.ts",
 	"scripts": {
 		"test": "bun test ./src"
-	},
-	"dependencies": {
-		"@freya/core": "workspace:*"
 	}
 }

packages/freya-agent-protocol/src/index.test.ts

@@ -1,40 +1,20 @@
-import { ConversationEntryKind, ConversationEntryVisibility } from "@freya/core"
 import { describe, expect, test } from "bun:test"
 
-import { AgentEventKind, type AgentEvent, type AgentServerApi } from "./index"
+import type { AgentEvent, AgentServerApi } from "./index"
 
 describe("agent protocol", () => {
 	test("defines server methods and agent events", () => {
 		const server: AgentServerApi = {
 			async sendMessage(message) {
-				return {
-					id: "entry-1",
-					conversationId: "conversation-1",
-					sequence: 1,
-					kind: ConversationEntryKind.UserMessage,
-					visibility: ConversationEntryVisibility.UserVisible,
-					fileId: null,
-					payload: {
-						role: "user",
-						parts: [{ type: "text", text: message }],
-					},
-					metadata: {},
-					createdAt: "2026-07-03T00:00:00.000Z",
-				}
-			},
-			notify() {
-				// no-op for protocol shape test
+				return { message, conversationId: "conversation-1" }
 			},
 			ping() {
 				return "pong"
 			},
 		}
-		const event: AgentEvent = {
-			kind: AgentEventKind.ResponseFinished,
-			conversationId: "conversation-1",
-		}
+		const event: AgentEvent = { type: "message_finished" }
 
 		expect(server.ping()).toBe("pong")
-		expect(event.kind).toBe(AgentEventKind.ResponseFinished)
+		expect(event.type).toBe("message_finished")
 	})
 })

packages/freya-agent-protocol/src/index.ts

@@ -1,46 +1,18 @@
-import type { ConversationEntry } from "@freya/core"
-
-export const AgentEventKind = {
-	ConversationStarted: "conversation_started",
-	ConversationEntryCreated: "conversation_entry_created",
-	ResponseFinished: "response_finished",
-	ResponseFailed: "response_failed",
-} as const
-
-export type AgentEventKind = (typeof AgentEventKind)[keyof typeof AgentEventKind]
-
-export interface AgentConversationStartedEvent {
-	kind: typeof AgentEventKind.ConversationStarted
+export interface SendMessageResult {
+	message: string
 	conversationId: string
 }
 
-export interface AgentConversationEntryCreatedEvent {
-	kind: typeof AgentEventKind.ConversationEntryCreated
-	entry: ConversationEntry
-}
-
-export interface AgentResponseFinishedEvent {
-	kind: typeof AgentEventKind.ResponseFinished
-	conversationId: string
-}
-
-export interface AgentResponseFailedEvent {
-	kind: typeof AgentEventKind.ResponseFailed
-	conversationId: string
-	error: string
-}
-
 export type AgentEvent =
-	| AgentConversationStartedEvent
-	| AgentConversationEntryCreatedEvent
-	| AgentResponseFinishedEvent
-	| AgentResponseFailedEvent
-
-export type UserEvent = { type: "typing" }
+	| { type: "conversation_started"; conversationId: string }
+	| { type: "message_created"; text: string }
+	| { type: "tool_started"; toolName: string }
+	| { type: "tool_finished"; toolName: string; ok: boolean }
+	| { type: "message_finished" }
+	| { type: "message_failed"; error: string }
 
 export interface AgentServerApi {
-	sendMessage(message: string): Promise<ConversationEntry>
-	notify(event: UserEvent): void
+	sendMessage(message: string): Promise<SendMessageResult>
 	ping(): "pong"
 }