@intrig/mcp 0.0.1

package/dist/app/intrig-mcp/src/types/daemon-api.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Daemon API type definitions.
+ * Based on the OpenAPI spec at .intrig/specs/daemon_api-latest.json
+ */
+import { Result } from './discovery.js';
+/**
+ * Error codes specific to daemon client operations.
+ */
+export type DaemonClientErrorCode = 'DAEMON_UNAVAILABLE' | 'RESOURCE_NOT_FOUND' | 'REQUEST_TIMEOUT' | 'INVALID_RESPONSE';
+/**
+ * Error type for daemon client operations.
+ */
+export interface DaemonClientError {
+    code: DaemonClientErrorCode;
+    message: string;
+    statusCode?: number;
+    cause?: unknown;
+}
+/**
+ * Create a daemon client error.
+ */
+export declare function daemonClientError(code: DaemonClientErrorCode, message: string, statusCode?: number, cause?: unknown): DaemonClientError;
+/**
+ * Result type for daemon client operations.
+ */
+export type DaemonResult<T> = Result<T, DaemonClientError>;
+/**
+ * Tab containing documentation content.
+ */
+export interface Tab {
+    name: string;
+    content: string;
+}
+/**
+ * Reference to a related type.
+ */
+export interface RelatedType {
+    name: string;
+    id: string;
+}
+/**
+ * Reference to a related endpoint.
+ */
+export interface RelatedEndpoint {
+    id: string;
+    name: string;
+    method: string;
+    path: string;
+}
+/**
+ * Variable in an endpoint request.
+ */
+export interface Variable {
+    name: string;
+    in: string;
+    ref: string;
+    relatedType: RelatedType;
+}
+/**
+ * Resource type filter for search.
+ */
+export type ResourceType = 'rest' | 'schema';
+/**
+ * Search query parameters.
+ */
+export interface SearchParams {
+    query?: string;
+    type?: ResourceType;
+    source?: string;
+    page?: number;
+    size?: number;
+}
+/**
+ * A resource descriptor returned from search.
+ */
+export interface ResourceDescriptor {
+    id: string;
+    name: string;
+    type: ResourceType;
+    source: string;
+    path?: string;
+    description?: string;
+    method?: string;
+    data?: Record<string, unknown>;
+    lastAccessed?: number;
+}
+/**
+ * Pagination information.
+ */
+export interface PageInfo {
+    total: number;
+    page: number;
+    limit: number;
+    totalPages: number;
+    hasNext: boolean;
+    hasPrevious: boolean;
+}
+/**
+ * Search response with paginated results.
+ */
+export interface SearchResponse extends PageInfo {
+    data: ResourceDescriptor[];
+}
+/**
+ * REST endpoint documentation.
+ */
+export interface RestDocumentation {
+    id: string;
+    name: string;
+    method: string;
+    path: string;
+    description?: string;
+    requestBody?: RelatedType;
+    contentType?: string;
+    response?: RelatedType;
+    responseType?: string;
+    requestUrl: string;
+    variables: Variable[];
+    responseExamples?: Record<string, unknown>;
+    tabs: Tab[];
+}
+/**
+ * Schema documentation.
+ */
+export interface SchemaDocumentation {
+    id: string;
+    name: string;
+    description?: string;
+    jsonSchema: Record<string, unknown>;
+    tabs: Tab[];
+    relatedTypes: RelatedType[];
+    relatedEndpoints: RelatedEndpoint[];
+}
+/**
+ * API source configuration.
+ */
+export interface IntrigSourceConfig {
+    id: string;
+    name: string;
+    specUrl: string;
+}
+/**
+ * Simplified source info for MCP responses.
+ */
+export interface SourceInfo {
+    id: string;
+    name: string;
+    specUrl: string;
+}
+//# sourceMappingURL=daemon-api.d.ts.map

package/dist/app/intrig-mcp/src/types/daemon-api.d.ts.map

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

