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

package/dist/server/core/runs/runner-view.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Agent runs as the runner pages see them: how many runs each runner holds (its slots count them beside its jobs),
+ * which agents each runner may run (`takes`), which runs one holds (`held`) and its latest runs (`recent`), without the
+ * subject's link of a private kind's run the viewer is not part of. `runnerForViewer` leaves out what identifies a
+ * runner's machine for those who may not see it.
+ */
+import type { AgentTool } from '@nocobase/agent-protocol';
+import type { DatabaseConnection } from '@nocobase/db';
+import { type Runner, type RunnerHeldItem, type RunnerRecentRun, type RunnerWorkTarget } from '../../../shared/runners.js';
+import type { AgentService } from '../agents/agent.service.js';
+import type { TxRunner } from '../../kernel/tx.js';
+import type { SubjectRegistry } from './ports.js';
+/** How many runs each of `runnerIds` holds now; they take its slots. */
+export declare function runsHeldBy(conn: DatabaseConnection, runnerIds: readonly string[]): Promise<ReadonlyMap<string, number>>;
+/**
+ * The runs `runnerId` holds now, by the coding tool each runs with (set when it was claimed); a tool it runs nothing of
+ * is left out. A tool's limit (`Runner.toolSlots`) counts them.
+ */
+export declare function runsHeldByTool(conn: DatabaseConnection, runnerId: string): Promise<Partial<Record<AgentTool, number>>>;
+/** How many of a runner's latest runs its page shows. */
+export declare const RECENT_RUNS = 10;
+/** What a runner shows its viewer of its machine. */
+export interface RunnerMachineView {
+    readonly canSeeMachine: boolean;
+    readonly hostname: string | null;
+    readonly tools: Runner['tools'];
+}
+/**
+ * The runner as `seesMachine` decides: its host name, where its tools are installed and where its working directories
+ * are name the machine and, through home directories, its user. Its owner, the managers of runners and those who may
+ * wake an agent see them (the routes decide); everyone else sees none of them, and of the working directories only
+ * their totals.
+ */
+export declare function runnerForViewer<T extends Runner>(runner: T, seesMachine: boolean): Omit<T, 'hostname' | 'tools'> & RunnerMachineView;
+export interface RunnerView {
+    /** What each of `runners` takes work for: the agents it may run, by what people configured and what it reported. */
+    takes(runners: readonly Runner[]): Promise<ReadonlyMap<string, readonly RunnerWorkTarget[]>>;
+    /** For a runner's page: the runs it holds now, as `viewerUserId` may see them. */
+    held(runner: Runner, viewerUserId: string): Promise<RunnerHeldItem[]>;
+    /** For a runner's page: its latest runs, newest first, as `viewerUserId` may see them. */
+    recent(runner: Runner, viewerUserId: string): Promise<RunnerRecentRun[]>;
+}
+export declare function createRunnerView(deps: {
+    readonly agents: Pick<AgentService, 'list' | 'names'>;
+    readonly subjects: Pick<SubjectRegistry, 'get'>;
+    readonly tx: TxRunner;
+}): RunnerView;
+//# sourceMappingURL=runner-view.d.ts.map

package/dist/server/core/runs/runner-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-view.d.ts","sourceRoot":"","sources":["../../../../server/core/runs/runner-view.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,EAEL,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIlD,wEAAwE;AACxE,wBAAsB,UAAU,CAC9B,IAAI,EAAE,kBAAkB,EACxB,SAAS,EAAE,SAAS,MAAM,EAAE,GAC3B,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CActC;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,kBAAkB,EACxB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,CAc7C;AAED,yDAAyD;AACzD,eAAO,MAAM,WAAW,KAAK,CAAC;AAE9B,qDAAqD;AACrD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;CACjC;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAC9C,MAAM,EAAE,CAAC,EACT,WAAW,EAAE,OAAO,GACnB,IAAI,CAAC,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,iBAAiB,CAWnD;AAED,MAAM,WAAW,UAAU;IACzB,oHAAoH;IACpH,KAAK,CACH,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC,CAAC,CAAC;IAC7D,kFAAkF;IAClF,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACtE,0FAA0F;IAC1F,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;CAC1E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IACtD,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IAChD,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;CACvB,GAAG,UAAU,CAyEb"}

