@salesforce/magen-mcp-workflow 0.0.1 → 0.0.3

package/dist/nodes/abstractBaseNode.d.ts

@@ -1,13 +1,23 @@
 import { StateType, StateDefinition } from '@langchain/langgraph';
+import type { WorkflowRunnableConfig } from '../common/graphConfig.js';
+export type { WorkflowRunnableConfig } from '../common/graphConfig.js';
 /**
  * Base class for all workflow nodes
  *
+ * LangGraph supports both sync and async node functions. This base class
+ * supports both patterns - nodes can return Partial<TState> synchronously
+ * or Promise<Partial<TState>> asynchronously.
+ *
+ * Nodes receive an optional second parameter `config` (RunnableConfig) that
+ * contains runtime context like progress reporters, thread IDs, etc. This
+ * is the proper way to access runtime dependencies without polluting state.
+ *
  * @template TState - The state type for the workflow (defaults to StateType&lt;StateDefinition&gt;)
  *
- * Example:
+ * Example (sync):
  * ```
  * const MyWorkflowState = Annotation.Root({ count: Annotation<number> });
- * type State = typeof MyWorkflowState.State; // This is StateType<typeof MyWorkflowState.spec>
+ * type State = typeof MyWorkflowState.State;
  *
  * class IncrementNode extends BaseNode<State> {
  *   constructor() {
@@ -19,9 +29,25 @@ import { StateType, StateDefinition } from '@langchain/langgraph';
  *   };
  * }
  * ```
+ *
+ * Example (async with config):
+ * ```
+ * class AsyncNode extends BaseNode<State> {
+ *   constructor() {
+ *     super('asyncNode');
+ *   }
+ *
+ *   execute = async (state: State, config?: WorkflowRunnableConfig) => {
+ *     const progressReporter = config?.configurable?.progressReporter;
+ *     progressReporter?.report(50, 100, 'Processing...');
+ *     const result = await someAsyncOperation();
+ *     return { data: result };
+ *   };
+ * }
+ * ```
  */
 export declare abstract class BaseNode<TState extends StateType<StateDefinition>> {
     readonly name: string;
     constructor(name: string);
-    abstract execute: (state: TState) => Partial<TState>;
+    abstract execute: (state: TState, config?: WorkflowRunnableConfig) => Partial<TState> | Promise<Partial<TState>>;
 }

package/dist/nodes/abstractBaseNode.js

