@larkup/workspace-server 0.2.14 → 0.2.16

package/dist-types/app/api/chat/route.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../../src/app/api/chat/route.ts"],"names":[],"mappings":"AAqHA,eAAO,MAAM,WAAW,MAAM,CAAC;AAiuB/B,wBAAsB,IAAI,CAAC,GAAG,EAAE,OAAO,qBA69CtC"}
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../../src/app/api/chat/route.ts"],"names":[],"mappings":"AAuHA,eAAO,MAAM,WAAW,MAAM,CAAC;AAquB/B,wBAAsB,IAAI,CAAC,GAAG,EAAE,OAAO,qBA+/CtC"}

package/dist-types/app/api/chat/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../../src/app/api/chat/tools.ts"],"names":[],"mappings":"AA+WA,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0I7F;AAyVD,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iGAAiG;IACjG,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,gGAAgG;IAChG,iBAAiB,CAAC,EAAE;QAClB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;KACtC,CAAC;IACF,oFAAoF;IACpF,wBAAwB,CAAC,EAAE;QACzB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;KACtC,CAAC;IACF,2FAA2F;IAC3F,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;;;;;;GAumFA"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../../src/app/api/chat/tools.ts"],"names":[],"mappings":"AAoXA,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0I7F;AAyVD,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iGAAiG;IACjG,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,gGAAgG;IAChG,iBAAiB,CAAC,EAAE;QAClB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;KACtC,CAAC;IACF,oFAAoF;IACpF,wBAAwB,CAAC,EAAE;QACzB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;KACtC,CAAC;IACF,2FAA2F;IAC3F,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;;;;;;GAmnFA"}

package/dist-types/lib/chat/analysis-presentation.d.ts

@@ -0,0 +1,34 @@
+export interface AnalysisTablePresentation {
+    kind: 'table';
+    title: string;
+    summary?: string;
+    columns: string[];
+    rows: Array<Record<string, string | number | boolean | null>>;
+    totalItems: number;
+    requestedItems?: number;
+    complete: boolean;
+    fileName?: string;
+}
+export interface AnalysisDocumentPage {
+    title?: string;
+    content: string;
+}
+export interface AnalysisDocumentPresentation {
+    kind: 'document';
+    title: string;
+    summary?: string;
+    pages: AnalysisDocumentPage[];
+    totalItems: number;
+    requestedItems?: number;
+    complete: boolean;
+    fileName?: string;
+}
+export type AnalysisPresentation = AnalysisTablePresentation | AnalysisDocumentPresentation;
+export declare function extractAnalysisPresentation(stdout: string): {
+    stdout: string;
+    presentation?: AnalysisPresentation;
+};
+/** Injected before generated Python so long results have one stable UI contract. */
+export declare const ANALYSIS_PRESENTATION_PYTHON: string;
+export declare function withAnalysisPresentationHelpers(code: string, requestedItems?: number): string;
+//# sourceMappingURL=analysis-presentation.d.ts.map

package/dist-types/lib/chat/analysis-presentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-presentation.d.ts","sourceRoot":"","sources":["../../../src/lib/chat/analysis-presentation.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,oBAAoB,GAAG,yBAAyB,GAAG,4BAA4B,CAAC;AAkH5F,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,oBAAoB,CAAC;CACrC,CAqBA;AAED,oFAAoF;AACpF,eAAO,MAAM,4BAA4B,QAmCxC,CAAC;AAEF,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAG7F"}

package/dist-types/lib/chat/conversation-memory.d.ts

@@ -21,6 +21,13 @@ export type ReusableTabularEvidence = {
     rows: Array<Record<string, unknown>>;
     totalRows: number;
 };
