@nocobase/app-plugin-agents 0.1.0-beta.9 → 1.0.0-beta.16

package/dist/server/online/agent/configuration.js

@@ -0,0 +1,261 @@
+import { invalid } from '../../kernel/errors.js';
+import { jsonSafe, strictJson } from './messages/json.js';
+/** Detect SDK result protocols without accidentally executing an accessor on a raw result. */
+function resultMethod(value, key) {
+    if (value === null ||
+        (typeof value !== 'object' && typeof value !== 'function'))
+        return false;
+    let current = value;
+    while (current) {
+        const descriptor = Object.getOwnPropertyDescriptor(current, key);
+        if (descriptor) {
+            if (!('value' in descriptor))
+                throw invalid('Tool result protocols cannot use accessors.');
+            return typeof descriptor.value === 'function';
+        }
+        current = Object.getPrototypeOf(current);
+    }
+    return false;
+}
+function supported(value) {
+    if ('skill' in value && Array.isArray(value.skill) && value.skill.length)
+        throw invalid('Skills are not supported.');
+    if ('permissions' in value || 'toolApproval' in value)
+        throw invalid('Permission overrides and custom approval protocols are not supported.');
+}
+export class OnlineAgentConfigurator {
+    globals = [];
+    scopes = new Map();
+    tools = new Map();
+    registerOnlineAgentGlobalScope(...scope) {
+        scope.forEach((item) => {
+            if (typeof item !== 'function')
+                supported(item);
+        });
+        this.globals.push(...scope);
+    }
+    registerOnlineAgentScope(name, ...scope) {
+        if (this.scopes.has(name))
+            throw invalid(`Scope ${name} is already registered.`);
+        scope.forEach((item) => {
+            if (typeof item !== 'function')
+                supported(item);
+        });
+        this.scopes.set(name, scope);
+    }
+    registerTool(name, options) {
+        if (!/^[a-zA-Z0-9_-]{1,64}$/u.test(name) ||
+            !options.version ||
+            this.tools.has(name))
+            throw invalid(`Invalid or duplicate tool ${name}.`);
+        if (typeof options.definition !== 'function')
+            supported(options.definition);
+        if (typeof options.definition !== 'function' &&
+            options.definition.needsApproval !== undefined &&
+            options.definition.needsApproval !== false &&
+            !options.definition.public)
+            throw invalid(`Approval tool ${name} needs explicit public projections.`);
+        let resolved;
+        this.tools.set(name, {
+            version: options.version,
+            resolve: (resolver) => {
+                if (!resolved) {
+                    if (typeof options.definition === 'function' && !resolver)
+                        throw invalid('A tool factory requires the application service resolver.');
+                    const definition = typeof options.definition === 'function'
+                        ? options.definition(resolver)
+                        : options.definition;
+                    supported(definition);
+                    if (definition.needsApproval !== undefined &&
+                        definition.needsApproval !== false &&
+                        !definition.public)
+                        throw invalid(`Approval tool ${name} needs explicit public projections.`);
+                    if (typeof definition.execute !== 'function')
+                        throw invalid(`Tool ${name} needs an execute function.`);
+                    resolved = definition;
+                    Object.freeze(resolved);
+                }
+                return resolved;
+            },
+        });
+    }
+    async resolve(context, options, previous, fallbackModels = [], http = false) {
+        return (await this.resolveSelection(context, options, previous, fallbackModels, http)).config;
+    }
+    async resolveSelection(context, options, previous, fallbackModels = [], http = false) {
+        let hasModel = previous !== undefined;
+        supported(options);
+        if (http &&
+            (options.tool !== undefined ||
+                options.model !== undefined ||
+                options.systemPromptTemplate !== undefined ||
+                options.context?.systemPrompt !== undefined))
+            throw invalid('HTTP configuration cannot override tools, models or system prompts.');
+        const supplied = http ? options.context?.variable : undefined;
+        if (supplied !== undefined &&
+            (!supplied || typeof supplied !== 'object' || Array.isArray(supplied)))
+            throw invalid('Business variables must be an object declared by a selected scope.');
+        const declared = new Set();
+        let validated = false;
+        const result = previous
+            ? structuredClone(previous)
+            : {
+                scope: [],
+                systemPrompt: '',
+                tool: [],
+                toolVersions: {},
+                model: [...fallbackModels],
+            };
+        const layers = previous
+            ? []
+            : this.globals.map((value) => ({ value, selected: false }));
+        // Only explicit HTTP variable changes revisit the selected scope declarations.
+        for (const name of options.scope ??
+            (supplied !== undefined ? previous?.scope : undefined) ??
+            []) {
+            const found = this.scopes.get(name);
+            if (!found)
+                throw invalid(`Scope ${name} is not registered.`);
+            layers.push(...found.map((value) => ({ value, selected: true })));
+        }
+        layers.push({ value: options, selected: false });
+        for (const { value: layer, selected } of layers) {
+            const current = {
+                ...context,
+                variable: result.variable,
+                systemPrompt: result.systemPrompt,
+            };
+            const scope = typeof layer === 'function' ? await layer(current) : layer;
+            supported(scope);
+            if (scope.context?.variable !== undefined && !(http && layer === options))
+                result.variable = jsonSafe(scope.context.variable);
+            if (scope.context?.systemPrompt !== undefined)
+                result.systemPrompt = scope.context.systemPrompt;
+            const template = scope.systemPromptTemplate;
+            if (typeof template === 'string')
+                result.systemPrompt = template;
+            else if (template) {
+                if (template.variableSchema) {
+                    const existing = result.variable &&
+                        typeof result.variable === 'object' &&
+                        !Array.isArray(result.variable)
+                        ? result.variable
+                        : {};
+                    let candidate = result.variable;
+                    if (supplied !== undefined && selected) {
+                        validated = true;
+                        candidate = Object.fromEntries(Object.keys(template.variableSchema.shape).flatMap((key) => {
+                            declared.add(key);
+                            if (Object.hasOwn(supplied, key))
+                                return [[key, supplied[key]]];
+                            return Object.hasOwn(existing, key)
+                                ? [[key, existing[key]]]
+                                : [];
+                        }));
+                    }
+                    const parsed = template.variableSchema.safeParse(candidate);
+                    if (!parsed.success) {
+                        if (http)
+                            throw invalid('Business variables do not match the selected scope schema.');
+                        throw parsed.error;
+                    }
+                    result.variable = jsonSafe(supplied !== undefined && selected
+                        ? { ...existing, ...parsed.data }
+                        : parsed.data);
+                }
+                result.systemPrompt = template.template({
+                    ...context,
+                    variable: result.variable,
+                    systemPrompt: result.systemPrompt,
+                });
+            }
+            if (scope.agentId !== undefined) {
+                if (typeof scope.agentId !== 'string' || !scope.agentId.trim())
+                    throw invalid('Select a valid agentId.');
+                result.agentId = scope.agentId;
+            }
+            if (scope.tool !== undefined)
+                result.tool = [...scope.tool];
+            if (scope.model !== undefined) {
+                result.model = [...scope.model];
+                hasModel = true;
+            }
+            if (scope.thinking !== undefined)
+                result.thinking = scope.thinking;
+        }
+        if (supplied !== undefined &&
+            (!validated || Object.keys(supplied).some((key) => !declared.has(key))))
+            throw invalid('Business variables must be declared by the selected scopes.');
+        if (options.scope !== undefined)
+            result.scope = [...options.scope];
+        result.toolVersions = Object.fromEntries(result.tool.map((name) => {
+            const registered = this.tools.get(name);
+            if (!registered)
+                throw invalid(`Tool ${name} is not registered.`);
+            return [name, registered.version];
+        }));
+        jsonSafe(result);
+        return { config: result, hasModel };
+    }
+    bind(config, context, resolver, track = () => { }) {
+        return Object.fromEntries(config.tool.map((name) => {
+            const registered = this.tools.get(name);
+            if (!registered || registered.version !== config.toolVersions[name])
+                throw invalid(`Tool ${name} has changed or is unavailable.`);
+            const definition = registered.resolve(resolver);
+            const execute = definition.execute;
+            const { public: _public, ...sdkDefinition } = definition;
+            const bound = {
+                ...sdkDefinition,
+                ...(definition.toModelOutput
+                    ? {
+                        toModelOutput: (options) => definition.toModelOutput({
+                            ...options,
+                            input: structuredClone(options.input),
+                            output: strictJson(options.output),
+                        }),
+                    }
+                    : {}),
+                execute: (input, options) => {
+                    context.signal.throwIfAborted();
+                    const result = execute(input, options);
+                    if (resultMethod(result, Symbol.asyncIterator)) {
+                        const iterable = result;
+                        let done;
+                        track(new Promise((resolve) => {
+                            done = resolve;
+                        }));
+                        return (async function* () {
+                            let yielded = false;
+                            try {
+                                for await (const value of iterable) {
+                                    yield strictJson(resultMethod(value, 'then') ? await value : value);
+                                    yielded = true;
+                                }
+                                if (!yielded)
+                                    throw invalid('A tool result stream must yield a JSON value.');
+                            }
+                            finally {
+                                done();
+                            }
+                        })();
+                    }
+                    // Validate synchronous values before any caller can mutate them; await only SDK promises.
+                    const task = resultMethod(result, 'then')
+                        ? Promise.resolve(result).then(strictJson)
+                        : Promise.resolve(strictJson(result));
+                    track(task);
+                    return task;
+                },
+            };
+            return [name, bound];
+        }));
+    }
+    toolDefinition(name, resolver) {
+        return this.tools.get(name)?.resolve(resolver);
+    }
+    publicProjection(name, resolver) {
+        return this.tools.get(name)?.resolve(resolver).public;
+    }
+}
+//# sourceMappingURL=configuration.js.map

