@larkup/workspace-server 0.2.2 → 0.2.9

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":"AAoHA,eAAO,MAAM,WAAW,MAAM,CAAC;AAutB/B,wBAAsB,IAAI,CAAC,GAAG,EAAE,OAAO,qBA26CtC"}

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,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,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,14 @@
+import type { VideoInvestigationDirective } from '@larkup/core/video-knowledge/query-planner';
+export interface VideoQuestionSignals {
+    hasPosition?: boolean;
+    connectsBeyondPosition?: boolean;
+    asksForSettledOutcome?: 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;CACjC;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,2BAA2B,GAAG,SAAS,EAChD,OAAO,EAAE,oBAAoB,GAAG,SAAS,GACxC,2BAA2B,GAAG,SAAS,CAiBzC"}

package/dist-types/lib/media/source-utils.d.ts

@@ -34,7 +34,7 @@ export interface UrlInspection {
     isYouTube: boolean;
 }
 /** Download a public URL after applying the same DNS and redirect checks as media imports. */
-export declare function readPublicUrl(url: string, maxBytes?: number): Promise<{
+export declare function readPublicUrl(url: string, maxBytes?: number, init?: RequestInit): Promise<{
     bytes: Uint8Array;
     mimeType?: string;
     finalUrl: string;
@@ -57,6 +57,21 @@ interface YouTubeInspectionData {
         duration?: number;
     }>;
 }
+interface YouTubePlayerData {
+    videoDetails?: {
+        videoId?: string;
+        title?: string;
+        lengthSeconds?: string | number;
+    };
+    streamingData?: {
+        formats?: Array<{
+            approxDurationMs?: string | number;
+        }>;
+        adaptiveFormats?: Array<{
+            approxDurationMs?: string | number;
+        }>;
+    };
+}
 export declare function inspectYouTubeMetadata(url: string, data: YouTubeInspectionData): UrlInspection;
 /**
  * A public watch URL is enough to stage one video even when an interactive
@@ -65,6 +80,8 @@ export declare function inspectYouTubeMetadata(url: string, data: YouTubeInspect
  * fallback does not claim a title, duration, or byte size it could not verify.
  */
 export declare function inspectYouTubeWatchUrl(url: string): UrlInspection | undefined;
+export declare function inspectYouTubeWatchPage(url: string, html: string): UrlInspection | undefined;
+export declare function inspectYouTubePlayerMetadata(url: string, data: YouTubePlayerData): UrlInspection | undefined;
 export interface MediaProbe {
     durationSecs: number;
     containerDurationSecs: number;

package/dist-types/lib/media/source-utils.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@larkup/workspace-server",
-  "version": "0.2.2",
+  "version": "0.2.9",
   "type": "module",
   "files": [
     "src",
@@ -317,16 +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",
     "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/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

@@ -41,6 +41,7 @@ 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,
@@ -65,6 +66,7 @@ import {
   formatExhaustiveMediaAnswer,
   formatLocatedObservedSubjectAnswer,
   formatObservedAppearanceAnswer,
+  formatOutcomeMediaAnswer,
   mediaEvidenceRequestsOnlySpeech,
   mediaClaimNeedsCorroboration,
   withFinalAnswerNudge,
@@ -450,8 +452,9 @@ 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. ' +
         '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 +464,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 +489,7 @@ async function userSpecifiedSourcePosition(input: {
   | {
       hasPosition: boolean;
       connectsBeyondPosition: boolean;
+      asksForSettledOutcome: boolean;
     }
   | undefined
 > {
@@ -498,7 +502,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}. 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. 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}. Example: "Who won the match?" => {"kind":"none","locator":null,"connectsBeyondPosition":false,"asksForSettledOutcome":true}. Example: "What happens at 14:00?" => {"kind":"input-location","locator":"14:00","connectsBeyondPosition":false,"asksForSettledOutcome":false}. Example: "Who is at 14:00 and where else do they appear?" => {"kind":"input-location","locator":"14:00","connectsBeyondPosition":true,"asksForSettledOutcome":false}. Example: "Give the full story from beginning to conclusion" => {"kind":"none","locator":null,"connectsBeyondPosition":false,"asksForSettledOutcome":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 +511,12 @@ async function userSpecifiedSourcePosition(input: {
       kind?: unknown;
       locator?: unknown;
       connectsBeyondPosition?: unknown;
+      asksForSettledOutcome?: unknown;
     };
     const connectsBeyondPosition = parsed.connectsBeyondPosition === true;
+    const asksForSettledOutcome = parsed.asksForSettledOutcome === true;
     if (parsed.kind === 'answer-timestamp' || parsed.kind === 'none') {
-      return { hasPosition: false, connectsBeyondPosition };
+      return { hasPosition: false, connectsBeyondPosition, asksForSettledOutcome };
     }
     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 +524,7 @@ async function userSpecifiedSourcePosition(input: {
     return {
       hasPosition: input.question.normalize('NFKC').includes(parsed.locator.normalize('NFKC')),
       connectsBeyondPosition,
+      asksForSettledOutcome,
     };
   } catch {
     return undefined;
@@ -535,7 +542,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'])
@@ -1362,6 +1369,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 +1708,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 +1766,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)))
             : 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/tool-context.ts

@@ -544,7 +544,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 +575,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 +617,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 +648,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,35 @@
+import type { VideoInvestigationDirective } from '@larkup/core/video-knowledge/query-planner';
+
+export interface VideoQuestionSignals {
+  hasPosition?: boolean;
+  connectsBeyondPosition?: boolean;
+  asksForSettledOutcome?: 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 && 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;
+}

package/src/lib/media/source-utils.ts

@@ -43,8 +43,9 @@ export interface UrlInspection {
 export async function readPublicUrl(
   url: string,
   maxBytes = 25 * 1024 * 1024,
+  init: RequestInit = {},
 ): Promise<{ bytes: Uint8Array; mimeType?: string; finalUrl: string }> {
-  const response = await fetchPublic(url);
+  const response = await fetchPublic(url, init);
   if (!response.ok || !response.body) {
     await response.body?.cancel();
     throw new Error(`Media download failed (${response.status}).`);
@@ -98,6 +99,18 @@ interface YouTubeInspectionData {
   }>;
 }
 
+interface YouTubePlayerData {
+  videoDetails?: {
+    videoId?: string;
+    title?: string;
+    lengthSeconds?: string | number;
+  };
+  streamingData?: {
+    formats?: Array<{ approxDurationMs?: string | number }>;
+    adaptiveFormats?: Array<{ approxDurationMs?: string | number }>;
+  };
+}
+
 function positiveDuration(value: unknown): number | undefined {
   const duration = Number(value);
   return Number.isFinite(duration) && duration > 0 ? duration : undefined;
@@ -170,6 +183,107 @@ export function inspectYouTubeWatchUrl(url: string): UrlInspection | undefined {
   };
 }
 
+export function inspectYouTubeWatchPage(url: string, html: string): UrlInspection | undefined {
+  const details = jsonObjectAfterMarker(html, '"videoDetails":');
+  if (details) {
+    try {
+      const inspection = inspectYouTubePlayerMetadata(url, {
+        videoDetails: JSON.parse(details) as YouTubePlayerData['videoDetails'],
+      });
+      if (inspection) return inspection;
+    } catch {
+      // Continue to the page's public schema.org duration metadata.
+    }
+  }
+  const requestedId = youtubeVideoId(url);
+  const durationSecs = youtubePageDurationSecs(html);
+  return requestedId && durationSecs
+    ? youtubeInspection(url, requestedId, undefined, durationSecs)
+    : undefined;
+}
+
+export function inspectYouTubePlayerMetadata(
+  url: string,
+  data: YouTubePlayerData,
+): UrlInspection | undefined {
+  const requestedId = youtubeVideoId(url);
+  const details = data.videoDetails;
+  const declaredDurationSecs = positiveDuration(details?.lengthSeconds);
+  if (requestedId && declaredDurationSecs && details?.videoId === requestedId) {
+    return youtubeInspection(url, requestedId, details.title, declaredDurationSecs);
+  }
+  // Some serverless requests receive a reduced but still valid player payload:
+  // `videoDetails` is omitted while the signed selected-stream metadata remains.
+  // It is tied to the requested ID in this player request, so use a rounded
+  // positive stream duration only when the response does not claim another ID.
+  const streamDurationSecs = playerStreamDurationSecs(data);
+  if (!requestedId || data.videoDetails?.videoId || !streamDurationSecs) return undefined;
+  return youtubeInspection(url, requestedId, data.videoDetails?.title, streamDurationSecs);
+}
+
+function youtubeInspection(
+  url: string,
+  requestedId: string,
+  title: string | undefined,
+  durationSecs: number,
+): UrlInspection {
+  return {
+    originalUrl: url,
+    ...(title ? { title } : {}),
+    durationSecs,
+    singleItemDurationSecs: durationSecs,
+    singleItemUrl: `https://www.youtube.com/watch?v=${encodeURIComponent(requestedId)}`,
+    entryCount: 1,
+    mediaType: 'video',
+    isYouTube: true,
+  };
+}
+
+function playerStreamDurationSecs(data: YouTubePlayerData): number | undefined {
+  const durations = [
+    ...(data.streamingData?.formats ?? []),
+    ...(data.streamingData?.adaptiveFormats ?? []),
+  ]
+    .map((format) => positiveDuration(Number(format.approxDurationMs) / 1_000))
+    .filter((duration): duration is number => duration !== undefined);
+  return durations.length ? Math.round(Math.max(...durations)) : undefined;
+}
+
+function youtubePageDurationSecs(html: string): number | undefined {
+  const durationTag = html.match(
+    /<meta\b(?=[^>]*\bitemprop=["']duration["'])(?=[^>]*\bcontent=["']([^"']+)["'])[^>]*>/i,
+  );
+  const durationText = durationTag?.[1];
+  if (!durationText) return undefined;
+  const match = durationText.match(/^PT(?:(\d+)H)?(?:(\d+)M)?(?:(\d+)S)?$/i);
+  if (!match) return undefined;
+  return positiveDuration(
+    Number(match[1] ?? 0) * 3_600 + Number(match[2] ?? 0) * 60 + Number(match[3] ?? 0),
+  );
+}
+
+function jsonObjectAfterMarker(source: string, marker: string): string | undefined {
+  const markerIndex = source.indexOf(marker);
+  const start = markerIndex < 0 ? -1 : source.indexOf('{', markerIndex + marker.length);
+  if (start < 0) return undefined;
+  let depth = 0;
+  let inString = false;
+  let escaped = false;
+  for (let index = start; index < source.length; index++) {
+    const character = source[index];
+    if (inString) {
+      if (escaped) escaped = false;
+      else if (character === '\\') escaped = true;
+      else if (character === '"') inString = false;
+      continue;
+    }
+    if (character === '"') inString = true;
+    else if (character === '{') depth += 1;
+    else if (character === '}' && --depth === 0) return source.slice(start, index + 1);
+  }
+  return undefined;
+}
+
 export interface MediaProbe {
   durationSecs: number;
   containerDurationSecs: number;
@@ -313,6 +427,48 @@ export function hasInflatedPlaybackTimeline(probe: MediaProbe) {
   return longestReported - videoDuration > Math.max(5, videoDuration * 0.03);
 }
 
+async function inspectYouTubePlayer(url: string): Promise<UrlInspection | undefined> {
+  const videoId = youtubeVideoId(url);
+  if (!videoId) return undefined;
+  const response = await fetchPublic(
+    'https://www.youtube.com/youtubei/v1/player?prettyPrint=false',
+    {
+      method: 'POST',
+      headers: {
+        'content-type': 'application/json',
+        'user-agent': 'com.google.android.youtube/20.10.38 (Linux; U; Android 11) gzip',
+      },
+      body: JSON.stringify({
+        context: {
+          client: {
+            clientName: 'ANDROID',
+            clientVersion: '20.10.38',
+            androidSdkVersion: 30,
+            hl: 'en',
+            gl: 'US',
+          },
+        },
+        videoId,
+        contentCheckOk: true,
+        racyCheckOk: true,
+      }),
+      signal: AbortSignal.timeout(MEDIA_URL_INSPECTION_TIMEOUT_MS),
+    },
+  );
+  if (!response.ok) {
+    await response.body?.cancel();
+    return undefined;
+  }
+  const declared = Number(response.headers.get('content-length'));
+  if (Number.isFinite(declared) && declared > 3 * 1024 * 1024) {
+    await response.body?.cancel();
+    return undefined;
+  }
+  const body = await response.text();
+  if (body.length > 3 * 1024 * 1024) return undefined;
+  return inspectYouTubePlayerMetadata(url, JSON.parse(body) as YouTubePlayerData);
+}
+
 export async function inspectMediaUrl(url: string): Promise<UrlInspection> {
   const parsed = validHttpUrl(url);
   await assertPublicHost(parsed.hostname);
@@ -321,6 +477,21 @@ export async function inspectMediaUrl(url: string): Promise<UrlInspection> {
     try {
       output = await runYtDlp(['--dump-single-json', '--simulate', '--flat-playlist', url]);
     } catch (error) {
+      const playerInspection = await inspectYouTubePlayer(url).catch(() => undefined);
+      if (playerInspection) return playerInspection;
+      try {
+        const page = await readPublicUrl(url, 3 * 1024 * 1024, {
+          headers: {
+            // YouTube otherwise serves a reduced challenge page to serverless
+            // fetch clients, which excludes its public schema.org duration.
+            'user-agent': 'Mozilla/5.0 (compatible; Larkup/1.0; +https://larkup.de)',
+          },
+        });
+        const inspection = inspectYouTubeWatchPage(url, new TextDecoder().decode(page.bytes));
+        if (inspection) return inspection;
+      } catch {
+        // A public watch URL can still be staged for durable inspection below.
+      }
       const fallback = inspectYouTubeWatchUrl(url);
       if (fallback) return fallback;
       throw error;