@@ -7,12 +7,20 @@
 /**
  * Base class for all workflow nodes
  *
+ * LangGraph supports both sync and async node functions. This base class
+ * supports both patterns - nodes can return Partial<TState> synchronously
+ * or Promise<Partial<TState>> asynchronously.
+ *
+ * Nodes receive an optional second parameter `config` (RunnableConfig) that
+ * contains runtime context like progress reporters, thread IDs, etc. This
+ * is the proper way to access runtime dependencies without polluting state.
+ *
  * @template TState - The state type for the workflow (defaults to StateType&lt;StateDefinition&gt;)
  *
- * Example:
+ * Example (sync):
  * ```
  * const MyWorkflowState = Annotation.Root({ count: Annotation<number> });
- * type State = typeof MyWorkflowState.State; // This is StateType<typeof MyWorkflowState.spec>
+ * type State = typeof MyWorkflowState.State;
  *
  * class IncrementNode extends BaseNode<State> {
  *   constructor() {
@@ -24,6 +32,22 @@
  *   };
  * }
  * ```
+ *
+ * Example (async with config):
+ * ```
+ * class AsyncNode extends BaseNode<State> {
+ *   constructor() {
+ *     super('asyncNode');
+ *   }
+ *
+ *   execute = async (state: State, config?: WorkflowRunnableConfig) => {
+ *     const progressReporter = config?.configurable?.progressReporter;
+ *     progressReporter?.report(50, 100, 'Processing...');
+ *     const result = await someAsyncOperation();
+ *     return { data: result };
+ *   };
+ * }
+ * ```
  */
 export class BaseNode {
     name;

package/dist/nodes/abstractBaseNode.js.map

@@ -1 +1 @@
-{"version":3,"file":"abstractBaseNode.js","sourceRoot":"","sources":["../../src/nodes/abstractBaseNode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAgB,QAAQ;IACZ,IAAI,CAAS;IAE7B,YAAY,IAAY;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CAGF"}
+{"version":3,"file":"abstractBaseNode.js","sourceRoot":"","sources":["../../src/nodes/abstractBaseNode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,OAAgB,QAAQ;IACZ,IAAI,CAAS;IAE7B,YAAY,IAAY;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CAMF"}

package/dist/nodes/abstractToolNode.d.ts

@@ -1,7 +1,7 @@
 import z from 'zod';
 import { StateType, StateDefinition } from '@langchain/langgraph';
 import { BaseNode } from './abstractBaseNode.js';
-import { MCPToolInvocationData } from '../common/metadata.js';
+import { InterruptData } from '../common/metadata.js';
 import { Logger } from '../logging/logger.js';
 import { ToolExecutor } from './toolExecutor.js';
 /**
@@ -23,10 +23,12 @@ export declare abstract class AbstractToolNode<TState extends StateType<StateDef
      * This method uses the common toolExecutionUtils.executeToolWithLogging function
      * to ensure consistent behavior across all tool invocations in the codebase.
      *
-     * @param toolInvocationData The tool invocation data to pass to the tool executor
+     * Supports both MCPToolInvocationData (delegate mode) and NodeGuidanceData (direct guidance mode).
+     *
+     * @param interruptData The interrupt data (MCPToolInvocationData or NodeGuidanceData) to pass to the tool executor
      * @param resultSchema The schema to validate the result against
      * @param validator Optional custom validator function
      * @returns The validated result from the tool execution
      */
-    protected executeToolWithLogging<TResultSchema extends z.ZodObject<z.ZodRawShape>>(toolInvocationData: MCPToolInvocationData<z.ZodObject<z.ZodRawShape>>, resultSchema: TResultSchema, validator?: (result: unknown, schema: TResultSchema) => z.infer<TResultSchema>): z.infer<TResultSchema>;
+    protected executeToolWithLogging<TResultSchema extends z.ZodObject<z.ZodRawShape>>(interruptData: InterruptData<z.ZodObject<z.ZodRawShape>, TResultSchema>, resultSchema: TResultSchema, validator?: (result: unknown, schema: TResultSchema) => z.infer<TResultSchema>): z.infer<TResultSchema>;
 }

package/dist/nodes/abstractToolNode.js

@@ -32,13 +32,15 @@ export class AbstractToolNode extends BaseNode {
      * This method uses the common toolExecutionUtils.executeToolWithLogging function
      * to ensure consistent behavior across all tool invocations in the codebase.
      *
-     * @param toolInvocationData The tool invocation data to pass to the tool executor
+     * Supports both MCPToolInvocationData (delegate mode) and NodeGuidanceData (direct guidance mode).
+     *
+     * @param interruptData The interrupt data (MCPToolInvocationData or NodeGuidanceData) to pass to the tool executor
      * @param resultSchema The schema to validate the result against
      * @param validator Optional custom validator function
      * @returns The validated result from the tool execution
      */
-    executeToolWithLogging(toolInvocationData, resultSchema, validator) {
-        return executeToolWithLogging(this.toolExecutor, this.logger, toolInvocationData, resultSchema, validator);
+    executeToolWithLogging(interruptData, resultSchema, validator) {
+        return executeToolWithLogging(this.toolExecutor, this.logger, interruptData, resultSchema, validator);
     }
 }
 //# sourceMappingURL=abstractToolNode.js.map

package/dist/nodes/abstractToolNode.js.map

@@ -1 +1 @@
-{"version":3,"file":"abstractToolNode.js","sourceRoot":"","sources":["../../src/nodes/abstractToolNode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,OAAO,EAAU,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAgB,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAExE;;;;GAIG;AACH,MAAM,OAAgB,gBAEpB,SAAQ,QAAgB;IACL,MAAM,CAAS;IACf,aAAa,CAAS;IACtB,YAAY,CAAe;IAE9C,YAAY,IAAY,EAAE,YAA2B,EAAE,MAAe;QACpE,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,aAAa,GAAG,gBAAgB,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAC7D,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,qBAAqB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAClE,IAAI,CAAC,YAAY,GAAG,YAAY,IAAI,IAAI,qBAAqB,EAAE,CAAC;IAClE,CAAC;IAED;;;;;;;;;;;;;OAaG;IACO,sBAAsB,CAC9B,kBAAqE,EACrE,YAA2B,EAC3B,SAA8E;QAE9E,OAAO,sBAAsB,CAC3B,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,MAAM,EACX,kBAAkB,EAClB,YAAY,EACZ,SAAS,CACV,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"abstractToolNode.js","sourceRoot":"","sources":["../../src/nodes/abstractToolNode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,OAAO,EAAU,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAgB,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAExE;;;;GAIG;AACH,MAAM,OAAgB,gBAEpB,SAAQ,QAAgB;IACL,MAAM,CAAS;IACf,aAAa,CAAS;IACtB,YAAY,CAAe;IAE9C,YAAY,IAAY,EAAE,YAA2B,EAAE,MAAe;QACpE,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,aAAa,GAAG,gBAAgB,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAC7D,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,qBAAqB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAClE,IAAI,CAAC,YAAY,GAAG,YAAY,IAAI,IAAI,qBAAqB,EAAE,CAAC;IAClE,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACO,sBAAsB,CAC9B,aAAuE,EACvE,YAA2B,EAC3B,SAA8E;QAE9E,OAAO,sBAAsB,CAC3B,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,MAAM,EACX,aAAa,EACb,YAAY,EACZ,SAAS,CACV,CAAC;IACJ,CAAC;CACF"}

package/dist/nodes/getUserInput/factory.js

@@ -56,9 +56,9 @@ export function createGetUserInputNode(options) {
             isFulfilled: false,
             reason: `Property '${propertyName}' is missing from the workflow state.`,
         };
-    }, userInputProperty, } = options;
+    }, userInputProperty, nodeName = 'getUserInput', } = options;
     // Create default service implementation if not provided
     const service = getInputService ?? new GetInputService(toolId, toolExecutor, logger);
-    return new GetUserInputNode(service, requiredProperties, isPropertyFulfilled, userInputProperty);
+    return new GetUserInputNode(service, requiredProperties, isPropertyFulfilled, userInputProperty, nodeName);
 }
 //# sourceMappingURL=factory.js.map

