From f1fcb050533e5e29a333a20e90ea3c08f2fcfc26 Mon Sep 17 00:00:00 2001 From: ajspig Date: Fri, 20 Mar 2026 16:31:16 -0400 Subject: [PATCH] docs: clarifying language --- mcp/README.md | 24 +++++--------------- mcp/src/config.ts | 3 --- mcp/src/server.ts | 2 -- mcp/src/tools/bespoke.ts | 48 ---------------------------------------- 4 files changed, 6 insertions(+), 71 deletions(-) delete mode 100644 mcp/src/tools/bespoke.ts diff --git a/mcp/README.md b/mcp/README.md index bf6569e8..f21a3768 100644 --- a/mcp/README.md +++ b/mcp/README.md @@ -33,27 +33,16 @@ A Cloudflare Worker that implements the [Model Context Protocol (MCP)](https://m | Header | Default | Description | | --- | --- | --- | -| `X-Honcho-Assistant-Name` | `"Assistant"` | Name for the assistant peer | | `X-Honcho-Workspace-ID` | `"default"` | Workspace to operate in | | `X-Honcho-Base-URL` | `https://api.honcho.dev` | Custom API base URL | ## Available Tools -### Bespoke Flow (Simple) +**Workspace:** `inspect_workspace` (aggregates metadata, configuration, and peer/session IDs), `list_workspaces` (enumerates accessible workspaces), `search` (semantic search scoped by optional peer/session params), `get_metadata`, `set_metadata` -| Tool | Description | -| --- | --- | -| `start_conversation` | Start a new conversation, returns a session ID | -| `get_personalization_insights` | Ask Honcho about the user for personalized responses | -| `add_turn` | Record user + assistant messages | +**Peers:** `create_peer`, `list_peers`, `chat`, `get_peer_card`, `set_peer_card`, `get_peer_context`, `get_representation` -### General Tools - -**Workspace:** `inspect_workspace` (aggregates metadata, configuration, and peer/session IDs), `list_workspaces` (enumerates accessible workspaces), `search_workspace`, `get_workspace_metadata`, `set_workspace_metadata` - -**Peers:** `create_peer`, `list_peers`, `chat`, `get_peer_card`, `set_peer_card`, `get_peer_context`, `get_representation`, `get_peer_metadata`, `set_peer_metadata`, `search_peer_messages` - -**Sessions:** `create_session`, `list_sessions`, `delete_session`, `clone_session`, `add_peers_to_session`, `remove_peers_from_session`, `get_session_peers`, `add_messages_to_session`, `get_session_messages`, `search_session_messages`, `get_session_context`, `get_session_representation`, `get_session_metadata`, `set_session_metadata` +**Sessions:** `create_session`, `list_sessions`, `delete_session`, `clone_session`, `add_peers_to_session`, `remove_peers_from_session`, `get_session_peers`, `inspect_session`, `add_messages_to_session`, `get_session_messages`, `get_session_message`, `get_session_context` **Conclusions:** `list_conclusions`, `query_conclusions`, `create_conclusions`, `delete_conclusion` @@ -68,10 +57,9 @@ src/ config.ts # HonchoConfig, parseConfig(), createClient() types.ts # ToolContext, result helpers tools/ - bespoke.ts # start_conversation, add_turn, get_personalization_insights - workspace.ts # search, metadata - peers.ts # CRUD, chat, card, context, representation, search - sessions.ts # CRUD, peers, messages, context, representation, clone + workspace.ts # inspect, list, search, metadata + peers.ts # CRUD, chat, card, context, representation + sessions.ts # CRUD, peers, messages, inspect, context, clone conclusions.ts # list, query, create, delete system.ts # dream, queue status ``` diff --git a/mcp/src/config.ts b/mcp/src/config.ts index 02ba8810..61f3d90b 100644 --- a/mcp/src/config.ts +++ b/mcp/src/config.ts @@ -5,7 +5,6 @@ export interface HonchoConfig { userName: string; baseUrl: string; workspaceId: string; - assistantName: string; } /** @@ -40,8 +39,6 @@ export function parseConfig(request: Request): HonchoConfig { request.headers.get("X-Honcho-Base-URL")?.trim() || "https://api.honcho.dev", workspaceId: request.headers.get("X-Honcho-Workspace-ID")?.trim() || "default", - assistantName: - request.headers.get("X-Honcho-Assistant-Name")?.trim() || "Assistant", }; } diff --git a/mcp/src/server.ts b/mcp/src/server.ts index bf49df79..6bbd5e08 100644 --- a/mcp/src/server.ts +++ b/mcp/src/server.ts @@ -1,6 +1,5 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js"; import type { ToolContext } from "./types.js"; -import { register as registerBespokeTools } from "./tools/bespoke.js"; import { register as registerWorkspaceTools } from "./tools/workspace.js"; import { register as registerPeerTools } from "./tools/peers.js"; import { register as registerSessionTools } from "./tools/sessions.js"; @@ -13,7 +12,6 @@ export function createServer(ctx: ToolContext): McpServer { version: "3.0.0", }); - registerBespokeTools(server, ctx); registerWorkspaceTools(server, ctx); registerPeerTools(server, ctx); registerSessionTools(server, ctx); diff --git a/mcp/src/tools/bespoke.ts b/mcp/src/tools/bespoke.ts deleted file mode 100644 index 0c8eb324..00000000 --- a/mcp/src/tools/bespoke.ts +++ /dev/null @@ -1,48 +0,0 @@ -import { z } from "zod"; -import { nanoid } from "nanoid"; -import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js"; -import type { ToolContext } from "../types.js"; -import { textResult, errorResult } from "../types.js"; - -export function register(server: McpServer, ctx: ToolContext) { - // ── start_conversation ────────────────────────────────────────────── - server.registerTool( - "start_conversation", - { - description: [ - "Start a new conversation for the current user.", - "Call this once at the beginning of every new conversation.", - "Returns session_id, user_peer_id, and assistant_peer_id.", - "Use the peer IDs with add_messages_to_session to record turns.", - ].join("\n"), - inputSchema: {}, - }, - async () => { - try { - const userPeer = await ctx.honcho.peer(ctx.config.userName); - const assistantPeer = await ctx.honcho.peer( - ctx.config.assistantName, - { configuration: { observeMe: false } }, - ); - - const sessionId = nanoid(); - const session = await ctx.honcho.session(sessionId, { metadata: {} }); - - await session.addPeers([ - userPeer, - [assistantPeer, { observeMe: null, observeOthers: false }], - ]); - - return textResult({ - session_id: sessionId, - user_peer_id: userPeer.id, - assistant_peer_id: assistantPeer.id, - }); - } catch (e) { - return errorResult( - `Failed to start conversation: ${e instanceof Error ? e.message : String(e)}`, - ); - } - }, - ); -}