@nocobase/app-plugin-agents 0.0.0-stage → 0.1.0-beta.2

package/dist/server/online/services.js

@@ -0,0 +1,444 @@
+import { z } from 'zod';
+import { MODEL_KINDS, MODEL_PROVIDER_NAMES, guessModelKind, providerOf, } from '../../shared/models.js';
+import { ONLINE_TOOL } from '../../shared/reports.js';
+import { settingsRepo } from '../core/conversations/conversation.store.js';
+import { invalid, notFound } from '../kernel/errors.js';
+import { asJson, jsonObject } from '../kernel/values.js';
+import { answered, checkEmbedding, checkModel, checkRerank, CHECK_TIMEOUT_MS, ModelError, } from './gateway.js';
+import { listModels } from './providers.js';
+const SERVICES = 'agModelServices';
+const PRICES = 'agModelPrices';
+/** The failures a model of another kind answers with, rather than a connection, key or quota problem. */
+const WRONG_KIND_CODES = new Set([
+    'config',
+    'badResponse',
+    'unknown',
+]);
+/** The `agSettings` key of the default models. */
+const DEFAULTS_KEY = 'models';
+const KindSchema = z.enum(MODEL_KINDS);
+const DimensionsSchema = z.number().int().min(1).max(8192).nullable();
+const ModelsSchema = z
+    .array(z
+    .strictObject({
+    value: z.string().trim().min(1).max(200),
+    label: z.string().trim().max(200).optional(),
+    kind: KindSchema.optional(),
+    dimensions: DimensionsSchema.optional(),
+})
+    .refine((model) => !model.dimensions || model.kind === 'embedding', 'Only an embedding model has dimensions.'))
+    .max(500);
+const ProviderSchema = z.enum(MODEL_PROVIDER_NAMES);
+export const CreateServiceSchema = z.strictObject({
+    title: z.string().trim().min(1).max(100),
+    provider: ProviderSchema,
+    baseUrl: z.string().trim().max(500).nullable().optional(),
+    apiKey: z.string().max(4000).nullable().optional(),
+    models: ModelsSchema.optional(),
+    enabled: z.boolean().optional(),
+});
+export const UpdateServiceSchema = z.strictObject({
+    title: z.string().trim().min(1).max(100).optional(),
+    baseUrl: z.string().trim().max(500).nullable().optional(),
+    apiKey: z.string().max(4000).nullable().optional(),
+    models: ModelsSchema.optional(),
+    enabled: z.boolean().optional(),
+});
+export const ModelRefSchema = z.strictObject({
+    modelService: z.string().trim().min(1).max(64),
+    model: z.string().trim().min(1).max(200),
+});
+export const ConnectionSchema = z.strictObject({
+    service: z.string().trim().min(1).max(64).optional(),
+    provider: ProviderSchema.optional(),
+    baseUrl: z.string().trim().max(500).nullable().optional(),
+    apiKey: z.string().max(4000).nullable().optional(),
+});
+export const ConnectionCheckSchema = z.strictObject({
+    service: z.string().trim().min(1).max(64).optional(),
+    provider: ProviderSchema.optional(),
+    baseUrl: z.string().trim().max(500).nullable().optional(),
+    apiKey: z.string().max(4000).nullable().optional(),
+    model: z.string().trim().min(1).max(200),
+    kind: KindSchema.optional(),
+    dimensions: DimensionsSchema.optional(),
+});
+const kindOf = (value) => typeof value === 'string' &&
+    MODEL_KINDS.includes(value)
+    ? value
+    : 'chat';
+const dimensionsOf = (kind, value) => kind === 'embedding' &&
+    typeof value === 'number' &&
+    Number.isInteger(value) &&
+    value > 0
+    ? value
+    : null;
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const text = (value) => typeof value === 'string' && value.trim() ? value.trim() : null;
+/** The models a stored list offers, in order and each once; a model without a kind is a chat model. */
+function modelsOf(stored) {
+    const seen = new Set();
+    const models = [];
+    for (const item of Array.isArray(stored) ? stored : []) {
+        if (!isRecord(item))
+            continue;
+        const value = text(item.value);
+        const kind = kindOf(item.kind);
+        if (!value || seen.has(value))
+            continue;
+        seen.add(value);
+        models.push({
+            value,
+            label: text(item.label) ?? value,
+            kind,
+            dimensions: dimensionsOf(kind, item.dimensions),
+        });
+    }
+    return models;
+}
+/** The models as stored, refused when one is of a kind the provider does not serve. */
+function cleanModels(provider, models) {
+    const kinds = providerOf(provider)?.kinds ?? ['chat'];
+    for (const model of models) {
+        if (model.dimensions && (model.kind ?? 'chat') !== 'embedding')
+            throw invalid(`${model.value} is not an embedding model: it has no dimensions.`);
+        if (!kinds.includes(model.kind ?? 'chat'))
+            throw invalid(`${providerOf(provider)?.title ?? provider} serves no ${model.kind ?? 'chat'} models.`);
+    }
+    return modelsOf(models.map((model) => ({ ...model })));
+}
+/** A name from the title: lower-case ASCII letters, digits and dashes; the provider's when the title has none. */
+export function nameFrom(title, provider) {
+    const slug = title
+        .normalize('NFKD')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/gu, '-')
+        .replace(/^-+|-+$/gu, '')
+        .slice(0, 48);
+    return slug || provider;
+}
+function normalizeBaseUrl(value) {
+    const url = text(value);
+    if (!url)
+        return null;
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        throw invalid('The base URL is not a URL.');
+    }
+    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:')
+        throw invalid('The base URL must start with http:// or https://.');
+    return url.replace(/\/+$/u, '');
+}
+const providerName = (record) => ProviderSchema.parse(record.provider);
+function view(record) {
+    return {
+        name: record.name,
+        title: record.title,
+        provider: providerName(record),
+        baseUrl: record.baseUrl,
+        apiKeySet: record.apiKeyEncrypted !== null,
+        enabled: Boolean(record.enabled),
+        models: modelsOf(record.models),
+    };
+}
+/** The enabled services with their models of `kind`, those offering none left out. */
+function offeredOf(records, kind) {
+    return records
+        .filter((record) => Boolean(record.enabled))
+        .map((record) => ({
+        name: record.name,
+        title: record.title,
+        provider: record.provider,
+        models: modelsOf(record.models).filter((model) => model.kind === kind),
+    }))
+        .filter((service) => service.models.length > 0);
+}
+/** `ref` as a chat model an enabled service offers, with its titles; null when none offers it. */
+function offeredRef(records, ref) {
+    const service = offeredOf(records, 'chat').find((item) => item.name === ref.modelService);
+    const model = service?.models.find((item) => item.value === ref.model);
+    return service && model
+        ? {
+            modelService: service.name,
+            model: model.value,
+            serviceTitle: service.title,
+            modelLabel: model.label,
+        }
+        : null;
+}
+/** The default chat model used now: `set` while it is offered, else the first chat model offered. */
+function effectiveChat(records, set) {
+    const chosen = set ? offeredRef(records, set) : null;
+    if (chosen)
+        return chosen;
+    const first = offeredOf(records, 'chat').at(0);
+    const model = first?.models.at(0);
+    return first && model
+        ? {
+            modelService: first.name,
+            model: model.value,
+            serviceTitle: first.title,
+            modelLabel: model.label,
+        }
+        : null;
+}
+function defaultsOf(records, set) {
+    return { chat: set, effectiveChat: effectiveChat(records, set) };
+}
+export function createModelServices(deps) {
+    const repo = (conn) => conn.repository(SERVICES);
+    const all = (conn) => repo(conn).findMany({
+        sort: (sort) => [sort.field('sort').asc(), sort.field('name').asc()],
+    });
+    async function stored(conn, name) {
+        const record = (await repo(conn).findMany({ filter: { name } })).at(0);
+        if (!record)
+            throw notFound('Model service');
+        return record;
+    }
+    function keyOf(record) {
+        if (record.apiKeyEncrypted === null)
+            return null;
+        return deps.box.open(record.apiKeyEncrypted, [record.name]);
+    }
+    /** A key is bound to its service's name, which never changes. */
+    function sealed(name, apiKey) {
+        return { apiKeyEncrypted: apiKey ? deps.box.seal(apiKey, [name]) : null };
+    }
+    const connectionOf = (record) => ({
+        provider: providerName(record),
+        baseUrl: record.baseUrl,
+        apiKey: keyOf(record),
+    });
+    /** The connection being tried: the edited values over the saved service's. */
+    async function tried(request) {
+        const saved = request.service
+            ? connectionOf(await stored(deps.tx.read(), request.service))
+            : null;
+        const provider = request.provider ?? saved?.provider;
+        if (!provider)
+            throw invalid('Choose a provider.');
+        return {
+            provider,
+            baseUrl: request.baseUrl === undefined
+                ? (saved?.baseUrl ?? null)
+                : normalizeBaseUrl(request.baseUrl),
+            apiKey: request.apiKey === undefined
+                ? (saved?.apiKey ?? null)
+                : text(request.apiKey),
+        };
+    }
+    /** Adds a service under `name`, after the others. */
+    async function insert(conn, name, input) {
+        const baseUrl = normalizeBaseUrl(input.baseUrl);
+        if (!baseUrl && !providerOf(input.provider)?.defaultBaseUrl)
+            throw invalid('This provider needs a base URL.');
+        const services = await all(conn);
+        const now = deps.clock.now().toISOString();
+        await repo(conn).createOne({
+            values: {
+                name,
+                title: input.title.trim(),
+                provider: input.provider,
+                baseUrl,
+                ...sealed(name, text(input.apiKey)),
+                enabled: input.enabled !== false,
+                models: cleanModels(input.provider, input.models ?? []),
+                sort: services.reduce((top, row) => Math.max(top, row.sort), 0) + 1,
+                createdAt: now,
+                updatedAt: now,
+            },
+        });
+    }
+    async function storedDefault(conn) {
+        const row = await settingsRepo(conn).findOne({
+            filter: { key: DEFAULTS_KEY },
+        });
+        const chat = jsonObject(jsonObject(row?.value).chat);
+        const modelService = text(chat.modelService);
+        const model = text(chat.model);
+        return modelService && model ? { modelService, model } : null;
+    }
+    async function writeDefault(conn, chat, byUserId) {
+        const values = {
+            value: asJson({
+                chat: chat
+                    ? { modelService: chat.modelService, model: chat.model }
+                    : null,
+            }),
+            updatedById: byUserId,
+            updatedAt: deps.clock.now().toISOString(),
+        };
+        const filter = { key: DEFAULTS_KEY };
+        if (await settingsRepo(conn).findOne({ filter }))
+            await settingsRepo(conn).updateMany({ filter, values });
+        else
+            await settingsRepo(conn).createOne({
+                values: { key: DEFAULTS_KEY, ...values },
+            });
+    }
+    /** With no default chat model set, the first chat model offered becomes it. */
+    async function ensureDefault(conn) {
+        if (await storedDefault(conn))
+            return;
+        const first = effectiveChat(await all(conn), null);
+        if (first)
+            await writeDefault(conn, { modelService: first.modelService, model: first.model }, null);
+    }
+    const names = async (conn) => new Set((await all(conn)).map((service) => service.name));
+    return {
+        async list() {
+            return (await all(deps.tx.read())).map(view);
+        },
+        create(input) {
+            return deps.tx.run(async ({ conn }) => {
+                const taken = await names(conn);
+                const base = nameFrom(input.title.trim(), input.provider);
+                let name = base;
+                for (let suffix = 2; taken.has(name); suffix += 1)
+                    name = `${base}-${suffix}`;
+                await insert(conn, name, input);
+                await ensureDefault(conn);
+                return view(await stored(conn, name));
+            });
+        },
+        update(name, input) {
+            return deps.tx.run(async ({ conn }) => {
+                const current = await stored(conn, name);
+                const baseUrl = input.baseUrl === undefined
+                    ? undefined
+                    : normalizeBaseUrl(input.baseUrl);
+                if (baseUrl === null && !providerOf(current.provider)?.defaultBaseUrl)
+                    throw invalid('This provider needs a base URL.');
+                await repo(conn).updateMany({
+                    filter: { name },
+                    values: {
+                        ...(input.title === undefined ? {} : { title: input.title.trim() }),
+                        ...(baseUrl === undefined ? {} : { baseUrl }),
+                        ...(input.apiKey === undefined
+                            ? {}
+                            : sealed(name, text(input.apiKey))),
+                        ...(input.models === undefined
+                            ? {}
+                            : { models: cleanModels(providerName(current), input.models) }),
+                        ...(input.enabled === undefined ? {} : { enabled: input.enabled }),
+                        updatedAt: deps.clock.now().toISOString(),
+                    },
+                });
+                await ensureDefault(conn);
+                return view(await stored(conn, name));
+            });
+        },
+        remove(name) {
+            return deps.tx.run(async ({ conn }) => {
+                await stored(conn, name);
+                await repo(conn).deleteMany({ filter: { name } });
+                await conn
+                    .repository(PRICES)
+                    .deleteMany({ filter: { tool: ONLINE_TOOL, modelService: name } });
+            });
+        },
+        async models(request) {
+            const connection = await tried(request);
+            try {
+                const kinds = providerOf(connection.provider)?.kinds ?? ['chat'];
+                return {
+                    ok: true,
+                    items: (await listModels(connection, AbortSignal.timeout(CHECK_TIMEOUT_MS))).map((id) => ({ id, kind: guessModelKind(id, kinds) })),
+                };
+            }
+            catch (error) {
+                return {
+                    ok: false,
+                    message: (error instanceof Error
+                        ? error.message
+                        : String(error)).slice(0, 500),
+                };
+            }
+        },
+        async check(request) {
+            const connection = await tried(request);
+            const kind = request.kind ?? 'chat';
+            if (!(providerOf(connection.provider)?.kinds ?? []).includes(kind))
+                return {
+                    ok: false,
+                    message: `${providerOf(connection.provider)?.title ?? connection.provider} serves no ${kind} models.`,
+                };
+            const model = request.model.trim();
+            const as = (other) => {
+                switch (other) {
+                    case 'embedding':
+                        return checkEmbedding(connection, model, other === kind ? (request.dimensions ?? null) : null);
+                    case 'rerank':
+                        return checkRerank(connection, model);
+                    default:
+                        return checkModel(connection, model);
+                }
+            };
+            const checked = await as(kind);
+            // A model that answers as another kind its provider serves was given the wrong kind; tried at once, unless the
+            // failure is the connection's or the account's rather than the model's.
+            if (checked.ok || !WRONG_KIND_CODES.has(checked.code ?? 'unknown'))
+                return answered(checked);
+            const others = (providerOf(connection.provider)?.kinds ?? []).filter((other) => other !== kind);
+            const answers = await Promise.all(others.map((other) => as(other)));
+            const looksLike = others.find((_, index) => answers[index]?.ok) ?? null;
+            return answered(looksLike ? { ...checked, looksLike } : checked);
+        },
+        async catalog(kind = 'chat') {
+            const conn = deps.tx.read();
+            const records = await all(conn);
+            const services = offeredOf(records, kind);
+            if (kind !== 'chat')
+                return { services };
+            const chosen = effectiveChat(records, await storedDefault(conn));
+            return {
+                services,
+                defaultModel: chosen
+                    ? { modelService: chosen.modelService, model: chosen.model }
+                    : null,
+            };
+        },
+        async defaults(on) {
+            const conn = on ?? deps.tx.read();
+            return defaultsOf(await all(conn), await storedDefault(conn));
+        },
+        setDefaultChat(ref, byUserId) {
+            return deps.tx.run(async ({ conn }) => {
+                const records = await all(conn);
+                if (!offeredRef(records, ref))
+                    throw invalid(`No enabled model service offers the chat model ${ref.model} of ${ref.modelService}.`, { field: 'model' });
+                await writeDefault(conn, ref, byUserId);
+                return defaultsOf(records, ref);
+            });
+        },
+        async connectionFor(ref, kind = 'chat') {
+            return (await endpoint(ref, kind)).connection;
+        },
+        endpointFor: (ref, kind) => endpoint(ref, kind),
+    };
+    async function endpoint(ref, kind) {
+        const record = (await repo(deps.tx.read()).findMany({
+            filter: { name: ref.modelService },
+        })).at(0);
+        if (!record?.enabled)
+            throw new ModelError('config', `The model service ${ref.modelService} is not there or is off.`);
+        const offered = modelsOf(record.models).find((model) => model.value === ref.model && model.kind === kind);
+        if (!offered)
+            throw new ModelError('config', `The model service ${ref.modelService} does not offer the ${kind} model ${ref.model}.`);
+        let connection;
+        try {
+            connection = connectionOf(record);
+        }
+        catch (error) {
+            throw new ModelError('auth', 'The service’s API key cannot be read with this application’s secrets keys; set it again.', { cause: error });
+        }
+        if (!connection.apiKey && providerOf(connection.provider)?.keyRequired)
+            throw new ModelError('auth', `The model service ${ref.modelService} has no API key.`);
+        return { connection, dimensions: offered.dimensions };
+    }
+}
+//# sourceMappingURL=services.js.map

