decibel-tools-mcp 1.0.0

package/dist/tools/shared/project.d.ts

@@ -0,0 +1,17 @@
+import { ResolvedProjectPaths } from '../../projectRegistry.js';
+import { ToolResult } from '../types.js';
+/**
+ * Wrap a tool handler with automatic project resolution.
+ * Handles PROJECT_NOT_FOUND errors with helpful hints.
+ */
+export declare function withProject<T>(args: {
+    projectId?: string;
+}, fn: (resolved: ResolvedProjectPaths) => Promise<T>): Promise<T>;
+/**
+ * Wrap a tool handler that requires a project, returning ToolResult on error.
+ * Use this for top-level tool handlers.
+ */
+export declare function withProjectResult(args: {
+    projectId?: string;
+}, fn: (resolved: ResolvedProjectPaths) => Promise<ToolResult>): Promise<ToolResult>;
+//# sourceMappingURL=project.d.ts.map

package/dist/tools/shared/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../src/tools/shared/project.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;GAGG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,IAAI,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EAC5B,EAAE,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,OAAO,CAAC,CAAC,CAAC,GACjD,OAAO,CAAC,CAAC,CAAC,CAQZ;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EAC5B,EAAE,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,OAAO,CAAC,UAAU,CAAC,GAC1D,OAAO,CAAC,UAAU,CAAC,CAQrB"}

package/dist/tools/shared/project.js

@@ -0,0 +1,36 @@
+// ============================================================================
+// Project Resolution Helper
+// ============================================================================
+// Wraps tool handlers with automatic project resolution.
+// ============================================================================
+import { resolveProjectPaths, } from '../../projectRegistry.js';
+import { toolError } from './response.js';
+/**
+ * Wrap a tool handler with automatic project resolution.
+ * Handles PROJECT_NOT_FOUND errors with helpful hints.
+ */
+export async function withProject(args, fn) {
+    try {
+        const resolved = resolveProjectPaths(args.projectId);
+        return await fn(resolved);
+    }
+    catch (err) {
+        // Re-throw with the error message (which now includes helpful hints)
+        throw err;
+    }
+}
+/**
+ * Wrap a tool handler that requires a project, returning ToolResult on error.
+ * Use this for top-level tool handlers.
+ */
+export async function withProjectResult(args, fn) {
+    try {
+        const resolved = resolveProjectPaths(args.projectId);
+        return await fn(resolved);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return toolError(message);
+    }
+}
+//# sourceMappingURL=project.js.map

package/dist/tools/shared/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../../src/tools/shared/project.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,4BAA4B;AAC5B,+EAA+E;AAC/E,yDAAyD;AACzD,+EAA+E;AAE/E,OAAO,EACL,mBAAmB,GAEpB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAA4B,EAC5B,EAAkD;IAElD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrD,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,qEAAqE;QACrE,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAA4B,EAC5B,EAA2D;IAE3D,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrD,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC"}

package/dist/tools/shared/response.d.ts

@@ -0,0 +1,10 @@
+import { ToolResult } from '../types.js';
+/**
+ * Create a successful tool response
+ */
+export declare function toolSuccess(data: unknown): ToolResult;
+/**
+ * Create an error tool response
+ */
+export declare function toolError(error: string, hint?: string): ToolResult;
+//# sourceMappingURL=response.d.ts.map

package/dist/tools/shared/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../../src/tools/shared/response.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,CAOrD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAelE"}

package/dist/tools/shared/response.js

