skedyul 0.1.26 → 0.1.28

package/dist/server.js

@@ -401,6 +401,110 @@ function getListeningPort(config) {
     }
     return config.defaultPort ?? 3000;
 }
+/**
+ * Prints a styled startup log showing server configuration
+ */
+function printStartupLog(config, tools, webhookRegistry, port) {
+    const webhookCount = webhookRegistry ? Object.keys(webhookRegistry).length : 0;
+    const webhookNames = webhookRegistry ? Object.keys(webhookRegistry) : [];
+    const maxRequests = config.maxRequests ??
+        parseNumberEnv(process.env.MCP_MAX_REQUESTS) ??
+        null;
+    const ttlExtendSeconds = config.ttlExtendSeconds ??
+        parseNumberEnv(process.env.MCP_TTL_EXTEND) ??
+        3600;
+    const executableId = process.env.SKEDYUL_EXECUTABLE_ID || 'local';
+    const divider = '═'.repeat(70);
+    const thinDivider = '─'.repeat(70);
+    // eslint-disable-next-line no-console
+    console.log('');
+    // eslint-disable-next-line no-console
+    console.log(`╔${divider}╗`);
+    // eslint-disable-next-line no-console
+    console.log(`║  🚀 Skedyul MCP Server Starting                                      ║`);
+    // eslint-disable-next-line no-console
+    console.log(`╠${divider}╣`);
+    // eslint-disable-next-line no-console
+    console.log(`║                                                                      ║`);
+    // eslint-disable-next-line no-console
+    console.log(`║  📦 Server:       ${padEnd(config.metadata.name, 49)}║`);
+    // eslint-disable-next-line no-console
+    console.log(`║  🏷️  Version:      ${padEnd(config.metadata.version, 49)}║`);
+    // eslint-disable-next-line no-console
+    console.log(`║  ⚡ Compute:      ${padEnd(config.computeLayer, 49)}║`);
+    if (port) {
+        // eslint-disable-next-line no-console
+        console.log(`║  🌐 Port:         ${padEnd(String(port), 49)}║`);
+    }
+    // eslint-disable-next-line no-console
+    console.log(`║  🔑 Executable:   ${padEnd(executableId, 49)}║`);
+    // eslint-disable-next-line no-console
+    console.log(`║                                                                      ║`);
+    // eslint-disable-next-line no-console
+    console.log(`╟${thinDivider}╢`);
+    // eslint-disable-next-line no-console
+    console.log(`║                                                                      ║`);
+    // eslint-disable-next-line no-console
+    console.log(`║  🔧 Tools (${tools.length}):                                                       ║`);
+    // List tools (max 10, then show "and X more...")
+    const maxToolsToShow = 10;
+    const toolsToShow = tools.slice(0, maxToolsToShow);
+    for (const tool of toolsToShow) {
+        // eslint-disable-next-line no-console
+        console.log(`║     • ${padEnd(tool.name, 61)}║`);
+    }
+    if (tools.length > maxToolsToShow) {
+        // eslint-disable-next-line no-console
+        console.log(`║     ... and ${tools.length - maxToolsToShow} more                                              ║`);
+    }
+    if (webhookCount > 0) {
+        // eslint-disable-next-line no-console
+        console.log(`║                                                                      ║`);
+        // eslint-disable-next-line no-console
+        console.log(`║  🪝 Webhooks (${webhookCount}):                                                     ║`);
+        const maxWebhooksToShow = 5;
+        const webhooksToShow = webhookNames.slice(0, maxWebhooksToShow);
+        for (const name of webhooksToShow) {
+            // eslint-disable-next-line no-console
+            console.log(`║     • /webhooks/${padEnd(name, 51)}║`);
+        }
+        if (webhookCount > maxWebhooksToShow) {
+            // eslint-disable-next-line no-console
+            console.log(`║     ... and ${webhookCount - maxWebhooksToShow} more                                              ║`);
+        }
+    }
+    // eslint-disable-next-line no-console
+    console.log(`║                                                                      ║`);
+    // eslint-disable-next-line no-console
+    console.log(`╟${thinDivider}╢`);
+    // eslint-disable-next-line no-console
+    console.log(`║                                                                      ║`);
+    // eslint-disable-next-line no-console
+    console.log(`║  ⚙️  Configuration:                                                   ║`);
+    // eslint-disable-next-line no-console
+    console.log(`║     Max Requests:    ${padEnd(maxRequests !== null ? String(maxRequests) : 'unlimited', 46)}║`);
+    // eslint-disable-next-line no-console
+    console.log(`║     TTL Extend:      ${padEnd(`${ttlExtendSeconds}s`, 46)}║`);
+    // eslint-disable-next-line no-console
+    console.log(`║                                                                      ║`);
+    // eslint-disable-next-line no-console
+    console.log(`╟${thinDivider}╢`);
+    // eslint-disable-next-line no-console
+    console.log(`║  ✅ Ready at ${padEnd(new Date().toISOString(), 55)}║`);
+    // eslint-disable-next-line no-console
+    console.log(`╚${divider}╝`);
+    // eslint-disable-next-line no-console
+    console.log('');
+}
+/**
+ * Pad a string to the right with spaces
+ */
+function padEnd(str, length) {
+    if (str.length >= length) {
+        return str.slice(0, length);
+    }
+    return str + ' '.repeat(length - str.length);
+}
 function createSkedyulServer(config, registry, webhookRegistry) {
     mergeRuntimeEnv();
     if (config.coreApi?.service) {
@@ -678,15 +782,32 @@ function createDedicatedServerInstance(config, tools, callTool, state, mcpServer
                 return;
             }
             if (pathname === '/mcp' && req.method === 'POST') {
-                const transport = new streamableHttp_js_1.StreamableHTTPServerTransport({
-                    sessionIdGenerator: undefined,
-                    enableJsonResponse: true,
-                });
-                res.on('close', () => {
-                    transport.close();
-                });
                 try {
                     const body = await parseJSONBody(req);
+                    // Handle webhooks/list before passing to MCP SDK transport
+                    if (body?.method === 'webhooks/list') {
+                        const webhooks = webhookRegistry
+                            ? Object.values(webhookRegistry).map((w) => ({
+                                name: w.name,
+                                description: w.description,
+                                methods: w.methods ?? ['POST'],
+                            }))
+                            : [];
+                        sendJSON(res, 200, {
+                            jsonrpc: '2.0',
+                            id: body.id ?? null,
+                            result: { webhooks },
+                        });
+                        return;
+                    }
+                    // Pass to MCP SDK transport for standard MCP methods
+                    const transport = new streamableHttp_js_1.StreamableHTTPServerTransport({
+                        sessionIdGenerator: undefined,
+                        enableJsonResponse: true,
+                    });
+                    res.on('close', () => {
+                        transport.close();
+                    });
                     await mcpServer.connect(transport);
                     await transport.handleRequest(req, res, body);
                 }
@@ -727,12 +848,7 @@ function createDedicatedServerInstance(config, tools, callTool, state, mcpServer
             const finalPort = listenPort ?? port;
             return new Promise((resolve, reject) => {
                 httpServer.listen(finalPort, () => {
-                    // eslint-disable-next-line no-console
-                    console.log(`MCP Server running on port ${finalPort}`);
-                    // eslint-disable-next-line no-console
-                    console.log(`Registry loaded with ${tools.length} tools: ${tools
-                        .map((tool) => tool.name)
-                        .join(', ')}`);
+                    printStartupLog(config, tools, webhookRegistry, finalPort);
                     resolve();
                 });
                 httpServer.once('error', reject);
@@ -743,8 +859,15 @@ function createDedicatedServerInstance(config, tools, callTool, state, mcpServer
 }
 function createServerlessInstance(config, tools, callTool, state, mcpServer, registry, webhookRegistry) {
     const headers = getDefaultHeaders(config.cors);
+    // Print startup log once on cold start
+    let hasLoggedStartup = false;
     return {
         async handler(event) {
+            // Log startup info on first invocation (cold start)
+            if (!hasLoggedStartup) {
+                printStartupLog(config, tools, webhookRegistry);
+                hasLoggedStartup = true;
+            }
             try {
                 const path = event.path;
                 const method = event.httpMethod;
@@ -1039,6 +1162,17 @@ function createServerlessInstance(config, tools, callTool, state, mcpServer, reg
                                 }, headers);
                             }
                         }
+                        else if (rpcMethod === 'webhooks/list') {
+                            // Return registered webhooks with their metadata
+                            const webhooks = webhookRegistry
+                                ? Object.values(webhookRegistry).map((w) => ({
+                                    name: w.name,
+                                    description: w.description,
+                                    methods: w.methods ?? ['POST'],
+                                }))
+                                : [];
+                            result = { webhooks };
+                        }
                         else {
                             return createResponse(200, {
                                 jsonrpc: '2.0',

package/dist/types.d.ts

@@ -132,12 +132,56 @@ export interface WebhookContext {
     env: Record<string, string | undefined>;
 }
 export type WebhookHandler = (request: WebhookRequest, context: WebhookContext) => Promise<WebhookResponse> | WebhookResponse;
+export interface WebhookLifecycleContext {
+    /** The Skedyul-generated webhook URL for this webhook */
+    webhookUrl: string;
+    /** Environment variables available during lifecycle operation */
+    env: Record<string, string | undefined>;
+}
+export interface CommunicationChannelLifecycleContext extends WebhookLifecycleContext {
+    /** The communication channel being configured */
+    communicationChannel: {
+        id: string;
+        /** The identifier value (e.g., phone number like "+15551234567") */
+        identifierValue: string;
+        /** The channel handle (e.g., "sms") */
+        handle: string;
+    };
+}
+export interface WebhookLifecycleResult {
+    /** External ID from the provider (e.g., Twilio phone number SID) */
+    externalId: string;
+    /** Optional message describing what was configured */
+    message?: string;
+    /** Optional metadata from the provider */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Lifecycle hook for webhook operations.
+ * Return null if the API doesn't support programmatic management
+ * (user must configure manually).
+ */
+export type WebhookLifecycleHook<TContext = WebhookLifecycleContext> = (context: TContext) => Promise<WebhookLifecycleResult | null> | WebhookLifecycleResult | null;
 export interface WebhookDefinition {
     name: string;
     description: string;
     /** HTTP methods this webhook accepts. Defaults to ['POST'] */
     methods?: ('GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH')[];
     handler: WebhookHandler;
+    /** Called when the app is installed to a workplace. Return null if manual setup required. */
+    onAppInstalled?: WebhookLifecycleHook;
+    /** Called when the app is uninstalled from a workplace. Return null if manual cleanup required. */
+    onAppUninstalled?: WebhookLifecycleHook;
+    /** Called when a new app version is provisioned. Return null if manual setup required. */
+    onAppVersionProvisioned?: WebhookLifecycleHook;
+    /** Called when an app version is deprovisioned. Return null if manual cleanup required. */
+    onAppVersionDeprovisioned?: WebhookLifecycleHook;
+    /** Called when a communication channel is created. Return null if manual setup required. */
+    onCommunicationChannelCreated?: WebhookLifecycleHook<CommunicationChannelLifecycleContext>;
+    /** Called when a communication channel is updated. Return null if manual update required. */
+    onCommunicationChannelUpdated?: WebhookLifecycleHook<CommunicationChannelLifecycleContext>;
+    /** Called when a communication channel is deleted. Return null if manual cleanup required. */
+    onCommunicationChannelDeleted?: WebhookLifecycleHook<CommunicationChannelLifecycleContext>;
 }
 export type WebhookRegistry = Record<string, WebhookDefinition>;
 export type WebhookName<T extends WebhookRegistry> = Extract<keyof T, string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skedyul",
-  "version": "0.1.26",
+  "version": "0.1.28",
   "description": "The Skedyul SDK for Node.js",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",