RomanNum3ral
/
honcho
mirror of https://github.com/plastic-labs/honcho.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

docs: clarifying language

This commit is contained in:
ajspig 2026-03-20 16:31:16 -04:00
parent 4a5f4364cd
commit f1fcb05053
4 changed files with 6 additions and 71 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
mcp/README.md
View File

@ -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
```

3
mcp/src/config.ts
View File

@ -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",
};
}

2
mcp/src/server.ts
View File

@ -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);

48
mcp/src/tools/bespoke.ts
View File

@ -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)}`,
);
}
},
);
}