@@ -0,0 +1,36 @@
+// ============================================================================
+// Response Helpers
+// ============================================================================
+// Standardized response formatting for tool handlers.
+// ============================================================================
+/**
+ * Create a successful tool response
+ */
+export function toolSuccess(data) {
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(data, null, 2),
+            }],
+    };
+}
+/**
+ * Create an error tool response
+ */
+export function toolError(error, hint) {
+    const payload = {
+        success: false,
+        error,
+    };
+    if (hint) {
+        payload.hint = hint;
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(payload, null, 2),
+            }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=response.js.map

package/dist/tools/shared/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../../../src/tools/shared/response.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAC/E,sDAAsD;AACtD,+EAA+E;AAI/E;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAa;IACvC,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;aACpC,CAAC;KACH,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,IAAa;IACpD,MAAM,OAAO,GAA4B;QACvC,OAAO,EAAE,KAAK;QACd,KAAK;KACN,CAAC;IACF,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IACtB,CAAC;IACD,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;aACvC,CAAC;QACF,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/dist/tools/shared/validation.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Validate that required fields are present in args.
+ * Throws an error listing any missing fields.
+ */
+export declare function requireFields(args: any, ...fields: string[]): void;
+/**
+ * Validate that a field matches one of the allowed values.
+ */
+export declare function requireOneOf<T>(value: T, fieldName: string, allowed: T[]): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/tools/shared/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/tools/shared/validation.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,wBAAgB,aAAa,CAE3B,IAAI,EAAE,GAAG,EACT,GAAG,MAAM,EAAE,MAAM,EAAE,GAClB,IAAI,CAKN;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,KAAK,EAAE,CAAC,EACR,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,EAAE,GACX,IAAI,CAIN"}

package/dist/tools/shared/validation.js

@@ -0,0 +1,26 @@
+// ============================================================================
+// Validation Helpers
+// ============================================================================
+// Common validation utilities for tool handlers.
+// ============================================================================
+/**
+ * Validate that required fields are present in args.
+ * Throws an error listing any missing fields.
+ */
+export function requireFields(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+args, ...fields) {
+    const missing = fields.filter(f => args[f] === undefined || args[f] === null);
+    if (missing.length > 0) {
+        throw new Error(`Missing required field${missing.length > 1 ? 's' : ''}: ${missing.join(', ')}`);
+    }
+}
+/**
+ * Validate that a field matches one of the allowed values.
+ */
+export function requireOneOf(value, fieldName, allowed) {
+    if (!allowed.includes(value)) {
+        throw new Error(`Invalid ${fieldName}: "${value}". Must be one of: ${allowed.join(', ')}`);
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/tools/shared/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/tools/shared/validation.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAC/E,iDAAiD;AACjD,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,UAAU,aAAa;AAC3B,8DAA8D;AAC9D,IAAS,EACT,GAAG,MAAgB;IAEnB,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAC9E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,yBAAyB,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnG,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAQ,EACR,SAAiB,EACjB,OAAY;IAEZ,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,WAAW,SAAS,MAAM,KAAK,sBAAsB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7F,CAAC;AACH,CAAC"}

package/dist/tools/studio/cloud-spine.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Studio Cloud Spine Tools
+ *
+ * Supabase-backed tools for Decibel Studio cloud sync.
+ * Integrates with senken.pro Supabase for:
+ *   - Project management
+ *   - Artifact sync
+ *   - Event streaming
+ *   - Device registration
+ *
+ * EPIC-0002: Cloud Spine (Supabase Backend)
+ */
+import { ToolSpec } from '../types.js';
+export declare const studioListProjectsTool: ToolSpec;
+export declare const studioCreateProjectTool: ToolSpec;
+export declare const studioGetProjectTool: ToolSpec;
+export declare const studioListArtifactsTool: ToolSpec;
+export declare const studioCreateArtifactTool: ToolSpec;
+export declare const studioUpdateArtifactTool: ToolSpec;
+export declare const studioSyncEventsTool: ToolSpec;
+export declare const studioRegisterDeviceTool: ToolSpec;
+export declare const studioHeartbeatTool: ToolSpec;
+export declare const studioListJobsTool: ToolSpec;
+export declare const studioClaimJobTool: ToolSpec;
+export declare const studioUpdateJobTool: ToolSpec;
+export declare const studioCloudSpineTools: ToolSpec[];
+//# sourceMappingURL=cloud-spine.d.ts.map

package/dist/tools/studio/cloud-spine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-spine.d.ts","sourceRoot":"","sources":["../../../src/tools/studio/cloud-spine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAkBvC,eAAO,MAAM,sBAAsB,EAAE,QAsDpC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,QA6DrC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,QAwClC,CAAC;AAMF,eAAO,MAAM,uBAAuB,EAAE,QA8ErC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,QAyFtC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,QAqFtC,CAAC;AAMF,eAAO,MAAM,oBAAoB,EAAE,QA8DlC,CAAC;AAMF,eAAO,MAAM,wBAAwB,EAAE,QAmEtC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,QAuCjC,CAAC;AAMF,eAAO,MAAM,kBAAkB,EAAE,QA6DhC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,QA4DhC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,QAyEjC,CAAC;AAMF,eAAO,MAAM,qBAAqB,EAAE,QAAQ,EAkB3C,CAAC"}