@larkup/workspace-server 0.0.0-stage → 0.2.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"video-rag-routing.d.ts","sourceRoot":"","sources":["../../../src/lib/chat/video-rag-routing.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,+BAA+B,GACzC,WAAW,GAAG,YAAY,GAAG,cAAc,GAAG,kBAAkB,CAAC;AAEnE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAKD,eAAO,MAAM,6BAA6B,MAAM,CAAC;AAKjD,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD,kFAAkF;AAClF,wBAAsB,mCAAmC,CACvD,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,OAAO,CAAC,EAC9F,KAAK,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAC9C,SAAS,EAAE,OAAO,EAClB,UAAU,EAAE,MAAM,oBAqEnB;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAC,KAAK,EAAE;IACtD,kBAAkB,EAAE,+BAA+B,CAAC;IACpD,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,EAAE,wBAAwB,EAAE,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,WAqCA"}

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

@@ -0,0 +1,53 @@
+type ImageDocument = {
+    metadata?: {
+        images?: any[];
+        imageUrl?: unknown;
+        index?: unknown;
+        pageNumber?: unknown;
+    };
+};
+export type RetrievedPdfSource = {
+    documentId: string;
+    pageNumber?: number;
+    title?: string;
+};
+/** Resolve both current parent-document images and legacy standalone image records. */
+export declare function findIndexedImageSource<T extends ImageDocument>(documents: T[], imageUrl: string): {
+    source: T | undefined;
+    image: any;
+} | undefined;
+/** Recognizes image-bearing retrieval results, including compact JSON envelopes. */
+export declare function hasRetrievedImageEvidence(value: unknown): boolean;
+/** Finds a PDF source returned by retrieval, even when it has no pre-indexed images. */
+export declare function hasRetrievedPdfEvidence(value: unknown): boolean;
+/** Whether the request names a stable, numbered object inside a document. */
+export declare function hasNumberedDocumentReference(text: string): boolean;
+/** Return the nearest named document object from a chronological text history. */
+export declare function latestNumberedDocumentReferenceText(texts: readonly string[]): string | undefined;
+/**
+ * An explicit document reference must be ranked against the original PDF.
+ * Otherwise, a page attached to the retrieval hit is an efficient exact hint.
+ */
+export declare function preferredPdfPagesForInspection(retrievedPageNumber: number | undefined, question: string): number[] | undefined;
+/**
+ * Select the leading PDF source returned by retrieval. A direct visual chunk
+ * carries its page number, so it is preferred over a document-level text
+ * chunk that would otherwise make a preview fall back to page one.
+ */
+export declare function findRetrievedPdfSource(value: unknown): RetrievedPdfSource | undefined;
+/**
+ * Reuse relevant descriptions produced during image indexing, and reserve a
+ * fresh vision pass for details those descriptions do not cover.
+ */
+export declare function shouldInspectRetrievedImage(text: string, evidence: unknown): boolean;
+/** Generic presentation intent, shared by PDFs, screenshots, scans, and media frames. */
+export declare function requestsImagePresentation(text: string): boolean;
+/**
+ * Page text is enough for ordinary prose. These requests explicitly depend on
+ * page layout, notation, or a visual object, so a rendered-page read is the
+ * higher-fidelity source of truth. The language is document-generic rather
+ * than tied to any particular paper or diagram format.
+ */
+export declare function requiresPdfVisualAnalysis(text: string): boolean;
+export {};
+//# sourceMappingURL=visual-routing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"visual-routing.d.ts","sourceRoot":"","sources":["../../../src/lib/chat/visual-routing.ts"],"names":[],"mappings":"AAEA,KAAK,aAAa,GAAG;IACnB,QAAQ,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC1F,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AASF,uFAAuF;AACvF,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,aAAa,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM;;;cAiB/F;AAuBD,oFAAoF;AACpF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAajE;AAED,wFAAwF;AACxF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CA0B/D;AAMD,6EAA6E;AAC7E,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElE;AAED,kFAAkF;AAClF,wBAAgB,mCAAmC,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAKhG;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,mBAAmB,EAAE,MAAM,GAAG,SAAS,EACvC,QAAQ,EAAE,MAAM,GACf,MAAM,EAAE,GAAG,SAAS,CAGtB;AAsBD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CAarF;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CA2BpF;AAED,yFAAyF;AACzF,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAI/D;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAI/D"}

package/dist-types/lib/enterprise-client.d.ts

