agent-relay 8.9.0 → 8.9.2

package/dist/cli/mcp/telemetry.js

@@ -0,0 +1,176 @@
+import { agentTokenRecoveryMessage, isInvalidAgentTokenError, isInvalidAgentTokenToolResult, } from '@agent-relay/sdk';
+import { track } from '../telemetry/index.js';
+import { errorClassName } from '../lib/telemetry-helpers.js';
+import { formatInbox, SKIP_PIGGYBACK } from './inbox.js';
+import { hasContentArray, invalidAgentTokenToolResult, isErrorToolResult } from './tool-results.js';
+/**
+ * Owned tools that delegate to the actions surface (`actions.invoke(...)`)
+ * rather than the agents/messaging APIs. Together with the dynamic per-action
+ * tools (tracked via `actionToolNames`), these intentionally skip per-tool
+ * telemetry so the same underlying action is not counted differently depending
+ * on which MCP surface the caller used (e.g. `spawn` vs `invoke_action`).
+ */
+const ACTION_ROUTED_TOOL_NAMES = new Set(['invoke_action', 'spawn']);
+/**
+ * Coarse type/category metadata for the statically-registered ("owned") MCP
+ * tools. Action-routed calls (see `ACTION_ROUTED_TOOL_NAMES`) and the dynamic
+ * per-action tools surfaced from the actions registry are intentionally
+ * excluded from per-tool telemetry (see the skip in `enableInboxPiggyback`),
+ * so they have no entry.
+ */
+const AGENT_RELAY_TOOL_CALL_METADATA = {
+    add_agent: { toolType: 'agent.create', toolCategory: 'spawn' },
+    remove_agent: { toolType: 'agent.release', toolCategory: 'release' },
+    list_actions: { toolType: 'action.list', toolCategory: 'action' },
+    submit_result: { toolType: 'result.submit', toolCategory: 'result' },
+    create_workspace: { toolType: 'workspace.create', toolCategory: 'workspace' },
+    set_workspace_key: { toolType: 'workspace.set_key', toolCategory: 'workspace' },
+    register_agent: { toolType: 'agent.register', toolCategory: 'agent' },
+    list_agents: { toolType: 'agent.list', toolCategory: 'agent' },
+    post_message: { toolType: 'message.post', toolCategory: 'message' },
+    send_dm: { toolType: 'message.dm', toolCategory: 'message' },
+    send_group_dm: { toolType: 'message.group_dm', toolCategory: 'message' },
+    list_dms: { toolType: 'message.dm_list', toolCategory: 'message' },
+    list_messages: { toolType: 'message.list', toolCategory: 'message' },
+    reply_to_thread: { toolType: 'message.reply', toolCategory: 'message' },
+    get_message_thread: { toolType: 'message.thread', toolCategory: 'message' },
+    search_messages: { toolType: 'message.search', toolCategory: 'message' },
+    create_channel: { toolType: 'channel.create', toolCategory: 'channel' },
+    list_channels: { toolType: 'channel.list', toolCategory: 'channel' },
+    join_channel: { toolType: 'channel.join', toolCategory: 'channel' },
+    leave_channel: { toolType: 'channel.leave', toolCategory: 'channel' },
+    set_channel_topic: { toolType: 'channel.set_topic', toolCategory: 'channel' },
+    archive_channel: { toolType: 'channel.archive', toolCategory: 'channel' },
+    invite_to_channel: { toolType: 'channel.invite', toolCategory: 'channel' },
+    add_reaction: { toolType: 'reaction.add', toolCategory: 'reaction' },
+    remove_reaction: { toolType: 'reaction.remove', toolCategory: 'reaction' },
+    check_inbox: { toolType: 'inbox.check', toolCategory: 'inbox' },
+    mark_message_read: { toolType: 'inbox.mark_read', toolCategory: 'inbox' },
+    get_message_readers: { toolType: 'inbox.reader_list', toolCategory: 'inbox' },
+};
+function agentRelayToolCallMetadata(name) {
+    const known = AGENT_RELAY_TOOL_CALL_METADATA[name];
+    return known ?? { toolType: name, toolCategory: 'tool' };
+}
+function trackAgentRelayToolCall(input) {
+    track('agent_relay_tool_call', {
+        tool_name: input.toolName,
+        tool_type: input.toolType,
+        tool_category: input.toolCategory,
+        transport: input.transport ?? 'unknown',
+        success: input.success,
+        duration_ms: Date.now() - input.startedAt,
+        ...(input.errorClass ? { error_class: input.errorClass } : {}),
+    });
+}
+function readAsIdentity(args) {
+    const [input] = args;
+    if (typeof input !== 'object' || input === null)
+        return undefined;
+    const as = input.as;
+    return typeof as === 'string' ? as : undefined;
+}
+/**
+ * Wrap `server.registerTool` so every owned tool emits `agent_relay_tool_call`
+ * telemetry, surfaces invalid-agent-token errors as recoverable results, and
+ * piggybacks a compact inbox summary onto successful results.
+ */
+export function enableInboxPiggyback(mcpServer, getSession, getAgentClient, invalidateAgentToken, telemetryTransport, actionToolNames = new Set()) {
+    const original = mcpServer.registerTool.bind(mcpServer);
+    const mutableServer = mcpServer;
+    mutableServer.registerTool = (name, config, handler) => {
+        if (!handler) {
+            return original(name, config, handler);
+        }
+        const wrapped = async (...args) => {
+            const asIdentity = readAsIdentity(args);
+            const startedAt = Date.now();
+            // Action-routed calls (`invoke_action`, `spawn`, and the dynamic
+            // per-action tools) run through the actions surface and deliberately skip
+            // per-tool telemetry; only the owned tools emit `agent_relay_tool_call`.
+            const toolMetadata = !ACTION_ROUTED_TOOL_NAMES.has(name) && !actionToolNames.has(name)
+                ? agentRelayToolCallMetadata(name)
+                : undefined;
+            let result;
+            try {
+                result = await handler(...args);
+            }
+            catch (err) {
+                if (name !== 'register_agent' && isInvalidAgentTokenError(err)) {
+                    invalidateAgentToken(asIdentity);
+                    if (toolMetadata) {
+                        trackAgentRelayToolCall({
+                            toolName: name,
+                            toolType: toolMetadata.toolType,
+                            toolCategory: toolMetadata.toolCategory,
+                            transport: telemetryTransport,
+                            startedAt,
+                            success: false,
+                            errorClass: errorClassName(err) ?? 'InvalidAgentToken',
+                        });
+                    }
+                    return invalidAgentTokenToolResult();
+                }
+                if (toolMetadata) {
+                    trackAgentRelayToolCall({
+                        toolName: name,
+                        toolType: toolMetadata.toolType,
+                        toolCategory: toolMetadata.toolCategory,
+                        transport: telemetryTransport,
+                        startedAt,
+                        success: false,
+                        errorClass: errorClassName(err),
+                    });
+                }
+                throw err;
+            }
+            if (name !== 'register_agent' && isInvalidAgentTokenToolResult(result)) {
+                invalidateAgentToken(asIdentity);
+                if (toolMetadata) {
+                    trackAgentRelayToolCall({
+                        toolName: name,
+                        toolType: toolMetadata.toolType,
+                        toolCategory: toolMetadata.toolCategory,
+                        transport: telemetryTransport,
+                        startedAt,
+                        success: false,
+                        errorClass: 'InvalidAgentToken',
+                    });
+                }
+                if (hasContentArray(result)) {
+                    result.content.push({ type: 'text', text: agentTokenRecoveryMessage() });
+                }
+                return result;
+            }
+            if (!SKIP_PIGGYBACK.has(name) && getSession().agentToken && hasContentArray(result)) {
+                try {
+                    const inbox = await getAgentClient(asIdentity).inbox();
+                    const inboxText = formatInbox(inbox, asIdentity ?? getSession().agentName);
+                    if (inboxText) {
+                        result.content.push({ type: 'text', text: inboxText });
+                    }
+                }
+                catch (err) {
+                    if (isInvalidAgentTokenError(err)) {
+                        invalidateAgentToken(asIdentity);
+                    }
+                }
+            }
+            if (toolMetadata) {
+                const resultIsError = isErrorToolResult(result);
+                trackAgentRelayToolCall({
+                    toolName: name,
+                    toolType: toolMetadata.toolType,
+                    toolCategory: toolMetadata.toolCategory,
+                    transport: telemetryTransport,
+                    startedAt,
+                    success: !resultIsError,
+                    ...(resultIsError ? { errorClass: 'ToolResultError' } : {}),
+                });
+            }
+            return result;
+        };
+        return original(name, config, wrapped);
+    };
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/cli/mcp/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../../src/cli/mcp/telemetry.ts"],"names":[],"mappings":"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"}

package/dist/cli/mcp/tool-results.d.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+/** Permissive output schema for tools that return arbitrary JSON objects. */
+export declare const jsonResult: z.ZodObject<{}, "passthrough", z.ZodTypeAny, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">, z.objectInputType<{}, z.ZodTypeAny, "passthrough">>;
+export type JsonToolResult = {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    structuredContent: Record<string, unknown>;
+};
+/** Wrap an arbitrary value as an MCP tool result with both text and structured content. */
+export declare function jsonContent(value: unknown): JsonToolResult;
+/** Wrap a human-readable message as an MCP tool result. */
+export declare function textContent(message: string, structuredContent?: Record<string, unknown>): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: Record<string, unknown>;
+};
+export declare function hasContentArray(value: unknown): value is {
+    content: Array<Record<string, unknown>>;
+};
+export declare function isErrorToolResult(value: unknown): boolean;
+/** Standard MCP error result describing an invalid/expired agent token. */
+export declare function invalidAgentTokenToolResult(): JsonToolResult & {
+    isError: true;
+};
+//# sourceMappingURL=tool-results.d.ts.map

