@salesforce/magen-mcp-workflow 0.0.1

package/dist/tools/utilities/getInput/metadata.d.ts

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+import { WorkflowToolMetadata } from '../../../common/metadata.js';
+/**
+ * Get Input Tool Input Schema
+ */
+export declare const GET_INPUT_PROPERTY_SCHEMA: z.ZodObject<{
+    propertyName: z.ZodString;
+    friendlyName: z.ZodString;
+    description: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    friendlyName: string;
+    propertyName: string;
+}, {
+    description: string;
+    friendlyName: string;
+    propertyName: string;
+}>;
+export declare const GET_INPUT_WORKFLOW_INPUT_SCHEMA: z.ZodObject<{
+    workflowStateData: z.ZodObject<{
+        thread_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        thread_id: string;
+    }, {
+        thread_id: string;
+    }>;
+} & {
+    propertiesRequiringInput: z.ZodArray<z.ZodObject<{
+        propertyName: z.ZodString;
+        friendlyName: z.ZodString;
+        description: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        friendlyName: string;
+        propertyName: string;
+    }, {
+        description: string;
+        friendlyName: string;
+        propertyName: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    workflowStateData: {
+        thread_id: string;
+    };
+    propertiesRequiringInput: {
+        description: string;
+        friendlyName: string;
+        propertyName: string;
+    }[];
+}, {
+    workflowStateData: {
+        thread_id: string;
+    };
+    propertiesRequiringInput: {
+        description: string;
+        friendlyName: string;
+        propertyName: string;
+    }[];
+}>;
+export declare const GET_INPUT_WORKFLOW_RESULT_SCHEMA: z.ZodObject<{
+    userUtterance: z.ZodUnknown;
+}, "strip", z.ZodTypeAny, {
+    userUtterance?: unknown;
+}, {
+    userUtterance?: unknown;
+}>;
+export type GetInputWorkflowInput = z.infer<typeof GET_INPUT_WORKFLOW_INPUT_SCHEMA>;
+/**
+ * Get Input Tool Metadata Type
+ */
+export type GetInputToolMetadata = WorkflowToolMetadata<typeof GET_INPUT_WORKFLOW_INPUT_SCHEMA, typeof GET_INPUT_WORKFLOW_RESULT_SCHEMA>;
+/**
+ * Factory function to create Get Input Tool metadata with a dynamic tool ID
+ *
+ * @param toolId - The unique identifier for the tool (e.g., 'magen-get-input', 'mobile-magen-get-input')
+ * @returns Tool metadata object for Get Input Tool
+ */
+export declare function createGetInputMetadata(toolId: string): GetInputToolMetadata;

package/dist/tools/utilities/getInput/metadata.js

@@ -0,0 +1,43 @@
+/*
+ * Copyright (c) 2025, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: MIT
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
+ */
+import { z } from 'zod';
+import { WORKFLOW_TOOL_BASE_INPUT_SCHEMA, MCP_WORKFLOW_TOOL_OUTPUT_SCHEMA, } from '../../../common/metadata.js';
+/**
+ * Get Input Tool Input Schema
+ */
+export const GET_INPUT_PROPERTY_SCHEMA = z
+    .object({
+    propertyName: z.string().describe('The name of the property'),
+    friendlyName: z.string().describe('The friendly name of the property'),
+    description: z.string().describe('The description of the property'),
+})
+    .describe('The metadata for the property to be queried, used to formulate a prompting question for input');
+export const GET_INPUT_WORKFLOW_INPUT_SCHEMA = WORKFLOW_TOOL_BASE_INPUT_SCHEMA.extend({
+    propertiesRequiringInput: z
+        .array(GET_INPUT_PROPERTY_SCHEMA)
+        .describe('The metadata for the properties that require input from the user'),
+});
+export const GET_INPUT_WORKFLOW_RESULT_SCHEMA = z.object({
+    userUtterance: z.unknown().describe("The user's response to the question"),
+});
+/**
+ * Factory function to create Get Input Tool metadata with a dynamic tool ID
+ *
+ * @param toolId - The unique identifier for the tool (e.g., 'magen-get-input', 'mobile-magen-get-input')
+ * @returns Tool metadata object for Get Input Tool
+ */
+export function createGetInputMetadata(toolId) {
+    return {
+        toolId,
+        title: 'Get User Input',
+        description: 'Provides a prompt to the user to elicit their input for a set of properties',
+        inputSchema: GET_INPUT_WORKFLOW_INPUT_SCHEMA,
+        outputSchema: MCP_WORKFLOW_TOOL_OUTPUT_SCHEMA,
+        resultSchema: GET_INPUT_WORKFLOW_RESULT_SCHEMA,
+    };
+}
+//# sourceMappingURL=metadata.js.map

package/dist/tools/utilities/getInput/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../../src/tools/utilities/getInput/metadata.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,+BAA+B,EAC/B,+BAA+B,GAEhC,MAAM,6BAA6B,CAAC;AAErC;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC;KACvC,MAAM,CAAC;IACN,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IAC7D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IACtE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;CACpE,CAAC;KACD,QAAQ,CACP,+FAA+F,CAChG,CAAC;AAEJ,MAAM,CAAC,MAAM,+BAA+B,GAAG,+BAA+B,CAAC,MAAM,CAAC;IACpF,wBAAwB,EAAE,CAAC;SACxB,KAAK,CAAC,yBAAyB,CAAC;SAChC,QAAQ,CAAC,kEAAkE,CAAC;CAChF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,CAAC;IACvD,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;CAC3E,CAAC,CAAC;AAYH;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAc;IACnD,OAAO;QACL,MAAM;QACN,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,6EAA6E;QAC1F,WAAW,EAAE,+BAA+B;QAC5C,YAAY,EAAE,+BAA+B;QAC7C,YAAY,EAAE,gCAAgC;KACtC,CAAC;AACb,CAAC"}

package/dist/tools/utilities/getInput/tool.d.ts

@@ -0,0 +1,89 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { Logger } from '../../../logging/logger.js';
+import { GetInputWorkflowInput, GetInputToolMetadata } from './metadata.js';
+import { AbstractWorkflowTool } from '../../base/abstractWorkflowTool.js';
+export declare class GetInputTool extends AbstractWorkflowTool<GetInputToolMetadata> {
+    constructor(server: McpServer, toolId: string, orchestratorToolId: string, logger?: Logger);
+    handleRequest: (input: GetInputWorkflowInput) => Promise<{
+        [x: string]: unknown;
+        content: ({
+            [x: string]: unknown;
+            type: "text";
+            text: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "image";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "audio";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource_link";
+            name: string;
+            uri: string;
+            description?: string | undefined;
+            title?: string | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            mimeType?: string | undefined;
+            icons?: {
+                [x: string]: unknown;
+                src: string;
+                mimeType?: string | undefined;
+                sizes?: string[] | undefined;
+            }[] | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource";
+            resource: {
+                [x: string]: unknown;
+                text: string;
+                uri: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            } | {
+                [x: string]: unknown;
+                uri: string;
+                blob: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            };
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        })[];
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        structuredContent?: {
+            [x: string]: unknown;
+        } | undefined;
+        isError?: boolean | undefined;
+    }>;
+    private generatePromptForInputGuidance;
+    /**
+     * Creates a "prompt-friendly" description of the properties requiring input, for inclusion
+     * in the prompt to the LLM.
+     * @param input The input to the tool, containing the properties requiring input
+     * @returns A "prompt-friendly" description of the properties requiring input
+     */
+    private generatePropertiesDescription;
+}

package/dist/tools/utilities/getInput/tool.js

@@ -0,0 +1,69 @@
+/*
+ * Copyright (c) 2025, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: MIT
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
+ */
+import { createGetInputMetadata } from './metadata.js';
+import { AbstractWorkflowTool } from '../../base/abstractWorkflowTool.js';
+export class GetInputTool extends AbstractWorkflowTool {
+    constructor(server, toolId, orchestratorToolId, logger) {
+        super(server, createGetInputMetadata(toolId), orchestratorToolId, 'GetInputTool', logger);
+    }
+    handleRequest = async (input) => {
+        try {
+            const guidance = this.generatePromptForInputGuidance(input);
+            return this.finalizeWorkflowToolOutput(guidance, input.workflowStateData);
+        }
+        catch (error) {
+            const toolError = error instanceof Error ? error : new Error('Unknown error occurred');
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${toolError.message}`,
+                    },
+                ],
+            };
+        }
+    };
+    generatePromptForInputGuidance(input) {
+        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:
+
+${this.generatePropertiesDescription(input)}
+
+# 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.
+4. Follow the the "Post-Tool-Invocation" instructions below, to return the user's
+   response to the orchestrator for further processing.
+`;
+    }
+    /**
+     * Creates a "prompt-friendly" description of the properties requiring input, for inclusion
+     * in the prompt to the LLM.
+     * @param input The input to the tool, containing the properties requiring input
+     * @returns A "prompt-friendly" description of the properties requiring input
+     */
+    generatePropertiesDescription(input) {
+        return input.propertiesRequiringInput
+            .map(property => `- Property Name: ${property.propertyName}\n- Friendly Name: ${property.friendlyName}\n- Description: ${property.description}`)
+            .join('\n\n');
+    }
+}
+//# sourceMappingURL=tool.js.map

package/dist/tools/utilities/getInput/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../../src/tools/utilities/getInput/tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAA+C,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACpG,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAE1E,MAAM,OAAO,YAAa,SAAQ,oBAA0C;IAC1E,YAAY,MAAiB,EAAE,MAAc,EAAE,kBAA0B,EAAE,MAAe;QACxF,KAAK,CAAC,MAAM,EAAE,sBAAsB,CAAC,MAAM,CAAC,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;IAC5F,CAAC;IAEM,aAAa,GAAG,KAAK,EAAE,KAA4B,EAAE,EAAE;QAC5D,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,8BAA8B,CAAC,KAAK,CAAC,CAAC;YAC5D,OAAO,IAAI,CAAC,0BAA0B,CAAC,QAAQ,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAC5E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;YACvF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,UAAU,SAAS,CAAC,OAAO,EAAE;qBACpC;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;IAEM,8BAA8B,CAAC,KAA4B;QACjE,OAAO;;;;;;;;;;;;;EAaT,IAAI,CAAC,6BAA6B,CAAC,KAAK,CAAC;;;;;;;;;;CAU1C,CAAC;IACA,CAAC;IAED;;;;;OAKG;IACK,6BAA6B,CAAC,KAA4B;QAChE,OAAO,KAAK,CAAC,wBAAwB;aAClC,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;IAClB,CAAC;CACF"}

package/dist/tools/utilities/index.d.ts

@@ -0,0 +1,2 @@
+export * from './getInput/index.js';
+export * from './inputExtraction/index.js';

package/dist/tools/utilities/index.js

@@ -0,0 +1,9 @@
+/*
+ * Copyright (c) 2025, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: MIT
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
+ */
+export * from './getInput/index.js';
+export * from './inputExtraction/index.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/utilities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/utilities/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC"}

package/dist/tools/utilities/inputExtraction/factory.d.ts

@@ -0,0 +1,43 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { Logger } from '../../../logging/logger.js';
+import { InputExtractionTool } from './tool.js';
+/**
+ * Configuration options for creating an Input Extraction Tool
+ */
+export interface InputExtractionToolOptions {
+    /**
+     * The tool ID to use for the input extraction tool
+     */
+    toolId: string;
+    /**
+     * Orchestrator tool ID that this tool reports back to
+     * @required
+     */
+    orchestratorToolId: string;
+    /**
+     * Optional logger instance for tool operations
+     */
+    logger?: Logger;
+}
+/**
+ * Factory function to create an Input Extraction Tool with configurable tool ID
+ *
+ * @param server - The MCP server instance
+ * @param options - Configuration options for the tool
+ * @returns A configured Input Extraction Tool instance ready for registration
+ *
+ * @example
+ * // Simple case - single MCP server
+ * const inputExtractionTool = createInputExtractionTool(server, {
+ *   toolId: 'magen-input-extraction',
+ *   orchestratorToolId: 'my-orchestrator',
+ * });
+ *
+ * @example
+ * // Multi-server environment - avoid collisions
+ * const inputExtractionTool = createInputExtractionTool(server, {
+ *   toolId: 'mobile-magen-input-extraction',
+ *   orchestratorToolId: 'mobile-orchestrator',
+ * });
+ */
+export declare function createInputExtractionTool(server: McpServer, options: InputExtractionToolOptions): InputExtractionTool;

package/dist/tools/utilities/inputExtraction/factory.js

@@ -0,0 +1,32 @@
+/*
+ * Copyright (c) 2025, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: MIT
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
+ */
+import { InputExtractionTool } from './tool.js';
+/**
+ * Factory function to create an Input Extraction Tool with configurable tool ID
+ *
+ * @param server - The MCP server instance
+ * @param options - Configuration options for the tool
+ * @returns A configured Input Extraction Tool instance ready for registration
+ *
+ * @example
+ * // Simple case - single MCP server
+ * const inputExtractionTool = createInputExtractionTool(server, {
+ *   toolId: 'magen-input-extraction',
+ *   orchestratorToolId: 'my-orchestrator',
+ * });
+ *
+ * @example
+ * // Multi-server environment - avoid collisions
+ * const inputExtractionTool = createInputExtractionTool(server, {
+ *   toolId: 'mobile-magen-input-extraction',
+ *   orchestratorToolId: 'mobile-orchestrator',
+ * });
+ */
+export function createInputExtractionTool(server, options) {
+    return new InputExtractionTool(server, options.toolId, options.orchestratorToolId, options.logger);
+}
+//# sourceMappingURL=factory.js.map

package/dist/tools/utilities/inputExtraction/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../src/tools/utilities/inputExtraction/factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAuBhD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAiB,EACjB,OAAmC;IAEnC,OAAO,IAAI,mBAAmB,CAC5B,MAAM,EACN,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,kBAAkB,EAC1B,OAAO,CAAC,MAAM,CACf,CAAC;AACJ,CAAC"}

package/dist/tools/utilities/inputExtraction/index.d.ts

@@ -0,0 +1,3 @@
+export * from './tool.js';
+export * from './metadata.js';
+export * from './factory.js';

package/dist/tools/utilities/inputExtraction/index.js

@@ -0,0 +1,10 @@
+/*
+ * Copyright (c) 2025, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: MIT
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
+ */
+export * from './tool.js';
+export * from './metadata.js';
+export * from './factory.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/utilities/inputExtraction/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/utilities/inputExtraction/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC"}

package/dist/tools/utilities/inputExtraction/metadata.d.ts

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+import { WorkflowToolMetadata } from '../../../common/metadata.js';
+/**
+ * Input Extraction Tool Input Schema
+ */
+export declare const INPUT_EXTRACTION_WORKFLOW_INPUT_SCHEMA: z.ZodObject<{
+    workflowStateData: z.ZodObject<{
+        thread_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        thread_id: string;
+    }, {
+        thread_id: string;
+    }>;
+} & {
+    userUtterance: z.ZodUnknown;
+    propertiesToExtract: z.ZodArray<z.ZodObject<{
+        propertyName: z.ZodString;
+        description: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        propertyName: string;
+    }, {
+        description: string;
+        propertyName: string;
+    }>, "many">;
+    resultSchema: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    workflowStateData: {
+        thread_id: string;
+    };
+    resultSchema: string;
+    propertiesToExtract: {
+        description: string;
+        propertyName: string;
+    }[];
+    userUtterance?: unknown;
+}, {
+    workflowStateData: {
+        thread_id: string;
+    };
+    resultSchema: string;
+    propertiesToExtract: {
+        description: string;
+        propertyName: string;
+    }[];
+    userUtterance?: unknown;
+}>;
+export declare const INPUT_EXTRACTION_WORKFLOW_RESULT_SCHEMA: z.ZodObject<{
+    resultSchema: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    resultSchema: string;
+}, {
+    resultSchema: string;
+}>;
+export type InputExtractionWorkflowInput = z.infer<typeof INPUT_EXTRACTION_WORKFLOW_INPUT_SCHEMA>;
+/**
+ * Input Extraction Tool Metadata Type
+ */
+export type InputExtractionToolMetadata = WorkflowToolMetadata<typeof INPUT_EXTRACTION_WORKFLOW_INPUT_SCHEMA, typeof INPUT_EXTRACTION_WORKFLOW_RESULT_SCHEMA>;
+/**
+ * Factory function to create Input Extraction Tool metadata with a dynamic tool ID
+ *
+ * @param toolId - The unique identifier for the tool (e.g., 'magen-input-extraction', 'mobile-magen-input-extraction')
+ * @returns Tool metadata object for Input Extraction Tool
+ */
+export declare function createInputExtractionMetadata(toolId: string): InputExtractionToolMetadata;

package/dist/tools/utilities/inputExtraction/metadata.js

@@ -0,0 +1,52 @@
+/*
+ * Copyright (c) 2025, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: MIT
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
+ */
+import { z } from 'zod';
+import { WORKFLOW_TOOL_BASE_INPUT_SCHEMA, MCP_WORKFLOW_TOOL_OUTPUT_SCHEMA, } from '../../../common/metadata.js';
+/**
+ * Input Extraction Tool Input Schema
+ */
+export const INPUT_EXTRACTION_WORKFLOW_INPUT_SCHEMA = WORKFLOW_TOOL_BASE_INPUT_SCHEMA.extend({
+    userUtterance: z
+        .unknown()
+        .describe('Raw user input - can be text, structured data, or any format describing their request'),
+    propertiesToExtract: z
+        .array(z
+        .object({
+        propertyName: z.string().describe('The name of the property'),
+        description: z.string().describe('The description of the property'),
+    })
+        .describe('The name of the property and its description to correlate with the user input'))
+        .describe('The array of properties to extract from the user input'),
+    resultSchema: z
+        .string()
+        .describe('The JSON schema definining the extracted properties structure, as a string'),
+});
+// NOTE: This is a nominal definition, as the actual schema is dynamic, and needs to come
+// through the input schema. Having this defined is an artifact of needing to reconsider
+// our design for schema representation in our server tools.
+export const INPUT_EXTRACTION_WORKFLOW_RESULT_SCHEMA = z.object({
+    resultSchema: z
+        .string()
+        .describe('The JSON schema definining the extracted properties structure, as a string'),
+});
+/**
+ * Factory function to create Input Extraction Tool metadata with a dynamic tool ID
+ *
+ * @param toolId - The unique identifier for the tool (e.g., 'magen-input-extraction', 'mobile-magen-input-extraction')
+ * @returns Tool metadata object for Input Extraction Tool
+ */
+export function createInputExtractionMetadata(toolId) {
+    return {
+        toolId,
+        title: 'Input Extraction',
+        description: 'Parses user input and extracts structured project properties',
+        inputSchema: INPUT_EXTRACTION_WORKFLOW_INPUT_SCHEMA,
+        outputSchema: MCP_WORKFLOW_TOOL_OUTPUT_SCHEMA,
+        resultSchema: INPUT_EXTRACTION_WORKFLOW_RESULT_SCHEMA,
+    };
+}
+//# sourceMappingURL=metadata.js.map

package/dist/tools/utilities/inputExtraction/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../../src/tools/utilities/inputExtraction/metadata.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,+BAA+B,EAC/B,+BAA+B,GAEhC,MAAM,6BAA6B,CAAC;AAErC;;GAEG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAG,+BAA+B,CAAC,MAAM,CAAC;IAC3F,aAAa,EAAE,CAAC;SACb,OAAO,EAAE;SACT,QAAQ,CACP,uFAAuF,CACxF;IACH,mBAAmB,EAAE,CAAC;SACnB,KAAK,CACJ,CAAC;SACE,MAAM,CAAC;QACN,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;QAC7D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;KACpE,CAAC;SACD,QAAQ,CAAC,+EAA+E,CAAC,CAC7F;SACA,QAAQ,CAAC,wDAAwD,CAAC;IACrE,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,QAAQ,CAAC,4EAA4E,CAAC;CAC1F,CAAC,CAAC;AAEH,yFAAyF;AACzF,wFAAwF;AACxF,4DAA4D;AAC5D,MAAM,CAAC,MAAM,uCAAuC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9D,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,QAAQ,CAAC,4EAA4E,CAAC;CAC1F,CAAC,CAAC;AAYH;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAAC,MAAc;IAC1D,OAAO;QACL,MAAM;QACN,KAAK,EAAE,kBAAkB;QACzB,WAAW,EAAE,8DAA8D;QAC3E,WAAW,EAAE,sCAAsC;QACnD,YAAY,EAAE,+BAA+B;QAC7C,YAAY,EAAE,uCAAuC;KAC7C,CAAC;AACb,CAAC"}

package/dist/tools/utilities/inputExtraction/tool.d.ts

@@ -0,0 +1,82 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { Logger } from '../../../logging/logger.js';
+import { InputExtractionWorkflowInput, InputExtractionToolMetadata } from './metadata.js';
+import { AbstractWorkflowTool } from '../../base/abstractWorkflowTool.js';
+export declare class InputExtractionTool extends AbstractWorkflowTool<InputExtractionToolMetadata> {
+    constructor(server: McpServer, toolId: string, orchestratorToolId: string, logger?: Logger);
+    handleRequest: (input: InputExtractionWorkflowInput) => Promise<{
+        [x: string]: unknown;
+        content: ({
+            [x: string]: unknown;
+            type: "text";
+            text: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "image";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "audio";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource_link";
+            name: string;
+            uri: string;
+            description?: string | undefined;
+            title?: string | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            mimeType?: string | undefined;
+            icons?: {
+                [x: string]: unknown;
+                src: string;
+                mimeType?: string | undefined;
+                sizes?: string[] | undefined;
+            }[] | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource";
+            resource: {
+                [x: string]: unknown;
+                text: string;
+                uri: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            } | {
+                [x: string]: unknown;
+                uri: string;
+                blob: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            };
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        })[];
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        structuredContent?: {
+            [x: string]: unknown;
+        } | undefined;
+        isError?: boolean | undefined;
+    }>;
+    private generateInputExtractionGuidance;
+}