@harperfast/harper 5.0.30 → 5.1.0-beta.2

package/dist/components/mcp/tools/schemas/operations.js

@@ -0,0 +1,299 @@
+"use strict";
+/**
+ * Hand-curated JSON Schemas for the operations-profile MCP tools.
+ *
+ * Why hand-curated: Harper's server-side validators are Joi, which doesn't
+ * round-trip cleanly to JSON Schema. The MCP spec requires draft-07-ish
+ * JSON Schema for tool inputSchema. Authoring these directly keeps the
+ * schemas readable, easy to tweak per the LLM ergonomics we want, and
+ * decoupled from server-side validation evolution.
+ *
+ * Each schema follows MCP convention: `type: 'object'` at the top, with
+ * `properties` declared and a small `required` list when applicable.
+ * Optional fields are listed but not required, so an LLM can call the
+ * minimum-viable form.
+ *
+ * Coverage matches the v1 conservative `allow` default in the design
+ * (#465 → Operations MCP). When operators expand `mcp.operations.allow`
+ * beyond this list, ops without an entry here fall back to a permissive
+ * `{ type: 'object' }` schema and a runtime-validates-as-it-goes posture
+ * — better than silently dropping them from the tool surface.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OPERATION_INPUT_SCHEMAS = exports.PERMISSIVE_SCHEMA = void 0;
+/** Permissive default for any opted-in operation that doesn't have a hand-curated schema yet. */
+exports.PERMISSIVE_SCHEMA = {
+    type: 'object',
+    additionalProperties: true,
+    description: 'Free-form arguments — Harper validates server-side and returns a structured error if invalid.',
+};
+/**
+ * Map of operation name → input schema. Lookup misses fall back to
+ * `PERMISSIVE_SCHEMA`. Keys mirror `OPERATIONS_ENUM` values.
+ */
+exports.OPERATION_INPUT_SCHEMAS = {
+    // ─── describe_* ───────────────────────────────────────────────────────
+    describe_all: {
+        type: 'object',
+        properties: {},
+        description: 'Returns the full schema tree: every database, table, and attribute the caller can describe.',
+    },
+    describe_schema: {
+        type: 'object',
+        properties: {
+            schema: { type: 'string', description: 'Database name (legacy: "schema"). Required.' },
+            database: { type: 'string', description: 'Database name (preferred). Required if `schema` is omitted.' },
+        },
+    },
+    describe_database: {
+        type: 'object',
+        properties: {
+            database: { type: 'string', description: 'Database name. Required.' },
+        },
+        required: ['database'],
+    },
+    describe_table: {
+        type: 'object',
+        properties: {
+            database: { type: 'string', description: 'Database name.' },
+            schema: { type: 'string', description: 'Legacy alias for `database`.' },
+            table: { type: 'string', description: 'Table name. Required.' },
+        },
+        required: ['table'],
+    },
+    // ─── list_* ───────────────────────────────────────────────────────────
+    list_users: {
+        type: 'object',
+        properties: {},
+        description: 'Lists every Harper user the caller can see (requires super_user).',
+    },
+    list_roles: {
+        type: 'object',
+        properties: {},
+        description: 'Lists every Harper role the caller can see (requires super_user).',
+    },
+    list_metrics: {
+        type: 'object',
+        properties: {},
+        description: 'Lists analytics metric names currently being collected.',
+    },
+    list_deployments: {
+        type: 'object',
+        properties: {},
+        description: 'Lists deployed component versions in this Harper instance.',
+    },
+    // ─── search_* ─────────────────────────────────────────────────────────
+    search_by_hash: {
+        type: 'object',
+        properties: {
+            database: { type: 'string', description: 'Database name.' },
+            schema: { type: 'string', description: 'Legacy alias for `database`.' },
+            table: { type: 'string', description: 'Table name. Required.' },
+            hash_values: {
+                type: 'array',
+                items: { type: ['string', 'number'] },
+                description: 'Primary-key values to fetch. Required.',
+            },
+            get_attributes: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Attribute names to include in the response. Defaults to all.',
+            },
+        },
+        required: ['table', 'hash_values'],
+    },
+    search_by_id: {
+        type: 'object',
+        properties: {
+            database: { type: 'string' },
+            schema: { type: 'string', description: 'Legacy alias for `database`.' },
+            table: { type: 'string' },
+            ids: { type: 'array', items: { type: ['string', 'number'] }, description: 'Primary-key values. Required.' },
+            get_attributes: { type: 'array', items: { type: 'string' } },
+        },
+        required: ['table', 'ids'],
+    },
+    search_by_value: {
+        type: 'object',
+        properties: {
+            database: { type: 'string' },
+            schema: { type: 'string', description: 'Legacy alias for `database`.' },
+            table: { type: 'string' },
+            search_attribute: { type: 'string', description: 'Attribute to match.' },
+            search_value: { description: 'Value to match (any JSON type).' },
+            get_attributes: { type: 'array', items: { type: 'string' } },
+        },
+        required: ['table', 'search_attribute', 'search_value'],
+    },
+    search_by_conditions: {
+        type: 'object',
+        properties: {
+            database: { type: 'string' },
+            schema: { type: 'string', description: 'Legacy alias for `database`.' },
+            table: { type: 'string' },
+            operator: { type: 'string', enum: ['and', 'or'], description: 'How to combine conditions. Defaults to "and".' },
+            conditions: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    properties: {
+                        search_attribute: { type: 'string' },
+                        search_type: {
+                            type: 'string',
+                            enum: ['equals', 'contains', 'starts_with', 'ends_with', 'greater_than', 'less_than', 'between'],
+                        },
+                        search_value: {},
+                    },
+                    required: ['search_attribute', 'search_type', 'search_value'],
+                },
+            },
+            get_attributes: { type: 'array', items: { type: 'string' } },
+            offset: { type: 'number', minimum: 0 },
+            limit: { type: 'number', minimum: 1 },
+        },
+        required: ['table', 'conditions'],
+    },
+    search: {
+        type: 'object',
+        properties: {
+            database: { type: 'string' },
+            schema: { type: 'string', description: 'Legacy alias for `database`.' },
+            table: { type: 'string' },
+            operation: { type: 'object', description: 'Search operation descriptor; varies by search kind.' },
+        },
+        required: ['table', 'operation'],
+        description: 'Generic search dispatcher; prefer the specific search_by_* operations when possible.',
+    },
+    search_jobs_by_start_date: {
+        type: 'object',
+        properties: {
+            from_date: { type: 'string', description: 'ISO 8601 timestamp; lower bound.' },
+            to_date: { type: 'string', description: 'ISO 8601 timestamp; upper bound.' },
+        },
+        required: ['from_date', 'to_date'],
+    },
+    // ─── get_* ────────────────────────────────────────────────────────────
+    get_job: {
+        type: 'object',
+        properties: {
+            id: { type: 'string', description: 'Job id. Required.' },
+        },
+        required: ['id'],
+    },
+    get_configuration: {
+        type: 'object',
+        properties: {},
+        description: 'Returns the resolved server configuration (with secrets redacted).',
+    },
+    get_backup: {
+        type: 'object',
+        properties: {
+            database: { type: 'string', description: 'Database to back up. Required.' },
+            table: { type: 'string', description: 'Optional single table within the database.' },
+        },
+        required: ['database'],
+    },
+    // ─── read_* / system_information ──────────────────────────────────────
+    read_log: {
+        type: 'object',
+        properties: {
+            from: { type: 'string', description: 'ISO 8601 lower bound. Optional.' },
+            until: { type: 'string', description: 'ISO 8601 upper bound. Optional.' },
+            limit: { type: 'number', minimum: 1, description: 'Max entries to return.' },
+            start: { type: 'number', minimum: 0, description: 'Pagination offset.' },
+            order: { type: 'string', enum: ['asc', 'desc'] },
+            level: { type: 'string', enum: ['trace', 'debug', 'info', 'warn', 'error', 'fatal', 'notify'] },
+        },
+    },
+    read_audit_log: {
+        type: 'object',
+        properties: {
+            database: { type: 'string' },
+            schema: { type: 'string', description: 'Legacy alias for `database`.' },
+            table: { type: 'string' },
+            search_type: { type: 'string', enum: ['timestamp', 'username', 'hash_value'] },
+            search_values: { type: 'array', items: { type: ['string', 'number'] } },
+        },
+        required: ['table'],
+    },
+    read_transaction_log: {
+        type: 'object',
+        properties: {
+            database: { type: 'string' },
+            schema: { type: 'string', description: 'Legacy alias for `database`.' },
+            table: { type: 'string' },
+            from: { type: 'number', description: 'Inclusive lower-bound transaction timestamp (ms).' },
+            until: { type: 'number', description: 'Exclusive upper-bound transaction timestamp (ms).' },
+            limit: { type: 'number', minimum: 1 },
+        },
+        required: ['table'],
+    },
+    system_information: {
+        type: 'object',
+        properties: {
+            attributes: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Restrict the response to the named sections (e.g. ["cpu","memory"]).',
+            },
+        },
+        description: 'Returns host metrics: CPU, memory, disk, network, replication state.',
+    },
+    get_status: {
+        type: 'object',
+        properties: {
+            id: {
+                type: 'string',
+                description: 'Status entry id. When omitted, returns aggregated status across threads.',
+            },
+        },
+    },
+    get_analytics: {
+        type: 'object',
+        properties: {
+            metric: { type: 'string', description: 'Metric name (use list_metrics to discover available metrics).' },
+            get_attributes: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Attribute names to project; defaults to all.',
+            },
+            start_time: {
+                type: ['number', 'string'],
+                description: 'ISO 8601 timestamp or epoch ms — inclusive window start.',
+            },
+            end_time: { type: ['number', 'string'], description: 'ISO 8601 timestamp or epoch ms — exclusive window end.' },
+        },
+        required: ['metric'],
+    },
+    describe_metric: {
+        type: 'object',
+        properties: {
+            metric: { type: 'string', description: 'Metric name to describe (use list_metrics to discover).' },
+        },
+        required: ['metric'],
+    },
+    list_agent_sessions: {
+        type: 'object',
+        properties: {
+            limit: { type: 'integer', minimum: 1, description: 'Max sessions to return.' },
+        },
+    },
+    get_metrics: {
+        type: 'object',
+        properties: {
+            metric: { type: 'string', description: 'Metric name (use list_metrics to discover available metrics).' },
+            get_attributes: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Attribute names to project; defaults to all.',
+            },
+            start_time: {
+                type: ['number', 'string'],
+                description: 'ISO 8601 timestamp or epoch ms — inclusive window start.',
+            },
+            end_time: { type: ['number', 'string'], description: 'ISO 8601 timestamp or epoch ms — exclusive window end.' },
+        },
+        required: ['metric'],
+    },
+};
+//# sourceMappingURL=operations.js.map

