@on-mission/sdk 0.1.0

package/dist/sdk.js

@@ -0,0 +1,327 @@
+/**
+ * Mission SDK — Main Entry
+ *
+ * Creates the SDK instance that a plugin uses to interact with the
+ * Mission platform. Communication is HTTP-native:
+ *
+ *   Outbound (Plugin → Mission API):
+ *     Standard REST calls via the API client.
+ *
+ *   Inbound (Mission API → Plugin):
+ *     HTTP requests to the plugin's HTTP server, exposed via
+ *     Daytona Preview URLs.
+ *
+ * Lifecycle:
+ *   1. const mission = createMissionSDK()     — create SDK (no connection yet)
+ *   2. await mission.connect()                — start HTTP server, install logging
+ *   3. // auth, config, events are now usable
+ *   4. mission.tools.registerAll(handlers)    — register tool handlers
+ *   5. mission.ingress.on('name', handler)    — register ingress handlers
+ *   6. mission.onShutdown(() => cleanup())    — register shutdown hooks
+ *   7. await mission.ready()                  — signal readiness, accept traffic
+ *
+ * See docs/technical-designs/plugin-architecture.md §4 and §6.
+ * See docs/technical-designs/daytona-sandbox-runtime.md.
+ */
+import { createApiClient } from './api';
+import { createAuthModule } from './auth';
+import { createConfigModule } from './config';
+import { readContextFromEnv } from './context';
+import { createEventsModule } from './events';
+import { createHttpServer } from './http-server';
+import { createIngressRegistry } from './ingress';
+import { installLogging } from './logging';
+import { createToolRegistry } from './tool-registry';
+// ─── Factory ─────────────────────────────────────────────────────────────────
+/** Interval between keep-alive heartbeats (in ms). */
+const HEARTBEAT_INTERVAL_MS = 10 * 60 * 1000; // 10 minutes
+/** How often to check if the JWT needs refreshing (in ms). */
+const TOKEN_REFRESH_CHECK_MS = 5 * 60 * 1000; // 5 minutes
+/** Refresh the JWT when it has this much time left (in ms). */
+const TOKEN_REFRESH_BUFFER_MS = 15 * 60 * 1000; // 15 minutes before expiry
+/**
+ * Create a Mission SDK instance.
+ *
+ * @example
+ * ```ts
+ * import { createMissionSDK } from '@mission/sdk'
+ *
+ * const mission = createMissionSDK()
+ * await mission.connect()
+ *
+ * const auth = await mission.auth.get()
+ * const config = await mission.config.get<MyConfig>(defaults)
+ *
+ * mission.tools.registerAll(handlers)
+ * mission.ingress.on('webhook', handler)
+ * mission.onShutdown(() => cleanup())
+ *
+ * await mission.ready()
+ * ```
+ */
+export function createMissionSDK(options) {
+    const envContext = readContextFromEnv();
+    const context = {
+        ...envContext,
+        ...options?.context
+    };
+    // Port priority: explicit option > env var (in context) > 3000
+    const port = options?.port ?? context.pluginPort;
+    // Core modules
+    const api = createApiClient(context);
+    const httpServer = createHttpServer();
+    const toolRegistry = createToolRegistry();
+    const ingressRegistry = createIngressRegistry(api);
+    const shutdownHandlers = [];
+    let isShuttingDown = false;
+    let heartbeatTimer = null;
+    let tokenRefreshTimer = null;
+    let shutdownResolve = null;
+    // ─── Keep-alive heartbeat ───────────────────────────────────────────
+    function startHeartbeat() {
+        heartbeatTimer = setInterval(() => {
+            // Send heartbeat to Mission API.
+            // The API responds by pinging our HTTP server's /_mission/ping
+            // endpoint, which resets Daytona's auto-stop timer.
+            void api.trpc.plugin.heartbeat.mutate({}).catch((err) => {
+                console.error('[SDK] heartbeat failed:', err);
+            });
+        }, HEARTBEAT_INTERVAL_MS);
+        // Don't let the heartbeat timer prevent process exit
+        if (heartbeatTimer.unref) {
+            heartbeatTimer.unref();
+        }
+    }
+    function stopHeartbeat() {
+        if (heartbeatTimer) {
+            clearInterval(heartbeatTimer);
+            heartbeatTimer = null;
+        }
+    }
+    // ─── JWT token refresh ────────────────────────────────────────────
+    function getTokenExpiry() {
+        const token = api.getToken();
+        if (!token)
+            return null;
+        try {
+            const payload = JSON.parse(Buffer.from(token.split('.')[1], 'base64').toString());
+            return typeof payload.exp === 'number' ? payload.exp * 1000 : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    function startTokenRefresh() {
+        tokenRefreshTimer = setInterval(async () => {
+            const expiry = getTokenExpiry();
+            if (!expiry)
+                return;
+            const timeLeft = expiry - Date.now();
+            if (timeLeft > TOKEN_REFRESH_BUFFER_MS)
+                return;
+            try {
+                const result = await api.trpc.plugin.tokenRefresh.mutate({});
+                if (!result || typeof result !== 'object' || !('token' in result)) {
+                    throw new Error('Invalid token refresh response');
+                }
+                api.setToken(result.token);
+                console.error('[SDK] JWT refreshed successfully');
+            }
+            catch (err) {
+                console.error('[SDK] JWT refresh failed:', err);
+            }
+        }, TOKEN_REFRESH_CHECK_MS);
+        if (tokenRefreshTimer.unref) {
+            tokenRefreshTimer.unref();
+        }
+    }
+    function stopTokenRefresh() {
+        if (tokenRefreshTimer) {
+            clearInterval(tokenRefreshTimer);
+            tokenRefreshTimer = null;
+        }
+    }
+    // ─── Graceful shutdown ──────────────────────────────────────────────
+    async function handleShutdown() {
+        if (isShuttingDown)
+            return;
+        isShuttingDown = true;
+        console.error('[SDK] Shutdown signal received — running cleanup handlers');
+        // 1. Stop timers
+        stopHeartbeat();
+        stopTokenRefresh();
+        // 2. Run plugin shutdown handlers
+        for (const handler of shutdownHandlers) {
+            try {
+                await handler();
+            }
+            catch (err) {
+                console.error('[SDK] Shutdown handler error:', err);
+            }
+        }
+        // 3. Stop the HTTP server
+        try {
+            await httpServer.stop();
+        }
+        catch (err) {
+            console.error('[SDK] Error stopping HTTP server:', err);
+        }
+        console.error('[SDK] Shutdown complete');
+        // 4. Resolve the ready() promise so the process can exit
+        if (shutdownResolve) {
+            shutdownResolve();
+        }
+    }
+    // ─── Wire up HTTP server routes ─────────────────────────────────────
+    function installRoutes() {
+        // Health check
+        httpServer.route('GET', '/_mission/health', async () => {
+            return {
+                status: 200,
+                body: JSON.stringify({
+                    status: 'healthy',
+                    installationId: context.installationId,
+                    timestamp: new Date().toISOString()
+                })
+            };
+        });
+        // Keep-alive ping (Mission API calls this to reset Daytona auto-stop)
+        httpServer.route('GET', '/_mission/ping', async () => {
+            return {
+                status: 200,
+                body: JSON.stringify({ pong: true })
+            };
+        });
+        // Tool calls: POST /_mission/tools/:toolName
+        httpServer.route('POST', '/_mission/tools/:toolName', async (req) => {
+            const toolName = req.params.toolName;
+            let args = {};
+            if (req.body) {
+                try {
+                    args = JSON.parse(req.body);
+                }
+                catch {
+                    return {
+                        status: 400,
+                        body: JSON.stringify({ error: 'Invalid JSON body' })
+                    };
+                }
+            }
+            try {
+                const result = await toolRegistry.dispatch(toolName, args);
+                return {
+                    status: 200,
+                    body: JSON.stringify({ result })
+                };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                console.error(`[SDK] Tool call '${toolName}' failed:`, message);
+                return {
+                    status: err instanceof Error && err.message.startsWith('Unknown tool')
+                        ? 404
+                        : 500,
+                    body: JSON.stringify({ error: message })
+                };
+            }
+        });
+        // Ingress HTTP endpoints: POST /_ingress/:endpointName
+        // (also accepts GET for webhook verification flows like Slack challenge)
+        httpServer.route('POST', '/_ingress/:endpointName', async (req) => {
+            const endpointName = req.params.endpointName;
+            const ingressReq = {
+                method: req.method,
+                path: req.path,
+                headers: req.headers,
+                body: req.body,
+                query: req.query
+            };
+            const result = await ingressRegistry.dispatch(endpointName, ingressReq);
+            return {
+                status: result.status,
+                headers: result.headers,
+                body: result.body
+            };
+        });
+        httpServer.route('GET', '/_ingress/:endpointName', async (req) => {
+            const endpointName = req.params.endpointName;
+            const ingressReq = {
+                method: req.method,
+                path: req.path,
+                headers: req.headers,
+                body: req.body,
+                query: req.query
+            };
+            const result = await ingressRegistry.dispatch(endpointName, ingressReq);
+            return {
+                status: result.status,
+                headers: result.headers,
+                body: result.body
+            };
+        });
+    }
+    // ─── SDK instance ───────────────────────────────────────────────────
+    const sdk = {
+        context,
+        auth: createAuthModule(api),
+        config: createConfigModule(api),
+        events: createEventsModule(api),
+        ingress: ingressRegistry,
+        tools: toolRegistry,
+        connect: async () => {
+            // 1. Install console override for structured logging
+            installLogging(api);
+            // 2. Install HTTP routes
+            installRoutes();
+            // 3. Start the HTTP server
+            await httpServer.start(port);
+            // 4. Start keep-alive heartbeat
+            startHeartbeat();
+            // 5. Start JWT token refresh timer
+            startTokenRefresh();
+            console.error(`[SDK] Connected — HTTP server on port ${port}, auth/config/events available`);
+        },
+        ready: async () => {
+            // 1. Signal to the Mission API that we're ready for traffic
+            const toolNames = toolRegistry.getToolNames();
+            const ingressEndpoints = ingressRegistry.getHttpEndpointNames();
+            const streamEndpoints = ingressRegistry.getStreamEndpointNames();
+            await api.trpc.plugin.ready.mutate({
+                tools: toolNames,
+                ingress: ingressEndpoints,
+                streams: streamEndpoints,
+                port
+            });
+            console.error(`[SDK] Ready — ${toolNames.length} tools: ${toolNames.join(', ')}`);
+            if (ingressEndpoints.length > 0) {
+                console.error(`[SDK] Ingress endpoints: ${ingressEndpoints.join(', ')}`);
+            }
+            if (streamEndpoints.length > 0) {
+                console.error(`[SDK] Stream endpoints: ${streamEndpoints.join(', ')}`);
+            }
+            // 2. Install signal handlers for graceful shutdown
+            process.on('SIGTERM', () => {
+                handleShutdown().catch(err => {
+                    console.error('[SDK] Fatal shutdown error:', err);
+                    process.exit(1);
+                });
+            });
+            process.on('SIGINT', () => {
+                handleShutdown().catch(err => {
+                    console.error('[SDK] Fatal shutdown error:', err);
+                    process.exit(1);
+                });
+            });
+            console.error('[SDK] Accepting traffic — plugin is live');
+            // 3. Keep alive until shutdown signal
+            await new Promise(resolve => {
+                shutdownResolve = resolve;
+            });
+        },
+        onShutdown: (handler) => {
+            shutdownHandlers.push(handler);
+        }
+    };
+    return sdk;
+}
+//# sourceMappingURL=sdk.js.map

package/dist/sdk.js.map

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

package/dist/tool-registry.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Tool Registry
+ *
+ * Plugins register their tool handlers here. When the Gateway sends
+ * a "tools.call" command, the registry dispatches to the right handler.
+ *
+ * Usage:
+ *   mission.tools.register('gmail_search', async (params) => { ... })
+ *   mission.tools.registerAll(handlers)
+ */
+/**
+ * A tool handler function. Receives validated params, returns a result.
+ * The SDK handles wrapping the result in the gateway response protocol.
+ */
+export type ToolHandler = (params: Record<string, unknown>) => Promise<unknown>;
+export type ToolsModule = {
+    /** Register a single tool handler by name. */
+    register: (name: string, handler: ToolHandler) => void;
+    /** Register multiple tool handlers at once. */
+    registerAll: (handlers: Record<string, ToolHandler>) => void;
+};
+export type ToolRegistry = ToolsModule & {
+    /** Dispatch a tool call to the registered handler. */
+    dispatch: (name: string, params: Record<string, unknown>) => Promise<unknown>;
+    /** Get the list of registered tool names. */
+    getToolNames: () => string[];
+};
+export declare function createToolRegistry(): ToolRegistry;
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../src/tool-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AAE/E,MAAM,MAAM,WAAW,GAAG;IACxB,8CAA8C;IAC9C,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,KAAK,IAAI,CAAA;IACtD,+CAA+C;IAC/C,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,KAAK,IAAI,CAAA;CAC7D,CAAA;AAID,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG;IACvC,sDAAsD;IACtD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC7E,6CAA6C;IAC7C,YAAY,EAAE,MAAM,MAAM,EAAE,CAAA;CAC7B,CAAA;AAED,wBAAgB,kBAAkB,IAAI,YAAY,CAgCjD"}

package/dist/tool-registry.js

@@ -0,0 +1,37 @@
+/**
+ * Tool Registry
+ *
+ * Plugins register their tool handlers here. When the Gateway sends
+ * a "tools.call" command, the registry dispatches to the right handler.
+ *
+ * Usage:
+ *   mission.tools.register('gmail_search', async (params) => { ... })
+ *   mission.tools.registerAll(handlers)
+ */
+export function createToolRegistry() {
+    const handlers = new Map();
+    return {
+        register(name, handler) {
+            if (handlers.has(name)) {
+                console.error(`[Tools] Warning: overwriting handler for '${name}'`);
+            }
+            handlers.set(name, handler);
+        },
+        registerAll(map) {
+            for (const [name, handler] of Object.entries(map)) {
+                handlers.set(name, handler);
+            }
+        },
+        async dispatch(name, params) {
+            const handler = handlers.get(name);
+            if (!handler) {
+                throw new Error(`Unknown tool: ${name}`);
+            }
+            return handler(params);
+        },
+        getToolNames() {
+            return Array.from(handlers.keys());
+        }
+    };
+}
+//# sourceMappingURL=tool-registry.js.map

package/dist/tool-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.js","sourceRoot":"","sources":["../src/tool-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAwBH,MAAM,UAAU,kBAAkB;IAChC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAA;IAE/C,OAAO;QACL,QAAQ,CAAC,IAAY,EAAE,OAAoB;YACzC,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvB,OAAO,CAAC,KAAK,CAAC,6CAA6C,IAAI,GAAG,CAAC,CAAA;YACrE,CAAC;YACD,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QAC7B,CAAC;QAED,WAAW,CAAC,GAAgC;YAC1C,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClD,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YAC7B,CAAC;QACH,CAAC;QAED,KAAK,CAAC,QAAQ,CACZ,IAAY,EACZ,MAA+B;YAE/B,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YAClC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAA;YAC1C,CAAC;YACD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAA;QACxB,CAAC;QAED,YAAY;YACV,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;QACpC,CAAC;KACF,CAAA;AACH,CAAC"}