@vinkius-core/mcp-fusion-aws 1.0.0

package/dist/AwsClient.d.ts

@@ -0,0 +1,109 @@
+import type { LambdaInvokeResult, SfnSyncResult, SfnAsyncResult } from './types.js';
+/**
+ * Minimal wrapper around the AWS SDK Lambda and Step Functions clients.
+ *
+ * Accepts pre-configured adapter instances (IoC for enterprise).
+ * Adapters abstract away the AWS SDK Command pattern, letting
+ * the rest of the codebase focus on business logic.
+ *
+ * **Why adapters instead of raw SDK clients?**
+ * AWS SDK v3 uses `client.send(new Command(input))`.
+ * Adapters encapsulate this pattern, keeping the surface clean
+ * and testable via simple interface mocks.
+ */
+export declare class AwsClient {
+    private readonly lambda;
+    private readonly sfn;
+    constructor(lambda: LambdaAdapter | undefined, sfn: SfnAdapter | undefined);
+    /** List all Lambda functions (paginated) */
+    listLambdaFunctions(): Promise<LambdaFunctionSummary[]>;
+    /** Get tags for a Lambda function by ARN */
+    getLambdaTags(arn: string): Promise<Record<string, string>>;
+    /** Invoke a Lambda function synchronously (RequestResponse) */
+    invokeLambda(arn: string, payload: unknown): Promise<LambdaInvokeResult>;
+    /** List all Step Functions state machines (paginated) */
+    listStateMachines(): Promise<SfnStateMachineSummary[]>;
+    /** Get tags for a Step Function */
+    getStateMachineTags(arn: string): Promise<Record<string, string>>;
+    /** Describe a Step Function state machine */
+    describeStateMachine(arn: string): Promise<{
+        description: string;
+        type: string;
+    }>;
+    /** Start a synchronous execution (Express Step Functions) */
+    startSyncExecution(arn: string, input: unknown): Promise<SfnSyncResult>;
+    /** Start an asynchronous execution (Standard Step Functions) */
+    startExecution(arn: string, input: unknown): Promise<SfnAsyncResult>;
+    private requireLambda;
+    private requireSfn;
+}
+/**
+ * Adapter interface for Lambda SDK interactions.
+ * Users create these via `createLambdaAdapter()`.
+ */
+export interface LambdaAdapter {
+    listFunctions(): Promise<LambdaFunctionSummary[]>;
+    listTags(arn: string): Promise<Record<string, string>>;
+    invoke(arn: string, payload: unknown): Promise<LambdaInvokeResult>;
+}
+/**
+ * Adapter interface for Step Functions SDK interactions.
+ * Users create these via `createSfnAdapter()`.
+ */
+export interface SfnAdapter {
+    listStateMachines(): Promise<SfnStateMachineSummary[]>;
+    listTags(arn: string): Promise<Record<string, string>>;
+    describe(arn: string): Promise<{
+        description: string;
+        type: string;
+    }>;
+    startSync(arn: string, input: unknown): Promise<SfnSyncResult>;
+    startAsync(arn: string, input: unknown): Promise<SfnAsyncResult>;
+}
+/** Summarized Lambda function from discovery */
+export interface LambdaFunctionSummary {
+    readonly functionName: string;
+    readonly functionArn: string;
+    readonly description: string;
+    readonly runtime: string;
+}
+/** Summarized Step Function state machine from discovery */
+export interface SfnStateMachineSummary {
+    readonly name: string;
+    readonly stateMachineArn: string;
+    /** State machine type — available from ListStateMachines directly */
+    readonly type: string;
+}
+/**
+ * Create a Lambda adapter from a real AWS SDK v3 `LambdaClient`.
+ *
+ * Uses `client.send(new Command())` pattern — compatible with the real SDK.
+ * Requires `@aws-sdk/client-lambda` to be installed (Command classes
+ * are dynamically imported at runtime).
+ *
+ * ```typescript
+ * import { LambdaClient } from '@aws-sdk/client-lambda';
+ * const adapter = await createLambdaAdapter(new LambdaClient({ region: 'us-east-1' }));
+ * ```
+ */
+export declare function createLambdaAdapter(client: AwsSdkClientLike): Promise<LambdaAdapter>;
+/**
+ * Create a Step Functions adapter from a real AWS SDK v3 `SFNClient`.
+ *
+ * Uses `client.send(new Command())` pattern — compatible with the real SDK.
+ * Requires `@aws-sdk/client-sfn` to be installed.
+ *
+ * ```typescript
+ * import { SFNClient } from '@aws-sdk/client-sfn';
+ * const adapter = await createSfnAdapter(new SFNClient({ region: 'us-east-1' }));
+ * ```
+ */
+export declare function createSfnAdapter(client: AwsSdkClientLike): Promise<SfnAdapter>;
+/**
+ * Minimal duck-type for an AWS SDK v3 client.
+ * Both `LambdaClient` and `SFNClient` satisfy this interface.
+ */
+export interface AwsSdkClientLike {
+    send(command: unknown): Promise<unknown>;
+}
+//# sourceMappingURL=AwsClient.d.ts.map

