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

package/dist/server/core/runs/workload.js

@@ -0,0 +1,281 @@
+import { entryTools } from '../../../shared/agents.js';
+import { runsTool, toolLimit } from '../../../shared/runners.js';
+import { RUN_ACTIVITY_TEXT_MAX, } from '../../../shared/runs.js';
+import { covers } from '../../kernel/values.js';
+import { listAgents } from '../agents/index.js';
+import { ACTIVE, eventsRepo, inputsRepo, runsRepo, toRun, } from './run.store.js';
+const DEFAULT_LIMIT = 200;
+const MAX_LIMIT = 1000;
+/** Queued runs read for the claim order, of every kind. */
+const QUEUE_SCAN = 2000;
+/** The event types a "last activity" line is made of. */
+const ACTIVITY_TYPES = ['text', 'toolUse', 'status', 'error'];
+const time = (value) => value === null ? null : new Date(value).getTime();
+const iso = (value) => value === null ? null : new Date(value).toISOString();
+/** Claim order: the more urgent first, then the oldest, then by id. */
+export function claimOrder(a, b) {
+    return (Number(a.priority) - Number(b.priority) ||
+        (time(a.createdAt) ?? 0) - (time(b.createdAt) ?? 0) ||
+        a.id.localeCompare(b.id));
+}
+const wait = (reason, extra = {}) => ({
+    reason,
+    until: null,
+    tool: null,
+    missing: [],
+    detail: null,
+    ...extra,
+});
+/**
+ * Why a queued run has not been taken, by the claim's rules in the claim's order (`RUN_WAIT_REASONS`); the first rule
+ * that holds it answers.
+ */
+export function explainWait(run, context) {
+    const { agent } = context;
+    if (!agent || agent.archivedAt)
+        return wait('agentArchived');
+    const availableAt = time(run.availableAt);
+    if (availableAt !== null && availableAt > context.now.getTime())
+        return wait('delayed', { until: iso(run.availableAt) });
+    // An online run needs no runner: the application takes it as soon as an instance looks.
+    if (agent.type === 'online')
+        return wait('next');
+    const tools = entryTools(agent);
+    const tool = tools[0] ?? null;
+    let fitting = context.runners;
+    if (fitting.length === 0)
+        return wait('noRunnerOnline');
+    if (agent.runnerIds.length > 0) {
+        fitting = fitting.filter((runner) => agent.runnerIds.includes(runner.id));
+        if (fitting.length === 0)
+            return wait('runnersOffline');
+    }
+    fitting = fitting.filter((runner) => tools.some((each) => runsTool(runner, each)));
+    if (fitting.length === 0)
+        return wait('toolUnavailable', { tool });
+    fitting = fitting.filter((runner) => runner.trust === 'team' || runner.ownerUserId === run.actorUserId);
+    if (fitting.length === 0)
+        return wait('noSharedRunner');
+    const withFeatures = fitting.filter((runner) => covers(runner.features, run.requires));
+    if (withFeatures.length === 0) {
+        const offered = new Set(fitting.flatMap((runner) => runner.features));
+        return wait('missingFeatures', {
+            missing: run.requires.filter((feature) => !offered.has(feature)),
+        });
+    }
+    if (context.sameWorkActive)
+        return wait('sameWorkActive');
+    if (context.agentActive >= agent.maxConcurrentRuns)
+        return wait('concurrencyFull');
+    const free = withFeatures.filter((runner) => (context.runnerUsed.get(runner.id) ?? 0) < runner.slots);
+    if (free.length === 0)
+        return wait('runnersBusy');
+    // A tool has room on a runner below its limit here and while the runner last said it could take more of it.
+    const hasRoom = (runner, each) => (context.runnerToolUsed?.get(runner.id)?.[each] ?? 0) <
+        toolLimit(runner, each) && (runner.toolLoad?.[each]?.free ?? 1) > 0;
+    if (free.every((runner) => !tools.some((each) => runsTool(runner, each) && hasRoom(runner, each))))
+        return wait('toolSlotsFull', {
+            tool: tools.find((each) => free.some((runner) => runsTool(runner, each))) ??
+                null,
+        });
+    if (Number(run.claimFailures) > 0)
+        return wait('setupRetrying', { detail: run.failureDetail });
+    return wait('next');
+}
+const keyOf = (run) => JSON.stringify([
+    run.agentId,
+    run.subjectKind,
+    run.subjectId,
+    run.threadScope,
+]);
+function triggerOf(payload) {
+    const value = typeof payload === 'string'
+        ? (() => {
+            try {
+                return JSON.parse(payload);
+            }
+            catch {
+                return null;
+            }
+        })()
+        : payload;
+    if (value && typeof value === 'object' && !Array.isArray(value)) {
+        const trigger = value.trigger;
+        if (typeof trigger === 'string' && trigger !== '')
+            return trigger;
+    }
+    return null;
+}
+function cut(text) {
+    if (!text)
+        return null;
+    const line = text.replace(/\s+/gu, ' ').trim();
+    if (line === '')
+        return null;
+    return line.length > RUN_ACTIVITY_TEXT_MAX
+        ? `${line.slice(0, RUN_ACTIVITY_TEXT_MAX - 1)}…`
+        : line;
+}
+export async function readWorkload(conn, clock, runnerSource, query) {
+    const now = clock.now();
+    const limit = Math.min(Math.max(query.limit ?? DEFAULT_LIMIT, 1), MAX_LIMIT);
+    const open = await runsRepo(conn).findMany({
+        filter: (f) => f.and([
+            f.string('subjectKind').eq(query.subjectKind),
+            f.or(['queued', ...ACTIVE].map((status) => f.string('status').eq(status))),
+        ]),
+        sort: (sort) => [sort.field('createdAt').asc(), sort.field('id').asc()],
+        limit: limit + 1,
+    });
+    const truncated = open.length > limit;
+    const mine = open.slice(0, limit);
+    const queued = (await runsRepo(conn).findMany({
+        filter: { status: 'queued' },
+        limit: QUEUE_SCAN,
+    })).sort(claimOrder);
+    const held = await runsRepo(conn).findMany({
+        filter: (f) => f.or(ACTIVE.map((status) => f.string('status').eq(status))),
+    });
+    const runners = await runnerSource.all(conn);
+    const online = runners.filter((runner) => runner.status === 'online');
+    const jobs = await runnerSource.jobsByRunner(conn);
+    const agents = await listAgents(conn, true);
+    const agentById = new Map(agents.map((agent) => [agent.id, agent]));
+    const runnerUsed = new Map();
+    const runnerToolUsed = new Map();
+    const agentActive = new Map();
+    const busyKeys = new Set();
+    for (const run of held) {
+        if (run.runnerId) {
+            runnerUsed.set(run.runnerId, (runnerUsed.get(run.runnerId) ?? 0) + 1);
+            const tool = run.tool;
+            if (tool) {
+                const counts = runnerToolUsed.get(run.runnerId) ?? {};
+                counts[tool] = (counts[tool] ?? 0) + 1;
+                runnerToolUsed.set(run.runnerId, counts);
+            }
+        }
+        agentActive.set(run.agentId, (agentActive.get(run.agentId) ?? 0) + 1);
+        busyKeys.add(keyOf(run));
+    }
+    for (const [runnerId, count] of jobs)
+        runnerUsed.set(runnerId, (runnerUsed.get(runnerId) ?? 0) + count);
+    // Places in the claim order: among the runs claimable now, and among each agent's queued runs.
+    const position = new Map();
+    const agentPosition = new Map();
+    const agentQueued = new Map();
+    let claimable = 0;
+    for (const run of queued) {
+        const at = time(run.availableAt);
+        if (at === null || at <= now.getTime())
+            position.set(run.id, (claimable += 1));
+        const count = (agentQueued.get(run.agentId) ?? 0) + 1;
+        agentQueued.set(run.agentId, count);
+        agentPosition.set(run.id, count);
+    }
+    // The newest input's trigger, per open run.
+    const ids = mine.map((run) => run.id);
+    const triggers = new Map();
+    if (ids.length > 0) {
+        const inputs = await inputsRepo(conn).findMany({
+            filter: (f) => f.or(ids.map((id) => f.string('runId').eq(id))),
+            sort: (sort) => [sort.field('createdAt').desc(), sort.field('id').desc()],
+        });
+        for (const input of inputs) {
+            if (triggers.has(input.runId))
+                continue;
+            const trigger = triggerOf(input.payload);
+            if (trigger)
+                triggers.set(input.runId, trigger);
+        }
+    }
+    // The newest activity of each held run: at most one per runner slot.
+    const activity = new Map();
+    for (const run of mine) {
+        if (!ACTIVE.includes(run.status))
+            continue;
+        const event = await eventsRepo(conn).findOne({
+            filter: (f) => f.and([
+                f.string('runId').eq(run.id),
+                f.or(ACTIVITY_TYPES.map((type) => f.string('type').eq(type))),
+            ]),
+            sort: (sort) => sort.field('seq').desc(),
+        });
+        if (event)
+            activity.set(run.id, {
+                at: iso(event.at) ?? event.at,
+                type: event.type,
+                tool: event.tool,
+                text: cut(event.content ?? event.output),
+            });
+    }
+    const runnerName = new Map(runners.map((runner) => [runner.id, runner.name]));
+    const runs = mine.map((record) => {
+        const run = toRun(record);
+        const isQueued = record.status === 'queued';
+        return {
+            ...run,
+            trigger: triggers.get(run.id) ?? null,
+            runnerName: run.runnerId ? (runnerName.get(run.runnerId) ?? null) : null,
+            lastActivity: activity.get(run.id) ?? null,
+            wait: isQueued
+                ? {
+                    ...explainWait({ ...record, requires: run.requires }, {
+                        now,
+                        agent: agentById.get(run.agentId) ?? null,
+                        runners: online,
+                        runnerUsed,
+                        runnerToolUsed,
+                        agentActive: agentActive.get(run.agentId) ?? 0,
+                        sameWorkActive: busyKeys.has(keyOf(record)),
+                    }),
+                    position: position.get(run.id) ?? null,
+                    agentPosition: agentPosition.get(run.id) ?? 1,
+                }
+                : null,
+        };
+    });
+    // Held runs first, the longest-running first; then queued ones in claim order.
+    const order = new Map(queued.map((run, index) => [run.id, index]));
+    runs.sort((a, b) => {
+        const aQueued = a.status === 'queued';
+        const bQueued = b.status === 'queued';
+        if (aQueued !== bQueued)
+            return aQueued ? 1 : -1;
+        if (aQueued)
+            return ((order.get(a.id) ?? Number.MAX_SAFE_INTEGER) -
+                (order.get(b.id) ?? Number.MAX_SAFE_INTEGER));
+        return 0;
+    });
+    const loads = [];
+    const agentsWithRuns = new Set(mine.map((run) => run.agentId));
+    for (const agent of agents) {
+        if (agent.archivedAt && !agentsWithRuns.has(agent.id))
+            continue;
+        loads.push({
+            agentId: agent.id,
+            active: agentActive.get(agent.id) ?? 0,
+            queued: agentQueued.get(agent.id) ?? 0,
+            maxConcurrentRuns: agent.maxConcurrentRuns,
+            // An online agent needs no runner; whether its model is offered is the availability's business.
+            online: !agent.archivedAt &&
+                (agent.type === 'online' ||
+                    online.some((runner) => entryTools(agent).some((tool) => runsTool(runner, tool)) &&
+                        (agent.runnerIds.length === 0 ||
+                            agent.runnerIds.includes(runner.id)))),
+        });
+    }
+    return {
+        runs,
+        truncated,
+        agents: loads,
+        runners: {
+            online: online.length,
+            busy: online.filter((runner) => (runnerUsed.get(runner.id) ?? 0) > 0)
+                .length,
+            slots: online.reduce((sum, runner) => sum + runner.slots, 0),
+            used: online.reduce((sum, runner) => sum + Math.min(runnerUsed.get(runner.id) ?? 0, runner.slots), 0),
+        },
+    };
+}
+//# sourceMappingURL=workload.js.map