package/dist/server/core/runs/runner-view.js

@@ -0,0 +1,121 @@
+import { runnerTakesAgent, } from '../../../shared/runners.js';
+import { ACTIVE, runsRepo, toRun } from './run.store.js';
+/** How many runs each of `runnerIds` holds now; they take its slots. */
+export async function runsHeldBy(conn, runnerIds) {
+    const counts = new Map();
+    if (runnerIds.length === 0)
+        return counts;
+    const held = await runsRepo(conn).findMany({
+        filter: (f) => f.and([
+            f.or(runnerIds.map((id) => f.string('runnerId').eq(id))),
+            f.or(ACTIVE.map((status) => f.string('status').eq(status))),
+        ]),
+    });
+    for (const run of held)
+        if (run.runnerId)
+            counts.set(run.runnerId, (counts.get(run.runnerId) ?? 0) + 1);
+    return counts;
+}
+/**
+ * The runs `runnerId` holds now, by the coding tool each runs with (set when it was claimed); a tool it runs nothing of
+ * is left out. A tool's limit (`Runner.toolSlots`) counts them.
+ */
+export async function runsHeldByTool(conn, runnerId) {
+    const held = await runsRepo(conn).findMany({
+        filter: (f) => f.and([
+            f.string('runnerId').eq(runnerId),
+            f.or(ACTIVE.map((status) => f.string('status').eq(status))),
+        ]),
+    });
+    const counts = {};
+    for (const run of held) {
+        const tool = run.tool;
+        if (tool)
+            counts[tool] = (counts[tool] ?? 0) + 1;
+    }
+    return counts;
+}
+/** How many of a runner's latest runs its page shows. */
+export const RECENT_RUNS = 10;
+/**
+ * The runner as `seesMachine` decides: its host name, where its tools are installed and where its working directories
+ * are name the machine and, through home directories, its user. Its owner, the managers of runners and those who may
+ * wake an agent see them (the routes decide); everyone else sees none of them, and of the working directories only
+ * their totals.
+ */
+export function runnerForViewer(runner, seesMachine) {
+    if (seesMachine)
+        return { ...runner, canSeeMachine: true };
+    return {
+        ...runner,
+        canSeeMachine: false,
+        hostname: null,
+        tools: runner.tools.map(({ path: _path, ...tool }) => tool),
+        ...(runner.workspaceUsage
+            ? { workspaceUsage: { ...runner.workspaceUsage, workspaces: [] } }
+            : {}),
+    };
+}
+export function createRunnerView(deps) {
+    const agentNames = (runs) => deps.agents.names(deps.tx.read(), runs.map((run) => run.agentId));
+    /** The subject's link of `run`, or null when it has none or the viewer is not part of a private kind's run. */
+    const pathOf = (run, viewerUserId) => {
+        const binding = deps.subjects.get(run.subject.kind);
+        const hidden = binding?.private === true &&
+            run.actorUserId !== viewerUserId &&
+            run.ownerUserId !== viewerUserId;
+        return !hidden && binding?.path
+            ? binding.path.replaceAll('{id}', encodeURIComponent(run.subject.id))
+            : null;
+    };
+    return {
+        async takes(runners) {
+            const agents = (await deps.agents.list()).filter((agent) => agent.status === 'enabled');
+            return new Map(runners.map((runner) => [
+                runner.id,
+                agents
+                    .filter((agent) => runnerTakesAgent(runner, agent))
+                    .map((agent) => ({ id: agent.id, name: agent.name })),
+            ]));
+        },
+        async held(runner, viewerUserId) {
+            const records = await runsRepo(deps.tx.read()).findMany({
+                filter: (f) => f.and([
+                    f.string('runnerId').eq(runner.id),
+                    f.or(ACTIVE.map((status) => f.string('status').eq(status))),
+                ]),
+                sort: (sort) => [sort.field('createdAt').asc(), sort.field('id').asc()],
+            });
+            const names = await agentNames(records);
+            return records.map(toRun).map((run) => ({
+                id: run.id,
+                kind: 'run',
+                title: names.get(run.agentId) ?? run.agentId,
+                status: run.status === 'running' ? 'running' : 'dispatched',
+                startedAt: run.startedAt ?? run.dispatchedAt,
+                path: pathOf(run, viewerUserId),
+            }));
+        },
+        async recent(runner, viewerUserId) {
+            const records = await runsRepo(deps.tx.read()).findMany({
+                filter: (f) => f.string('runnerId').eq(runner.id),
+                sort: (sort) => [
+                    sort.field('createdAt').desc(),
+                    sort.field('id').desc(),
+                ],
+                limit: RECENT_RUNS,
+            });
+            const names = await agentNames(records);
+            return records.map(toRun).map((run) => ({
+                id: run.id,
+                title: names.get(run.agentId) ?? run.agentId,
+                status: run.status,
+                startedAt: run.startedAt ?? run.dispatchedAt,
+                finishedAt: run.finishedAt,
+                createdAt: run.createdAt,
+                path: pathOf(run, viewerUserId),
+            }));
+        },
+    };
+}
+//# sourceMappingURL=runner-view.js.map