package/dist/AwsClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AwsClient.d.ts","sourceRoot":"","sources":["../src/AwsClient.ts"],"names":[],"mappings":"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"}

package/dist/AwsClient.js

@@ -0,0 +1,220 @@
+// ============================================================================
+// AwsClient — Wrapper for AWS SDK Lambda & Step Functions APIs
+// ============================================================================
+/**
+ * Minimal wrapper around the AWS SDK Lambda and Step Functions clients.
+ *
+ * Accepts pre-configured adapter instances (IoC for enterprise).
+ * Adapters abstract away the AWS SDK Command pattern, letting
+ * the rest of the codebase focus on business logic.
+ *
+ * **Why adapters instead of raw SDK clients?**
+ * AWS SDK v3 uses `client.send(new Command(input))`.
+ * Adapters encapsulate this pattern, keeping the surface clean
+ * and testable via simple interface mocks.
+ */
+export class AwsClient {
+    lambda;
+    sfn;
+    constructor(lambda, sfn) {
+        this.lambda = lambda;
+        this.sfn = sfn;
+    }
+    // ── Lambda ───────────────────────────────────────────
+    /** List all Lambda functions (paginated) */
+    async listLambdaFunctions() {
+        return this.requireLambda().listFunctions();
+    }
+    /** Get tags for a Lambda function by ARN */
+    async getLambdaTags(arn) {
+        return this.requireLambda().listTags(arn);
+    }
+    /** Invoke a Lambda function synchronously (RequestResponse) */
+    async invokeLambda(arn, payload) {
+        return this.requireLambda().invoke(arn, payload);
+    }
+    // ── Step Functions ────────────────────────────────────
+    /** List all Step Functions state machines (paginated) */
+    async listStateMachines() {
+        return this.requireSfn().listStateMachines();
+    }
+    /** Get tags for a Step Function */
+    async getStateMachineTags(arn) {
+        return this.requireSfn().listTags(arn);
+    }
+    /** Describe a Step Function state machine */
+    async describeStateMachine(arn) {
+        return this.requireSfn().describe(arn);
+    }
+    /** Start a synchronous execution (Express Step Functions) */
+    async startSyncExecution(arn, input) {
+        return this.requireSfn().startSync(arn, input);
+    }
+    /** Start an asynchronous execution (Standard Step Functions) */
+    async startExecution(arn, input) {
+        return this.requireSfn().startAsync(arn, input);
+    }
+    // ── Internal ─────────────────────────────────────────
+    requireLambda() {
+        if (!this.lambda) {
+            throw new Error('AwsClient: Lambda adapter not configured. ' +
+                'Pass a LambdaAdapter via createLambdaAdapter() in your connector config.');
+        }
+        return this.lambda;
+    }
+    requireSfn() {
+        if (!this.sfn) {
+            throw new Error('AwsClient: Step Functions adapter not configured. ' +
+                'Pass an SfnAdapter via createSfnAdapter() in your connector config.');
+        }
+        return this.sfn;
+    }
+}
+// ── Adapter Factories ────────────────────────────────────
+/**
+ * Create a Lambda adapter from a real AWS SDK v3 `LambdaClient`.
+ *
+ * Uses `client.send(new Command())` pattern — compatible with the real SDK.
+ * Requires `@aws-sdk/client-lambda` to be installed (Command classes
+ * are dynamically imported at runtime).
+ *
+ * ```typescript
+ * import { LambdaClient } from '@aws-sdk/client-lambda';
+ * const adapter = await createLambdaAdapter(new LambdaClient({ region: 'us-east-1' }));
+ * ```
+ */
+export async function createLambdaAdapter(client) {
+    const { ListFunctionsCommand, ListTagsCommand, InvokeCommand, } = await import('@aws-sdk/client-lambda');
+    return {
+        async listFunctions() {
+            const functions = [];
+            let marker;
+            do {
+                const response = await client.send(new ListFunctionsCommand({ Marker: marker }));
+                const fns = response.Functions ?? [];
+                for (const fn of fns) {
+                    functions.push({
+                        functionName: fn.FunctionName ?? '',
+                        functionArn: fn.FunctionArn ?? '',
+                        description: fn.Description ?? '',
+                        runtime: fn.Runtime ?? 'unknown',
+                    });
+                }
+                marker = response.NextMarker;
+            } while (marker);
+            return functions;
+        },
+        async listTags(arn) {
+            const response = await client.send(new ListTagsCommand({ Resource: arn }));
+            return response.Tags ?? {};
+        },
+        async invoke(arn, payload) {
+            const response = await client.send(new InvokeCommand({
+                FunctionName: arn,
+                InvocationType: 'RequestResponse',
+                Payload: new TextEncoder().encode(JSON.stringify(payload ?? {})),
+            }));
+            const rawPayload = response.Payload
+                ? new TextDecoder().decode(response.Payload)
+                : 'null';
+            let parsed;
+            try {
+                parsed = JSON.parse(rawPayload);
+            }
+            catch {
+                parsed = rawPayload;
+            }
+            return {
+                statusCode: response.StatusCode ?? 200,
+                payload: parsed,
+                functionError: response.FunctionError,
+                logResult: response.LogResult,
+            };
+        },
+    };
+}
+/**
+ * Create a Step Functions adapter from a real AWS SDK v3 `SFNClient`.
+ *
+ * Uses `client.send(new Command())` pattern — compatible with the real SDK.
+ * Requires `@aws-sdk/client-sfn` to be installed.
+ *
+ * ```typescript
+ * import { SFNClient } from '@aws-sdk/client-sfn';
+ * const adapter = await createSfnAdapter(new SFNClient({ region: 'us-east-1' }));
+ * ```
+ */
+export async function createSfnAdapter(client) {
+    const { ListStateMachinesCommand, ListTagsForResourceCommand, DescribeStateMachineCommand, StartSyncExecutionCommand, StartExecutionCommand, } = await import('@aws-sdk/client-sfn');
+    return {
+        async listStateMachines() {
+            const machines = [];
+            let nextToken;
+            do {
+                const response = await client.send(new ListStateMachinesCommand({ nextToken }));
+                const sms = response.stateMachines ?? [];
+                for (const sm of sms) {
+                    machines.push({
+                        name: sm.name ?? '',
+                        stateMachineArn: sm.stateMachineArn ?? '',
+                        type: sm.type ?? 'STANDARD',
+                    });
+                }
+                nextToken = response.nextToken;
+            } while (nextToken);
+            return machines;
+        },
+        async listTags(arn) {
+            const response = await client.send(new ListTagsForResourceCommand({ resourceArn: arn }));
+            const tags = {};
+            const rawTags = response.tags ?? [];
+            for (const tag of rawTags) {
+                tags[tag.key] = tag.value;
+            }
+            return tags;
+        },
+        async describe(arn) {
+            const response = await client.send(new DescribeStateMachineCommand({ stateMachineArn: arn }));
+            return {
+                description: response.description ?? '',
+                type: response.type ?? 'STANDARD',
+            };
+        },
+        async startSync(arn, input) {
+            const response = await client.send(new StartSyncExecutionCommand({
+                stateMachineArn: arn,
+                input: JSON.stringify(input ?? {}),
+            }));
+            let output;
+            const rawOutput = response.output;
+            try {
+                output = rawOutput ? JSON.parse(rawOutput) : null;
+            }
+            catch {
+                output = rawOutput;
+            }
+            return {
+                status: (response.status ?? 'FAILED'),
+                output,
+                error: response.error,
+                cause: response.cause,
+                executionArn: response.executionArn ?? '',
+            };
+        },
+        async startAsync(arn, input) {
+            const response = await client.send(new StartExecutionCommand({
+                stateMachineArn: arn,
+                input: JSON.stringify(input ?? {}),
+            }));
+            // startDate is a Date object from the SDK — convert to ISO string
+            const startDate = response.startDate instanceof Date
+                ? response.startDate.toISOString()
+                : new Date().toISOString();
+            return {
+                executionArn: response.executionArn ?? '',
+                startDate,
+            };
+        },
+    };
+}
+//# sourceMappingURL=AwsClient.js.map

