@larkup/workspace-server 0.2.1 → 0.2.2

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

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":"AA2XA,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":"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"}

package/dist-types/lib/chat/media-retrieval-routing.d.ts

@@ -10,5 +10,7 @@ export declare function leadingMediaAssetId(retrieval: {
 }, activeAssetIds: ReadonlySet<string>, assetIdByDocumentId: ReadonlyMap<string, string>): string | undefined;
 /** Read only an explicitly routed media source, never metadata on secondary search hits. */
 export declare function explicitMediaEvidenceAssetId(value: unknown): string | null;
+/** A deterministic gate before an answer model is allowed to compose prose. */
+export declare function hasRetrievedSourceEvidence(value: unknown): boolean;
 export {};
 //# sourceMappingURL=media-retrieval-routing.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"media-retrieval-routing.d.ts","sourceRoot":"","sources":["../../../src/lib/chat/media-retrieval-routing.ts"],"names":[],"mappings":"AAAA,KAAK,YAAY,GAAG;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACvC,CAAC;AAEF,gFAAgF;AAChF,wBAAgB,mBAAmB,CACjC,SAAS,EAAE;IAAE,IAAI,CAAC,EAAE,YAAY,EAAE,CAAA;CAAE,EACpC,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,EACnC,mBAAmB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/C,MAAM,GAAG,SAAS,CASpB;AAED,4FAA4F;AAC5F,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAc1E"}
+{"version":3,"file":"media-retrieval-routing.d.ts","sourceRoot":"","sources":["../../../src/lib/chat/media-retrieval-routing.ts"],"names":[],"mappings":"AAAA,KAAK,YAAY,GAAG;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACvC,CAAC;AAEF,gFAAgF;AAChF,wBAAgB,mBAAmB,CACjC,SAAS,EAAE;IAAE,IAAI,CAAC,EAAE,YAAY,EAAE,CAAA;CAAE,EACpC,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,EACnC,mBAAmB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/C,MAAM,GAAG,SAAS,CASpB;AAED,4FAA4F;AAC5F,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAc1E;AAED,+EAA+E;AAC/E,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAOlE"}

package/dist-types/lib/chat/media-source-routing.d.ts

@@ -15,6 +15,9 @@ export declare function clearlyTitleMatchedMediaAsset<T extends RoutableMediaAss
  * retrieval miss, but it must never pre-empt a document or tabular hit.
  */
 export declare function explicitlySelectedMediaAsset<T extends RoutableMediaAsset>(query: string, assets: readonly T[]): T | undefined;