package/dist/server/core/runs/runner-view.js.map

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

package/dist/server/core/runs/selection.d.ts

@@ -0,0 +1,13 @@
+/** Optional ordered-model policy. Selection stays inside the existing claim transaction. */
+import type { DatabaseConnection } from '@nocobase/db';
+import type { Run } from '../../../shared/runs.js';
+export interface ModelSelectionPolicy {
+    readonly fallbackAfterSeconds: number;
+}
+export interface ModelSelectionPolicies {
+    register(agentId: string, policy: (conn: DatabaseConnection, run: Run) => Promise<ModelSelectionPolicy>): () => void;
+    forRun(conn: DatabaseConnection, run: Run): Promise<ModelSelectionPolicy | null>;
+}
+export declare function createModelSelectionPolicies(): ModelSelectionPolicies;
+export declare function queueStart(run: Pick<Run, 'queueEnteredAt' | 'createdAt' | 'availableAt'>): number;
+//# sourceMappingURL=selection.d.ts.map

package/dist/server/core/runs/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../../../server/core/runs/selection.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,yBAAyB,CAAC;AAEnD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;CACvC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CACN,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,CACN,IAAI,EAAE,kBAAkB,EACxB,GAAG,EAAE,GAAG,KACL,OAAO,CAAC,oBAAoB,CAAC,GACjC,MAAM,IAAI,CAAC;IACd,MAAM,CACJ,IAAI,EAAE,kBAAkB,EACxB,GAAG,EAAE,GAAG,GACP,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;CACzC;AAED,wBAAgB,4BAA4B,IAAI,sBAAsB,CAkBrE;AAED,wBAAgB,UAAU,CACxB,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,gBAAgB,GAAG,WAAW,GAAG,aAAa,CAAC,GAC7D,MAAM,CAKR"}

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

