npm - @cyanheads/nasa-power-mcp-server - Versions diffs - 0.4.0 → 0.4.2 - Mend

@cyanheads/nasa-power-mcp-server 0.4.0 → 0.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (83) hide show

package/dist/mcp-server/tools/definitions/nasa-power-search-parameters.tool.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"nasa-power-search-parameters.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/nasa-power-search-parameters.tool.ts"],"names":[],"mappings":"AAAA,6IAA6I;AAC7I,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;~~AAEnC~~,MAAM,iBAAiB,GAAG,qBAAqB,CAAC,MAAM,CAAC;IACrD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;CACzD,CAAC,CAAC;AAEH,iEAAiE;AACjE,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC,8BAA8B,EAAE;IACvE,KAAK,EAAE,8BAA8B;IACrC,WAAW,EACT,+~~SAA~~+S;~~IACjT~~,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IAC9E,KAAK,EAAE,CAAC,CAAC,YAAY,CAAC;QACpB,SAAS,EAAE,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC;QACxC,kBAAkB,EAAE,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC;QACrD,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,GAAG,CAAC,GAAG,CAAC;aACR,OAAO,CAAC,EAAE,CAAC;aACX,QAAQ,CAAC,0DAA0D,CAAC;QACvE,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC;aACN,OAAO,CAAC,CAAC,CAAC;aACV,QAAQ,CAAC,+CAA+C,CAAC;QAC5D,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC;aACN,OAAO,CAAC,EAAE,CAAC;aACX,QAAQ,CAAC,4EAA4E,CAAC;KAC1F,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,SAAS,EAAE,eAAe;QAC1B,kBAAkB,EAAE,gBAAgB;QACpC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QAC3D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;QACxD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;QAC1E,KAAK,EAAE,CAAC,~~CAAC,~~MAAM,EAAE,~~CAAC,~~QAAQ,~~CAAC~~,~~8CAA8C~~,~~CAAC~~;~~QAC1E~~,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;QACtE,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;QAClF,OAAO,EAAE,CAAC;aACP,KAAK,CAAC,iBAAiB,CAAC,QAAQ,CAAC,sCAAsC,CAAC,CAAC;aACzE,QAAQ,CAAC,kCAAkC,CAAC;KAChD,CAAC;IACF,UAAU,EAAE;QACV,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,~~CAAC~~,~~0EAA0E~~,~~CAAC~~;~~KACxF~~;IACD,MAAM,EAAE;QACN;YACE,MAAM,EAAE,uBAAuB;YAC/B,IAAI,EAAE,gBAAgB,CAAC,WAAW;YAClC,IAAI,EAAE,uCAAuC;YAC7C,QAAQ,EACN,0GAA0G;YAC5G,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,SAAS;SACpB;QACD;YACE,MAAM,EAAE,oBAAoB;YAC5B,IAAI,EAAE,gBAAgB,CAAC,WAAW;YAClC,IAAI,EAAE,yCAAyC;YAC/C,QAAQ,EAAE,oEAAoE;YAC9E,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,SAAS;SACpB;QACD;YACE,MAAM,EAAE,eAAe;YACvB,IAAI,EAAE,gBAAgB,CAAC,eAAe;YACtC,IAAI,EAAE,2DAA2D;YACjE,QAAQ,EAAE,wBAAwB;YAClC,QAAQ,EAAE,SAAS;SACpB;QACD;YACE,MAAM,EAAE,mBAAmB;YAC3B,IAAI,EAAE,gBAAgB,CAAC,eAAe;YACtC,IAAI,EAAE,mCAAmC;YACzC,QAAQ,EACN,8IAA8I;YAChJ,QAAQ,EAAE,SAAS;SACpB;KACF;IACD,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACzC,MAAM,UAAU,GAAG,MAAM,eAAe,EAAE,CAAC,UAAU,CACnD,KAAK,CAAC,SAAS,EACf,KAAK,CAAC,kBAAkB,EACxB,GAAG,CACJ,CAAC;QACF,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACvE,MAAM,~~OAAO~~,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;~~aACvC~~,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE;YACxB,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,CAAC;iBAC9C,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;iBACtC,IAAI,CAAC,GAAG,CAAC;iBACT,WAAW,EAAE,CAAC;YACjB,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QACvD,CAAC,CAAC;aACD,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;QACxD,GAAG,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,IAAI,KAAK,CAAC,KAAK,GAAG,KAAK;YACrB,OAAO,CAAC,IAAI,CAAC,uEAAuE,CAAC,CAAC;QACxF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;~~YACtB~~,OAAO,CAAC,IAAI,CACV,sJAAsJ,CACvJ,CAAC;QACJ,IAAI,OAAO,CAAC,MAAM;YAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACzD,OAAO;YACL,GAAG,KAAK;YACR,KAAK;YACL,KAAK,EAAE,OAAO,CAAC,MAAM;YACrB,OAAO,EAAE,KAAK,CAAC,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC,MAAM;YAC9C,SAAS,EAAE,KAAK,CAAC,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC,MAAM;YAChD,OAAO,EAAE,OAAO;iBACb,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;iBACzC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;SACvE,CAAC;IACJ,CAAC;IACD,MAAM,EAAE,gBAAgB;CACzB,CAAC,CAAC"}
1	+ {"version":3,"file":"nasa-power-search-parameters.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/nasa-power-search-parameters.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/point-contracts.d.ts CHANGED Viewed

@@ -2,7 +2,7 @@
 import type { Context } from '@cyanheads/mcp-ts-core';
 import { z } from '@cyanheads/mcp-ts-core';
 import { type PowerRequest } from '../../../services/power/index.js';
-/** Full scientific envelope with exact row count and optional staged pointer. */
+/** Full scientific envelope with exact row count and optional staged pointers. */
 export declare const PointOutputSchema: z.ZodObject<{
     request: z.ZodObject<{
         community: z.ZodDefault<z.ZodEnum<{
@@ -175,7 +175,27 @@ export declare const PointOutputSchema: z.ZodObject<{
         describeTool: z.ZodLiteral<"nasa_power_dataframe_describe">;
         queryTool: z.ZodLiteral<"nasa_power_dataframe_query">;
     }, z.core.$strip>>;
+    summaryCount: z.ZodOptional<z.ZodNumber>;
+    summaryDataset: z.ZodOptional<z.ZodObject<{
+        canvas_id: z.ZodString;
+        table: z.ZodString;
+        rowCount: z.ZodNumber;
+        expiresAt: z.ZodString;
+        columns: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodString;
+            nullable: z.ZodBoolean;
+            units: z.ZodOptional<z.ZodString>;
+            valueKind: z.ZodOptional<z.ZodEnum<{
+                categorical: "categorical";
+                number: "number";
+                orientation: "orientation";
+            }>>;
+        }, z.core.$strip>>;
+        describeTool: z.ZodLiteral<"nasa_power_dataframe_describe">;
+        queryTool: z.ZodLiteral<"nasa_power_dataframe_query">;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
-/** Source retrieval and presentation share one producer reservation and deadline signal. */
+/** Source retrieval and presentation share one producer reservation and the deadline started at tool entry. */
 export declare function presentPoint(request: PowerRequest, canvasId: string | undefined, ctx: Context, sourceTool: string): Promise<import("../../../services/canvas/index.js").PresentedDataset<import("../../../services/power/index.js").PowerDataset>>;
 //# sourceMappingURL=point-contracts.d.ts.map

package/dist/mcp-server/tools/definitions/point-contracts.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"point-contracts.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/point-contracts.ts"],"names":[],"mappings":"AAAA,sHAAsH;AACtH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;~~AAE3C~~,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,2BAA2B,CAAC;AAEnC,~~iFAAiF~~;~~AACjF~~,eAAO,MAAM,iBAAiB~~;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAK5B~~,CAAC;AAEH~~,4FAA4F~~;~~AAC5F~~,wBAAgB,YAAY,CAC1B,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,GAAG,EAAE,OAAO,EACZ,UAAU,EAAE,MAAM,~~oHASnB~~"}
1	+ {"version":3,"file":"point-contracts.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/point-contracts.ts"],"names":[],"mappings":"AAAA,sHAAsH;AACtH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAG3C,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,2BAA2B,CAAC;AAEnC,kFAAkF;AAClF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAa5B,CAAC;AAEH,+GAA+G;AAC/G,wBAAgB,YAAY,CAC1B,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,GAAG,EAAE,OAAO,EACZ,UAAU,EAAE,MAAM,oHAkBnB"}

package/dist/mcp-server/tools/definitions/point-contracts.js CHANGED Viewed

@@ -1,19 +1,29 @@
 import { z } from '@cyanheads/mcp-ts-core';
 import { getCanvasService } from '../../../services/canvas/index.js';
+import { estimatePointBytes } from '../../../services/canvas/producer-estimate.js';
 import { DatasetHandleSchema, getPowerService, PowerDatasetSchema, } from '../../../services/power/index.js';
-/** Full scientific envelope with exact row count and optional staged pointer. */
+/** Full scientific envelope with exact row count and optional staged pointers. */
 export const PointOutputSchema = PowerDatasetSchema.extend({
     rowCount: z.number().int().describe('Exact full normalized observation count'),
     dataset: DatasetHandleSchema.nullable().describe('Full-table handle when observations exceed inline budget; null otherwise'),
+    summaryCount: z
+        .number()
+        .int()
+        .optional()
+        .describe('Exact complete summary count when summaries are staged; summaries then holds one'),
+    summaryDataset: DatasetHandleSchema.optional().describe('Complete summaries ordered by summaryIndex; SQL NULL units restore an omitted source unit'),
 });
-/** Source retrieval and presentation share one producer reservation and deadline signal. */
+/** Source retrieval and presentation share one producer reservation and the deadline started at tool entry. */
 export function presentPoint(request, canvasId, ctx, sourceTool) {
-    return getCanvasService().withProducer('single', ctx, async (producerCtx) => {
+    const canvas = getCanvasService();
+    return canvas.withProducer(estimatePointBytes(request), ctx, async (producerCtx, lease) => {
         const power = getPowerService();
-        const budget = power.createCallBudget(producerCtx);
+        const budget = power.createCallBudget(producerCtx, false, {
+            deadlineMs: lease.remainingMs(),
+            onHeldBytes: lease.bodyBytes,
+        });
         const callCtx = { ...producerCtx, signal: budget.signal };
-        const dataset = await power.point(request, callCtx, budget);
-        return getCanvasService().present(dataset, canvasId, callCtx, sourceTool);
+        return canvas.presentPoint(await power.point(request, callCtx, budget), canvasId, callCtx, sourceTool, lease);
     });
 }
 //# sourceMappingURL=point-contracts.js.map

package/dist/mcp-server/tools/definitions/point-contracts.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"point-contracts.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/point-contracts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,kBAAkB,GAEnB,MAAM,2BAA2B,CAAC;AAEnC,~~iFAAiF~~;~~AACjF~~,MAAM,CAAC,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,MAAM,CAAC;IACzD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IAC9E,OAAO,EAAE,mBAAmB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAC9C,0EAA0E,CAC3E;CACF,CAAC,CAAC;AAEH~~,4FAA4F~~;~~AAC5F~~,MAAM,UAAU,YAAY,CAC1B,OAAqB,EACrB,QAA4B,EAC5B,GAAY,EACZ,UAAkB;IAElB,~~OAAO~~,gBAAgB,EAAE,CAAC,YAAY,CAAC,~~QAAQ~~,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE;~~QAC1E~~,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,KAAK,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;~~QACnD~~,MAAM,OAAO,GAAG,EAAE,GAAG,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QAC1D,MAAM,~~OAAO~~,~~GAAG~~,MAAM,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,~~CAAC;QAC5D~~,~~OAAO~~,~~gBAAgB~~,~~EAAE,CAAC,~~OAAO,~~CAAC~~,~~OAAO~~,~~EAAE~~,~~QAAQ~~,~~EAAE~~,~~OAAO,EAAE,UAAU,~~CAAC~~,CAAC~~;~~IAC5E~~,CAAC,CAAC,CAAC;AACL,CAAC"}
1	+ {"version":3,"file":"point-contracts.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/point-contracts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,kBAAkB,GAEnB,MAAM,2BAA2B,CAAC;AAEnC,kFAAkF;AAClF,MAAM,CAAC,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,MAAM,CAAC;IACzD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IAC9E,OAAO,EAAE,mBAAmB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAC9C,0EAA0E,CAC3E;IACD,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,CAAC,kFAAkF,CAAC;IAC/F,cAAc,EAAE,mBAAmB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACrD,2FAA2F,CAC5F;CACF,CAAC,CAAC;AAEH,+GAA+G;AAC/G,MAAM,UAAU,YAAY,CAC1B,OAAqB,EACrB,QAA4B,EAC5B,GAAY,EACZ,UAAkB;IAElB,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,OAAO,MAAM,CAAC,YAAY,CAAC,kBAAkB,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE;QACxF,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,KAAK,CAAC,gBAAgB,CAAC,WAAW,EAAE,KAAK,EAAE;YACxD,UAAU,EAAE,KAAK,CAAC,WAAW,EAAE;YAC/B,WAAW,EAAE,KAAK,CAAC,SAAS;SAC7B,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,GAAG,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QAC1D,OAAO,MAAM,CAAC,YAAY,CACxB,MAAM,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAC3C,QAAQ,EACR,OAAO,EACP,UAAU,EACV,KAAK,CACN,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/services/canvas/canvas-service.d.ts CHANGED Viewed

@@ -3,13 +3,36 @@ import type { DataCanvas } from '@cyanheads/mcp-ts-core/canvas';
 import type { AppConfig } from '@cyanheads/mcp-ts-core/config';
 import type { StorageService } from '@cyanheads/mcp-ts-core/storage';
 import { type ServerConfig } from '../../config/server-config.js';
+import { type PowerDataset } from '../power/index.js';
+import { type ComparisonShape, type RegionShape, type SplitPlanner } from './inline-split.js';
 import { type ComparisonDataset, type PresentableDataset, type PresentedDataset, type RegionalSummaryDataset, type ScientificColumn } from './types.js';
 type SummaryTable = {
-    key: 'buckets' | 'locations' | 'regional';
+    /** `summaries` returns as `summaryDataset`; `buckets` and `locations` as `summaryDatasets`. */
+    key: 'buckets' | 'locations' | 'summaries';
     table: string;
     rows: Record<string, string | number | boolean | null | undefined>[];
     columns: ScientificColumn[];
 };
+/**
+ * One admitted producing call. Its deadline started at tool entry, so admission wait, fetch,
+ * normalization and staging share it. The reservation starts at the caller's estimate and grows
+ * atomically when measured bytes exceed it; growth that would breach the tenant or process
+ * in-flight ceiling aborts the call with `producer_capacity_exhausted`.
+ */
+export type ProducerLease = {
+    /** Milliseconds left of the call deadline. */
+    remainingMs(): number;
+    /** Record the decoded upstream body bytes this call holds now; a discarded attempt's body is not held. */
+    bodyBytes(total: number): void;
+    /** Record the normalized row bytes this call holds so far. */
+    rowBytes(total: number): void;
+};
+/** Presentation inputs beyond the dataset; producers pass their lease and split planner. */
+export type PresentOptions = {
+    lease?: ProducerLease | undefined;
+    /** Sizes the `canvas_required` refusal's split; defaults to the inline row-prefix capacity alone. */
+    split?: SplitPlanner;
+};
 /** Service dependencies; native lifecycle settings are supplied to the framework at startup. */
 export type CanvasServiceOptions = {
     canvas?: DataCanvas;
@@ -28,6 +51,7 @@ export declare class CanvasService {
     private readonly canvasLimits;
     private readonly records;
     private readonly producers;
+    private readonly waiters;
     private readonly operations;
     private readonly shutdownController;
     private queryCount;
@@ -37,15 +61,44 @@ export declare class CanvasService {
     constructor(options: CanvasServiceOptions);
     /** Availability is a configuration fact; native initialization can still fail. */
     get enabled(): boolean;
-    /** Producer admission includes cache-hit copies and spans fetch through presentation. */
-    withProducer<T>(kind: 'single' | 'comparison', ctx: Context, run: (ctx: Context) => Promise<T>): Promise<T>;
+    /**
+     * Run one producing call under an in-flight reservation of `estimateBytes`, an upper bound the
+     * caller computes from its request before fetching (see `producer-estimate.ts`). The call's
+     * deadline starts here, at tool entry. When the producer count or the tenant or process byte
+     * ceiling is exhausted, admission waits up to the queue wait inside that deadline, admitting
+     * waiters in arrival order as capacity frees. A call that fits may overtake a waiting one until
+     * the oldest waiter has waited the overtake window; after that, calls queue behind it, so it
+     * cannot be starved by smaller calls that keep its bytes in use. A call still waiting is refused with
+     * `producer_capacity_exhausted`. A waiting call aborted by its caller rejects with the caller's
+     * reason and holds no reservation; shutdown rejects every waiter.
+     */
+    withProducer<T>(estimateBytes: number, ctx: Context, run: (ctx: Context, lease: ProducerLease) => Promise<T>): Promise<T>;
+    /** Reserve atomically when both counts and byte ceilings allow it; otherwise nothing changes. */
+    private tryAdmit;
+    /** Admit at once, or queue until capacity frees, the caller aborts, the wait ends, or shutdown. */
+    private admit;
+    /** Whether a waiter has waited long enough that later calls may no longer overtake it. */
+    private overtakeClosed;
+    /**
+     * Release and waiter-exit path: admit each queued call, in arrival order, that now fits,
+     * stopping at a waiter that does not fit once later calls may no longer overtake it.
+     */
+    private admitWaiters;
     /** Stage comparison summaries with observations only when the scientific envelope overflows. */
-    presentComparison<T extends ComparisonDataset>(dataset: T, canvasId: string | undefined, ctx: Context, sourceTool: string): Promise<PresentedDataset<T>>;
+    presentComparison<T extends ComparisonDataset & ComparisonShape>(dataset: T, canvasId: string | undefined, ctx: Context, sourceTool: string, lease?: ProducerLease): Promise<PresentedDataset<T>>;
     /** Stage complete cross-cell summaries when the no-observation regional envelope overflows. */
-    presentRegion<T extends RegionalSummaryDataset>(dataset: T, canvasId: string | undefined, ctx: Context, sourceTool: string): Promise<PresentedDataset<T>>;
+    presentRegion<T extends RegionalSummaryDataset & RegionShape>(dataset: T, canvasId: string | undefined, ctx: Context, sourceTool: string, lease?: ProducerLease): Promise<PresentedDataset<T>>;
+    /** Stage complete per-column summaries when the no-observation point envelope overflows. */
+    presentPoint<T extends PowerDataset>(dataset: T, canvasId: string | undefined, ctx: Context, sourceTool: string, lease?: ProducerLease): Promise<PresentedDataset<T>>;
+    /**
+     * Present unchanged when the envelope without observations fits. Otherwise one summary stays
+     * inline beside the exact `summaryCount`, and the complete summaries stage as a related table
+     * ordered by `summaryIndex`. The split planner always sees the complete dataset.
+     */
+    private presentSummarized;
     private summaryTable;
     /** Preserve the scientific envelope with complete staging and bounded whole-row previews. */
-    present<T extends PresentableDataset>(dataset: T, canvasId: string | undefined, ctx: Context, sourceTool: string, related?: SummaryTable[]): Promise<PresentedDataset<T>>;
+    present<T extends PresentableDataset>(dataset: T, canvasId: string | undefined, ctx: Context, sourceTool: string, options?: PresentOptions, related?: SummaryTable[]): Promise<PresentedDataset<T>>;
     /** Inspect only the supplied canvas, including original scientific provenance. */
     describe(canvasId: string, input: {
         table?: string;

package/dist/services/canvas/canvas-service.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"canvas-service.d.ts","sourceRoot":"","sources":["../../../src/services/canvas/canvas-service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAGV,UAAU,EAEX,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAC;~~AAI5E~~,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EAIrB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAC;AAEpB,KAAK,YAAY,GAAG;IAClB,GAAG,EAAE,SAAS,GAAG,WAAW,GAAG,~~UAAU~~,CAAC;~~IAC1C~~,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,CAAC;IACrE,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B,CAAC;~~AAuBF~~,gGAAgG;AAChG,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,OAAO,EAAE,cAAc,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,MAAM,EAAE,YAAY,CAAC;IACrB,YAAY,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,sBAAsB,GAAG,eAAe,CAAC,CAAC;IACnF,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,oFAAoF;AACpF,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoD;IACjF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA+B;IAC1D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAyB;IAC5D,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IAEvD,YAAY,OAAO,EAAE,oBAAoB,EAexC;IAED,kFAAkF;IAClF,IAAI,OAAO,IAAI,OAAO,CAErB;IACD~~,yFAAyF~~;~~IACnF~~,YAAY,CAAC,CAAC,EAClB,~~IAAI~~,EAAE,~~QAAQ~~,~~GAAG~~,~~YAAY,EAC7B,~~GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,~~GAChC~~,OAAO,CAAC,CAAC,CAAC,~~CAyCZ~~;IAED,gGAAgG;IAChG,iBAAiB,CAAC,CAAC,SAAS,iBAAiB,~~EAC3C~~,OAAO,EAAE,CAAC,EACV,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,GAAG,EAAE,OAAO,EACZ,UAAU,EAAE,MAAM,~~gCAyBnB~~;IAED,+FAA+F;IAC/F,aAAa,CAAC,CAAC,SAAS,sBAAsB,~~EAC5C~~,OAAO,EAAE,CAAC,EACV,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,GAAG,EAAE,OAAO,EACZ,UAAU,EAAE,MAAM,~~gCAmBnB~~;IAED,OAAO,CAAC,YAAY;IAkCpB,6FAA6F;IACvF,OAAO,CAAC,CAAC,SAAS,kBAAkB,EACxC,OAAO,EAAE,CAAC,EACV,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,GAAG,EAAE,OAAO,EACZ,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,YAAY,EAAO,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,~~CA4J9B~~;IAED,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;OA0CjE;IAED,kFAAkF;IAC5E,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,EAAE,OAAO;;;;;;;;OA2CpF;IAED,+EAA+E;IACzE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,EAAE,OAAO;;;;OAmBlE;IAED,mFAAmF;IACnF,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAMzB;IAED,uFAAuF;IACjF,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,~~CAS9B~~;IAED,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,YAAY;IAGpB,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,OAAO;IAyCf,OAAO,CAAC,IAAI;IAUZ,OAAO,CAAC,OAAO;IAcf,OAAO,CAAC,OAAO;~~YA4ED~~,KAAK;IAoGnB,OAAO,CAAC,YAAY;YAMN,OAAO;YAqCP,cAAc;YAId,aAAa;YAYb,KAAK;CA0CpB;AAED,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAEhF;AAED,0DAA0D;AAC1D,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAG9E;AACD,yDAAyD;AACzD,wBAAgB,gBAAgB,IAAI,aAAa,CAGhD"}
1	+ {"version":3,"file":"canvas-service.d.ts","sourceRoot":"","sources":["../../../src/services/canvas/canvas-service.ts"],"names":[],"mappings":"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"}

package/dist/services/canvas/canvas-service.js CHANGED Viewed

@@ -5,6 +5,7 @@ import { POWER_LIMITS } from '../../config/server-config.js';
 import { powerError } from '../power/index.js';
 import { canvasError, safeCanvasError } from './errors.js';
 import { formatFaithfully } from './format.js';
+import { comparisonSplit, pointSplit, prefixSplit, regionSplit, splitRecovery, } from './inline-split.js';
 import { ProvenanceSchema, QueryResultSchema, } from './types.js';
 /** Explicit token access, atomic admission, and native-lifecycle reconciliation. */
 export class CanvasService {
@@ -15,6 +16,7 @@ export class CanvasService {
     canvasLimits;
     records = new Map();
     producers = new Set();
+    waiters = [];
     operations = new Set();
     shutdownController = new AbortController();
     queryCount = 0;
@@ -41,48 +43,151 @@ export class CanvasService {
     get enabled() {
         return this.canvas !== undefined;
     }
-    /** Producer admission includes cache-hit copies and spans fetch through presentation. */
-    async withProducer(kind, ctx, run) {
+    /**
+     * Run one producing call under an in-flight reservation of `estimateBytes`, an upper bound the
+     * caller computes from its request before fetching (see `producer-estimate.ts`). The call's
+     * deadline starts here, at tool entry. When the producer count or the tenant or process byte
+     * ceiling is exhausted, admission waits up to the queue wait inside that deadline, admitting
+     * waiters in arrival order as capacity frees. A call that fits may overtake a waiting one until
+     * the oldest waiter has waited the overtake window; after that, calls queue behind it, so it
+     * cannot be starved by smaller calls that keep its bytes in use. A call still waiting is refused with
+     * `producer_capacity_exhausted`. A waiting call aborted by its caller rejects with the caller's
+     * reason and holds no reservation; shutdown rejects every waiter.
+     */
+    async withProducer(estimateBytes, ctx, run) {
         this.assertRunning();
         ctx.signal.throwIfAborted();
-        const bytes = (kind === 'comparison' ? POWER_LIMITS.comparisonBodyBytes : POWER_LIMITS.bodyBytes) +
-            POWER_LIMITS.rowBytes;
+        const tenant = this.tenant(ctx);
+        const entered = this.now();
+        const deadline = new AbortController();
+        const timer = setTimeout(() => deadline.abort(new DOMException('The operation timed out.', 'TimeoutError')), POWER_LIMITS.deadlineMs);
+        let producer;
+        try {
+            producer = await this.admit(tenant, estimateBytes, ctx.signal);
+            const admitted = producer;
+            const signal = AbortSignal.any([
+                ctx.signal,
+                admitted.controller.signal,
+                this.shutdownController.signal,
+                deadline.signal,
+            ]);
+            const measured = { body: 0, rows: 0 };
+            const grow = () => {
+                const total = measured.body + measured.rows;
+                if (total <= admitted.bytes)
+                    return;
+                const others = [...this.producers].filter((item) => item !== admitted);
+                const sum = (items) => items.reduce((acc, item) => acc + item.bytes, 0);
+                if (sum(others) + total > POWER_LIMITS.processInflightBytes ||
+                    sum(others.filter((item) => item.tenant === admitted.tenant)) + total >
+                        POWER_LIMITS.tenantInflightBytes) {
+                    const error = canvasError('producer_capacity_exhausted', 'This data call outgrew its in-flight reservation while other data calls hold the remaining capacity.');
+                    admitted.controller.abort(error);
+                    throw error;
+                }
+                admitted.bytes = total;
+            };
+            return await run({ ...ctx, signal }, {
+                remainingMs: () => Math.max(0, entered + POWER_LIMITS.deadlineMs - this.now()),
+                bodyBytes: (total) => {
+                    measured.body = total;
+                    grow();
+                },
+                rowBytes: (total) => {
+                    measured.rows = total;
+                    grow();
+                },
+            });
+        }
+        finally {
+            clearTimeout(timer);
+            if (producer) {
+                this.producers.delete(producer);
+                producer.finish();
+                this.admitWaiters();
+            }
+        }
+    }
+    /** Reserve atomically when both counts and byte ceilings allow it; otherwise nothing changes. */
+    tryAdmit(tenant, bytes) {
         const active = [...this.producers];
-        const total = active.reduce((sum, p) => sum + p.bytes, 0);
-        const tenant = active
-            .filter((p) => p.tenant === ctx.tenantId)
-            .reduce((sum, p) => sum + p.bytes, 0);
+        const total = active.reduce((sum, item) => sum + item.bytes, 0);
+        const owned = active
+            .filter((item) => item.tenant === tenant)
+            .reduce((sum, item) => sum + item.bytes, 0);
         if (active.length >= POWER_LIMITS.producers ||
             total + bytes > POWER_LIMITS.processInflightBytes ||
-            tenant + bytes > POWER_LIMITS.tenantInflightBytes)
-            throw canvasError('canvas_capacity_exhausted', 'Producer memory or concurrency capacity is exhausted.');
-        const controller = new AbortController();
-        const signal = AbortSignal.any([
-            ctx.signal,
-            controller.signal,
-            this.shutdownController.signal,
-            AbortSignal.timeout(POWER_LIMITS.deadlineMs),
-        ]);
+            owned + bytes > POWER_LIMITS.tenantInflightBytes)
+            return undefined;
         const { promise: settled, resolve: finish } = Promise.withResolvers();
         const producer = {
-            tenant: this.tenant(ctx),
+            tenant,
             bytes,
-            controller,
+            controller: new AbortController(),
             settled,
+            finish,
         };
         this.producers.add(producer);
-        try {
-            return await run({ ...ctx, signal });
-        }
-        finally {
-            this.producers.delete(producer);
-            finish();
+        return producer;
+    }
+    /** Admit at once, or queue until capacity frees, the caller aborts, the wait ends, or shutdown. */
+    admit(tenant, bytes, signal) {
+        const head = this.waiters[0];
+        const immediate = !head || !this.overtakeClosed(head) ? this.tryAdmit(tenant, bytes) : undefined;
+        if (immediate)
+            return Promise.resolve(immediate);
+        return new Promise((resolve, reject) => {
+            const settle = () => {
+                clearTimeout(timer);
+                signal.removeEventListener('abort', onAbort);
+                this.waiters.splice(this.waiters.indexOf(waiter), 1);
+            };
+            const waiter = {
+                tenant,
+                bytes,
+                since: this.now(),
+                admit: (producer) => {
+                    settle();
+                    resolve(producer);
+                },
+                refuse: (error) => {
+                    settle();
+                    reject(error);
+                },
+            };
+            /** A waiter that leaves may have been the head holding later calls that already fit. */
+            const leave = (error) => {
+                waiter.refuse(error);
+                this.admitWaiters();
+            };
+            const onAbort = () => leave(signal.reason);
+            const timer = setTimeout(() => leave(canvasError('producer_capacity_exhausted', 'Other data calls held the producer capacity for the whole admission wait.')), POWER_LIMITS.queueWaitMs);
+            signal.addEventListener('abort', onAbort, { once: true });
+            this.waiters.push(waiter);
+        });
+    }
+    /** Whether a waiter has waited long enough that later calls may no longer overtake it. */
+    overtakeClosed(waiter) {
+        return this.now() - waiter.since >= POWER_LIMITS.queueOvertakeMs;
+    }
+    /**
+     * Release and waiter-exit path: admit each queued call, in arrival order, that now fits,
+     * stopping at a waiter that does not fit once later calls may no longer overtake it.
+     */
+    admitWaiters() {
+        for (const waiter of [...this.waiters]) {
+            const producer = this.tryAdmit(waiter.tenant, waiter.bytes);
+            if (producer)
+                waiter.admit(producer);
+            else if (this.overtakeClosed(waiter))
+                return;
         }
     }
     /** Stage comparison summaries with observations only when the scientific envelope overflows. */
-    presentComparison(dataset, canvasId, ctx, sourceTool) {
+    presentComparison(dataset, canvasId, ctx, sourceTool, lease) {
+        const options = { lease, split: comparisonSplit(dataset) };
         if (this.fits({ ...dataset, rows: [], rowCount: dataset.rows.length, dataset: null }))
-            return this.present(dataset, canvasId, ctx, sourceTool);
+            return this.present(dataset, canvasId, ctx, sourceTool, options);
         const summaryRows = {
             buckets: dataset.summaries.map((summary, summaryIndex) => ({ ...summary, summaryIndex })),
             locations: dataset.locations
@@ -99,18 +204,36 @@ export class CanvasService {
                 summaryCount: location.summaries.length,
             })),
         };
-        return this.present(compact, canvasId, ctx, sourceTool, tables);
+        return this.present(compact, canvasId, ctx, sourceTool, options, tables);
     }
     /** Stage complete cross-cell summaries when the no-observation regional envelope overflows. */
-    presentRegion(dataset, canvasId, ctx, sourceTool) {
+    presentRegion(dataset, canvasId, ctx, sourceTool, lease) {
+        return this.presentSummarized(dataset, canvasId, ctx, sourceTool, {
+            lease,
+            split: regionSplit(dataset),
+        });
+    }
+    /** Stage complete per-column summaries when the no-observation point envelope overflows. */
+    presentPoint(dataset, canvasId, ctx, sourceTool, lease) {
+        return this.presentSummarized(dataset, canvasId, ctx, sourceTool, {
+            lease,
+            split: pointSplit(dataset),
+        });
+    }
+    /**
+     * Present unchanged when the envelope without observations fits. Otherwise one summary stays
+     * inline beside the exact `summaryCount`, and the complete summaries stage as a related table
+     * ordered by `summaryIndex`. The split planner always sees the complete dataset.
+     */
+    presentSummarized(dataset, canvasId, ctx, sourceTool, options) {
         if (this.fits({ ...dataset, rows: [], rowCount: dataset.rows.length, dataset: null }))
-            return this.present(dataset, canvasId, ctx, sourceTool);
-        const summaries = this.summaryTable('regional', dataset.summaries.map((summary, summaryIndex) => ({ ...summary, summaryIndex })));
+            return this.present(dataset, canvasId, ctx, sourceTool, options);
+        const summaries = this.summaryTable('summaries', dataset.summaries.map((summary, summaryIndex) => ({ ...summary, summaryIndex })));
         return this.present({
             ...dataset,
             summaries: dataset.summaries.slice(0, 1),
             summaryCount: dataset.summaries.length,
-        }, canvasId, ctx, sourceTool, [summaries]);
+        }, canvasId, ctx, sourceTool, options, [summaries]);
     }
     summaryTable(key, rows) {
         const strings = new Set([
@@ -146,7 +269,7 @@ export class CanvasService {
         };
     }
     /** Preserve the scientific envelope with complete staging and bounded whole-row previews. */
-    async present(dataset, canvasId, ctx, sourceTool, related = []) {
+    async present(dataset, canvasId, ctx, sourceTool, options = {}, related = []) {
         this.assertRunning();
         ctx.signal.throwIfAborted();
         const serialized = JSON.stringify(dataset.rows);
@@ -157,6 +280,7 @@ export class CanvasService {
             related.some((item) => item.rows.length > POWER_LIMITS.rows) ||
             dataset.parameters.length > POWER_LIMITS.columns)
             throw powerError('dataset_limit', 'Normalized dataset exceeds the analytical workload limit.');
+        options.lease?.rowBytes(bytes + relatedBytes);
         const inline = { ...dataset, rowCount: dataset.rows.length, dataset: null };
         if (!related.length && this.fits(inline))
             return inline;
@@ -174,10 +298,10 @@ export class CanvasService {
             queryTool: 'nasa_power_dataframe_query',
         });
         const relatedHandles = (id, expiresAt) => {
-            const regional = related.find((item) => item.key === 'regional');
-            if (regional)
+            const summaries = related.find((item) => item.key === 'summaries');
+            if (summaries)
                 return {
-                    summaryDataset: handle(id, expiresAt, regional.table, regional.rows.length, regional.columns),
+                    summaryDataset: handle(id, expiresAt, summaries.table, summaries.rows.length, summaries.columns),
                 };
             const buckets = related.find((item) => item.key === 'buckets');
             const locations = related.find((item) => item.key === 'locations');
@@ -199,8 +323,11 @@ export class CanvasService {
         });
         const preview = this.preview(dataset.rows, (rows) => output('0000000000', new Date(this.now()).toISOString(), rows));
         const canvas = this.canvas;
-        if (!canvas)
-            throw canvasError('canvas_required', 'This complete dataset requires an analytical workspace.');
+        if (!canvas) {
+            const rowCount = dataset.rows.length;
+            const split = (options.split ?? prefixSplit(dataset))((output) => this.fits(output));
+            throw canvasError('canvas_required', 'This complete dataset requires an analytical workspace.', splitRecovery(rowCount, split), { rowCount, inlineRows: split.inlineRows, calls: split.calls });
+        }
         await this.reconcile();
         ctx.signal.throwIfAborted();
         const record = this.reserve(canvasId, ctx, table, bytes, columns, dataset, sourceTool, related);
@@ -293,7 +420,7 @@ export class CanvasService {
             ? 'The effective row limit is 1000; larger requested limits are capped.'
             : undefined;
         if (this.queryCount >= POWER_LIMITS.queries)
-            throw canvasError('canvas_capacity_exhausted', 'Analytical query concurrency is exhausted.');
+            throw canvasError('canvas_busy', 'Analytical query concurrency is exhausted.');
         this.queryCount++;
         try {
             return await this.operate(canvasId, ctx, async (instance) => {
@@ -358,6 +485,8 @@ export class CanvasService {
         this.stopped = true;
         clearInterval(this.timer);
         this.shutdownController.abort();
+        for (const waiter of [...this.waiters])
+            waiter.refuse(new McpError(JsonRpcErrorCode.ServiceUnavailable, 'Analytical workspace is shutting down.'));
         for (const producer of this.producers)
             producer.controller.abort();
         await Promise.allSettled([...this.producers].map((producer) => producer.settled));
@@ -446,10 +575,11 @@ export class CanvasService {
             throw canvasError('canvas_capacity_exhausted', 'The process or tenant canvas-count limit is exhausted.', this.config.dataframeDropEnabled
                 ? 'Reuse an explicit live canvas_id, drop all tables from a canvas, or wait for canvas expiry.'
                 : 'Reuse an explicit live canvas_id, or wait for canvas expiry.');
+        if (record?.busy)
+            throw canvasError('canvas_busy', 'Another operation is active on this canvas.');
         if (retained(records) + bytes + relatedBytes > POWER_LIMITS.processRetainedBytes ||
             retained(tenantRecords) + bytes + relatedBytes > POWER_LIMITS.tenantRetainedBytes ||
-            (record &&
-                (record.busy || record.tables.size + 1 + related.length > POWER_LIMITS.tablesPerCanvas)))
+            (record && record.tables.size + 1 + related.length > POWER_LIMITS.tablesPerCanvas))
             throw canvasError('canvas_capacity_exhausted', 'Analytical workspace memory or table capacity is exhausted.');
         const { rows: _rows, ...envelope } = dataset;
         const provenance = ProvenanceSchema.parse({
@@ -582,7 +712,7 @@ export class CanvasService {
         if (!record || record.tenant !== ctx.tenantId || record.pending)
             throw canvasError('canvas_not_found', 'Canvas not found or expired.', drop ? 'The canvas has expired or is absent; there is nothing left to remove.' : undefined);
         if (record.busy)
-            throw canvasError('canvas_capacity_exhausted', 'Another operation is active on this canvas.');
+            throw canvasError('canvas_busy', 'Another operation is active on this canvas.');
         record.busy = true;
         const operation = (async () => {
             try {