+/** Recover media after a miss only when the user named the source clearly.
+ * A sole video is not evidence for every unrelated question. */
+export declare function retrievalFallbackMediaAsset<T extends RoutableMediaAsset>(query: string, assets: readonly T[]): T | undefined;
 /**
  * Detect an explicitly named source that exists but is outside the Assistant
  * source scope. A generic single-source fallback must not silently replace it

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

@@ -1 +1 @@
-{"version":3,"file":"media-source-routing.d.ts","sourceRoot":"","sources":["../../../src/lib/chat/media-source-routing.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,8BAA8B,CAAC,EAAE,MAAM,CAAC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,oFAAoF;AACpF,wBAAgB,6BAA6B,CAAC,CAAC,SAAS,kBAAkB,EACxE,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,SAAS,CAAC,EAAE,GACnB,CAAC,GAAG,SAAS,CAUf;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,CAAC,SAAS,kBAAkB,EACvE,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,SAAS,CAAC,EAAE,GACnB,CAAC,GAAG,SAAS,CAEf;AAED;;;;GAIG;AACH,wBAAgB,wCAAwC,CAAC,CAAC,SAAS,kBAAkB,EACnF,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,SAAS,CAAC,EAAE,EAC7B,SAAS,EAAE,SAAS,CAAC,EAAE,GACtB,CAAC,GAAG,SAAS,CAIf;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,kBAAkB,EACtE,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,CAAC,EACd,eAAe,EAAE,SAAS,CAAC,EAAE,WAG9B;AAED,wFAAwF;AACxF,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,kBAAkB,EACzB,cAAc,CAAC,EAAE,MAAM;;;;;;;;;;;;;;;;;;;EAyBxB"}
+{"version":3,"file":"media-source-routing.d.ts","sourceRoot":"","sources":["../../../src/lib/chat/media-source-routing.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,8BAA8B,CAAC,EAAE,MAAM,CAAC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,oFAAoF;AACpF,wBAAgB,6BAA6B,CAAC,CAAC,SAAS,kBAAkB,EACxE,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,SAAS,CAAC,EAAE,GACnB,CAAC,GAAG,SAAS,CAUf;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,CAAC,SAAS,kBAAkB,EACvE,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,SAAS,CAAC,EAAE,GACnB,CAAC,GAAG,SAAS,CAEf;AAED;gEACgE;AAChE,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,kBAAkB,EACtE,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,SAAS,CAAC,EAAE,GACnB,CAAC,GAAG,SAAS,CAEf;AAED;;;;GAIG;AACH,wBAAgB,wCAAwC,CAAC,CAAC,SAAS,kBAAkB,EACnF,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,SAAS,CAAC,EAAE,EAC7B,SAAS,EAAE,SAAS,CAAC,EAAE,GACtB,CAAC,GAAG,SAAS,CAIf;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,kBAAkB,EACtE,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,CAAC,EACd,eAAe,EAAE,SAAS,CAAC,EAAE,WAG9B;AAED,wFAAwF;AACxF,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,kBAAkB,EACzB,cAAc,CAAC,EAAE,MAAM;;;;;;;;;;;;;;;;;;;EAyBxB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@larkup/workspace-server",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "type": "module",
   "files": [
     "src",
@@ -324,8 +324,8 @@
     "zod": "^4.4.3",
     "mammoth": "^1.12.0",
     "@larkup/marketplace": "0.3.10",
-    "@larkup/sandbox": "0.1.8",
     "@larkup/scraper": "0.2.1",
+    "@larkup/sandbox": "0.1.8",
     "@larkup/vector-stores": "0.1.27"
   },
   "devDependencies": {

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

@@ -99,7 +99,10 @@ import {
 import { assistantSourceScopeFingerprint } from '../../../lib/chat/assistant-source-scope';
 import { normalizeIncomingMessages } from '../../../lib/chat/message-input';
 import { repairChatToolCall } from '../../../lib/chat/tool-call-repair';
-import { explicitMediaEvidenceAssetId } from '../../../lib/chat/media-retrieval-routing';
+import {
+  explicitMediaEvidenceAssetId,
+  hasRetrievedSourceEvidence,
+} from '../../../lib/chat/media-retrieval-routing';
 import {
   authorizeEnterpriseAiRequest,
   trackEnterpriseAiUsage,
@@ -1458,6 +1461,26 @@ ${fieldLines}`;
             output: preloadedEvidence,
           });
 
+          // End no-evidence turns deterministically. A prose model may answer
+          // from general knowledge or mistake a sole media source for evidence
+          // even when the retrieval instruction says not to.
+          if (!hasRetrievedSourceEvidence(preloadedEvidence)) {
+            const retrievalError =
+              preloadedEvidence && typeof preloadedEvidence === 'object'
+                ? (preloadedEvidence as { error?: unknown }).error
+                : undefined;
+            const answer =
+              typeof retrievalError === 'string' && retrievalError.trim()
+                ? retrievalError
+                : "I couldn't find an answer to that in this project's data.";
+            const answerId = `answer-${crypto.randomUUID()}`;
+            writer.write({ type: 'text-start', id: answerId });
+            writer.write({ type: 'text-delta', id: answerId, delta: answer });
+            writer.write({ type: 'text-end', id: answerId });
+            await mcp.close();
+            return;
+          }
+
           // A PDF hit is a document-level locator, not necessarily the exact
           // page. Read its bounded local page evidence before asking the chat
           // model to compose an answer. This works whether or not visual

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

@@ -88,6 +88,7 @@ import {
   clearlyTitleMatchedMediaAsset,
   clearlyUnavailableTitleMatchedMediaAsset,
   explicitlySelectedMediaAsset,
+  retrievalFallbackMediaAsset,
   shouldKeepActiveMediaSource,
 } from '../../../lib/chat/media-source-routing';
 import { createTabularVisualization } from '../../../lib/chat/tabular-visualization';
@@ -348,24 +349,11 @@ function uniqueCompletedMediaFallback(
       error: `The named media source "${unavailableTitleMatch.fileName}" is not available to Assistant chat. Enable its data group under Data → Groups, then ask again.`,
     };
   }
-  // A retrieval miss must not strand a single, unambiguous active media
-  // source. With several sources the host deliberately stays neutral and
-  // lets ordinary retrieval disambiguate rather than guessing the asset.
-  if (assets.length === 1) {
-    return {
-      query,
-      hits: [],
-      videoEvidence: {
-        mediaAssetId: assets[0].id,
-        retrievalFallback: 'single-active-media-source',
-      },
-    };
-  }
   // A vector index can be temporarily unavailable while a completed video
   // remains perfectly usable through its evidence store. Recover an asset
-  // only when its user-visible title has a clear lexical lead; otherwise
-  // preserve the neutral no-result behavior for genuinely ambiguous media.
-  const titleMatch = clearlyTitleMatchedMediaAsset(query, assets);
+  // only when its user-visible title has a clear lexical lead. The mere fact
+  // that a project contains one video is not evidence for an unrelated query.
+  const titleMatch = retrievalFallbackMediaAsset(query, assets);
   if (!titleMatch) return { query, hits: [] };
   return {
     query,

package/src/lib/chat/media-retrieval-routing.ts

@@ -35,3 +35,13 @@ export function explicitMediaEvidenceAssetId(value: unknown): string | null {
   }
   return explicitMediaEvidenceAssetId(record.videoEvidence);
 }
+
+/** A deterministic gate before an answer model is allowed to compose prose. */
+export function hasRetrievedSourceEvidence(value: unknown): boolean {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) return false;
+  const record = value as { hits?: unknown };
+  return (
+    (Array.isArray(record.hits) && record.hits.length > 0) ||
+    Boolean(explicitMediaEvidenceAssetId(value))
+  );
+}

package/src/lib/chat/media-source-routing.ts

@@ -38,6 +38,15 @@ export function explicitlySelectedMediaAsset<T extends RoutableMediaAsset>(
   return clearlyTitleMatchedMediaAsset(query, assets);
 }
 
+/** Recover media after a miss only when the user named the source clearly.
+ * A sole video is not evidence for every unrelated question. */
+export function retrievalFallbackMediaAsset<T extends RoutableMediaAsset>(
+  query: string,
+  assets: readonly T[],
+): T | undefined {
+  return clearlyTitleMatchedMediaAsset(query, assets);
+}
+
 /**
  * Detect an explicitly named source that exists but is outside the Assistant
  * source scope. A generic single-source fallback must not silently replace it