@larkup/workspace-server 0.2.6 → 0.2.14

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":"AAkHA,eAAO,MAAM,WAAW,MAAM,CAAC;AAktB/B,wBAAsB,IAAI,CAAC,GAAG,EAAE,OAAO,qBAu7CtC"}
+{"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"}

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

@@ -9,7 +9,8 @@ export type ExactGroundedAnswer = {
     sourceScopeFingerprint: string;
 };
 export type ReusableImageEvidence = {
-    imageUrl: string;
+    imageUrl?: string;
+    documentId?: string;
     pageNumber?: number;
     index?: number;
     title?: string;
@@ -57,6 +58,13 @@ export declare function extractConversationEvidence(messages: readonly ChatMessa
  */
 export declare function isTabularFollowUp(text: string, evidence: ConversationEvidence): boolean;
 export declare function isImagePreviewFollowUp(text: string, evidence: ConversationEvidence): boolean;
+/** Reuse the exact prior source, preferring a fresh PDF-page render over a stale derivative. */
+export declare function imagePreviewInput(evidence: ConversationEvidence): {
+    documentId: string;
+    pageNumber: number;
+} | {
+    imageUrl: string;
+} | undefined;
 /**
  * A source is selected by structured evidence from the immediately preceding
  * turn. Keep it until a later source-selection event replaces it; never infer

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":"AAeA,KAAK,WAAW,GAAG;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,0FAA0F;AAC1F,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,uBAAuB,GAAG,SAAS,EAC7C,mBAAmB,EAAE,WAAW,CAAC,MAAM,CAAC,GACvC,OAAO,CAET;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAChC,yFAAyF;IACzF,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,6FAA6F;IAC7F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,uBAAuB,CAAC;CACnC,CAAC;AAoFF;;;;GAIG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,SAAS,WAAW,EAAE,EAChC,eAAe,EAAE,MAAM,GACtB,mBAAmB,GAAG,SAAS,CA0DjC;AAuED,gFAAgF;AAChF,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,SAAS,WAAW,EAAE,GAC/B,uBAAuB,GAAG,SAAS,CAUrC;AAED,sFAAsF;AACtF,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,OAAO,EAAE,EACjB,OAAO,EAAE,MAAM,EAAE,GAChB,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAuBhC;AAYD;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,SAAS,WAAW,EAAE,GAC/B,oBAAoB,CA0GtB;AAmCD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAavF;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAK5F;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAE/F;AAUD;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC/C,eAAe,EAAE,MAAM,EACvB,gBAAgB,EAAE,MAAM,GACvB,MAAM,GAAG,SAAS,CAepB;AAED;;;;GAIG;AACH,wBAAgB,mCAAmC,CACjD,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,oBAAoB,GAC7B,MAAM,GAAG,SAAS,CAyBpB;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,CAoCjF"}
+{"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/tool-context.d.ts

@@ -38,7 +38,10 @@ export declare function formatLocatedObservedSubjectAnswer(value: unknown): stri
  * asking a prose model to reinterpret explicit discrete moments as one
  * continuous appearance or as an absence claim.
  */
-export declare function formatObservedAppearanceAnswer(value: unknown): string | undefined;
+export declare function formatObservedAppearanceAnswer(value: unknown, investigation?: {
+    goal?: unknown;
+    recordSet?: unknown;
+}): string | undefined;
 /** Render a final two-sided numeric outcome without waiting on a slow prose model. */
 export declare function formatOutcomeMediaAnswer(value: unknown, investigation: VideoInvestigationDirective): string | undefined;
 /** Use the strongest bounded source reading directly when it already settled the question. */

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,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAgGjF;AAED,sFAAsF;AACtF,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,aAAa,EAAE,2BAA2B,GACzC,MAAM,GAAG,SAAS,CAwFpB;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;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"}

package/dist-types/lib/chat/video-query-planning.d.ts

@@ -0,0 +1,15 @@
+import type { VideoInvestigationDirective } from '@larkup/core/video-knowledge/query-planner';
+export interface VideoQuestionSignals {
+    hasPosition?: boolean;
+    connectsBeyondPosition?: boolean;
+    asksForSettledOutcome?: boolean;
+    asksForExhaustiveCoverage?: boolean;
+}
+/**
+ * Reconcile the planner directive with the independent question classifier.
+ * The classifier is deliberately language-neutral and has final authority over
+ * outcome requests, because a broad planner can otherwise mistake “who won?”
+ * for source synthesis and send the answer through appearance rendering.
+ */
+export declare function reconcileVideoInvestigation(planned: VideoInvestigationDirective | undefined, signals: VideoQuestionSignals | undefined): VideoInvestigationDirective | undefined;
+//# sourceMappingURL=video-query-planning.d.ts.map

package/dist-types/lib/chat/video-query-planning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-query-planning.d.ts","sourceRoot":"","sources":["../../../src/lib/chat/video-query-planning.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,4CAA4C,CAAC;AAE9F,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,2BAA2B,GAAG,SAAS,EAChD,OAAO,EAAE,oBAAoB,GAAG,SAAS,GACxC,2BAA2B,GAAG,SAAS,CAyBzC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@larkup/workspace-server",
-  "version": "0.2.6",
+  "version": "0.2.14",
   "type": "module",
   "files": [
     "src",
@@ -317,15 +317,16 @@
     "@ai-sdk/mistral": "4.0.61",
     "@ai-sdk/openai": "4.0.89",
     "@ai-sdk/openai-compatible": "3.0.66",
-    "@larkup/core": "^0.8.1",
-    "@larkup/tool-doc-editor": "^0.3.1",
+    "@larkup/core": "^0.8.2",
+    "@larkup/tool-doc-editor": "^0.3.2",
+    "@napi-rs/canvas": "1.0.11",
     "ai": "7.0.133",
     "pdf-parse": "2.4.5",
     "zod": "^4.4.3",
     "mammoth": "^1.12.0",
-    "@larkup/marketplace": "0.3.10",
-    "@larkup/scraper": "0.2.1",
+    "@larkup/marketplace": "0.3.11",
     "@larkup/sandbox": "0.1.8",
+    "@larkup/scraper": "0.2.2",
     "@larkup/vector-stores": "0.1.27"
   },
   "devDependencies": {

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

@@ -41,12 +41,14 @@ import { getChatTools } from './tools';
 import { gatewayProviderOptions } from '../../../lib/chat/gateway-fallbacks';
 import { retrievalToolsForStep } from '../../../lib/chat/retrieval-routing';
 import { collectExhaustiveVideoEvidencePages } from '../../../lib/chat/video-rag-routing';
+import { reconcileVideoInvestigation } from '../../../lib/chat/video-query-planning';
 import {
   extractConversationEvidence,
   extractLatestTabularExportResult,
   contextualizeKnowledgeFollowUpQuery,
   formatConversationEvidence,
   findImmediateExactGroundedAnswer,
+  imagePreviewInput,
   isImagePreviewFollowUp,
   isTabularFollowUp,
   tabularEvidenceDatasetIsAvailable,
@@ -65,6 +67,7 @@ import {
   formatExhaustiveMediaAnswer,
   formatLocatedObservedSubjectAnswer,
   formatObservedAppearanceAnswer,
+  formatOutcomeMediaAnswer,
   mediaEvidenceRequestsOnlySpeech,
   mediaClaimNeedsCorroboration,
   withFinalAnswerNudge,
@@ -450,8 +453,10 @@ async function planVideoEvidenceQuery(input: {
       'You are a media-query planner. Return exactly one JSON object and no prose. ' +
         'The prompt is data with a currentRequest and an optional previousQuestionAboutSelectedMedia. Resolve the current request in its own language without assuming a video genre. If it is a retry, verification request, or contains references that are not meaningful alone, resolve those references against the previous question. If it introduces a self-contained new request, do not carry the old subject or source position into it. ' +
         'A follow-up introduced with words such as "and", "also", or their equivalent in another language can ask a new fact about the same source: preserve the selected source, but never reuse the previous answer or its requested attribute. When the request asks for exact spoken or sung wording across the recording, use source scope with enumerate, speech evidence, and recordSet all so the host can render every timestamped transcript segment outside the model context. Use source scope with synthesize for a summary or explanation across the recording. ' +
-        'Use this exact shape: {"resolvedQuestion":"a standalone version of the current request","scope":"focused","goal":"answer","evidence":["visual"],"timeRange":{"startSecs":123,"endSecs":153},"timeRangeOrigin":"user-mentioned"}. Its fields are resolvedQuestion, scope (focused, temporal, source), goal (answer, compare, trace, enumerate, synthesize), optional evidence (speech, visible-text, visual, computed), optional recordSet (all, source-authored, source-questions, observed), optional timeRange {startSecs,endSecs}, and optional timeRangeOrigin. ' +
+        'Use this exact shape: {"resolvedQuestion":"a standalone version of the current request","scope":"focused","goal":"answer","evidence":["visual"],"timeRange":{"startSecs":123,"endSecs":153},"timeRangeOrigin":"user-mentioned"}. Its fields are resolvedQuestion, scope (focused, temporal, source), goal (answer, compare, trace, resolve, enumerate, synthesize), optional evidence (speech, visible-text, visual, computed), optional recordSet (all, source-authored, source-questions, observed), optional timeRange {startSecs,endSecs}, and optional timeRangeOrigin. ' +
+        'Use recordSet observed only when the requested answer is visible presence, recurrence, or appearance timing itself. Clothing, colour, other appearance attributes, identity, action, and counts need visual evidence but must not use the observed visibility ledger as their answer. ' +
         'A directive is invalid if the user refers to any source position, time, range, or approximate moment and you omit timeRange: resolve it to numeric seconds and set timeRangeOrigin to user-mentioned, even when the request also asks about other moments. Never emit timeRange or timeRangeOrigin when the user did not constrain a source position; a topic occurring near an opening, closing, or any other position is not a user constraint. When the request names a coarse source unit without a smaller boundary, cover that whole named unit rather than an arbitrary part of it. When the user asks how a visible subject or event at an explicit source position relates to appearances or recurrence elsewhere, use temporal plus trace, visual evidence, and recordSet observed while retaining that position. Use source plus synthesize with no timeRange whenever the answer must combine two or more source facts from unrestricted positions. Use source plus enumerate and recordSet source-questions for a complete inventory of source-authored questions and their answers. Use temporal for a relationship or development across moments; use focused only for one local moment or one self-contained fact. ' +
+        'Use temporal plus resolve when the requested fact is the settled or final outcome of a process, contest, decision, vote, test, or other sequence; this includes asking who won or what the final result was in any language. Do not confuse an entity mentioned in that request with a request to inventory its visual appearances. ' +
         'Do not answer the question or add fields.',
       320,
     );
@@ -461,7 +466,7 @@ async function planVideoEvidenceQuery(input: {
     // first planning attempt without introducing source- or language-specific
     // routing rules in the host.
     return await requestPlan(
-      'Return only JSON with resolvedQuestion, scope, goal, and optional recordSet/timeRange/timeRangeOrigin. Resolve an elliptical retry or reference against previousQuestionAboutSelectedMedia; otherwise keep currentRequest standalone. Select source/enumerate/source-questions for a complete question-and-answer inventory from a recording; select source/synthesize for an unrestricted explanation; select focused/answer for one local fact. Do not include a timeRange unless the resolved request contains a source position, and then set timeRangeOrigin to user-mentioned.',
+      'Return only JSON with resolvedQuestion, scope, goal, and optional recordSet/timeRange/timeRangeOrigin. Resolve an elliptical retry or reference against previousQuestionAboutSelectedMedia; otherwise keep currentRequest standalone. Select source/enumerate/source-questions for a complete question-and-answer inventory from a recording; source/synthesize for an unrestricted explanation; temporal/resolve for a settled or final outcome such as who won; focused/answer for one local fact. Do not include a timeRange unless the resolved request contains a source position, and then set timeRangeOrigin to user-mentioned.',
       180,
     );
   } catch {
@@ -486,6 +491,8 @@ async function userSpecifiedSourcePosition(input: {
   | {
       hasPosition: boolean;
       connectsBeyondPosition: boolean;
+      asksForSettledOutcome: boolean;
+      asksForExhaustiveCoverage: boolean;
     }
   | undefined
 > {
@@ -498,7 +505,7 @@ async function userSpecifiedSourcePosition(input: {
       abortSignal: AbortSignal.timeout(8_000),
       providerOptions: input.providerOptions,
       system:
-        'Return exactly one JSON object and no prose: {"kind":"input-location"|"answer-timestamp"|"none","locator":string|null,"connectsBeyondPosition":boolean}. Use input-location only when the user explicitly constrains where in the provided source to look; locator must be the exact corresponding substring from the user request. Use answer-timestamp when the user asks for timestamps in the answer but does not specify where to look; locator is null. Use none when neither is present. Set connectsBeyondPosition true only when the request explicitly relates the thing at its named source position to another point or portion of the source, such as recurrence, reappearance, a later/earlier occurrence, change, or comparison; otherwise false. Example: "Explain a subject and include timestamps" => {"kind":"answer-timestamp","locator":null,"connectsBeyondPosition":false}. Example: "What happens at 14:00?" => {"kind":"input-location","locator":"14:00","connectsBeyondPosition":false}. Example: "Who is at 14:00 and where else do they appear?" => {"kind":"input-location","locator":"14:00","connectsBeyondPosition":true}. Example: "Give the full story from beginning to conclusion" => {"kind":"none","locator":null,"connectsBeyondPosition":false} unless the user asks specifically about the beginning or conclusion. Interpret every language without assuming a source genre.',
+        'Return exactly one JSON object and no prose: {"kind":"input-location"|"answer-timestamp"|"none","locator":string|null,"connectsBeyondPosition":boolean,"asksForSettledOutcome":boolean,"asksForExhaustiveCoverage":boolean}. Use input-location only when the user explicitly constrains where in the provided source to look; locator must be the exact corresponding substring from the user request. Use answer-timestamp when the user asks for timestamps in the answer but does not specify where to look; locator is null. Use none when neither is present. Set connectsBeyondPosition true only when the request explicitly relates the thing at its named source position to another point or portion of the source, such as recurrence, reappearance, a later/earlier occurrence, change, or comparison; otherwise false. Set asksForSettledOutcome true only when the request asks for the final or settled result of a process, contest, decision, vote, test, or other sequence, including who won in any language; it overrides a broad summary classification. Set asksForExhaustiveCoverage true only when the user explicitly asks to enumerate all or every relevant record across the complete recording, such as a complete start-to-finish timeline, every spoken statement, or every visual and spoken event. A full story, overview, or summary is source-wide synthesis, not exhaustive enumeration. A status at a named intermediate position is not a settled outcome. Example: "Explain a subject and include timestamps" => {"kind":"answer-timestamp","locator":null,"connectsBeyondPosition":false,"asksForSettledOutcome":false,"asksForExhaustiveCoverage":false}. Example: "Who won the match?" => {"kind":"none","locator":null,"connectsBeyondPosition":false,"asksForSettledOutcome":true,"asksForExhaustiveCoverage":false}. Example: "What happens at 14:00?" => {"kind":"input-location","locator":"14:00","connectsBeyondPosition":false,"asksForSettledOutcome":false,"asksForExhaustiveCoverage":false}. Example: "Who is at 14:00 and where else do they appear?" => {"kind":"input-location","locator":"14:00","connectsBeyondPosition":true,"asksForSettledOutcome":false,"asksForExhaustiveCoverage":false}. Example: "Give a complete timeline of every visual and spoken event from start to finish" => {"kind":"none","locator":null,"connectsBeyondPosition":false,"asksForSettledOutcome":false,"asksForExhaustiveCoverage":true}. Example: "Give the full story from beginning to conclusion" => {"kind":"none","locator":null,"connectsBeyondPosition":false,"asksForSettledOutcome":false,"asksForExhaustiveCoverage":false} unless the user asks specifically about the beginning or conclusion. Interpret every language without assuming a source genre.',
       prompt: input.question,
     });
     const serialized = text.match(/\{[\s\S]*\}/)?.[0];
@@ -507,10 +514,19 @@ async function userSpecifiedSourcePosition(input: {
       kind?: unknown;
       locator?: unknown;
       connectsBeyondPosition?: unknown;
+      asksForSettledOutcome?: unknown;
+      asksForExhaustiveCoverage?: unknown;
     };
     const connectsBeyondPosition = parsed.connectsBeyondPosition === true;
+    const asksForSettledOutcome = parsed.asksForSettledOutcome === true;
+    const asksForExhaustiveCoverage = parsed.asksForExhaustiveCoverage === true;
     if (parsed.kind === 'answer-timestamp' || parsed.kind === 'none') {
-      return { hasPosition: false, connectsBeyondPosition };
+      return {
+        hasPosition: false,
+        connectsBeyondPosition,
+        asksForSettledOutcome,
+        asksForExhaustiveCoverage,
+      };
     }
     if (parsed.kind !== 'input-location' || typeof parsed.locator !== 'string') return undefined;
     // The quote need only occur in the user text. Its semantic role was
@@ -518,6 +534,8 @@ async function userSpecifiedSourcePosition(input: {
     return {
       hasPosition: input.question.normalize('NFKC').includes(parsed.locator.normalize('NFKC')),
       connectsBeyondPosition,
+      asksForSettledOutcome,
+      asksForExhaustiveCoverage,
     };
   } catch {
     return undefined;
@@ -535,7 +553,7 @@ function parseVideoInvestigationDirective(value: string): VideoInvestigationDire
     const scope = ['focused', 'temporal', 'source'].includes(String(parsed.scope))
       ? (parsed.scope as VideoInvestigationDirective['scope'])
       : 'focused';
-    const goal = ['answer', 'compare', 'trace', 'enumerate', 'synthesize'].includes(
+    const goal = ['answer', 'compare', 'trace', 'resolve', 'enumerate', 'synthesize'].includes(
       String(parsed.goal),
     )
       ? (parsed.goal as VideoInvestigationDirective['goal'])
@@ -1206,6 +1224,9 @@ ${fieldLines}`;
       userText,
     );
   const imagePreviewFollowUp = isImagePreviewFollowUp(userText, reusableEvidence);
+  const directImagePreviewInput = imagePreviewFollowUp
+    ? imagePreviewInput(reusableEvidence)
+    : undefined;
   const tabularFollowUp = isTabularFollowUp(userText, reusableEvidence);
   const dataExportFormat = requestedDataExportFormat(userText);
   const exportNeedsFreshData = dataExportNeedsFreshData(userText);
@@ -1328,6 +1349,53 @@ ${fieldLines}`;
     delete (builtInTools as any).searchKnowledgeBase;
   }
 
+  // A direct "show it" follow-up already has a source-scoped image reference.
+  // Render it on the host instead of repeating retrieval and a model round trip.
+  // PDF pages are rendered fresh from the original source, not a stale derivative.
+  if (directImagePreviewInput && builtInTools.presentMedia) {
+    const previewCallId = `preview-${crypto.randomUUID()}`;
+    const stream = createUIMessageStream({
+      originalMessages: messages,
+      execute: async ({ writer }) => {
+        writer.write({ type: 'start' });
+        writer.write({
+          type: 'tool-input-available',
+          toolCallId: previewCallId,
+          toolName: 'presentMedia',
+          input: directImagePreviewInput,
+        });
+        let previewOutput: any;
+        try {
+          previewOutput = await (builtInTools.presentMedia as any).execute(
+            directImagePreviewInput,
+            { toolCallId: previewCallId },
+          );
+        } catch (error) {
+          previewOutput = {
+            success: false,
+            error: error instanceof Error ? error.message : 'The source image could not be opened.',
+          };
+        }
+        writer.write({
+          type: 'tool-output-available',
+          toolCallId: previewCallId,
+          output: previewOutput,
+        });
+        const answerId = `answer-${crypto.randomUUID()}`;
+        writer.write({ type: 'text-start', id: answerId });
+        writer.write({
+          type: 'text-delta',
+          id: answerId,
+          delta: previewOutput?.success
+            ? 'Here is the requested source image.'
+            : previewOutput?.error || 'The source image could not be opened.',
+        });
+        writer.write({ type: 'text-end', id: answerId });
+      },
+    });
+    return createUIMessageStreamResponse({ stream });
+  }
+
   // Remote MCP connections are opt-in per workspace and their tool names are
   // namespaced by connection. This lets Local Chat use the same connections as
   // Agents without risking collisions with Larkup's built-in tools.
@@ -1362,6 +1430,7 @@ ${fieldLines}`;
         let preloadedEvidence: unknown;
         let preloadedVideoEvidence = false;
         let preloadedEvidenceQueryAttempted = false;
+        let preloadedVideoInvestigation: VideoInvestigationDirective | undefined;
         const preflightToolCallId = `knowledge-${crypto.randomUUID()}`;
 
         if (directDataExport && dataExportFormat && builtInTools.createDataExport) {
@@ -1700,26 +1769,8 @@ ${fieldLines}`;
               ...plannerInput,
               question: resolvedMediaQuestion,
             });
-            const hasUserSpecifiedPosition = sourcePosition?.hasPosition;
-            const connectsBeyondPosition = sourcePosition?.connectsBeyondPosition === true;
-            // `trace` is already the planner's language-neutral declaration
-            // that the answer connects moments. Preserve its supplied source
-            // boundary and give the evidence capability its visibility record
-            // set even if the auxiliary binary classifier was inconclusive.
-            const tracesBeyondPosition =
-              connectsBeyondPosition || plannedInvestigation?.goal === 'trace';
-            const investigation =
-              hasUserSpecifiedPosition === false && plannedInvestigation?.timeRange
-                ? { scope: 'source' as const, goal: 'synthesize' as const }
-                : tracesBeyondPosition && plannedInvestigation?.timeRange
-                  ? {
-                      ...plannedInvestigation,
-                      scope: 'temporal' as const,
-                      goal: 'trace' as const,
-                      evidence: ['visual'] as const,
-                      recordSet: 'observed' as const,
-                    }
-                  : plannedInvestigation;
+            const investigation = reconcileVideoInvestigation(plannedInvestigation, sourcePosition);
+            preloadedVideoInvestigation = investigation;
             const evidenceInput = {
               mediaAssetId,
               query: resolvedMediaQuestion,
@@ -1776,10 +1827,15 @@ ${fieldLines}`;
         const deterministicAnswer =
           formatExhaustiveMediaAnswer(preloadedEvidence, userText) ??
           (useVisualDeterministicAnswer
-            ? (formatLocatedObservedSubjectAnswer(preloadedEvidence) ??
+            ? ((preloadedVideoInvestigation
+                ? formatOutcomeMediaAnswer(preloadedEvidence, preloadedVideoInvestigation)
+                : undefined) ??
+              formatLocatedObservedSubjectAnswer(preloadedEvidence) ??
               collectQuestionMatchedDirectClaims(preloadedEvidence, userText)[0] ??
               formatDirectObservationAnswer(preloadedEvidence, userText) ??
-              formatObservedAppearanceAnswer(preloadedEvidence))
+              (preloadedVideoInvestigation?.goal === 'resolve'
+                ? undefined
+                : formatObservedAppearanceAnswer(preloadedEvidence, preloadedVideoInvestigation)))
             : undefined);
         if (deterministicAnswer) {
           const answerId = `answer-${crypto.randomUUID()}`;

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

@@ -1328,7 +1328,7 @@ export async function getChatTools(context: {
         investigation: z
           .object({
             scope: z.enum(['focused', 'temporal', 'source']),
-            goal: z.enum(['answer', 'compare', 'trace', 'enumerate', 'synthesize']),
+            goal: z.enum(['answer', 'compare', 'trace', 'resolve', 'enumerate', 'synthesize']),
             evidence: z
               .array(z.enum(['speech', 'visible-text', 'visual', 'computed']))
               .max(4)
@@ -2306,7 +2306,7 @@ export async function getChatTools(context: {
         question: z.string().describe('The full user question, including any temporal conditions.'),
         investigation: z.object({
           scope: z.enum(['focused', 'temporal', 'source']),
-          goal: z.enum(['answer', 'compare', 'trace', 'enumerate', 'synthesize']),
+          goal: z.enum(['answer', 'compare', 'trace', 'resolve', 'enumerate', 'synthesize']),
           evidence: z
             .array(z.enum(['speech', 'visible-text', 'visual', 'computed']))
             .max(4)

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

@@ -26,7 +26,8 @@ export type ExactGroundedAnswer = {
 };
 
 export type ReusableImageEvidence = {
-  imageUrl: string;
+  imageUrl?: string;
+  documentId?: string;
   pageNumber?: number;
   index?: number;
   title?: string;
@@ -208,13 +209,18 @@ export function findImmediateExactGroundedAnswer(
   return undefined;
 }
 
-function imageEvidence(value: unknown, title?: string): ReusableImageEvidence[] {
+function imageEvidence(
+  value: unknown,
+  title?: string,
+  documentId?: string,
+): ReusableImageEvidence[] {
   if (!Array.isArray(value)) return [];
   return value.flatMap((image: any) => {
     if (!image || typeof image.imageUrl !== 'string' || !image.imageUrl) return [];
     return [
       {
         imageUrl: image.imageUrl,
+        documentId,
         pageNumber: typeof image.pageNumber === 'number' ? image.pageNumber : undefined,
         index: typeof image.index === 'number' ? image.index : undefined,
         title,
@@ -349,6 +355,28 @@ export function extractConversationEvidence(
       return { sources: [], images: [], mediaAssetIds: [], tabular: table };
     }
 
+    const inspectedPdfPages = parts
+      .filter((part) => part.name === 'inspectPdfPages')
+      .flatMap((part) => {
+        const input = unwrapJson(part.input) as { documentId?: unknown } | undefined;
+        const output = unwrapJson(part.output) as
+          | { success?: unknown; pages?: Array<{ pageNumber?: unknown; imageUrl?: unknown }> }
+          | undefined;
+        if (typeof input?.documentId !== 'string' || output?.success !== true) return [];
+        return (output.pages ?? []).flatMap((page) => {
+          if (typeof page.pageNumber !== 'number' || !Number.isInteger(page.pageNumber)) return [];
+          return [
+            {
+              documentId: input.documentId as string,
+              pageNumber: page.pageNumber,
+              ...(typeof page.imageUrl === 'string' && page.imageUrl
+                ? { imageUrl: page.imageUrl }
+                : {}),
+            } satisfies ReusableImageEvidence,
+          ];
+        });
+      });
+
     const result = parts
       .filter((part) => part.name === 'searchKnowledgeBase')
       .map(
@@ -369,14 +397,17 @@ export function extractConversationEvidence(
     const hits = Array.isArray(result?.hits) ? result.hits : [];
 
     const images = new Map<string, ReusableImageEvidence>();
+    for (const image of inspectedPdfPages) {
+      images.set(`${image.documentId}:${image.pageNumber}`, image);
+    }
     for (const hit of hits.slice(0, 4) as any[]) {
       if (!hit || typeof hit !== 'object') continue;
       const title = typeof hit.title === 'string' ? hit.title : undefined;
       for (const image of [
-        ...imageEvidence(hit.images, title),
-        ...imageEvidence(hit.metadata?.images, title),
+        ...imageEvidence(hit.images, title, hit.documentId),
+        ...imageEvidence(hit.metadata?.images, title, hit.documentId),
       ]) {
-        images.set(image.imageUrl, image);
+        images.set(image.imageUrl ?? `${image.documentId}:${image.pageNumber}`, image);
       }
     }
     const sources = hits.slice(0, 2).flatMap((hit: any) => {
@@ -500,11 +531,23 @@ export function isTabularFollowUp(text: string, evidence: ConversationEvidence):
 
 export function isImagePreviewFollowUp(text: string, evidence: ConversationEvidence): boolean {
   if (evidence.images.length === 0) return false;
-  return /\b(?:show|preview|display|open|view|render)\b[\s\S]{0,40}\b(?:image|picture|diagram|page|figure|it)\b|\b(?:image|picture|diagram|figure)\s+preview\b/i.test(
+  return /\b(?:show|preview|display|open|view|render|need|give|provide|want)\b[\s\S]{0,40}\b(?:image|picture|diagram|page|figure|visual|it)\b|\b(?:image|picture|diagram|figure|visual)\s+(?:preview|view)\b/i.test(
     text,
   );
 }
 
+/** Reuse the exact prior source, preferring a fresh PDF-page render over a stale derivative. */
+export function imagePreviewInput(
+  evidence: ConversationEvidence,
+): { documentId: string; pageNumber: number } | { imageUrl: string } | undefined {
+  const image = evidence.images[0];
+  if (!image) return undefined;
+  if (image.documentId && image.pageNumber) {
+    return { documentId: image.documentId, pageNumber: image.pageNumber };
+  }
+  return image.imageUrl ? { imageUrl: image.imageUrl } : undefined;
+}
+
 /**
  * A source is selected by structured evidence from the immediately preceding
  * turn. Keep it until a later source-selection event replaces it; never infer

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

@@ -441,7 +441,18 @@ export function formatLocatedObservedSubjectAnswer(value: unknown): string | und
  * asking a prose model to reinterpret explicit discrete moments as one
  * continuous appearance or as an absence claim.
  */
-export function formatObservedAppearanceAnswer(value: unknown): string | undefined {
+export function formatObservedAppearanceAnswer(
+  value: unknown,
+  investigation?: { goal?: unknown; recordSet?: unknown },
+): string | undefined {
+  // A visibility ledger answers recurrence/presence questions. It is context,
+  // not a substitute for another requested visual fact such as clothing,
+  // colour, action, count, or identity. The typed planner directive is the
+  // language-neutral boundary: only an explicit observed trace may render the
+  // ledger as the final answer.
+  if (investigation?.goal !== 'trace' || investigation.recordSet !== 'observed') {
+    return undefined;
+  }
   type Appearance = { startSecs: number; endSecs: number };
   type Subject = { identity: string; basis: string; appearances: Appearance[] };
   const subjects = new Map<string, Subject>();
@@ -544,7 +555,7 @@ export function formatOutcomeMediaAnswer(
   value: unknown,
   investigation: VideoInvestigationDirective,
 ): string | undefined {
-  if (investigation.goal !== 'trace') return undefined;
+  if (investigation.goal !== 'trace' && investigation.goal !== 'resolve') return undefined;
   type Reading = { at: number; text: string };
   const readings: Reading[] = [];
   const visit = (candidate: unknown) => {
@@ -575,6 +586,16 @@ export function formatOutcomeMediaAnswer(
   };
   visit(value);
 
+  const settledWinner = readings
+    .sort((left, right) => left.at - right.at)
+    .flatMap((reading) => {
+      const match = reading.text.match(
+        /^Reconciled event:\s*(?:.*?\b(?:conclusion|final)\b.*?)\bwith\s+(.+?)\s+as\s+(?:the\s+)?winner\s*$/iu,
+      );
+      return match?.[1]?.trim() ? [{ ...reading, winner: match[1].trim() }] : [];
+    })
+    .at(-1);
+
   const cleanLabel = (label: string) =>
     label
       .replace(/^.*?(?:(?:final\s+)?(?:result|score)|النتيجة(?:\s+النهائية)?)\s*:\s*/iu, '')
@@ -607,6 +628,22 @@ export function formatOutcomeMediaAnswer(
           : [];
       });
     });
+  const sideScorePattern =
+    /^\s*(.+?\p{L})\s+(\d+(?:[.,]\d+)?)\s*[|｜]\s*(.+?\p{L})\s+(\d+(?:[.,]\d+)?)\s*$/u;
+  const sideScoreCandidates = readings
+    .sort((left, right) => left.at - right.at)
+    .flatMap((reading) => {
+      const match = cleanLabel(reading.text).match(sideScorePattern);
+      if (!match) return [];
+      const left = { label: cleanLabel(match[1]), value: Number(match[2].replace(',', '.')) };
+      const right = { label: cleanLabel(match[3]), value: Number(match[4].replace(',', '.')) };
+      return left.label &&
+        right.label &&
+        Number.isFinite(left.value) &&
+        Number.isFinite(right.value)
+        ? [{ ...reading, pairs: [left, right] }]
+        : [];
+    });
   const pairPattern =
     /([^=,;،؛\n]{2,100}?)(?:\s*=\s*|\s*:\s*|\s+)(-?\d+(?:[.,]\d+)?)(?=$|[,;،؛])/gu;
   const candidates = readings
@@ -622,7 +659,14 @@ export function formatOutcomeMediaAnswer(
       };
     })
     .filter((reading) => reading.pairs.length === 2);
-  const settled = scorelineCandidates.at(-1) ?? candidates.at(-1);
+  const settled = scorelineCandidates.at(-1) ?? sideScoreCandidates.at(-1) ?? candidates.at(-1);
+  if (settledWinner) {
+    if (!settled) return `${settledWinner.winner} won.`;
+    const values = settled.pairs.map((pair) => pair.value).sort((left, right) => right - left);
+    if (values[0] !== values[1]) {
+      return `${settledWinner.winner} won, ${values[0]}–${values[1]}.`;
+    }
+  }
   if (!settled) return undefined;
   const [left, right] = settled.pairs;
   if (left.value === right.value) {

package/src/lib/chat/video-query-planning.ts

@@ -0,0 +1,44 @@
+import type { VideoInvestigationDirective } from '@larkup/core/video-knowledge/query-planner';
+
+export interface VideoQuestionSignals {
+  hasPosition?: boolean;
+  connectsBeyondPosition?: boolean;
+  asksForSettledOutcome?: boolean;
+  asksForExhaustiveCoverage?: boolean;
+}
+
+/**
+ * Reconcile the planner directive with the independent question classifier.
+ * The classifier is deliberately language-neutral and has final authority over
+ * outcome requests, because a broad planner can otherwise mistake “who won?”
+ * for source synthesis and send the answer through appearance rendering.
+ */
+export function reconcileVideoInvestigation(
+  planned: VideoInvestigationDirective | undefined,
+  signals: VideoQuestionSignals | undefined,
+): VideoInvestigationDirective | undefined {
+  if (signals?.asksForSettledOutcome) {
+    return { scope: 'temporal', goal: 'resolve' };
+  }
+  if (signals?.hasPosition === false && signals.asksForExhaustiveCoverage) {
+    return {
+      scope: 'source',
+      goal: 'enumerate',
+      ...(planned?.evidence?.length ? { evidence: planned.evidence } : {}),
+      recordSet: 'all',
+    };
+  }
+  if (signals?.hasPosition === false && planned?.timeRange) {
+    return { scope: 'source', goal: 'synthesize' };
+  }
+  if ((signals?.connectsBeyondPosition || planned?.goal === 'trace') && planned?.timeRange) {
+    return {
+      ...planned,
+      scope: 'temporal',
+      goal: 'trace',
+      evidence: ['visual'],
+      recordSet: 'observed',
+    };
+  }
+  return planned;
+}