@touchcastllc/napster-companion-api-dev 1.0.0-alpha.73 → 1.0.0-alpha.74

package/lib/services/edge-mcp/edge-mcp-bridge.d.ts

@@ -26,6 +26,8 @@ export declare class EdgeMcpBridge {
     private tools;
     private onToolChange;
     private onResourceUpdated;
+    private onResourceListChanged;
+    private readonly seededUris;
     private lastInlineSig;
     private sessionReady;
     private disposed;
@@ -40,6 +42,23 @@ export declare class EdgeMcpBridge {
     attach(): Promise<EdgeMcpModelContext | null>;
     /** Attach to a known model context: cache tools and subscribe to events. */
     private bind;
+    /**
+     * Relay the current value of every registered resource to the agent once, as
+     * an initial state seed — batched into a SINGLE `send_message` rather than one
+     * per resource, so the agent gets the whole starting state in one context
+     * injection. Feature-detects the toolkit's resource extension (`getResources` /
+     * `readResource`) — a bare WebMCP surface has neither, so this is a no-op there.
+     * Already-seeded URIs are skipped so a `resourcelistchanged` re-seed only emits
+     * genuinely new resources. (Ongoing changes still relay per-resource via
+     * `relayResourceUpdate`, since they happen one at a time.)
+     */
+    private seedResources;
+    /**
+     * Send the whole initial state set to the agent as ONE `role: 'system'`
+     * message (one line per resource). `trigger_response: false` so the avatar
+     * doesn't speak on the seed; `delay: true` to wait for any current speech.
+     */
+    private relayInitialState;
     /** Re-read the tool catalog from the model context. */
     private refreshTools;
     /** Map the current WebMCP tools to `set_settings.inline_functions` definitions. */

package/lib/services/edge-mcp/edge-mcp-types.d.ts

@@ -12,6 +12,29 @@ export interface EdgeMcpToolInfo {
     inputSchema?: Record<string, unknown> | string;
     /** Optional human-readable label. */
     title?: string;
+    /**
+     * Standard WebMCP/MCP annotation hints, surfaced by the polyfill's
+     * `getTools()`. The bridge reads these to gate agent behavior — most
+     * importantly, `destructiveHint` ⇒ the agent must confirm with the user before
+     * calling. A bare WebMCP surface (or older polyfill) may omit this entirely, so
+     * every field is optional and the bridge treats a missing object as "no hints."
+     */
+    annotations?: EdgeMcpToolAnnotations;
+}
+/** The standard MCP tool annotation hints the bridge understands. */
+export interface EdgeMcpToolAnnotations {
+    /** Tool only reads state — safe to call freely, no confirmation. */
+    readOnlyHint?: boolean;
+    /**
+     * Tool performs a destructive / final action. Bridge convention: treat this as
+     * "confirm with the user before calling" (covers additive-but-final actions
+     * like submit / send / place-order too).
+     */
+    destructiveHint?: boolean;
+    /** Safe to retry with the same args (no extra effect). */
+    idempotentHint?: boolean;
+    /** Output may contain untrusted / third-party content (injection risk). */
+    untrustedContentHint?: boolean;
 }
 /**
  * Payload of the toolkit's `resourceupdated` event (live-state extension).

package/lib/services/edge-mcp/index.d.ts

@@ -2,4 +2,4 @@ export { EdgeMcpBridge } from "./edge-mcp-bridge";
 export type { EdgeMcpBridgeOptions } from "./edge-mcp-bridge";
 export { normalizeFunctionCallEvent } from "./normalizeFunctionCallEvent";
 export { getModelContext, discoverModelContext } from "./edge-mcp-discovery";
-export type { EdgeMcpModelContext, EdgeMcpToolInfo, EdgeMcpResourceUpdate, FunctionCallEvent, SendCommand, } from "./edge-mcp-types";
+export type { EdgeMcpModelContext, EdgeMcpToolInfo, EdgeMcpToolAnnotations, EdgeMcpResourceUpdate, FunctionCallEvent, SendCommand, } from "./edge-mcp-types";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@touchcastllc/napster-companion-api-dev",
-  "version": "1.0.0-alpha.73",
+  "version": "1.0.0-alpha.74",
   "keywords": [
     "napster",
     "companion-api",