@@ -0,0 +1,31 @@
+export type EnterpriseToolDescriptor = {
+    id: string;
+    name: string;
+    description: string;
+    ui: 'notice' | 'table' | 'card';
+};
+export declare function getEnterpriseTools(config: any): Promise<EnterpriseToolDescriptor[]>;
+export declare function executeEnterpriseTool(config: any, id: string, input: {
+    query?: string;
+}): Promise<any>;
+/** Do this before model invocation so a paused or exhausted client cannot spend more. */
+export declare function authorizeEnterpriseAiRequest(config: any): Promise<void>;
+export declare function trackEnterpriseAiUsage(config: any, event: {
+    modelId: string;
+    inputTokens: number;
+    outputTokens: number;
+    costUsd: number;
+}): void;
+/**
+ * Reports one meter's usage for an installed Marketplace catalog tool. This
+ * is the `trackUsage` sink wired into every dynamically-loaded ToolExtension
+ * client for an EE-enrolled installation — generic across tools, since the
+ * meter id and quantity always come from the tool itself, never hardcoded
+ * here. A no-op when the workspace isn't enrolled with Enterprise.
+ */
+export declare function trackEnterpriseToolUsage(config: any, toolId: string, event: {
+    meter: string;
+    quantity: number;
+    unit: string;
+}): void;
+//# sourceMappingURL=enterprise-client.d.ts.map

package/dist-types/lib/enterprise-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enterprise-client.d.ts","sourceRoot":"","sources":["../../src/lib/enterprise-client.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,wBAAwB,GAAG;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;CACjC,CAAC;AAyBF,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAYzF;AAED,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,gBAK7F;AAED,yFAAyF;AACzF,wBAAsB,4BAA4B,CAAC,MAAM,EAAE,GAAG,iBAG7D;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,GAAG,EACX,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,QAMvF;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,MAAM,EACd,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,QAYzD"}

package/dist-types/lib/marketplace/tool-runtime-config.d.ts

@@ -0,0 +1,7 @@
+import type { RagConfig } from '@larkup/core/types';
+/**
+ * Supplies a marketplace runtime with the user's selected AI Models settings
+ * without making the installed package import the host application's source.
+ */
+export declare function withGlobalVisionGatewayConfig(toolConfig: Record<string, unknown>, config: Pick<RagConfig, 'visionProvider' | 'visionApiKey' | 'visionModelId' | 'chatProvider' | 'chatApiKey' | 'chatModelId' | 'embeddingProvider' | 'embeddingApiKey'>): Record<string, unknown>;
+//# sourceMappingURL=tool-runtime-config.d.ts.map

package/dist-types/lib/marketplace/tool-runtime-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-runtime-config.d.ts","sourceRoot":"","sources":["../../../src/lib/marketplace/tool-runtime-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,MAAM,EAAE,IAAI,CACV,SAAS,EACP,gBAAgB,GAChB,cAAc,GACd,eAAe,GACf,cAAc,GACd,YAAY,GACZ,aAAa,GACb,mBAAmB,GACnB,iBAAiB,CACpB,GACA,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyEzB"}

package/dist-types/lib/media/knowledge.d.ts

@@ -0,0 +1,47 @@
+import type { NewDocumentInput } from '@larkup/core/documents-store';
+import type { RagConfig } from '@larkup/core/types';
+export interface MediaEvidenceSegment {
+    text: string;
+    transcript?: string;
+    visualContext?: string;
+    startSecs: number;
+    endSecs: number;
+    sequence: number;
+}
+interface SummaryOptions {
+    title: string;
+    mediaType: 'video' | 'audio';
+    durationSecs: number;
+    segments: MediaEvidenceSegment[];
+    config: RagConfig;
+    onProgress?: (completed: number, total: number, message: string) => void | Promise<void>;
+}
+interface MediaDocumentOptions {
+    assetId: string;
+    title: string;
+    mediaType: 'video' | 'audio';
+    localUrl: string;
+    originalUrl?: string;
+    durationSecs: number;
+    summary: string;
+    segments: MediaEvidenceSegment[];
+    fileName: string;
+    mimeType: string;
+    transcriptSource: string;
+    transcriptProvider?: string;
+    transcriptLanguage?: string;
+    knowledgeRevisionId?: string;
+    videoRuntimeScope?: 'local' | 'cloud';
+}
+export declare function createMediaKnowledgeSummary(options: SummaryOptions): Promise<string>;
+export declare function createFallbackMediaSummary(_title: string, _mediaType: 'video' | 'audio', segments: MediaEvidenceSegment[]): string;
+export declare function buildMediaDocumentInputs(options: MediaDocumentOptions): NewDocumentInput[];
+export declare function timestampMediaUrl(url: string, startSecs: number): string;
+export declare function normalizeMediaCitationRange(mediaType: 'image' | 'video' | 'audio', durationSecs?: number, startSecs?: number, endSecs?: number): {
+    startSecs?: number;
+    endSecs?: number;
+};
+export declare function formatTime(seconds: number): string;
+export declare function queryAwareExcerpt(text: string, query: string, maxChars: number, preferEnd?: boolean): string;
+export {};
+//# sourceMappingURL=knowledge.d.ts.map