package/dist/server/online/agent/configuration.js.map

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

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

@@ -0,0 +1,87 @@
+import type { JSONSchema7, ModelMessage, Schema } from 'ai';
+import type { AppUIMessage } from '../../../shared/online-agent.js';
+import type { ModelRef } from '../../../shared/models.js';
+import type { OnlineAgentOptions, NativeApproval, NativeHistoryPage, NativeHistoryQuery, NativeUIChunk, OnlineAgentSendOptions, OnlineAgentJson, OnlineAgentResult, OnlineAgentConfig, OnlineAgentContext, OnlineAgentRealtimeOptions, OnlineAgentBoundary, OnlineAgentBackendKind, OnlineAgentConfiguration, OnlineAgentInitialConfiguration } from './types.js';
+import type { NativeSessionStore } from './persistence/store.js';
+import type { ResolvedPageContext } from '../../../shared/conversations.js';
+import type { NativeOnlineAgent } from './native/execution.js';
+import type { OnlineAgentUIStreams } from './transport/streams.js';
+import type { OnlineAgentSession, OnlineAgentSessionIdentity } from './persistence/types.js';
+import type { OnlineAgentExecution } from './native/types.js';
+/** Public conversation capabilities; model replay always derives from the private original. */
+export interface OnlineAgent {
+    readonly sessionId: string;
+    status(): Promise<'running' | 'idle'>;
+    history(): Promise<AppUIMessage[]>;
+    abort(): Promise<void>;
+    retryFinalization(): Promise<void>;
+}
+export interface RealtimeOnlineAgent extends OnlineAgent {
+    readonly backend: 'native' | 'runner';
+    messages(query: NativeHistoryQuery): Promise<NativeHistoryPage>;
+    send(messages: ModelMessage[], input?: OnlineAgentSendOptions): Promise<number>;
+    receive(): Promise<ReadableStream<NativeUIChunk> | null>;
+    approve(input: NativeApproval): Promise<number>;
+}
+export interface BackgroundOnlineAgent extends OnlineAgent {
+    run(messages: ModelMessage[], schema: JSONSchema7, input?: {
+        overrides?: OnlineAgentOptions;
+        selectedModel?: ModelRef;
+    }): Promise<void>;
+    /** Wait for the execution admitted at invocation, including persistence and finalization. */
+    get(): Promise<OnlineAgentJson>;
+    /** A finite observation budget; timeout never cancels the execution. */
+    try(options?: {
+        wait?: number;
+    }): Promise<OnlineAgentResult>;
+}
+/** Execution-specific contract. Unsupported capabilities reject; they are never optional or redirected. */
+export interface OnlineAgentBackend {
+    readonly kind: OnlineAgentBackendKind;
+    createRealtime(context: OnlineAgentContext, initial: OnlineAgentInitialConfiguration, options: OnlineAgentRealtimeOptions, boundary?: OnlineAgentBoundary): Promise<RealtimeOnlineAgent>;
+    restoreRealtime(context: OnlineAgentContext, options: OnlineAgentRealtimeOptions & {
+        sessionId: string;
+    }, boundary?: OnlineAgentBoundary): Promise<RealtimeOnlineAgent>;
+    createBackground(context: OnlineAgentContext, initial: OnlineAgentInitialConfiguration, options: OnlineAgentRealtimeOptions, boundary?: OnlineAgentBoundary): Promise<BackgroundOnlineAgent>;
+    restoreBackground(context: OnlineAgentContext, options: OnlineAgentRealtimeOptions & {
+        sessionId: string;
+    }, boundary?: OnlineAgentBoundary): Promise<BackgroundOnlineAgent>;
+    configuration(context: OnlineAgentContext, id: string): Promise<OnlineAgentConfiguration>;
+    configure(context: OnlineAgentContext, id: string, options: OnlineAgentOptions, selectedModel?: ModelRef, boundary?: OnlineAgentBoundary): Promise<OnlineAgentConfiguration>;
+    shutdown(): Promise<void>;
+}
+export interface OnlineAgentSessionManager {
+    readonly native: NativeSessionStore;
+    recoverAtStartup(): Promise<void>;
+    defaults(userId: string): Promise<{
+        scope?: string[];
+        model?: ModelRef;
+    }>;
+    create(userId: string, kind: OnlineAgentSession['kind'], config: OnlineAgentConfig, model: ModelRef, info?: {
+        source?: string;
+        title?: string;
+        showInChatList?: boolean;
+    }): Promise<string>;
+    identify(userId: string, id: string): Promise<OnlineAgentSessionIdentity>;
+    load(userId: string, id: string): Promise<OnlineAgentSession>;
+    configure(userId: string, id: string, config: OnlineAgentConfig, model: ModelRef): Promise<void>;
+    /** Private model projection; public facades expose safe UI messages instead. */
+    history(userId: string, id: string): Promise<ModelMessage[]>;
+    executionHistory(userId: string, id: string, current?: ResolvedPageContext): Promise<ModelMessage[]>;
+    finish(userId: string, id: string): Promise<void>;
+}
+/** Internal execution capabilities, shared by all facades of the application's one service. */
+export interface NativeSessionHost {
+    sessions: OnlineAgentSessionManager;
+    native: NativeOnlineAgent;
+    uiStreams: OnlineAgentUIStreams;
+    isActive(id: string): boolean;
+    abort(context: OnlineAgentContext, id: string, kind: OnlineAgentSession['kind']): Promise<void>;
+    retryFinalization(context: OnlineAgentContext, id: string): Promise<void>;
+    start(context: OnlineAgentContext, id: string, messages: ModelMessage[], input?: OnlineAgentSendOptions & {
+        boundary?: OnlineAgentBoundary;
+    }, schema?: Schema<OnlineAgentJson>, onExecution?: (execution: OnlineAgentExecution) => void): Promise<number>;
+    approve(context: OnlineAgentContext, id: string, input: NativeApproval, onExecution?: (execution: OnlineAgentExecution) => void): Promise<number>;
+    observe(userId: string, id: string, wait?: number): Promise<OnlineAgentResult>;
+}
+//# sourceMappingURL=contracts.d.ts.map

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

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