package/dist/AwsClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AwsClient.js","sourceRoot":"","sources":["../src/AwsClient.ts"],"names":[],"mappings":"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"}

package/dist/LambdaDiscovery.d.ts

@@ -0,0 +1,31 @@
+import type { AwsClient } from './AwsClient.js';
+import type { AwsLambdaConfig } from './types.js';
+export interface LambdaDiscoveryOptions {
+    /** Tag filter — only functions matching ALL tags are included.
+     *  Default: `{ 'mcp:expose': 'true' }` */
+    readonly tagFilter?: Readonly<Record<string, string>> | undefined;
+}
+/**
+ * Discovers Lambda functions tagged with `mcp:expose = true`
+ * and extracts MCP-relevant metadata from their tags.
+ *
+ * Tag convention:
+ * - `mcp:expose` — opt-in (required)
+ * - `mcp:group` — groups multiple Lambdas into a single MCP tool
+ * - `mcp:action` — action name within a group (default: 'execute')
+ * - `mcp:readOnly` — marks the action as read-only
+ * - `mcp:destructive` — marks the action as destructive
+ */
+export declare class LambdaDiscovery {
+    private readonly client;
+    private readonly options;
+    private readonly tagFilter;
+    constructor(client: AwsClient, options?: LambdaDiscoveryOptions);
+    /** Discover all tagged Lambda functions and return their configs */
+    discover(): Promise<AwsLambdaConfig[]>;
+    /** Check if tags match the required tag filter */
+    private matchesTagFilter;
+    /** Extract AwsLambdaConfig from a function summary + its tags */
+    private extractConfig;
+}
+//# sourceMappingURL=LambdaDiscovery.d.ts.map

