@tapicker/bridge 1.0.0 → 1.1.0

package/dist/commands.d.ts

@@ -1,11 +1,14 @@
 import { z } from 'zod';
+import type { ExportStore } from './bridge/export-store.js';
 import type { BridgeService } from './bridge/bridge-service.js';
 export type CommandContext = {
     bridge: BridgeService;
+    exports?: ExportStore;
 };
 type CommandDefinition = {
     description: string;
     schema: z.ZodType;
+    resultSchema: z.ZodType;
     execute: (input: unknown, context: CommandContext, clientId?: string) => Promise<unknown>;
 };
 export declare function getCommandDefinition(name: string): CommandDefinition;
@@ -17,11 +20,16 @@ export declare function getCommandCapabilities(): ({
         clientId: z.ZodOptional<z.ZodUUID>;
         input: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
     }, z.core.$strict>>;
+    outputSchema: z.core.ZodStandardJSONSchemaPayload<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
 } | {
     name: string;
     description: string;
     transport: string;
     path: string;
+    outputSchema: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
+        workflowId: z.ZodString;
+        clientId: z.ZodUUID;
+    }, z.core.$strip>>;
     inputSchema: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
         clientId: z.ZodOptional<z.ZodUUID>;
         input: z.ZodObject<{

package/dist/commands.js

@@ -1,7 +1,7 @@
 import { z } from 'zod';
-import { DEFAULT_WORKFLOW_WATCH_WS_PATH } from './constants.js';
+import { DEFAULT_WORKFLOW_STATUS_WATCH_WS_PATH } from './constants.js';
 import { BridgeError } from './errors.js';
-import { WorkflowControlInputSchema, DataInputSchema, WorkflowStartInputSchema, WorkflowStartResultSchema, WorkflowStatusDataSchema, WorkflowWatchRequestSchema, } from './protocol/schema.js';
+import { WorkflowControlInputSchema, DataInputSchema, WorkflowStartInputSchema, WorkflowStartResultSchema, WorkflowStatusInputSchema, WorkflowStatusResultSchema, WorkflowControlResultSchema, DataGetResultSchema, DataGetInputSchema, DataListInputSchema, DataListResultSchema, DataPreviewInputSchema, DataPreviewResultSchema, DEFAULT_DATA_PAGE_SIZE, DataDeleteResultSchema, UserMeInputSchema, UserMeResultSchema, DataExportInputSchema, DataExportReceiptSchema, DataExportResultSchema, WorkflowStatusWatchRequestSchema, WorkflowLogsInputSchema, WorkflowLogInputSchema, WorkflowLogsResultSchema, WorkflowLogResultSchema, WorkflowListInputSchema, WorkflowListResultSchema, WorkflowGetInputSchema, WorkflowGetResultSchema, WorkflowCreateInputSchema, WorkflowCreateResultSchema, WorkflowUpdateInputSchema, WorkflowUpdateResultSchema, WorkflowGuideInputSchema, WorkflowGuideResultSchema, WorkflowSchemaInputSchema, WorkflowSchemaResultSchema, WorkflowValidateInputSchema, WorkflowValidateResultSchema, } from './protocol/schema.js';
 const CommandRequestSchema = z
     .object({
     clientId: z.uuid().optional(),
@@ -9,72 +9,306 @@ const CommandRequestSchema = z
 })
     .strict();
 const commandDefinitions = {
-    'workflow.start': {
-        description: 'Start one Workflow in a selected connected Tapicker Extension',
-        schema: WorkflowStartInputSchema,
+    'workflow.guide': {
+        description: 'Read Workflow authoring documentation by topic; start with overview and follow references.topic',
+        schema: WorkflowGuideInputSchema,
+        resultSchema: WorkflowGuideResultSchema,
         execute: async (input, context, clientId) => {
-            const { clientId: selectedClientId, result } = await context.bridge.sendCommandWithClientId('workflow.start', input, clientId);
-            if (!result || typeof result !== 'object' || Array.isArray(result)) {
-                throw new BridgeError('InvalidExtensionResponse', 'Extension returned an invalid workflow.start response', {
+            const result = await forwardCommand('workflow.guide', input, WorkflowGuideResultSchema, context, clientId);
+            if (result.topic !== input.topic) {
+                throw new BridgeError('InvalidExtensionResponse', 'Extension returned a different Workflow guide topic', {
                     status: 502,
                 });
             }
-            const parsed = WorkflowStartResultSchema.safeParse({ ...result, clientId: selectedClientId });
-            if (!parsed.success || parsed.data.workflowId !== input.workflowId) {
-                throw new BridgeError('InvalidExtensionResponse', 'Extension returned an invalid workflow.start response', {
+            return result;
+        },
+    },
+    'workflow.schema': {
+        description: 'Get JSON Schema for Workflow documents using the selected node types; omit nodeTypes for all',
+        schema: WorkflowSchemaInputSchema,
+        resultSchema: WorkflowSchemaResultSchema,
+        execute: (input, context, clientId) => forwardCommand('workflow.schema', input, WorkflowSchemaResultSchema, context, clientId),
+    },
+    'workflow.validate': {
+        description: 'Check a Workflow document without saving or running it; inspect isValid and normalized nodes or issues',
+        schema: WorkflowValidateInputSchema,
+        resultSchema: WorkflowValidateResultSchema,
+        execute: (input, context, clientId) => forwardCommand('workflow.validate', input, WorkflowValidateResultSchema, context, clientId),
+    },
+    'workflow.list': {
+        description: 'List Workflow summaries with scope, name, exact host filtering and pagination',
+        schema: WorkflowListInputSchema,
+        resultSchema: WorkflowListResultSchema,
+        execute: async (input, context, clientId) => {
+            const result = await forwardCommand('workflow.list', input, WorkflowListResultSchema, context, clientId);
+            const query = input;
+            if (result.scope !== query.scope ||
+                result.page !== query.page ||
+                result.pageSize !== query.pageSize ||
+                result.workflows.length > query.pageSize) {
+                throw new BridgeError('InvalidExtensionResponse', 'Extension returned a different Workflow list query', {
                     status: 502,
-                    details: parsed.success
-                        ? {
-                            requestedWorkflowId: input.workflowId,
-                            returnedWorkflowId: parsed.data.workflowId,
-                        }
-                        : parsed.error.issues,
                 });
             }
-            return parsed.data;
+            return result;
+        },
+    },
+    'workflow.get': {
+        description: 'Read current Workflow metadata and startup arguments, with nodes when permitted',
+        schema: WorkflowGetInputSchema,
+        resultSchema: WorkflowGetResultSchema,
+        execute: async (input, context, clientId) => {
+            const result = await forwardCommand('workflow.get', input, WorkflowGetResultSchema, context, clientId);
+            if (result.workflow.id !== input.workflowId) {
+                throw new BridgeError('InvalidExtensionResponse', 'Extension returned a different Workflow', { status: 502 });
+            }
+            return result;
+        },
+    },
+    'workflow.create': {
+        description: 'Validate and create a private Workflow without running it; check the list before retrying a failed request',
+        schema: WorkflowCreateInputSchema,
+        resultSchema: WorkflowCreateResultSchema,
+        execute: async (input, context, clientId) => {
+            const result = await forwardCommand('workflow.create', input, WorkflowCreateResultSchema, context, clientId);
+            if (!result.workflowName.endsWith(`/${input.name}`)) {
+                throw new BridgeError('InvalidExtensionResponse', 'Extension returned a different Workflow name; check the Workflow list before retrying', { status: 502 });
+            }
+            return result;
+        },
+    },
+    'workflow.update': {
+        description: 'Update Workflow fields using the revision from workflow.get; on conflict read again and reconcile changes',
+        schema: WorkflowUpdateInputSchema,
+        resultSchema: WorkflowUpdateResultSchema,
+        execute: async (input, context, clientId) => {
+            const result = await forwardCommand('workflow.update', input, WorkflowUpdateResultSchema, context, clientId);
+            const query = input;
+            if (result.workflowId !== query.workflowId || result.revision !== query.revision + 1) {
+                throw new BridgeError('InvalidExtensionResponse', 'Extension returned an invalid Workflow update response; read the Workflow before retrying', { status: 502 });
+            }
+            return result;
+        },
+    },
+    'workflow.start': {
+        description: 'Start one Workflow in a selected connected Tapicker Extension',
+        schema: WorkflowStartInputSchema,
+        resultSchema: WorkflowStartResultSchema,
+        execute: async (input, context, clientId) => {
+            const result = await forwardCommand('workflow.start', input, WorkflowStartResultSchema, context, clientId, 55_000);
+            if (result.workflowId !== input.workflowId) {
+                throw new BridgeError('InvalidExtensionResponse', 'Extension returned a different Workflow start response', {
+                    status: 502,
+                    details: {
+                        requestedWorkflowId: input.workflowId,
+                        returnedWorkflowId: result.workflowId,
+                    },
+                });
+            }
+            return result;
         },
     },
     'workflow.pause': {
         description: 'Pause a running Workflow in a selected connected Tapicker Extension',
         schema: WorkflowControlInputSchema,
-        execute: (input, context, clientId) => context.bridge.sendCommand('workflow.pause', input, clientId),
+        resultSchema: WorkflowControlResultSchema,
+        execute: (input, context, clientId) => controlWorkflow('pause', input, context, clientId),
     },
     'workflow.resume': {
         description: 'Resume a paused Workflow in a selected connected Tapicker Extension',
         schema: WorkflowControlInputSchema,
-        execute: (input, context, clientId) => context.bridge.sendCommand('workflow.resume', input, clientId),
+        resultSchema: WorkflowControlResultSchema,
+        execute: (input, context, clientId) => controlWorkflow('resume', input, context, clientId),
     },
     'workflow.stop': {
-        description: 'Stop a running Workflow in a selected connected Tapicker Extension',
+        description: 'Request a stop for the active Workflow instance',
         schema: WorkflowControlInputSchema,
-        execute: (input, context, clientId) => context.bridge.sendCommand('workflow.stop', input, clientId),
+        resultSchema: WorkflowControlResultSchema,
+        execute: (input, context, clientId) => controlWorkflow('stop', input, context, clientId),
     },
     'workflow.status': {
-        description: 'Get the current or most recently persisted Workflow status',
-        schema: WorkflowControlInputSchema,
+        description: 'Read the latest recorded Workflow status in the selected Extension',
+        schema: WorkflowStatusInputSchema,
+        resultSchema: WorkflowStatusResultSchema,
         execute: async (input, context, clientId) => {
-            const result = await context.bridge.sendCommand('workflow.status.get', input, clientId);
-            const parsed = WorkflowStatusDataSchema.safeParse(result);
-            if (!parsed.success || parsed.data.workflowId !== input.workflowId) {
-                throw new BridgeError('InvalidExtensionResponse', 'Extension returned an invalid workflow status response', {
+            const result = await forwardCommand('workflow.status', input, WorkflowStatusResultSchema, context, clientId);
+            const query = input;
+            if (result.workflowId !== query.workflowId ||
+                (query.runAt !== undefined && result.runAt !== query.runAt) ||
+                (result.dataSummary !== undefined && (!query.includeDataSummary || result.status !== 'stopped'))) {
+                throw new BridgeError('InvalidExtensionResponse', 'Extension returned a different Workflow status response', {
                     status: 502,
-                    details: parsed.success ? undefined : parsed.error.issues,
                 });
             }
-            return parsed.data;
+            return result;
+        },
+    },
+    'workflow.logs': {
+        description: 'Query the latest run logs with optional level filters and pagination; read a single log for full details',
+        schema: WorkflowLogsInputSchema,
+        resultSchema: WorkflowLogsResultSchema,
+        execute: async (input, context, clientId) => {
+            const query = input;
+            const result = await forwardCommand('workflow.logs', input, WorkflowLogsResultSchema, context, clientId);
+            if (result.workflowId !== query.workflowId ||
+                (query.runAt !== undefined && result.runAt !== query.runAt) ||
+                result.logs.length > query.limit ||
+                result.logs.some((log, index, logs) => log.workflowId !== query.workflowId ||
+                    (query.levels !== undefined && !query.levels.includes(log.level)) ||
+                    (query.before !== undefined && log.id >= query.before) ||
+                    (query.after !== undefined && log.id <= query.after) ||
+                    (index > 0 && log.id <= logs[index - 1].id))) {
+                throw new BridgeError('InvalidExtensionResponse', 'Extension returned an invalid workflow.logs response', {
+                    status: 502,
+                });
+            }
+            return result;
+        },
+    },
+    'workflow.log': {
+        description: 'Get one log from the latest run with full readable details, without preview truncation',
+        schema: WorkflowLogInputSchema,
+        resultSchema: WorkflowLogResultSchema,
+        execute: async (input, context, clientId) => {
+            const query = input;
+            const result = await forwardCommand('workflow.log', input, WorkflowLogResultSchema, context, clientId);
+            if (result.workflowId !== query.workflowId ||
+                result.log.workflowId !== query.workflowId ||
+                result.log.id !== query.logId ||
+                (query.runAt !== undefined && result.runAt !== query.runAt)) {
+                throw new BridgeError('InvalidExtensionResponse', 'Extension returned an invalid workflow.log response', {
+                    status: 502,
+                });
+            }
+            return result;
+        },
+    },
+    'data.list': {
+        description: 'List saved data tables with optional name and Workflow ownership filters',
+        schema: DataListInputSchema,
+        resultSchema: DataListResultSchema,
+        execute: async (input, context, clientId) => {
+            const query = input;
+            const result = await forwardCommand('data.list', input, DataListResultSchema, context, clientId);
+            if (result.page !== query.page ||
+                result.pageSize !== query.pageSize ||
+                result.tables.length > query.pageSize ||
+                (result.hasMore && result.tables.length !== query.pageSize)) {
+                throw new BridgeError('InvalidExtensionResponse', 'Extension returned an invalid data.list response', {
+                    status: 502,
+                });
+            }
+            return result;
+        },
+    },
+    'data.preview': {
+        description: 'Preview up to 10 oldest or latest inserted rows without using export quota',
+        schema: DataPreviewInputSchema,
+        resultSchema: DataPreviewResultSchema,
+        execute: async (input, context, clientId) => {
+            const result = await forwardCommand('data.preview', input, DataPreviewResultSchema, context, clientId);
+            const query = input;
+            if (result.tableId !== query.tableId || result.sample !== query.sample) {
+                throw new BridgeError('InvalidExtensionResponse', 'Extension returned an invalid data.preview response', {
+                    status: 502,
+                });
+            }
+            return result;
         },
     },
     'data.get': {
-        description: 'Get an extracted data table by tableId; the rows count against the Extension export quota',
-        schema: DataInputSchema,
-        execute: (input, context, clientId) => context.bridge.sendCommand('data.get', input, clientId),
+        description: 'Read one page or all rows from a saved table; returned rows consume export quota',
+        schema: DataGetInputSchema,
+        resultSchema: DataGetResultSchema,
+        execute: async (input, context, clientId) => {
+            const result = await forwardCommand('data.get', input, DataGetResultSchema, context, clientId);
+            const query = input;
+            const validPagination = 'page' in result
+                ? query.all !== true &&
+                    result.page === (query.page ?? 1) &&
+                    result.pageSize === (query.pageSize ?? DEFAULT_DATA_PAGE_SIZE) &&
+                    result.rows.length <= result.pageSize &&
+                    (!result.hasMore || result.rows.length === result.pageSize)
+                : query.all === true;
+            if (result.tableId !== query.tableId || !validPagination) {
+                throw new BridgeError('InvalidExtensionResponse', 'Extension returned an invalid data.get response', {
+                    status: 502,
+                });
+            }
+            return result;
+        },
+    },
+    'data.export': {
+        description: 'Export a saved table as a downloadable file',
+        schema: DataExportInputSchema,
+        resultSchema: DataExportResultSchema,
+        execute: async (input, context, clientId) => {
+            if (!context.exports)
+                throw new BridgeError('ExportUnavailable', 'File exports are unavailable', { status: 503 });
+            const query = input;
+            const selectedClientId = context.bridge.resolveCommandClientId('data.export', clientId);
+            return context.exports.create(async (upload) => {
+                const result = await forwardCommand('data.export', { ...query, ...upload }, DataExportReceiptSchema, context, selectedClientId, 120_000);
+                if (result.tableId !== query.tableId || result.format !== query.format) {
+                    throw new BridgeError('InvalidExtensionResponse', 'Extension returned an invalid data.export response', {
+                        status: 502,
+                    });
+                }
+                return result;
+            });
+        },
     },
     'data.delete': {
         description: 'Delete an extracted data table by tableId',
         schema: DataInputSchema,
-        execute: (input, context, clientId) => context.bridge.sendCommand('data.delete', input, clientId),
+        resultSchema: DataDeleteResultSchema,
+        execute: async (input, context, clientId) => {
+            const result = await forwardCommand('data.delete', input, DataDeleteResultSchema, context, clientId);
+            if (result.tableId !== input.tableId) {
+                throw new BridgeError('InvalidExtensionResponse', 'Extension returned an invalid data.delete response', {
+                    status: 502,
+                });
+            }
+            return result;
+        },
+    },
+    'user.me': {
+        description: 'Read the current Tapicker account and plan for the selected Extension',
+        schema: UserMeInputSchema.default({}),
+        resultSchema: UserMeResultSchema,
+        execute: async (input, context, clientId) => forwardCommand('user.me', input, UserMeResultSchema, context, clientId),
     },
 };
+/**
+ * 命令共用目标路由与结果校验，业务节点规则只由 Extension 维护。
+ */
+async function forwardCommand(name, input, schema, context, clientId, ...timeout) {
+    const { clientId: selectedClientId, result } = await context.bridge.sendCommandWithClientId(name, input, clientId, ...timeout);
+    if (!result || typeof result !== 'object' || Array.isArray(result)) {
+        throw new BridgeError('InvalidExtensionResponse', `Extension returned an invalid ${name} response`, { status: 502 });
+    }
+    const parsed = schema.safeParse({ ...result, clientId: selectedClientId });
+    if (!parsed.success) {
+        throw new BridgeError('InvalidExtensionResponse', `Extension returned an invalid ${name} response`, {
+            status: 502,
+            details: { issues: parsed.error.issues },
+        });
+    }
+    return parsed.data;
+}
+/**
+ * 校验控制操作回执，避免空响应或工作流标识不匹配时误报成功。
+ */
+async function controlWorkflow(action, input, context, clientId) {
+    const result = await forwardCommand(`workflow.${action}`, input, WorkflowControlResultSchema, context, clientId);
+    if (result.workflowId !== input.workflowId) {
+        throw new BridgeError('InvalidExtensionResponse', `Extension returned a different workflow.${action} response`, {
+            status: 502,
+            details: { requestedWorkflowId: input.workflowId, returnedWorkflowId: result.workflowId },
+        });
+    }
+    return result;
+}
 export function getCommandDefinition(name) {
     return commandDefinitions[name];
 }
@@ -87,14 +321,14 @@ export async function dispatchCommand(name, rawInput, context) {
     if (!request.success) {
         throw new BridgeError('InvalidArguments', `Invalid command request for ${name}`, {
             status: 400,
-            details: request.error.issues,
+            details: { issues: request.error.issues },
         });
     }
     const parsed = definition.schema.safeParse(request.data.input);
     if (!parsed.success) {
         throw new BridgeError('InvalidArguments', `Invalid arguments for ${name}`, {
             status: 400,
-            details: parsed.error.issues,
+            details: { issues: parsed.error.issues },
         });
     }
     return definition.execute(parsed.data, context, request.data.clientId);
@@ -110,13 +344,15 @@ export function getCommandCapabilities() {
                 input: definition.schema,
             })
                 .strict(), { io: 'input' }),
+            outputSchema: z.toJSONSchema(definition.resultSchema),
         })),
         {
-            name: 'workflow.watch',
-            description: 'Watch one Workflow through the workflow.watch WebSocket endpoint',
+            name: 'workflow.status.watch',
+            description: 'Watch one Workflow through the workflow.status.watch WebSocket endpoint',
             transport: 'websocket',
-            path: DEFAULT_WORKFLOW_WATCH_WS_PATH,
-            inputSchema: z.toJSONSchema(WorkflowWatchRequestSchema, { io: 'input' }),
+            path: DEFAULT_WORKFLOW_STATUS_WATCH_WS_PATH,
+            outputSchema: z.toJSONSchema(WorkflowControlResultSchema),
+            inputSchema: z.toJSONSchema(WorkflowStatusWatchRequestSchema, { io: 'input' }),
         },
     ];
 }

package/dist/constants.d.ts

@@ -1,10 +1,10 @@
-export declare const VERSION = "1.0.0";
+export declare const VERSION: string;
 export declare const PROTOCOL_VERSION = 1;
 export declare const DEFAULT_HOST = "127.0.0.1";
 export declare const DEFAULT_PORT = 9520;
 export declare const DEFAULT_PORT_MAX = 9530;
 export declare const DEFAULT_WS_PATH = "/ws";
-export declare const DEFAULT_WORKFLOW_WATCH_WS_PATH = "/v1/commands/workflow.watch";
+export declare const DEFAULT_WORKFLOW_STATUS_WATCH_WS_PATH = "/v1/commands/workflow.status.watch";
 export declare const DEFAULT_MCP_PATH = "/mcp";
 export declare const DEFAULT_REQUEST_TIMEOUT = 30000;
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.js

@@ -1,10 +1,12 @@
-export const VERSION = '1.0.0';
+import { createRequire } from 'node:module';
+const packageInfo = createRequire(import.meta.url)('../package.json');
+export const VERSION = packageInfo.version;
 export const PROTOCOL_VERSION = 1;
 export const DEFAULT_HOST = '127.0.0.1';
 export const DEFAULT_PORT = 9520;
 export const DEFAULT_PORT_MAX = 9530;
 export const DEFAULT_WS_PATH = '/ws';
-export const DEFAULT_WORKFLOW_WATCH_WS_PATH = '/v1/commands/workflow.watch';
+export const DEFAULT_WORKFLOW_STATUS_WATCH_WS_PATH = '/v1/commands/workflow.status.watch';
 export const DEFAULT_MCP_PATH = '/mcp';
 export const DEFAULT_REQUEST_TIMEOUT = 30_000;
 //# sourceMappingURL=constants.js.map

package/dist/http-client.d.ts

@@ -0,0 +1,24 @@
+/**
+ * CLI 与 MCP stdio 共用 HTTP 请求和响应校验。
+ */
+export declare function createHttpBridgeApi(baseUrl: string, token?: string): {
+    executeCommand: (name: string, input: unknown) => Promise<unknown>;
+    listExtensions: () => Promise<{
+        ready: boolean;
+        capabilities: string[];
+        pairingRequired?: boolean | undefined;
+        clientId?: string | undefined;
+        clientName?: string | undefined;
+        clientVersion?: string | undefined;
+        user?: {
+            id: string;
+            username: string;
+            plan: "Free" | "Plus" | "Pro";
+        } | undefined;
+    }[]>;
+};
+/**
+ * 接受基础地址或复制的 /mcp 端点，统一为 origin；其他路径、凭据和查询串仍拒绝。
+ */
+export declare function parseBridgeUrl(value: string): URL;
+//# sourceMappingURL=http-client.d.ts.map

package/dist/http-client.js

@@ -0,0 +1,101 @@
+import { BridgeError } from './errors.js';
+import { ExtensionListResultSchema, SafeResultSchema } from './protocol/schema.js';
+/**
+ * CLI 与 MCP stdio 共用 HTTP 请求和响应校验。
+ */
+export function createHttpBridgeApi(baseUrl, token) {
+    const bridgeUrl = parseBridgeUrl(baseUrl);
+    const headers = {};
+    if (token)
+        headers.Authorization = `Bearer ${token}`;
+    const request = async (path, init = {}, timeout = 30_000) => {
+        const url = new URL(path, bridgeUrl);
+        let response;
+        try {
+            response = await fetch(url, {
+                ...init,
+                headers: { ...headers, ...init.headers },
+                signal: AbortSignal.timeout(timeout),
+            });
+        }
+        catch (cause) {
+            throw new BridgeError('BridgeUnavailable', `Unable to reach Tapicker Bridge at ${url.origin}`, {
+                status: 503,
+                cause,
+            });
+        }
+        let body;
+        try {
+            body = await response.json();
+        }
+        catch (cause) {
+            throw new BridgeError('InvalidBridgeResponse', 'Bridge returned an invalid JSON response', { status: 502, cause });
+        }
+        return { response, body };
+    };
+    return {
+        executeCommand: async (name, input) => {
+            let timeout;
+            if (name === 'data.export')
+                timeout = 130_000;
+            if (name === 'workflow.start')
+                timeout = 60_000;
+            const { response, body } = await request(`/v1/commands/${encodeURIComponent(name)}`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(input),
+            }, timeout);
+            const parsed = SafeResultSchema.safeParse(body);
+            if (!parsed.success || (parsed.data.ok && (!response.ok || !Object.hasOwn(parsed.data, 'data')))) {
+                throw new BridgeError('InvalidBridgeResponse', 'Bridge returned an invalid command response', { status: 502 });
+            }
+            if (!parsed.data.ok) {
+                throw new BridgeError(parsed.data.error.code, parsed.data.error.message, {
+                    status: response.ok ? 502 : response.status,
+                    details: parsed.data.error.details,
+                });
+            }
+            return parsed.data.data;
+        },
+        listExtensions: async () => {
+            const { response, body } = await request('/v1/extensions');
+            if (!response.ok) {
+                const parsed = SafeResultSchema.safeParse(body);
+                if (parsed.success && !parsed.data.ok) {
+                    throw new BridgeError(parsed.data.error.code, parsed.data.error.message, {
+                        status: response.status,
+                        details: parsed.data.error.details,
+                    });
+                }
+            }
+            const parsed = ExtensionListResultSchema.safeParse(body);
+            if (!response.ok || !parsed.success) {
+                throw new BridgeError('InvalidBridgeResponse', 'Bridge returned an invalid Extension list', { status: 502 });
+            }
+            return parsed.data.extensions;
+        },
+    };
+}
+/**
+ * 接受基础地址或复制的 /mcp 端点，统一为 origin；其他路径、凭据和查询串仍拒绝。
+ */
+export function parseBridgeUrl(value) {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch (cause) {
+        throw new BridgeError('InvalidBridgeUrl', 'Bridge URL must be a valid HTTP or HTTPS URL', { status: 400, cause });
+    }
+    if (url.protocol !== 'http:' && url.protocol !== 'https:') {
+        throw new BridgeError('InvalidBridgeUrl', 'Bridge URL must use HTTP or HTTPS', { status: 400 });
+    }
+    if (url.username || url.password || !['/', '/mcp', '/mcp/'].includes(url.pathname) || url.search || url.hash) {
+        throw new BridgeError('InvalidBridgeUrl', 'Use an HTTP(S) base URL or /mcp endpoint without credentials, query or fragment', {
+            status: 400,
+        });
+    }
+    url.pathname = '/';
+    return url;
+}
+//# sourceMappingURL=http-client.js.map

package/dist/index.d.ts

@@ -3,8 +3,8 @@ export { BridgeService } from './bridge/bridge-service.js';
 export { ExtensionSession } from './bridge/extension-session.js';
 export { dispatchCommand, getCommandCapabilities, getCommandDefinition } from './commands.js';
 export { BridgeError, safeError, safeSuccess, serializeBridgeError } from './errors.js';
-export { BridgeHelloDataSchema, BridgePairDataSchema, DataInputSchema, ExtensionHelloInputSchema, ExtensionPairInputSchema, MessageEnvelopeSchema, SafeResultSchema, TabTargetSchema, WorkflowControlInputSchema, WorkflowLifecycleStateSchema, WorkflowStatusEventSchema, WorkflowStatusDataSchema, WorkflowStartInputSchema, WorkflowStartResultSchema, WorkflowWatchRequestSchema, createEnvelope, parseEnvelope, } from './protocol/schema.js';
-export type { DataInput, WorkflowControlInput, WorkflowStartInput, WorkflowStartResult, WorkflowStatusData, WorkflowStatusEvent, WorkflowWatchRequest, } from './protocol/schema.js';
-export { connectWorkflowWatch, waitForWorkflowStatus, workflowWatchWebSocketUrl } from './workflow-watch.js';
-export type { WorkflowWatchConnection, WorkflowWatchInput, WorkflowWatchResult } from './workflow-watch.js';
+export { BridgeHelloDataSchema, BridgePairDataSchema, DataInputSchema, DataListInputSchema, DataListResultSchema, DataPreviewInputSchema, DataPreviewResultSchema, DataGetInputSchema, DataGetResultSchema, DataExportInputSchema, DataExportResultSchema, DataDeleteResultSchema, UserMeInputSchema, UserMeResultSchema, ExtensionListResultSchema, WorkflowControlResultSchema, WorkflowStatusWatchResultSchema, ExtensionHelloInputSchema, ExtensionPairInputSchema, MessageEnvelopeSchema, SafeResultSchema, WorkflowControlInputSchema, WorkflowProcessStatusSchema, WorkflowProcessReasonSchema, WorkflowStatusEventSchema, WorkflowStatusInputSchema, WorkflowStatusResultSchema, WorkflowStatusDataSchema, WorkflowStartInputSchema, WorkflowStartResultSchema, WorkflowStatusWatchRequestSchema, WorkflowLogLevelSchema, WorkflowLogInputSchema, WorkflowLogsInputSchema, WorkflowLogDataSchema, WorkflowLogResultSchema, WorkflowLogsResultSchema, createEnvelope, parseEnvelope, } from './protocol/schema.js';
+export type { DataInput, WorkflowStatusInput, DataListInput, DataGetInput, DataExportResult, WorkflowControlInput, WorkflowStartInput, WorkflowStartResult, WorkflowStatusData, WorkflowStatusEvent, WorkflowStatusWatchRequest, WorkflowLogInput, WorkflowLogsInput, WorkflowLogData, WorkflowLogResult, WorkflowLogsResult, } from './protocol/schema.js';
+export { connectWorkflowStatusWatch, waitForWorkflowStatus, workflowStatusWatchWebSocketUrl } from './workflow-watch.js';
+export type { WorkflowStatusWatchConnection, WorkflowStatusWatchInput, WorkflowStatusWatchResult, } from './workflow-watch.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -3,6 +3,6 @@ export { BridgeService } from './bridge/bridge-service.js';
 export { ExtensionSession } from './bridge/extension-session.js';
 export { dispatchCommand, getCommandCapabilities, getCommandDefinition } from './commands.js';
 export { BridgeError, safeError, safeSuccess, serializeBridgeError } from './errors.js';
-export { BridgeHelloDataSchema, BridgePairDataSchema, DataInputSchema, ExtensionHelloInputSchema, ExtensionPairInputSchema, MessageEnvelopeSchema, SafeResultSchema, TabTargetSchema, WorkflowControlInputSchema, WorkflowLifecycleStateSchema, WorkflowStatusEventSchema, WorkflowStatusDataSchema, WorkflowStartInputSchema, WorkflowStartResultSchema, WorkflowWatchRequestSchema, createEnvelope, parseEnvelope, } from './protocol/schema.js';
-export { connectWorkflowWatch, waitForWorkflowStatus, workflowWatchWebSocketUrl } from './workflow-watch.js';
+export { BridgeHelloDataSchema, BridgePairDataSchema, DataInputSchema, DataListInputSchema, DataListResultSchema, DataPreviewInputSchema, DataPreviewResultSchema, DataGetInputSchema, DataGetResultSchema, DataExportInputSchema, DataExportResultSchema, DataDeleteResultSchema, UserMeInputSchema, UserMeResultSchema, ExtensionListResultSchema, WorkflowControlResultSchema, WorkflowStatusWatchResultSchema, ExtensionHelloInputSchema, ExtensionPairInputSchema, MessageEnvelopeSchema, SafeResultSchema, WorkflowControlInputSchema, WorkflowProcessStatusSchema, WorkflowProcessReasonSchema, WorkflowStatusEventSchema, WorkflowStatusInputSchema, WorkflowStatusResultSchema, WorkflowStatusDataSchema, WorkflowStartInputSchema, WorkflowStartResultSchema, WorkflowStatusWatchRequestSchema, WorkflowLogLevelSchema, WorkflowLogInputSchema, WorkflowLogsInputSchema, WorkflowLogDataSchema, WorkflowLogResultSchema, WorkflowLogsResultSchema, createEnvelope, parseEnvelope, } from './protocol/schema.js';
+export { connectWorkflowStatusWatch, waitForWorkflowStatus, workflowStatusWatchWebSocketUrl } from './workflow-watch.js';
 //# sourceMappingURL=index.js.map

package/dist/mcp.d.ts

@@ -1,13 +1,14 @@
 import { McpServer } from '@modelcontextprotocol/server';
 import type { BridgeService } from './bridge/bridge-service.js';
+import type { ExportStore } from './bridge/export-store.js';
 import type { WorkflowStatusEvent } from './protocol/schema.js';
-import type { WorkflowWatchInput, WorkflowWatchResult } from './workflow-watch.js';
+import type { WorkflowStatusWatchInput, WorkflowStatusWatchResult } from './workflow-watch.js';
 export type TapickerMcpApi = {
     executeCommand: (name: string, request: unknown) => Promise<unknown>;
     listExtensions: () => Promise<unknown[]>;
-    watchWorkflow: (input: WorkflowWatchInput, onStatus: (event: WorkflowStatusEvent) => void, signal?: AbortSignal) => Promise<WorkflowWatchResult>;
+    watchWorkflowStatus: (input: WorkflowStatusWatchInput, onStatus: (event: WorkflowStatusEvent) => void, signal?: AbortSignal) => Promise<WorkflowStatusWatchResult>;
 };
-export declare function createBridgeMcpApi(bridge: BridgeService): TapickerMcpApi;
+export declare function createBridgeMcpApi(bridge: BridgeService, exports?: ExportStore): TapickerMcpApi;
 export declare function createHttpMcpApi(baseUrl: string, token?: string): TapickerMcpApi;
 export declare function createTapickerMcpServer(api: TapickerMcpApi): McpServer;
 //# sourceMappingURL=mcp.d.ts.map