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

package/dist/server/core/variables/variable.service.js

@@ -0,0 +1,370 @@
+import { isReservedVariable, VARIABLE_NAME_PATTERN, VARIABLE_VALUE_MAX_BYTES, } from '../../../shared/variables.js';
+import { invalid, notFound } from '../../kernel/errors.js';
+import { stringArray } from '../../kernel/values.js';
+import { JobSecretsNotAllowed } from '../../jobs/spec.js';
+import { runnersRepo } from '../../runners/runner.store.js';
+function secrets(conn) {
+    return conn.repository('agSecrets');
+}
+function runnerVariables(conn) {
+    return conn.repository('agRunnerVariables');
+}
+function audits(conn) {
+    return conn.repository('agSecretAudits');
+}
+/** The variables named in a JSON column, such as `agRuns.teamOnlyVariables`; anything else reads as none. */
+export function variableRefs(value) {
+    const parsed = typeof value === 'string'
+        ? (() => {
+            try {
+                return JSON.parse(value);
+            }
+            catch {
+                return null;
+            }
+        })()
+        : value;
+    if (!Array.isArray(parsed))
+        return [];
+    return parsed.flatMap((item) => {
+        if (!item || typeof item !== 'object')
+            return [];
+        const { scope, scopeId, name } = item;
+        return typeof scope === 'string' &&
+            typeof scopeId === 'string' &&
+            typeof name === 'string'
+            ? [{ scope, scopeId, name }]
+            : [];
+    });
+}
+/** Variables as a person reads them in a wait or a notice: `NPM_TOKEN (agent 42), API_KEY (workdir 7)`. */
+export function describeVariables(variables) {
+    return variables
+        .map((each) => `${each.name} (${each.scope} ${each.scopeId})`)
+        .join(', ');
+}
+/** What a variable's value is bound to: moved to another scope or name, it no longer opens. */
+export function variableAad(variable) {
+    return [variable.scope, variable.scopeId, variable.name];
+}
+/** Why `name` cannot be a variable's, or nothing. */
+export function checkVariableName(name, cli) {
+    if (!VARIABLE_NAME_PATTERN.test(name))
+        throw invalid('A variable name uses upper-case letters, digits and underscores, and does not start with a digit.', { reason: 'pattern' });
+    if (isReservedVariable(name, cli))
+        throw invalid(`${name} is reserved.`, { reason: 'reserved' });
+}
+/** Why `name` and `value` cannot be stored, or nothing. */
+export function checkVariable(name, value, cli) {
+    checkVariableName(name, cli);
+    if (Buffer.byteLength(value, 'utf8') > VARIABLE_VALUE_MAX_BYTES)
+        throw invalid('The value is larger than 8 KB.', { reason: 'tooLong' });
+}
+export function createVariableService(deps) {
+    const { tx, ids, clock, box, people, cli } = deps;
+    const of = (conn, target) => secrets(conn).findMany({
+        filter: { scope: target.scope, scopeId: target.scopeId },
+        sort: (sort) => sort.field('name').asc(),
+    });
+    const audit = (conn, target, entry) => audits(conn).createOne({
+        values: {
+            id: ids.next(),
+            scope: target.scope,
+            scopeId: target.scopeId,
+            action: entry.action,
+            names: [...entry.names],
+            userId: entry.userId ?? null,
+            runId: entry.runId ?? null,
+            jobId: entry.jobId ?? null,
+            runnerId: entry.runnerId ?? null,
+            at: clock.now().toISOString(),
+        },
+    });
+    const open = (record) => box.open(record.valueEncrypted, variableAad(record));
+    const fromRunnerOf = (conn, target) => runnerVariables(conn).findMany({
+        filter: { scope: target.scope, scopeId: target.scopeId },
+        sort: (sort) => sort.field('name').asc(),
+    });
+    /** The names of `targets` merged in order, each with the kind of its last entry. */
+    const merge = async (conn, targets) => {
+        const merged = new Map();
+        for (const target of targets) {
+            for (const record of await of(conn, target))
+                merged.set(record.name, { kind: 'value', target, record });
+            for (const record of await fromRunnerOf(conn, target))
+                merged.set(record.name, { kind: 'runner', target });
+        }
+        return merged;
+    };
+    const passthroughOf = async (conn, targets) => [...(await merge(conn, targets))]
+        .filter(([, entry]) => entry.kind === 'runner')
+        .map(([name]) => name)
+        .sort();
+    /** Takes a variable from the runner: replaces one with a value, keeps one already taken from it. */
+    const setFromRunner = async (conn, target, name, userId) => {
+        checkVariableName(name, cli);
+        const now = clock.now().toISOString();
+        const valued = await secrets(conn).findOne({
+            filter: { scope: target.scope, scopeId: target.scopeId, name },
+        });
+        if (valued)
+            await secrets(conn).deleteMany({ filter: { id: valued.id } });
+        const existing = await runnerVariables(conn).findOne({
+            filter: { scope: target.scope, scopeId: target.scopeId, name },
+        });
+        if (existing)
+            await runnerVariables(conn).updateMany({
+                filter: { id: existing.id },
+                values: { updatedById: userId, updatedAt: now },
+            });
+        else
+            await runnerVariables(conn).createOne({
+                values: {
+                    id: ids.next(),
+                    scope: target.scope,
+                    scopeId: target.scopeId,
+                    name,
+                    createdById: userId,
+                    updatedById: userId,
+                    createdAt: now,
+                    updatedAt: now,
+                },
+            });
+        return existing || valued ? 'changed' : 'added';
+    };
+    return {
+        async list(target) {
+            const conn = tx.read();
+            const records = await of(conn, target);
+            const fromRunner = await fromRunnerOf(conn, target);
+            const names = await people.names(conn, [
+                ...records.map((record) => record.updatedById),
+                ...fromRunner.map((record) => record.updatedById),
+            ]);
+            const by = (id) => (id ? (names.get(id) ?? null) : null);
+            return [
+                ...records.map((record) => ({
+                    name: record.name,
+                    teamRunnersOnly: Boolean(record.teamRunnersOnly),
+                    updatedAt: record.updatedAt,
+                    updatedById: record.updatedById,
+                    updatedByName: by(record.updatedById),
+                })),
+                ...fromRunner.map((record) => ({
+                    name: record.name,
+                    fromRunner: true,
+                    updatedAt: record.updatedAt,
+                    updatedById: record.updatedById,
+                    updatedByName: by(record.updatedById),
+                })),
+            ].sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+        },
+        set: (target, name, value, userId, options = {}) => tx.run(async ({ conn }) => {
+            if (options.fromRunner === true) {
+                if (value !== undefined)
+                    throw invalid('A variable taken from the runner has no value here; leave the value out.', { reason: 'valueNotAllowed' });
+                if (options.teamRunnersOnly === true)
+                    throw invalid('A variable taken from the runner never leaves the runner; it cannot be for team runners only.', { reason: 'teamRunnersOnlyNotAllowed' });
+                const change = await setFromRunner(conn, target, name, userId);
+                await audit(conn, target, { action: 'set', names: [name], userId });
+                await deps.onChange?.(conn, target, {
+                    name,
+                    change,
+                    byUserId: userId,
+                });
+                return;
+            }
+            const taken = await runnerVariables(conn).findOne({
+                filter: { scope: target.scope, scopeId: target.scopeId, name },
+            });
+            if (taken && value === undefined)
+                throw invalid('This variable is taken from the runner; give it a value to keep one here instead.', { reason: 'valueRequired' });
+            const existing = await secrets(conn).findOne({
+                filter: { scope: target.scope, scopeId: target.scopeId, name },
+            });
+            if (value === undefined && !existing)
+                throw invalid('A new variable needs a value.', {
+                    reason: 'valueRequired',
+                });
+            if (value !== undefined)
+                checkVariable(name, value, cli);
+            if (taken)
+                await runnerVariables(conn).deleteMany({ filter: { id: taken.id } });
+            const sealed = value === undefined
+                ? undefined
+                : box.seal(value, variableAad({ ...target, name }));
+            const now = clock.now().toISOString();
+            if (existing)
+                await secrets(conn).updateMany({
+                    filter: { id: existing.id },
+                    values: {
+                        ...(sealed === undefined ? {} : { valueEncrypted: sealed }),
+                        ...(options.teamRunnersOnly === undefined
+                            ? {}
+                            : { teamRunnersOnly: options.teamRunnersOnly }),
+                        updatedById: userId,
+                        updatedAt: now,
+                    },
+                });
+            else
+                await secrets(conn).createOne({
+                    values: {
+                        id: ids.next(),
+                        scope: target.scope,
+                        scopeId: target.scopeId,
+                        name,
+                        valueEncrypted: sealed,
+                        teamRunnersOnly: options.teamRunnersOnly ?? false,
+                        createdById: userId,
+                        updatedById: userId,
+                        createdAt: now,
+                        updatedAt: now,
+                    },
+                });
+            await audit(conn, target, { action: 'set', names: [name], userId });
+            await deps.onChange?.(conn, target, {
+                name,
+                change: existing || taken ? 'changed' : 'added',
+                byUserId: userId,
+            });
+        }),
+        remove: (target, name, userId) => tx.run(async ({ conn }) => {
+            const filter = { scope: target.scope, scopeId: target.scopeId, name };
+            const existing = await secrets(conn).findOne({ filter });
+            const taken = await runnerVariables(conn).findOne({ filter });
+            if (!existing && !taken)
+                throw notFound('Variable');
+            if (existing)
+                await secrets(conn).deleteMany({ filter: { id: existing.id } });
+            if (taken)
+                await runnerVariables(conn).deleteMany({ filter: { id: taken.id } });
+            await audit(conn, target, { action: 'delete', names: [name], userId });
+            await deps.onChange?.(conn, target, {
+                name,
+                change: 'removed',
+                byUserId: userId,
+            });
+        }),
+        reveal: (target, userId) => tx.run(async ({ conn }) => {
+            const records = await of(conn, target);
+            const values = records.map((record) => ({
+                name: record.name,
+                value: open(record),
+            }));
+            if (values.length > 0)
+                await audit(conn, target, {
+                    action: 'reveal',
+                    names: values.map((value) => value.name),
+                    userId,
+                });
+            return values;
+        }),
+        async audits(target, limit = 50, cursor) {
+            const conn = tx.read();
+            const records = await audits(conn).findMany({
+                filter: { scope: target.scope, scopeId: target.scopeId },
+                sort: (sort) => [sort.field('at').desc(), sort.field('id').desc()],
+                limit,
+                ...(cursor ? { cursor } : {}),
+            });
+            const names = await people.names(conn, records.map((record) => record.userId));
+            return records.map((record) => ({
+                id: record.id,
+                at: record.at,
+                action: record.action,
+                names: stringArray(record.names),
+                userId: record.userId,
+                userName: record.userId ? (names.get(record.userId) ?? null) : null,
+                runId: record.runId,
+                jobId: record.jobId,
+                runnerId: record.runnerId,
+            }));
+        },
+        async clear(conn, target) {
+            const filter = { scope: target.scope, scopeId: target.scopeId };
+            await secrets(conn).deleteMany({ filter });
+            await runnerVariables(conn).deleteMany({ filter });
+        },
+        async namesOf(conn, targets) {
+            return [...(await merge(conn, targets))]
+                .filter(([, entry]) => entry.kind === 'value')
+                .map(([name]) => name)
+                .sort();
+        },
+        async teamOnly(conn, targets) {
+            const refs = [];
+            for (const [name, entry] of await merge(conn, targets))
+                if (entry.kind === 'value' && entry.record.teamRunnersOnly)
+                    refs.push({
+                        scope: entry.target.scope,
+                        scopeId: entry.target.scopeId,
+                        name,
+                    });
+            return refs;
+        },
+        passthroughOf,
+        async holding(conn, targets) {
+            const held = [];
+            for (const target of targets)
+                if ((await secrets(conn).count({
+                    filter: { scope: target.scope, scopeId: target.scopeId },
+                })) > 0)
+                    held.push(target);
+            return held;
+        },
+        async forRun(conn, targets, delivery) {
+            const fromRunner = new Set(await passthroughOf(conn, targets));
+            const merged = new Map();
+            for (const target of targets) {
+                const records = (await of(conn, target)).filter((record) => !fromRunner.has(record.name));
+                if (records.length === 0)
+                    continue;
+                for (const record of records)
+                    merged.set(record.name, open(record));
+                await audit(conn, target, {
+                    action: 'deliver',
+                    names: records.map((record) => record.name),
+                    runId: delivery.runId,
+                    runnerId: delivery.runnerId,
+                });
+            }
+            return [...merged].map(([name, value]) => ({ name, value }));
+        },
+        async forJob(conn, refs, delivery) {
+            const values = new Map();
+            const byTarget = new Map();
+            const selected = [];
+            for (const ref of refs) {
+                const key = `${ref.scope}\u0000${ref.scopeId}`;
+                byTarget.set(key, [...(byTarget.get(key) ?? []), ref]);
+            }
+            for (const wanted of byTarget.values()) {
+                const target = { scope: wanted[0].scope, scopeId: wanted[0].scopeId };
+                const names = new Set(wanted.map((ref) => ref.name));
+                const records = (await of(conn, target)).filter((record) => names.has(record.name));
+                if (records.length === 0)
+                    continue;
+                selected.push({ target, records });
+            }
+            if (selected.some(({ records }) => records.some((record) => record.teamRunnersOnly))) {
+                const runner = await runnersRepo(conn).findOne({
+                    filter: { id: delivery.runnerId },
+                });
+                if (runner?.trust !== 'team')
+                    throw new JobSecretsNotAllowed();
+            }
+            for (const { target, records } of selected) {
+                for (const record of records)
+                    values.set(`${target.scope}\u0000${target.scopeId}\u0000${record.name}`, open(record));
+                await audit(conn, target, {
+                    action: 'deliver',
+                    names: records.map((record) => record.name),
+                    jobId: delivery.jobId,
+                    runnerId: delivery.runnerId,
+                });
+            }
+            return values;
+        },
+    };
+}
+//# sourceMappingURL=variable.service.js.map

