@salesforce/magen-mcp-workflow 0.0.1 → 0.0.3

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

@@ -1,66 +0,0 @@
-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

@@ -1,52 +0,0 @@
-/*
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,82 +0,0 @@
-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;
-}

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

@@ -1,71 +0,0 @@
-/*
- * 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 { createInputExtractionMetadata, } from './metadata.js';
-import { AbstractWorkflowTool } from '../../base/abstractWorkflowTool.js';
-export class InputExtractionTool extends AbstractWorkflowTool {
-    constructor(server, toolId, orchestratorToolId, logger) {
-        super(server, createInputExtractionMetadata(toolId), orchestratorToolId, 'InputExtractionTool', logger);
-    }
-    handleRequest = async (input) => {
-        try {
-            const guidance = this.generateInputExtractionGuidance(input);
-            return this.finalizeWorkflowToolOutput(guidance, input.workflowStateData, input.resultSchema);
-        }
-        catch (error) {
-            const toolError = error instanceof Error ? error : new Error('Unknown error occurred');
-            return {
-                isError: true,
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${toolError.message}`,
-                    },
-                ],
-            };
-        }
-    };
-    generateInputExtractionGuidance(input) {
-        return `
-# ROLE
-You are a highly accurate and precise data extraction tool.
-
-# TASK
-
-Your task is to analyze a user utterance and extract values for a given list of properties.
-For each property you are asked to find, you must provide its extracted value or \`null\`
-if no value is found.
-
----
-# CONTEXT
-
-## USER UTTERANCE TO ANALYZE
-${JSON.stringify(input.userUtterance)}
-
-## PROPERTIES TO EXTRACT
-Here is the list of properties you need to find values for. Use each property's description
-to understand what to look for.
-
-\`\`\`json
-${JSON.stringify(input.propertiesToExtract)}
-\`\`\`
-
----
-# INSTRUCTIONS
-1. Carefully read the "USER UTTERANCE TO ANALYZE".
-2. For each property listed in "PROPERTIES TO EXTRACT", search the text for a  
-   corresponding value.
-3. If a clear value is found for a property, place it in your output.
-4. If a property's value is not ABSOLUTELY INFERABLE from USER UTTERANCE TO ANALYZE, you
-   MUST use \`null\` as the value for that property. You MAY NOT infer your own property
-   values, in the absence of their clear specification in the USER UTTERANCE TO ANALYZE.
-5. Ensure the keys in your output JSON object exactly match the \`propertyName\` values  
-   from the input list.
-6. The exact format of your output object will be given in the section below.
-`;
-    }
-}
-//# sourceMappingURL=tool.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../../src/tools/utilities/inputExtraction/tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAGL,6BAA6B,GAC9B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAE1E,MAAM,OAAO,mBAAoB,SAAQ,oBAAiD;IACxF,YAAY,MAAiB,EAAE,MAAc,EAAE,kBAA0B,EAAE,MAAe;QACxF,KAAK,CACH,MAAM,EACN,6BAA6B,CAAC,MAAM,CAAC,EACrC,kBAAkB,EAClB,qBAAqB,EACrB,MAAM,CACP,CAAC;IACJ,CAAC;IAEM,aAAa,GAAG,KAAK,EAAE,KAAmC,EAAE,EAAE;QACnE,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,+BAA+B,CAAC,KAAK,CAAC,CAAC;YAC7D,OAAO,IAAI,CAAC,0BAA0B,CAAC,QAAQ,EAAE,KAAK,CAAC,iBAAiB,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;QAChG,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,+BAA+B,CAAC,KAAmC;QACzE,OAAO;;;;;;;;;;;;;;EAcT,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,aAAa,CAAC;;;;;;;EAOnC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,mBAAmB,CAAC;;;;;;;;;;;;;;;CAe1C,CAAC;IACA,CAAC;CACF"}