@rainfall-devkit/sdk 0.2.1 → 0.2.3

package/dist/index.d.mts

@@ -1,7 +1,7 @@
-import { l as RainfallClient } from './sdk-4OvXPr8E.mjs';
-export { A as AI, b as ApiError, c as ApiResponse, d as Articles, D as Data, I as Integrations, M as Memory, a as Rainfall, R as RainfallConfig, e as RateLimitInfo, f as RequestOptions, T as ToolSchema, U as Utils, W as Web } from './sdk-4OvXPr8E.mjs';
+import { l as RainfallClient, a as Rainfall } from './sdk-Cl5Qzt4I.mjs';
+export { A as AI, b as ApiError, c as ApiResponse, d as Articles, D as Data, I as Integrations, M as Memory, P as ParamSchema, R as RainfallConfig, e as RateLimitInfo, f as RequestOptions, m as ToolParamsSchema, T as ToolSchema, U as Utils, V as ValidationIssue, n as ValidationResult, W as Web, o as clearSchemaCache, p as fetchToolSchema, q as formatValidationErrors, v as validateParams } from './sdk-Cl5Qzt4I.mjs';
 export { A as AuthenticationError, N as NetworkError, a as NotFoundError, R as RainfallError, b as RateLimitError, S as ServerError, T as TimeoutError, c as ToolNotFoundError, V as ValidationError } from './errors-BMPseAnM.mjs';
-export { C as ContextOptions, c as CronTriggerConfig, E as EdgeNodeRegistration, F as FileWatcherConfig, L as ListenerEvent, d as ListenerRegistry, M as MemoryEntry, N as NetworkedExecutorOptions, e as NodeCapabilities, Q as QueuedJob, a as RainfallDaemonContext, b as RainfallListenerRegistry, R as RainfallNetworkedExecutor, S as SessionContext, T as ToolExecutionRecord, f as createCronWorkflow, g as createFileWatcherWorkflow } from './listeners-MNAnpZj-.mjs';
+export { C as ContextOptions, c as CronTriggerConfig, E as EdgeNodeRegistration, F as FileWatcherConfig, L as ListenerEvent, d as ListenerRegistry, M as MemoryEntry, N as NetworkedExecutorOptions, e as NodeCapabilities, Q as QueuedJob, a as RainfallDaemonContext, b as RainfallListenerRegistry, R as RainfallNetworkedExecutor, S as SessionContext, T as ToolExecutionRecord, f as createCronWorkflow, g as createFileWatcherWorkflow } from './listeners-Ckdj6D8T.mjs';
 import 'ws';
 import '@modelcontextprotocol/sdk/client/index.js';
 import '@modelcontextprotocol/sdk/client/stdio.js';
@@ -247,6 +247,68 @@ declare function createSecureEdgeClient(client: RainfallClient, options: {
     backendSecret?: string;
 }): Promise<SecureEdgeClient>;
 