package/dist/cli/mcp/tool-results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-results.d.ts","sourceRoot":"","sources":["../../../src/cli/mcp/tool-results.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,6EAA6E;AAC7E,eAAO,MAAM,UAAU,uJAA6B,CAAC;AAErD,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C,CAAC;AAEF,2FAA2F;AAC3F,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAS1D;AAED,2DAA2D;AAC3D,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,iBAAiB,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAe;;;;;;EAKpG;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI;IAAE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAAE,CAIpG;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEzD;AAED,2EAA2E;AAC3E,wBAAgB,2BAA2B,IAAI,cAAc,GAAG;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,CAShF"}

package/dist/cli/mcp/tool-results.js

@@ -0,0 +1,39 @@
+import { INVALID_AGENT_TOKEN_CODE, agentTokenRecoveryMessage } from '@agent-relay/sdk';
+import { z } from 'zod';
+/** Permissive output schema for tools that return arbitrary JSON objects. */
+export const jsonResult = z.object({}).passthrough();
+/** Wrap an arbitrary value as an MCP tool result with both text and structured content. */
+export function jsonContent(value) {
+    const structuredContent = typeof value === 'object' && value !== null && !Array.isArray(value)
+        ? value
+        : { value };
+    return {
+        content: [{ type: 'text', text: JSON.stringify(value, null, 2) }],
+        structuredContent,
+    };
+}
+/** Wrap a human-readable message as an MCP tool result. */
+export function textContent(message, structuredContent = { message }) {
+    return {
+        content: [{ type: 'text', text: message }],
+        structuredContent,
+    };
+}
+export function hasContentArray(value) {
+    return (typeof value === 'object' && value !== null && Array.isArray(value.content));
+}
+export function isErrorToolResult(value) {
+    return Boolean(value && typeof value === 'object' && value.isError === true);
+}
+/** Standard MCP error result describing an invalid/expired agent token. */
+export function invalidAgentTokenToolResult() {
+    const text = agentTokenRecoveryMessage();
+    return {
+        content: [{ type: 'text', text }],
+        structuredContent: {
+            error: { code: INVALID_AGENT_TOKEN_CODE, message: text },
+        },
+        isError: true,
+    };
+}
+//# sourceMappingURL=tool-results.js.map

