@wolpertingerlabs/drawlatch 1.0.0-alpha.3 → 1.0.0-alpha.35

package/dist/remote/tool-dispatch.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Canonical MCP tool implementations — the single source of truth.
+ *
+ * These handlers implement every proxy/management tool drawlatch exposes:
+ *   http_request, list_routes, poll_events, ingestor_status,
+ *   test_connection, test_ingestor, control_listener,
+ *   list_listener_configs, resolve_listener_options,
+ *   get/set_listener_params, list/delete_listener_instance,
+ *   list_connection_templates, set_connection_enabled,
+ *   set_secrets, get_secret_status.
+ *
+ * Consumed by:
+ *   - The remote secure server's `/request` dispatch (src/remote/server.ts)
+ *   - The password-gated admin API (src/remote/admin-mutations.ts)
+ *   - Any in-process host (e.g. callboard) that imports
+ *     `@wolpertingerlabs/drawlatch/remote/tool-dispatch` instead of
+ *     re-implementing a LocalProxy.
+ *
+ * Pure in the sense that handlers take `routes` + `context` as input rather
+ * than reading global session state. The only side effects are the outbound
+ * fetch() and config/.env writes (which mirror what the live daemon does).
+ */
+import { type ResolvedRoute } from '../shared/config.js';
+import type { IngestorManager } from './ingestors/index.js';
+export declare function isEndpointAllowed(url: string, patterns: string[]): boolean;
+/**
+ * Find the first route whose allowedEndpoints match the given URL.
+ * Routes with empty allowedEndpoints match nothing.
+ */
+export declare function matchRoute(url: string, routes: ResolvedRoute[]): ResolvedRoute | null;
+/** A file attachment transmitted as base64 data through the encrypted channel. */
+export interface FileAttachment {
+    /** Form field name (e.g., "files[0]", "file", "attachment") */
+    field: string;
+    /** Base64-encoded file content */
+    data: string;
+    /** Filename for the upload */
+    filename: string;
+    /** MIME type (e.g., "image/png", "application/pdf") */
+    contentType: string;
+}
+export interface ProxyRequestInput {
+    method: string;
+    url: string;
+    headers?: Record<string, string>;
+    body?: unknown;
+    /** File attachments — triggers multipart/form-data encoding */
+    files?: FileAttachment[];
+    /** Form field name for the JSON body part (default: "payload_json") */
+    bodyFieldName?: string;
+}
+export interface ProxyRequestResult {
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+    body: unknown;
+}
+/**
+ * Core proxy request execution — route matching, secret injection, and fetch.
+ *
+ * Pure in the sense that it takes routes as input rather than reading global
+ * state. The only side effect is the outbound fetch().
+ */
+export declare function executeProxyRequest(input: ProxyRequestInput, routes: ResolvedRoute[]): Promise<ProxyRequestResult>;
+/** Context passed to every tool handler, providing caller identity and shared services. */
+export interface ToolContext {
+    /** The caller alias for the session making this request. */
+    callerAlias: string;
+    /** The shared ingestor manager (for poll_events / ingestor_status). */
+    ingestorManager: IngestorManager;
+    /** Re-resolve routes for all sessions belonging to this caller.
+     *  Call after secrets or connection list changes. */
+    refreshRoutes: () => void;
+}
+export type ToolHandler = (input: Record<string, unknown>, routes: ResolvedRoute[], context: ToolContext) => Promise<unknown> | object;
+export declare const toolHandlers: Record<string, ToolHandler>;
+/**
+ * Dispatch a single tool call by name. Throws on unknown tool.
+ *
+ * The canonical entry point for in-process hosts (admin API, callboard) that
+ * want to invoke a tool without going through the encrypted `/request` path.
+ */
+export declare function dispatchTool(toolName: string, input: Record<string, unknown>, routes: ResolvedRoute[], context: ToolContext): Promise<unknown>;
+//# sourceMappingURL=tool-dispatch.d.ts.map