package/dist/server/online/agent/contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/server/online/agent/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../../server/online/agent/contracts.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,11 @@
+import { invalid } from '../../kernel/errors.js';
+import type { OnlineAgentBackendKind, OnlineAgentSafeError } from './types.js';
+/** Keep the existing protocol error domain, with one machine-readable capability discriminator. */
+export declare function unsupportedCapability(backend: OnlineAgentBackendKind, capability: string): ReturnType<typeof invalid>;
+/** A safe execution failure; admission and infrastructure errors still throw separately. */
+export declare class OnlineAgentResultError extends Error {
+    readonly reason: 'failed' | 'cancelled';
+    readonly code: OnlineAgentSafeError['code'];
+    constructor(reason: 'failed' | 'cancelled', error: OnlineAgentSafeError);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../server/online/agent/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,KAAK,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE/E,mGAAmG;AACnG,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,sBAAsB,EAC/B,UAAU,EAAE,MAAM,GACjB,UAAU,CAAC,OAAO,OAAO,CAAC,CAM5B;AACD,4FAA4F;AAC5F,qBAAa,sBAAuB,SAAQ,KAAK;IAG7C,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,WAAW;IAFzC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC;gBAEjC,MAAM,EAAE,QAAQ,GAAG,WAAW,EACvC,KAAK,EAAE,oBAAoB;CAM9B"}

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

@@ -0,0 +1,21 @@
+import { invalid } from '../../kernel/errors.js';
+/** Keep the existing protocol error domain, with one machine-readable capability discriminator. */
+export function unsupportedCapability(backend, capability) {
+    return invalid(`The ${backend} backend does not support ${capability}.`, {
+        reason: 'UNSUPPORTED_CAPABILITY',
+        backend,
+        capability,
+    });
+}
+/** A safe execution failure; admission and infrastructure errors still throw separately. */
+export class OnlineAgentResultError extends Error {
+    reason;
+    code;
+    constructor(reason, error) {
+        super(error.message);
+        this.reason = reason;
+        this.name = 'OnlineAgentResultError';
+        this.code = error.code;
+    }
+}
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../server/online/agent/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGjD,mGAAmG;AACnG,MAAM,UAAU,qBAAqB,CACnC,OAA+B,EAC/B,UAAkB;IAElB,OAAO,OAAO,CAAC,OAAO,OAAO,6BAA6B,UAAU,GAAG,EAAE;QACvE,MAAM,EAAE,wBAAwB;QAChC,OAAO;QACP,UAAU;KACX,CAAC,CAAC;AACL,CAAC;AACD,4FAA4F;AAC5F,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAGpC;IAFF,IAAI,CAA+B;IAC5C,YACW,MAA8B,EACvC,KAA2B;QAE3B,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHZ,WAAM,GAAN,MAAM,CAAwB;QAIvC,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF"}

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

@@ -0,0 +1,11 @@
+export type { OnlineAgent, RealtimeOnlineAgent, BackgroundOnlineAgent, OnlineAgentBackend, } from './contracts.js';
+export type { OnlineAgentResult, OnlineAgentSafeError, OnlineAgentContext, OnlineAgentToolContext, OnlineAgentScope, OnlineAgentScopeProvider, OnlineAgentOptions, OnlineAgentConfig, OnlineAgentToolDefinition, OnlineAgentRealtimeOptions, OnlineAgentSendOptions, OnlineAgentBackendKind, OnlineAgentBoundary, OnlineAgentConfiguration, OnlineAgentInitialConfiguration, NativeHistoryQuery, NativeHistoryPage, OnlineAgentRecoveryConfig, OnlineAgentJson, } from './types.js';
+export { OnlineAgentResultError } from './errors.js';
+export { OnlineAgentService } from './service.js';
+export { OnlineAgentConfigurator } from './configuration.js';
+export { NativeOnlineAgentBackend } from './native/backend.js';
+export { NativeRealtimeOnlineAgent, NativeBackgroundOnlineAgent, } from './native/session.js';
+export { RunnerOnlineAgentAdapter } from './runner/backend.js';
+export { OnlineAgentUIStreams } from './transport/streams.js';
+export { appUIToolApprovalInputSchema, type AppUIToolApprovalInput, appUIDataSchemas, appUIJsonSchema, appUIMessageMetadataSchema, validateAppUIMessages, type AppUIData, type AppUIJson, type AppUIMessage, type AppUIMessageMetadata, type AppUITools, clonePageUIContext, pageUIContextSchema, PAGE_UI_CONTEXT_LIMITS, type PageUIItem, type PageUIContext, } from '../../../shared/online-agent.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../server/online/agent/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,yBAAyB,EACzB,0BAA0B,EAC1B,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,+BAA+B,EAC/B,kBAAkB,EAClB,iBAAiB,EACjB,yBAAyB,EACzB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EACL,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EACL,4BAA4B,EAC5B,KAAK,sBAAsB,EAC3B,gBAAgB,EAChB,eAAe,EACf,0BAA0B,EAC1B,qBAAqB,EACrB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,UAAU,EACf,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,KAAK,UAAU,EACf,KAAK,aAAa,GACnB,MAAM,iCAAiC,CAAC"}

package/dist/server/online/agent/index.js

@@ -0,0 +1,9 @@
+export { OnlineAgentResultError } from './errors.js';
+export { OnlineAgentService } from './service.js';
+export { OnlineAgentConfigurator } from './configuration.js';
+export { NativeOnlineAgentBackend } from './native/backend.js';
+export { NativeRealtimeOnlineAgent, NativeBackgroundOnlineAgent, } from './native/session.js';
+export { RunnerOnlineAgentAdapter } from './runner/backend.js';
+export { OnlineAgentUIStreams } from './transport/streams.js';
+export { appUIToolApprovalInputSchema, appUIDataSchemas, appUIJsonSchema, appUIMessageMetadataSchema, validateAppUIMessages, clonePageUIContext, pageUIContextSchema, PAGE_UI_CONTEXT_LIMITS, } from '../../../shared/online-agent.js';
+//# sourceMappingURL=index.js.map

package/dist/server/online/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../server/online/agent/index.ts"],"names":[],"mappings":"AA2BA,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EACL,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EACL,4BAA4B,EAE5B,gBAAgB,EAChB,eAAe,EACf,0BAA0B,EAC1B,qBAAqB,EAMrB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,GAGvB,MAAM,iCAAiC,CAAC"}

package/dist/server/online/agent/messages/json.d.ts

@@ -0,0 +1,5 @@
+import type { OnlineAgentJson } from '../types.js';
+export declare function jsonSafe(value: unknown): OnlineAgentJson;
+/** Validate without coercion, invoking accessors or toJSON, and detach every JSON node. */
+export declare function strictJson(value: unknown): OnlineAgentJson;
+//# sourceMappingURL=json.d.ts.map

package/dist/server/online/agent/messages/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../../../server/online/agent/messages/json.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CA4BxD;AAED,2FAA2F;AAC3F,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAuD1D"}

package/dist/server/online/agent/messages/json.js

@@ -0,0 +1,88 @@
+import { invalid } from '../../../kernel/errors.js';
+export function jsonSafe(value) {
+    const visit = (item, seen = new Set()) => {
+        if (item === null || typeof item === 'boolean' || typeof item === 'string')
+            return item;
+        if (typeof item === 'number' && Number.isFinite(item))
+            return item;
+        if (typeof item !== 'object' || seen.has(item))
+            throw invalid('A JSON-safe value is required.');
+        seen.add(item);
+        try {
+            if (Array.isArray(item))
+                return item.map((entry) => visit(entry, seen));
+            if (Object.getPrototypeOf(item) !== Object.prototype &&
+                Object.getPrototypeOf(item) !== null)
+                throw invalid('A JSON-safe object is required.');
+            return Object.fromEntries(Object.entries(item)
+                .filter(([, entry]) => entry !== undefined)
+                .map(([key, entry]) => [key, visit(entry, seen)]));
+        }
+        finally {
+            seen.delete(item);
+        }
+    };
+    return visit(value);
+}
+/** Validate without coercion, invoking accessors or toJSON, and detach every JSON node. */
+export function strictJson(value) {
+    const ancestors = new Set();
+    const fail = () => {
+        throw invalid('A strict JSON value is required.');
+    };
+    const visit = (item) => {
+        if (item === null || typeof item === 'string' || typeof item === 'boolean')
+            return item;
+        if (typeof item === 'number' && Number.isFinite(item))
+            return item;
+        if (typeof item !== 'object' || ancestors.has(item))
+            return fail();
+        const array = Array.isArray(item);
+        const prototype = Object.getPrototypeOf(item);
+        if (array
+            ? prototype !== Array.prototype
+            : prototype !== Object.prototype && prototype !== null)
+            return fail();
+        ancestors.add(item);
+        try {
+            const entries = [];
+            const keys = Reflect.ownKeys(item);
+            const length = array
+                ? Object.getOwnPropertyDescriptor(item, 'length').value
+                : 0;
+            for (const key of keys) {
+                if (typeof key !== 'string')
+                    return fail();
+                const descriptor = Object.getOwnPropertyDescriptor(item, key);
+                if (!('value' in descriptor))
+                    return fail();
+                if (array && key === 'length')
+                    continue;
+                if (!descriptor.enumerable)
+                    return fail();
+                if (array) {
+                    const index = Number(key);
+                    if (!Number.isInteger(index) ||
+                        index < 0 ||
+                        index >= length ||
+                        String(index) !== key)
+                        return fail();
+                }
+                entries.push([key, visit(descriptor.value)]);
+            }
+            if (array) {
+                // Array holes and extra properties must not silently become null or disappear.
+                if (entries.length !== length)
+                    return fail();
+                return entries.map(([, entry]) => entry);
+            }
+            // Define keys as data, including a possible own "__proto__" key.
+            return Object.fromEntries(entries);
+        }
+        finally {
+            ancestors.delete(item);
+        }
+    };
+    return visit(value);
+}
+//# sourceMappingURL=json.js.map

package/dist/server/online/agent/messages/json.js.map

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

package/dist/server/online/agent/messages/projection.d.ts

@@ -0,0 +1,20 @@
+import { type ModelMessage, type UIMessage, type UIMessageChunk } from 'ai';
+import type { ServiceResolver } from '@nocobase/service-provider';
+import { type AppUIMessage } from '../../../../shared/online-agent.js';
+import type { OnlineAgentConfigurator } from '../configuration.js';
+import type { NativeUIChunk, NativeMessage } from '../types.js';
+/** Central conversions from immutable, private SDK originals, never a second saved projection. */
+export declare class NativeMessages {
+    private configurator;
+    private resolver;
+    constructor(configurator: OnlineAgentConfigurator, resolver?: ServiceResolver | undefined);
+    validate(messages: unknown[]): Promise<NativeMessage[]>;
+    public(messages: UIMessage[], allowedTools?: string[]): Promise<AppUIMessage[]>;
+    private publicPart;
+    private publicTool;
+    stream(allowedTools: string[], original?: UIMessage): {
+        project(chunk: UIMessageChunk): Promise<NativeUIChunk | undefined>;
+    };
+    model(messages: UIMessage[]): Promise<ModelMessage[]>;
+}
+//# sourceMappingURL=projection.d.ts.map

package/dist/server/online/agent/messages/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../../../../server/online/agent/messages/projection.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,YAAY,EAGjB,KAAK,SAAS,EACd,KAAK,cAAc,EACpB,MAAM,IAAI,CAAC;AACZ,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAEnE,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EAGd,MAAM,aAAa,CAAC;AA2ErB,kGAAkG;AAClG,qBAAa,cAAc;IAEvB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,QAAQ;gBADR,YAAY,EAAE,uBAAuB,EACrC,QAAQ,GAAE,eAAe,GAAG,SAAqB;IAGrD,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA+EvD,MAAM,CACV,QAAQ,EAAE,SAAS,EAAE,EACrB,YAAY,CAAC,EAAE,MAAM,EAAE,GACtB,OAAO,CAAC,YAAY,EAAE,CAAC;IAkC1B,OAAO,CAAC,UAAU;YAsCJ,UAAU;IAqCxB,MAAM,CACJ,YAAY,EAAE,MAAM,EAAE,EACtB,QAAQ,CAAC,EAAE,SAAS,GACnB;QAAE,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAA;KAAE;IAqKnE,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAsG5D"}