package/dist/server/online/services.js.map

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

package/dist/server/online/tools.d.ts

@@ -0,0 +1,17 @@
+import type { ModelToolSpec } from './gateway.js';
+/** A tool of an online run. */
+export interface ServerTool {
+    readonly spec: ModelToolSpec;
+    /** Runs the call; a refusal or failure is a result the model reads (`ok: false`), not an error. */
+    invoke(args: unknown): Promise<{
+        readonly ok: boolean;
+        readonly output: string;
+    }>;
+}
+/** The longest tool result the model reads, in characters; longer ones are cut with a note. */
+export declare const TOOL_OUTPUT_MAX = 24000;
+/** A result cut to `TOOL_OUTPUT_MAX`, with a note saying so. */
+export declare function clip(text: string): string;
+/** A refusal or failure as the model reads it: the command's error, which it should not try to work around. */
+export declare function errorOutput(error: unknown): string;
+//# sourceMappingURL=tools.d.ts.map

package/dist/server/online/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../server/online/tools.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,+BAA+B;AAC/B,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,mGAAmG;IACnG,MAAM,CACJ,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC;QAAE,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/D;AAED,+FAA+F;AAC/F,eAAO,MAAM,eAAe,QAAS,CAAC;AAEtC,gEAAgE;AAChE,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGzC;AAED,+GAA+G;AAC/G,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAelD"}