package/dist/app/intrig-mcp/src/types/discovery.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Metadata written by daemon when registering itself.
+ * Stored in {os.tmpdir()}/{username}.intrig/{sha1(projectPath)}.json
+ */
+export interface DiscoveryMetadata {
+    projectName: string;
+    url: string;
+    port: number;
+    pid: number;
+    timestamp: string;
+    path: string;
+    type: string;
+}
+/**
+ * Project info with resolved running status.
+ */
+export interface ProjectInfo {
+    projectName: string;
+    path: string;
+    url: string;
+    port: number;
+    type: string;
+    running: boolean;
+    metadata: DiscoveryMetadata;
+}
+/**
+ * Error codes for discovery operations.
+ */
+export type DiscoveryErrorCode = 'PROJECT_NOT_FOUND' | 'DAEMON_START_FAILED' | 'DAEMON_UNAVAILABLE' | 'REGISTRY_ERROR';
+/**
+ * Explicit error type for discovery operations.
+ */
+export interface DiscoveryError {
+    code: DiscoveryErrorCode;
+    message: string;
+    cause?: unknown;
+}
+/**
+ * Result type for operations that can fail with expected errors.
+ * Using discriminated union for type-safe error handling.
+ */
+export type Result<T, E = DiscoveryError> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: E;
+};
+/**
+ * Helper to create success result.
+ */
+export declare function ok<T>(value: T): Result<T, never>;
+/**
+ * Helper to create error result.
+ */
+export declare function err<E>(error: E): Result<never, E>;
+/**
+ * Create a discovery error with code and message.
+ */
+export declare function discoveryError(code: DiscoveryErrorCode, message: string, cause?: unknown): DiscoveryError;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/app/intrig-mcp/src/types/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../../../src/types/discovery.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,iBAAiB,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,mBAAmB,GACnB,qBAAqB,GACrB,oBAAoB,GACpB,gBAAgB,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,cAAc,IACpC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACtB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAE5B;;GAEG;AACH,wBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAEhD;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAEjD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,kBAAkB,EACxB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,OAAO,GACd,cAAc,CAEhB"}

package/dist/app/intrig-mcp/src/utils/errors.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Error message formatting utilities.
+ * Provides user-friendly error messages with actionable suggestions.
+ */
+import type { DiscoveryErrorCode } from '../types/discovery.js';
+import type { DaemonClientErrorCode } from '../types/daemon-api.js';
+type ErrorCode = DiscoveryErrorCode | DaemonClientErrorCode;
+/**
+ * Format an error message with actionable suggestion.
+ */
+export declare function formatError(code: ErrorCode, message: string): string;
+/**
+ * Format a validation error message.
+ */
+export declare function formatValidationError(field: string, expected: string): string;
+/**
+ * Format an "empty state" message when no projects are found.
+ */
+export declare function formatNoProjectsMessage(): string;
+/**
+ * Format a message when sources are not yet synced.
+ */
+export declare function formatNoSourcesMessage(projectName: string): string;
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/app/intrig-mcp/src/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEpE,KAAK,SAAS,GAAG,kBAAkB,GAAG,qBAAqB,CAAC;AAgC5D;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAUpE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAShD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAWlE"}

package/dist/app/intrig-mcp/src/utils/logger.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Debug logging utility for intrig-mcp.
+ * Logs to stderr to avoid interfering with MCP protocol on stdout.
+ *
+ * Enable debug logging by setting the environment variable:
+ *   DEBUG=intrig-mcp
+ *
+ * Or for more verbose output:
+ *   DEBUG=intrig-mcp:*
+ */
+/**
+ * Log a debug message to stderr.
+ * Only outputs when DEBUG=intrig-mcp is set.
+ */
+export declare function debug(message: string, ...args: unknown[]): void;
+/**
+ * Log an error message to stderr.
+ * Always outputs regardless of debug setting.
+ */
+export declare function logError(message: string, error?: unknown): void;
+/**
+ * Create a namespaced debug logger.
+ */
+export declare function createDebugger(namespace: string): (message: string, ...args: unknown[]) => void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/app/intrig-mcp/src/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH;;;GAGG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAa/D;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAc/D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAqB/F"}