@vinkius-core/mcp-fusion-aws 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,157 @@
+import type { LambdaAdapter, SfnAdapter } from './AwsClient.js';
+/** Discovered Lambda function configuration */
+export interface AwsLambdaConfig {
+    /** Lambda function name */
+    readonly functionName: string;
+    /** Full ARN */
+    readonly functionArn: string;
+    /** Lambda description (≤256 chars — used for LLM semantics only) */
+    readonly description: string;
+    /** Runtime (e.g. 'nodejs20.x') */
+    readonly runtime: string;
+    /** MCP group name (from `mcp:group` tag). Undefined = standalone tool */
+    readonly group?: string | undefined;
+    /** MCP action name (from `mcp:action` tag). Default: 'execute' */
+    readonly actionName: string;
+    /** Read-only hint (from `mcp:readOnly` tag) */
+    readonly readOnly: boolean;
+    /** Destructive hint (from `mcp:destructive` tag) */
+    readonly destructive: boolean;
+    /** All AWS tags on the function */
+    readonly tags: Readonly<Record<string, string>>;
+}
+/** Discovered Step Functions state machine configuration */
+export interface AwsStepFunctionConfig {
+    /** State machine name */
+    readonly name: string;
+    /** Full ARN */
+    readonly stateMachineArn: string;
+    /** State machine description */
+    readonly description: string;
+    /** Execution type: EXPRESS → sync, STANDARD → fire-and-forget with LRO pattern */
+    readonly executionType: 'express' | 'standard';
+    /** MCP group name (from `mcp:group` tag). Undefined = standalone tool */
+    readonly group?: string | undefined;
+    /** MCP action name (from `mcp:action` tag). Default: 'execute' */
+    readonly actionName: string;
+    /** Read-only hint */
+    readonly readOnly: boolean;
+    /** Destructive hint */
+    readonly destructive: boolean;
+    /** All AWS tags */
+    readonly tags: Readonly<Record<string, string>>;
+}
+/** Lambda invocation result from AwsClient */
+export interface LambdaInvokeResult {
+    /** HTTP status code */
+    readonly statusCode: number;
+    /** Decoded response payload (parsed JSON) */
+    readonly payload: unknown;
+    /** Function error type (if function failed) */
+    readonly functionError?: string | undefined;
+    /** Execution log tail (if requested) */
+    readonly logResult?: string | undefined;
+}
+/** Step Functions execution result (Express — synchronous) */
+export interface SfnSyncResult {
+    /** Execution status */
+    readonly status: 'SUCCEEDED' | 'FAILED' | 'TIMED_OUT';
+    /** Parsed output */
+    readonly output: unknown;
+    /** Error info (if failed) */
+    readonly error?: string | undefined;
+    /** Cause (if failed) */
+    readonly cause?: string | undefined;
+    /** Execution ARN */
+    readonly executionArn: string;
+}
+/** Step Functions execution result (Standard — async fire-and-forget) */
+export interface SfnAsyncResult {
+    /** Execution ARN (use to poll for completion) */
+    readonly executionArn: string;
+    /** Start timestamp (ISO 8601) */
+    readonly startDate: string;
+}
+/**
+ * Configuration for the AWS connector.
+ *
+ * Auth uses IoC: inject pre-configured `LambdaAdapter` / `SfnAdapter`
+ * created via `createLambdaAdapter()` / `createSfnAdapter()`.
+ *
+ * ```typescript
+ * import { LambdaClient } from '@aws-sdk/client-lambda';
+ * import { createLambdaAdapter, createAwsConnector } from '@vinkius-core/mcp-fusion-aws';
+ *
+ * const aws = await createAwsConnector({
+ *     lambdaClient: await createLambdaAdapter(new LambdaClient({ region: 'us-east-1' })),
+ * });
+ * ```
+ */
+export interface AwsConnectorConfig {
+    /**
+     * Lambda adapter created via `createLambdaAdapter()`.
+     * Required when `enableLambda` is true (default).
+     */
+    readonly lambdaClient?: LambdaAdapter | undefined;
+    /**
+     * Step Functions adapter created via `createSfnAdapter()`.
+     * Required when `enableStepFunctions` is true.
+     */
+    readonly sfnClient?: SfnAdapter | undefined;
+    /**
+     * Tag filter for discovery. Only resources matching ALL tags are included.
+     * Default: `{ 'mcp:expose': 'true' }`
+     */
+    readonly tagFilter?: Readonly<Record<string, string>> | undefined;
+    /** Enable Lambda function discovery (default: true) */
+    readonly enableLambda?: boolean | undefined;
+    /** Enable Step Functions discovery (default: false) */
+    readonly enableStepFunctions?: boolean | undefined;
+    /**
+     * Polling interval in ms for live state sync (default: off).
+     * Set to enable auto-refresh of the tool list.
+     */
+    readonly pollInterval?: number | undefined;
+    /**
+     * Called when the tool list changes after a poll cycle.
+     * Use this to emit `notifications/tools/list_changed` on your MCP server.
+     */
+    readonly onChange?: (() => void) | undefined;
+    /**
+     * Called when a polling cycle encounters an error.
+     * Default: errors are silently ignored (next cycle retries).
+     */
+    readonly onError?: ((error: unknown) => void) | undefined;
+}
+/** Configuration for manually defining an AWS Lambda/SFN as a tool */
+export interface AwsToolConfig {
+    /** Lambda function ARN or Step Function ARN */
+    readonly arn: string;
+    /** Tool description for the LLM */
+    readonly description?: string | undefined;
+    /** MCP annotations */
+    readonly annotations?: {
+        readonly readOnlyHint?: boolean | undefined;
+        readonly destructiveHint?: boolean | undefined;
+    } | undefined;
+}
+/** AWS tag keys used by the connector */
+export declare const MCP_TAGS: {
+    /** Opt-in tag — must be 'true' for a resource to be discovered */
+    readonly EXPOSE: "mcp:expose";
+    /** Groups multiple Lambdas/SFNs into a single MCP tool */
+    readonly GROUP: "mcp:group";
+    /** Action name within a group (default: 'execute') */
+    readonly ACTION: "mcp:action";
+    /** Marks the action as read-only */
+    readonly READ_ONLY: "mcp:readOnly";
+    /** Marks the action as destructive */
+    readonly DESTRUCTIVE: "mcp:destructive";
+    /** Step Function execution type: 'express' or 'standard' */
+    readonly SFN_TYPE: "mcp:sfn-type";
+};
+/** Default tag filter for discovery */
+export declare const DEFAULT_TAG_FILTER: Readonly<Record<string, string>>;
+/** Default action name for standalone (ungrouped) resources */
+export declare const DEFAULT_ACTION_NAME = "execute";
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,26 @@
+// ============================================================================
+// AWS Connector Types — Internal type definitions for the AWS connector
+// ============================================================================
+// ── Tag Constants ────────────────────────────────────────
+/** AWS tag keys used by the connector */
+export const MCP_TAGS = {
+    /** Opt-in tag — must be 'true' for a resource to be discovered */
+    EXPOSE: 'mcp:expose',
+    /** Groups multiple Lambdas/SFNs into a single MCP tool */
+    GROUP: 'mcp:group',
+    /** Action name within a group (default: 'execute') */
+    ACTION: 'mcp:action',
+    /** Marks the action as read-only */
+    READ_ONLY: 'mcp:readOnly',
+    /** Marks the action as destructive */
+    DESTRUCTIVE: 'mcp:destructive',
+    /** Step Function execution type: 'express' or 'standard' */
+    SFN_TYPE: 'mcp:sfn-type',
+};
+/** Default tag filter for discovery */
+export const DEFAULT_TAG_FILTER = {
+    [MCP_TAGS.EXPOSE]: 'true',
+};
+/** Default action name for standalone (ungrouped) resources */
+export const DEFAULT_ACTION_NAME = 'execute';
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,wEAAwE;AACxE,+EAA+E;AAkK/E,4DAA4D;AAE5D,yCAAyC;AACzC,MAAM,CAAC,MAAM,QAAQ,GAAG;IACpB,kEAAkE;IAClE,MAAM,EAAE,YAAY;IACpB,0DAA0D;IAC1D,KAAK,EAAE,WAAW;IAClB,sDAAsD;IACtD,MAAM,EAAE,YAAY;IACpB,oCAAoC;IACpC,SAAS,EAAE,cAAc;IACzB,sCAAsC;IACtC,WAAW,EAAE,iBAAiB;IAC9B,4DAA4D;IAC5D,QAAQ,EAAE,cAAc;CAClB,CAAC;AAEX,uCAAuC;AACvC,MAAM,CAAC,MAAM,kBAAkB,GAAqC;IAChE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM;CAC5B,CAAC;AAEF,+DAA+D;AAC/D,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAAC"}

