skedyul 0.2.148 → 0.2.149

package/dist/.build-stamp

@@ -1 +1 @@
-1770684891920
+1770690573798

package/dist/errors.d.ts

@@ -75,3 +75,26 @@ export declare class InvalidConfigurationError extends InstallError {
 export declare class ConnectionError extends InstallError {
     constructor(message?: string);
 }
+/**
+ * Error thrown when app authentication/authorization is invalid and needs re-validation.
+ *
+ * Any app integration can throw this error to signal that the installation's
+ * auth status should be set to INVALID, triggering re-authorization flow.
+ *
+ * The error code 'APP_AUTH_INVALID' is used by the workflow to detect and handle
+ * this error generically, regardless of which app throws it.
+ *
+ * The redirect URL is constructed by the workflow after catching this error,
+ * so apps don't need to provide it.
+ *
+ * @example
+ * ```typescript
+ * if (tokenExpired) {
+ *   throw new AppAuthInvalidError('Access token has expired. Please re-authorize the app.')
+ * }
+ * ```
+ */
+export declare class AppAuthInvalidError extends Error {
+    readonly code = "APP_AUTH_INVALID";
+    constructor(message: string);
+}

package/dist/errors.js

@@ -7,7 +7,7 @@
  * that the frontend can display inline on the install form.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConnectionError = exports.InvalidConfigurationError = exports.AuthenticationError = exports.MissingRequiredFieldError = exports.InstallError = void 0;
+exports.AppAuthInvalidError = exports.ConnectionError = exports.InvalidConfigurationError = exports.AuthenticationError = exports.MissingRequiredFieldError = exports.InstallError = void 0;
 /**
  * Base error class for install handler errors.
  *
@@ -97,3 +97,30 @@ class ConnectionError extends InstallError {
     }
 }
 exports.ConnectionError = ConnectionError;
+/**
+ * Error thrown when app authentication/authorization is invalid and needs re-validation.
+ *
+ * Any app integration can throw this error to signal that the installation's
+ * auth status should be set to INVALID, triggering re-authorization flow.
+ *
+ * The error code 'APP_AUTH_INVALID' is used by the workflow to detect and handle
+ * this error generically, regardless of which app throws it.
+ *
+ * The redirect URL is constructed by the workflow after catching this error,
+ * so apps don't need to provide it.
+ *
+ * @example
+ * ```typescript
+ * if (tokenExpired) {
+ *   throw new AppAuthInvalidError('Access token has expired. Please re-authorize the app.')
+ * }
+ * ```
+ */
+class AppAuthInvalidError extends Error {
+    constructor(message) {
+        super(message);
+        this.code = 'APP_AUTH_INVALID';
+        this.name = 'AppAuthInvalidError';
+    }
+}
+exports.AppAuthInvalidError = AppAuthInvalidError;

package/dist/index.d.ts

@@ -4,7 +4,7 @@ export { ToolResponseMetaSchema } from './types';
 export * from './schemas';
 export { server } from './server';
 export { DEFAULT_DOCKERFILE } from './dockerfile';
-export { InstallError, MissingRequiredFieldError, AuthenticationError, InvalidConfigurationError, ConnectionError, } from './errors';
+export { InstallError, MissingRequiredFieldError, AuthenticationError, InvalidConfigurationError, ConnectionError, AppAuthInvalidError, } from './errors';
 export type { InstallErrorCode } from './errors';
 export { z };
 export { workplace, communicationChannel, instance, token, file, webhook, resource, contactAssociationLink, configure, getConfig, runWithConfig, } from './core/client';

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.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.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 zod_1 = require("zod");
 Object.defineProperty(exports, "z", { enumerable: true, get: function () { return zod_1.z; } });
 __exportStar(require("./types"), exports);
@@ -32,6 +32,7 @@ Object.defineProperty(exports, "MissingRequiredFieldError", { enumerable: true,
 Object.defineProperty(exports, "AuthenticationError", { enumerable: true, get: function () { return errors_1.AuthenticationError; } });
 Object.defineProperty(exports, "InvalidConfigurationError", { enumerable: true, get: function () { return errors_1.InvalidConfigurationError; } });
 Object.defineProperty(exports, "ConnectionError", { enumerable: true, get: function () { return errors_1.ConnectionError; } });
+Object.defineProperty(exports, "AppAuthInvalidError", { enumerable: true, get: function () { return errors_1.AppAuthInvalidError; } });
 var client_1 = require("./core/client");
 Object.defineProperty(exports, "workplace", { enumerable: true, get: function () { return client_1.workplace; } });
 Object.defineProperty(exports, "communicationChannel", { enumerable: true, get: function () { return client_1.communicationChannel; } });

package/dist/server.js

@@ -403,6 +403,24 @@ function createCallToolHandler(registry, state, onMaxRequests) {
             };
         }
         catch (error) {
+            // Check if it's an AppAuthInvalidError
+            if (error instanceof errors_1.AppAuthInvalidError) {
+                return {
+                    output: null,
+                    billing: { credits: 0 },
+                    meta: {
+                        success: false,
+                        message: error.message,
+                        toolName,
+                    },
+                    error: {
+                        code: error.code,
+                        message: error.message,
+                    },
+                    // Note: redirect URL will be added by workflow after detecting APP_AUTH_INVALID
+                };
+            }
+            // Generic error handling for other errors
             const errorMessage = error instanceof Error ? error.message : String(error ?? '');
             return {
                 output: null,
@@ -412,7 +430,10 @@ function createCallToolHandler(registry, state, onMaxRequests) {
                     message: errorMessage,
                     toolName,
                 },
-                error: errorMessage,
+                error: {
+                    code: 'TOOL_EXECUTION_ERROR',
+                    message: errorMessage,
+                },
             };
         }
         finally {

package/dist/types.d.ts

@@ -104,6 +104,14 @@ export interface ToolEffect {
     /** URL to navigate to after the tool completes */
     redirect?: string;
 }
+/**
+ * Structured error information for tool execution results.
+ * Uses codes for serialization and workflow detection.
+ */
+export interface ToolError {
+    code: string;
+    message: string;
+}
 export interface ToolExecutionResult<Output = unknown> {
     /** Tool-specific output data. Null on error. */
     output: Output | null;
@@ -113,6 +121,8 @@ export interface ToolExecutionResult<Output = unknown> {
     meta: ToolResponseMeta;
     /** Optional client-side effects to execute */
     effect?: ToolEffect;
+    /** Structured error information (null/undefined if no error) */
+    error?: ToolError | null;
 }
 export interface ToolSchemaWithJson<Schema extends z.ZodTypeAny = z.ZodTypeAny> {
     zod: Schema;
@@ -300,7 +310,7 @@ export interface ToolCallResponse {
     output: unknown | null;
     billing: BillingInfo;
     meta: ToolResponseMeta;
-    error?: string;
+    error?: ToolError | null;
     effect?: ToolEffect;
 }
 export interface DedicatedServerInstance {

package/package.json

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