package/dist/server/core/runs/workload.js.map

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

package/dist/server/core/runs/workspace.store.d.ts

@@ -0,0 +1,23 @@
+/**
+ * What a claim keeps besides the run: the brief it was given (`agRunBriefs`, one per run, the latest attempt's), and
+ * the requests to start a subject's work from a fresh working directory (`agWorkspaceResets`).
+ */
+import type { DatabaseConnection } from '@nocobase/db';
+import type { RunBrief } from '../../../shared/briefs.js';
+/** Keeps `brief` as the run's, replacing an earlier attempt's. */
+export declare function saveBrief(conn: DatabaseConnection, id: () => string, brief: RunBrief): Promise<void>;
+export declare function findBrief(conn: DatabaseConnection, runId: string): Promise<RunBrief | null>;
+/**
+ * Asks for the subject's next run to start from a fresh working directory, and forgets the sessions on it, which
+ * lived in the old one.
+ */
+export declare function requestReset(conn: DatabaseConnection, id: () => string, subject: {
+    readonly kind: string;
+    readonly id: string;
+}, userId: string | null, now: string): Promise<void>;
+/** Whether a reset waits for the subject; marks every waiting one delivered to `runId`. */
+export declare function consumeReset(conn: DatabaseConnection, subject: {
+    readonly kind: string;
+    readonly id: string;
+}, runId: string, now: string): Promise<boolean>;
+//# sourceMappingURL=workspace.store.d.ts.map