@@ -0,0 +1,21 @@
+export function createModelSelectionPolicies() {
+    const policies = new Map();
+    return {
+        register(agentId, policy) {
+            if (policies.has(agentId))
+                throw new Error(`Model selection already registered: ${agentId}`);
+            policies.set(agentId, policy);
+            return () => {
+                if (policies.get(agentId) === policy)
+                    policies.delete(agentId);
+            };
+        },
+        async forRun(conn, run) {
+            return (await policies.get(run.agentId)?.(conn, run)) ?? null;
+        },
+    };
+}
+export function queueStart(run) {
+    return Math.max(new Date(run.queueEnteredAt ?? run.createdAt).getTime(), run.availableAt ? new Date(run.availableAt).getTime() : 0);
+}
+//# sourceMappingURL=selection.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../../../server/core/runs/selection.ts"],"names":[],"mappings":"AAsBA,MAAM,UAAU,4BAA4B;IAC1C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAGrB,CAAC;IACJ,OAAO;QACL,QAAQ,CAAC,OAAO,EAAE,MAAM;YACtB,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,uCAAuC,OAAO,EAAE,CAAC,CAAC;YACpE,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC9B,OAAO,GAAG,EAAE;gBACV,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,MAAM;oBAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACjE,CAAC,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG;YACpB,OAAO,CAAC,MAAM,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC;QAChE,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,GAA8D;IAE9D,OAAO,IAAI,CAAC,GAAG,CACb,IAAI,IAAI,CAAC,GAAG,CAAC,cAAc,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,EACvD,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAC1D,CAAC;AACJ,CAAC"}

package/dist/server/core/runs/sweeper.d.ts

@@ -0,0 +1,28 @@
+import type { RunnerService } from '../../runners/index.js';
+import type { Clock } from '../../kernel/clock.js';
+import type { IdSource } from '../../kernel/ids.js';
+import type { Tx, TxRunner } from '../../kernel/tx.js';
+import { type RunRecord } from './run.store.js';
+import { type TransitionDeps } from './transitions.js';
+export interface SweepReport {
+    readonly requeued: number;
+    readonly failed: number;
+    readonly cancelled: number;
+}
+export interface Sweeper {
+    sweep(): Promise<SweepReport>;
+}
+export interface SweeperDeps extends TransitionDeps {
+    readonly tx: TxRunner;
+    readonly ids: IdSource;
+    readonly clock: Clock;
+    /** Which runners are not online. */
+    readonly runners: Pick<RunnerService, 'absent'>;
+}
+/**
+ * Records the usage the held attempt reported in its latest `usage` event, unless the attempt already reported usage
+ * with an ending. Events from before the attempt was dispatched belong to earlier attempts.
+ */
+export declare function salvageUsage(tx: Tx, deps: Pick<SweeperDeps, 'ids' | 'clock'>, run: RunRecord): Promise<void>;
+export declare function createSweeper(deps: SweeperDeps): Sweeper;
+//# sourceMappingURL=sweeper.d.ts.map

package/dist/server/core/runs/sweeper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sweeper.d.ts","sourceRoot":"","sources":["../../../../server/core/runs/sweeper.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAG5D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAIvD,OAAO,EAML,KAAK,SAAS,EAEf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAyB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE9E,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,WAAY,SAAQ,cAAc;IACjD,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;CACjD;AAID;;;GAGG;AACH,wBAAsB,YAAY,CAChC,EAAE,EAAE,EAAE,EACN,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,GAAG,OAAO,CAAC,EACxC,GAAG,EAAE,SAAS,GACb,OAAO,CAAC,IAAI,CAAC,CAyCf;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAuMxD"}

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