package/dist/cli/mcp/tool-results.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-results.js","sourceRoot":"","sources":["../../../src/cli/mcp/tool-results.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AACvF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,6EAA6E;AAC7E,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AAOrD,2FAA2F;AAC3F,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,MAAM,iBAAiB,GACrB,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAClE,CAAC,CAAE,KAAiC;QACpC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;IAChB,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QACjE,iBAAiB;KAClB,CAAC;AACJ,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,oBAA6C,EAAE,OAAO,EAAE;IACnG,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACnD,iBAAiB;KAClB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAE,KAA+B,CAAC,OAAO,CAAC,CACvG,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAK,KAA+B,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC;AAC1G,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,2BAA2B;IACzC,MAAM,IAAI,GAAG,yBAAyB,EAAE,CAAC;IACzC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACjC,iBAAiB,EAAE;YACjB,KAAK,EAAE,EAAE,IAAI,EAAE,wBAAwB,EAAE,OAAO,EAAE,IAAI,EAAE;SACzD;QACD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/dist/cli/mcp/tool-shapes.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+/** Standard output schema for tools that return a single confirmation message. */
+export declare const messageResult: {
+    message: z.ZodString;
+};
+/**
+ * Optional `as` input field that lets a tool act on behalf of one of several
+ * registered agent identities in the same MCP session.
+ */
+export declare const identityOverrideInputShape: {
+    as: z.ZodOptional<z.ZodString>;
+};
+//# sourceMappingURL=tool-shapes.d.ts.map

