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

package/dist/shared/runners.d.ts

@@ -0,0 +1,246 @@
+/**
+ * Runners as the browser and the server's admin API exchange them.
+ */
+import { type AgentTool, type RunnerFeature, type RunnerPolicy, type RunStatus, type ToolInfo, type ToolLoad, type ToolSlots } from '@nocobase/agent-protocol';
+import { type AgentModelEntry } from './agents.js';
+/**
+ * `team` runs anyone's work; `ownerOnly` (shown as "personal") runs only work its owner started. A runner added by its
+ * owner starts personal; the owner may share it with the team, and an administrator may add one shared from the start.
+ */
+export declare const RUNNER_TRUST: readonly ["team", "ownerOnly"];
+export type RunnerTrust = (typeof RUNNER_TRUST)[number];
+/**
+ * `upgrade_required`: the runner is connected, but speaks a protocol this application does not serve
+ * (`protocolVersion` outside `RunnerSummary.requiredProtocol`). It keeps sending heartbeats and is given no work until
+ * it is upgraded; its owner is told once (the `notice` event).
+ */
+export declare const RUNNER_STATUSES: readonly ["online", "offline", "revoked", "upgrade_required"];
+export type RunnerStatus = (typeof RUNNER_STATUSES)[number];
+export interface Runner {
+    readonly id: string;
+    readonly name: string;
+    readonly hostname: string;
+    readonly os: string;
+    readonly arch: string;
+    readonly version: string;
+    /**
+     * The product it runs as and updates itself to, `nocobase-runner`; null for a runner that did not report one, which
+     * is offered no update.
+     */
+    readonly product: string | null;
+    readonly protocolVersion: number;
+    readonly features: readonly RunnerFeature[];
+    /** What the runner reported: each coding tool with its version and whether it is signed in. */
+    readonly tools: readonly ToolInfo[];
+    /**
+     * The coding tools people let this runner run, chosen on the web; null offers every tool it reports. A tool left
+     * out is still reported (with its version and sign-in) but never dispatched here.
+     */
+    readonly enabledTools: readonly AgentTool[] | null;
+    readonly trust: RunnerTrust;
+    readonly ownerUserId: string | null;
+    readonly ownerName: string | null;
+    readonly status: RunnerStatus;
+    /** Its slots, shared by runs and jobs. */
+    readonly slots: number;
+    /**
+     * How many runs of each coding tool it may hold at once, beside `slots` (`{ claude: 2, codex: 1 }`); a tool left
+     * out, or every tool when null or absent, is bounded by `slots` only. Set on the web or on registration (`--slots`).
+     * Optional so a runner built by other code than this plugin's server needs none; the server always sets it.
+     */
+    readonly toolSlots?: ToolSlots | null;
+    /**
+     * What it last reported per coding tool for the tools its own settings limit: how many runs of each it holds at most
+     * and could take now, across every application it serves. Null or absent when it reported none (unknown: read as
+     * room left).
+     */
+    readonly toolLoad?: Readonly<Partial<Record<AgentTool, ToolLoad>>> | null;
+    /**
+     * Its owner (or a manager of runners) lets it take jobs: builds and other steps an application configures, run
+     * without a model. Off for every runner until someone turns it on; a job also needs the runner to report the job's
+     * feature (`jobs.build`).
+     */
+    readonly acceptJobs: boolean;
+    /**
+     * What its owner's local policy lets it take, as it reported it (protocol 7): the agents, subjects and repositories
+     * it accepts. Null when it reported none: it takes anything it is registered for. Work kinds it refuses outright are
+     * missing from its `features` instead.
+     */
+    readonly policy: RunnerPolicy | null;
+    readonly lastSeenAt: string | null;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+/** What a runner takes work for, as the kind of work it serves names it: an agent, for agent runs. */
+export interface RunnerWorkTarget {
+    readonly id: string;
+    readonly name: string;
+}
+/** One item a runner holds now: a run of the kind of work it serves, or a job. */
+export interface RunnerHeldItem {
+    readonly id: string;
+    readonly kind: 'run' | 'job';
+    /** What it is, for people: the agent of a run, a job's title or kind. */
+    readonly title: string;
+    readonly status: 'dispatched' | 'running';
+    readonly startedAt: string | null;
+    /** Where the application shows what it works on; null when nowhere, or when the viewer may not see it. */
+    readonly path: string | null;
+}
+/** One of a runner's latest runs, for its page. */
+export interface RunnerRecentRun {
+    readonly id: string;
+    /** The agent that ran. */
+    readonly title: string;
+    readonly status: RunStatus;
+    readonly startedAt: string | null;
+    readonly finishedAt: string | null;
+    readonly createdAt: string;
+    /** Where the application shows what it worked on; null when nowhere, or when the viewer may not see it. */
+    readonly path: string | null;
+}
+/**
+ * A runner in the list, with what the viewer may do with it. What identifies its machine (the host name, the tools'
+ * executable paths) is shown only to those who may manage it (`canManage`): `hostname` is null and the tools carry no
+ * `path` for everyone else.
+ */
+export interface RunnerSummary extends Omit<Runner, 'hostname'> {
+    /** Null when the viewer may not manage it. */
+    readonly hostname: string | null;
+    /** Runs it holds now. */
+    readonly activeRuns: number;
+    /** Jobs it holds now. */
+    readonly activeJobs: number;
+    /**
+     * The runs it holds now, by the coding tool each runs with; a tool it runs nothing of is left out. Absent when
+     * unknown (a summary built by other code than this plugin's server): no use per tool is shown.
+     */
+    readonly activeByTool?: Readonly<Partial<Record<AgentTool, number>>>;
+    /**
+     * What it takes work for, by what people configured and what it reported (for agent runs: the agents whose tool is
+     * enabled and signed in here, that are not limited to other runners, and that its owner's policy lets in).
+     */
+    readonly takes: readonly RunnerWorkTarget[];
+    /** The viewer may rename it, change its slots, revoke and delete it. */
+    readonly canManage: boolean;
+    /** The viewer may switch it between personal and team: its owner, or a manager of runners. */
+    readonly canChangeTrust: boolean;
+    /**
+     * A newer runner version the application serves for its platform, which the runner installs on its own between
+     * runs; null when it is up to date or the application serves none.
+     */
+    readonly updateVersion: string | null;
+    /** The protocols this application serves; a runner speaking another one is `upgrade_required`. */
+    readonly requiredProtocol: {
+        readonly min: number;
+        readonly max: number;
+    };
+    /**
+     * The application gives runners jobs (it registered job kinds, such as an application's runner build method): only then is
+     * whether a runner takes them (`acceptJobs`) worth showing.
+     */
+    readonly offersJobs: boolean;
+}
+/** What people change about a runner after it registered. */
+export interface RunnerPatch {
+    readonly name?: string;
+    readonly trust?: RunnerTrust;
+    readonly slots?: number;
+    /** Limits per coding tool; null, or a tool left out, for none of its own (bounded by `slots`). */
+    readonly toolSlots?: ToolSlots | null;
+    /** null offers every tool the runner reports. */
+    readonly enabledTools?: readonly AgentTool[] | null;
+    readonly acceptJobs?: boolean;
+}
+export interface RegistrationTokenInput {
+    /** `team` needs the `agents.runners` manage permission; anyone may add a personal runner. */
+    readonly trust?: RunnerTrust;
+    /** The coding tools the runner that registers with this token may run; omitted or null for every tool. */
+    readonly enabledTools?: readonly AgentTool[] | null;
+    /**
+     * How many runs at once the runner that registers with this token takes (1 to 64); omitted or null leaves it to the
+     * runner. A runner registered with an explicit `--slots` keeps its own number.
+     */
+    readonly slots?: number | null;
+    /**
+     * The limits per coding tool the runner that registers with this token gets; omitted or null for none. A runner
+     * registered with its own limits per tool (`--slots claude=2`) keeps its own.
+     */
+    readonly toolSlots?: ToolSlots | null;
+}
+/** A one-time registration token; `token` is shown only in this answer. */
+export interface RegistrationToken {
+    readonly id: string;
+    readonly token: string;
+    readonly trust: RunnerTrust;
+    readonly enabledTools: readonly AgentTool[] | null;
+    readonly slots: number | null;
+    /** Absent from tokens made before limits per tool, or built by other code: none. */
+    readonly toolSlots?: ToolSlots | null;
+    readonly expiresAt: string;
+}
+/**
+ * A short-lived token that lets the install script download the `acme` CLI for one platform (the one its first
+ * download names) and nothing else; `token` is shown only in this answer. It registers no runner.
+ */
+export interface DownloadToken {
+    readonly token: string;
+    readonly expiresAt: string;
+    /** How many tarball downloads it allows, retries included. */
+    readonly maxDownloads: number;
+}
+/** Whether people let `runner` run `tool` (whether it is installed and signed in is another matter). */
+export declare function toolEnabled(runner: Pick<Runner, 'enabledTools'>, tool: AgentTool): boolean;
+/** Whether `runner` can run `tool`'s work: it is enabled there, installed and signed in. */
+export declare function runsTool(runner: Pick<Runner, 'enabledTools' | 'tools'>, tool: AgentTool): boolean;
+/** The job kinds a runner reports it executes (`jobs.<kind>` features). */
+export declare function jobKindsOf(runner: Pick<Runner, 'features'>): string[];
+/** The state of one of a runner's coding tools, as a page shows it. */
+export type ToolState = 'off' | 'notInstalled' | 'signedOut' | 'signedIn';
+/** Off when people turned it off here; otherwise whether the runner has it installed and signed in. */
+export declare function toolState(runner: Pick<Runner, 'enabledTools' | 'tools'>, tool: AgentTool): ToolState;
+/**
+ * The tools a runner lists, in the protocol's order: exactly the tools it reported. A runner reports only the tools it
+ * has installed, so a tool it did not report is not listed, even when `enabledTools` names it (turning one tool off
+ * from "every tool" stores every other tool the protocol knows).
+ */
+export declare function listedTools(runner: Pick<Runner, 'tools'>): AgentTool[];
+/**
+ * How a runner reads at a glance: `busy` is online with every slot taken. Revoked and upgrade-required runners take
+ * no work whatever their slots say.
+ */
+export type RunnerActivity = 'online' | 'busy' | 'offline' | 'revoked' | 'upgrade_required';
+export declare function runnerActivity(runner: Pick<RunnerSummary, 'status' | 'slots' | 'activeRuns' | 'activeJobs'>): RunnerActivity;
+/** How many runs of `tool` the runner may hold at once: its limit for the tool, never above its total slots. */
+export declare function toolLimit(runner: Pick<Runner, 'slots' | 'toolSlots'>, tool: AgentTool): number;
+/** One coding tool's use of a runner's slots, as a page shows it. */
+export interface ToolUsage {
+    readonly tool: AgentTool;
+    /** Runs of it the runner holds now, for this application. */
+    readonly used: number;
+    /** Its limit (`toolLimit`). */
+    readonly limit: number;
+    /** Whether the limit is its own (`toolSlots`) rather than the runner's total. */
+    readonly limited: boolean;
+}
+/**
+ * The coding tools worth showing a runner's use of, in the protocol's order: those with a limit of their own and those
+ * it runs something of now. Empty for a runner without limits per tool that runs nothing.
+ */
+export declare function toolUsage(runner: Pick<RunnerSummary, 'slots' | 'toolSlots' | 'activeByTool'>): ToolUsage[];
+/** An agent as far as where it may run is concerned (the agents plugin's `Agent` fits). */
+export interface RunnerAgentFit {
+    readonly id: string;
+    readonly name: string;
+    /** Runner agents list their coding tools; online agents' entries name none, and never run on a runner. */
+    readonly modelEntries: readonly AgentModelEntry[];
+    /** The runners it is limited to; empty for any runner that fits. */
+    readonly runnerIds: readonly string[];
+}
+/**
+ * Whether `runner` may take `agent`'s runs, by what people configured and what it reported: the agent is not limited
+ * to other runners, one of its tools is enabled, installed and signed in here, and the owner's local policy lets it in. Whether
+ * the runner is online right now is left to the caller.
+ */
+export declare function runnerTakesAgent(runner: Pick<Runner, 'id' | 'enabledTools' | 'tools' | 'policy'>, agent: RunnerAgentFit): boolean;
+//# sourceMappingURL=runners.d.ts.map

package/dist/shared/runners.d.ts.map

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

package/dist/shared/runners.js

@@ -0,0 +1,90 @@
+/**
+ * Runners as the browser and the server's admin API exchange them.
+ */
+import { AGENT_TOOLS, policyAllowsAgent, } from '@nocobase/agent-protocol';
+import { entryTools } from './agents.js';
+/**
+ * `team` runs anyone's work; `ownerOnly` (shown as "personal") runs only work its owner started. A runner added by its
+ * owner starts personal; the owner may share it with the team, and an administrator may add one shared from the start.
+ */
+export const RUNNER_TRUST = ['team', 'ownerOnly'];
+/**
+ * `upgrade_required`: the runner is connected, but speaks a protocol this application does not serve
+ * (`protocolVersion` outside `RunnerSummary.requiredProtocol`). It keeps sending heartbeats and is given no work until
+ * it is upgraded; its owner is told once (the `notice` event).
+ */
+export const RUNNER_STATUSES = [
+    'online',
+    'offline',
+    'revoked',
+    'upgrade_required',
+];
+/** Whether people let `runner` run `tool` (whether it is installed and signed in is another matter). */
+export function toolEnabled(runner, tool) {
+    return runner.enabledTools === null || runner.enabledTools.includes(tool);
+}
+/** Whether `runner` can run `tool`'s work: it is enabled there, installed and signed in. */
+export function runsTool(runner, tool) {
+    return (toolEnabled(runner, tool) &&
+        runner.tools.some((item) => item.kind === tool && item.authenticated));
+}
+/** The job kinds a runner reports it executes (`jobs.<kind>` features). */
+export function jobKindsOf(runner) {
+    return runner.features
+        .filter((feature) => feature.startsWith('jobs.'))
+        .map((feature) => feature.slice('jobs.'.length));
+}
+/** Off when people turned it off here; otherwise whether the runner has it installed and signed in. */
+export function toolState(runner, tool) {
+    if (!toolEnabled(runner, tool))
+        return 'off';
+    const info = runner.tools.find((item) => item.kind === tool);
+    if (!info)
+        return 'notInstalled';
+    return info.authenticated ? 'signedIn' : 'signedOut';
+}
+/**
+ * The tools a runner lists, in the protocol's order: exactly the tools it reported. A runner reports only the tools it
+ * has installed, so a tool it did not report is not listed, even when `enabledTools` names it (turning one tool off
+ * from "every tool" stores every other tool the protocol knows).
+ */
+export function listedTools(runner) {
+    return AGENT_TOOLS.filter((tool) => runner.tools.some((item) => item.kind === tool));
+}
+export function runnerActivity(runner) {
+    if (runner.status !== 'online')
+        return runner.status;
+    return runner.activeRuns + runner.activeJobs >= runner.slots
+        ? 'busy'
+        : 'online';
+}
+/** How many runs of `tool` the runner may hold at once: its limit for the tool, never above its total slots. */
+export function toolLimit(runner, tool) {
+    const own = runner.toolSlots?.[tool];
+    return own === undefined ? runner.slots : Math.min(own, runner.slots);
+}
+/**
+ * The coding tools worth showing a runner's use of, in the protocol's order: those with a limit of their own and those
+ * it runs something of now. Empty for a runner without limits per tool that runs nothing.
+ */
+export function toolUsage(runner) {
+    return AGENT_TOOLS.flatMap((tool) => {
+        const used = runner.activeByTool?.[tool] ?? 0;
+        const limited = runner.toolSlots?.[tool] !== undefined;
+        return limited || used > 0
+            ? [{ tool, used, limit: toolLimit(runner, tool), limited }]
+            : [];
+    });
+}
+/**
+ * Whether `runner` may take `agent`'s runs, by what people configured and what it reported: the agent is not limited
+ * to other runners, one of its tools is enabled, installed and signed in here, and the owner's local policy lets it in. Whether
+ * the runner is online right now is left to the caller.
+ */
+export function runnerTakesAgent(runner, agent) {
+    if (agent.runnerIds.length > 0 && !agent.runnerIds.includes(runner.id))
+        return false;
+    return (entryTools(agent).some((tool) => runsTool(runner, tool)) &&
+        policyAllowsAgent(runner.policy, agent));
+}
+//# sourceMappingURL=runners.js.map

package/dist/shared/runners.js.map

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

package/dist/shared/runs.d.ts

@@ -0,0 +1,205 @@
+/**
+ * Runs as the browser and the server's admin API exchange them.
+ */
+import type { ActorKind, AgentTool, FailureReason, RunEvent, RunEventType, RunInputType, RunnerFeature, RunStatus } from '@nocobase/agent-protocol';
+/** The run subject kind of a consultation: an online agent asking another a question (`ask_agent`). */
+export declare const CONSULTATION_SUBJECT = "consultation";
+/** How deep consultations go: the agent asked may ask another, which may not ask further. */
+export declare const CONSULT_MAX_DEPTH = 2;
+export interface Run {
+    readonly id: string;
+    readonly agentId: string;
+    /** The agent's type (`AgentType`): an `online` run is held by the application itself, a `runner` run by a runner. */
+    readonly agentType: 'online' | 'runner';
+    /** The runner holding it; `server:<instance>` for an online run held by an application instance. */
+    readonly runnerId: string | null;
+    /**
+     * The entry of the agent's list it works with (`AgentModelEntry`): a runner run's coding tool and model (null: the
+     * tool's default), set when a runner claims it; an online run's model service and model, set when it is claimed (a
+     * conversation's choice, else the agent's first entry). Null fields while nothing settled them.
+     */
+    readonly tool: AgentTool | null;
+    readonly modelService: string | null;
+    readonly model: string | null;
+    /** The entry's reasoning effort, settled with it; null for the tool's or provider's default. */
+    readonly effort: string | null;
+    readonly status: RunStatus;
+    readonly priority: number;
+    readonly attempt: number;
+    readonly maxAttempts: number;
+    readonly retryOfRunId: string | null;
+    /**
+     * A consultation: the run whose agent asked this run's agent a question (`ask_agent`), which waited for its answer.
+     * Null for every other run.
+     */
+    readonly parentRunId: string | null;
+    readonly subject: {
+        readonly kind: string;
+        readonly id: string;
+    };
+    readonly threadScope: string;
+    readonly actorUserId: string;
+    readonly ownerUserId: string | null;
+    readonly requires: readonly RunnerFeature[];
+    readonly acceptsInput: boolean;
+    readonly availableAt: string | null;
+    readonly leaseExpiresAt: string | null;
+    readonly dispatchedAt: string | null;
+    readonly startedAt: string | null;
+    readonly finishedAt: string | null;
+    readonly lastActivityAt: string | null;
+    readonly cancelRequestedAt: string | null;
+    readonly failureReason: FailureReason | null;
+    readonly failureDetail: string | null;
+    readonly summary: string | null;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+export interface RunInputRecord {
+    readonly id: string;
+    readonly type: RunInputType;
+    readonly actor: {
+        readonly kind: ActorKind;
+        readonly id: string;
+        readonly name: string;
+    };
+    readonly text: string;
+    readonly payload: unknown;
+    readonly createdAt: string;
+    readonly deliveredAt: string | null;
+    readonly handledAt: string | null;
+}
+export interface RunRepo {
+    readonly url: string;
+    readonly branch: string;
+    readonly pushed: boolean;
+    readonly headSha: string | null;
+    readonly updatedAt: string;
+}
+export interface RunUsageTotal {
+    readonly tool: string;
+    readonly model: string | null;
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly cacheReadTokens: number;
+    readonly cacheWriteTokens: number;
+    readonly reasoningTokens: number;
+}
+/** A consultation a run made (`ask_agent`): the run of the agent it asked. */
+export interface RunChild {
+    readonly id: string;
+    readonly agentId: string;
+    /** The agent's name; null when it was deleted. */
+    readonly agentName: string | null;
+    readonly status: RunStatus;
+    readonly failureReason: FailureReason | null;
+    /** Its answer. */
+    readonly summary: string | null;
+    readonly createdAt: string;
+    readonly finishedAt: string | null;
+}
+export interface RunDetail extends Run {
+    readonly inputs: readonly RunInputRecord[];
+    readonly repos: readonly RunRepo[];
+    readonly usage: readonly RunUsageTotal[];
+    /** The consultations it made, oldest first; each is a run of its own, with its own usage. */
+    readonly children: readonly RunChild[];
+}
+/** One page of a run's transcript, after a `seq`. */
+export interface RunEventPage {
+    readonly events: readonly RunEvent[];
+    /** The highest `seq` returned, to ask for the next page with. */
+    readonly lastSeq: number;
+}
+/**
+ * Why a queued run has not been taken yet, as far as the claim's own rules tell (`RunService.workload`), checked in
+ * this order:
+ *
+ * - `agentArchived`: its agent is archived or gone; the sweeper cancels it.
+ * - `delayed`: it was given a moment (`fireAt`, or a retry's backoff) that has not come; `until` says when.
+ * - `noRunnerOnline`: no runner is online at all.
+ * - `runnersOffline`: the agent names its runners, and none of them is online.
+ * - `toolUnavailable`: runners are online, but none has any of the agent's coding tools enabled, installed and
+ *   signed in.
+ * - `noSharedRunner`: only personal runners could take it, and none belongs to the person who woke the agent.
+ * - `missingFeatures`: the runners that could take it lack what it needs (`missing`).
+ * - `sameWorkActive`: the agent is already working on the same subject and thread; this run follows.
+ * - `concurrencyFull`: the agent has as many runs held as it may have at once.
+ * - `runnersBusy`: every runner that could take it has its slots full (the machine's slots).
+ * - `toolSlotsFull`: a runner that could take it has a free slot, but none has room for any of the agent's coding tools
+ *   (`Runner.toolSlots`); `tool` names the one that is full.
+ * - `setupRetrying`: preparing it failed and is tried again (`detail` says why).
+ * - `next`: nothing holds it; the next free runner that asks takes it.
+ */
+export declare const RUN_WAIT_REASONS: readonly ["agentArchived", "delayed", "noRunnerOnline", "runnersOffline", "toolUnavailable", "noSharedRunner", "missingFeatures", "sameWorkActive", "concurrencyFull", "runnersBusy", "toolSlotsFull", "setupRetrying", "next"];
+export type RunWaitReason = (typeof RUN_WAIT_REASONS)[number];
+/** Where a queued run stands and what holds it. */
+export interface RunWait {
+    readonly reason: RunWaitReason;
+    /** Its place among the runs that may be claimed now, in claim order (1 first); null while delayed. */
+    readonly position: number | null;
+    /** Its place among its agent's queued runs, in claim order (1 first). */
+    readonly agentPosition: number;
+    /** When a delayed run may be claimed. */
+    readonly until: string | null;
+    /**
+     * For `toolUnavailable`: the agent's default coding tool (its first entry's); any of its tools would do. For
+     * `toolSlotsFull`: the first of the agent's tools the free runners run, all of whose slots are taken.
+     */
+    readonly tool: AgentTool | null;
+    /** For `missingFeatures`: what no fitting runner has. */
+    readonly missing: readonly RunnerFeature[];
+    /** For `setupRetrying`: why preparing it failed. */
+    readonly detail: string | null;
+}
+/** The newest thing a held run reported, for a one-line "last activity". */
+export interface RunActivity {
+    readonly at: string;
+    readonly type: RunEventType;
+    readonly tool: string | null;
+    /** Its text, cut to `RUN_ACTIVITY_TEXT_MAX` characters; null when it has none. */
+    readonly text: string | null;
+}
+export declare const RUN_ACTIVITY_TEXT_MAX = 200;
+/** An open run with what a board of work shows about it. */
+export interface WorkloadRun extends Run {
+    /** The newest input's `payload.trigger`, what the subject says woke the agent; null without one. */
+    readonly trigger: string | null;
+    /** The runner holding it. */
+    readonly runnerName: string | null;
+    /** For a held run: the newest text, tool call, status or error it reported. */
+    readonly lastActivity: RunActivity | null;
+    /** For a queued run: why it waits. */
+    readonly wait: RunWait | null;
+}
+/** An agent's load: its runs held and queued, the most it may hold, and whether a runner could take its work now. */
+export interface AgentLoad {
+    readonly agentId: string;
+    readonly active: number;
+    readonly queued: number;
+    readonly maxConcurrentRuns: number;
+    readonly online: boolean;
+}
+/** The runners as a whole: how many are online, how many of those hold work, and their slots. */
+export interface RunnerLoad {
+    readonly online: number;
+    readonly busy: number;
+    readonly slots: number;
+    readonly used: number;
+}
+/** The open runs on one kind of subject, with the queue explained (`RunService.workload`). */
+export interface Workload {
+    /** Held runs first, then queued in claim order. */
+    readonly runs: readonly WorkloadRun[];
+    /** More runs are open than the limit allowed. */
+    readonly truncated: boolean;
+    /** Every agent that is not archived, and any archived one with an open run here. */
+    readonly agents: readonly AgentLoad[];
+    readonly runners: RunnerLoad;
+}
+export interface WorkloadQuery {
+    readonly subjectKind: string;
+    /** At most this many runs (200 by default, at most 1000). */
+    readonly limit?: number;
+}
+//# sourceMappingURL=runs.d.ts.map

package/dist/shared/runs.d.ts.map

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

package/dist/shared/runs.js

@@ -0,0 +1,41 @@
+/** The run subject kind of a consultation: an online agent asking another a question (`ask_agent`). */
+export const CONSULTATION_SUBJECT = 'consultation';
+/** How deep consultations go: the agent asked may ask another, which may not ask further. */
+export const CONSULT_MAX_DEPTH = 2;
+/**
+ * Why a queued run has not been taken yet, as far as the claim's own rules tell (`RunService.workload`), checked in
+ * this order:
+ *
+ * - `agentArchived`: its agent is archived or gone; the sweeper cancels it.
+ * - `delayed`: it was given a moment (`fireAt`, or a retry's backoff) that has not come; `until` says when.
+ * - `noRunnerOnline`: no runner is online at all.
+ * - `runnersOffline`: the agent names its runners, and none of them is online.
+ * - `toolUnavailable`: runners are online, but none has any of the agent's coding tools enabled, installed and
+ *   signed in.
+ * - `noSharedRunner`: only personal runners could take it, and none belongs to the person who woke the agent.
+ * - `missingFeatures`: the runners that could take it lack what it needs (`missing`).
+ * - `sameWorkActive`: the agent is already working on the same subject and thread; this run follows.
+ * - `concurrencyFull`: the agent has as many runs held as it may have at once.
+ * - `runnersBusy`: every runner that could take it has its slots full (the machine's slots).
+ * - `toolSlotsFull`: a runner that could take it has a free slot, but none has room for any of the agent's coding tools
+ *   (`Runner.toolSlots`); `tool` names the one that is full.
+ * - `setupRetrying`: preparing it failed and is tried again (`detail` says why).
+ * - `next`: nothing holds it; the next free runner that asks takes it.
+ */
+export const RUN_WAIT_REASONS = [
+    'agentArchived',
+    'delayed',
+    'noRunnerOnline',
+    'runnersOffline',
+    'toolUnavailable',
+    'noSharedRunner',
+    'missingFeatures',
+    'sameWorkActive',
+    'concurrencyFull',
+    'runnersBusy',
+    'toolSlotsFull',
+    'setupRetrying',
+    'next',
+];
+export const RUN_ACTIVITY_TEXT_MAX = 200;
+//# sourceMappingURL=runs.js.map

package/dist/shared/runs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs.js","sourceRoot":"","sources":["../../shared/runs.ts"],"names":[],"mappings":"AAcA,uGAAuG;AACvG,MAAM,CAAC,MAAM,oBAAoB,GAAG,cAAc,CAAC;AAEnD,6FAA6F;AAC7F,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AA+GnC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,eAAe;IACf,SAAS;IACT,gBAAgB;IAChB,gBAAgB;IAChB,iBAAiB;IACjB,gBAAgB;IAChB,iBAAiB;IACjB,gBAAgB;IAChB,iBAAiB;IACjB,aAAa;IACb,eAAe;IACf,eAAe;IACf,MAAM;CACE,CAAC;AAiCX,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC"}