@@ -0,0 +1,243 @@
+/**
+ * The runs' sweep: takes runs back from runners that stopped answering and ends runs nobody will end. The runners'
+ * sweeper (`runners/sweeper.ts`) calls it on its timer (every 30 seconds) after it marked silent runners offline; it
+ * is safe to run on several instances at once: every move it makes is a guarded
+ * update, so a run another instance (or its runner) moved first is left alone.
+ *
+ * - The runs an offline runner holds go back to the queue (`runnerOffline`); so do the runs of a revoked runner.
+ * - A dispatched run not started within `startTimeoutMs` goes back to the queue (`startTimeout`).
+ * - A held run whose lease lapsed goes back to the queue (`leaseExpired`).
+ * - A running run with no event for twice its idle timeout fails (`idleTimeout`).
+ * - A cancellation not acknowledged within `cancelGraceMs` is recorded as done.
+ * - Queued runs of an agent that is not enabled are cancelled.
+ * - A queued run that waited longer than its subject allows (`SubjectBinding.queuedExpiryMs`), counted from its last
+ *   change (queued, sent back to the queue, merged into) or from when its delay passed, fails (`queuedExpired`).
+ *
+ * A run that goes back to the queue with no attempt left fails with the same reason instead.
+ *
+ * A runner that stops answering never sends the usage of the attempt it held; the latest `usage` event it reported for
+ * the attempt (cumulative, `meta.usage`) is recorded instead, so the tokens it spent still reach the reports.
+ */
+import { TIMINGS, UsageSchema, } from '@nocobase/agent-protocol';
+import { z } from 'zod';
+import { jsonObject } from '../../kernel/values.js';
+import { lockAgentForClaim, findAgent } from '../agents/index.js';
+import { toolPolicyFor } from './policy.js';
+import { ACTIVE, eventsRepo, findRunRecord, runsRepo, usageRepo, toRun, } from './run.store.js';
+import { finishRun, requeueRun } from './transitions.js';
+const ReportedUsage = z.array(UsageSchema);
+/**
+ * Records the usage the held attempt reported in its latest `usage` event, unless the attempt already reported usage
+ * with an ending. Events from before the attempt was dispatched belong to earlier attempts.
+ */
+export async function salvageUsage(tx, deps, run) {
+    if (!run.dispatchedAt)
+        return;
+    const since = new Date(run.dispatchedAt);
+    const recorded = await usageRepo(tx.conn).count({
+        filter: (f) => f.and([
+            f.string('runId').eq(run.id),
+            f.date('createdAt').notBefore(since),
+        ]),
+    });
+    if (recorded > 0)
+        return;
+    const [latest] = await eventsRepo(tx.conn).findMany({
+        filter: (f) => f.and([
+            f.string('runId').eq(run.id),
+            f.string('type').eq('usage'),
+            f.date('createdAt').notBefore(since),
+        ]),
+        sort: (sort) => [sort.field('seq').desc()],
+        limit: 1,
+    });
+    if (!latest)
+        return;
+    const parsed = ReportedUsage.safeParse(jsonObject(latest.meta).usage);
+    if (!parsed.success)
+        return;
+    const now = deps.clock.now().toISOString();
+    for (const usage of parsed.data)
+        await usageRepo(tx.conn).createOne({
+            values: {
+                id: deps.ids.next(),
+                runId: run.id,
+                tool: usage.tool,
+                modelService: null,
+                model: usage.model ?? null,
+                inputTokens: usage.inputTokens,
+                outputTokens: usage.outputTokens,
+                cacheReadTokens: usage.cacheReadTokens ?? 0,
+                cacheWriteTokens: usage.cacheWriteTokens ?? 0,
+                reasoningTokens: usage.reasoningTokens ?? 0,
+                createdAt: now,
+            },
+        });
+}
+export function createSweeper(deps) {
+    const { tx, clock } = deps;
+    return {
+        async sweep() {
+            const now = clock.now();
+            const counts = { requeued: 0, failed: 0, cancelled: 0 };
+            const take = async (run, reason) => {
+                await tx.run(async (unit) => {
+                    const current = await findRunRecord(unit.conn, run.id);
+                    if (!current ||
+                        current.status !== run.status ||
+                        current.runnerId !== run.runnerId)
+                        return;
+                    await salvageUsage(unit, deps, current);
+                    const outcome = await requeueRun(unit, deps, current, reason);
+                    if (outcome.status === 'queued')
+                        counts.requeued += 1;
+                    else if (outcome.run)
+                        counts.failed += 1;
+                });
+            };
+            const end = async (run, outcome) => {
+                await tx.run(async (unit) => {
+                    const current = await findRunRecord(unit.conn, run.id);
+                    if (!current || current.status !== run.status)
+                        return;
+                    if (current.status !== 'queued')
+                        await salvageUsage(unit, deps, current);
+                    const ended = await finishRun(unit, deps, current, outcome);
+                    if (ended?.status === 'failed')
+                        counts.failed += 1;
+                    if (ended?.status === 'cancelled')
+                        counts.cancelled += 1;
+                });
+            };
+            const conn = tx.read();
+            const held = await runsRepo(conn).findMany({
+                filter: (f) => f.or(ACTIVE.map((status) => f.string('status').eq(status))),
+            });
+            const absent = new Set(await deps.runners.absent(conn, [...new Set(held.map((run) => run.runnerId ?? ''))].filter((id) => id !== '')));
+            const policies = new Map();
+            const idleTimeoutOf = async (agentId) => {
+                if (!policies.has(agentId)) {
+                    const agent = await findAgent(conn, agentId);
+                    policies.set(agentId, toolPolicyFor(agent?.toolPolicy ?? null).idleTimeoutMs);
+                }
+                return policies.get(agentId);
+            };
+            const time = (at) => (at ? Date.parse(at) : 0);
+            for (const run of held) {
+                if (run.cancelRequestedAt &&
+                    time(run.cancelRequestedAt) < now.getTime() - TIMINGS.cancelGraceMs) {
+                    await end(run, { status: 'cancelled', reason: 'cancelled' });
+                    continue;
+                }
+                if (run.runnerId && absent.has(run.runnerId)) {
+                    await take(run, 'runnerOffline');
+                    continue;
+                }
+                if (run.status === 'dispatched' &&
+                    time(run.dispatchedAt) < now.getTime() - TIMINGS.startTimeoutMs) {
+                    await take(run, 'startTimeout');
+                    continue;
+                }
+                if (time(run.leaseExpiresAt) < now.getTime()) {
+                    await take(run, 'leaseExpired');
+                    continue;
+                }
+                if (run.status === 'running' &&
+                    time(run.lastActivityAt ?? run.startedAt) <
+                        now.getTime() - 2 * (await idleTimeoutOf(run.agentId)))
+                    await end(run, {
+                        status: 'failed',
+                        reason: 'idleTimeout',
+                        detail: 'The run reported nothing for too long.',
+                    });
+            }
+            const queued = await runsRepo(conn).findMany({
+                filter: (f) => f.and([
+                    f.string('status').eq('queued'),
+                    f
+                        .relation('agent')
+                        .some((agent) => agent.or([
+                        agent.string('status').ne('enabled'),
+                        agent.date('archivedAt').notEmpty(),
+                        agent.date('deletedAt').notEmpty(),
+                    ])),
+                ]),
+            });
+            for (const run of queued)
+                await end(run, {
+                    status: 'cancelled',
+                    reason: 'cancelled',
+                    detail: 'The agent was archived.',
+                });
+            for (const binding of deps.subjects.list()) {
+                if (binding.queuedTimeout) {
+                    let cursor = null;
+                    while (true) {
+                        let scan = conn.query
+                            .selectFrom('agRuns')
+                            .select('id')
+                            .where('status', '=', 'queued')
+                            .where('subjectKind', '=', binding.kind);
+                        if (cursor !== null)
+                            scan = scan.where('id', '>', cursor);
+                        const ids = await scan.orderBy('id').limit(200).execute();
+                        const batch = ids.length
+                            ? await runsRepo(conn).findMany({
+                                filter: (f) => f.or(ids.map((row) => f.string('id').eq(String(row.id)))),
+                                sort: (s) => s.field('id').asc(),
+                            })
+                            : [];
+                        if (!batch.length)
+                            break;
+                        for (const candidate of batch)
+                            await tx.run(async (unit) => {
+                                await lockAgentForClaim(unit.conn, candidate.agentId, clock.now().toISOString());
+                                const current = await findRunRecord(unit.conn, candidate.id);
+                                if (!current ||
+                                    current.status !== 'queued' ||
+                                    current.runnerId !== null ||
+                                    Number(current.attempt) !== Number(candidate.attempt) ||
+                                    time(current.queueEnteredAt ?? null) !==
+                                        time(candidate.queueEnteredAt ?? null) ||
+                                    time(current.availableAt) !== time(candidate.availableAt))
+                                    return;
+                                const outcome = await binding.queuedTimeout(unit.conn, toRun(current), clock.now());
+                                if (!outcome)
+                                    return;
+                                const ended = await finishRun(unit, deps, current, {
+                                    status: 'cancelled',
+                                    ...outcome,
+                                });
+                                if (ended)
+                                    counts.cancelled += 1;
+                            });
+                        cursor = batch.at(-1).id;
+                    }
+                }
+                const expiry = binding.queuedExpiryMs ?? 0;
+                if (!(expiry > 0))
+                    continue;
+                const cutoff = new Date(now.getTime() - expiry);
+                const stale = await runsRepo(conn).findMany({
+                    filter: (f) => f.and([
+                        f.string('status').eq('queued'),
+                        f.string('subjectKind').eq(binding.kind),
+                        f.date('updatedAt').before(cutoff),
+                        f.or([
+                            f.date('availableAt').empty(),
+                            f.date('availableAt').before(cutoff),
+                        ]),
+                    ]),
+                });
+                for (const run of stale)
+                    await end(run, {
+                        status: 'failed',
+                        reason: 'queuedExpired',
+                        detail: 'No runtime took the run in time.',
+                    });
+            }
+            return counts;
+        },
+    };
+}
+//# sourceMappingURL=sweeper.js.map

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

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

