@nocobase/app-plugin-agents 1.0.0-beta.20 → 1.0.0-beta.22

package/dist/server/online/agent/types.d.ts

@@ -1,3 +1,4 @@
+import type { WebSearchBudget } from '../search/budget.js';
 import type { OnlineAgentSandbox } from '../sandbox/types.js';
 import type { Tool, ModelMessage, UIMessage, UIMessageChunk } from 'ai';
 import type { AuthorizationContext } from '@nocobase/authorization/core';
@@ -31,6 +32,8 @@ export type OnlineAgentToolContext = OnlineAgentContext & {
     /** The executing session, supplied by the runtime rather than model or page input. */
     readonly sessionId: string;
     readonly signal: AbortSignal;
+    readonly selectedModel?: Readonly<ModelRef>;
+    readonly webSearchBudget?: WebSearchBudget;
     readonly execution: OnlineAgentToolExecution;
 };
 export type OnlineAgentScope = {
@@ -47,6 +50,7 @@ export type OnlineAgentScope = {
     skill?: string[];
     model?: string[];
     thinking?: string;
+    webSearch?: boolean;
     permissions?: never;
 };
 export type OnlineAgentScopeProvider = (context: OnlineAgentContext) => OnlineAgentScope | Promise<OnlineAgentScope>;
@@ -64,6 +68,7 @@ export type OnlineAgentConfig = {
     /** Missing and empty lists are unrestricted; preserve their distinct shapes. */
     model?: string[];
     thinking?: string;
+    webSearch?: boolean;
 };
 export type OnlineAgentToolDefinition<I, O extends OnlineAgentJson, C = OnlineAgentToolContext> = Tool<I, O, C> & {
     execute: NonNullable<Tool<I, O, C>['execute']>;

package/dist/server/online/agent/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../server/online/agent/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../server/online/agent/types.ts"],"names":[],"mappings":"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"}

package/dist/server/online/agent/web-search.d.ts

@@ -0,0 +1,13 @@
+import type { ModelCapabilities, ModelRef } from '../../../shared/models.js';
+import type { WebSearchResult } from '../../../shared/web-search.js';
+import type { WebSearchRequest } from '../gateway.js';
+import type { OnlineAgentConfigurator } from './configuration.js';
+import type { OnlineAgentConfig } from './types.js';
+export interface OnlineAgentWebSearch {
+    capabilities(model: ModelRef): Promise<ModelCapabilities>;
+    search(request: WebSearchRequest): Promise<WebSearchResult>;
+}
+/** Validate before admission; an inherited preference may be cleared only during an explicit model switch. */
+export declare function validateWebSearch(config: OnlineAgentConfig, model: ModelRef, dependency: OnlineAgentWebSearch | undefined, clearInherited?: boolean): Promise<void>;
+export declare function registerWebSearchTool(configurator: OnlineAgentConfigurator, dependency: OnlineAgentWebSearch | undefined): void;
+//# sourceMappingURL=web-search.d.ts.map

package/dist/server/online/agent/web-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.d.ts","sourceRoot":"","sources":["../../../../server/online/agent/web-search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGtD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC1D,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC7D;AAED,8GAA8G;AAC9G,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,QAAQ,EACf,UAAU,EAAE,oBAAoB,GAAG,SAAS,EAC5C,cAAc,GAAE,OAAe,GAC9B,OAAO,CAAC,IAAI,CAAC,CAYf;AAMD,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,uBAAuB,EACrC,UAAU,EAAE,oBAAoB,GAAG,SAAS,GAC3C,IAAI,CA+CN"}

package/dist/server/online/agent/web-search.js

@@ -0,0 +1,65 @@
+import { WEB_SEARCH_TOOL_DESCRIPTION } from '../search/prompts.js';
+import { WEB_SEARCH_TOOL } from '../../../shared/web-search.js';
+import { publicSearchResult, WebSearchInputSchema } from '../search/results.js';
+import { invalid } from '../../kernel/errors.js';
+/** Validate before admission; an inherited preference may be cleared only during an explicit model switch. */
+export async function validateWebSearch(config, model, dependency, clearInherited = false) {
+    if (!config.webSearch)
+        return;
+    if (!dependency)
+        throw invalid('Native web search is unavailable.');
+    if ((await dependency.capabilities(model)).webSearch)
+        return;
+    if (clearInherited) {
+        config.webSearch = false;
+        delete config.toolVersions[WEB_SEARCH_TOOL];
+        return;
+    }
+    throw invalid('Web search is unavailable for the selected model. Refresh model configuration.');
+}
+const registrations = new WeakMap();
+export function registerWebSearchTool(configurator, dependency) {
+    if (registrations.has(configurator)) {
+        if (dependency !== undefined &&
+            dependency !== registrations.get(configurator))
+            throw invalid('This configurator already owns a different web search dependency.');
+        return;
+    }
+    configurator.registerTool(WEB_SEARCH_TOOL, {
+        version: '1',
+        definition: {
+            description: WEB_SEARCH_TOOL_DESCRIPTION,
+            inputSchema: WebSearchInputSchema,
+            public: {
+                input: (input) => WebSearchInputSchema.parse(input),
+                output: (output) => publicSearchResult(output),
+            },
+            toModelOutput: ({ output }) => ({
+                type: 'text',
+                value: `Untrusted search output (unverified results do not establish search execution, freshness or sources):\n${JSON.stringify(publicSearchResult(output))}`,
+            }),
+            execute: async (input, { context, abortSignal, toolCallId }) => {
+                context.signal.throwIfAborted();
+                if (!dependency || !context.selectedModel || !context.webSearchBudget)
+                    throw invalid('Native web search is unavailable.');
+                const signal = abortSignal
+                    ? AbortSignal.any([context.signal, abortSignal])
+                    : context.signal;
+                signal.throwIfAborted();
+                context.webSearchBudget.reserve(toolCallId, input.queries);
+                const result = await dependency.search({
+                    model: context.selectedModel,
+                    queries: input.queries,
+                    sessionId: context.sessionId,
+                    signal,
+                    budget: context.webSearchBudget,
+                    source: 'agents.webSearch',
+                });
+                signal.throwIfAborted();
+                return publicSearchResult(result);
+            },
+        },
+    });
+    registrations.set(configurator, dependency);
+}
+//# sourceMappingURL=web-search.js.map

package/dist/server/online/agent/web-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.js","sourceRoot":"","sources":["../../../../server/online/agent/web-search.ts"],"names":[],"mappings":"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"}

package/dist/server/online/files/cache.d.ts

@@ -0,0 +1,19 @@
+/** Completed local results only; neither permissions nor in-flight executions are shared. */
+export declare class ExtractedDocumentCache {
+    private readonly entries;
+    private bytes;
+    private readonly ttlMs;
+    private readonly maxEntries;
+    private readonly maxBytes;
+    private readonly now;
+    constructor(options?: {
+        ttlMs?: number;
+        maxEntries?: number;
+        maxBytes?: number;
+        now?: () => number;
+    });
+    get(key: string): string | undefined;
+    set(key: string, text: string): void;
+    private remove;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/server/online/files/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../../server/online/files/cache.ts"],"names":[],"mappings":"AAMA,6FAA6F;AAC7F,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAGjC,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;KACf;IAaR,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAYpC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAgBpC,OAAO,CAAC,MAAM;CAKf"}

package/dist/server/online/files/cache.js

@@ -0,0 +1,52 @@
+/** Completed local results only; neither permissions nor in-flight executions are shared. */
+export class ExtractedDocumentCache {
+    entries = new Map();
+    bytes = 0;
+    ttlMs;
+    maxEntries;
+    maxBytes;
+    now;
+    constructor(options = {}) {
+        this.ttlMs = options.ttlMs ?? 30 * 60_000;
+        this.maxEntries = options.maxEntries ?? 128;
+        this.maxBytes = options.maxBytes ?? 32 * 1024 * 1024;
+        this.now = options.now ?? Date.now;
+        for (const value of [this.ttlMs, this.maxEntries, this.maxBytes])
+            if (!Number.isSafeInteger(value) || value < 0)
+                throw new RangeError('Cache limits must be non-negative safe integers.');
+    }
+    get(key) {
+        const entry = this.entries.get(key);
+        if (!entry)
+            return undefined;
+        if (entry.expiresAt <= this.now()) {
+            this.remove(key);
+            return undefined;
+        }
+        this.entries.delete(key);
+        this.entries.set(key, entry);
+        return entry.text;
+    }
+    set(key, text) {
+        this.remove(key);
+        const bytes = Buffer.byteLength(text);
+        if (!this.ttlMs || !this.maxEntries || bytes > this.maxBytes)
+            return;
+        const now = this.now();
+        for (const [id, entry] of this.entries)
+            if (entry.expiresAt <= now)
+                this.remove(id);
+        while (this.entries.size >= this.maxEntries ||
+            this.bytes + bytes > this.maxBytes)
+            this.remove(this.entries.keys().next().value);
+        this.entries.set(key, { text, bytes, expiresAt: now + this.ttlMs });
+        this.bytes += bytes;
+    }
+    remove(key) {
+        const entry = this.entries.get(key);
+        if (entry)
+            this.bytes -= entry.bytes;
+        this.entries.delete(key);
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/server/online/files/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../../server/online/files/cache.ts"],"names":[],"mappings":"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"}

package/dist/server/online/files/errors.d.ts

@@ -0,0 +1,8 @@
+import { ProtocolError } from '../../kernel/errors.js';
+import { type FileInputFailureReason } from '../../../shared/file-input-failures.js';
+/** A controlled preparation failure, distinct from arbitrary extractor or Provider errors. */
+export declare class FileInputError extends ProtocolError {
+    readonly fileInputReason: FileInputFailureReason;
+    constructor(reason: FileInputFailureReason);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/server/online/files/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../server/online/files/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,wCAAwC,CAAC;AAEhD,8FAA8F;AAC9F,qBAAa,cAAe,SAAQ,aAAa;IAC/C,QAAQ,CAAC,eAAe,EAAE,sBAAsB,CAAC;gBACrC,MAAM,EAAE,sBAAsB;CAO3C"}

package/dist/server/online/files/errors.js

@@ -0,0 +1,14 @@
+import { ProtocolError } from '../../kernel/errors.js';
+import { fileInputFailureTitles, isFileInputFailureReason, } from '../../../shared/file-input-failures.js';
+/** A controlled preparation failure, distinct from arbitrary extractor or Provider errors. */
+export class FileInputError extends ProtocolError {
+    fileInputReason;
+    constructor(reason) {
+        const safe = isFileInputFailureReason(reason)
+            ? reason
+            : 'preparationFailed';
+        super('INVALID_REQUEST', fileInputFailureTitles[safe]);
+        this.fileInputReason = safe;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/server/online/files/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../server/online/files/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EACL,sBAAsB,EACtB,wBAAwB,GAEzB,MAAM,wCAAwC,CAAC;AAEhD,8FAA8F;AAC9F,MAAM,OAAO,cAAe,SAAQ,aAAa;IACtC,eAAe,CAAyB;IACjD,YAAY,MAA8B;QACxC,MAAM,IAAI,GAAG,wBAAwB,CAAC,MAAM,CAAC;YAC3C,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,mBAAmB,CAAC;QACxB,KAAK,CAAC,iBAAiB,EAAE,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC;QACvD,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;IAC9B,CAAC;CACF"}

package/dist/server/online/files/input.d.ts

@@ -0,0 +1,23 @@
+export declare function characters(text: string): number;
+export declare function localExtension(filename: string, mediaType: string, storedExt?: string): string;
+export declare function inlineBytes(url: string, mediaType: string): Uint8Array;
+export declare class ByteLimitError extends Error {
+}
+export declare function readBytes(body: ReadableStream<Uint8Array>, signal: AbortSignal): Promise<Uint8Array>;
+/** One bounded reader for authorized files and Provider responses, sharing the original cancellation. */
+export declare function readBoundedBytes(body: ReadableStream<Uint8Array>, signal: AbortSignal, maxBytes: number): Promise<Uint8Array>;
+/** Every occurrence counts as context, but repeated copies of one source count bytes once. */
+export declare class FileInputBudget {
+    private readonly maxNativeFiles;
+    static readonly maxOutputChars: number;
+    private readonly sources;
+    private bytes;
+    private textChars;
+    private nativeFiles;
+    constructor(fileCount: number, maxNativeFiles: number);
+    native(): void;
+    source(key: string, bytes: number): void;
+    document(text: string): void;
+    context(text: string): void;
+}
+//# sourceMappingURL=input.d.ts.map

package/dist/server/online/files/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../../server/online/files/input.ts"],"names":[],"mappings":"AAoBA,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI/C;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAmBR;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,CAgBtE;AAED,qBAAa,cAAe,SAAQ,KAAK;CAAG;AAE5C,wBAAsB,SAAS,CAC7B,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAChC,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,UAAU,CAAC,CAQrB;AACD,yGAAyG;AACzG,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAChC,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,CAAC,CA4BrB;AAED,8FAA8F;AAC9F,qBAAa,eAAe;IASxB,OAAO,CAAC,QAAQ,CAAC,cAAc;IARjC,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAW;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,WAAW,CAAK;gBAGtB,SAAS,EAAE,MAAM,EACA,cAAc,EAAE,MAAM;IAKzC,MAAM,IAAI,IAAI;IAKd,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IASxC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK5B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAI5B"}

package/dist/server/online/files/input.js

@@ -0,0 +1,129 @@
+import { FileInputError } from './errors.js';
+import { isParsed } from '@nocobase/document-extractor';
+import { CHAT_ATTACHMENT_SIZE_MAX } from '../../../shared/conversations.js';
+const mimeExtensions = {
+    'application/pdf': 'pdf',
+    'application/msword': 'doc',
+    'application/vnd.openxmlformats-officedocument.wordprocessingml.document': 'docx',
+    'application/vnd.ms-excel': 'xls',
+    'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet': 'xlsx',
+    'application/vnd.ms-excel.sheet.macroenabled.12': 'xlsm',
+    'application/vnd.openxmlformats-officedocument.presentationml.presentation': 'pptx',
+    'text/plain': 'txt',
+    'text/markdown': 'md',
+    'text/csv': 'csv',
+    'application/json': 'json',
+};
+export function characters(text) {
+    let count = 0;
+    for (const _ of text)
+        count += 1;
+    return count;
+}
+export function localExtension(filename, mediaType, storedExt) {
+    const named = filename.includes('.')
+        ? filename.split('.').at(-1).toLowerCase()
+        : undefined;
+    const mime = mimeExtensions[mediaType];
+    const ext = storedExt?.toLowerCase() || named || mime;
+    if (!ext ||
+        !isParsed(ext) ||
+        (!mime && mediaType !== 'application/octet-stream'))
+        throw new FileInputError(mediaType.startsWith('image/') ? 'imageCapability' : 'unsupportedFormat');
+    const plainTextAlias = mime === 'txt' && ['txt', 'md', 'json', 'csv'].includes(ext);
+    if (mime && mime !== ext && !plainTextAlias)
+        throw new FileInputError('formatMismatch');
+    return ext;
+}
+export function inlineBytes(url, mediaType) {
+    const match = /^data:([^;,]+);base64,([A-Za-z0-9+/]*={0,2})$/u.exec(url);
+    if (!match ||
+        match[1] !== mediaType ||
+        match[2].length > Math.ceil(CHAT_ATTACHMENT_SIZE_MAX / 3) * 4)
+        throw new FileInputError('invalidInline');
+    const bytes = Buffer.from(match[2], 'base64');
+    if (bytes.byteLength > CHAT_ATTACHMENT_SIZE_MAX ||
+        bytes.toString('base64').replace(/=+$/u, '') !==
+            match[2].replace(/=+$/u, ''))
+        throw new FileInputError('invalidInline');
+    return bytes;
+}
+export class ByteLimitError extends Error {
+}
+export async function readBytes(body, signal) {
+    try {
+        return await readBoundedBytes(body, signal, CHAT_ATTACHMENT_SIZE_MAX);
+    }
+    catch (error) {
+        if (error instanceof ByteLimitError)
+            throw new FileInputError('fileTooLarge');
+        throw error;
+    }
+}
+/** One bounded reader for authorized files and Provider responses, sharing the original cancellation. */
+export async function readBoundedBytes(body, signal, maxBytes) {
+    const reader = body.getReader();
+    let cancellation;
+    const cancel = () => (cancellation ??= reader.cancel().catch(() => undefined));
+    const abort = () => {
+        void cancel();
+    };
+    signal.addEventListener('abort', abort, { once: true });
+    const chunks = [];
+    let size = 0;
+    try {
+        signal.throwIfAborted();
+        while (true) {
+            const { done, value } = await reader.read();
+            signal.throwIfAborted();
+            if (done)
+                break;
+            size += value.byteLength;
+            if (size > maxBytes)
+                throw new ByteLimitError('The input exceeds its byte budget.');
+            chunks.push(value);
+        }
+        return Buffer.concat(chunks, size);
+    }
+    finally {
+        await cancel();
+        reader.releaseLock();
+        signal.removeEventListener('abort', abort);
+    }
+}
+/** Every occurrence counts as context, but repeated copies of one source count bytes once. */
+export class FileInputBudget {
+    maxNativeFiles;
+    static maxOutputChars = 100_000;
+    sources = new Set();
+    bytes = 0;
+    textChars = 0;
+    nativeFiles = 0;
+    constructor(fileCount, maxNativeFiles) {
+        this.maxNativeFiles = maxNativeFiles;
+        if (fileCount > 100)
+            throw new FileInputError('fileCount');
+    }
+    native() {
+        if (++this.nativeFiles > this.maxNativeFiles)
+            throw new FileInputError('nativeFileCount');
+    }
+    source(key, bytes) {
+        if (!this.sources.has(key)) {
+            this.sources.add(key);
+            this.bytes += bytes;
+        }
+        if (this.bytes > 64 * 1024 * 1024)
+            throw new FileInputError('inputTooLarge');
+    }
+    document(text) {
+        if (characters(text) > FileInputBudget.maxOutputChars)
+            throw new FileInputError('documentTooLarge');
+    }
+    context(text) {
+        this.textChars += characters(text);
+        if (this.textChars > 200_000)
+            throw new FileInputError('contextTooLarge');
+    }
+}
+//# sourceMappingURL=input.js.map

package/dist/server/online/files/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../../../server/online/files/input.ts"],"names":[],"mappings":"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"}

package/dist/server/online/files/kimi.d.ts

@@ -0,0 +1,11 @@
+import type { TextExtractor } from '@nocobase/document-extractor';
+import { type ModelConnection } from '../providers.js';
+interface KimiOptions {
+    readonly timeoutMs?: number;
+    readonly cleanupTimeoutMs?: number;
+    readonly onWarning?: (message: string) => void;
+}
+/** Credentials and endpoint remain in this private execution-bound closure, never in messages or cache keys. */
+export declare function kimiExtractor(connection: ModelConnection, sessionId: string, options?: KimiOptions): TextExtractor;
+export {};
+//# sourceMappingURL=kimi.d.ts.map

package/dist/server/online/files/kimi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kimi.d.ts","sourceRoot":"","sources":["../../../../server/online/files/kimi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,aAAa,EACd,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,iBAAiB,CAAC;AAQzB,UAAU,WAAW;IACnB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAChD;AAoOD,gHAAgH;AAChH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,eAAe,EAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,WAAgB,GACxB,aAAa,CAIf"}

package/dist/server/online/files/kimi.js

@@ -0,0 +1,177 @@
+import { CHAT_ATTACHMENT_SIZE_MAX } from '../../../shared/conversations.js';
+import { baseUrlOf, headersOf, modelFetch, } from '../providers.js';
+import { ByteLimitError, characters, FileInputBudget, readBoundedBytes, } from './input.js';
+/** A single connection-bound protocol adapter, with no retries or cross-execution results. */
+class KimiExtractor {
+    filesUrl;
+    headers;
+    timeoutMs;
+    cleanupTimeoutMs;
+    warn;
+    constructor(connection, sessionId, options) {
+        const base = baseUrlOf(connection);
+        if (!base || !connection.apiKey)
+            throw new Error('Kimi file extraction requires a valid service endpoint and explicit API key.');
+        const url = new URL(base);
+        if (!['https:', 'http:'].includes(url.protocol) ||
+            url.username ||
+            url.password ||
+            url.search ||
+            url.hash)
+            throw new Error('Invalid Kimi file extraction service endpoint.');
+        this.filesUrl = `${base.replace(/\/+$/u, '')}/files`;
+        this.headers = new Headers({
+            ...headersOf(connection, sessionId),
+            Authorization: `Bearer ${connection.apiKey}`,
+        });
+        this.timeoutMs = options.timeoutMs ?? 300_000;
+        this.cleanupTimeoutMs = options.cleanupTimeoutMs ?? 5_000;
+        if (!Number.isSafeInteger(this.timeoutMs) ||
+            this.timeoutMs < 1 ||
+            this.timeoutMs > 300_000 ||
+            !Number.isSafeInteger(this.cleanupTimeoutMs) ||
+            this.cleanupTimeoutMs < 1 ||
+            this.cleanupTimeoutMs > 5_000)
+            throw new RangeError('Invalid Kimi extraction deadline.');
+        this.warn = options.onWarning ?? ((message) => console.warn(message));
+    }
+    async extract(request, options = {}) {
+        const deadline = AbortSignal.timeout(this.timeoutMs);
+        const signal = options.signal
+            ? AbortSignal.any([options.signal, deadline])
+            : deadline;
+        const maxChars = options.maxOutputChars ?? FileInputBudget.maxOutputChars;
+        let id;
+        let attempted = false;
+        let result;
+        try {
+            signal.throwIfAborted();
+            if (request.bytes.byteLength > CHAT_ATTACHMENT_SIZE_MAX)
+                throw new ByteLimitError();
+            if (!Number.isSafeInteger(maxChars) ||
+                maxChars < 0 ||
+                maxChars > FileInputBudget.maxOutputChars)
+                throw new ByteLimitError();
+            attempted = true;
+            id = await this.upload(request, signal);
+            const markdown = await this.content(id, signal, maxChars);
+            signal.throwIfAborted();
+            result = { status: 'ready', markdown, hasText: Boolean(markdown.trim()) };
+        }
+        catch (error) {
+            const code = options.signal?.aborted
+                ? 'aborted'
+                : deadline.aborted
+                    ? 'timeout'
+                    : error instanceof ByteLimitError
+                        ? 'too-large'
+                        : 'invalid-document';
+            result = {
+                status: 'failed',
+                code,
+                error: 'Remote file extraction failed.',
+            };
+        }
+        finally {
+            if (id)
+                await this.cleanup(id);
+            else if (attempted)
+                this.warning('Remote file cleanup could not be confirmed: no usable file identifier was received.');
+        }
+        return options.signal?.aborted
+            ? {
+                status: 'failed',
+                code: 'aborted',
+                error: 'File extraction was cancelled.',
+            }
+            : result;
+    }
+    async upload(request, signal) {
+        const form = new FormData();
+        form.set('purpose', 'file-extract');
+        form.set('file', new Blob([new Uint8Array(request.bytes)], {
+            type: request.mediaType ?? 'application/octet-stream',
+        }), request.filename ?? `document.${request.ext}`);
+        const response = await this.request('POST', this.filesUrl, signal, form);
+        const metadata = JSON.parse(await this.text(response, signal, 64 * 1024));
+        if (typeof metadata !== 'object' ||
+            metadata === null ||
+            !('id' in metadata) ||
+            typeof metadata.id !== 'string' ||
+            !/^[a-zA-Z0-9_-]{1,256}$/u.test(metadata.id))
+            throw new Error('Invalid remote file identifier.');
+        return metadata.id;
+    }
+    async content(id, signal, maxChars) {
+        const response = await this.request('GET', `${this.filesUrl}/${encodeURIComponent(id)}/content`, signal);
+        const mediaType = response.headers
+            .get('content-type')
+            ?.split(';')[0]
+            ?.trim()
+            .toLowerCase();
+        if (mediaType !== 'text/plain' && mediaType !== 'application/json') {
+            await response.body?.cancel();
+            throw new Error('Unsupported remote extraction response.');
+        }
+        const text = await this.text(response, signal, maxChars * (mediaType === 'application/json' ? 12 : 4) + 64 * 1024);
+        let markdown;
+        if (mediaType === 'text/plain')
+            markdown = text;
+        else {
+            const content = JSON.parse(text);
+            if (typeof content !== 'object' ||
+                content === null ||
+                !('content' in content) ||
+                typeof content.content !== 'string')
+                throw new Error('Unsupported remote extraction response.');
+            markdown = content.content;
+        }
+        signal.throwIfAborted();
+        if (characters(markdown) > maxChars)
+            throw new ByteLimitError();
+        return markdown;
+    }
+    async request(method, url, signal, body) {
+        const response = await modelFetch(url, {
+            method,
+            headers: this.headers,
+            signal,
+            body,
+            redirect: 'error',
+        });
+        if (!response.ok) {
+            await response.body?.cancel();
+            throw new Error('Remote file request failed.');
+        }
+        return response;
+    }
+    async text(response, signal, maxBytes) {
+        if (!response.body)
+            throw new Error('Missing remote file response.');
+        const bytes = await readBoundedBytes(response.body, signal, maxBytes);
+        return new TextDecoder('utf-8', { fatal: true }).decode(bytes);
+    }
+    async cleanup(id) {
+        try {
+            const response = await this.request('DELETE', `${this.filesUrl}/${encodeURIComponent(id)}`, AbortSignal.timeout(this.cleanupTimeoutMs));
+            await response.body?.cancel();
+        }
+        catch {
+            this.warning('Remote file cleanup failed; a temporary file may remain at the configured service.');
+        }
+    }
+    warning(message) {
+        try {
+            this.warn(message);
+        }
+        catch {
+            /* Diagnostics must not replace the extraction outcome. */
+        }
+    }
+}
+/** Credentials and endpoint remain in this private execution-bound closure, never in messages or cache keys. */
+export function kimiExtractor(connection, sessionId, options = {}) {
+    const extractor = new KimiExtractor(connection, sessionId, options);
+    return (request, extractOptions) => extractor.extract(request, extractOptions);
+}
+//# sourceMappingURL=kimi.js.map