package/dist/LambdaDiscovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LambdaDiscovery.d.ts","sourceRoot":"","sources":["../src/LambdaDiscovery.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAyB,MAAM,gBAAgB,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,MAAM,WAAW,sBAAsB;IACnC;8CAC0C;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;CACrE;AAED;;;;;;;;;;GAUG;AACH,qBAAa,eAAe;IAIpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;gBAGxC,MAAM,EAAE,SAAS,EACjB,OAAO,GAAE,sBAA2B;IAKzD,oEAAoE;IAC9D,QAAQ,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAiB5C,kDAAkD;IAClD,OAAO,CAAC,gBAAgB;IAOxB,iEAAiE;IACjE,OAAO,CAAC,aAAa;CAgBxB"}

package/dist/LambdaDiscovery.js

@@ -0,0 +1,61 @@
+// ============================================================================
+// LambdaDiscovery — Discover Lambda functions via AWS tags
+// ============================================================================
+import { MCP_TAGS, DEFAULT_TAG_FILTER, DEFAULT_ACTION_NAME } from './types.js';
+/**
+ * Discovers Lambda functions tagged with `mcp:expose = true`
+ * and extracts MCP-relevant metadata from their tags.
+ *
+ * Tag convention:
+ * - `mcp:expose` — opt-in (required)
+ * - `mcp:group` — groups multiple Lambdas into a single MCP tool
+ * - `mcp:action` — action name within a group (default: 'execute')
+ * - `mcp:readOnly` — marks the action as read-only
+ * - `mcp:destructive` — marks the action as destructive
+ */
+export class LambdaDiscovery {
+    client;
+    options;
+    tagFilter;
+    constructor(client, options = {}) {
+        this.client = client;
+        this.options = options;
+        this.tagFilter = options.tagFilter ?? DEFAULT_TAG_FILTER;
+    }
+    /** Discover all tagged Lambda functions and return their configs */
+    async discover() {
+        const allFunctions = await this.client.listLambdaFunctions();
+        const configs = [];
+        for (const fn of allFunctions) {
+            const tags = await this.client.getLambdaTags(fn.functionArn);
+            if (this.matchesTagFilter(tags)) {
+                configs.push(this.extractConfig(fn, tags));
+            }
+        }
+        return configs;
+    }
+    // ── Internal ──────────────────────────────────────────
+    /** Check if tags match the required tag filter */
+    matchesTagFilter(tags) {
+        for (const [key, value] of Object.entries(this.tagFilter)) {
+            if (tags[key] !== value)
+                return false;
+        }
+        return true;
+    }
+    /** Extract AwsLambdaConfig from a function summary + its tags */
+    extractConfig(fn, tags) {
+        return {
+            functionName: fn.functionName,
+            functionArn: fn.functionArn,
+            description: fn.description,
+            runtime: fn.runtime,
+            group: tags[MCP_TAGS.GROUP],
+            actionName: tags[MCP_TAGS.ACTION] ?? DEFAULT_ACTION_NAME,
+            readOnly: tags[MCP_TAGS.READ_ONLY] === 'true',
+            destructive: tags[MCP_TAGS.DESTRUCTIVE] === 'true',
+            tags,
+        };
+    }
+}
+//# sourceMappingURL=LambdaDiscovery.js.map