package/dist/server/core/runs/transitions.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The moves every part of the runs domain shares: ending a run and sending it back to the queue. Each is a guarded
+ * update (it changes the run only while it is still in the state the caller saw), so concurrent callers, such as a
+ * runner reporting while the sweeper reclaims, cannot both win.
+ */
+import type { FailureReason, RunStatus } from '@nocobase/agent-protocol';
+import { type Clock } from '../../kernel/clock.js';
+import type { Tx } from '../../kernel/tx.js';
+import type { SubjectRegistry } from './ports.js';
+import { type RunRecord } from './run.store.js';
+export interface TransitionDeps {
+    readonly clock: Clock;
+    readonly subjects: SubjectRegistry;
+}
+export interface FinishOutcome {
+    readonly status: 'completed' | 'failed' | 'cancelled';
+    readonly reason?: FailureReason | null;
+    readonly detail?: string;
+    readonly summary?: string;
+    readonly sessionId?: string;
+    readonly cancelledById?: string;
+}
+/** Revokes every live token of the run. */
+export declare function revokeTokens(tx: Tx, runId: string, now: string): Promise<void>;
+/**
+ * Ends `run` if it is still in `run.status` (and, when held, still held by the same runner). Returns the ended run,
+ * or null when someone else moved it first.
+ */
+export declare function finishRun(tx: Tx, deps: TransitionDeps, run: RunRecord, outcome: FinishOutcome): Promise<RunRecord | null>;
+export interface RequeueOutcome {
+    readonly status: RunStatus;
+    /** When the next attempt may start; absent when the run ended instead. */
+    readonly retryAt?: string;
+    readonly run: RunRecord | null;
+}
+/**
+ * Takes a held run back from its runner after a retryable failure: it goes back to the queue while attempts remain,
+ * and fails with `reason` otherwise.
+ */
+export declare function requeueRun(tx: Tx, deps: TransitionDeps, run: RunRecord, reason: FailureReason, detail?: string): Promise<RequeueOutcome>;
+//# sourceMappingURL=transitions.d.ts.map

package/dist/server/core/runs/transitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transitions.d.ts","sourceRoot":"","sources":["../../../../server/core/runs/transitions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAEzE,OAAO,EAAS,KAAK,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAOlD,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,2CAA2C;AAC3C,wBAAsB,YAAY,CAChC,EAAE,EAAE,EAAE,EACN,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,EAAE,EAAE,EAAE,EACN,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAyD3B;AA0CD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,EAAE,EAAE,EAAE,EACN,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,aAAa,EACrB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,cAAc,CAAC,CA+DzB"}