package/dist/nodes/getUserInput/factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/nodes/getUserInput/factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,eAAe,EAA2B,MAAM,mCAAmC,CAAC;AAC7F,OAAO,EAA2B,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAGtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAwC;IAExC,MAAM,EACJ,kBAAkB,EAClB,MAAM,EACN,eAAe,EACf,YAAY,GAAG,IAAI,qBAAqB,EAAE,EAC1C,MAAM,GAAG,qBAAqB,CAAC,kBAAkB,CAAC,EAClD,mBAAmB,GAAG,CAAC,KAAa,EAAE,YAAoB,EAA2B,EAAE;QACrF,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC1C,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QAC/B,CAAC;QACD,OAAO;YACL,WAAW,EAAE,KAAK;YAClB,MAAM,EAAE,aAAa,YAAY,uCAAuC;SACzE,CAAC;IACJ,CAAC,EACD,iBAAiB,GAClB,GAAG,OAAO,CAAC;IAEZ,wDAAwD;IACxD,MAAM,OAAO,GACX,eAAe,IAAI,IAAI,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IAEvE,OAAO,IAAI,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,iBAAiB,CAAC,CAAC;AACnG,CAAC"}
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/nodes/getUserInput/factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,eAAe,EAA2B,MAAM,mCAAmC,CAAC;AAC7F,OAAO,EAA2B,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAGtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAwC;IAExC,MAAM,EACJ,kBAAkB,EAClB,MAAM,EACN,eAAe,EACf,YAAY,GAAG,IAAI,qBAAqB,EAAE,EAC1C,MAAM,GAAG,qBAAqB,CAAC,kBAAkB,CAAC,EAClD,mBAAmB,GAAG,CAAC,KAAa,EAAE,YAAoB,EAA2B,EAAE;QACrF,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC1C,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QAC/B,CAAC;QACD,OAAO;YACL,WAAW,EAAE,KAAK;YAClB,MAAM,EAAE,aAAa,YAAY,uCAAuC;SACzE,CAAC;IACJ,CAAC,EACD,iBAAiB,EACjB,QAAQ,GAAG,cAAc,GAC1B,GAAG,OAAO,CAAC;IAEZ,wDAAwD;IACxD,MAAM,OAAO,GACX,eAAe,IAAI,IAAI,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IAEvE,OAAO,IAAI,gBAAgB,CACzB,OAAO,EACP,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,QAAQ,CACT,CAAC;AACJ,CAAC"}

package/dist/nodes/getUserInput/node.d.ts

@@ -56,13 +56,31 @@ export interface GetUserInputNodeOptions<TState extends StateType<StateDefinitio
      *
      */
     userInputProperty: keyof TState;
+    /**
+     * Custom name for the node (optional, defaults to 'getUserInput')
+     * Use this when you need multiple getUserInput nodes in the same graph
+     *
+     * @example
+     *
+     * // Create multiple input nodes with unique names
+     * const userInputNode = createGetUserInputNode({
+     *   nodeName: 'getUserInput',
+     *   ...
+     * });
+     *
+     * const androidSetupNode = createGetUserInputNode({
+     *   nodeName: 'getAndroidSetup',
+     *   ...
+     * });
+     */
+    nodeName?: string;
 }
 export declare class GetUserInputNode<TState extends StateType<StateDefinition>> extends BaseNode<TState> {
     private readonly getInputService;
     private readonly requiredProperties;
     private readonly isPropertyFulfilled;
     private readonly userInputProperty;
-    constructor(getInputService: GetInputServiceProvider, requiredProperties: PropertyMetadataCollection, isPropertyFulfilled: IsPropertyFulfilled<TState>, userInputProperty: keyof TState);
+    constructor(getInputService: GetInputServiceProvider, requiredProperties: PropertyMetadataCollection, isPropertyFulfilled: IsPropertyFulfilled<TState>, userInputProperty: keyof TState, nodeName?: string);
     execute: (state: TState) => Partial<TState>;
     private getUnfulfilledProperties;
 }

package/dist/nodes/getUserInput/node.js