package/dist/server/core/runs/workspace.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.store.d.ts","sourceRoot":"","sources":["../../../../server/core/runs/workspace.store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAc,MAAM,cAAc,CAAC;AAEnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAkC1D,kEAAkE;AAClE,wBAAsB,SAAS,CAC7B,IAAI,EAAE,kBAAkB,EACxB,EAAE,EAAE,MAAM,MAAM,EAChB,KAAK,EAAE,QAAQ,GACd,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,wBAAsB,SAAS,CAC7B,IAAI,EAAE,kBAAkB,EACxB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAgB1B;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,kBAAkB,EACxB,EAAE,EAAE,MAAM,MAAM,EAChB,OAAO,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,EACvD,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,2FAA2F;AAC3F,wBAAsB,YAAY,CAChC,IAAI,EAAE,kBAAkB,EACxB,OAAO,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,EACvD,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,OAAO,CAAC,CAWlB"}

package/dist/server/core/runs/workspace.store.js

@@ -0,0 +1,77 @@
+import { sessionsRepo } from './run.store.js';
+function briefsRepo(conn) {
+    return conn.repository('agRunBriefs');
+}
+function resetsRepo(conn) {
+    return conn.repository('agWorkspaceResets');
+}
+/** Keeps `brief` as the run's, replacing an earlier attempt's. */
+export async function saveBrief(conn, id, brief) {
+    await briefsRepo(conn).deleteMany({ filter: { runId: brief.runId } });
+    await briefsRepo(conn).createOne({
+        values: {
+            id: id(),
+            runId: brief.runId,
+            attempt: brief.attempt,
+            system: brief.layers.system,
+            task: brief.layers.task,
+            context: brief.layers.context,
+            agent: brief.layers.agent,
+            turn: brief.turn,
+            prompt: brief.prompt,
+            createdAt: brief.createdAt,
+        },
+    });
+}
+export async function findBrief(conn, runId) {
+    const record = await briefsRepo(conn).findOne({ filter: { runId } });
+    if (!record)
+        return null;
+    return {
+        runId: record.runId,
+        attempt: Number(record.attempt),
+        layers: {
+            system: record.system,
+            task: record.task,
+            context: record.context,
+            agent: record.agent,
+        },
+        turn: record.turn,
+        prompt: record.prompt,
+        createdAt: record.createdAt,
+    };
+}
+/**
+ * Asks for the subject's next run to start from a fresh working directory, and forgets the sessions on it, which
+ * lived in the old one.
+ */
+export async function requestReset(conn, id, subject, userId, now) {
+    await resetsRepo(conn).createOne({
+        values: {
+            id: id(),
+            subjectKind: subject.kind,
+            subjectId: subject.id,
+            requestedById: userId,
+            requestedAt: now,
+            consumedByRunId: null,
+            consumedAt: null,
+        },
+    });
+    await sessionsRepo(conn).updateMany({
+        filter: { subjectKind: subject.kind, subjectId: subject.id },
+        values: { poisoned: true, updatedAt: now },
+    });
+}
+/** Whether a reset waits for the subject; marks every waiting one delivered to `runId`. */
+export async function consumeReset(conn, subject, runId, now) {
+    const result = await resetsRepo(conn).updateMany({
+        filter: (f) => f.and([
+            f.string('subjectKind').eq(subject.kind),
+            f.string('subjectId').eq(subject.id),
+            f.date('consumedAt').empty(),
+        ]),
+        values: { consumedByRunId: runId, consumedAt: now },
+    });
+    return result.updatedCount > 0;
+}
+//# sourceMappingURL=workspace.store.js.map