package/dist/cli/mcp/tool-shapes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-shapes.d.ts","sourceRoot":"","sources":["../../../src/cli/mcp/tool-shapes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,kFAAkF;AAClF,eAAO,MAAM,aAAa;;CAEzB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;CAKtC,CAAC"}

package/dist/cli/mcp/tool-shapes.js

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+/** Standard output schema for tools that return a single confirmation message. */
+export const messageResult = {
+    message: z.string().describe('Human-readable confirmation message'),
+};
+/**
+ * Optional `as` input field that lets a tool act on behalf of one of several
+ * registered agent identities in the same MCP session.
+ */
+export const identityOverrideInputShape = {
+    as: z
+        .string()
+        .optional()
+        .describe('Registered agent identity to act as when multiple identities have been registered'),
+};
+//# sourceMappingURL=tool-shapes.js.map

package/dist/cli/mcp/tool-shapes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-shapes.js","sourceRoot":"","sources":["../../../src/cli/mcp/tool-shapes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,kFAAkF;AAClF,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;CACpE,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,EAAE,EAAE,CAAC;SACF,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,mFAAmF,CAAC;CACjG,CAAC"}

package/dist/cli/mcp/types.d.ts

@@ -0,0 +1,38 @@
+import type { RelayCast, AgentClient } from '@relaycast/sdk';
+import type { ActionAuditEvent, AgentRelayActions } from '@agent-relay/sdk/actions';
+import type { RealtimeResourceBridge, SubscriptionManager } from './resources.js';
+export type AgentType = 'agent' | 'human';
+export type RelayCastLike = Pick<RelayCast, 'agents'>;
+export type AgentClientLike = AgentClient;
+export interface AgentRelayMcpServerOptions {
+    workspaceKey?: string;
+    /** @deprecated Use workspaceKey. */
+    apiKey?: string;
+    baseUrl?: string;
+    agentToken?: string;
+    agentName?: string;
+    agentType?: AgentType;
+    strictAgentName?: boolean;
+    telemetryTransport?: 'stdio' | 'http';
+    skipBootstrap?: boolean;
+    actions?: AgentRelayActions;
+    onActionAuditEvent?: (event: ActionAuditEvent) => Promise<void> | void;
+}
+export interface RegisteredAgent {
+    agentName: string;
+    agentToken: string;
+}
+export interface SessionState {
+    workspaceKey: string | null;
+    agentToken: string | null;
+    agentName: string | null;
+    agents: Map<string, RegisteredAgent>;
+    wsBridge: RealtimeResourceBridge | null;
+    subscriptions: SubscriptionManager | null;
+    wsInitAttempted: boolean;
+}
+export type RegistrationSession = Pick<SessionState, 'workspaceKey' | 'agentToken' | 'agentName'> & {
+    agents?: Map<string, RegisteredAgent>;
+};
+export type SessionSetter = (partial: Partial<SessionState>) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/cli/mcp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/mcp/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEpF,OAAO,KAAK,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAElF,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAC1C,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AACtD,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC;AAE1C,MAAM,WAAW,0BAA0B;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,kBAAkB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACtC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACxE;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACrC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACxC,aAAa,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC1C,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,YAAY,EAAE,cAAc,GAAG,YAAY,GAAG,WAAW,CAAC,GAAG;IAClG,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC"}

package/dist/cli/mcp/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cli/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/cli/mcp/types.ts"],"names":[],"mappings":""}

package/dist/cli/mcp/workspace.d.ts

@@ -0,0 +1,10 @@
+import type { RegistrationSession } from './types.js';
+/** Create a new RelayCast workspace, returning the raw provisioning payload. */
+export declare function createWorkspace(name: string, baseUrl?: string): Promise<Record<string, unknown>>;
+/** Extract a workspace key from a provisioning payload, tolerating naming variants. */
+export declare function extractWorkspaceKey(payload: Record<string, unknown>): string | undefined;
+/** Extract a workspace name from a provisioning payload, falling back to `fallback`. */
+export declare function extractWorkspaceName(payload: Record<string, unknown>, fallback: string): string;
+/** Throw a descriptive error when the session has no workspace key configured. */
+export declare function requireWorkspaceKey(session: RegistrationSession): void;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/cli/mcp/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../src/cli/mcp/workspace.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,gFAAgF;AAChF,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAKtG;AAED,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAcxF;AAED,wFAAwF;AACxF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAK/F;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAQtE"}

package/dist/cli/mcp/workspace.js