@@ -10,8 +10,8 @@ export class GetUserInputNode extends BaseNode {
     requiredProperties;
     isPropertyFulfilled;
     userInputProperty;
-    constructor(getInputService, requiredProperties, isPropertyFulfilled, userInputProperty) {
-        super('getUserInput');
+    constructor(getInputService, requiredProperties, isPropertyFulfilled, userInputProperty, nodeName = 'getUserInput') {
+        super(nodeName);
         this.getInputService = getInputService;
         this.requiredProperties = requiredProperties;
         this.isPropertyFulfilled = isPropertyFulfilled;

package/dist/nodes/getUserInput/node.js.map

@@ -1 +1 @@
-{"version":3,"file":"node.js","sourceRoot":"","sources":["../../../src/nodes/getUserInput/node.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAkElD,MAAM,OAAO,gBAA4D,SAAQ,QAAgB;IAE5E;IACA;IACA;IACA;IAJnB,YACmB,eAAwC,EACxC,kBAA8C,EAC9C,mBAAgD,EAChD,iBAA+B;QAEhD,KAAK,CAAC,cAAc,CAAC,CAAC;QALL,oBAAe,GAAf,eAAe,CAAyB;QACxC,uBAAkB,GAAlB,kBAAkB,CAA4B;QAC9C,wBAAmB,GAAnB,mBAAmB,CAA6B;QAChD,sBAAiB,GAAjB,iBAAiB,CAAc;IAGlD,CAAC;IAED,OAAO,GAAG,CAAC,KAAa,EAAmB,EAAE;QAC3C,MAAM,qBAAqB,GAAG,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC;QACnE,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;QAC1E,OAAO,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,YAAY,EAAgC,CAAC;IAClF,CAAC,CAAC;IAEM,wBAAwB,CAAC,KAAa;QAC5C,MAAM,aAAa,GAAuB,EAAE,CAAC;QAC7C,KAAK,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CACnD,IAAI,CAAC,kBAAgD,CACtD,EAAE,CAAC;YACF,MAAM,iBAAiB,GAAG,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;YAExE,IAAI,CAAC,iBAAiB,CAAC,WAAW,EAAE,CAAC;gBACnC,aAAa,CAAC,IAAI,CAAC;oBACjB,YAAY;oBACZ,YAAY,EAAE,QAAQ,CAAC,YAAY;oBACnC,WAAW,EAAE,QAAQ,CAAC,WAAW;oBACjC,MAAM,EAAE,iBAAiB,CAAC,MAAM;iBACjC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,OAAO,aAAa,CAAC;IACvB,CAAC;CACF"}
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../../src/nodes/getUserInput/node.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAqFlD,MAAM,OAAO,gBAA4D,SAAQ,QAAgB;IAE5E;IACA;IACA;IACA;IAJnB,YACmB,eAAwC,EACxC,kBAA8C,EAC9C,mBAAgD,EAChD,iBAA+B,EAChD,WAAmB,cAAc;QAEjC,KAAK,CAAC,QAAQ,CAAC,CAAC;QANC,oBAAe,GAAf,eAAe,CAAyB;QACxC,uBAAkB,GAAlB,kBAAkB,CAA4B;QAC9C,wBAAmB,GAAnB,mBAAmB,CAA6B;QAChD,sBAAiB,GAAjB,iBAAiB,CAAc;IAIlD,CAAC;IAED,OAAO,GAAG,CAAC,KAAa,EAAmB,EAAE;QAC3C,MAAM,qBAAqB,GAAG,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC;QACnE,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;QAC1E,OAAO,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,YAAY,EAAgC,CAAC;IAClF,CAAC,CAAC;IAEM,wBAAwB,CAAC,KAAa;QAC5C,MAAM,aAAa,GAAuB,EAAE,CAAC;QAC7C,KAAK,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CACnD,IAAI,CAAC,kBAAgD,CACtD,EAAE,CAAC;YACF,MAAM,iBAAiB,GAAG,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;YAExE,IAAI,CAAC,iBAAiB,CAAC,WAAW,EAAE,CAAC;gBACnC,aAAa,CAAC,IAAI,CAAC;oBACjB,YAAY;oBACZ,YAAY,EAAE,QAAQ,CAAC,YAAY;oBACnC,WAAW,EAAE,QAAQ,CAAC,WAAW;oBACjC,MAAM,EAAE,iBAAiB,CAAC,MAAM;iBACjC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,OAAO,aAAa,CAAC;IACvB,CAAC;CACF"}

package/dist/nodes/toolExecutor.d.ts

@@ -1,5 +1,5 @@
 import z from 'zod';
-import { MCPToolInvocationData } from '../common/metadata.js';
+import { InterruptData } from '../common/metadata.js';
 /**
  * Interface for tool execution mechanism.
  * Abstracts the LangGraph interrupt mechanism to enable dependency injection and testing.
@@ -8,15 +8,16 @@ export interface ToolExecutor {
     /**
      * Executes a tool by invoking the underlying mechanism (e.g., LangGraph interrupt).
      *
-     * @param toolInvocationData The tool invocation data to pass to the execution mechanism
+     * @param interruptData The interrupt data to pass to the execution mechanism.
+     *   Can be either MCPToolInvocationData (delegate mode) or NodeGuidanceData (direct guidance mode).
      * @returns The result from the tool execution (as unknown, to be validated by caller)
      */
-    execute(toolInvocationData: MCPToolInvocationData<z.ZodObject<z.ZodRawShape>>): unknown;
+    execute(interruptData: InterruptData<z.ZodObject<z.ZodRawShape>, z.ZodObject<z.ZodRawShape>>): unknown;
 }
 /**
  * Production implementation of ToolExecutor that uses LangGraph's interrupt mechanism.
  * This is the default implementation used in production workflows.
  */
 export declare class LangGraphToolExecutor implements ToolExecutor {
-    execute(toolInvocationData: MCPToolInvocationData<z.ZodObject<z.ZodRawShape>>): unknown;
+    execute(interruptData: InterruptData<z.ZodObject<z.ZodRawShape>, z.ZodObject<z.ZodRawShape>>): unknown;
 }

package/dist/nodes/toolExecutor.js

@@ -11,8 +11,8 @@ import { interrupt } from '@langchain/langgraph';
  */
 /* c8 ignore start */
 export class LangGraphToolExecutor {
-    execute(toolInvocationData) {
-        return interrupt(toolInvocationData);
+    execute(interruptData) {
+        return interrupt(interruptData);
     }
 }
 /* c8 ignore stop */

package/dist/nodes/toolExecutor.js.map

@@ -1 +1 @@
-{"version":3,"file":"toolExecutor.js","sourceRoot":"","sources":["../../src/nodes/toolExecutor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAiBjD;;;GAGG;AACH,qBAAqB;AACrB,MAAM,OAAO,qBAAqB;IAChC,OAAO,CAAC,kBAAqE;QAC3E,OAAO,SAAS,CAAC,kBAAkB,CAAC,CAAC;IACvC,CAAC;CACF;AACD,oBAAoB"}
+{"version":3,"file":"toolExecutor.js","sourceRoot":"","sources":["../../src/nodes/toolExecutor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAoBjD;;;GAGG;AACH,qBAAqB;AACrB,MAAM,OAAO,qBAAqB;IAChC,OAAO,CACL,aAAoF;QAEpF,OAAO,SAAS,CAAC,aAAa,CAAC,CAAC;IAClC,CAAC;CACF;AACD,oBAAoB"}

package/dist/routers/checkPropertiesFulfilledRouter.js

@@ -89,14 +89,14 @@ export class CheckPropertiesFulfilledRouter {
             }
         }
         if (unfulfilledProperties.length > 0) {
-            this.logger.debug('Properties not fulfilled, routing to unfulfilled node', {
+            this.logger.debug(`Properties not fulfilled, routing to ${this.propertiesUnfulfilledNodeName}`, {
                 unfulfilledProperties,
                 targetNode: this.propertiesUnfulfilledNodeName,
                 totalRequired: Object.keys(this.requiredProperties).length,
             });
             return this.propertiesUnfulfilledNodeName;
         }
-        this.logger.debug('All properties fulfilled, routing to fulfilled node', {
+        this.logger.debug(`All properties fulfilled, routing to ${this.propertiesFulfilledNodeName}`, {
             targetNode: this.propertiesFulfilledNodeName,
             totalProperties: Object.keys(this.requiredProperties).length,
         });

package/dist/routers/checkPropertiesFulfilledRouter.js.map

@@ -1 +1 @@
-{"version":3,"file":"checkPropertiesFulfilledRouter.js","sourceRoot":"","sources":["../../src/routers/checkPropertiesFulfilledRouter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAU,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAErE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,OAAO,8BAA8B;IACxB,2BAA2B,CAAS;IACpC,6BAA6B,CAAS;IACtC,kBAAkB,CAA6B;IAC/C,MAAM,CAAS;IAEhC;;;;;;;;OAQG;IACH,YACE,2BAAmC,EACnC,6BAAqC,EACrC,kBAA8C,EAC9C,MAAe;QAEf,IAAI,CAAC,2BAA2B,GAAG,2BAA2B,CAAC;QAC/D,IAAI,CAAC,6BAA6B,GAAG,6BAA6B,CAAC;QACnE,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;QAC7C,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,qBAAqB,CAAC,gCAAgC,CAAC,CAAC;IAClF,CAAC;IAED;;;;;;;;;OASG;IACH,OAAO,GAAG,CAAC,KAAa,EAAU,EAAE;QAClC,OAAO,IAAI,CAAC,4BAA4B,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC,CAAC;IAEF;;;;;;;;OAQG;IACK,4BAA4B,CAAC,KAAa;QAChD,MAAM,qBAAqB,GAAa,EAAE,CAAC;QAE3C,KAAK,MAAM,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAChE,IAAI,CAAC,KAAK,CAAC,YAA4B,CAAC,EAAE,CAAC;gBACzC,qBAAqB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QAED,IAAI,qBAAqB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uDAAuD,EAAE;gBACzE,qBAAqB;gBACrB,UAAU,EAAE,IAAI,CAAC,6BAA6B;gBAC9C,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,MAAM;aAC3D,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,6BAA6B,CAAC;QAC5C,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qDAAqD,EAAE;YACvE,UAAU,EAAE,IAAI,CAAC,2BAA2B;YAC5C,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,MAAM;SAC7D,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,2BAA2B,CAAC;IAC1C,CAAC;CACF"}
+{"version":3,"file":"checkPropertiesFulfilledRouter.js","sourceRoot":"","sources":["../../src/routers/checkPropertiesFulfilledRouter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAU,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAErE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,OAAO,8BAA8B;IACxB,2BAA2B,CAAS;IACpC,6BAA6B,CAAS;IACtC,kBAAkB,CAA6B;IAC/C,MAAM,CAAS;IAEhC;;;;;;;;OAQG;IACH,YACE,2BAAmC,EACnC,6BAAqC,EACrC,kBAA8C,EAC9C,MAAe;QAEf,IAAI,CAAC,2BAA2B,GAAG,2BAA2B,CAAC;QAC/D,IAAI,CAAC,6BAA6B,GAAG,6BAA6B,CAAC;QACnE,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;QAC7C,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,qBAAqB,CAAC,gCAAgC,CAAC,CAAC;IAClF,CAAC;IAED;;;;;;;;;OASG;IACH,OAAO,GAAG,CAAC,KAAa,EAAU,EAAE;QAClC,OAAO,IAAI,CAAC,4BAA4B,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC,CAAC;IAEF;;;;;;;;OAQG;IACK,4BAA4B,CAAC,KAAa;QAChD,MAAM,qBAAqB,GAAa,EAAE,CAAC;QAE3C,KAAK,MAAM,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAChE,IAAI,CAAC,KAAK,CAAC,YAA4B,CAAC,EAAE,CAAC;gBACzC,qBAAqB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QAED,IAAI,qBAAqB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,wCAAwC,IAAI,CAAC,6BAA6B,EAAE,EAC5E;gBACE,qBAAqB;gBACrB,UAAU,EAAE,IAAI,CAAC,6BAA6B;gBAC9C,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,MAAM;aAC3D,CACF,CAAC;YACF,OAAO,IAAI,CAAC,6BAA6B,CAAC;QAC5C,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,wCAAwC,IAAI,CAAC,2BAA2B,EAAE,EAAE;YAC5F,UAAU,EAAE,IAAI,CAAC,2BAA2B;YAC5C,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,MAAM;SAC7D,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,2BAA2B,CAAC;IAC1C,CAAC;CACF"}

package/dist/services/abstractService.d.ts

@@ -1,5 +1,5 @@
 import z from 'zod';
-import { MCPToolInvocationData } from '../common/metadata.js';
+import { InterruptData } from '../common/metadata.js';
 import { Logger } from '../logging/logger.js';
 import { ToolExecutor } from '../nodes/toolExecutor.js';
 /**
@@ -29,9 +29,9 @@ import { ToolExecutor } from '../nodes/toolExecutor.js';
  *   }
  *
  *   doSomething(input: string): ResultType {
- *     const toolInvocationData = { ... };
+ *     const interruptData = { ... };
  *     return this.executeToolWithLogging(
- *       toolInvocationData,
+ *       interruptData,
  *       MyToolResultSchema
  *     );
  *   }
@@ -59,7 +59,7 @@ export declare abstract class AbstractService {
      * This method uses the common toolExecutionUtils.executeToolWithLogging function
      * to ensure consistent behavior across all tool invocations in the codebase.
      *
-     * @param toolInvocationData - The tool invocation data to pass to the tool executor
+     * @param interruptData - The interrupt data (MCPToolInvocationData or NodeGuidanceData)
      * @param resultSchema - The schema to validate the result against
      * @param validator - Optional custom validator function
      * @returns The validated result from the tool execution
@@ -67,5 +67,5 @@ export declare abstract class AbstractService {
      * @throws {z.ZodError} If the result does not match the schema (when using default validation)
      * @throws {Error} If tool execution fails or custom validator throws
      */
-    protected executeToolWithLogging<TResultSchema extends z.ZodObject<z.ZodRawShape>>(toolInvocationData: MCPToolInvocationData<z.ZodObject<z.ZodRawShape>>, resultSchema: TResultSchema, validator?: (result: unknown, schema: TResultSchema) => z.infer<TResultSchema>): z.infer<TResultSchema>;
+    protected executeToolWithLogging<TResultSchema extends z.ZodObject<z.ZodRawShape>>(interruptData: InterruptData<z.ZodObject<z.ZodRawShape>, TResultSchema>, resultSchema: TResultSchema, validator?: (result: unknown, schema: TResultSchema) => z.infer<TResultSchema>): z.infer<TResultSchema>;
 }

package/dist/services/abstractService.js

@@ -34,9 +34,9 @@ import { executeToolWithLogging } from '../utils/toolExecutionUtils.js';
  *   }
  *
  *   doSomething(input: string): ResultType {
- *     const toolInvocationData = { ... };
+ *     const interruptData = { ... };
  *     return this.executeToolWithLogging(
- *       toolInvocationData,
+ *       interruptData,
  *       MyToolResultSchema
  *     );
  *   }
@@ -68,7 +68,7 @@ export class AbstractService {
      * This method uses the common toolExecutionUtils.executeToolWithLogging function
      * to ensure consistent behavior across all tool invocations in the codebase.
      *
-     * @param toolInvocationData - The tool invocation data to pass to the tool executor
+     * @param interruptData - The interrupt data (MCPToolInvocationData or NodeGuidanceData)
      * @param resultSchema - The schema to validate the result against
      * @param validator - Optional custom validator function
      * @returns The validated result from the tool execution
@@ -76,8 +76,8 @@ export class AbstractService {
      * @throws {z.ZodError} If the result does not match the schema (when using default validation)
      * @throws {Error} If tool execution fails or custom validator throws
      */
-    executeToolWithLogging(toolInvocationData, resultSchema, validator) {
-        return executeToolWithLogging(this.toolExecutor, this.logger, toolInvocationData, resultSchema, validator);
+    executeToolWithLogging(interruptData, resultSchema, validator) {
+        return executeToolWithLogging(this.toolExecutor, this.logger, interruptData, resultSchema, validator);
     }
 }
 //# sourceMappingURL=abstractService.js.map

package/dist/services/abstractService.js.map

@@ -1 +1 @@
-{"version":3,"file":"abstractService.js","sourceRoot":"","sources":["../../src/services/abstractService.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAU,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAgB,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,OAAgB,eAAe;IAChB,MAAM,CAAS;IACf,aAAa,CAAS;IACtB,YAAY,CAAe;IAE9C;;;;;;OAMG;IACH,YAAY,WAAmB,EAAE,YAA2B,EAAE,MAAe;QAC3E,IAAI,CAAC,aAAa,GAAG,WAAW,WAAW,EAAE,CAAC;QAC9C,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,qBAAqB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAClE,IAAI,CAAC,YAAY,GAAG,YAAY,IAAI,IAAI,qBAAqB,EAAE,CAAC;IAClE,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACO,sBAAsB,CAC9B,kBAAqE,EACrE,YAA2B,EAC3B,SAA8E;QAE9E,OAAO,sBAAsB,CAC3B,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,MAAM,EACX,kBAAkB,EAClB,YAAY,EACZ,SAAS,CACV,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"abstractService.js","sourceRoot":"","sources":["../../src/services/abstractService.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAU,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAgB,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,OAAgB,eAAe;IAChB,MAAM,CAAS;IACf,aAAa,CAAS;IACtB,YAAY,CAAe;IAE9C;;;;;;OAMG;IACH,YAAY,WAAmB,EAAE,YAA2B,EAAE,MAAe;QAC3E,IAAI,CAAC,aAAa,GAAG,WAAW,WAAW,EAAE,CAAC;QAC9C,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,qBAAqB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAClE,IAAI,CAAC,YAAY,GAAG,YAAY,IAAI,IAAI,qBAAqB,EAAE,CAAC;IAClE,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACO,sBAAsB,CAC9B,aAAuE,EACvE,YAA2B,EAC3B,SAA8E;QAE9E,OAAO,sBAAsB,CAC3B,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,MAAM,EACX,aAAa,EACb,YAAY,EACZ,SAAS,CACV,CAAC;IACJ,CAAC;CACF"}

package/dist/services/getInputService.d.ts

@@ -27,8 +27,9 @@ export interface GetInputServiceProvider {
 /**
  * Service for getting user input for a given question.
  *
- * This service extends AbstractService to leverage common tool execution
- * patterns including standardized logging and result validation.
+ * This service uses direct guidance mode (NodeGuidanceData) to have the orchestrator
+ * generate user input collection prompts directly, eliminating the need for an
+ * intermediate tool call.
  */
 export declare class GetInputService extends AbstractService implements GetInputServiceProvider {
     private readonly toolId;
@@ -40,4 +41,11 @@ export declare class GetInputService extends AbstractService implements GetInput
      */
     constructor(toolId: string, toolExecutor?: ToolExecutor, logger?: Logger);
     getInput(unfulfilledProperties: GetInputProperty[]): unknown;
+    /**
+     * Generates the task guidance for user input collection.
+     *
+     * @param properties - Array of properties requiring user input
+     * @returns The guidance prompt string
+     */
+    private generateTaskGuidance;
 }

package/dist/services/getInputService.js

@@ -5,12 +5,13 @@
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
 import { AbstractService } from './abstractService.js';
-import { createGetInputMetadata, GET_INPUT_WORKFLOW_RESULT_SCHEMA, } from '../tools/utilities/index.js';
+import { GET_INPUT_WORKFLOW_RESULT_SCHEMA } from '../tools/utilities/index.js';
 /**
  * Service for getting user input for a given question.
  *
- * This service extends AbstractService to leverage common tool execution
- * patterns including standardized logging and result validation.
+ * This service uses direct guidance mode (NodeGuidanceData) to have the orchestrator
+ * generate user input collection prompts directly, eliminating the need for an
+ * intermediate tool call.
  */
 export class GetInputService extends AbstractService {
     toolId;
@@ -28,21 +29,55 @@ export class GetInputService extends AbstractService {
         this.logger.debug('Starting input request with properties', {
             unfulfilledProperties,
         });
-        const metadata = createGetInputMetadata(this.toolId);
-        // Create tool invocation data
-        const toolInvocationData = {
-            llmMetadata: {
-                name: metadata.toolId,
-                description: metadata.description,
-                inputSchema: metadata.inputSchema,
-            },
-            input: {
-                propertiesRequiringInput: unfulfilledProperties,
-            },
+        // Build a concrete example based on the actual properties being requested
+        const exampleProperties = unfulfilledProperties.reduce((acc, prop) => {
+            acc[prop.propertyName] = `<user's ${prop.friendlyName} value>`;
+            return acc;
+        }, {});
+        // Create NodeGuidanceData for direct guidance mode
+        const nodeGuidanceData = {
+            nodeId: this.toolId,
+            taskGuidance: this.generateTaskGuidance(unfulfilledProperties),
+            resultSchema: GET_INPUT_WORKFLOW_RESULT_SCHEMA,
+            // Provide example to help LLM understand the expected userUtterance wrapper
+            exampleOutput: JSON.stringify({ userUtterance: exampleProperties }),
         };
         // Execute tool with logging and validation
-        const validatedResult = this.executeToolWithLogging(toolInvocationData, GET_INPUT_WORKFLOW_RESULT_SCHEMA);
+        const validatedResult = this.executeToolWithLogging(nodeGuidanceData, GET_INPUT_WORKFLOW_RESULT_SCHEMA);
         return validatedResult.userUtterance;
     }
+    /**
+     * Generates the task guidance for user input collection.
+     *
+     * @param properties - Array of properties requiring user input
+     * @returns The guidance prompt string
+     */
+    generateTaskGuidance(properties) {
+        const propertiesDescription = properties
+            .map(property => `- Property Name: ${property.propertyName}\n- Friendly Name: ${property.friendlyName}\n- Description: ${property.description}`)
+            .join('\n\n');
+        return `
+# ROLE
+You are an input gathering tool, responsible for explicitly requesting and gathering the
+user's input for a set of unfulfilled properties.
+
+# TASK
+Your job is to provide a prompt to the user that outlines the details for a set of properties
+that require the user's input. The prompt should be polite and conversational.
+
+# CONTEXT
+Here is the list of properties that require the user's input, along with their describing
+metadata:
+
+${propertiesDescription}
+
+# INSTRUCTIONS
+1. Based on the properties listed in "CONTEXT", generate a prompt that outlines the details
+   for each property.
+2. Present the prompt to the user and instruct the user to provide their input.
+3. **IMPORTANT:** YOU MUST NOW WAIT for the user to provide a follow-up response to your prompt.
+    1. You CANNOT PROCEED FROM THIS STEP until the user has provided THEIR OWN INPUT VALUE.
+`;
+    }
 }
 //# sourceMappingURL=getInputService.js.map

package/dist/services/getInputService.js.map

@@ -1 +1 @@
-{"version":3,"file":"getInputService.js","sourceRoot":"","sources":["../../src/services/getInputService.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EACL,sBAAsB,EAEtB,gCAAgC,GACjC,MAAM,6BAA6B,CAAC;AAgCrC;;;;;GAKG;AACH,MAAM,OAAO,eAAgB,SAAQ,eAAe;IAQ/B;IAPnB;;;;;OAKG;IACH,YACmB,MAAc,EAC/B,YAA2B,EAC3B,MAAe;QAEf,KAAK,CAAC,iBAAiB,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;QAJ9B,WAAM,GAAN,MAAM,CAAQ;IAKjC,CAAC;IAED,QAAQ,CAAC,qBAAyC;QAChD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,wCAAwC,EAAE;YAC1D,qBAAqB;SACtB,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,sBAAsB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrD,8BAA8B;QAC9B,MAAM,kBAAkB,GAAkE;YACxF,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ,CAAC,MAAM;gBACrB,WAAW,EAAE,QAAQ,CAAC,WAAW;gBACjC,WAAW,EAAE,QAAQ,CAAC,WAAW;aAClC;YACD,KAAK,EAAE;gBACL,wBAAwB,EAAE,qBAAqB;aAChD;SACF,CAAC;QAEF,2CAA2C;QAC3C,MAAM,eAAe,GAAG,IAAI,CAAC,sBAAsB,CACjD,kBAAkB,EAClB,gCAAgC,CACjC,CAAC;QAEF,OAAO,eAAe,CAAC,aAAa,CAAC;IACvC,CAAC;CACF"}
+{"version":3,"file":"getInputService.js","sourceRoot":"","sources":["../../src/services/getInputService.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,gCAAgC,EAAE,MAAM,6BAA6B,CAAC;AAgC/E;;;;;;GAMG;AACH,MAAM,OAAO,eAAgB,SAAQ,eAAe;IAQ/B;IAPnB;;;;;OAKG;IACH,YACmB,MAAc,EAC/B,YAA2B,EAC3B,MAAe;QAEf,KAAK,CAAC,iBAAiB,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;QAJ9B,WAAM,GAAN,MAAM,CAAQ;IAKjC,CAAC;IAED,QAAQ,CAAC,qBAAyC;QAChD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,wCAAwC,EAAE;YAC1D,qBAAqB;SACtB,CAAC,CAAC;QAEH,0EAA0E;QAC1E,MAAM,iBAAiB,GAAG,qBAAqB,CAAC,MAAM,CACpD,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;YACZ,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,WAAW,IAAI,CAAC,YAAY,SAAS,CAAC;YAC/D,OAAO,GAAG,CAAC;QACb,CAAC,EACD,EAA4B,CAC7B,CAAC;QAEF,mDAAmD;QACnD,MAAM,gBAAgB,GAA8D;YAClF,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,YAAY,EAAE,IAAI,CAAC,oBAAoB,CAAC,qBAAqB,CAAC;YAC9D,YAAY,EAAE,gCAAgC;YAC9C,4EAA4E;YAC5E,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,aAAa,EAAE,iBAAiB,EAAE,CAAC;SACpE,CAAC;QAEF,2CAA2C;QAC3C,MAAM,eAAe,GAAG,IAAI,CAAC,sBAAsB,CACjD,gBAAgB,EAChB,gCAAgC,CACjC,CAAC;QAEF,OAAO,eAAe,CAAC,aAAa,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACK,oBAAoB,CAAC,UAA8B;QACzD,MAAM,qBAAqB,GAAG,UAAU;aACrC,GAAG,CACF,QAAQ,CAAC,EAAE,CACT,oBAAoB,QAAQ,CAAC,YAAY,sBAAsB,QAAQ,CAAC,YAAY,oBAAoB,QAAQ,CAAC,WAAW,EAAE,CACjI;aACA,IAAI,CAAC,MAAM,CAAC,CAAC;QAEhB,OAAO;;;;;;;;;;;;;EAaT,qBAAqB;;;;;;;;CAQtB,CAAC;IACA,CAAC;CACF"}

package/dist/services/inputExtractionService.d.ts

@@ -26,8 +26,9 @@ export interface InputExtractionServiceProvider {
 /**
  * Service for extracting structured properties from user input.
  *
- * This service extends AbstractService to leverage common tool execution
- * patterns including standardized logging and result validation.
+ * This service uses direct guidance mode (NodeGuidanceData) to have the orchestrator
+ * generate property extraction prompts directly, eliminating the need for an
+ * intermediate tool call.
  */
 export declare class InputExtractionService extends AbstractService implements InputExtractionServiceProvider {
     private readonly toolId;
@@ -43,4 +44,12 @@ export declare class InputExtractionService extends AbstractService implements I
     private preparePropertiesForExtraction;
     private preparePropertyResultsSchema;
     private validateAndFilterResult;
+    /**
+     * Generates the task guidance for input extraction.
+     *
+     * @param userUtterance - The raw user input to analyze
+     * @param propertiesToExtract - Array of properties to extract
+     * @returns The guidance prompt string
+     */
+    private generateTaskGuidance;
 }