package/dist/LambdaDiscovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LambdaDiscovery.js","sourceRoot":"","sources":["../src/LambdaDiscovery.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,2DAA2D;AAC3D,+EAA+E;AAI/E,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAQ/E;;;;;;;;;;GAUG;AACH,MAAM,OAAO,eAAe;IAIH;IACA;IAJJ,SAAS,CAAmC;IAE7D,YACqB,MAAiB,EACjB,UAAkC,EAAE;QADpC,WAAM,GAAN,MAAM,CAAW;QACjB,YAAO,GAAP,OAAO,CAA6B;QAErD,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,kBAAkB,CAAC;IAC7D,CAAC;IAED,oEAAoE;IACpE,KAAK,CAAC,QAAQ;QACV,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;QAC7D,MAAM,OAAO,GAAsB,EAAE,CAAC;QAEtC,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC;YAE7D,IAAI,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;YAC/C,CAAC;QACL,CAAC;QAED,OAAO,OAAO,CAAC;IACnB,CAAC;IAED,yDAAyD;IAEzD,kDAAkD;IAC1C,gBAAgB,CAAC,IAA4B;QACjD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACxD,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK;gBAAE,OAAO,KAAK,CAAC;QAC1C,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,iEAAiE;IACzD,aAAa,CACjB,EAAyB,EACzB,IAA4B;QAE5B,OAAO;YACH,YAAY,EAAE,EAAE,CAAC,YAAY;YAC7B,WAAW,EAAE,EAAE,CAAC,WAAW;YAC3B,WAAW,EAAE,EAAE,CAAC,WAAW;YAC3B,OAAO,EAAE,EAAE,CAAC,OAAO;YACnB,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAC3B,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,mBAAmB;YACxD,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,MAAM;YAC7C,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,MAAM;YAClD,IAAI;SACP,CAAC;IACN,CAAC;CACJ"}