+export type AnalysisArtifactSummary = {
+    kind: 'table' | 'document';
+    title: string;
+    totalItems: number;
+    requestedItems?: number;
+    complete: boolean;
+};
 /** Only reuse table evidence while its source is still present in the live data store. */
 export declare function tabularEvidenceDatasetIsAvailable(evidence: ReusableTabularEvidence | undefined, availableDatasetIds: ReadonlySet<string>): boolean;
 export type ConversationEvidence = {
@@ -42,6 +49,8 @@ export type ConversationEvidence = {
  * answers keep their specialized verification paths and are never reused here.
  */
 export declare function findImmediateExactGroundedAnswer(messages: readonly ChatMessage[], currentQuestion: string): ExactGroundedAnswer | undefined;
+/** Read only completion metadata; the full paged artifact remains in the UI message. */
+export declare function extractLatestAnalysisArtifact(messages: readonly ChatMessage[]): AnalysisArtifactSummary | undefined;
 /** Keep the complete bounded query result for an immediate export follow-up. */
 export declare function extractLatestTabularExportResult(messages: readonly ChatMessage[]): ReusableTabularEvidence | undefined;
 /** Keep only enough exact table evidence for a direct follow-up, never raw sheets. */

package/dist-types/lib/chat/conversation-memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-memory.d.ts","sourceRoot":"","sources":["../../../src/lib/chat/conversation-memory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"conversation-memory.d.ts","sourceRoot":"","sources":["../../../src/lib/chat/conversation-memory.ts"],"names":[],"mappings":"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"}

package/dist-types/lib/chat/tabular-query-plan.d.ts

@@ -1,8 +1,10 @@
-import type { TabularDataset, TabularQueryRequest } from '@larkup/core/tabular-store';
+import { type TabularDataset, type TabularQueryRequest } from '@larkup/core/tabular-store';
 export type InferredTabularPlan = {
     request: TabularQueryRequest;
     chartTitle?: string;
 };
+/** Preserve an explicit long-list size instead of relying on a model default. */
+export declare function requestedTabularResultLimit(text: string): number | undefined;
 /**
  * Normalize a clear calendar request from the dataset schema. It never
  * assumes business columns or domain names: a time series is derived only

package/dist-types/lib/chat/tabular-query-plan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tabular-query-plan.d.ts","sourceRoot":"","sources":["../../../src/lib/chat/tabular-query-plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAiHF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,mBAAmB,GAC3B,mBAAmB,CAmErB"}
+{"version":3,"file":"tabular-query-plan.d.ts","sourceRoot":"","sources":["../../../src/lib/chat/tabular-query-plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACzB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AA2EF,iFAAiF;AACjF,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQ5E;AAwCD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,mBAAmB,GAC3B,mBAAmB,CAuErB"}

package/dist-types/lib/chat/tabular-routing.d.ts

@@ -28,6 +28,14 @@ export declare function hasCompletedTabularVisualizationStep(steps: Array<{
  * column names.
  */
 export declare function requiresTabularSandbox(text: string): boolean;
+/**
+ * Long per-record transformations cannot be completed safely as streamed prose:
+ * the model will eventually hit its output ceiling and a later "continue" loses
+ * global constraints. Route these through one sandbox run and a paged artifact.
+ */
+export declare function requestsLongAnalysisArtifact(text: string): boolean;
+/** Preserve explicit batch sizes for sandbox artifacts (larger than chat prose limits). */
+export declare function requestedLongAnalysisItemCount(text: string): number | undefined;
 /**
  * A workspace can contain spreadsheets alongside PDFs, media, and notes.
  * Only force the table path when the wording actually asks for tabular facts;

package/dist-types/lib/chat/tabular-routing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tabular-routing.d.ts","sourceRoot":"","sources":["../../../src/lib/chat/tabular-routing.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;;;;;;;;;EAqBA;AAED,gFAAgF;AAChF,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,KAAK,CAAC;IACX,WAAW,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CAClC,CAAC,WAgBH;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAI5D;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,WA8CA"}
+{"version":3,"file":"tabular-routing.d.ts","sourceRoot":"","sources":["../../../src/lib/chat/tabular-routing.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;;;;;;;;;EAqBA;AAED,gFAAgF;AAChF,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,KAAK,CAAC;IACX,WAAW,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CAClC,CAAC,WAgBH;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAM5D;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAUlE;AAED,2FAA2F;AAC3F,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAM/E;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,WA8CA"}

package/dist-types/lib/chat/tabular-visualization.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tabular-visualization.d.ts","sourceRoot":"","sources":["../../../src/lib/chat/tabular-visualization.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7C,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,KAAK,0BAA0B,GAAG;IAChC,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAoBF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAI3D;AA+BD,0EAA0E;AAC1E,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;CAAE,GAC7D,kBAAkB,GAAG,SAAS,CAsDhC;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,0BAA0B,GAAG,MAAM,CA4B3F"}
+{"version":3,"file":"tabular-visualization.d.ts","sourceRoot":"","sources":["../../../src/lib/chat/tabular-visualization.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7C,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,KAAK,0BAA0B,GAAG;IAChC,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAoBF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAU3D;AA+BD,0EAA0E;AAC1E,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;CAAE,GAC7D,kBAAkB,GAAG,SAAS,CAsDhC;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,0BAA0B,GAAG,MAAM,CA4B3F"}

package/dist-types/lib/chat/tool-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-context.d.ts","sourceRoot":"","sources":["../../../src/lib/chat/tool-context.ts"],"names":[],"mappings":"AAUA;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAmBpE;AAED,0EAA0E;AAC1E,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAgB/D;AAED,kFAAkF;AAClF,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAmBxE;AAmBD,oEAAoE;AACpE,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAuB7F;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CA+D1E;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAyDrE;AAED;;;;;GAKG;AACH,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CA4KrF;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,OAAO,EACd,aAAa,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GACtD,MAAM,GAAG,SAAS,CAwGpB;AAED,sFAAsF;AACtF,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,aAAa,EAAE,2BAA2B,GACzC,MAAM,GAAG,SAAS,CAyHpB;AAED,8FAA8F;AAC9F,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAK,GAAG,MAAM,GAAG,SAAS,CAqE/F;AAED,8EAA8E;AAC9E,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CA2BvE;AAED,sGAAsG;AACtG,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA0D/F;AAYD;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA+IjG;AAED,gGAAgG;AAChG,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,MAAM,mCAwC/D;AAkLD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,CAapE;AAED,uFAAuF;AACvF,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,CAiB1E;AACD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,4CAA4C,CAAC"}
+{"version":3,"file":"tool-context.d.ts","sourceRoot":"","sources":["../../../src/lib/chat/tool-context.ts"],"names":[],"mappings":"AAUA;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAmBpE;AAED,0EAA0E;AAC1E,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAgB/D;AAED,kFAAkF;AAClF,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAmBxE;AAmBD,oEAAoE;AACpE,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAuB7F;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CA+D1E;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAyDrE;AAED;;;;;GAKG;AACH,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CA4KrF;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,OAAO,EACd,aAAa,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GACtD,MAAM,GAAG,SAAS,CAwGpB;AAED,sFAAsF;AACtF,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,aAAa,EAAE,2BAA2B,GACzC,MAAM,GAAG,SAAS,CAyHpB;AAED,8FAA8F;AAC9F,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAK,GAAG,MAAM,GAAG,SAAS,CAqE/F;AAED,8EAA8E;AAC9E,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CA2BvE;AAED,sGAAsG;AACtG,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA0D/F;AAYD;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA+IjG;AAED,gGAAgG;AAChG,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,MAAM,mCAwC/D;AAmMD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,CAapE;AAED,uFAAuF;AACvF,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,CAiB1E;AACD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,4CAA4C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@larkup/workspace-server",
-  "version": "0.2.14",
+  "version": "0.2.16",
   "type": "module",
   "files": [
     "src",
@@ -53,6 +53,11 @@
       "import": "./src/lib/chat/assistant-source-scope.ts",
       "default": "./src/lib/chat/assistant-source-scope.ts"
     },
+    "./lib/chat/analysis-presentation": {
+      "types": "./dist-types/lib/chat/analysis-presentation.d.ts",
+      "import": "./src/lib/chat/analysis-presentation.ts",
+      "default": "./src/lib/chat/analysis-presentation.ts"
+    },
     "./lib/chat/conversation-memory": {
       "types": "./dist-types/lib/chat/conversation-memory.d.ts",
       "import": "./src/lib/chat/conversation-memory.ts",
@@ -326,8 +331,8 @@
     "mammoth": "^1.12.0",
     "@larkup/marketplace": "0.3.11",
     "@larkup/sandbox": "0.1.8",
-    "@larkup/scraper": "0.2.2",
-    "@larkup/vector-stores": "0.1.27"
+    "@larkup/vector-stores": "0.1.27",
+    "@larkup/scraper": "0.2.2"
   },
   "devDependencies": {
     "typescript": "^7.0.2",

package/src/app/api/chat/route.ts

@@ -44,6 +44,7 @@ import { collectExhaustiveVideoEvidencePages } from '../../../lib/chat/video-rag
 import { reconcileVideoInvestigation } from '../../../lib/chat/video-query-planning';
 import {
   extractConversationEvidence,
+  extractLatestAnalysisArtifact,
   extractLatestTabularExportResult,
   contextualizeKnowledgeFollowUpQuery,
   formatConversationEvidence,
@@ -78,6 +79,7 @@ import {
 } from '../../../lib/chat/tabular-visualization';
 import {
   isLikelyTabularQuestion,
+  requestsLongAnalysisArtifact,
   requiresTabularSandbox,
   tabularToolsForStep,
 } from '../../../lib/chat/tabular-routing';
@@ -176,6 +178,10 @@ ${PERSONALIZED_RESPONSE_STYLE}
 
 Keep the answer brief and direct: give the answer first, then only the essential context. Do not repeat tool output, dump rows, or add a table unless the user asks to see data. Use a short list only when it improves clarity.
 
+When a tabular tool returns a requested long list, the structured table is the complete visible answer. Briefly state what it contains and its coverage; never stream the rows again as prose or Markdown.
+
+When the user asks for a transformation repeated across many records (for example matches, recommendations, explanations, profiles, or summaries for the first 25 or for every item), use the sandbox analysis tool. It must prepare the whole requested result in one run with larkup_table or larkup_document. Treat that paged artifact as the answer: state its coverage briefly and never repeat its entries in chat prose. Do not ask the user to say "continue" for an artifact result.
+
 When the user asks for an Excel, CSV, or PDF export, use createDataExport. Never claim that a file was created and never write a Markdown download link unless the tool returned a real file artifact.
 
 When the user asks for every item and the media evidence marks its continuation as exhaustive, include every returned item in chronological order. In that case completeness overrides brevity; deduplicate wording but do not summarize items away.
@@ -1197,6 +1203,19 @@ ${fieldLines}`;
       ? precedingNumberedDocumentReference(messagesToProcess)
       : undefined;
   const reusableEvidence = extractConversationEvidence(evidenceMessages);
+  const latestAnalysisArtifact = extractLatestAnalysisArtifact(evidenceMessages);
+  if (
+    latestAnalysisArtifact?.complete &&
+    /^(?:continue|go\s+on|keep\s+going|show\s+the\s+rest|more|تابع|أكمل|اكمل)[.!\s]*$/iu.test(
+      userText.trim(),
+    )
+  ) {
+    const count = latestAnalysisArtifact.requestedItems ?? latestAnalysisArtifact.totalItems;
+    return directAssistantTextResponse(
+      messages,
+      `The complete ${count.toLocaleString()}-item result is already prepared in “${latestAnalysisArtifact.title}”. Use its page controls, search, or download button to inspect the rest without restarting the analysis.`,
+    );
+  }
   const latestTabularExportResult = extractLatestTabularExportResult(evidenceMessages);
   // This compact string is used by retrieval only, not appended to model
   // history. It preserves the immediate topic while keeping the model context
@@ -1217,8 +1236,11 @@ ${fieldLines}`;
     columnNames: tabularColumnNames,
     datasetNames: tabularDatasetNames,
   });
+  const requestsLongArtifact = requestsLongAnalysisArtifact(userText);
+  const requiresCorpusSandboxAnalysis = !tabularQuestion && requestsLongArtifact;
   const requiresSandboxAnalysis =
-    hasTabularData && tabularQuestion && requiresTabularSandbox(userText);
+    (hasTabularData && tabularQuestion && requiresTabularSandbox(userText)) ||
+    requiresCorpusSandboxAnalysis;
   const isExplicitVideoCorrection =
     /^(?:no|nah),\s+|\b(?:that(?:'s| is) (?:wrong|incorrect)|correction\s*:|actually\s*,|instead\s*,|should be|not .{0,80}\bbut|i meant)\b/i.test(
       userText,
@@ -1318,6 +1340,9 @@ ${fieldLines}`;
     createDataExport: allTools.createDataExport,
     generateVisualization: allTools.generateVisualization,
     ...(allTools.executeAnalysis ? { executeAnalysis: allTools.executeAnalysis } : {}),
+    ...(allTools.analyzeCorpusWithCode
+      ? { analyzeCorpusWithCode: allTools.analyzeCorpusWithCode }
+      : {}),
     inspectPdfPages: allTools.inspectPdfPages,
     analyzePdfPages: allTools.analyzePdfPages,
     analyzeImageDeeply: allTools.analyzeImageDeeply,
@@ -1340,6 +1365,7 @@ ${fieldLines}`;
     userText.trim() &&
     !isGreeting &&
     !docSessionId &&
+    !(requiresCorpusSandboxAnalysis && builtInTools.analyzeCorpusWithCode) &&
     (!hasTabularData || !tabularQuestion) &&
     builtInTools.searchKnowledgeBase,
   );
@@ -2106,6 +2132,20 @@ ${fieldLines}`;
               };
             }
 
+            if (requiresCorpusSandboxAnalysis && builtInTools.analyzeCorpusWithCode) {
+              return stepNumber === 0
+                ? {
+                    toolChoice: { type: 'tool' as const, toolName: 'analyzeCorpusWithCode' },
+                    activeTools: ['analyzeCorpusWithCode'],
+                    messages: compactToolContextForModel(messages),
+                  }
+                : {
+                    toolChoice: 'none' as const,
+                    activeTools: [],
+                    messages: withFinalAnswerNudge(compactToolContextForModel(messages)),
+                  };
+            }
+
             if (tabularFollowUp) {
               if (dataExportFormat && stepNumber === 1 && builtInTools.createDataExport) {
                 return {

package/src/app/api/chat/tools.ts

@@ -96,6 +96,7 @@ import { normalizeChartConfigWithEvidence } from '@larkup/core/chart-config';
 import { createDataExport, selectDataExportSource } from '@larkup/core/data-export';
 import { assistantSourceScopeFingerprint } from '../../../lib/chat/assistant-source-scope';
 import { inferTabularPlan } from '../../../lib/chat/tabular-query-plan';
+import { requestedLongAnalysisItemCount } from '../../../lib/chat/tabular-routing';
 import {
   resolveTabularDatasetForQuestion,
   selectTabularDatasetForQuestion,
@@ -104,6 +105,10 @@ import {
   createTabularSandboxFiles,
   remapLegacyMultiDatasetReads,
 } from '../../../lib/chat/tabular-sandbox-files';
+import {
+  extractAnalysisPresentation,
+  withAnalysisPresentationHelpers,
+} from '../../../lib/chat/analysis-presentation';
 import { leadingMediaAssetId } from '../../../lib/chat/media-retrieval-routing';
 import { findIndexedImageSource } from '../../../lib/chat/visual-routing';
 import { indexedVideoEvidenceIsSufficient } from '../../../lib/chat/video-rag-routing';
@@ -2759,12 +2764,12 @@ export async function getChatTools(context: {
 
     executeAnalysis: tool({
       description:
-        'Execute Python code in a secure sandbox for deep data analysis. Use this for complex statistical computations (correlations, regressions, clustering), data transformations, or when creating custom matplotlib visualizations. The code has access to pandas, numpy, matplotlib, scipy, scikit-learn, and seaborn. Always print results to stdout and use plt.show() for charts. The sandbox already configures headless plotting and its cache directories: do not set MPLBACKEND, MPLCONFIGDIR, or XDG_CACHE_HOME in analysis code.',
+        'Execute Python code in a secure sandbox for deep data analysis and complete multi-record results. Use this for correlations, matching or recommendations across many rows, constrained ranking, transformations, clustering, and custom visualizations. For a result containing many records, do not print the records as prose. Call larkup_table(title, rows, columns, summary, requested_items, file_name) exactly once so Chat renders the complete result with pagination and download. For long narrative sections, call larkup_document(title, pages, summary, requested_items, file_name), where pages is a list of strings or {title, content} objects. Produce every requested item in this one execution, validate counts and global constraints in Python, and keep stdout to a short diagnostic. The code has pandas, numpy, matplotlib, scipy, scikit-learn, and seaborn. Use plt.show() for charts. The sandbox already configures headless plotting and cache directories.',
       inputSchema: z.object({
         code: z
           .string()
           .describe(
-            'Python code to execute. Has pandas (2.0+), numpy, matplotlib, scipy, sklearn, seaborn available. ALWAYS use "ME" instead of "M" for resample frequency. Print results and use plt.show() for charts. Plot configuration is already prepared by the sandbox; do not set MPLBACKEND, MPLCONFIGDIR, or XDG_CACHE_HOME.',
+            'Python code to execute. For a list/table longer than a short chat answer, finish with larkup_table(...). For long prose, finish with larkup_document(...). These helpers are preloaded; never redefine them. requested_items must equal the user-requested top/first/all count so completeness is verified. Has pandas (2.0+), numpy, matplotlib, scipy, sklearn, seaborn. ALWAYS use "ME" instead of "M" for resample frequency. Use plt.show() for charts. Plot configuration is already prepared; do not set MPLBACKEND, MPLCONFIGDIR, or XDG_CACHE_HOME.',
           ),
         datasetId: z
           .string()
@@ -2850,6 +2855,10 @@ export async function getChatTools(context: {
           ) {
             finalCode = `import os\n${finalCode}`;
           }
+          finalCode = withAnalysisPresentationHelpers(
+            finalCode,
+            requestedLongAnalysisItemCount(requestText ?? ''),
+          );
 
           let result = await sandboxManager.execute({
             code: finalCode,
@@ -2880,10 +2889,12 @@ export async function getChatTools(context: {
             });
           }
 
+          const extracted = extractAnalysisPresentation(result.stdout);
           return {
-            stdout: result.stdout.slice(0, 5000),
+            stdout: extracted.stdout.slice(0, 5000),
             stderr: result.stderr.slice(0, 2000),
             exitCode: result.exitCode,
+            ...(extracted.presentation ? { presentation: extracted.presentation } : {}),
             artifacts: result.artifacts.map((a) => ({
               name: a.name,
               mimeType: a.mimeType,
@@ -3052,12 +3063,12 @@ export async function getChatTools(context: {
 
     analyzeCorpusWithCode: tool({
       description:
-        'Run Python code in a sandbox with the FULL indexed corpus available as a file. Use this for complex analysis of documents: parsing fields from content, computing progress percentages, grouping by patterns, detecting duplicates, generating charts from corpus data, or any question that requires programmatic processing of hundreds/thousands of documents. The corpus is available as "corpus.csv" (or "corpus.jsonl" if format is jsonl). CSV columns: id, title, source, url, charCount, status, createdAt, content, plus any metadata_* columns.',
+        'Run Python code in a sandbox with the FULL indexed corpus available as a file. Use this for complete long inventories or transformations across documents, parsing fields, grouping, detecting duplicates, and corpus-scale analysis. For many result records call larkup_table(...) exactly once; for long narrative sections call larkup_document(...) exactly once. Produce the complete requested item count in one execution instead of streaming a long answer. The corpus is available as "corpus.csv" (or "corpus.jsonl"). CSV columns: id, title, source, url, charCount, status, createdAt, content, plus metadata_* columns.',
       inputSchema: z.object({
         code: z
           .string()
           .describe(
-            'Python code to execute. The corpus file is in the working directory. Use pandas to load it: df = pd.read_csv("corpus.csv") or for JSONL: df = pd.read_json("corpus.jsonl", lines=True). Has pandas (2.0+), numpy, matplotlib, scipy, sklearn, seaborn available. ALWAYS use "ME" instead of "M" for resample frequency. Print results and use plt.show() for charts.',
+            'Python code to execute. The corpus file is in the working directory. Use pandas to load it. For long structured results finish with larkup_table(...); for long prose finish with larkup_document(...). These helpers are preloaded. Set requested_items to the requested count. Has pandas, numpy, matplotlib, scipy, sklearn, seaborn. ALWAYS use "ME" instead of "M" for resample frequency.',
           ),
         format: z
           .enum(['csv', 'jsonl'])
@@ -3092,7 +3103,10 @@ export async function getChatTools(context: {
           const fileName = format === 'jsonl' ? 'corpus.jsonl' : 'corpus.csv';
           const files = [{ name: fileName, content: corpusData }];
 
-          let finalCode = code;
+          let finalCode = withAnalysisPresentationHelpers(
+            code,
+            requestedLongAnalysisItemCount(requestText ?? ''),
+          );
           let result = await sandboxManager.execute({
             code: finalCode,
             language: 'python',
@@ -3116,10 +3130,12 @@ export async function getChatTools(context: {
             });
           }
 
+          const extracted = extractAnalysisPresentation(result.stdout);
           return {
-            stdout: result.stdout.slice(0, 5000),
+            stdout: extracted.stdout.slice(0, 5000),
             stderr: result.stderr.slice(0, 2000),
             exitCode: result.exitCode,
+            ...(extracted.presentation ? { presentation: extracted.presentation } : {}),
             artifacts: result.artifacts.map((a) => ({
               name: a.name,
               mimeType: a.mimeType,
@@ -3389,6 +3405,7 @@ export async function getChatTools(context: {
         'createDataExport',
         'generateVisualization',
         'executeAnalysis',
+        'analyzeCorpusWithCode',
         // PDF/image hits can require one visual pass after retrieval. This is
         // available only to a follow-up tool step, never auto-run on chat.
         'inspectPdfPages',

package/src/lib/chat/analysis-presentation.ts

@@ -0,0 +1,217 @@
+const PRESENTATION_MARKER = '__LARKUP_PRESENTATION__:';
+const MAX_PRESENTATION_CHARS = 3_000_000;
+const MAX_TABLE_ROWS = 5_000;
+const MAX_TABLE_COLUMNS = 50;
+const MAX_CELL_CHARS = 20_000;
+const MAX_DOCUMENT_PAGES = 1_000;
+
+export interface AnalysisTablePresentation {
+  kind: 'table';
+  title: string;
+  summary?: string;
+  columns: string[];
+  rows: Array<Record<string, string | number | boolean | null>>;
+  totalItems: number;
+  requestedItems?: number;
+  complete: boolean;
+  fileName?: string;
+}
+
+export interface AnalysisDocumentPage {
+  title?: string;
+  content: string;
+}
+
+export interface AnalysisDocumentPresentation {
+  kind: 'document';
+  title: string;
+  summary?: string;
+  pages: AnalysisDocumentPage[];
+  totalItems: number;
+  requestedItems?: number;
+  complete: boolean;
+  fileName?: string;
+}
+
+export type AnalysisPresentation = AnalysisTablePresentation | AnalysisDocumentPresentation;
+
+function boundedText(value: unknown, max: number): string | undefined {
+  if (typeof value !== 'string') return undefined;
+  const text = value.trim();
+  return text ? text.slice(0, max) : undefined;
+}
+
+function boundedCount(value: unknown): number | undefined {
+  return typeof value === 'number' && Number.isFinite(value) && value >= 0
+    ? Math.floor(value)
+    : undefined;
+}
+
+function normalizeCell(value: unknown): string | number | boolean | null {
+  if (value === null || typeof value === 'number' || typeof value === 'boolean') return value;
+  if (typeof value === 'string') return value.slice(0, MAX_CELL_CHARS);
+  try {
+    const serialized = JSON.stringify(value);
+    return (serialized ?? String(value)).slice(0, MAX_CELL_CHARS);
+  } catch {
+    return String(value).slice(0, MAX_CELL_CHARS);
+  }
+}
+
+function normalizeTable(value: Record<string, unknown>): AnalysisTablePresentation | undefined {
+  if (!Array.isArray(value.rows)) return undefined;
+  const inferredColumns = value.rows.flatMap((row) =>
+    row && typeof row === 'object' && !Array.isArray(row) ? Object.keys(row) : [],
+  );
+  const columns = [
+    ...new Set(
+      (Array.isArray(value.columns) ? value.columns : inferredColumns).filter(
+        (column): column is string => typeof column === 'string' && column.trim().length > 0,
+      ),
+    ),
+  ]
+    .slice(0, MAX_TABLE_COLUMNS)
+    .map((column) => column.slice(0, 160));
+  if (columns.length === 0) return undefined;
+
+  const rows: AnalysisTablePresentation['rows'] = [];
+  let serializedChars = 0;
+  for (const candidate of value.rows) {
+    if (rows.length >= MAX_TABLE_ROWS || serializedChars >= MAX_PRESENTATION_CHARS) break;
+    if (!candidate || typeof candidate !== 'object' || Array.isArray(candidate)) continue;
+    const source = candidate as Record<string, unknown>;
+    const row = Object.fromEntries(
+      columns.map((column) => [column, normalizeCell(source[column])]),
+    );
+    const rowChars = JSON.stringify(row).length;
+    if (serializedChars + rowChars > MAX_PRESENTATION_CHARS) break;
+    rows.push(row);
+    serializedChars += rowChars;
+  }
+  if (rows.length === 0) return undefined;
+
+  const requestedItems = boundedCount(value.requestedItems);
+  const reportedTotal = boundedCount(value.totalItems) ?? value.rows.length;
+  const totalItems = Math.max(reportedTotal, rows.length);
+  const retainedEveryRow = rows.length === value.rows.length;
+  const satisfiesRequest = requestedItems === undefined || rows.length >= requestedItems;
+  return {
+    kind: 'table',
+    title: boundedText(value.title, 160) ?? 'Analysis results',
+    ...(boundedText(value.summary, 800) ? { summary: boundedText(value.summary, 800) } : {}),
+    columns,
+    rows,
+    totalItems,
+    ...(requestedItems !== undefined ? { requestedItems } : {}),
+    complete: value.complete !== false && retainedEveryRow && satisfiesRequest,
+    ...(boundedText(value.fileName, 120) ? { fileName: boundedText(value.fileName, 120) } : {}),
+  };
+}
+
+function normalizeDocument(
+  value: Record<string, unknown>,
+): AnalysisDocumentPresentation | undefined {
+  if (!Array.isArray(value.pages)) return undefined;
+  const pages: AnalysisDocumentPage[] = [];
+  let serializedChars = 0;
+  for (const candidate of value.pages) {
+    if (pages.length >= MAX_DOCUMENT_PAGES || serializedChars >= MAX_PRESENTATION_CHARS) break;
+    const page =
+      typeof candidate === 'string'
+        ? { content: candidate }
+        : candidate && typeof candidate === 'object' && !Array.isArray(candidate)
+          ? (candidate as Record<string, unknown>)
+          : undefined;
+    const content = boundedText(page?.content, MAX_CELL_CHARS);
+    if (!content || serializedChars + content.length > MAX_PRESENTATION_CHARS) break;
+    const title = boundedText(page?.title, 160);
+    pages.push({ ...(title ? { title } : {}), content });
+    serializedChars += content.length;
+  }
+  if (pages.length === 0) return undefined;
+
+  const requestedItems = boundedCount(value.requestedItems);
+  const reportedTotal = boundedCount(value.totalItems) ?? value.pages.length;
+  const totalItems = Math.max(reportedTotal, pages.length);
+  const retainedEveryPage = pages.length === value.pages.length;
+  const satisfiesRequest = requestedItems === undefined || pages.length >= requestedItems;
+  return {
+    kind: 'document',
+    title: boundedText(value.title, 160) ?? 'Prepared document',
+    ...(boundedText(value.summary, 800) ? { summary: boundedText(value.summary, 800) } : {}),
+    pages,
+    totalItems,
+    ...(requestedItems !== undefined ? { requestedItems } : {}),
+    complete: value.complete !== false && retainedEveryPage && satisfiesRequest,
+    ...(boundedText(value.fileName, 120) ? { fileName: boundedText(value.fileName, 120) } : {}),
+  };
+}
+
+export function extractAnalysisPresentation(stdout: string): {
+  stdout: string;
+  presentation?: AnalysisPresentation;
+} {
+  const markerIndex = stdout.lastIndexOf(PRESENTATION_MARKER);
+  if (markerIndex < 0) return { stdout };
+  const payloadStart = markerIndex + PRESENTATION_MARKER.length;
+  const lineEnd = stdout.indexOf('\n', payloadStart);
+  const payload = stdout.slice(payloadStart, lineEnd < 0 ? undefined : lineEnd).trim();
+  const cleanedStdout =
+    `${stdout.slice(0, markerIndex)}${lineEnd < 0 ? '' : stdout.slice(lineEnd + 1)}`.trim();
+  if (!payload || payload.length > MAX_PRESENTATION_CHARS * 2) return { stdout: cleanedStdout };
+  try {
+    const value = JSON.parse(payload) as Record<string, unknown>;
+    const presentation =
+      value?.kind === 'table'
+        ? normalizeTable(value)
+        : value?.kind === 'document'
+          ? normalizeDocument(value)
+          : undefined;
+    return { stdout: cleanedStdout, ...(presentation ? { presentation } : {}) };
+  } catch {
+    return { stdout: cleanedStdout };
+  }
+}
+
+/** Injected before generated Python so long results have one stable UI contract. */
+export const ANALYSIS_PRESENTATION_PYTHON = String.raw`
+import json as _larkup_json
+
+def _larkup_json_default(value):
+    item = getattr(value, "item", None)
+    if callable(item):
+        try:
+            return item()
+        except Exception:
+            pass
+    return str(value)
+
+def larkup_table(title, rows, columns=None, summary=None, requested_items=None, file_name=None):
+    if hasattr(rows, "to_dict"):
+        rows = rows.to_dict(orient="records")
+    rows = list(rows)
+    if columns is None:
+        columns = list(rows[0].keys()) if rows else []
+    requested_items = requested_items if requested_items is not None else _LARKUP_REQUESTED_ITEMS
+    payload = {
+        "kind": "table", "title": title, "summary": summary,
+        "columns": list(columns), "rows": rows, "totalItems": len(rows),
+        "requestedItems": requested_items, "complete": True, "fileName": file_name,
+    }
+    print("${PRESENTATION_MARKER}" + _larkup_json.dumps(payload, ensure_ascii=False, default=_larkup_json_default))
+
+def larkup_document(title, pages, summary=None, requested_items=None, file_name=None):
+    pages = list(pages)
+    requested_items = requested_items if requested_items is not None else _LARKUP_REQUESTED_ITEMS
+    payload = {
+        "kind": "document", "title": title, "summary": summary,
+        "pages": pages, "totalItems": len(pages), "requestedItems": requested_items,
+        "complete": True, "fileName": file_name,
+    }
+    print("${PRESENTATION_MARKER}" + _larkup_json.dumps(payload, ensure_ascii=False, default=_larkup_json_default))
+`;
+
+export function withAnalysisPresentationHelpers(code: string, requestedItems?: number): string {
+  const requested = requestedItems === undefined ? 'None' : String(requestedItems);
+  return `${ANALYSIS_PRESENTATION_PYTHON}\n_LARKUP_REQUESTED_ITEMS = ${requested}\n${code}`;
+}

package/src/lib/chat/conversation-memory.ts

@@ -40,6 +40,14 @@ export type ReusableTabularEvidence = {
   totalRows: number;
 };
 
+export type AnalysisArtifactSummary = {
+  kind: 'table' | 'document';
+  title: string;
+  totalItems: number;
+  requestedItems?: number;
+  complete: boolean;
+};
+
 /** Only reuse table evidence while its source is still present in the live data store. */
 export function tabularEvidenceDatasetIsAvailable(
   evidence: ReusableTabularEvidence | undefined,
@@ -283,6 +291,44 @@ function completeTabularEvidence(
   };
 }
 
+function analysisPresentation(output: unknown): Record<string, unknown> | undefined {
+  const result = unwrapJson(output) as Record<string, unknown> | undefined;
+  const presentation = result?.presentation;
+  return presentation && typeof presentation === 'object' && !Array.isArray(presentation)
+    ? (presentation as Record<string, unknown>)
+    : undefined;
+}
+
+/** Read only completion metadata; the full paged artifact remains in the UI message. */
+export function extractLatestAnalysisArtifact(
+  messages: readonly ChatMessage[],
+): AnalysisArtifactSummary | undefined {
+  for (const message of [...messages].reverse()) {
+    if (message.role !== 'assistant') continue;
+    for (const part of toolParts(message).reverse()) {
+      if (part.name !== 'executeAnalysis' && part.name !== 'analyzeCorpusWithCode') continue;
+      const presentation = analysisPresentation(part.output);
+      if (
+        (presentation?.kind !== 'table' && presentation?.kind !== 'document') ||
+        typeof presentation.title !== 'string' ||
+        typeof presentation.totalItems !== 'number' ||
+        typeof presentation.complete !== 'boolean'
+      )
+        continue;
+      return {
+        kind: presentation.kind,
+        title: presentation.title,
+        totalItems: presentation.totalItems,
+        ...(typeof presentation.requestedItems === 'number'
+          ? { requestedItems: presentation.requestedItems }
+          : {}),
+        complete: presentation.complete,
+      };
+    }
+  }
+  return undefined;
+}
+
 /** Keep the complete bounded query result for an immediate export follow-up. */
 export function extractLatestTabularExportResult(
   messages: readonly ChatMessage[],
@@ -290,8 +336,18 @@ export function extractLatestTabularExportResult(
   for (const message of [...messages].reverse()) {
     if (message.role !== 'assistant') continue;
     const result = toolParts(message)
-      .filter((part) => part.name === 'queryTabularData')
-      .map((part) => completeTabularEvidence(part.input, part.output))
+      .filter(
+        (part) =>
+          part.name === 'queryTabularData' ||
+          part.name === 'executeAnalysis' ||
+          part.name === 'analyzeCorpusWithCode',
+      )
+      .map((part) =>
+        completeTabularEvidence(
+          part.input,
+          part.name === 'queryTabularData' ? part.output : analysisPresentation(part.output),
+        ),
+      )
       .find(Boolean);
     if (result) return result;
   }
@@ -348,8 +404,18 @@ export function extractConversationEvidence(
     if (message.role !== 'assistant') continue;
     const parts = toolParts(message);
     const table = parts
-      .filter((part) => part.name === 'queryTabularData')
-      .map((part) => tabularEvidence(part.input, part.output))
+      .filter(
+        (part) =>
+          part.name === 'queryTabularData' ||
+          part.name === 'executeAnalysis' ||
+          part.name === 'analyzeCorpusWithCode',
+      )
+      .map((part) =>
+        tabularEvidence(
+          part.input,
+          part.name === 'queryTabularData' ? part.output : analysisPresentation(part.output),
+        ),
+      )
       .find(Boolean);
     if (table) {
       return { sources: [], images: [], mediaAssetIds: [], tabular: table };

package/src/lib/chat/tabular-query-plan.ts

@@ -1,4 +1,8 @@
-import type { TabularDataset, TabularQueryRequest } from '@larkup/core/tabular-store';
+import {
+  MAX_TABULAR_RESULT_LIMIT,
+  type TabularDataset,
+  type TabularQueryRequest,
+} from '@larkup/core/tabular-store';
 
 export type InferredTabularPlan = {
   request: TabularQueryRequest;
@@ -78,6 +82,17 @@ function requestedSortOrder(text: string) {
   return undefined;
 }
 
+/** Preserve an explicit long-list size instead of relying on a model default. */
+export function requestedTabularResultLimit(text: string): number | undefined {
+  const match = text.match(
+    /\b(?:top|first|last|show|list|return|give(?:\s+me)?|display)\s+(?:the\s+)?(\d{1,4})\b/iu,
+  );
+  if (!match) return undefined;
+  const requested = Number(match[1]);
+  if (!Number.isSafeInteger(requested) || requested < 1) return undefined;
+  return Math.min(requested, MAX_TABULAR_RESULT_LIMIT);
+}
+
 function normalizeAggregations(
   dataset: TabularDataset,
   request: TabularQueryRequest,
@@ -133,6 +148,7 @@ export function inferTabularPlan(
   const measureColumns =
     requestedMeasures.length > 0 ? requestedMeasures : numeric.length === 1 ? [numeric[0]] : [];
   const year = text.match(/\b(20\d{2})\b/)?.[1];
+  const explicitLimit = requestedTabularResultLimit(text);
 
   if (
     dateColumn &&
@@ -184,12 +200,15 @@ export function inferTabularPlan(
         ...(sortOrder
           ? { sortBy: `${aggregations[0].op}_${aggregations[0].column}`, sortOrder }
           : {}),
-        limit: Math.min(request.limit ?? 120, 120),
+        limit: explicitLimit ?? Math.min(request.limit ?? 120, 120),
       },
     };
   }
 
   return {
-    request: normalizeDistinctCountIntent(text, normalizeAggregations(dataset, request)),
+    request: {
+      ...normalizeDistinctCountIntent(text, normalizeAggregations(dataset, request)),
+      ...(explicitLimit ? { limit: explicitLimit } : {}),
+    },
   };
 }

package/src/lib/chat/tabular-routing.ts

@@ -59,9 +59,37 @@ export function hasCompletedTabularVisualizationStep(
  * column names.
  */
 export function requiresTabularSandbox(text: string): boolean {
-  return /\b(?:join|correlat(?:e|ion)|regression|cluster(?:ing)?|forecast(?:ing)?|statistical|sandbox|python|matplotlib|seaborn|scikit(?:-learn)?|custom\s+(?:analysis|chart|visuali[sz]ation)|across\s+(?:sheets?|tables?|datasets?|files?)|between\s+(?:sheets?|tables?|datasets?|files?))\b/i.test(
-    text,
+  return (
+    /\b(?:join|correlat(?:e|ion)|regression|cluster(?:ing)?|forecast(?:ing)?|statistical|sandbox|python|matplotlib|seaborn|scikit(?:-learn)?|custom\s+(?:analysis|chart|visuali[sz]ation)|across\s+(?:sheets?|tables?|datasets?|files?)|between\s+(?:sheets?|tables?|datasets?|files?))\b/i.test(
+      text,
+    ) || requestsLongAnalysisArtifact(text)
+  );
+}
+
+/**
+ * Long per-record transformations cannot be completed safely as streamed prose:
+ * the model will eventually hit its output ceiling and a later "continue" loses
+ * global constraints. Route these through one sandbox run and a paged artifact.
+ */
+export function requestsLongAnalysisArtifact(text: string): boolean {
+  const hasManyTargets =
+    /\bfor\s+(?:the\s+)?(?:first|last|top)\s+\d+\b|\bfor\s+(?:each|every|all)\b|\b(?:each|every|all)\s+(?:of\s+)?(?:the\s+)?(?:people|participants?|rows?|records?|entries|documents?|items?|responses?)\b/i.test(
+      text,
+    );
+  const transformsEachTarget =
+    /\b(?:match(?:es|ed|ing)?|recommend(?:ation|ations|ed|ing)?|explain(?:ed|ing|s)?|summari[sz](?:e|ed|es|ing|ation)|profile(?:d|s|ing)?|assess(?:ed|ment|ments|ing)?|evaluat(?:e|ed|es|ing|ion)|classif(?:y|ied|ies|ication)|score(?:d|s|ing)?|rewrite|generate\s+(?:a\s+)?(?:description|report|answer))\b/i.test(
+      text,
+    );
+  return hasManyTargets && transformsEachTarget;
+}
+
+/** Preserve explicit batch sizes for sandbox artifacts (larger than chat prose limits). */
+export function requestedLongAnalysisItemCount(text: string): number | undefined {
+  const match = text.match(
+    /\b(?:first|last|top)\s+(\d{1,5})\b|\bfor\s+(\d{1,5})\s+(?:people|participants?|rows?|records?|entries|documents?|items?|responses?)\b/i,
   );
+  const value = Number(match?.[1] ?? match?.[2]);
+  return Number.isInteger(value) && value > 0 ? Math.min(value, 5_000) : undefined;
 }
 
 /**

package/src/lib/chat/tabular-visualization.ts

@@ -35,9 +35,15 @@ function formatSeriesLabel(value: string) {
 }
 
 export function requestsVisualization(text: string): boolean {
-  return /\b(chart|graph|plot|visuali[sz]e|distribution|breakdown|trends?|compare|show\s+me)\b/i.test(
-    text,
-  );
+  const explicitChart =
+    /\b(?:charts?|graphs?|plots?|visuali[sz](?:e|ation)|diagram|histogram|scatter\s*plot|trends?)\b/iu.test(
+      text,
+    );
+  const visualPresentation =
+    /\b(?:show|display|draw|render|create|make)\b.{0,40}\b(?:distribution|breakdown|trend|comparison)\b/iu.test(
+      text,
+    );
+  return explicitChart || visualPresentation;
 }
 
 function normalizedTerms(value: string) {

package/src/lib/chat/tool-context.ts

@@ -1192,11 +1192,28 @@ function compactValue(value: unknown, toolName?: string): unknown {
           totalRows: result.totalRows,
           aggregationResults: result.aggregationResults,
         };
-  } else if (toolName === 'executeAnalysis') {
+  } else if (toolName === 'executeAnalysis' || toolName === 'analyzeCorpusWithCode') {
+    const presentation =
+      result.presentation && typeof result.presentation === 'object'
+        ? (result.presentation as Record<string, any>)
+        : undefined;
     compact = {
       stdout: typeof result.stdout === 'string' ? result.stdout.slice(0, 4_000) : result.stdout,
       stderr: typeof result.stderr === 'string' ? result.stderr.slice(0, 1_000) : result.stderr,
       exitCode: result.exitCode,
+      ...(presentation
+        ? {
+            presentation: {
+              kind: presentation.kind,
+              title: presentation.title,
+              summary: presentation.summary,
+              totalItems: presentation.totalItems,
+              requestedItems: presentation.requestedItems,
+              complete: presentation.complete,
+              ...(Array.isArray(presentation.columns) ? { columns: presentation.columns } : {}),
+            },
+          }
+        : {}),
     };
   } else if (
     (toolName === 'inspectPdfPages' || toolName === 'analyzePdfPages') &&