copilotz 1.0.0-rc.20 → 1.0.0-rc.21
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +417 -0
- package/README.md +295 -19
- package/hosts/orgs/mod.d.ts +4 -1
- package/hosts/orgs/mod.js +2 -2
- package/hosts/web/files.d.ts +6 -2
- package/hosts/web/files.js +36 -3
- package/hosts/web/node/mod.d.ts +1 -1
- package/hosts/web/node/mod.js +1 -1
- package/hosts/web/node/serve.d.ts +26 -0
- package/hosts/web/node/serve.js +23 -1
- package/hosts/web/routes.d.ts +28 -1
- package/hosts/web/routes.js +65 -10
- package/hosts/web/server.d.ts +5 -4
- package/hosts/web/server.js +1 -1
- package/package.json +2 -2
- package/plugins/access/accounts/collections/account.d.ts +2 -2
- package/plugins/access/contacts/actions/chat.d.ts +1 -0
- package/plugins/access/contacts/actions/chat.js +45 -0
- package/plugins/access/contacts/actions/forget.d.ts +1 -0
- package/plugins/access/contacts/actions/forget.js +56 -0
- package/plugins/access/contacts/actions/start.d.ts +1 -0
- package/plugins/access/contacts/actions/start.js +50 -0
- package/plugins/access/contacts/collections/contact.d.ts +81 -0
- package/plugins/access/contacts/collections/contact.js +58 -0
- package/plugins/access/contacts/contract.d.ts +10 -0
- package/plugins/access/contacts/contract.js +10 -0
- package/plugins/access/contacts/mod.d.ts +27 -0
- package/plugins/access/contacts/mod.js +49 -0
- package/plugins/access/contacts/views/contact.d.ts +8 -0
- package/plugins/access/contacts/views/contact.js +25 -0
- package/plugins/access/contacts/web.d.ts +7 -0
- package/plugins/access/contacts/web.js +11 -0
- package/plugins/access/directory/collections/credit-code.d.ts +1 -1
- package/plugins/access/directory/collections/invite.d.ts +1 -1
- package/plugins/access/identity/mod.js +8 -6
- package/plugins/access/mod.d.ts +7 -1
- package/plugins/access/mod.js +7 -2
- package/plugins/access/spaces/actions/agents.js +12 -6
- package/plugins/access/spaces/actions/create.js +10 -1
- package/plugins/access/spaces/actions/invitation.js +5 -2
- package/plugins/access/spaces/actions/keep.d.ts +1 -0
- package/plugins/access/spaces/actions/keep.js +55 -0
- package/plugins/access/spaces/actions/member.js +17 -4
- package/plugins/access/spaces/actions/rename.js +4 -0
- package/plugins/access/spaces/collections/member.d.ts +1 -1
- package/plugins/access/spaces/collections/request.d.ts +1 -1
- package/plugins/access/spaces/collections/space.d.ts +9 -0
- package/plugins/access/spaces/collections/space.js +2 -0
- package/plugins/access/spaces/contract.d.ts +4 -3
- package/plugins/access/spaces/contract.js +1 -1
- package/plugins/access/spaces/mod.d.ts +7 -1
- package/plugins/access/spaces/mod.js +8 -1
- package/plugins/access/spaces/resources/tools.d.ts +0 -5
- package/plugins/access/spaces/resources/tools.js +11 -1
- package/plugins/access/spaces/shared/agents.js +2 -2
- package/plugins/access/spaces/shared/can.d.ts +18 -3
- package/plugins/access/spaces/shared/can.js +32 -5
- package/plugins/access/spaces/shared/declared.d.ts +21 -0
- package/plugins/access/spaces/shared/declared.js +8 -0
- package/plugins/access/spaces/shared/labels.d.ts +7 -1
- package/plugins/access/spaces/shared/labels.js +56 -8
- package/plugins/access/spaces/shared/managers.js +2 -2
- package/plugins/access/spaces/shared/names.d.ts +9 -5
- package/plugins/access/spaces/shared/names.js +36 -19
- package/plugins/access/spaces/shared/reach.d.ts +20 -6
- package/plugins/access/spaces/shared/reach.js +62 -20
- package/plugins/access/spaces/shared/rules.d.ts +10 -5
- package/plugins/access/spaces/shared/rules.js +35 -10
- package/plugins/access/spaces/shared/seat.d.ts +3 -2
- package/plugins/access/spaces/shared/seat.js +9 -2
- package/plugins/access/spaces/views/where.d.ts +4 -2
- package/plugins/access/spaces/views/where.js +9 -0
- package/plugins/access/spaces/web.js +1 -1
- package/plugins/access/web.d.ts +1 -0
- package/plugins/access/web.js +1 -0
- package/plugins/agents/chat/actions/erase.d.ts +1 -0
- package/plugins/agents/chat/actions/erase.js +51 -0
- package/plugins/agents/chat/actions/open.d.ts +1 -0
- package/plugins/agents/chat/actions/open.js +49 -0
- package/plugins/agents/chat/actions/quiet.d.ts +1 -0
- package/plugins/agents/chat/actions/quiet.js +33 -0
- package/plugins/agents/chat/actions/say.d.ts +1 -0
- package/plugins/agents/chat/actions/say.js +82 -0
- package/plugins/agents/chat/actions/send.js +57 -19
- package/plugins/agents/chat/actions/shown.d.ts +1 -0
- package/plugins/agents/chat/actions/shown.js +35 -0
- package/plugins/agents/chat/collections/intent.d.ts +124 -0
- package/plugins/agents/chat/collections/intent.js +52 -0
- package/plugins/agents/chat/collections/message.d.ts +74 -1
- package/plugins/agents/chat/collections/message.js +23 -1
- package/plugins/agents/chat/collections/shown.d.ts +105 -0
- package/plugins/agents/chat/collections/shown.js +34 -0
- package/plugins/agents/chat/contract.d.ts +15 -7
- package/plugins/agents/chat/contract.js +7 -1
- package/plugins/agents/chat/mod.d.ts +20 -2
- package/plugins/agents/chat/mod.js +43 -4
- package/plugins/agents/chat/processors/failed.js +15 -5
- package/plugins/agents/chat/processors/turn.d.ts +1 -1
- package/plugins/agents/chat/processors/turn.js +95 -35
- package/plugins/agents/chat/shared/delivery.d.ts +16 -2
- package/plugins/agents/chat/shared/delivery.js +62 -7
- package/plugins/agents/chat/shared/send.d.ts +1 -3
- package/plugins/agents/chat/shared/send.js +2 -9
- package/plugins/agents/chat/shared/tools.d.ts +33 -0
- package/plugins/agents/chat/shared/tools.js +28 -0
- package/plugins/agents/chat/shared/types.d.ts +59 -1
- package/plugins/agents/chat/views/message.d.ts +4 -2
- package/plugins/agents/chat/views/message.js +22 -4
- package/plugins/agents/chat/views/prompt.js +38 -4
- package/plugins/agents/history/collections/outline.d.ts +1 -1
- package/plugins/agents/history/collections/summary.d.ts +1 -1
- package/plugins/agents/history/mod.js +2 -1
- package/plugins/agents/history/processors/erase.d.ts +3 -0
- package/plugins/agents/history/processors/erase.js +11 -0
- package/plugins/agents/memory/mod.js +2 -1
- package/plugins/agents/memory/processors/extract.d.ts +1 -1
- package/plugins/agents/memory/processors/extract.js +5 -0
- package/plugins/agents/memory/resources/tools.js +1 -1
- package/plugins/agents/memory/shared/settings.d.ts +7 -2
- package/plugins/agents/memory/shared/settings.js +9 -1
- package/plugins/agents/routines/collections/routine.d.ts +1 -1
- package/plugins/agents/routines/collections/run.d.ts +1 -1
- package/plugins/compute/apps/collections/app.d.ts +2 -2
- package/plugins/compute/cloud/resources/tools.js +3 -3
- package/plugins/compute/computers/collections/approval.d.ts +2 -2
- package/plugins/compute/computers/collections/grant.d.ts +1 -1
- package/plugins/compute/computers/collections/preview.d.ts +2 -2
- package/plugins/compute/computers/program/version.d.ts +1 -1
- package/plugins/compute/computers/program/version.js +1 -1
- package/plugins/compute/computers/resources/downloads.js +1 -1
- package/plugins/compute/computers/shared/wake.d.ts +1 -1
- package/plugins/compute/computers/shared/wake.js +17 -0
- package/plugins/interfaces/api/collections/key.d.ts +1 -1
- package/plugins/interfaces/api/shared/events.js +5 -4
- package/plugins/interfaces/maintenance/actions/read.d.ts +4 -0
- package/plugins/interfaces/maintenance/actions/read.js +76 -0
- package/plugins/interfaces/maintenance/actions/write.d.ts +4 -0
- package/plugins/interfaces/maintenance/actions/write.js +64 -0
- package/plugins/interfaces/maintenance/contract.d.ts +60 -0
- package/plugins/interfaces/maintenance/contract.js +2 -0
- package/plugins/interfaces/maintenance/mod.d.ts +52 -0
- package/plugins/interfaces/maintenance/mod.js +66 -0
- package/plugins/interfaces/maintenance/resources/routes.d.ts +71 -0
- package/plugins/interfaces/maintenance/resources/routes.js +457 -0
- package/plugins/interfaces/maintenance/shared/ops.d.ts +4 -0
- package/plugins/interfaces/maintenance/shared/ops.js +19 -0
- package/plugins/interfaces/mcp/actions/call.d.ts +11 -0
- package/plugins/interfaces/mcp/actions/call.js +304 -0
- package/plugins/interfaces/mcp/actions/prune.d.ts +1 -0
- package/plugins/interfaces/mcp/actions/prune.js +18 -0
- package/plugins/interfaces/mcp/collections/closed.d.ts +23 -0
- package/plugins/interfaces/mcp/collections/closed.js +17 -0
- package/plugins/interfaces/mcp/collections/rate.d.ts +27 -0
- package/plugins/interfaces/mcp/collections/rate.js +18 -0
- package/plugins/interfaces/mcp/collections/receipt.d.ts +46 -0
- package/plugins/interfaces/mcp/collections/receipt.js +46 -0
- package/plugins/interfaces/mcp/contract.d.ts +9 -0
- package/plugins/interfaces/mcp/contract.js +9 -0
- package/plugins/interfaces/mcp/mod.d.ts +84 -0
- package/plugins/interfaces/mcp/mod.js +122 -0
- package/plugins/interfaces/mcp/processors/closed.d.ts +13 -0
- package/plugins/interfaces/mcp/processors/closed.js +16 -0
- package/plugins/interfaces/mcp/resources/running.d.ts +21 -0
- package/plugins/interfaces/mcp/resources/running.js +36 -0
- package/plugins/interfaces/mcp/resources/server.d.ts +54 -0
- package/plugins/interfaces/mcp/resources/server.js +423 -0
- package/plugins/interfaces/mcp/resources/tools.d.ts +114 -0
- package/plugins/interfaces/mcp/resources/tools.js +324 -0
- package/plugins/interfaces/mcp/shared/caller.d.ts +45 -0
- package/plugins/interfaces/mcp/shared/caller.js +99 -0
- package/plugins/interfaces/mcp/shared/keys.d.ts +50 -0
- package/plugins/interfaces/mcp/shared/keys.js +53 -0
- package/plugins/interfaces/mcp/shared/settings.d.ts +187 -0
- package/plugins/interfaces/mcp/shared/settings.js +176 -0
- package/plugins/interfaces/mcp/views/offered.d.ts +20 -0
- package/plugins/interfaces/mcp/views/offered.js +20 -0
- package/plugins/interfaces/mod.d.ts +5 -1
- package/plugins/interfaces/mod.js +5 -1
- package/plugins/interfaces/terminal/actions/print.js +1 -1
- package/plugins/interfaces/terminal/actions/set.js +1 -1
- package/plugins/interfaces/terminal/collections/output.d.ts +1 -1
- package/plugins/interfaces/terminal/collections/shell.js +1 -1
- package/plugins/interfaces/voice/actions/block.d.ts +2 -0
- package/plugins/interfaces/voice/actions/block.js +74 -0
- package/plugins/interfaces/voice/actions/call.d.ts +19 -0
- package/plugins/interfaces/voice/actions/call.js +253 -0
- package/plugins/interfaces/voice/actions/hook.d.ts +5 -0
- package/plugins/interfaces/voice/actions/hook.js +225 -0
- package/plugins/interfaces/voice/actions/prune.d.ts +1 -0
- package/plugins/interfaces/voice/actions/prune.js +35 -0
- package/plugins/interfaces/voice/collections/blocked.d.ts +87 -0
- package/plugins/interfaces/voice/collections/blocked.js +34 -0
- package/plugins/interfaces/voice/collections/call.d.ts +279 -0
- package/plugins/interfaces/voice/collections/call.js +77 -0
- package/plugins/interfaces/voice/collections/phone.d.ts +74 -0
- package/plugins/interfaces/voice/collections/phone.js +26 -0
- package/plugins/interfaces/voice/contract.d.ts +14 -0
- package/plugins/interfaces/voice/contract.js +2 -0
- package/plugins/interfaces/voice/mod.d.ts +57 -0
- package/plugins/interfaces/voice/mod.js +118 -0
- package/plugins/interfaces/voice/processors/forget.d.ts +13 -0
- package/plugins/interfaces/voice/processors/forget.js +27 -0
- package/plugins/interfaces/voice/resources/relay.d.ts +77 -0
- package/plugins/interfaces/voice/resources/relay.js +428 -0
- package/plugins/interfaces/voice/resources/tools.d.ts +1 -0
- package/plugins/interfaces/voice/resources/tools.js +25 -0
- package/plugins/interfaces/voice/shared/caller.d.ts +27 -0
- package/plugins/interfaces/voice/shared/caller.js +38 -0
- package/plugins/interfaces/voice/shared/settings.d.ts +136 -0
- package/plugins/interfaces/voice/shared/settings.js +121 -0
- package/plugins/interfaces/voice/shared/signature.d.ts +11 -0
- package/plugins/interfaces/voice/shared/signature.js +34 -0
- package/plugins/interfaces/voice/views/call.d.ts +41 -0
- package/plugins/interfaces/voice/views/call.js +30 -0
- package/plugins/interfaces/voice/views/context.d.ts +9 -0
- package/plugins/interfaces/voice/views/context.js +14 -0
- package/plugins/interfaces/voice/views/message.d.ts +17 -0
- package/plugins/interfaces/voice/views/message.js +41 -0
- package/plugins/interfaces/whatsapp/actions/connect.js +3 -0
- package/plugins/interfaces/whatsapp/actions/disconnect.js +4 -1
- package/plugins/interfaces/whatsapp/actions/hook.js +27 -11
- package/plugins/interfaces/whatsapp/actions/set.d.ts +8 -0
- package/plugins/interfaces/whatsapp/actions/set.js +121 -0
- package/plugins/interfaces/whatsapp/collections/blocked.d.ts +29 -0
- package/plugins/interfaces/whatsapp/collections/blocked.js +22 -0
- package/plugins/interfaces/whatsapp/collections/code.d.ts +1 -1
- package/plugins/interfaces/whatsapp/collections/number.d.ts +90 -4
- package/plugins/interfaces/whatsapp/collections/number.js +36 -4
- package/plugins/interfaces/whatsapp/collections/phone.d.ts +13 -3
- package/plugins/interfaces/whatsapp/collections/phone.js +9 -3
- package/plugins/interfaces/whatsapp/collections/rate.d.ts +27 -0
- package/plugins/interfaces/whatsapp/collections/rate.js +13 -0
- package/plugins/interfaces/whatsapp/collections/sent.d.ts +24 -12
- package/plugins/interfaces/whatsapp/collections/sent.js +11 -7
- package/plugins/interfaces/whatsapp/collections/thread.d.ts +14 -6
- package/plugins/interfaces/whatsapp/collections/thread.js +7 -5
- package/plugins/interfaces/whatsapp/collections/typing.d.ts +70 -0
- package/plugins/interfaces/whatsapp/collections/typing.js +21 -0
- package/plugins/interfaces/whatsapp/contract.d.ts +27 -4
- package/plugins/interfaces/whatsapp/contract.js +34 -1
- package/plugins/interfaces/whatsapp/events/undelivered.d.ts +8 -0
- package/plugins/interfaces/whatsapp/events/undelivered.js +17 -0
- package/plugins/interfaces/whatsapp/mod.d.ts +28 -2
- package/plugins/interfaces/whatsapp/mod.js +65 -6
- package/plugins/interfaces/whatsapp/processors/forget.d.ts +6 -0
- package/plugins/interfaces/whatsapp/processors/forget.js +11 -0
- package/plugins/interfaces/whatsapp/processors/receive.d.ts +17 -3
- package/plugins/interfaces/whatsapp/processors/receive.js +264 -81
- package/plugins/interfaces/whatsapp/processors/reply.d.ts +25 -5
- package/plugins/interfaces/whatsapp/processors/reply.js +216 -20
- package/plugins/interfaces/whatsapp/processors/typing.d.ts +8 -0
- package/plugins/interfaces/whatsapp/processors/typing.js +25 -0
- package/plugins/interfaces/whatsapp/shared/customers.d.ts +13 -0
- package/plugins/interfaces/whatsapp/shared/customers.js +16 -0
- package/plugins/interfaces/whatsapp/shared/graph.d.ts +31 -6
- package/plugins/interfaces/whatsapp/shared/graph.js +117 -10
- package/plugins/interfaces/whatsapp/shared/media.d.ts +23 -0
- package/plugins/interfaces/whatsapp/shared/media.js +46 -0
- package/plugins/interfaces/whatsapp/shared/number.d.ts +19 -8
- package/plugins/interfaces/whatsapp/shared/number.js +64 -7
- package/plugins/interfaces/whatsapp/shared/parts.d.ts +94 -0
- package/plugins/interfaces/whatsapp/shared/parts.js +184 -0
- package/plugins/interfaces/whatsapp/shared/payload.d.ts +27 -1
- package/plugins/interfaces/whatsapp/shared/payload.js +36 -1
- package/plugins/interfaces/whatsapp/shared/settings.d.ts +49 -1
- package/plugins/interfaces/whatsapp/shared/settings.js +11 -0
- package/plugins/interfaces/whatsapp/views/message.d.ts +13 -0
- package/plugins/interfaces/whatsapp/views/message.js +13 -0
- package/plugins/interfaces/whatsapp/views/web/line.d.ts +24 -0
- package/plugins/interfaces/whatsapp/views/web/line.js +44 -0
- package/plugins/interfaces/whatsapp/views/web/space.d.ts +7 -5
- package/plugins/interfaces/whatsapp/views/web/space.js +17 -10
- package/plugins/interfaces/whatsapp/views/web/style.d.ts +1 -1
- package/plugins/interfaces/whatsapp/views/web/style.js +8 -0
- package/plugins/models/adapters/llm/anthropic.d.ts +1 -1
- package/plugins/models/adapters/llm/anthropic.js +28 -15
- package/plugins/models/adapters/llm/gemini.d.ts +1 -1
- package/plugins/models/adapters/llm/gemini.js +2 -1
- package/plugins/models/adapters/llm/openai-compatible.d.ts +1 -1
- package/plugins/models/adapters/llm/openai-compatible.js +2 -1
- package/plugins/models/adapters/llm/openai.d.ts +1 -1
- package/plugins/models/adapters/llm/openai.js +16 -4
- package/plugins/models/shared/types.d.ts +8 -0
- package/plugins/models/shared/types.js +10 -0
- package/runtime/actor.d.ts +6 -0
- package/runtime/actor.js +9 -4
- package/runtime/aggregate.js +8 -2
- package/runtime/blobs.d.ts +15 -12
- package/runtime/blobs.js +58 -11
- package/runtime/cache.d.ts +6 -0
- package/runtime/cache.js +19 -1
- package/runtime/define.d.ts +10 -0
- package/runtime/errors.d.ts +20 -2
- package/runtime/errors.js +7 -1
- package/runtime/executor.js +27 -11
- package/runtime/links.d.ts +31 -0
- package/runtime/links.js +60 -0
- package/runtime/maintain.d.ts +88 -0
- package/runtime/maintain.js +120 -0
- package/runtime/memory.js +7 -4
- package/runtime/mod.d.ts +6 -4
- package/runtime/mod.js +5 -2
- package/runtime/mongo.d.ts +13 -0
- package/runtime/mongo.js +39 -8
- package/runtime/observe.d.ts +2 -0
- package/runtime/observe.js +14 -10
- package/runtime/ops.d.ts +5 -0
- package/runtime/ops.js +10 -1
- package/runtime/owner.d.ts +18 -1
- package/runtime/owner.js +127 -61
- package/runtime/presence.d.ts +18 -0
- package/runtime/presence.js +25 -0
- package/runtime/registry.d.ts +5 -0
- package/runtime/registry.js +18 -0
- package/runtime/runtime.js +9 -3
- package/runtime/store.d.ts +48 -1
- package/runtime/wire.d.ts +1 -0
- package/runtime/wire.js +3 -1
- package/stores/blobs/files/mod.js +4 -2
- package/stores/blobs/gcs/mod.d.ts +3 -0
- package/stores/blobs/gcs/mod.js +6 -5
- package/stores/blobs/http/mod.d.ts +1 -1
- package/stores/blobs/http/mod.js +2 -1
- package/stores/latency/mod.js +5 -1
- package/stores/sql/postgres/maintenance.d.ts +24 -0
- package/stores/sql/postgres/maintenance.js +258 -0
- package/stores/sql/postgres/mod.d.ts +20 -4
- package/stores/sql/postgres/mod.js +363 -96
- package/stores/sql/postgres/update.js +3 -1
- package/stores/sql/shared/capped.d.ts +2 -0
- package/stores/sql/shared/capped.js +22 -0
- package/stores/sql/shared/rows.d.ts +14 -0
- package/stores/sql/shared/rows.js +29 -0
- package/stores/sql/shared/statement.d.ts +12 -0
- package/stores/sql/shared/statement.js +244 -0
- package/stores/sql/sqlite/apart.d.ts +11 -0
- package/stores/sql/sqlite/apart.js +219 -0
- package/stores/sql/sqlite/mod.d.ts +16 -2
- package/stores/sql/sqlite/mod.js +246 -51
- package/testing/mod.js +1 -1
|
@@ -0,0 +1,423 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The MCP route: each line's server at `POST /mcp/<line>` (under many orgs,
|
|
3
|
+
* `/o/<org>/mcp/<line>`), MCP's Streamable HTTP transport, written here
|
|
4
|
+
* with no dependency. It keeps no session: every request carries all it
|
|
5
|
+
* needs, as ChatGPT sends them (it stopped echoing `Mcp-Session-Id` in 2026)
|
|
6
|
+
* and as MCP 2026-07-28 says.
|
|
7
|
+
*
|
|
8
|
+
* - **HTTP.** A POST, `application/json`, within the line's `body` limit,
|
|
9
|
+
* answered with JSON (never a stream). GET and DELETE answer 405: there's
|
|
10
|
+
* no stream to open and no session to end. A request with an `Origin` (a
|
|
11
|
+
* browser's page) is refused unless the line names it: no browser calls
|
|
12
|
+
* MCP. No cookie is read: whoever calls is nobody but their
|
|
13
|
+
* conversation's contact.
|
|
14
|
+
* - **Who calls.** With the app's `caller` settings, the caller's address,
|
|
15
|
+
* as its front says it (see shared/caller.ts); a request that came around
|
|
16
|
+
* the front (without its secret) is refused (403).
|
|
17
|
+
* - **At once.** Tool calls running at once: in the runtime (`mcp.atOnce`,
|
|
18
|
+
* 4), on the line (`limits.atOnce`, 4), from one caller's address
|
|
19
|
+
* (`addressAtOnce`, 2: a batch's every call counts) and in one
|
|
20
|
+
* conversation (`chatAtOnce`, 2), each call taking its places until it's
|
|
21
|
+
* done. Past any, it's busy (503, `Retry-After`, -31000, its own code),
|
|
22
|
+
* before anything runs; in a batch, that call's answer says so (and a
|
|
23
|
+
* batch busy for every call is a 503). A batch with more tool calls than
|
|
24
|
+
* one caller may run at once could never be served: it's refused
|
|
25
|
+
* (-32600). A call that hasn't answered within the line's `timeout` is
|
|
26
|
+
* answered "still working" while it goes on, as long as few do (2 on the
|
|
27
|
+
* line, 1 from an address); else it's stopped (see tools.ts).
|
|
28
|
+
* - **JSON-RPC 2.0.** One message a request. A notification (or a reply)
|
|
29
|
+
* answers 202. Bad JSON is -32700, a malformed message -32600, an unknown
|
|
30
|
+
* method -32601, bad params -32602; what fails inside says -32603 and
|
|
31
|
+
* nothing more (it's logged here). A batch (a list of messages) is taken
|
|
32
|
+
* only from a 2025-03-26 client (later versions have none; that one's
|
|
33
|
+
* servers must take them): at most 10 messages, answered one after
|
|
34
|
+
* another, as one call at once.
|
|
35
|
+
* - **Versions.** 2026-07-28 (modern: no handshake; each request says its
|
|
36
|
+
* version and capabilities in `_meta`, and repeats its method and name in
|
|
37
|
+
* headers, which must match: else 400, -32020) and 2025-11-25, 2025-06-18
|
|
38
|
+
* and 2025-03-26 (legacy: `initialize`, answered without a session id; a
|
|
39
|
+
* request without `MCP-Protocol-Version` is 2025-03-26). Any other is 400,
|
|
40
|
+
* -32022, with those it takes.
|
|
41
|
+
* - **Methods.** `initialize`, `server/discover`, `ping`, `tools/list`,
|
|
42
|
+
* `tools/call` (see tools.ts). Tools are all the server has.
|
|
43
|
+
*
|
|
44
|
+
* Sources: https://modelcontextprotocol.io/specification/2026-07-28 (transport,
|
|
45
|
+
* versioning, tools), https://modelcontextprotocol.io/specification/2025-11-25,
|
|
46
|
+
* https://developers.openai.com/apps-sdk/reference (ChatGPT's `_meta`).
|
|
47
|
+
*/
|
|
48
|
+
import { linksOf } from "../../../../runtime/mod.js";
|
|
49
|
+
import { callerFrom } from "../shared/caller.js";
|
|
50
|
+
import { atOnceOf, callerOf, lineOf, PATH } from "../shared/settings.js";
|
|
51
|
+
import { isBusy } from "./running.js";
|
|
52
|
+
import { called, listed, mirrored, offeredOf, usable } from "./tools.js";
|
|
53
|
+
/** The version without a handshake, and the ones with one, newest first. */
|
|
54
|
+
const MODERN = "2026-07-28";
|
|
55
|
+
const LEGACY = ["2025-11-25", "2025-06-18", "2025-03-26"];
|
|
56
|
+
const VERSIONS = [MODERN, ...LEGACY];
|
|
57
|
+
/** What a request without `MCP-Protocol-Version` is (MCP 2025-06-18 and later say so). */
|
|
58
|
+
const UNSAID = "2025-03-26";
|
|
59
|
+
/** JSON-RPC's codes, and MCP's own. */
|
|
60
|
+
const PARSE = -32700;
|
|
61
|
+
const REQUEST = -32600;
|
|
62
|
+
const METHOD = -32601;
|
|
63
|
+
const PARAMS = -32602;
|
|
64
|
+
const INTERNAL = -32603;
|
|
65
|
+
const MISMATCH = -32020;
|
|
66
|
+
const UNSUPPORTED = -32022;
|
|
67
|
+
/** This server's own: too many calls at once (outside JSON-RPC's reserved range, as MCP asks). */
|
|
68
|
+
const BUSY = -31000;
|
|
69
|
+
/** The most messages a batch takes. */
|
|
70
|
+
const BATCH = 10;
|
|
71
|
+
/** How long a client may keep what `tools/list` and `server/discover` say (tools change on deploys). */
|
|
72
|
+
const TTL_MS = 300_000;
|
|
73
|
+
const BUSY_TEXT = "Busy: too many calls at once. Try again in a moment.";
|
|
74
|
+
const AGAIN = { "retry-after": "1" };
|
|
75
|
+
const headers = { "content-type": "application/json", "cache-control": "no-store" };
|
|
76
|
+
const respond = (status, body, more = {}) => new Response(body === undefined ? null : JSON.stringify(body), {
|
|
77
|
+
status,
|
|
78
|
+
headers: { ...(body === undefined ? { "cache-control": "no-store" } : headers), ...more },
|
|
79
|
+
});
|
|
80
|
+
const fault = (id, code, message, data) => ({
|
|
81
|
+
jsonrpc: "2.0",
|
|
82
|
+
...(id !== undefined ? { id } : {}),
|
|
83
|
+
error: { code, message, ...(data !== undefined ? { data } : {}) },
|
|
84
|
+
});
|
|
85
|
+
const failed = (status, id, code, message, data) => ({ status, body: fault(id, code, message, data) });
|
|
86
|
+
const isObject = (value) => !!value && typeof value === "object" && !Array.isArray(value);
|
|
87
|
+
/** Answers a request to `/mcp/<line>`. */
|
|
88
|
+
export async function serveMcp(request, host) {
|
|
89
|
+
if (!host?.runtime)
|
|
90
|
+
return respond(501, fault(undefined, INTERNAL, "No runtime here"));
|
|
91
|
+
const resources = host.runtime.describe().resources;
|
|
92
|
+
const url = new URL(request.url);
|
|
93
|
+
const name = url.pathname.slice(PATH.length).replace(/\/$/, "");
|
|
94
|
+
const line = /^[\w-]{1,60}$/.test(name) ? lineOf({ resources }, name) : undefined;
|
|
95
|
+
if (!line)
|
|
96
|
+
return respond(404, fault(undefined, REQUEST, "No MCP server here"));
|
|
97
|
+
if (request.method !== "POST") {
|
|
98
|
+
return new Response(null, {
|
|
99
|
+
status: 405,
|
|
100
|
+
headers: { allow: "POST", "cache-control": "no-store" },
|
|
101
|
+
});
|
|
102
|
+
}
|
|
103
|
+
// A browser's page: only from an origin the line names (none, unless it says).
|
|
104
|
+
const origin = request.headers.get("origin");
|
|
105
|
+
if (origin !== null && !(line.origins ?? []).includes(origin)) {
|
|
106
|
+
return respond(403, fault(undefined, REQUEST, "Not from this origin"));
|
|
107
|
+
}
|
|
108
|
+
// Around the app's front, straight to it: refused, when the front vouches for callers.
|
|
109
|
+
const caller = callerFrom(request, callerOf({ resources }));
|
|
110
|
+
if (caller === "refused") {
|
|
111
|
+
return respond(403, fault(undefined, REQUEST, "Not through the app's front"));
|
|
112
|
+
}
|
|
113
|
+
if (!/^application\/json\b/i.test(request.headers.get("content-type") ?? "")) {
|
|
114
|
+
return respond(415, fault(undefined, REQUEST, "Send JSON (application/json)"));
|
|
115
|
+
}
|
|
116
|
+
const text = await bodyOf(request, line.limits.body);
|
|
117
|
+
if (text === undefined)
|
|
118
|
+
return respond(413, fault(undefined, REQUEST, "Too large"));
|
|
119
|
+
let parsed;
|
|
120
|
+
try {
|
|
121
|
+
parsed = JSON.parse(text);
|
|
122
|
+
}
|
|
123
|
+
catch {
|
|
124
|
+
return respond(400, fault(undefined, PARSE, "Parse error"));
|
|
125
|
+
}
|
|
126
|
+
const secret = linksOf(resources)?.secret;
|
|
127
|
+
if (!secret)
|
|
128
|
+
return respond(500, fault(undefined, INTERNAL, "Internal error"));
|
|
129
|
+
const org = resources.org?.id;
|
|
130
|
+
const { runtime } = host;
|
|
131
|
+
const context = {
|
|
132
|
+
runtime,
|
|
133
|
+
line,
|
|
134
|
+
resources,
|
|
135
|
+
request,
|
|
136
|
+
caller,
|
|
137
|
+
scope: { line: line.name, ...(org ? { org } : {}), secret },
|
|
138
|
+
atOnce: atOnceOf({ resources }),
|
|
139
|
+
};
|
|
140
|
+
if (Array.isArray(parsed)) {
|
|
141
|
+
// Batches were MCP's only in 2025-03-26.
|
|
142
|
+
const version = request.headers.get("mcp-protocol-version") ?? UNSAID;
|
|
143
|
+
if (version !== UNSAID || !parsed.length || parsed.length > BATCH) {
|
|
144
|
+
return respond(400, fault(undefined, REQUEST, `One message a request (from 2025-03-26, ${BATCH} at most)`));
|
|
145
|
+
}
|
|
146
|
+
// More tool calls than one caller may run at once could never be served: not a busy moment.
|
|
147
|
+
const calls = parsed.filter((m) => isObject(m) && m.method === "tools/call").length;
|
|
148
|
+
const most = line.limits.addressAtOnce;
|
|
149
|
+
if (caller && !caller.exempt && calls > most) {
|
|
150
|
+
return respond(400, fault(undefined, REQUEST, `A batch takes at most ${most} tool calls (addressAtOnce)`));
|
|
151
|
+
}
|
|
152
|
+
const bodies = [];
|
|
153
|
+
for (const message of parsed) {
|
|
154
|
+
const { body } = await answered(context, message, true);
|
|
155
|
+
if (body)
|
|
156
|
+
bodies.push(body);
|
|
157
|
+
}
|
|
158
|
+
// Every call in it busy: the batch is (and may be sent again).
|
|
159
|
+
const busyAll = bodies.length > 0 &&
|
|
160
|
+
bodies.every((b) => b.error?.code === BUSY);
|
|
161
|
+
return bodies.length
|
|
162
|
+
? respond(busyAll ? 503 : 200, bodies, busyAll ? AGAIN : {})
|
|
163
|
+
: respond(202);
|
|
164
|
+
}
|
|
165
|
+
const { status, body, again } = await answered(context, parsed, false);
|
|
166
|
+
return respond(status, body, again ? AGAIN : {});
|
|
167
|
+
}
|
|
168
|
+
/** A request's id, when it's one JSON-RPC takes. */
|
|
169
|
+
const idOf = (id) => (typeof id === "string" && id.length <= 200) || Number.isSafeInteger(id) ? id : undefined;
|
|
170
|
+
/** A request's body as text, or undefined past `limit` bytes. */
|
|
171
|
+
async function bodyOf(request, limit) {
|
|
172
|
+
if (Number(request.headers.get("content-length") ?? 0) > limit)
|
|
173
|
+
return undefined;
|
|
174
|
+
if (!request.body)
|
|
175
|
+
return "";
|
|
176
|
+
const reader = request.body.getReader();
|
|
177
|
+
const chunks = [];
|
|
178
|
+
let size = 0;
|
|
179
|
+
for (;;) {
|
|
180
|
+
const { done, value } = await reader.read();
|
|
181
|
+
if (done)
|
|
182
|
+
break;
|
|
183
|
+
size += value.length;
|
|
184
|
+
if (size > limit) {
|
|
185
|
+
await reader.cancel().catch(() => { });
|
|
186
|
+
return undefined;
|
|
187
|
+
}
|
|
188
|
+
chunks.push(value);
|
|
189
|
+
}
|
|
190
|
+
const bytes = new Uint8Array(size);
|
|
191
|
+
let at = 0;
|
|
192
|
+
for (const chunk of chunks) {
|
|
193
|
+
bytes.set(chunk, at);
|
|
194
|
+
at += chunk.length;
|
|
195
|
+
}
|
|
196
|
+
return new TextDecoder().decode(bytes);
|
|
197
|
+
}
|
|
198
|
+
/** A header's value as MCP may encode it (`=?base64?…?=`, for what isn't plain ASCII). */
|
|
199
|
+
function decoded(value) {
|
|
200
|
+
const encoded = value?.match(/^=\?base64\?([A-Za-z0-9+/=]*)\?=$/)?.[1];
|
|
201
|
+
if (encoded === undefined)
|
|
202
|
+
return value;
|
|
203
|
+
try {
|
|
204
|
+
return new TextDecoder("utf-8", { fatal: true }).decode(Uint8Array.from(atob(encoded), (c) => c.charCodeAt(0)));
|
|
205
|
+
}
|
|
206
|
+
catch {
|
|
207
|
+
return null;
|
|
208
|
+
}
|
|
209
|
+
}
|
|
210
|
+
/** One message, answered. In a batch, a request's HTTP status is the batch's (200). */
|
|
211
|
+
async function answered(c, raw, batched) {
|
|
212
|
+
if (!isObject(raw) || raw.jsonrpc !== "2.0") {
|
|
213
|
+
return failed(400, undefined, REQUEST, "Not JSON-RPC 2.0");
|
|
214
|
+
}
|
|
215
|
+
const message = raw;
|
|
216
|
+
const headed = c.request.headers.get("mcp-protocol-version");
|
|
217
|
+
const params = (message.params ?? {});
|
|
218
|
+
const meta = isObject(params) && isObject(params._meta) ? params._meta : undefined;
|
|
219
|
+
const said = meta?.["io.modelcontextprotocol/protocolVersion"];
|
|
220
|
+
const version = message.method === "initialize"
|
|
221
|
+
? undefined
|
|
222
|
+
: headed ?? (typeof said === "string" ? said : UNSAID);
|
|
223
|
+
const asked = idOf(message.id);
|
|
224
|
+
if (version !== undefined && !VERSIONS.includes(version)) {
|
|
225
|
+
return failed(400, asked, UNSUPPORTED, "Unsupported protocol version", {
|
|
226
|
+
supported: VERSIONS,
|
|
227
|
+
requested: version,
|
|
228
|
+
});
|
|
229
|
+
}
|
|
230
|
+
if (headed !== null && typeof said === "string" && headed !== said) {
|
|
231
|
+
return failed(400, asked, MISMATCH, "Header mismatch: MCP-Protocol-Version");
|
|
232
|
+
}
|
|
233
|
+
const modern = version === MODERN;
|
|
234
|
+
// A reply from the client: legacy clients may send one (to nothing we asked); modern ones don't.
|
|
235
|
+
if (message.method === undefined && ("result" in message || "error" in message)) {
|
|
236
|
+
return modern ? failed(400, undefined, REQUEST, "Clients send no replies") : { status: 202 };
|
|
237
|
+
}
|
|
238
|
+
if (typeof message.method !== "string" || !message.method) {
|
|
239
|
+
return failed(400, undefined, REQUEST, "A message has a method");
|
|
240
|
+
}
|
|
241
|
+
const method = message.method;
|
|
242
|
+
if (!("id" in message))
|
|
243
|
+
return { status: 202 }; // A notification: nothing to answer.
|
|
244
|
+
const rpc = idOf(message.id);
|
|
245
|
+
if (rpc === undefined) {
|
|
246
|
+
return failed(400, undefined, REQUEST, "A request's id is a string or an integer");
|
|
247
|
+
}
|
|
248
|
+
if (!isObject(params))
|
|
249
|
+
return failed(400, rpc, PARAMS, "params is an object");
|
|
250
|
+
if (modern) {
|
|
251
|
+
const wrong = headerProblem(c, method, params, said);
|
|
252
|
+
if (wrong)
|
|
253
|
+
return failed(400, rpc, wrong.code, wrong.message);
|
|
254
|
+
}
|
|
255
|
+
const ok = (result) => ({
|
|
256
|
+
status: 200,
|
|
257
|
+
body: { jsonrpc: "2.0", id: rpc, result: modern ? modernOf(c.line, result) : result },
|
|
258
|
+
});
|
|
259
|
+
// A method it doesn't have is a 404 to a modern client (MCP 2026-07-28); else errors in the body.
|
|
260
|
+
const status = (code) => !batched && modern && code === METHOD ? 404 : 200;
|
|
261
|
+
try {
|
|
262
|
+
switch (method) {
|
|
263
|
+
case "initialize":
|
|
264
|
+
return ok(initialized(c.line, params));
|
|
265
|
+
case "server/discover":
|
|
266
|
+
return ok(discovered(c.line));
|
|
267
|
+
case "ping":
|
|
268
|
+
return ok({});
|
|
269
|
+
case "tools/list": {
|
|
270
|
+
if (params.cursor !== undefined) {
|
|
271
|
+
return failed(status(PARAMS), rpc, PARAMS, "No such cursor");
|
|
272
|
+
}
|
|
273
|
+
const names = await offeredOf(c.runtime, c.line, usable(c.runtime, c.line));
|
|
274
|
+
return ok({
|
|
275
|
+
tools: listed(c.line, c.resources, names),
|
|
276
|
+
ttlMs: TTL_MS,
|
|
277
|
+
cacheScope: "public",
|
|
278
|
+
});
|
|
279
|
+
}
|
|
280
|
+
case "tools/call": {
|
|
281
|
+
const tool = params.name;
|
|
282
|
+
const input = params.arguments ?? {};
|
|
283
|
+
if (typeof tool !== "string" || !usable(c.runtime, c.line).includes(tool)) {
|
|
284
|
+
return failed(status(PARAMS), rpc, PARAMS, `Unknown tool: ${String(tool).slice(0, 128)}`);
|
|
285
|
+
}
|
|
286
|
+
if (!isObject(input))
|
|
287
|
+
return failed(status(PARAMS), rpc, PARAMS, "arguments is an object");
|
|
288
|
+
const odd = oddIn(input);
|
|
289
|
+
if (odd)
|
|
290
|
+
return failed(status(PARAMS), rpc, PARAMS, odd);
|
|
291
|
+
const conversation = saidOf(meta);
|
|
292
|
+
if (!conversation) {
|
|
293
|
+
return failed(status(PARAMS), rpc, PARAMS, "openai/session and openai/subject are text");
|
|
294
|
+
}
|
|
295
|
+
return ok(await called(c.runtime, c.line, c.scope, {
|
|
296
|
+
tool,
|
|
297
|
+
input,
|
|
298
|
+
request: rpc,
|
|
299
|
+
said: conversation,
|
|
300
|
+
caller: c.caller,
|
|
301
|
+
atOnce: c.atOnce,
|
|
302
|
+
}));
|
|
303
|
+
}
|
|
304
|
+
default:
|
|
305
|
+
return failed(status(METHOD), rpc, METHOD, "Method not found");
|
|
306
|
+
}
|
|
307
|
+
}
|
|
308
|
+
catch (error) {
|
|
309
|
+
if (isBusy(error)) {
|
|
310
|
+
return { ...failed(batched ? 200 : 503, rpc, BUSY, BUSY_TEXT), again: true };
|
|
311
|
+
}
|
|
312
|
+
console.error(`mcp.${c.line.name}: ${method}:`, error instanceof Error ? error.message : error);
|
|
313
|
+
return failed(batched ? 200 : 500, rpc, INTERNAL, "Internal error");
|
|
314
|
+
}
|
|
315
|
+
}
|
|
316
|
+
/** How deep a tool's input may nest: tools take a few levels; past this, it's no tool's. */
|
|
317
|
+
const DEPTH = 64;
|
|
318
|
+
/**
|
|
319
|
+
* What's wrong with a call's input before anything reads it, if anything:
|
|
320
|
+
* nested past `DEPTH` (what reads it recursively would run out of stack),
|
|
321
|
+
* or holding what the store reads as a blob reference (an object with a
|
|
322
|
+
* `$blob`: only the app writes those, never a caller). Walked without
|
|
323
|
+
* recursion.
|
|
324
|
+
*/
|
|
325
|
+
function oddIn(value) {
|
|
326
|
+
const left = [[value, 0]];
|
|
327
|
+
while (left.length) {
|
|
328
|
+
const [at, depth] = left.pop();
|
|
329
|
+
if (!at || typeof at !== "object")
|
|
330
|
+
continue;
|
|
331
|
+
if (depth > DEPTH)
|
|
332
|
+
return `arguments nest more than ${DEPTH} levels deep`;
|
|
333
|
+
if (!Array.isArray(at) && Object.hasOwn(at, "$blob")) {
|
|
334
|
+
return "arguments hold a blob reference ($blob)";
|
|
335
|
+
}
|
|
336
|
+
for (const item of Object.values(at))
|
|
337
|
+
left.push([item, depth + 1]);
|
|
338
|
+
}
|
|
339
|
+
return undefined;
|
|
340
|
+
}
|
|
341
|
+
/** ChatGPT's fields naming the conversation, when they're text of a sane size; null when not. */
|
|
342
|
+
function saidOf(meta) {
|
|
343
|
+
const session = meta?.["openai/session"];
|
|
344
|
+
const subject = meta?.["openai/subject"];
|
|
345
|
+
const fine = (v) => v === undefined || (typeof v === "string" && v.length > 0 && v.length <= 512);
|
|
346
|
+
if (!fine(session) || !fine(subject))
|
|
347
|
+
return null;
|
|
348
|
+
return {
|
|
349
|
+
...(typeof session === "string" ? { session } : {}),
|
|
350
|
+
...(typeof subject === "string" ? { subject } : {}),
|
|
351
|
+
};
|
|
352
|
+
}
|
|
353
|
+
/**
|
|
354
|
+
* What's wrong with a modern request's metadata and headers, if anything:
|
|
355
|
+
* its version and capabilities in `_meta`, and its method, name and
|
|
356
|
+
* mirrored input in headers, matching the body.
|
|
357
|
+
*/
|
|
358
|
+
function headerProblem(c, method, params, said) {
|
|
359
|
+
const meta = params._meta;
|
|
360
|
+
if (typeof said !== "string" || !isObject(meta?.["io.modelcontextprotocol/clientCapabilities"])) {
|
|
361
|
+
return { code: PARAMS, message: "_meta needs its protocolVersion and clientCapabilities" };
|
|
362
|
+
}
|
|
363
|
+
const header = (name) => c.request.headers.get(name);
|
|
364
|
+
if (header("mcp-protocol-version") !== said) {
|
|
365
|
+
return { code: MISMATCH, message: "Header mismatch: MCP-Protocol-Version" };
|
|
366
|
+
}
|
|
367
|
+
if (header("mcp-method") !== method) {
|
|
368
|
+
return { code: MISMATCH, message: "Header mismatch: Mcp-Method" };
|
|
369
|
+
}
|
|
370
|
+
if (method !== "tools/call")
|
|
371
|
+
return undefined;
|
|
372
|
+
if (decoded(header("mcp-name")) !== params.name) {
|
|
373
|
+
return { code: MISMATCH, message: "Header mismatch: Mcp-Name" };
|
|
374
|
+
}
|
|
375
|
+
const input = isObject(params.arguments) ? params.arguments : {};
|
|
376
|
+
for (const { header: name, path } of mirrored(c.line, String(params.name), c.resources)) {
|
|
377
|
+
const value = path.reduce((at, key) => isObject(at) ? at[key] : undefined, input);
|
|
378
|
+
if (value === undefined || value === null)
|
|
379
|
+
continue;
|
|
380
|
+
const given = decoded(header(`mcp-param-${name}`));
|
|
381
|
+
const same = typeof value === "number"
|
|
382
|
+
? given !== null && Number(given) === value
|
|
383
|
+
: given === String(value);
|
|
384
|
+
if (!same)
|
|
385
|
+
return { code: MISMATCH, message: `Header mismatch: Mcp-Param-${name}` };
|
|
386
|
+
}
|
|
387
|
+
return undefined;
|
|
388
|
+
}
|
|
389
|
+
/** Who the server is. */
|
|
390
|
+
const serverOf = (line) => ({
|
|
391
|
+
name: line.name,
|
|
392
|
+
...(line.title ? { title: line.title } : {}),
|
|
393
|
+
version: line.version,
|
|
394
|
+
});
|
|
395
|
+
const CAPABILITIES = { tools: {} };
|
|
396
|
+
/** A legacy client's handshake: the version it asked for when taken, else the newest legacy one. */
|
|
397
|
+
function initialized(line, params) {
|
|
398
|
+
const asked = params.protocolVersion;
|
|
399
|
+
return {
|
|
400
|
+
protocolVersion: typeof asked === "string" && LEGACY.includes(asked) ? asked : LEGACY[0],
|
|
401
|
+
capabilities: CAPABILITIES,
|
|
402
|
+
serverInfo: serverOf(line),
|
|
403
|
+
...(line.instructions ? { instructions: line.instructions } : {}),
|
|
404
|
+
};
|
|
405
|
+
}
|
|
406
|
+
/** What `server/discover` says: versions, what it has, who it is. */
|
|
407
|
+
const discovered = (line) => ({
|
|
408
|
+
supportedVersions: VERSIONS,
|
|
409
|
+
capabilities: CAPABILITIES,
|
|
410
|
+
_meta: { "io.modelcontextprotocol/serverInfo": serverOf(line) },
|
|
411
|
+
...(line.instructions ? { instructions: line.instructions } : {}),
|
|
412
|
+
ttlMs: TTL_MS,
|
|
413
|
+
cacheScope: "public",
|
|
414
|
+
});
|
|
415
|
+
/** A result as a modern client takes it: complete, and saying who answered. */
|
|
416
|
+
const modernOf = (line, result) => ({
|
|
417
|
+
resultType: "complete",
|
|
418
|
+
...result,
|
|
419
|
+
_meta: {
|
|
420
|
+
...(isObject(result._meta) ? result._meta : {}),
|
|
421
|
+
"io.modelcontextprotocol/serverInfo": serverOf(line),
|
|
422
|
+
},
|
|
423
|
+
});
|
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The line's tools, as the MCP route answers about them:
|
|
3
|
+
*
|
|
4
|
+
* - **Which:** those the line lists that have a `tool:<name>` View (`llm`):
|
|
5
|
+
* what a model outside reads of a tool is the app's choice, never its
|
|
6
|
+
* output as it is, so a tool without one isn't offered (and the route
|
|
7
|
+
* says so once, in the log). One whose `offer` says no to a contact isn't
|
|
8
|
+
* listed (see views/offered.ts), and isn't run. Listing asks offers for a
|
|
9
|
+
* stand-in contact in no chat yet, the same for everyone (kept a minute):
|
|
10
|
+
* an offer that depends on the chat is listed unless it says no to the
|
|
11
|
+
* stand-in, and asked again, for the real chat, when it's called.
|
|
12
|
+
* - **`tools/list`** (`listed`): each, in order: its name, title and
|
|
13
|
+
* description, its input's schema (with an optional `chat`, the handle,
|
|
14
|
+
* when the line gives handles), its hints as MCP names them
|
|
15
|
+
* (`readOnlyHint`…, each said, MCP's defaults where the app says nothing),
|
|
16
|
+
* what ChatGPT shows while and after it runs, and that it needs no
|
|
17
|
+
* sign-in (`securitySchemes`, also in `_meta` for clients that read only
|
|
18
|
+
* that).
|
|
19
|
+
* - **`tools/call`** (`called`): which conversation the call is (see
|
|
20
|
+
* shared/keys.ts). The same call (tool and input) already running in it,
|
|
21
|
+
* sent again from anywhere under any request id, waits for that run.
|
|
22
|
+
* Else it takes its places (the runtime's, the line's, the address's, the
|
|
23
|
+
* conversation's), held until it's done, and runs `mcp.call` as the
|
|
24
|
+
* conversation's contact (with who the user and the address are, as
|
|
25
|
+
* HMACs, for their limits: in its input, which no log keeps). The route
|
|
26
|
+
* waits the line's `timeout` (20 s) for its answer; past it, the model is
|
|
27
|
+
* told it's still working, and to ask again: the call goes on (while few
|
|
28
|
+
* do: `lateAtOnce`, 2 on the line, 1 from an address; else it's stopped),
|
|
29
|
+
* and asked again, under any request id, it answers what it did, from its
|
|
30
|
+
* receipt (a tool that changes things does it once). One still running
|
|
31
|
+
* past `stop` (60 s) is stopped: tools should honour `ctx.signal`. A call that names no conversation gets a handle, said once, at the
|
|
32
|
+
* end of its answer (`chat: <handle>`): a model reads only an answer's
|
|
33
|
+
* content (a result's `_meta` is the host's, never the model's), so
|
|
34
|
+
* that's where it must be. On a line without handles, it's refused.
|
|
35
|
+
*/
|
|
36
|
+
import type { Runtime } from "../../../../runtime/mod.js";
|
|
37
|
+
import type { Caller } from "../shared/caller.js";
|
|
38
|
+
import { type Scope } from "../shared/keys.js";
|
|
39
|
+
import { type Line } from "../shared/settings.js";
|
|
40
|
+
type Resources = Record<string, Record<string, unknown>>;
|
|
41
|
+
/** What a tool's input says, as far as the route looks into it. */
|
|
42
|
+
type Schema = {
|
|
43
|
+
type?: unknown;
|
|
44
|
+
properties?: Record<string, unknown>;
|
|
45
|
+
[key: string]: unknown;
|
|
46
|
+
};
|
|
47
|
+
/** The tools the line lists that have their `tool:<name>` View; the others, said once in the log. */
|
|
48
|
+
export declare function usable(runtime: Pick<Runtime, "describe">, line: Line): string[];
|
|
49
|
+
/**
|
|
50
|
+
* Of `names`, those a contact is offered, before any conversation (a
|
|
51
|
+
* stand-in contact, in no chat yet): only tools whose `offer` is a function
|
|
52
|
+
* are asked; nothing is read when none is.
|
|
53
|
+
*/
|
|
54
|
+
export declare function offeredOf(runtime: Pick<Runtime, "describe" | "observe">, line: Line, names: string[]): Promise<string[]>;
|
|
55
|
+
/** The tools `names` (the line's), as `tools/list` answers them. */
|
|
56
|
+
export declare function listed(line: Line, resources: Resources, names: string[]): {
|
|
57
|
+
description: string;
|
|
58
|
+
inputSchema: Schema;
|
|
59
|
+
annotations: {
|
|
60
|
+
readOnlyHint: boolean;
|
|
61
|
+
destructiveHint: boolean;
|
|
62
|
+
idempotentHint: boolean;
|
|
63
|
+
openWorldHint: boolean;
|
|
64
|
+
};
|
|
65
|
+
securitySchemes: {
|
|
66
|
+
type: string;
|
|
67
|
+
}[];
|
|
68
|
+
_meta: {
|
|
69
|
+
securitySchemes: {
|
|
70
|
+
type: string;
|
|
71
|
+
}[];
|
|
72
|
+
"openai/toolInvocation/invoked"?: string | undefined;
|
|
73
|
+
"openai/toolInvocation/invoking"?: string | undefined;
|
|
74
|
+
};
|
|
75
|
+
title?: string | undefined;
|
|
76
|
+
name: string;
|
|
77
|
+
}[];
|
|
78
|
+
/**
|
|
79
|
+
* The input properties a tool mirrors into headers (`x-mcp-header`, MCP
|
|
80
|
+
* 2026-07-28): each header's name and where its value is in the input.
|
|
81
|
+
*/
|
|
82
|
+
export declare function mirrored(line: Line, name: string, resources: Resources): {
|
|
83
|
+
header: string;
|
|
84
|
+
path: string[];
|
|
85
|
+
}[];
|
|
86
|
+
/** What a call says about its conversation: ChatGPT's fields, in the request's `_meta`. */
|
|
87
|
+
export type Said = {
|
|
88
|
+
session?: string;
|
|
89
|
+
subject?: string;
|
|
90
|
+
};
|
|
91
|
+
/**
|
|
92
|
+
* Runs a call (`tools/call`) on the line, for its conversation, and answers
|
|
93
|
+
* as MCP does: the text, and `isError` when it didn't work. `request` is the
|
|
94
|
+
* JSON-RPC request's id.
|
|
95
|
+
*/
|
|
96
|
+
export declare function called(runtime: Pick<Runtime, "call" | "cancel" | "describe">, line: Line, scope: Scope & {
|
|
97
|
+
secret: string;
|
|
98
|
+
}, call: {
|
|
99
|
+
tool: string;
|
|
100
|
+
input: Record<string, unknown>;
|
|
101
|
+
request: string | number;
|
|
102
|
+
said: Said;
|
|
103
|
+
/** Who calls, as the app's front says (undefined without its `caller` settings). */
|
|
104
|
+
caller?: Exclude<Caller, "refused">;
|
|
105
|
+
/** Calls the runtime runs at once. */
|
|
106
|
+
atOnce: number;
|
|
107
|
+
}): Promise<{
|
|
108
|
+
isError?: boolean | undefined;
|
|
109
|
+
content: {
|
|
110
|
+
type: string;
|
|
111
|
+
text: string;
|
|
112
|
+
}[];
|
|
113
|
+
}>;
|
|
114
|
+
export {};
|