package/dist/server/core/variables/variable.service.js.map

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

package/dist/server/distribution/dist.service.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Distribution: the runner (`nocobase-runner`) and the application's CLI (such as `acme`), served by the application
+ * itself as tarballs, so nothing is published to a registry: one per target, each bundling Node, or one for every
+ * target (`UNIVERSAL_TARGET`, `nocobase cli build --universal`) that runs on the machine's own Node.js 24 or newer.
+ *
+ * `nocobase cli build` of `@nocobase/app-cli` (`--runner` for the runner) builds each product into a directory of its
+ * own, with its own manifest, so the products are built and mounted apart (in CI, one artifact each):
+ *
+ *   <dir>/<channel>/<product>/manifest.json
+ *   <dir>/<channel>/<product>/<version>/<product>-v<version>-<target>.tar.gz
+ *
+ * where a product's manifest lists its versions with each target's file (relative to the product's directory),
+ * SHA-256 and size. A target without a file of its own gets the version's universal one, if it has one, answered with
+ * `universal: true`; a file built for the target wins over it. The application serves one channel (`agents.dist.channel`, `stable` by default); a product's
+ * current version is the one `agents.dist.versions` pins, or the highest the channel has. Only files a manifest lists
+ * are ever served.
+ *
+ * A product the directory has no current version of may instead be named on the npm registry (`agents.dist.npm`: its
+ * package and exact version), answered only to callers that understand it (`npmPackage`). The directory always wins.
+ */
+import { type ReadStream } from 'node:fs';
+import { type DistArtifact, type DistManifest, type DistNpmPackage } from '@nocobase/agent-protocol';
+/** `agents.dist` in the application's configuration. */
+export interface DistConfig {
+    /** Where the built tarballs are; `storage/runners/dist` of the application by default. */
+    readonly dir?: string;
+    /** Which channel to serve: `stable` by default. */
+    readonly channel?: string;
+    /** A version to serve per product instead of the channel's highest, such as `{ acme: '0.3.1' }`. */
+    readonly versions?: Readonly<Record<string, string>>;
+    /**
+     * The npm package and exact version each product is published as, such as
+     * `{ 'nocobase-runner': { package: '@nocobase/agent-runner', version: '1.0.0' } }`: answered instead of a tarball
+     * only when `dir` has no current version of the product, and only to callers that understand it (`DistNpmPackage`).
+     */
+    readonly npm?: Readonly<Record<string, DistNpmSource>>;
+}
+/** One product of `DistConfig.npm`. */
+export interface DistNpmSource {
+    readonly package: string;
+    /** An exact version, never a range. */
+    readonly version: string;
+}
+export declare const DEFAULT_CHANNEL = "stable";
+/** A file the application may serve, found through the manifest. */
+export interface DistFile {
+    /** The platform it is built for: `UNIVERSAL_TARGET` for the one that serves every platform. */
+    readonly target: string;
+    readonly path: string;
+    readonly sha256: string;
+    readonly size: number;
+    open(): ReadStream;
+}
+export interface DistService {
+    readonly channel: string;
+    /** What the channel serves now; empty when nothing was built. */
+    manifest(): Promise<DistManifest>;
+    /** The current `product` for `target`, or null. */
+    find(product: string, target: string): Promise<DistArtifact | null>;
+    /** Like `find`, but 404: `PLATFORM_UNSUPPORTED` with the targets there are, or `NOT_FOUND` for no such product. */
+    resolve(product: string, target: string): Promise<DistArtifact>;
+    /** A file the manifest lists (any version on the channel); 404 otherwise. */
+    file(product: string, version: string, name: string): Promise<DistFile>;
+    /**
+     * The npm package to install `product` from (`DistConfig.npm`), or null when none is configured or the directory has
+     * a current version of the product, which is then served as a tarball exactly as without it. Only for callers that
+     * understand the answer: the resolve route's `accept=npm`, a runner with the `npm` feature.
+     */
+    npmPackage(product: string): Promise<DistNpmPackage | null>;
+}
+export declare function createDistService(config?: DistConfig): DistService;
+//# sourceMappingURL=dist.service.d.ts.map

package/dist/server/distribution/dist.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dist.service.d.ts","sourceRoot":"","sources":["../../../server/distribution/dist.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAI5D,OAAO,EASL,KAAK,YAAY,EACjB,KAAK,YAAY,EAEjB,KAAK,cAAc,EACpB,MAAM,0BAA0B,CAAC;AAKlC,wDAAwD;AACxD,MAAM,WAAW,UAAU;IACzB,0FAA0F;IAC1F,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,oGAAoG;IACpG,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;CACxD;AAED,uCAAuC;AACvC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uCAAuC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAUD,eAAO,MAAM,eAAe,WAAW,CAAC;AA6BxC,oEAAoE;AACpE,MAAM,WAAW,QAAQ;IACvB,+FAA+F;IAC/F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,IAAI,IAAI,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IAClC,mDAAmD;IACnD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IACpE,mHAAmH;IACnH,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAChE,6EAA6E;IAC7E,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxE;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CAC7D;AAED,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,UAAe,GAAG,WAAW,CA+MtE"}