package/dist-types/lib/media/knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../../src/lib/media/knowledge.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAIpD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IACjC,MAAM,EAAE,SAAS,CAAC;IAClB,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1F;AAED,UAAU,oBAAoB;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;CACvC;AAKD,wBAAsB,2BAA2B,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CA0E1F;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,OAAO,GAAG,OAAO,EAC7B,QAAQ,EAAE,oBAAoB,EAAE,GAC/B,MAAM,CAaR;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,oBAAoB,GAAG,gBAAgB,EAAE,CAwD1F;AA2DD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAaxE;AAED,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,EACtC,YAAY,CAAC,EAAE,MAAM,EACrB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAgB1C;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQlD;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,SAAS,UAAQ,GAChB,MAAM,CAmBR"}

package/dist-types/lib/media/pdf-inspection.d.ts

@@ -0,0 +1,30 @@
+export type PdfSource = {
+    id: string;
+    title: string;
+    url?: string;
+};
+export type PdfPageInspection = {
+    pageNumber: number;
+    text: string;
+    tables: unknown[];
+    previewUrl?: string;
+};
+export declare function readStoredPdfBytes(source: PdfSource): Promise<Buffer>;
+/** Rank pages only from their own extracted text; no document-specific assumptions. */
+export declare function selectRelevantPdfPages(pages: Array<{
+    num: number;
+    text: string;
+}>, question: string, limit?: number): number[];
+/** Preserve the ranked page order when a full extraction supplied the source text. */
+export declare function selectInspectedPdfPages<T extends {
+    num: number;
+}>(pages: T[], selected: number[]): T[];
+export declare function inspectStoredPdf(source: PdfSource, question: string, pageNumbers?: number[], previewUrlForPage?: (pageNumber: number) => string): Promise<{
+    totalPages: number;
+    pages: PdfPageInspection[];
+}>;
+export declare function renderStoredPdfPage(source: PdfSource, pageNumber: number, width?: number): Promise<{
+    data: Buffer;
+    contentType: string;
+}>;
+//# sourceMappingURL=pdf-inspection.d.ts.map

package/dist-types/lib/media/pdf-inspection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-inspection.d.ts","sourceRoot":"","sources":["../../../src/lib/media/pdf-inspection.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,SAAS,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AA4BF,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAU3E;AA0FD,uFAAuF;AACvF,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAC3C,QAAQ,EAAE,MAAM,EAChB,KAAK,SAAY,GAChB,MAAM,EAAE,CAkCV;AAYD,sFAAsF;AACtF,wBAAgB,uBAAuB,CAAC,CAAC,SAAS;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,EAC/D,KAAK,EAAE,CAAC,EAAE,EACV,QAAQ,EAAE,MAAM,EAAE,GACjB,CAAC,EAAE,CAML;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,iBAAiB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,GACjD,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,iBAAiB,EAAE,CAAA;CAAE,CAAC,CAwC7D;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,MAAM,EAClB,KAAK,SAAQ,GACZ,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAoBhD"}

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

@@ -0,0 +1,12 @@
+/** Identity for one remote media source, independent of seek/tracking parameters. */
+export declare function canonicalMediaSourceUrl(value: string): string;
+type EquivalentMediaAsset = {
+    id: string;
+    originalUrl?: string;
+    updatedAt?: string;
+    createdAt?: string;
+};
+/** Resolve duplicate imports of one remote source to the newest indexed asset. */
+export declare function newestEquivalentMediaAsset<T extends EquivalentMediaAsset>(asset: T, assets: readonly T[]): T;
+export {};
+//# sourceMappingURL=source-identity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source-identity.d.ts","sourceRoot":"","sources":["../../../src/lib/media/source-identity.ts"],"names":[],"mappings":"AAGA,qFAAqF;AACrF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAoB7D;AAED,KAAK,oBAAoB,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,kFAAkF;AAClF,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,oBAAoB,EACvE,KAAK,EAAE,CAAC,EACR,MAAM,EAAE,SAAS,CAAC,EAAE,GACnB,CAAC,CAYH"}

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

