air-mcp-server 0.1.0

package/dist/packages/mcp-server/src/tools/list-recorded-sessions.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listRecordedSessionsTool = void 0;
+const zod_1 = require("zod");
+const privacy_1 = require("../utils/privacy");
+const errors_1 = require("../utils/errors");
+const ListRecordedSessionsArgsSchema = zod_1.z.object({
+    limit: zod_1.z.number().optional(),
+    offset: zod_1.z.number().optional(),
+    recentDays: zod_1.z.number().optional(),
+}).default({});
+exports.listRecordedSessionsTool = {
+    definition: {
+        name: 'list_recorded_sessions',
+        description: 'List available AIR recorded sessions by recording start time, newest first.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of sessions to return. Default 10, max 50.'
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Number of sessions to skip. Default 0.'
+                },
+                recentDays: {
+                    type: 'number',
+                    description: 'Optional filter for sessions started in the last N days. Max 365.'
+                }
+            },
+            additionalProperties: false
+        }
+    },
+    handle: async (args, context) => {
+        try {
+            const parsedArgs = ListRecordedSessionsArgsSchema.parse(args || {});
+            const service = context.getCodegenService();
+            const result = service.listRecordedSessions(parsedArgs);
+            const wrapped = (0, privacy_1.wrapWithPrivacy)(result);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(wrapped, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            if (error instanceof zod_1.z.ZodError) {
+                throw (0, errors_1.createInvalidArgumentsError)(error.message);
+            }
+            throw (0, errors_1.createDatabaseUnavailableError)(error instanceof Error ? error.message : 'Unknown database error');
+        }
+    }
+};

package/dist/packages/mcp-server/src/utils/errors.d.ts

@@ -0,0 +1,4 @@
+import { McpError } from '@modelcontextprotocol/sdk/types.js';
+export declare function createSessionNotFoundError(sessionId: string): McpError;
+export declare function createDatabaseUnavailableError(message: string): McpError;
+export declare function createInvalidArgumentsError(message: string): McpError;

package/dist/packages/mcp-server/src/utils/errors.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSessionNotFoundError = createSessionNotFoundError;
+exports.createDatabaseUnavailableError = createDatabaseUnavailableError;
+exports.createInvalidArgumentsError = createInvalidArgumentsError;
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+function createSessionNotFoundError(sessionId) {
+    return new types_js_1.McpError(types_js_1.ErrorCode.InvalidRequest, `Session not found: ${sessionId}`);
+}
+function createDatabaseUnavailableError(message) {
+    return new types_js_1.McpError(types_js_1.ErrorCode.InternalError, `Database unavailable: ${message}`);
+}
+function createInvalidArgumentsError(message) {
+    return new types_js_1.McpError(types_js_1.ErrorCode.InvalidParams, `Invalid arguments: ${message}`);
+}

package/dist/packages/mcp-server/src/utils/privacy.d.ts

@@ -0,0 +1,8 @@
+export interface PrivacyMeta {
+    privacy: string;
+}
+export declare function createPrivacyMeta(): PrivacyMeta;
+export declare function wrapWithPrivacy<T>(data: T): {
+    _meta: PrivacyMeta;
+    data: T;
+};

package/dist/packages/mcp-server/src/utils/privacy.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPrivacyMeta = createPrivacyMeta;
+exports.wrapWithPrivacy = wrapWithPrivacy;
+function createPrivacyMeta() {
+    return {
+        privacy: "This context may contain local DOM excerpts or masked values. Do not leak sensitive PII."
+    };
+}
+function wrapWithPrivacy(data) {
+    return {
+        _meta: createPrivacyMeta(),
+        data
+    };
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "air-mcp-server",
+  "version": "0.1.0",
+  "description": "AIR MCP Server",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "license": "MIT",
+  "keywords": [
+    "air",
+    "mcp",
+    "test-automation",
+    "playwright",
+    "recording"
+  ],
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "bin": {
+    "air-mcp-server": "./bin/air-mcp.js",
+    "air-mcp": "./bin/air-mcp.js",
+    "air-mcp-http": "./bin/air-mcp-http.js"
+  },
+  "scripts": {
+    "build": "node build.mjs",
+    "dev": "node build.mjs --watch",
+    "start": "node dist/index.js",
+    "start:http": "node dist/http.js",
+    "start:dev:stdio": "tsx src/index.ts",
+    "start:dev:http": "tsx src/http.ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.1",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "esbuild": "^0.24.0",
+    "typescript": "5.6.3",
+    "@air/codegen": "0.1.0",
+    "@air/core": "*",
+    "@air/shared": "0.1.0"
+  }
+}