package/dist/components/mcp/tools/schemas/operations.js.map

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

package/dist/components/mcp/transport.d.ts

@@ -0,0 +1,38 @@
+import { type AuthedUser } from './toolRegistry.ts';
+export type McpProfile = 'operations' | 'application';
+export interface NormRequest {
+    method: string;
+    /** Lowercased header name → value. Adapters normalize before calling. */
+    headers: Record<string, string | undefined>;
+    /**
+     * The request body. May be a raw JSON string (Harper-HTTP adapter, which
+     * reads from a stream) or an already-parsed value (Fastify adapter, which
+     * receives parsed JSON via its preParsing pipeline). `parseMessage` handles
+     * both — no JSON round-trip needed.
+     */
+    body: string | unknown;
+    /** Authenticated username from upstream auth pipeline. Used for session binding. */
+    user: string;
+    /**
+     * permission tree. Required for tools and resources RBAC enforcement.
+     * Adapters populate from `request.hdb_user` (Fastify) / `request.user`
+     * (Harper-HTTP). Tools/resources that gate on role return no matches
+     * when the object is absent.
+     */
+    userObject?: AuthedUser;
+    profile: McpProfile;
+}
+export interface NormResponse {
+    status: number;
+    headers: Record<string, string>;
+    jsonBody?: unknown;
+    sseIterable?: AsyncIterable<unknown>;
+}
+/**
+ * Main entry. Adapters call this and map the returned shape to their
+ * native wire format. Any unhandled error from a downstream call (e.g., a
+ * RocksDB I/O failure on the session table) is caught and reported as a
+ * spec-conformant JSON-RPC Internal Error so clients see a structured
+ * error envelope instead of an opaque framework 500.
+ */
+export declare function handleMcpRequest(request: NormRequest): Promise<NormResponse>;