@@ -0,0 +1,36 @@
+import { RelayCast } from '@relaycast/sdk';
+import { relaycastWorkspaceTelemetryOptions } from '../lib/relaycast-telemetry.js';
+/** Create a new RelayCast workspace, returning the raw provisioning payload. */
+export async function createWorkspace(name, baseUrl) {
+    return (await RelayCast.createWorkspace(name, {
+        baseUrl,
+        ...relaycastWorkspaceTelemetryOptions(),
+    }));
+}
+/** Extract a workspace key from a provisioning payload, tolerating naming variants. */
+export function extractWorkspaceKey(payload) {
+    const data = payload.data && typeof payload.data === 'object' ? payload.data : {};
+    const value = payload.workspaceKey ??
+        payload.workspace_key ??
+        payload.apiKey ??
+        payload.api_key ??
+        data.workspaceKey ??
+        data.workspace_key ??
+        data.apiKey ??
+        data.api_key;
+    return typeof value === 'string' && value.trim() ? value : undefined;
+}
+/** Extract a workspace name from a provisioning payload, falling back to `fallback`. */
+export function extractWorkspaceName(payload, fallback) {
+    const data = payload.data && typeof payload.data === 'object' ? payload.data : {};
+    const value = payload.workspaceName ?? payload.workspace_name ?? payload.name ?? data.workspaceName;
+    return typeof value === 'string' && value.trim() ? value : fallback;
+}
+/** Throw a descriptive error when the session has no workspace key configured. */
+export function requireWorkspaceKey(session) {
+    if (session.workspaceKey) {
+        return;
+    }
+    throw new Error('Workspace key not configured. Call "create_workspace" first, or "set_workspace_key" if someone shared a workspace key.');
+}
+//# sourceMappingURL=workspace.js.map

package/dist/cli/mcp/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../../src/cli/mcp/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,kCAAkC,EAAE,MAAM,+BAA+B,CAAC;AAGnF,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,OAAgB;IAClE,OAAO,CAAC,MAAM,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE;QAC5C,OAAO;QACP,GAAG,kCAAkC,EAAE;KACxC,CAAC,CAA4B,CAAC;AACjC,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,mBAAmB,CAAC,OAAgC;IAClE,MAAM,IAAI,GACR,OAAO,CAAC,IAAI,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAE,OAAO,CAAC,IAAgC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpG,MAAM,KAAK,GACT,OAAO,CAAC,YAAY;QACpB,OAAO,CAAC,aAAa;QACrB,OAAO,CAAC,MAAM;QACd,OAAO,CAAC,OAAO;QACf,IAAI,CAAC,YAAY;QACjB,IAAI,CAAC,aAAa;QAClB,IAAI,CAAC,MAAM;QACX,IAAI,CAAC,OAAO,CAAC;IAEf,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvE,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,oBAAoB,CAAC,OAAgC,EAAE,QAAgB;IACrF,MAAM,IAAI,GACR,OAAO,CAAC,IAAI,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAE,OAAO,CAAC,IAAgC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpG,MAAM,KAAK,GAAG,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,aAAa,CAAC;IACpG,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AACtE,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,mBAAmB,CAAC,OAA4B;IAC9D,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACzB,OAAO;IACT,CAAC;IAED,MAAM,IAAI,KAAK,CACb,wHAAwH,CACzH,CAAC;AACJ,CAAC"}

package/dist/index.cjs

@@ -283,7 +283,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // ../sdk/node_modules/@relaycast/sdk/dist/version.js
-var SDK_VERSION = "4.1.1";
+var SDK_VERSION = "4.1.4";
 
 // ../sdk/node_modules/zod/v4/classic/external.js
 var external_exports = {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay",
-  "version": "8.9.0",
+  "version": "8.9.2",
   "description": "Real-time agent-to-agent communication system",
   "type": "module",
   "main": "dist/index.cjs",
@@ -43,14 +43,14 @@
     "pack:validate": "npm pack --dry-run"
   },
   "dependencies": {
-    "@agent-relay/cloud": "8.9.0",
-    "@agent-relay/config": "8.9.0",
-    "@agent-relay/fleet": "8.9.0",
-    "@agent-relay/harness-driver": "8.9.0",
-    "@agent-relay/sdk": "8.9.0",
-    "@agent-relay/utils": "8.9.0",
+    "@agent-relay/cloud": "8.9.2",
+    "@agent-relay/config": "8.9.2",
+    "@agent-relay/fleet": "8.9.2",
+    "@agent-relay/harness-driver": "8.9.2",
+    "@agent-relay/sdk": "8.9.2",
+    "@agent-relay/utils": "8.9.2",
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "@relaycast/sdk": "^4.1.1",
+    "@relaycast/sdk": "^4.1.2",
     "@relayflows/cli": "^1.0.1",
     "@xterm/headless": "^6.0.0",
     "commander": "^12.1.0",