package/dist/server/online/tools.js

@@ -0,0 +1,31 @@
+/**
+ * An online run's tools (`sandbox.ts`): its shell, with the application's CLI in it, and its skills. A refusal or a
+ * failure is an output the model reads, never an error the run fails on.
+ */
+import { ProtocolError } from '@nocobase/agent-protocol';
+/** The longest tool result the model reads, in characters; longer ones are cut with a note. */
+export const TOOL_OUTPUT_MAX = 24_000;
+/** A result cut to `TOOL_OUTPUT_MAX`, with a note saying so. */
+export function clip(text) {
+    if (text.length <= TOOL_OUTPUT_MAX)
+        return text;
+    return `${text.slice(0, TOOL_OUTPUT_MAX)}\n…(cut: the result was ${text.length} characters; ask for less, such as with a filter or a limit)`;
+}
+/** A refusal or failure as the model reads it: the command's error, which it should not try to work around. */
+export function errorOutput(error) {
+    if (error instanceof ProtocolError)
+        return JSON.stringify({
+            error: {
+                code: error.code,
+                message: error.message,
+                ...(error.details ? { details: error.details } : {}),
+            },
+        });
+    return JSON.stringify({
+        error: {
+            code: 'INTERNAL',
+            message: error instanceof Error ? error.message : String(error),
+        },
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/server/online/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../server/online/tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAazD,+FAA+F;AAC/F,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AAEtC,gEAAgE;AAChE,MAAM,UAAU,IAAI,CAAC,IAAY;IAC/B,IAAI,IAAI,CAAC,MAAM,IAAI,eAAe;QAAE,OAAO,IAAI,CAAC;IAChD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,2BAA2B,IAAI,CAAC,MAAM,8DAA8D,CAAC;AAC/I,CAAC;AAED,+GAA+G;AAC/G,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,aAAa;QAChC,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,KAAK,EAAE;gBACL,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACrD;SACF,CAAC,CAAC;IACL,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,KAAK,EAAE;YACL,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAChE;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/server/plugin.d.ts

@@ -0,0 +1,4 @@
+import { type AppServerPlugin } from '@nocobase/app-server/plugins';
+declare const agentsPlugin: AppServerPlugin;
+export default agentsPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/server/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../server/plugin.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,8BAA8B,CAAC;AAKtC,QAAA,MAAM,YAAY,EAAE,eAalB,CAAC;AAEH,eAAe,YAAY,CAAC"}

package/dist/server/plugin.js

@@ -0,0 +1,20 @@
+import path from 'node:path';
+import { defineServerPlugin, } from '@nocobase/app-server/plugins';
+import serviceProviders from './providers/index.js';
+import routes from './routes/index.js';
+const agentsPlugin = defineServerPlugin({
+    baseDir: path.resolve(import.meta.dirname, '..'),
+    packageName: '@nocobase/app-plugin-agents',
+    locales: () => import('./locales/index.js'),
+    serviceProviders,
+    routes,
+    database: {
+        migrations: './database/migrations',
+        seeds: './database/seeds',
+    },
+    queue: {
+        jobs: ['./server/tasks'],
+    },
+});
+export default agentsPlugin;
+//# sourceMappingURL=plugin.js.map

package/dist/server/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../server/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EACL,kBAAkB,GAEnB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,gBAAgB,MAAM,sBAAsB,CAAC;AACpD,OAAO,MAAM,MAAM,mBAAmB,CAAC;AAEvC,MAAM,YAAY,GAAoB,kBAAkB,CAAC;IACvD,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;IAChD,WAAW,EAAE,6BAA6B;IAC1C,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC;IAC3C,gBAAgB;IAChB,MAAM;IACN,QAAQ,EAAE;QACR,UAAU,EAAE,uBAAuB;QACnC,KAAK,EAAE,kBAAkB;KAC1B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,CAAC,gBAAgB,CAAC;KACzB;CACF,CAAC,CAAC;AAEH,eAAe,YAAY,CAAC"}

package/dist/server/providers/agents.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Binds the plugin's services, and at boot connects them to the platform: realtime announcements of runs and
+ * conversations, and this instance's server executor, which runs online agents' runs (stopped again at shutdown,
+ * handing back what it holds). The runners' side (their announcements, the sweeper and the wake-ups of work sent back
+ * with a back-off) is `runners.ts`.
+ */
+import { type RunApp } from '@nocobase/agent-protocol';
+import type { AppPluginApplication } from '@nocobase/app-server/plugins';
+import { ServiceProvider } from '@nocobase/service-provider';
+import type { VectorsConfig } from '../vectors/index.js';
+import type { DistConfig } from '../distribution/index.js';
+import { type AgentCli } from '../core/runs/index.js';
+/** `agents` in the application's configuration. */
+export interface AgentsConfig {
+    /**
+     * The CLI agents talk to the application with, and where runners get it: `name` (the application's id from `app` when
+     * left out), and `package`, the tarball this application serves (`{ kind: 'served' }`, from `dist` below) by default,
+     * or an npm package and version, a tarball, or `{ kind: 'preinstalled' }` where runners have it. The run's token goes
+     * in `credentialFile`, `.<name>/run.json` by default. An application may set its own, such as `acme`.
+     */
+    readonly cli?: Partial<AgentCli>;
+    /**
+     * How runners name this application, which they keep one registration per `id` for: the CLI's `name`, else the
+     * application's name (`appName`), by default. An application may set its own, such as `{ id: 'acme', name: 'Acme' }`.
+     */
+    readonly app?: RunApp;
+    /**
+     * The tarballs of the runner and the application's CLI this application serves (`/api/agents/dist`): built into
+     * `storage/runners/dist` by default, on the `stable` channel, the highest version unless `versions` pins one.
+     */
+    readonly dist?: DistConfig;
+    /**
+     * Online agents' runs, which each instance runs itself: `enabled` (true by default; false leaves them to the other
+     * instances), `maxSteps`, the model calls a run may make (16 by default), and `consult`, the bounds of one agent
+     * consulting another (`ask_agent`): `timeoutMs` (120000) and `tokenBudget`, input and output tokens (200000).
+     */
+    readonly server?: {
+        readonly enabled?: boolean;
+        readonly maxSteps?: number;
+        readonly consult?: {
+            readonly timeoutMs?: number;
+            readonly tokenBudget?: number;
+        };
+    };
+    /**
+     * The vector store of vector collections, apart from the application's database: `store` (`sqlite-vec` by default,
+     * in `path`, `storage/vectors.sqlite` by default; `pgvector` with its own `url` or `host`, `port`, `database`,
+     * `user`, `password` and `ssl`; `false` turns vectors off). See `VectorsConfig`.
+     */
+    readonly vectors?: VectorsConfig;
+    /** Skills: `disk`, the Drive disk their files' contents go to (Drive's default disk by default). */
+    readonly skills?: {
+        readonly disk?: string;
+    };
+}
+export declare class AgentsProvider extends ServiceProvider<AppPluginApplication> {
+    readonly name: string;
+    private readonly releases;
+    private stopping;
+    private stoppingVectors;
+    private surface;
+    register(): void;
+    /** How runners name this application: `agents.app`, else the CLI's name, else the application's. */
+    private runApp;
+    /**
+     * An online run's commands from the application's command manifest, sent through the application itself with the
+     * run's token; undefined without one (no API documentation or command line), which leaves its shell without a CLI.
+     */
+    private commandsOf;
+    /** Where the plugin keeps sealed values, for `nocobase secrets status` and `secrets rotate`. */
+    private registerSecretsStores;
+    boot(): Promise<void>;
+    /** Deletes the chat files never sent with a message, a minute after boot and then every hour. */
+    private purgeChatFiles;
+    /**
+     * Teaches the application's authentication the run token (a scoped session for the person who woke the agent), and
+     * its command line who calls and which commands are custom.
+     */
+    private bindAuthentication;
+    shutdown(): Promise<void>;
+    /** Tells open pages what changed; they fetch the details through the API, which checks access. */
+    private announce;
+}
+//# sourceMappingURL=agents.d.ts.map