package/dist/server/core/runs/workspace.store.js.map

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

package/dist/server/core/skills/blobs.d.ts

@@ -0,0 +1,65 @@
+import type { DatabaseConnection } from '@nocobase/db';
+import type { Clock } from '../../kernel/clock.js';
+import type { TxRunner } from '../../kernel/tx.js';
+/** Where blobs are kept: the application's drive (a flydrive disk), or memory in tests. */
+export interface SkillDisk {
+    put(key: string, contents: Uint8Array): Promise<void>;
+    getBytes(key: string): Promise<Uint8Array>;
+    delete(key: string): Promise<void>;
+}
+export interface BlobRecord {
+    readonly hash: string;
+    readonly size: number;
+    readonly text: boolean;
+    readonly createdAt: string;
+    readonly lastUsedAt: string;
+}
+export interface BlobInfo {
+    readonly hash: string;
+    readonly size: number;
+    readonly text: boolean;
+}
+/** A disk in memory, for tests and an application without a drive. */
+export declare function memoryDisk(): SkillDisk & {
+    readonly keys: () => string[];
+};
+/** A disk in a local directory, for an application without a drive. */
+export declare function directoryDisk(root: string): SkillDisk;
+export declare function blobKey(hash: string): string;
+export declare function sha256(bytes: Uint8Array | string): string;
+/** Whether `bytes` read as text: valid UTF-8 without NUL bytes. */
+export declare function isText(bytes: Uint8Array): boolean;
+/** A least-recently-used cache of values with a size, bounded by their total. */
+export declare class SizedCache<V> {
+    private readonly maxBytes;
+    private readonly entries;
+    private total;
+    constructor(maxBytes: number);
+    get(key: string): V | undefined;
+    set(key: string, value: V, size: number): void;
+}
+export interface SkillBlobs {
+    /** Stores `bytes` unless stored already, and marks them used now. */
+    store(bytes: Uint8Array): Promise<BlobInfo>;
+    /** What is recorded of `hashes`; a hash not stored is missing from the map. */
+    info(conn: DatabaseConnection, hashes: readonly string[]): Promise<Map<string, BlobInfo>>;
+    /** Marks `hashes` used now, so the collector spares them. */
+    touch(conn: DatabaseConnection, hashes: readonly string[]): Promise<void>;
+    /** The bytes of a stored blob. */
+    read(hash: string): Promise<Uint8Array>;
+    /**
+     * Deletes the blobs no version names that were last used before the grace period; the number deleted. `referenced`
+     * reads every hash versions name.
+     */
+    collect(referenced: (conn: DatabaseConnection) => Promise<Set<string>>, graceMs: number): Promise<number>;
+}
+export interface SkillBlobsDeps {
+    readonly tx: TxRunner;
+    readonly clock: Clock;
+    /** Asked on each use: the drive is resolved when the first blob is stored or read. */
+    readonly disk: () => SkillDisk;
+    /** Bytes of blobs kept in memory for reads; 32 MB by default. */
+    readonly cacheBytes?: number;
+}
+export declare function createSkillBlobs(deps: SkillBlobsDeps): SkillBlobs;
+//# sourceMappingURL=blobs.d.ts.map

package/dist/server/core/skills/blobs.d.ts.map

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