skedyul 0.3.2 → 0.3.3

package/dist/types/handlers.d.ts

@@ -1,4 +1,5 @@
 import type { WebhookRequest } from './webhook';
+import type { InvocationContext } from './invocation';
 export interface InstallHandlerContext {
     env: Record<string, string>;
     workplace: {
@@ -12,6 +13,8 @@ export interface InstallHandlerContext {
         handle: string;
         versionHandle: string;
     };
+    /** Invocation context for log traceability */
+    invocation?: InvocationContext;
 }
 export interface InstallHandlerResponseOAuth {
     env?: Record<string, string>;
@@ -39,6 +42,8 @@ export interface UninstallHandlerContext {
         handle: string;
         versionHandle: string;
     };
+    /** Invocation context for log traceability */
+    invocation?: InvocationContext;
 }
 export interface UninstallHandlerResult {
     cleanedWebhookIds?: string[];
@@ -47,6 +52,8 @@ export type UninstallHandler = (ctx: UninstallHandlerContext) => Promise<Uninsta
 export interface OAuthCallbackContext {
     /** Full HTTP request from the OAuth provider */
     request: WebhookRequest;
+    /** Invocation context for log traceability */
+    invocation?: InvocationContext;
 }
 export interface OAuthCallbackResult {
     env?: Record<string, string>;
@@ -59,6 +66,8 @@ export interface ProvisionHandlerContext {
         id: string;
         versionId: string;
     };
+    /** Invocation context for log traceability */
+    invocation?: InvocationContext;
 }
 export interface ProvisionHandlerResult {
 }

package/dist/types/index.d.ts

@@ -5,6 +5,8 @@
  * into smaller, focused modules.
  */
 export type { AppInfo, WorkplaceInfo, RequestInfo } from './shared';
+export type { InvocationType, ServerHookHandle, InvocationContext, } from './invocation';
+export { createToolCallContext, createServerHookContext, createWebhookContext, createWorkflowStepContext, } from './invocation';
 export type { ToolTrigger, ProvisionToolContext, FieldChangeToolContext, PageActionToolContext, FormSubmitToolContext, AgentToolContext, WorkflowToolContext, ToolExecutionContext, } from './tool-context';
 export { isProvisionContext, isRuntimeContext } from './tool-context';
 export type { ProvisionToolInput, BillingInfo, ToolResponseMeta, ToolEffect, ToolError, ToolExecutionResult, ToolSchemaWithJson, ToolSchema, ToolHandler, ToolDefinition, ToolRegistryEntry, ToolRegistry, ToolName, ToolMetadata, ToolCallResponse, } from './tool';

package/dist/types/index.js

@@ -6,7 +6,12 @@
  * into smaller, focused modules.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isRuntimeWebhookContext = exports.ToolResponseMetaSchema = exports.isRuntimeContext = exports.isProvisionContext = void 0;
+exports.isRuntimeWebhookContext = exports.ToolResponseMetaSchema = exports.isRuntimeContext = exports.isProvisionContext = exports.createWorkflowStepContext = exports.createWebhookContext = exports.createServerHookContext = exports.createToolCallContext = void 0;
+var invocation_1 = require("./invocation");
+Object.defineProperty(exports, "createToolCallContext", { enumerable: true, get: function () { return invocation_1.createToolCallContext; } });
+Object.defineProperty(exports, "createServerHookContext", { enumerable: true, get: function () { return invocation_1.createServerHookContext; } });
+Object.defineProperty(exports, "createWebhookContext", { enumerable: true, get: function () { return invocation_1.createWebhookContext; } });
+Object.defineProperty(exports, "createWorkflowStepContext", { enumerable: true, get: function () { return invocation_1.createWorkflowStepContext; } });
 var tool_context_1 = require("./tool-context");
 Object.defineProperty(exports, "isProvisionContext", { enumerable: true, get: function () { return tool_context_1.isProvisionContext; } });
 Object.defineProperty(exports, "isRuntimeContext", { enumerable: true, get: function () { return tool_context_1.isRuntimeContext; } });

package/dist/types/invocation.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Type of invocation that triggered the executable
+ */
+export type InvocationType = 'tool_call' | 'server_hook' | 'workflow_step' | 'webhook';
+/**
+ * Server hook handles for lifecycle events
+ */
+export type ServerHookHandle = 'provision' | 'install' | 'uninstall' | 'oauth_callback';
+/**
+ * Context for tracking how an executable was invoked.
+ * Used for log traceability and filtering.
+ */
+export interface InvocationContext {
+    /** Unique identifier for this invocation */
+    invocationId: string;
+    /** Type of invocation */
+    invocationType: InvocationType;
+    /** Unique ID for the tool call (for tool_call invocations) */
+    toolCallId?: string;
+    /** The tool's handle for searching (e.g., "get_customers") */
+    toolHandle?: string;
+    /** Hook type: "provision", "install", "uninstall", "oauth_callback" */
+    serverHookHandle?: ServerHookHandle;
+    /** The app installation that triggered the call */
+    appInstallationId?: string;
+    /** The workflow ID (if invoked via workflow) */
+    workflowId?: string;
+    /** The workflow version ID */
+    workflowVersionId?: string;
+    /** The workflow run ID */
+    workflowRunId?: string;
+    /** The workflow step ID */
+    workflowStepId?: string;
+}
+/**
+ * Create an invocation context for a tool call
+ */
+export declare function createToolCallContext(params: {
+    invocationId: string;
+    toolCallId: string;
+    toolHandle: string;
+    appInstallationId?: string;
+    workflowId?: string;
+    workflowVersionId?: string;
+    workflowRunId?: string;
+}): InvocationContext;
+/**
+ * Create an invocation context for a server hook
+ */
+export declare function createServerHookContext(params: {
+    invocationId: string;
+    serverHookHandle: ServerHookHandle;
+    appInstallationId?: string;
+}): InvocationContext;
+/**
+ * Create an invocation context for a webhook
+ */
+export declare function createWebhookContext(params: {
+    invocationId: string;
+    appInstallationId?: string;
+}): InvocationContext;
+/**
+ * Create an invocation context for a workflow step
+ */
+export declare function createWorkflowStepContext(params: {
+    invocationId: string;
+    workflowId: string;
+    workflowVersionId: string;
+    workflowRunId: string;
+    workflowStepId?: string;
+}): InvocationContext;

package/dist/types/invocation.js

@@ -0,0 +1,61 @@
+"use strict";
+// ─────────────────────────────────────────────────────────────────────────────
+// Invocation Context Types
+// ─────────────────────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createToolCallContext = createToolCallContext;
+exports.createServerHookContext = createServerHookContext;
+exports.createWebhookContext = createWebhookContext;
+exports.createWorkflowStepContext = createWorkflowStepContext;
+// ─────────────────────────────────────────────────────────────────────────────
+// Helper Functions for Creating Invocation Context
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Create an invocation context for a tool call
+ */
+function createToolCallContext(params) {
+    return {
+        invocationId: params.invocationId,
+        invocationType: 'tool_call',
+        toolCallId: params.toolCallId,
+        toolHandle: params.toolHandle,
+        appInstallationId: params.appInstallationId,
+        workflowId: params.workflowId,
+        workflowVersionId: params.workflowVersionId,
+        workflowRunId: params.workflowRunId,
+    };
+}
+/**
+ * Create an invocation context for a server hook
+ */
+function createServerHookContext(params) {
+    return {
+        invocationId: params.invocationId,
+        invocationType: 'server_hook',
+        serverHookHandle: params.serverHookHandle,
+        appInstallationId: params.appInstallationId,
+    };
+}
+/**
+ * Create an invocation context for a webhook
+ */
+function createWebhookContext(params) {
+    return {
+        invocationId: params.invocationId,
+        invocationType: 'webhook',
+        appInstallationId: params.appInstallationId,
+    };
+}
+/**
+ * Create an invocation context for a workflow step
+ */
+function createWorkflowStepContext(params) {
+    return {
+        invocationId: params.invocationId,
+        invocationType: 'workflow_step',
+        workflowId: params.workflowId,
+        workflowVersionId: params.workflowVersionId,
+        workflowRunId: params.workflowRunId,
+        workflowStepId: params.workflowStepId,
+    };
+}

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

@@ -1,4 +1,5 @@
 import type { AppInfo, WorkplaceInfo, RequestInfo } from './shared';
+import type { InvocationContext } from './invocation';
 /** 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 */
@@ -9,6 +10,8 @@ interface BaseToolContext {
     mode: 'execute' | 'estimate';
     /** App info - always present */
     app: AppInfo;
+    /** Invocation context for log traceability */
+    invocation?: InvocationContext;
 }
 /** Provision context - no installation, no workplace */
 export interface ProvisionToolContext extends BaseToolContext {

package/dist/types/tool.d.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import { z } from 'zod/v4';
 import type { ToolExecutionContext } from './tool-context';
 /**
  * Input type for Provision lifecycle tools (onProvision, onDeprovision).

package/dist/types/tool.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ToolResponseMetaSchema = void 0;
-const zod_1 = require("zod");
+const v4_1 = require("zod/v4");
 // ─────────────────────────────────────────────────────────────────────────────
 // Tool Response Meta
 // ─────────────────────────────────────────────────────────────────────────────
@@ -9,11 +9,11 @@ const zod_1 = require("zod");
  * Standardized metadata for tool responses.
  * Provides consistent structure for AI evaluation, logging, and debugging.
  */
-exports.ToolResponseMetaSchema = zod_1.z.object({
+exports.ToolResponseMetaSchema = v4_1.z.object({
     /** Whether the tool execution succeeded */
-    success: zod_1.z.boolean(),
+    success: v4_1.z.boolean(),
     /** Human-readable message describing the result or error */
-    message: zod_1.z.string(),
+    message: v4_1.z.string(),
     /** Name of the tool that was executed */
-    toolName: zod_1.z.string(),
+    toolName: v4_1.z.string(),
 });

package/dist/types/webhook.d.ts

@@ -1,4 +1,5 @@
 import type { AppInfo, WorkplaceInfo } from './shared';
+import type { InvocationContext } from './invocation';
 /**
  * Raw HTTP request shape sent over the wire in handler envelopes.
  * This is the wire format used by both webhooks and OAuth callbacks.
@@ -35,6 +36,8 @@ interface BaseWebhookContext {
     env: Record<string, string | undefined>;
     /** App info */
     app: AppInfo;
+    /** Invocation context for log traceability */
+    invocation?: InvocationContext;
 }
 /** 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.2",
+  "version": "0.3.3",
   "description": "The Skedyul SDK for Node.js",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -18,9 +18,10 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsc --build tsconfig.json && tsc --project tsconfig.tests.json && node -e \"require('fs').mkdirSync('dist',{recursive:true}); require('fs').writeFileSync('dist/.build-stamp', String(Date.now()))\"",
+    "build": "tsc --build tsconfig.json && node -e \"require('fs').mkdirSync('dist',{recursive:true}); require('fs').writeFileSync('dist/.build-stamp', String(Date.now()))\"",
+    "db:generate": "echo 'No database generation needed for this package'",
     "dev": "npx nodemon --watch src --ext js,ts --exec \"pnpm run build\"",
-    "test": "npm run build && node --test dist-tests/server.test.js dist-tests/cli.test.js"
+    "test": "tsc --project tsconfig.tests.json && node --test dist-tests/tests/server.test.js dist-tests/tests/cli.test.js"
   },
   "keywords": [
     "mcp",