package/dist/StepFunctionDiscovery.d.ts

@@ -0,0 +1,32 @@
+import type { AwsClient } from './AwsClient.js';
+import type { AwsStepFunctionConfig } from './types.js';
+export interface SfnDiscoveryOptions {
+    /** Tag filter — only state machines matching ALL tags are included.
+     *  Default: `{ 'mcp:expose': 'true' }` */
+    readonly tagFilter?: Readonly<Record<string, string>> | undefined;
+}
+/**
+ * Discovers Step Functions state machines tagged with `mcp:expose = true`
+ * and extracts MCP-relevant metadata.
+ *
+ * **Optimization:** `type` (EXPRESS/STANDARD) is read from ListStateMachines
+ * directly — no extra `DescribeStateMachine` call needed just for type detection.
+ * `DescribeStateMachine` is only called to fetch the `description` field.
+ *
+ * Additional tags:
+ * - `mcp:sfn-type` — 'express' for sync or 'standard' for async (LRO pattern)
+ * - `mcp:group` / `mcp:action` — grouping (same as Lambda)
+ */
+export declare class StepFunctionDiscovery {
+    private readonly client;
+    private readonly options;
+    private readonly tagFilter;
+    constructor(client: AwsClient, options?: SfnDiscoveryOptions);
+    /** Discover all tagged state machines and return their configs */
+    discover(): Promise<AwsStepFunctionConfig[]>;
+    /** Check if tags match the required tag filter */
+    private matchesTagFilter;
+    /** Extract AwsStepFunctionConfig from a state machine summary + tags */
+    private extractConfig;
+}
+//# sourceMappingURL=StepFunctionDiscovery.d.ts.map

package/dist/StepFunctionDiscovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StepFunctionDiscovery.d.ts","sourceRoot":"","sources":["../src/StepFunctionDiscovery.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAA0B,MAAM,gBAAgB,CAAC;AACxE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGxD,MAAM,WAAW,mBAAmB;IAChC;8CAC0C;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;CACrE;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,qBAAqB;IAI1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;gBAGxC,MAAM,EAAE,SAAS,EACjB,OAAO,GAAE,mBAAwB;IAKtD,kEAAkE;IAC5D,QAAQ,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAoBlD,kDAAkD;IAClD,OAAO,CAAC,gBAAgB;IAOxB,wEAAwE;IACxE,OAAO,CAAC,aAAa;CAyBxB"}

package/dist/StepFunctionDiscovery.js