@@ -0,0 +1,157 @@
+export type RemoteMediaType = 'audio' | 'video' | 'unknown';
+export interface ImportedMedia {
+    path: string;
+    originalUrl: string;
+    title: string;
+    mimeType?: string;
+    mediaType: RemoteMediaType;
+    sourceTranscript?: {
+        chunks: Array<{
+            text: string;
+            startSecs: number;
+            endSecs: number;
+        }>;
+        fullText: string;
+        durationSecs: number;
+        language?: string;
+        origin: {
+            kind: 'youtube-caption';
+            provider: 'youtube';
+            language?: string;
+        };
+    };
+}
+export interface UrlInspection {
+    originalUrl: string;
+    title?: string;
+    mimeType?: string;
+    mediaType: RemoteMediaType;
+    contentLength?: number;
+    durationSecs?: number;
+    singleItemDurationSecs?: number;
+    singleItemUrl?: string;
+    entryCount?: number;
+    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<{
+    bytes: Uint8Array;
+    mimeType?: string;
+    finalUrl: string;
+}>;
+/** Checking a pasted non-YouTube URL must stay interactive, not block on a slow origin. */
+export declare const MEDIA_URL_INSPECTION_TIMEOUT_MS = 7000;
+interface YouTubeInspectionData {
+    title?: string;
+    duration?: number;
+    language?: string;
+    ext?: string;
+    vcodec?: string;
+    acodec?: string;
+    subtitles?: Record<string, unknown>;
+    automatic_captions?: Record<string, unknown>;
+    entries?: Array<{
+        id?: string;
+        url?: string;
+        webpage_url?: string;
+        duration?: number;
+    }>;
+}
+export declare function inspectYouTubeMetadata(url: string, data: YouTubeInspectionData): UrlInspection;
+/**
+ * A public watch URL is enough to stage one video even when an interactive
+ * serverless IP is temporarily challenged by YouTube. The durable worker will
+ * still perform the real download and media probe before indexing, so this
+ * fallback does not claim a title, duration, or byte size it could not verify.
+ */
+export declare function inspectYouTubeWatchUrl(url: string): UrlInspection | undefined;
+export interface MediaProbe {
+    durationSecs: number;
+    containerDurationSecs: number;
+    videoDurationSecs?: number;
+    audioDurationSecs?: number;
+    hasVideo: boolean;
+    hasAudio: boolean;
+    hasCorruptionSignals: boolean;
+}
+export interface MediaImportProgress {
+    percent?: number;
+    current?: number;
+    total?: number;
+    unit?: string;
+    elapsedSeconds?: number;
+    estimatedRemainingSeconds?: number;
+    message: string;
+}
+export declare function createArtifactCacheKey(input: {
+    contentHash: string;
+    operation: string;
+    provider?: string;
+    model?: string;
+    promptVersion?: string;
+    schemaVersion?: string;
+    configuration?: Record<string, string | number | boolean | undefined>;
+}): string;
+export declare function extractRunningState(text: string): string;
+export declare function deriveAudioSignals(chunks: Array<{
+    text: string;
+    startSecs: number;
+    endSecs: number;
+}>, silenceGapSecs?: number): {
+    timestampSecs: number;
+    transcriptChange: number;
+    silenceBoundary: boolean;
+}[];
+/**
+ * The desktop/CLI process does not necessarily inherit a terminal's PATH.
+ * Keep probing self-contained, while allowing managed deployments to override it.
+ */
+export declare function ffprobeExecutable(): string;
+/** Read local media metadata with a bundled ffprobe binary. */
+export declare function probeMedia(mediaPath: string): Promise<MediaProbe>;
+/** Whether a browser-visible container clock is materially longer than its video. */
+export declare function hasInflatedPlaybackTimeline(probe: MediaProbe): boolean;
+export declare function inspectMediaUrl(url: string): Promise<UrlInspection>;
+export declare function importMediaUrl(url: string, options: {
+    outputDir: string;
+    maxBytes?: number;
+    playlistMax?: number;
+    onProgress?: (progress: MediaImportProgress) => void;
+}): Promise<ImportedMedia[]>;
+/**
+ * Serialize the selected downloader fields as one object. Per-field templates
+ * use yt-dlp's bare `NA` placeholder for missing values, which is not JSON.
+ */
+export declare function ytDlpImportPrintTemplate(): string;
+export declare function selectYoutubeCaptionLanguage(data: YouTubeInspectionData): string | undefined;
+interface YoutubeJson3 {
+    events?: Array<{
+        tStartMs?: number;
+        dDurationMs?: number;
+        segs?: Array<{
+            utf8?: string;
+        }>;
+    }>;
+}
+export declare function parseYoutubeJson3Transcript(data: YoutubeJson3): {
+    text: string;
+    startSecs: number;
+    endSecs: number;
+}[];
+/**
+ * Prefer a browser-safe H.264 MP4 video plus M4A audio stream. `best` can
+ * otherwise select an adaptive video-only representation on some YouTube
+ * responses, leaving the browser with a volume control but no audio track.
+ * The combined-format fallbacks keep older and audio-less public videos usable.
+ */
+export declare function youtubeDownloadFormat(): string;
+/**
+ * `after_move:filepath` normally names yt-dlp's final file, but some releases
+ * can print a path that no longer exists after a format merge. The import
+ * directory is newly created for this one download, so a media file bearing the
+ * reported video id is a safe fallback without accepting paths outside it.
+ */
+export declare function resolveYtDlpMediaPath(reportedPath: string, outputDir: string): Promise<string>;
+export declare function parseYtDlpProgress(line: string, elapsedSeconds?: number): MediaImportProgress | null;
+export {};
+//# sourceMappingURL=source-utils.d.ts.map

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

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

package/dist-types/lib/media/video/quick-look.d.ts

@@ -0,0 +1,60 @@
+export interface QuickLookRange {
+    startSecs: number;
+    endSecs: number;
+    /** What this particular window is expected to settle. */
+    lookingFor?: string;
+}
+export interface QuickLookFinding {
+    range: {
+        startSecs: number;
+        endSecs: number;
+    };
+    at: string;
+    /** What the re-watch established, in the reader's own words. */
+    found: string;
+    /** Whether this bounded reading actually answers the question, not merely relates to it. */
+    settlesQuestion: boolean;
+    /** For requests about every visible subject, whether each one was individually covered. */
+    coverageComplete?: boolean;
+    /** Exact short strings actually read off the frames. */
+    read: string[];
+    confidence: 'high' | 'medium' | 'low';
+    frameCount: number;
+    elapsedMs: number;
+    error?: string;
+}
+export declare function parseFinding(raw: string): {
+    found?: string;
+    read?: unknown;
+    confidence?: unknown;
+    settlesQuestion?: unknown;
+    coverageComplete?: unknown;
+};
+/**
+ * Re-watches each range and returns what it established. Ranges are independent,
+ * so they run together: a question needing three separate moments checked costs
+ * about the same wall time as one.
+ */
+export declare function quickLook(input: {
+    mediaPath: string;
+    question: string;
+    ranges: QuickLookRange[];
+    /** Speech aligned to each range, when the caller already holds it. */
+    transcriptFor?: (range: QuickLookRange) => string | undefined;
+    signal?: AbortSignal;
+}): Promise<QuickLookFinding[]>;
+/** True when a re-watch produced something an answer can actually rest on. */
+export declare function isUsableFinding(finding: QuickLookFinding): boolean;
+/**
+ * What ffmpeg should open for this asset.
+ *
+ * A presigned URL is preferred over downloading: with `-ss` ahead of `-i`,
+ * ffmpeg range-requests only the bytes around the window, so re-watching thirty
+ * seconds of a long recording never transfers the whole file. Falling back to a
+ * full retrieve keeps assets on storage backends without presigning usable.
+ */
+export declare function resolveQuickLookSource(storageUri: string, fileName: string): Promise<{
+    mediaPath: string;
+    cleanup: () => Promise<void>;
+}>;
+//# sourceMappingURL=quick-look.d.ts.map

package/dist-types/lib/media/video/quick-look.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-look.d.ts","sourceRoot":"","sources":["../../../../src/lib/media/video/quick-look.ts"],"names":[],"mappings":"AAyCA,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,4FAA4F;IAC5F,eAAe,EAAE,OAAO,CAAC;IACzB,2FAA2F;IAC3F,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,wDAAwD;IACxD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAwED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAyBA;AA+HD;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,sEAAsE;IACtE,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,MAAM,GAAG,SAAS,CAAC;IAC9D,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAyB9B;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAOlE;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CAc9D"}