skedyul 0.3.4 → 0.3.6

package/dist/.build-stamp

@@ -1 +1 @@
-1771566817944
+1771568589599

package/dist/cli/commands/invoke.js

@@ -38,6 +38,7 @@ const z = __importStar(require("zod"));
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const utils_1 = require("../utils");
+const logger_1 = require("../../server/logger");
 const auth_1 = require("../utils/auth");
 const link_1 = require("../utils/link");
 const config_1 = require("../utils/config");
@@ -278,6 +279,7 @@ async function invokeCommand(args) {
             request: { url: 'cli://invoke', params: {}, query: {} },
             env,
             mode: estimateMode ? 'estimate' : 'execute',
+            log: (0, logger_1.createContextLogger)(),
         };
     }
     else {
@@ -290,6 +292,7 @@ async function invokeCommand(args) {
             request: { url: 'cli://invoke', params: {}, query: {} },
             env,
             mode: estimateMode ? 'estimate' : 'execute',
+            log: (0, logger_1.createContextLogger)(),
         };
     }
     // Execute tool

package/dist/config/types/webhook.d.ts

@@ -1,3 +1,4 @@
+import type { ContextLogger } from '../../server/logger';
 export type WebhookHttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
 export interface WebhookRequest {
     method: string;
@@ -15,6 +16,8 @@ export interface WebhookHandlerContext {
         subdomain: string | null;
     } | null;
     registration: Record<string, unknown>;
+    /** Context-aware logger that automatically includes invocation context */
+    log: ContextLogger;
 }
 export interface WebhookHandlerResponse {
     status: number;

package/dist/index.d.ts

@@ -9,6 +9,8 @@ export type { InstallErrorCode } from './errors';
 export { z };
 export { workplace, communicationChannel, instance, token, file, webhook, resource, contactAssociationLink, configure, getConfig, runWithConfig, } from './core/client';
 export type { InstanceContext, InstanceData, InstanceMeta, InstancePagination, InstanceListResult, InstanceListArgs, FileUrlResponse, FileUploadParams, FileUploadResult, WebhookCreateResult, WebhookListItem, WebhookDeleteByNameOptions, WebhookListOptions, ResourceLinkParams, ResourceLinkResult, ContactAssociationLinkCreateParams, ContactAssociationLinkCreateResult, } from './core/client';
+export { createContextLogger } from './server/logger';
+export type { ContextLogger } from './server/logger';
 declare const _default: {
     z: typeof z;
 };

package/dist/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getRequiredInstallEnvKeys = exports.getAllEnvKeys = exports.CONFIG_FILE_NAMES = exports.validateConfig = exports.loadConfig = exports.defineConfig = exports.runWithConfig = exports.getConfig = exports.configure = exports.contactAssociationLink = exports.resource = exports.webhook = exports.file = exports.token = exports.instance = exports.communicationChannel = exports.workplace = exports.z = exports.AppAuthInvalidError = exports.ConnectionError = exports.InvalidConfigurationError = exports.AuthenticationError = exports.MissingRequiredFieldError = exports.InstallError = exports.DEFAULT_DOCKERFILE = exports.server = exports.ToolResponseMetaSchema = void 0;
+exports.getRequiredInstallEnvKeys = exports.getAllEnvKeys = exports.CONFIG_FILE_NAMES = exports.validateConfig = exports.loadConfig = exports.defineConfig = exports.createContextLogger = exports.runWithConfig = exports.getConfig = exports.configure = exports.contactAssociationLink = exports.resource = exports.webhook = exports.file = exports.token = exports.instance = exports.communicationChannel = exports.workplace = exports.z = exports.AppAuthInvalidError = exports.ConnectionError = exports.InvalidConfigurationError = exports.AuthenticationError = exports.MissingRequiredFieldError = exports.InstallError = exports.DEFAULT_DOCKERFILE = exports.server = exports.ToolResponseMetaSchema = void 0;
 const v4_1 = require("zod/v4");
 Object.defineProperty(exports, "z", { enumerable: true, get: function () { return v4_1.z; } });
 __exportStar(require("./types"), exports);
@@ -45,6 +45,9 @@ Object.defineProperty(exports, "contactAssociationLink", { enumerable: true, get
 Object.defineProperty(exports, "configure", { enumerable: true, get: function () { return client_1.configure; } });
 Object.defineProperty(exports, "getConfig", { enumerable: true, get: function () { return client_1.getConfig; } });
 Object.defineProperty(exports, "runWithConfig", { enumerable: true, get: function () { return client_1.runWithConfig; } });
+// Context-aware logger
+var logger_1 = require("./server/logger");
+Object.defineProperty(exports, "createContextLogger", { enumerable: true, get: function () { return logger_1.createContextLogger; } });
 // Default export for ESM compatibility when importing from CJS
 exports.default = { z: v4_1.z };
 var config_1 = require("./config");

package/dist/server/dedicated.js

@@ -13,6 +13,7 @@ const core_api_handler_1 = require("./core-api-handler");
 const handler_helpers_1 = require("./handler-helpers");
 const startup_logger_1 = require("./startup-logger");
 const context_logger_1 = require("./context-logger");
+const logger_1 = require("./logger");
 const utils_1 = require("./utils");
 /**
  * Creates a dedicated (long-running HTTP) server instance
@@ -94,6 +95,7 @@ function createDedicatedServerInstance(config, tools, callTool, state, mcpServer
                             workplace: context.workplace,
                             registration: context.registration ?? {},
                             invocation,
+                            log: (0, logger_1.createContextLogger)(),
                         };
                     }
                     else {
@@ -102,6 +104,7 @@ function createDedicatedServerInstance(config, tools, callTool, state, mcpServer
                             env: envVars,
                             app,
                             invocation,
+                            log: (0, logger_1.createContextLogger)(),
                         };
                     }
                 }
@@ -125,6 +128,7 @@ function createDedicatedServerInstance(config, tools, callTool, state, mcpServer
                     webhookContext = {
                         env: process.env,
                         app: { id: appId, versionId: appVersionId },
+                        log: (0, logger_1.createContextLogger)(),
                     };
                 }
                 // Temporarily inject env into process.env for skedyul client to use
@@ -243,6 +247,7 @@ function createDedicatedServerInstance(config, tools, callTool, state, mcpServer
                 const oauthCallbackContext = {
                     request: oauthRequest,
                     invocation,
+                    log: (0, logger_1.createContextLogger)(),
                 };
                 try {
                     const oauthCallbackHook = config.hooks.oauth_callback;
@@ -298,6 +303,7 @@ function createDedicatedServerInstance(config, tools, callTool, state, mcpServer
                     appInstallationId: installBody.context.appInstallationId,
                     app: installBody.context.app,
                     invocation: installBody.invocation,
+                    log: (0, logger_1.createContextLogger)(),
                 };
                 // Build request-scoped config for SDK access
                 // Use env from request body (contains generated token from workflow)
@@ -379,6 +385,7 @@ function createDedicatedServerInstance(config, tools, callTool, state, mcpServer
                     appInstallationId: uninstallBody.context.appInstallationId,
                     app: uninstallBody.context.app,
                     invocation: uninstallBody.invocation,
+                    log: (0, logger_1.createContextLogger)(),
                 };
                 const uninstallRequestConfig = {
                     baseUrl: uninstallBody.env?.SKEDYUL_API_URL ??
@@ -447,6 +454,7 @@ function createDedicatedServerInstance(config, tools, callTool, state, mcpServer
                     env: mergedEnv,
                     app: provisionBody.context.app,
                     invocation: provisionBody.invocation,
+                    log: (0, logger_1.createContextLogger)(),
                 };
                 // Build request-scoped config for SDK access
                 // Use merged env for consistency

package/dist/server/logger.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Context-Aware Logger
+ * ====================
+ *
+ * Provides a logger interface that can be attached to handler contexts.
+ * The logger wraps console methods, and since console.log is patched by
+ * context-logger.ts to inject invocation context from AsyncLocalStorage,
+ * all logs automatically include the context.
+ *
+ * Usage:
+ *   context.log('Starting operation...')
+ *   context.log.info('Info message')
+ *   context.log.error('Error occurred', error)
+ */
+export interface ContextLogger {
+    (message: string, ...args: unknown[]): void;
+    info: (message: string, ...args: unknown[]) => void;
+    warn: (message: string, ...args: unknown[]) => void;
+    error: (message: string, ...args: unknown[]) => void;
+    debug: (message: string, ...args: unknown[]) => void;
+}
+/**
+ * Creates a context logger instance.
+ * The logger simply wraps console methods - the AsyncLocalStorage patch
+ * in context-logger.ts handles injecting the invocation context automatically.
+ */
+export declare function createContextLogger(): ContextLogger;

package/dist/server/logger.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * Context-Aware Logger
+ * ====================
+ *
+ * Provides a logger interface that can be attached to handler contexts.
+ * The logger wraps console methods, and since console.log is patched by
+ * context-logger.ts to inject invocation context from AsyncLocalStorage,
+ * all logs automatically include the context.
+ *
+ * Usage:
+ *   context.log('Starting operation...')
+ *   context.log.info('Info message')
+ *   context.log.error('Error occurred', error)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createContextLogger = createContextLogger;
+/**
+ * Creates a context logger instance.
+ * The logger simply wraps console methods - the AsyncLocalStorage patch
+ * in context-logger.ts handles injecting the invocation context automatically.
+ */
+function createContextLogger() {
+    const log = ((msg, ...args) => {
+        console.log(msg, ...args);
+    });
+    log.info = (msg, ...args) => {
+        console.info(msg, ...args);
+    };
+    log.warn = (msg, ...args) => {
+        console.warn(msg, ...args);
+    };
+    log.error = (msg, ...args) => {
+        console.error(msg, ...args);
+    };
+    log.debug = (msg, ...args) => {
+        console.debug(msg, ...args);
+    };
+    return log;
+}

package/dist/server/serverless.js

@@ -8,6 +8,7 @@ const core_api_handler_1 = require("./core-api-handler");
 const handler_helpers_1 = require("./handler-helpers");
 const startup_logger_1 = require("./startup-logger");
 const context_logger_1 = require("./context-logger");
+const logger_1 = require("./logger");
 const utils_1 = require("./utils");
 /**
  * Creates a serverless (Lambda-style) server instance
@@ -105,6 +106,7 @@ function createServerlessInstance(config, tools, callTool, state, mcpServer, reg
                                 workplace: envelope.context.workplace,
                                 registration: envelope.context.registration ?? {},
                                 invocation,
+                                log: (0, logger_1.createContextLogger)(),
                             };
                         }
                         else {
@@ -113,6 +115,7 @@ function createServerlessInstance(config, tools, callTool, state, mcpServer, reg
                                 env: envVars,
                                 app,
                                 invocation,
+                                log: (0, logger_1.createContextLogger)(),
                             };
                         }
                     }
@@ -144,6 +147,7 @@ function createServerlessInstance(config, tools, callTool, state, mcpServer, reg
                         webhookContext = {
                             env: process.env,
                             app: { id: appId, versionId: appVersionId },
+                            log: (0, logger_1.createContextLogger)(),
                         };
                     }
                     // Temporarily inject env into process.env for skedyul client to use
@@ -316,6 +320,7 @@ function createServerlessInstance(config, tools, callTool, state, mcpServer, reg
                         appInstallationId: installBody.context.appInstallationId,
                         app: installBody.context.app,
                         invocation: installBody.invocation,
+                        log: (0, logger_1.createContextLogger)(),
                     };
                     // Build request-scoped config for SDK access
                     // Use env from request body (contains generated token from workflow)
@@ -386,6 +391,7 @@ function createServerlessInstance(config, tools, callTool, state, mcpServer, reg
                         appInstallationId: uninstallBody.context.appInstallationId,
                         app: uninstallBody.context.app,
                         invocation: uninstallBody.invocation,
+                        log: (0, logger_1.createContextLogger)(),
                     };
                     const uninstallRequestConfig = {
                         baseUrl: uninstallBody.env?.SKEDYUL_API_URL ??
@@ -442,6 +448,7 @@ function createServerlessInstance(config, tools, callTool, state, mcpServer, reg
                     const oauthCallbackContext = {
                         request: oauthRequest,
                         invocation,
+                        log: (0, logger_1.createContextLogger)(),
                     };
                     try {
                         const oauthCallbackHook = config.hooks.oauth_callback;

package/dist/server/tool-handler.js

@@ -7,6 +7,7 @@ const utils_1 = require("./utils");
 const client_1 = require("../core/client");
 const errors_1 = require("../errors");
 const context_logger_1 = require("./context-logger");
+const logger_1 = require("./logger");
 /**
  * Builds tool metadata array from a tool registry
  */
@@ -89,6 +90,8 @@ function createCallToolHandler(registry, state, onMaxRequests) {
             const trigger = rawContext.trigger || 'agent';
             // Build execution context based on trigger type
             let executionContext;
+            // Create context-aware logger
+            const log = (0, logger_1.createContextLogger)();
             if (trigger === 'provision') {
                 // Provision context - no installation, no workplace
                 executionContext = {
@@ -97,6 +100,7 @@ function createCallToolHandler(registry, state, onMaxRequests) {
                     env: process.env,
                     mode: estimateMode ? 'estimate' : 'execute',
                     invocation,
+                    log,
                 };
             }
             else {
@@ -108,26 +112,26 @@ function createCallToolHandler(registry, state, onMaxRequests) {
                 const modeValue = estimateMode ? 'estimate' : 'execute';
                 if (trigger === 'field_change') {
                     const field = rawContext.field;
-                    executionContext = { trigger: 'field_change', app, appInstallationId, workplace, request, env: envVars, mode: modeValue, field, invocation };
+                    executionContext = { trigger: 'field_change', app, appInstallationId, workplace, request, env: envVars, mode: modeValue, field, invocation, log };
                 }
                 else if (trigger === 'page_action') {
                     const page = rawContext.page;
-                    executionContext = { trigger: 'page_action', app, appInstallationId, workplace, request, env: envVars, mode: modeValue, page, invocation };
+                    executionContext = { trigger: 'page_action', app, appInstallationId, workplace, request, env: envVars, mode: modeValue, page, invocation, log };
                 }
                 else if (trigger === 'form_submit') {
                     const form = rawContext.form;
-                    executionContext = { trigger: 'form_submit', app, appInstallationId, workplace, request, env: envVars, mode: modeValue, form, invocation };
+                    executionContext = { trigger: 'form_submit', app, appInstallationId, workplace, request, env: envVars, mode: modeValue, form, invocation, log };
                 }
                 else if (trigger === 'workflow') {
-                    executionContext = { trigger: 'workflow', app, appInstallationId, workplace, request, env: envVars, mode: modeValue, invocation };
+                    executionContext = { trigger: 'workflow', app, appInstallationId, workplace, request, env: envVars, mode: modeValue, invocation, log };
                 }
                 else if (trigger === 'page_context') {
                     // Page context trigger - similar to agent but for page context resolution
-                    executionContext = { trigger: 'agent', app, appInstallationId, workplace, request, env: envVars, mode: modeValue, invocation };
+                    executionContext = { trigger: 'agent', app, appInstallationId, workplace, request, env: envVars, mode: modeValue, invocation, log };
                 }
                 else {
                     // Default to agent
-                    executionContext = { trigger: 'agent', app, appInstallationId, workplace, request, env: envVars, mode: modeValue, invocation };
+                    executionContext = { trigger: 'agent', app, appInstallationId, workplace, request, env: envVars, mode: modeValue, invocation, log };
                 }
             }
             // Build request-scoped config from env passed in MCP call

package/dist/types/handlers.d.ts

@@ -1,5 +1,6 @@
 import type { WebhookRequest } from './webhook';
 import type { InvocationContext } from './invocation';
+import type { ContextLogger } from '../server/logger';
 export interface InstallHandlerContext {
     env: Record<string, string>;
     workplace: {
@@ -15,6 +16,8 @@ export interface InstallHandlerContext {
     };
     /** Invocation context for log traceability */
     invocation?: InvocationContext;
+    /** Context-aware logger that automatically includes invocation context */
+    log: ContextLogger;
 }
 export interface InstallHandlerResponseOAuth {
     env?: Record<string, string>;
@@ -44,6 +47,8 @@ export interface UninstallHandlerContext {
     };
     /** Invocation context for log traceability */
     invocation?: InvocationContext;
+    /** Context-aware logger that automatically includes invocation context */
+    log: ContextLogger;
 }
 export interface UninstallHandlerResult {
     cleanedWebhookIds?: string[];
@@ -54,6 +59,8 @@ export interface OAuthCallbackContext {
     request: WebhookRequest;
     /** Invocation context for log traceability */
     invocation?: InvocationContext;
+    /** Context-aware logger that automatically includes invocation context */
+    log: ContextLogger;
 }
 export interface OAuthCallbackResult {
     env?: Record<string, string>;
@@ -68,6 +75,8 @@ export interface ProvisionHandlerContext {
     };
     /** Invocation context for log traceability */
     invocation?: InvocationContext;
+    /** Context-aware logger that automatically includes invocation context */
+    log: ContextLogger;
 }
 export interface ProvisionHandlerResult {
 }

package/dist/types/tool-context.d.ts

@@ -1,5 +1,6 @@
 import type { AppInfo, WorkplaceInfo, RequestInfo } from './shared';
 import type { InvocationContext } from './invocation';
+import type { ContextLogger } from '../server/logger';
 /** Trigger types for tool execution */
 export type ToolTrigger = 'provision' | 'field_change' | 'page_action' | 'form_submit' | 'agent' | 'workflow' | 'page_context';
 /** Base context shared by all tool executions */
@@ -12,6 +13,8 @@ interface BaseToolContext {
     app: AppInfo;
     /** Invocation context for log traceability */
     invocation?: InvocationContext;
+    /** Context-aware logger that automatically includes invocation context */
+    log: ContextLogger;
 }
 /** Provision context - no installation, no workplace */
 export interface ProvisionToolContext extends BaseToolContext {

package/dist/types/webhook.d.ts

@@ -1,5 +1,6 @@
 import type { AppInfo, WorkplaceInfo } from './shared';
 import type { InvocationContext } from './invocation';
+import type { ContextLogger } from '../server/logger';
 /**
  * Raw HTTP request shape sent over the wire in handler envelopes.
  * This is the wire format used by both webhooks and OAuth callbacks.
@@ -38,6 +39,8 @@ interface BaseWebhookContext {
     app: AppInfo;
     /** Invocation context for log traceability */
     invocation?: InvocationContext;
+    /** Context-aware logger that automatically includes invocation context */
+    log: ContextLogger;
 }
 /** Provision-level webhook context - no installation or workplace */
 export interface ProvisionWebhookContext extends BaseWebhookContext {

package/package.json

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