package/package.json

@@ -0,0 +1,69 @@
+{
+    "name": "@vinkius-core/mcp-fusion-aws",
+    "version": "1.0.0",
+    "description": "AWS Lambda & Step Functions connector for MCP Fusion. Auto-discovers tagged resources and produces GroupedToolBuilders — so AI agents can invoke your cloud functions natively.",
+    "type": "module",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "exports": {
+        ".": {
+            "import": "./dist/index.js",
+            "types": "./dist/index.d.ts"
+        }
+    },
+    "scripts": {
+        "build": "tsc",
+        "test": "vitest run",
+        "prepublishOnly": "npm run build"
+    },
+    "keywords": [
+        "mcp",
+        "aws",
+        "lambda",
+        "step-functions",
+        "mcp-fusion",
+        "serverless",
+        "ai",
+        "llm",
+        "connector"
+    ],
+    "author": "Vinkius Labs",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/vinkius-labs/mcp-fusion.git",
+        "directory": "packages/aws"
+    },
+    "bugs": {
+        "url": "https://github.com/vinkius-labs/mcp-fusion/issues"
+    },
+    "homepage": "https://mcp-fusion.vinkius.com/",
+    "files": [
+        "dist",
+        "README.md"
+    ],
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "peerDependencies": {
+        "@aws-sdk/client-lambda": "^3.0.0",
+        "@aws-sdk/client-sfn": "^3.0.0",
+        "@vinkius-core/mcp-fusion": "^2.0.0"
+    },
+    "peerDependenciesMeta": {
+        "@aws-sdk/client-lambda": {
+            "optional": true
+        },
+        "@aws-sdk/client-sfn": {
+            "optional": true
+        }
+    },
+    "devDependencies": {
+        "@aws-sdk/client-lambda": "^3.0.0",
+        "@aws-sdk/client-sfn": "^3.0.0",
+        "@types/node": "^25.3.0"
+    },
+    "license": "Apache-2.0"
+}