@cyanheads/mcp-ts-core 0.8.7 → 0.8.9

package/dist/canvas/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Public barrel for the DataCanvas primitive. Servers import
+ * from `@cyanheads/mcp-ts-core/canvas` to interact with `core.canvas` —
+ * either via tool handlers (acquire → register → query → export) or directly
+ * for advanced lifecycle work.
+ *
+ * The DuckDB provider is lazy-loaded; pulling this barrel does not pull in
+ * `@duckdb/node-api` until {@link DataCanvas.acquire} runs against an active
+ * canvas configuration.
+ *
+ * @module src/canvas/index
+ */
+export { CanvasInstance } from './core/CanvasInstance.js';
+export { type AcquireResult, CanvasRegistry, type CanvasRegistryOptions, DEFAULT_CANVAS_REGISTRY_OPTIONS, } from './core/CanvasRegistry.js';
+export { createCanvasService } from './core/canvasFactory.js';
+export { DataCanvas } from './core/DataCanvas.js';
+export type { IDataCanvasProvider } from './core/IDataCanvasProvider.js';
+export { ALLOWED_PLAN_OPERATORS, ALLOWED_STATEMENT_TYPES, assertReadOnlyQuery, assertValidIdentifier, collectDisallowedOperators, type DuckdbStatementType, quoteIdentifier, } from './core/sqlGate.js';
+export { DuckdbProvider, type DuckdbProviderOptions, } from './providers/duckdb/DuckdbProvider.js';
+export type { AcquireOptions, ColumnSchema, ColumnType, DescribeOptions, ExportFormat, ExportOptions, ExportResult, ExportTarget, QueryOptions, QueryResult, RegisterRows, RegisterTableOptions, RegisterTableResult, TableInfo, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/canvas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/canvas/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EACL,KAAK,aAAa,EAClB,cAAc,EACd,KAAK,qBAAqB,EAC1B,+BAA+B,GAChC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,EAC1B,KAAK,mBAAmB,EACxB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,cAAc,EACd,KAAK,qBAAqB,GAC3B,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EACV,cAAc,EACd,YAAY,EACZ,UAAU,EACV,eAAe,EACf,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,mBAAmB,EACnB,SAAS,GACV,MAAM,YAAY,CAAC"}

package/dist/canvas/index.js

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview Public barrel for the DataCanvas primitive. Servers import
+ * from `@cyanheads/mcp-ts-core/canvas` to interact with `core.canvas` —
+ * either via tool handlers (acquire → register → query → export) or directly
+ * for advanced lifecycle work.
+ *
+ * The DuckDB provider is lazy-loaded; pulling this barrel does not pull in
+ * `@duckdb/node-api` until {@link DataCanvas.acquire} runs against an active
+ * canvas configuration.
+ *
+ * @module src/canvas/index
+ */
+export { CanvasInstance } from './core/CanvasInstance.js';
+export { CanvasRegistry, DEFAULT_CANVAS_REGISTRY_OPTIONS, } from './core/CanvasRegistry.js';
+export { createCanvasService } from './core/canvasFactory.js';
+export { DataCanvas } from './core/DataCanvas.js';
+export { ALLOWED_PLAN_OPERATORS, ALLOWED_STATEMENT_TYPES, assertReadOnlyQuery, assertValidIdentifier, collectDisallowedOperators, quoteIdentifier, } from './core/sqlGate.js';
+export { DuckdbProvider, } from './providers/duckdb/DuckdbProvider.js';
+//# sourceMappingURL=index.js.map

package/dist/canvas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/canvas/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAEL,cAAc,EAEd,+BAA+B,GAChC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,EAE1B,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,cAAc,GAEf,MAAM,sCAAsC,CAAC"}

package/dist/canvas/providers/duckdb/DuckdbProvider.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @fileoverview DuckDB-backed implementation of {@link IDataCanvasProvider}.
+ * One DuckDB instance per canvasId for memory isolation; a shared connection
+ * for control-plane work (DDL, describe, drop) and per-query connections for
+ * data-plane work so that {@link DuckDBConnection.interrupt} cancels exactly
+ * the in-flight query without disturbing concurrent ops on the same canvas.
+ *
+ * Lazy-loaded via {@link lazyImport} so `@duckdb/node-api` stays a true peer
+ * dependency — servers that don't enable canvas pay no install cost.
+ *
+ * @module src/canvas/providers/duckdb/DuckdbProvider
+ */
+import { type RequestContext } from '../../../utils/internal/requestContext.js';
+import type { IDataCanvasProvider } from '../../core/IDataCanvasProvider.js';
+import type { DescribeOptions, ExportOptions, ExportResult, ExportTarget, QueryOptions, QueryResult, RegisterRows, RegisterTableOptions, RegisterTableResult, TableInfo } from '../../types.js';
+/** Configuration for {@link DuckdbProvider}. Mirrors the AppConfig.canvas block. */
+export interface DuckdbProviderOptions {
+    /** Default row cap for `query()` results. */
+    defaultRowLimit: number;
+    /** Sandbox root for path-targeted exports. */
+    exportRootPath: string;
+    /** Per-canvas `memory_limit` PRAGMA value, in MB. */
+    memoryLimitMb: number;
+    /** Number of rows to sniff for schema inference. */
+    schemaSniffRows: number;
+}
+/** DuckDB SELECT statement-type id (matches `StatementType.SELECT === 1`). */
+declare const STATEMENT_TYPE_SELECT_ID = 1;
+export declare class DuckdbProvider implements IDataCanvasProvider {
+    private readonly options;
+    readonly name = "duckdb";
+    private duck;
+    private readonly canvases;
+    constructor(options: DuckdbProviderOptions);
+    initCanvas(canvasId: string, _context: RequestContext): Promise<void>;
+    destroyCanvas(canvasId: string, _context: RequestContext): Promise<void>;
+    healthCheck(): Promise<boolean>;
+    shutdown(): Promise<void>;
+    registerTable(canvasId: string, name: string, rows: RegisterRows, _context: RequestContext, options?: RegisterTableOptions): Promise<RegisterTableResult>;
+    query(canvasId: string, sql: string, _context: RequestContext, options?: QueryOptions): Promise<QueryResult>;
+    export(canvasId: string, tableName: string, target: ExportTarget, _context: RequestContext, options?: ExportOptions): Promise<ExportResult>;
+    describe(canvasId: string, _context: RequestContext, options?: DescribeOptions): Promise<TableInfo[]>;
+    drop(canvasId: string, name: string, _context: RequestContext): Promise<boolean>;
+    clear(canvasId: string, _context: RequestContext): Promise<number>;
+    private requireCanvas;
+    private getModule;
+    private runExplain;
+}
+/** Re-export for tests and consumer-side parsing. */
+export { STATEMENT_TYPE_SELECT_ID };
+/**
+ * Map a DuckDB-thrown error to a framework error class.
+ * @internal Exported for unit testing — not re-exported from the canvas barrel.
+ */
+export declare function classifyDuckdbError(err: unknown): Error;
+//# sourceMappingURL=DuckdbProvider.d.ts.map

package/dist/canvas/providers/duckdb/DuckdbProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DuckdbProvider.d.ts","sourceRoot":"","sources":["../../../../src/canvas/providers/duckdb/DuckdbProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,EAAE,KAAK,cAAc,EAAyB,MAAM,oCAAoC,CAAC;AAEhG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAO7E,OAAO,KAAK,EAGV,eAAe,EACf,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,mBAAmB,EACnB,SAAS,EACV,MAAM,gBAAgB,CAAC;AAqBxB,oFAAoF;AACpF,MAAM,WAAW,qBAAqB;IACpC,6CAA6C;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,cAAc,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,8EAA8E;AAC9E,QAAA,MAAM,wBAAwB,IAAI,CAAC;AAQnC,qBAAa,cAAe,YAAW,mBAAmB;IAM5C,OAAO,CAAC,QAAQ,CAAC,OAAO;IALpC,QAAQ,CAAC,IAAI,YAAY;IAEzB,OAAO,CAAC,IAAI,CAA2B;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;gBAE/B,OAAO,EAAE,qBAAqB;IAMrD,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBrE,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BxE,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAc/B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAczB,aAAa,CACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,cAAc,EACxB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC;IAoFzB,KAAK,CACT,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,cAAc,EACxB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,WAAW,CAAC;IAsGjB,MAAM,CACV,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,cAAc,EACxB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC;IA8DlB,QAAQ,CACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,cAAc,EACxB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,SAAS,EAAE,CAAC;IA2CjB,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAWhF,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBxE,OAAO,CAAC,aAAa;YAQP,SAAS;YAKT,UAAU;CAezB;AAsHD,qDAAqD;AACrD,OAAO,EAAE,wBAAwB,EAAE,CAAC;AA4EpC;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CA0BvD"}