@@ -0,0 +1,71 @@
+// ============================================================================
+// StepFunctionDiscovery — Discover SFN state machines via AWS tags
+// ============================================================================
+import { MCP_TAGS, DEFAULT_TAG_FILTER, DEFAULT_ACTION_NAME } from './types.js';
+/**
+ * Discovers Step Functions state machines tagged with `mcp:expose = true`
+ * and extracts MCP-relevant metadata.
+ *
+ * **Optimization:** `type` (EXPRESS/STANDARD) is read from ListStateMachines
+ * directly — no extra `DescribeStateMachine` call needed just for type detection.
+ * `DescribeStateMachine` is only called to fetch the `description` field.
+ *
+ * Additional tags:
+ * - `mcp:sfn-type` — 'express' for sync or 'standard' for async (LRO pattern)
+ * - `mcp:group` / `mcp:action` — grouping (same as Lambda)
+ */
+export class StepFunctionDiscovery {
+    client;
+    options;
+    tagFilter;
+    constructor(client, options = {}) {
+        this.client = client;
+        this.options = options;
+        this.tagFilter = options.tagFilter ?? DEFAULT_TAG_FILTER;
+    }
+    /** Discover all tagged state machines and return their configs */
+    async discover() {
+        const allMachines = await this.client.listStateMachines();
+        const configs = [];
+        for (const sm of allMachines) {
+            const tags = await this.client.getStateMachineTags(sm.stateMachineArn);
+            if (this.matchesTagFilter(tags)) {
+                // Only call describeStateMachine for the description field.
+                // `type` is already available from ListStateMachines response.
+                const details = await this.client.describeStateMachine(sm.stateMachineArn);
+                configs.push(this.extractConfig(sm, tags, details.description));
+            }
+        }
+        return configs;
+    }
+    // ── Internal ──────────────────────────────────────────
+    /** Check if tags match the required tag filter */
+    matchesTagFilter(tags) {
+        for (const [key, value] of Object.entries(this.tagFilter)) {
+            if (tags[key] !== value)
+                return false;
+        }
+        return true;
+    }
+    /** Extract AwsStepFunctionConfig from a state machine summary + tags */
+    extractConfig(sm, tags, description) {
+        // Determine execution type: tag overrides API type
+        const sfnTypeTag = tags[MCP_TAGS.SFN_TYPE]?.toLowerCase();
+        const executionType = sfnTypeTag === 'express' ? 'express'
+            : sfnTypeTag === 'standard' ? 'standard'
+                : sm.type === 'EXPRESS' ? 'express'
+                    : 'standard';
+        return {
+            name: sm.name,
+            stateMachineArn: sm.stateMachineArn,
+            description,
+            executionType,
+            group: tags[MCP_TAGS.GROUP],
+            actionName: tags[MCP_TAGS.ACTION] ?? DEFAULT_ACTION_NAME,
+            readOnly: tags[MCP_TAGS.READ_ONLY] === 'true',
+            destructive: tags[MCP_TAGS.DESTRUCTIVE] === 'true',
+            tags,
+        };
+    }
+}
+//# sourceMappingURL=StepFunctionDiscovery.js.map

package/dist/StepFunctionDiscovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StepFunctionDiscovery.js","sourceRoot":"","sources":["../src/StepFunctionDiscovery.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,+EAA+E;AAI/E,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAQ/E;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,qBAAqB;IAIT;IACA;IAJJ,SAAS,CAAmC;IAE7D,YACqB,MAAiB,EACjB,UAA+B,EAAE;QADjC,WAAM,GAAN,MAAM,CAAW;QACjB,YAAO,GAAP,OAAO,CAA0B;QAElD,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,kBAAkB,CAAC;IAC7D,CAAC;IAED,kEAAkE;IAClE,KAAK,CAAC,QAAQ;QACV,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAC1D,MAAM,OAAO,GAA4B,EAAE,CAAC;QAE5C,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC;YAEvE,IAAI,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9B,4DAA4D;gBAC5D,+DAA+D;gBAC/D,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC;gBAC3E,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;YACpE,CAAC;QACL,CAAC;QAED,OAAO,OAAO,CAAC;IACnB,CAAC;IAED,yDAAyD;IAEzD,kDAAkD;IAC1C,gBAAgB,CAAC,IAA4B;QACjD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACxD,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK;gBAAE,OAAO,KAAK,CAAC;QAC1C,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,wEAAwE;IAChE,aAAa,CACjB,EAA0B,EAC1B,IAA4B,EAC5B,WAAmB;QAEnB,mDAAmD;QACnD,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;QAC1D,MAAM,aAAa,GACf,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS;YAChC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU;gBACxC,CAAC,CAAC,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS;oBACnC,CAAC,CAAC,UAAU,CAAC;QAErB,OAAO;YACH,IAAI,EAAE,EAAE,CAAC,IAAI;YACb,eAAe,EAAE,EAAE,CAAC,eAAe;YACnC,WAAW;YACX,aAAa;YACb,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAC3B,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,mBAAmB;YACxD,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,MAAM;YAC7C,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,MAAM;YAClD,IAAI;SACP,CAAC;IACN,CAAC;CACJ"}