+/**
+ * CLI handler types for tool-specific preflight/postflight/display overrides
+ */
+
+interface ToolContext {
+    rainfall: Rainfall;
+    toolId: string;
+    params: Record<string, unknown>;
+    args: string[];
+    flags: {
+        raw?: boolean;
+        quiet?: boolean;
+        [key: string]: unknown;
+    };
+}
+interface PreflightResult {
+    /** Modified params to use for execution */
+    params?: Record<string, unknown>;
+    /** Skip normal execution and return this result directly */
+    skipExecution?: unknown;
+    /** Additional context to pass to postflight */
+    context?: Record<string, unknown>;
+}
+interface PostflightContext extends ToolContext {
+    /** The result from tool execution (or skipExecution) */
+    result: unknown;
+    /** Context passed from preflight */
+    preflightContext?: Record<string, unknown>;
+}
+interface DisplayContext extends PostflightContext {
+    /** Output stream (for testing/custom output) */
+    output?: NodeJS.WriteStream;
+}
+/** Tool handler interface for custom CLI behavior */
+interface ToolHandler {
+    /** Tool ID this handler applies to (or pattern) */
+    toolId: string | RegExp;
+    /**
+     * Preflight: Modify params, validate, or skip execution entirely
+     * Called before tool execution
+     */
+    preflight?(context: ToolContext): Promise<PreflightResult | void> | PreflightResult | void;
+    /**
+     * Postflight: Process result, trigger side effects
+     * Called after successful tool execution
+     */
+    postflight?(context: PostflightContext): Promise<void> | void;
+    /**
+     * Display: Custom output formatting
+     * Return true if handled, false to use default display
+     */
+    display?(context: DisplayContext): Promise<boolean> | boolean;
+}
+/** Registry of tool handlers */
+declare class ToolHandlerRegistry {
+    private handlers;
+    register(handler: ToolHandler): void;
+    findHandler(toolId: string): ToolHandler | undefined;
+    getAllHandlers(): ToolHandler[];
+}
+declare const globalHandlerRegistry: ToolHandlerRegistry;
+
 /**
  * Rainfall SDK - Official SDK for Rainfall API
  *
@@ -273,4 +335,4 @@ declare function createSecureEdgeClient(client: RainfallClient, options: {
 
 declare const VERSION = "0.1.0";
 
-export { type ACLCheck, type ACLResult, type EdgeNodeJWT, EdgeNodeSecurity, type EncryptedPayload, type JWTPayload, type JobResult, type KeyPair, RainfallClient, SecureEdgeClient, type SecureEdgeConfig, type SecureJob, VERSION, createEdgeNodeSecurity, createSecureEdgeClient };
+export { type ACLCheck, type ACLResult, type DisplayContext, type EdgeNodeJWT, EdgeNodeSecurity, type EncryptedPayload, type JWTPayload, type JobResult, type KeyPair, type PostflightContext, type PreflightResult, Rainfall, RainfallClient, SecureEdgeClient, type SecureEdgeConfig, type SecureJob, type ToolContext, type ToolHandler, ToolHandlerRegistry, VERSION, createEdgeNodeSecurity, createSecureEdgeClient, globalHandlerRegistry };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { l as RainfallClient } from './sdk-4OvXPr8E.js';
-export { A as AI, b as ApiError, c as ApiResponse, d as Articles, D as Data, I as Integrations, M as Memory, a as Rainfall, R as RainfallConfig, e as RateLimitInfo, f as RequestOptions, T as ToolSchema, U as Utils, W as Web } from './sdk-4OvXPr8E.js';
+import { l as RainfallClient, a as Rainfall } from './sdk-Cl5Qzt4I.js';
+export { A as AI, b as ApiError, c as ApiResponse, d as Articles, D as Data, I as Integrations, M as Memory, P as ParamSchema, R as RainfallConfig, e as RateLimitInfo, f as RequestOptions, m as ToolParamsSchema, T as ToolSchema, U as Utils, V as ValidationIssue, n as ValidationResult, W as Web, o as clearSchemaCache, p as fetchToolSchema, q as formatValidationErrors, v as validateParams } from './sdk-Cl5Qzt4I.js';
 export { A as AuthenticationError, N as NetworkError, a as NotFoundError, R as RainfallError, b as RateLimitError, S as ServerError, T as TimeoutError, c as ToolNotFoundError, V as ValidationError } from './errors-BMPseAnM.js';
-export { C as ContextOptions, c as CronTriggerConfig, E as EdgeNodeRegistration, F as FileWatcherConfig, L as ListenerEvent, d as ListenerRegistry, M as MemoryEntry, N as NetworkedExecutorOptions, e as NodeCapabilities, Q as QueuedJob, a as RainfallDaemonContext, b as RainfallListenerRegistry, R as RainfallNetworkedExecutor, S as SessionContext, T as ToolExecutionRecord, f as createCronWorkflow, g as createFileWatcherWorkflow } from './listeners-B5Vy9Ao5.js';
+export { C as ContextOptions, c as CronTriggerConfig, E as EdgeNodeRegistration, F as FileWatcherConfig, L as ListenerEvent, d as ListenerRegistry, M as MemoryEntry, N as NetworkedExecutorOptions, e as NodeCapabilities, Q as QueuedJob, a as RainfallDaemonContext, b as RainfallListenerRegistry, R as RainfallNetworkedExecutor, S as SessionContext, T as ToolExecutionRecord, f as createCronWorkflow, g as createFileWatcherWorkflow } from './listeners-BBNBsJCk.js';
 import 'ws';
 import '@modelcontextprotocol/sdk/client/index.js';
 import '@modelcontextprotocol/sdk/client/stdio.js';
@@ -247,6 +247,68 @@ declare function createSecureEdgeClient(client: RainfallClient, options: {
     backendSecret?: string;
 }): Promise<SecureEdgeClient>;
 
+/**
+ * CLI handler types for tool-specific preflight/postflight/display overrides
+ */
+
+interface ToolContext {
+    rainfall: Rainfall;
+    toolId: string;
+    params: Record<string, unknown>;
+    args: string[];
+    flags: {
+        raw?: boolean;
+        quiet?: boolean;
+        [key: string]: unknown;
+    };
+}
+interface PreflightResult {
+    /** Modified params to use for execution */
+    params?: Record<string, unknown>;
+    /** Skip normal execution and return this result directly */
+    skipExecution?: unknown;
+    /** Additional context to pass to postflight */
+    context?: Record<string, unknown>;
+}
+interface PostflightContext extends ToolContext {
+    /** The result from tool execution (or skipExecution) */
+    result: unknown;
+    /** Context passed from preflight */
+    preflightContext?: Record<string, unknown>;
+}
+interface DisplayContext extends PostflightContext {
+    /** Output stream (for testing/custom output) */
+    output?: NodeJS.WriteStream;
+}
+/** Tool handler interface for custom CLI behavior */
+interface ToolHandler {
+    /** Tool ID this handler applies to (or pattern) */
+    toolId: string | RegExp;
+    /**
+     * Preflight: Modify params, validate, or skip execution entirely
+     * Called before tool execution
+     */
+    preflight?(context: ToolContext): Promise<PreflightResult | void> | PreflightResult | void;
+    /**
+     * Postflight: Process result, trigger side effects
+     * Called after successful tool execution
+     */
+    postflight?(context: PostflightContext): Promise<void> | void;
+    /**
+     * Display: Custom output formatting
+     * Return true if handled, false to use default display
+     */
+    display?(context: DisplayContext): Promise<boolean> | boolean;
+}
+/** Registry of tool handlers */
+declare class ToolHandlerRegistry {
+    private handlers;
+    register(handler: ToolHandler): void;
+    findHandler(toolId: string): ToolHandler | undefined;
+    getAllHandlers(): ToolHandler[];
+}
+declare const globalHandlerRegistry: ToolHandlerRegistry;
+
 /**
  * Rainfall SDK - Official SDK for Rainfall API
  *
@@ -273,4 +335,4 @@ declare function createSecureEdgeClient(client: RainfallClient, options: {
 
 declare const VERSION = "0.1.0";
 
-export { type ACLCheck, type ACLResult, type EdgeNodeJWT, EdgeNodeSecurity, type EncryptedPayload, type JWTPayload, type JobResult, type KeyPair, RainfallClient, SecureEdgeClient, type SecureEdgeConfig, type SecureJob, VERSION, createEdgeNodeSecurity, createSecureEdgeClient };
+export { type ACLCheck, type ACLResult, type DisplayContext, type EdgeNodeJWT, EdgeNodeSecurity, type EncryptedPayload, type JWTPayload, type JobResult, type KeyPair, type PostflightContext, type PreflightResult, Rainfall, RainfallClient, SecureEdgeClient, type SecureEdgeConfig, type SecureJob, type ToolContext, type ToolHandler, ToolHandlerRegistry, VERSION, createEdgeNodeSecurity, createSecureEdgeClient, globalHandlerRegistry };