@botiverse/porthole 0.7.0 → 0.9.0
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/README.md +9 -2
- package/THIRD_PARTY_NOTICES.md +421 -0
- package/dist/annotate/types.d.ts +40 -4
- package/dist/annotate/types.js +6 -1
- package/dist/annotate/validate.d.ts +10 -0
- package/dist/annotate/validate.js +24 -1
- package/dist/bridge/bounded-text.d.ts +34 -0
- package/dist/bridge/bounded-text.js +188 -0
- package/dist/bridge/bridge.d.ts +25 -5
- package/dist/bridge/bridge.js +311 -73
- package/dist/bridge/json-data.d.ts +28 -0
- package/dist/bridge/json-data.js +86 -0
- package/dist/bridge/navigation.d.ts +5 -0
- package/dist/bridge/navigation.js +7 -0
- package/dist/bridge/refusal.js +1 -0
- package/dist/bridge/types.d.ts +32 -1
- package/dist/check/page-source.js +1 -1
- package/dist/check/page.js +2 -0
- package/dist/compile/compile.d.ts +6 -0
- package/dist/compile/compile.js +3 -1
- package/dist/compile/policy.d.ts +38 -2
- package/dist/compile/policy.js +122 -7
- package/dist/config/capabilities.d.ts +23 -4
- package/dist/config/capabilities.js +12 -2
- package/dist/config/schema.d.ts +11 -0
- package/dist/config/validate.d.ts +8 -2
- package/dist/config/validate.js +28 -6
- package/dist/config/warnings.d.ts +20 -0
- package/dist/config/warnings.js +25 -0
- package/dist/conformance/behavior.js +46 -1
- package/dist/conformance/cookies.d.ts +15 -0
- package/dist/conformance/cookies.js +80 -0
- package/dist/conformance/harness/page.d.ts +1 -0
- package/dist/conformance/harness/page.js +9 -2
- package/dist/conformance/harness-source.js +1 -1
- package/dist/conformance/host-kit.js +5 -1
- package/dist/conformance/index.d.ts +10 -0
- package/dist/conformance/limits.js +38 -1
- package/dist/conformance/runtime.js +10 -0
- package/dist/conformance/served.d.ts +2 -0
- package/dist/conformance/served.js +737 -4
- package/dist/files/paths.js +4 -0
- package/dist/guide/gates.d.ts +7 -1
- package/dist/guide/gates.js +12 -0
- package/dist/guide/guide.js +2 -2
- package/dist/guide/runtime.js +11 -3
- package/dist/host/create-host.js +81 -39
- package/dist/host/pages-of-set.d.ts +43 -0
- package/dist/host/pages-of-set.js +196 -0
- package/dist/host/types.d.ts +8 -1
- package/dist/index.d.ts +5 -4
- package/dist/index.js +3 -2
- package/dist/mcp/adapter.js +11 -15
- package/dist/node/index.d.ts +36 -4
- package/dist/node/index.js +402 -101
- package/dist/platform/types.d.ts +9 -0
- package/dist/platform/web.js +8 -0
- package/dist/presets/presets.d.ts +16 -8
- package/dist/presets/presets.js +39 -8
- package/dist/protocol/live-data.d.ts +6 -2
- package/dist/protocol/live-data.js +20 -1
- package/dist/protocol/mcp-apps.d.ts +13 -2
- package/dist/protocol/mcp-apps.js +10 -2
- package/dist/protocol/message-text.d.ts +8 -0
- package/dist/protocol/message-text.js +29 -0
- package/dist/protocol/runtime-calls.js +3 -0
- package/dist/protocol/shell-adapter.js +16 -22
- package/dist/react/context-notice.d.ts +32 -0
- package/dist/react/context-notice.js +28 -0
- package/dist/react/dialog.js +62 -18
- package/dist/react/frame.d.ts +18 -3
- package/dist/react/frame.js +79 -2
- package/dist/react/index.d.ts +2 -1
- package/dist/react/index.js +2 -1
- package/dist/runtime/contract.d.ts +9 -1
- package/dist/runtime/contract.js +31 -2
- package/dist/runtime/db.d.ts +41 -6
- package/dist/runtime/db.js +120 -16
- package/dist/runtime/declaration.d.ts +15 -1
- package/dist/runtime/declaration.js +184 -87
- package/dist/runtime/requests.js +27 -11
- package/dist/runtime/types.generated.js +1 -1
- package/dist/server/files.d.ts +5 -0
- package/dist/server/files.js +22 -7
- package/dist/server/host.d.ts +18 -1
- package/dist/server/host.js +132 -2
- package/dist/server/index.d.ts +1 -1
- package/dist/server/index.js +1 -1
- package/dist/server/peer.d.ts +4 -0
- package/dist/server/peer.js +19 -0
- package/dist/server/proxy.d.ts +6 -0
- package/dist/server/proxy.js +12 -3
- package/dist/server/server.js +113 -26
- package/dist/server/types.d.ts +6 -3
- package/dist/shell/annotate.d.ts +7 -2
- package/dist/shell/annotate.js +233 -15
- package/dist/shell/document.d.ts +8 -0
- package/dist/shell/document.js +3 -0
- package/dist/shell/runtime.js +361 -14
- package/docs/ADOPTING.md +119 -14
- package/docs/ARCHITECTURE.md +15 -4
- package/docs/DECISIONS.md +1610 -9
- package/docs/DESIGN.md +114 -30
- package/docs/THREAT_MODEL.md +652 -0
- package/package.json +14 -3
- package/src/annotate/types.ts +37 -5
- package/src/annotate/validate.ts +30 -1
- package/src/bridge/bounded-text.ts +240 -0
- package/src/bridge/bridge.ts +373 -84
- package/src/bridge/json-data.ts +95 -0
- package/src/bridge/navigation.ts +10 -0
- package/src/bridge/refusal.ts +1 -0
- package/src/bridge/types.ts +30 -1
- package/src/check/page.ts +2 -0
- package/src/compile/compile.ts +9 -1
- package/src/compile/policy.ts +130 -7
- package/src/config/capabilities.ts +22 -3
- package/src/config/schema.ts +11 -0
- package/src/config/validate.ts +43 -5
- package/src/config/warnings.ts +42 -0
- package/src/conformance/behavior.ts +54 -1
- package/src/conformance/cookies.ts +93 -0
- package/src/conformance/harness/page.ts +11 -2
- package/src/conformance/host-kit.ts +10 -1
- package/src/conformance/index.ts +10 -0
- package/src/conformance/limits.ts +39 -1
- package/src/conformance/runtime.ts +21 -0
- package/src/conformance/served.ts +888 -4
- package/src/files/paths.ts +4 -0
- package/src/guide/gates.ts +13 -1
- package/src/guide/guide.ts +3 -3
- package/src/guide/runtime.ts +12 -3
- package/src/host/create-host.ts +88 -38
- package/src/host/pages-of-set.ts +226 -0
- package/src/host/types.ts +15 -1
- package/src/index.ts +5 -0
- package/src/mcp/adapter.ts +16 -20
- package/src/node/index.ts +507 -116
- package/src/platform/types.ts +6 -0
- package/src/platform/web.ts +10 -0
- package/src/presets/presets.ts +60 -17
- package/src/protocol/live-data.ts +31 -3
- package/src/protocol/mcp-apps.ts +11 -2
- package/src/protocol/message-text.ts +36 -0
- package/src/protocol/runtime-calls.ts +3 -0
- package/src/protocol/shell-adapter.ts +27 -23
- package/src/react/context-notice.tsx +95 -0
- package/src/react/dialog.tsx +77 -17
- package/src/react/frame.tsx +107 -2
- package/src/react/index.ts +8 -1
- package/src/runtime/contract.ts +36 -2
- package/src/runtime/db.ts +140 -20
- package/src/runtime/declaration.ts +227 -89
- package/src/runtime/requests.ts +27 -11
- package/src/runtime/types.generated.ts +1 -1
- package/src/server/files.ts +29 -11
- package/src/server/host.ts +158 -3
- package/src/server/index.ts +1 -0
- package/src/server/peer.ts +21 -0
- package/src/server/proxy.ts +13 -3
- package/src/server/server.ts +139 -36
- package/src/server/types.ts +6 -3
- package/src/shell/annotate.ts +233 -15
- package/src/shell/document.ts +8 -0
- package/src/shell/runtime.ts +361 -14
- package/types/runtime/v1/context.d.ts +13 -2
package/src/mcp/adapter.ts
CHANGED
|
@@ -12,6 +12,7 @@ import type { AdapterConnection, AdapterSession, ProtocolAdapter } from "../prot
|
|
|
12
12
|
import {
|
|
13
13
|
MCP_APPS_METHODS,
|
|
14
14
|
MCP_APPS_PROTOCOL_VERSION,
|
|
15
|
+
MODEL_CONTEXT_OFFERED,
|
|
15
16
|
type HostContext,
|
|
16
17
|
} from "../protocol/mcp-apps.ts";
|
|
17
18
|
import {
|
|
@@ -20,6 +21,7 @@ import {
|
|
|
20
21
|
NAVIGATION_BLOCKED_METHOD,
|
|
21
22
|
} from "../protocol/mcp-apps.ts";
|
|
22
23
|
import { liveData } from "../protocol/live-data.ts";
|
|
24
|
+
import { messageText } from "../protocol/message-text.ts";
|
|
23
25
|
import { reasonFor } from "../bridge/refusal.ts";
|
|
24
26
|
|
|
25
27
|
/**
|
|
@@ -96,15 +98,6 @@ export function viewHostContext(
|
|
|
96
98
|
return out;
|
|
97
99
|
}
|
|
98
100
|
|
|
99
|
-
/** The text of a `ui/message`'s content: its text blocks, in order (the spec's examples send one). */
|
|
100
|
-
function messageText(content: unknown): string | null {
|
|
101
|
-
const blocks = Array.isArray(content) ? content : [content];
|
|
102
|
-
const texts = blocks.flatMap((block) =>
|
|
103
|
-
isRecord(block) && block.type === "text" && typeof block.text === "string" ? [block.text] : [],
|
|
104
|
-
);
|
|
105
|
-
return texts.length === 0 ? null : texts.join("\n\n");
|
|
106
|
-
}
|
|
107
|
-
|
|
108
101
|
/** Whether the host page has a live user gesture (a gesture in a frame activates its ancestors). */
|
|
109
102
|
function hostActivation(): boolean | undefined {
|
|
110
103
|
const activation = (globalThis as { navigator?: { userActivation?: { isActive: boolean } } })
|
|
@@ -164,9 +157,7 @@ function connect(session: AdapterSession, options: McpAppsAdapterOptions): McpAp
|
|
|
164
157
|
? { serverResources: declared("subscribeData") ? { subscribe: true } : {} }
|
|
165
158
|
: {}),
|
|
166
159
|
...(declared("sendPrompt") ? { message: { text: {} } } : {}),
|
|
167
|
-
...(declared("setModelContext")
|
|
168
|
-
? { updateModelContext: { text: {}, structuredContent: {} } }
|
|
169
|
-
: {}),
|
|
160
|
+
...(declared("setModelContext") ? { updateModelContext: MODEL_CONTEXT_OFFERED } : {}),
|
|
170
161
|
sandbox: {
|
|
171
162
|
csp: {
|
|
172
163
|
...(connectDomains.length > 0 ? { connectDomains } : {}),
|
|
@@ -248,7 +239,16 @@ function connect(session: AdapterSession, options: McpAppsAdapterOptions): McpAp
|
|
|
248
239
|
answer(request.id, {});
|
|
249
240
|
return;
|
|
250
241
|
case MCP_APPS_METHODS.message: {
|
|
251
|
-
|
|
242
|
+
// Its text blocks, in order (the spec's examples send one), read bounded (P095).
|
|
243
|
+
const content = params.content;
|
|
244
|
+
const text =
|
|
245
|
+
params.role === "user"
|
|
246
|
+
? messageText(
|
|
247
|
+
Array.isArray(content) ? content : [content],
|
|
248
|
+
"\n\n",
|
|
249
|
+
session.compiled.config.limits.maxPromptChars,
|
|
250
|
+
)
|
|
251
|
+
: null;
|
|
252
252
|
if (text === null) {
|
|
253
253
|
invalid('needs role "user" and text content');
|
|
254
254
|
return;
|
|
@@ -393,14 +393,10 @@ function connect(session: AdapterSession, options: McpAppsAdapterOptions): McpAp
|
|
|
393
393
|
return;
|
|
394
394
|
}
|
|
395
395
|
case MCP_APPS_METHODS.log:
|
|
396
|
+
// What the view said, as it came (S05, P095): the bridge reads it only within
|
|
397
|
+
// reportError's declaration and rate, into bounded text, and nothing in it throws here.
|
|
396
398
|
if (typeof params.level === "string" && ERROR_LEVELS.has(params.level)) {
|
|
397
|
-
|
|
398
|
-
void bridge.call("reportError", {
|
|
399
|
-
message: (typeof data === "string" ? data : (JSON.stringify(data) ?? "")).slice(
|
|
400
|
-
0,
|
|
401
|
-
2_000,
|
|
402
|
-
),
|
|
403
|
-
});
|
|
399
|
+
void bridge.call("reportError", { message: params.data });
|
|
404
400
|
}
|
|
405
401
|
return;
|
|
406
402
|
case NAVIGATION_BLOCKED_METHOD:
|