package/dist/ToolSynthesizer.d.ts

@@ -0,0 +1,61 @@
+import type { AwsLambdaConfig, AwsStepFunctionConfig } from './types.js';
+import type { AwsClient } from './AwsClient.js';
+/**
+ * Synthesized tool definition ready for `defineTool()`.
+ *
+ * This is the intermediate format between discovery and registration.
+ * The `config` object matches `ToolConfig` from `@vinkius-core/mcp-fusion`.
+ */
+export interface SynthesizedToolConfig {
+    /** Tool name (snake_case) */
+    readonly name: string;
+    /** Config object for defineTool() — contains description, actions/groups */
+    readonly config: {
+        readonly description: string;
+        readonly tags: readonly string[];
+        readonly actions: Readonly<Record<string, SynthesizedAction>>;
+    };
+}
+export interface SynthesizedAction {
+    readonly description: string;
+    readonly readOnly?: boolean | undefined;
+    readonly destructive?: boolean | undefined;
+    readonly handler: (ctx: unknown, args: Record<string, unknown>) => Promise<unknown>;
+}
+/**
+ * Convert a function/resource name to a valid snake_case tool name.
+ *
+ * "CreateUser" → "create_user"
+ * "my-awesome-lambda" → "my_awesome_lambda"
+ * "get_users_v2" → "get_users_v2"
+ *
+ * @throws {Error} If the resulting name is empty after conversion
+ */
+export declare function toToolName(resourceName: string): string;
+/**
+ * Synthesize tool configs from discovered Lambda functions.
+ *
+ * **Grouping logic:**
+ * - Lambdas with the same `mcp:group` tag → grouped into ONE tool with N actions
+ * - Lambdas without `mcp:group` → standalone tools with single `execute` action
+ *
+ * @throws {Error} If two Lambdas in the same group share an action name
+ * @returns Array of tool configs ready for defineTool()
+ */
+export declare function synthesizeLambdaTools(lambdas: readonly AwsLambdaConfig[], client: AwsClient): SynthesizedToolConfig[];
+/**
+ * Synthesize tool configs from discovered Step Functions.
+ *
+ * Same grouping logic as Lambda.
+ * Execution type determines handler behavior:
+ * - EXPRESS → `startSyncExecution` (blocks, returns output)
+ * - STANDARD → `startExecution` (fire-and-forget, returns LRO with cognitive rule)
+ *
+ * @throws {Error} If two state machines in the same group share an action name
+ */
+export declare function synthesizeStepFunctionTools(stateMachines: readonly AwsStepFunctionConfig[], client: AwsClient): SynthesizedToolConfig[];
+/**
+ * Synthesize all tools from both Lambda and Step Function configs.
+ */
+export declare function synthesizeAll(lambdas: readonly AwsLambdaConfig[], stepFunctions: readonly AwsStepFunctionConfig[], client: AwsClient): SynthesizedToolConfig[];
+//# sourceMappingURL=ToolSynthesizer.d.ts.map

package/dist/ToolSynthesizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolSynthesizer.d.ts","sourceRoot":"","sources":["../src/ToolSynthesizer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IAClC,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE;QACb,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;QACjC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;KACjE,CAAC;CACL;AAED,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACvF;AAID;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAgBvD;AAID;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACjC,OAAO,EAAE,SAAS,eAAe,EAAE,EACnC,MAAM,EAAE,SAAS,GAClB,qBAAqB,EAAE,CA4DzB;AAID;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACvC,aAAa,EAAE,SAAS,qBAAqB,EAAE,EAC/C,MAAM,EAAE,SAAS,GAClB,qBAAqB,EAAE,CAyDzB;AAID;;GAEG;AACH,wBAAgB,aAAa,CACzB,OAAO,EAAE,SAAS,eAAe,EAAE,EACnC,aAAa,EAAE,SAAS,qBAAqB,EAAE,EAC/C,MAAM,EAAE,SAAS,GAClB,qBAAqB,EAAE,CAKzB"}