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

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

@@ -0,0 +1,348 @@
+/**
+ * What a runner reports about the runs it holds: lease renewals, the start, events, and how the run ended. Every
+ * report first checks that the runner still holds the run; a runner that lost it (the sweeper took it back, or it
+ * ended) is told `LEASE_LOST` and must stop.
+ */
+import { isRetryable, MAX_EVENT_CONTENT_BYTES, ProtocolError, TIMINGS, } from '@nocobase/agent-protocol';
+import { ONLINE_TOOL } from '../../../shared/reports.js';
+import { later } from '../../kernel/clock.js';
+import { createSecretMemory, runSecretsKey, } from '../../kernel/redaction.js';
+import { asJson, truncateBytes } from '../../kernel/values.js';
+import { everHeld } from './run-tokens.js';
+import { eventsRepo, findRunRecord, inputsRepo, isActive, isTerminal, markDelivered, pendingInputs, reposRepo, runsRepo, sessionsRepo, toInput, usageRepo, } from './run.store.js';
+import { finishRun, requeueRun } from './transitions.js';
+export function createRunnerReports(deps) {
+    const { tx, ids, clock } = deps;
+    const secrets = deps.secrets ?? createSecretMemory();
+    const redactorOf = (runId) => secrets.redactor(runSecretsKey(runId));
+    /** The run, while `runner` holds it; `LEASE_LOST`, `RUN_NOT_ACTIVE` or `RUN_NOT_OWNED` otherwise. */
+    async function held(conn, runner, runId) {
+        const run = await findRunRecord(conn, runId);
+        if (run && run.runnerId === runner.id) {
+            if (isActive(run.status))
+                return run;
+            throw new ProtocolError('RUN_NOT_ACTIVE', `The run is ${run.status}.`, {
+                status: run.status,
+            });
+        }
+        if (run && (await everHeld(conn, runId, runner.id)))
+            throw new ProtocolError('LEASE_LOST', 'This runner no longer holds the run; stop it.', { status: run.status });
+        throw new ProtocolError('RUN_NOT_OWNED', 'This runner does not hold the run.');
+    }
+    async function extendLease(conn, run) {
+        const now = clock.now();
+        const leaseExpiresAt = later(now, TIMINGS.leaseMs);
+        await runsRepo(conn).updateMany({
+            filter: { id: run.id },
+            values: { leaseExpiresAt, updatedAt: now.toISOString() },
+        });
+        return leaseExpiresAt;
+    }
+    async function deliver(conn, runId) {
+        const pending = await pendingInputs(conn, runId);
+        await markDelivered(conn, pending, clock.now().toISOString());
+        return pending.map(toInput);
+    }
+    /** Records what every ending reports: handled inputs, usage, branches. */
+    async function recordOutcome({ conn }, run, report) {
+        const now = clock.now().toISOString();
+        const handled = report.handledInputIds ?? [];
+        if (handled.length > 0)
+            await inputsRepo(conn).updateMany({
+                filter: (f) => f.and([
+                    f.string('runId').eq(run.id),
+                    f.or(handled.map((id) => f.string('id').eq(id))),
+                    f.date('handledAt').empty(),
+                ]),
+                values: { handledAt: now },
+            });
+        for (const usage of report.usage ?? [])
+            await usageRepo(conn).createOne({
+                values: {
+                    id: 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,
+                },
+            });
+        for (const repo of report.repos ?? []) {
+            const existing = await reposRepo(conn).findOne({
+                filter: { runId: run.id, url: repo.url },
+            });
+            const values = {
+                branch: repo.branch,
+                pushed: repo.pushed,
+                headSha: repo.headSha ?? null,
+                updatedAt: now,
+            };
+            if (existing)
+                await reposRepo(conn).updateMany({
+                    filter: { id: existing.id },
+                    values,
+                });
+            else
+                await reposRepo(conn).createOne({
+                    values: { id: ids.next(), runId: run.id, url: repo.url, ...values },
+                });
+        }
+    }
+    async function rememberSession({ conn }, run, sessionId, poisoned) {
+        if (!sessionId || !run.runnerId)
+            return;
+        const key = {
+            agentId: run.agentId,
+            runnerId: run.runnerId,
+            subjectKind: run.subjectKind,
+            subjectId: run.subjectId,
+            threadScope: run.threadScope,
+        };
+        const values = {
+            sessionId,
+            workDir: run.workDir,
+            fingerprint: run.payloadFingerprint,
+            poisoned,
+            updatedAt: clock.now().toISOString(),
+        };
+        const existing = await sessionsRepo(conn).findOne({ filter: key });
+        if (existing)
+            await sessionsRepo(conn).updateMany({
+                filter: { id: existing.id },
+                values,
+            });
+        else
+            await sessionsRepo(conn).createOne({
+                values: { id: ids.next(), ...key, branch: null, ...values },
+            });
+    }
+    return {
+        async holds(runner, runId) {
+            await held(tx.read(), runner, runId);
+        },
+        onlineUsage: (holder, runId, usage) => tx.run(async ({ conn }) => {
+            const run = await held(conn, holder, runId);
+            await usageRepo(conn).createOne({
+                values: {
+                    id: ids.next(),
+                    runId: run.id,
+                    tool: ONLINE_TOOL,
+                    modelService: usage.modelService?.slice(0, 64) ?? null,
+                    model: usage.model?.slice(0, 200) ?? null,
+                    inputTokens: usage.inputTokens,
+                    outputTokens: usage.outputTokens,
+                    cacheReadTokens: usage.cacheReadTokens ?? 0,
+                    cacheWriteTokens: usage.cacheWriteTokens ?? 0,
+                    reasoningTokens: usage.reasoningTokens ?? 0,
+                    createdAt: clock.now().toISOString(),
+                },
+            });
+        }),
+        lease: (runner, runId) => tx.run(async ({ conn }) => {
+            const run = await held(conn, runner, runId);
+            const leaseExpiresAt = await extendLease(conn, run);
+            return {
+                leaseExpiresAt,
+                cancelRequested: run.cancelRequestedAt !== null,
+                inputs: await deliver(conn, run.id),
+            };
+        }),
+        start: (runner, runId, request) => tx.run(async (unit) => {
+            const { conn } = unit;
+            const run = await held(conn, runner, runId);
+            const cancelRequested = run.cancelRequestedAt !== null;
+            if (run.status === 'dispatched' && !cancelRequested) {
+                const now = clock.now().toISOString();
+                await runsRepo(conn).updateMany({
+                    filter: (f) => f.and([
+                        f.string('id').eq(run.id),
+                        f.string('status').eq('dispatched'),
+                    ]),
+                    values: {
+                        status: 'running',
+                        startedAt: now,
+                        lastActivityAt: now,
+                        workDir: request.workDir,
+                        acceptsInput: request.acceptsInput,
+                        ...(request.sessionId ? { sessionId: request.sessionId } : {}),
+                        updatedAt: now,
+                    },
+                });
+                unit.emit({ type: 'run.changed', runId: run.id, status: 'running' });
+            }
+            const leaseExpiresAt = await extendLease(conn, run);
+            const current = (await findRunRecord(conn, run.id));
+            return {
+                status: current.status,
+                leaseExpiresAt,
+                cancelRequested,
+                inputs: await deliver(conn, run.id),
+            };
+        }),
+        events: (runner, runId, request) => tx.run(async (unit) => {
+            const { conn } = unit;
+            const run = await held(conn, runner, runId);
+            const seqs = request.events.map((event) => event.seq);
+            const existing = seqs.length === 0
+                ? []
+                : await eventsRepo(conn).findMany({
+                    filter: (f) => f.and([
+                        f.string('runId').eq(run.id),
+                        f.or(seqs.map((seq) => f.number('seq').eq(seq))),
+                    ]),
+                });
+            const stored = new Set(existing.map((event) => Number(event.seq)));
+            const now = clock.now().toISOString();
+            const redact = redactorOf(run.id);
+            let accepted = 0;
+            let lastSeq = 0;
+            for (const event of request.events) {
+                lastSeq = Math.max(lastSeq, event.seq);
+                if (stored.has(event.seq))
+                    continue;
+                stored.add(event.seq);
+                // Redacted before it is cut, so a cut never leaves part of a secret the redactor would have found.
+                const content = event.content === undefined
+                    ? null
+                    : truncateBytes(redact.text(event.content), MAX_EVENT_CONTENT_BYTES);
+                const output = event.output === undefined
+                    ? null
+                    : truncateBytes(redact.text(event.output), MAX_EVENT_CONTENT_BYTES);
+                await eventsRepo(conn).createOne({
+                    values: {
+                        id: ids.next(),
+                        runId: run.id,
+                        seq: event.seq,
+                        at: Number.isNaN(Date.parse(event.at))
+                            ? now
+                            : new Date(event.at).toISOString(),
+                        type: event.type,
+                        tool: event.tool ?? null,
+                        content: content?.text ?? null,
+                        input: asJson(redact.value(event.input)),
+                        output: output?.text ?? null,
+                        meta: asJson(redact.value(event.meta)),
+                        truncated: Boolean(event.truncated) ||
+                            Boolean(content?.truncated) ||
+                            Boolean(output?.truncated),
+                        createdAt: now,
+                    },
+                });
+                accepted += 1;
+            }
+            await runsRepo(conn).updateMany({
+                filter: { id: run.id },
+                values: { lastActivityAt: now },
+            });
+            if (accepted > 0)
+                unit.emit({ type: 'run.events', runId: run.id, lastSeq });
+            return {
+                accepted,
+                duplicates: request.events.length - accepted,
+                cancelRequested: run.cancelRequestedAt !== null,
+            };
+        }),
+        status: (runner, runId) => tx.run(async ({ conn }) => {
+            const run = await findRunRecord(conn, runId);
+            // A runner may still ask about a run it held once it ended, to learn how.
+            if (run && run.runnerId === runner.id && isTerminal(run.status))
+                return {
+                    status: run.status,
+                    cancelRequested: run.cancelRequestedAt !== null,
+                    inputs: [],
+                    leaseExpiresAt: null,
+                };
+            const current = await held(conn, runner, runId);
+            return {
+                status: current.status,
+                cancelRequested: current.cancelRequestedAt !== null,
+                inputs: await deliver(conn, current.id),
+                leaseExpiresAt: current.leaseExpiresAt,
+            };
+        }),
+        complete: (runner, runId, request) => tx.run(async (unit) => {
+            const run = await held(unit.conn, runner, runId);
+            const handled = new Set(request.handledInputIds);
+            const missing = (await pendingInputs(unit.conn, run.id)).filter((input) => !handled.has(input.id));
+            if (missing.length > 0)
+                throw new ProtocolError('RUN_INPUT_PENDING', 'The run has input it has not handled; handle it before completing.', {
+                    inputIds: missing.map((input) => input.id),
+                    inputs: missing.map(toInput),
+                });
+            await recordOutcome(unit, run, request);
+            await rememberSession(unit, run, request.sessionId, false);
+            const ended = await finishRun(unit, deps, run, {
+                status: 'completed',
+                summary: redactorOf(run.id).text(request.summary),
+                ...(request.sessionId ? { sessionId: request.sessionId } : {}),
+            });
+            if (!ended)
+                throw new ProtocolError('LEASE_LOST', 'The run moved on; stop it.');
+            secrets.forget(runSecretsKey(run.id));
+            return { status: ended.status };
+        }),
+        fail: (runner, runId, reported) => tx.run(async (unit) => {
+            const run = await held(unit.conn, runner, runId);
+            const request = reported.detail === undefined
+                ? reported
+                : {
+                    ...reported,
+                    detail: redactorOf(run.id).text(reported.detail),
+                };
+            await recordOutcome(unit, run, request);
+            await rememberSession(unit, run, request.sessionId, request.reason === 'contextOverflow');
+            if (isRetryable(request.reason) && run.cancelRequestedAt === null) {
+                const outcome = await requeueRun(unit, deps, run, request.reason, request.detail);
+                if (!outcome.run)
+                    throw new ProtocolError('LEASE_LOST', 'The run moved on; stop it.');
+                return {
+                    status: outcome.status,
+                    ...(outcome.status === 'queued' && outcome.retryAt
+                        ? { retryAt: outcome.retryAt }
+                        : {}),
+                };
+            }
+            const ended = await finishRun(unit, deps, run, {
+                status: run.cancelRequestedAt === null ? 'failed' : 'cancelled',
+                reason: run.cancelRequestedAt === null ? request.reason : 'cancelled',
+                ...(request.detail === undefined ? {} : { detail: request.detail }),
+                ...(request.sessionId ? { sessionId: request.sessionId } : {}),
+            });
+            if (!ended)
+                throw new ProtocolError('LEASE_LOST', 'The run moved on; stop it.');
+            secrets.forget(runSecretsKey(run.id));
+            return { status: ended.status };
+        }),
+        cancelAck: (runner, runId, request) => tx.run(async (unit) => {
+            const run = await held(unit.conn, runner, runId);
+            await recordOutcome(unit, run, request);
+            const ended = await finishRun(unit, deps, run, {
+                status: 'cancelled',
+                reason: 'cancelled',
+            });
+            if (!ended)
+                throw new ProtocolError('LEASE_LOST', 'The run moved on; stop it.');
+            secrets.forget(runSecretsKey(run.id));
+            return { status: ended.status };
+        }),
+        async reconcile(runner, active) {
+            const conn = tx.read();
+            const cancelRequested = [];
+            const release = [];
+            for (const { runId } of active) {
+                const run = await findRunRecord(conn, runId);
+                if (!run || run.runnerId !== runner.id || !isActive(run.status))
+                    release.push(runId);
+                else if (run.cancelRequestedAt !== null)
+                    cancelRequested.push(runId);
+            }
+            return { cancelRequested, release };
+        },
+    };
+}
+//# sourceMappingURL=lifecycle.js.map

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

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

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

@@ -0,0 +1,33 @@
+/**
+ * Run defaults: the tool policy an agent starts from, and how long a failed attempt waits before the next.
+ */
+import type { FailureReason, ToolPolicy } from '@nocobase/agent-protocol';
+import { DEFAULT_TOOL_POLICY } from '../../../shared/agents.js';
+import type { AgentCliSource } from './cli-package.js';
+/** The application CLI a run exposes to its agent (`RunPayload.cli`). */
+export interface AgentCli {
+    readonly name: string;
+    readonly package: AgentCliSource;
+    /** Relative to the run's working directory. */
+    readonly credentialFile: string;
+}
+/**
+ * The CLI an agent talks to the application with, as the application configures it (`agents.cli`). Only `name` is
+ * needed, the application's id when it is left out: the runner installs the CLI from the tarball this application
+ * serves for its platform (`served`, see `cli-package.ts`) unless `package` names an npm package and version, a tarball,
+ * or `preinstalled` where runners already have it, and the run's token goes in `.<name>/run.json` unless
+ * `credentialFile` says otherwise.
+ */
+export declare function resolveAgentCli(configured: Partial<AgentCli> | undefined, app: {
+    readonly id: string;
+}): AgentCli;
+export { DEFAULT_TOOL_POLICY };
+/** The agent's overrides over the defaults. */
+export declare function toolPolicyFor(overrides: Partial<ToolPolicy> | null): ToolPolicy;
+/** How long before attempt `attempt + 1` may start, after attempt `attempt` failed for `reason`. */
+export declare function retryDelayMs(reason: FailureReason, attempt: number): number;
+/** Claims that failed to assemble a run's payload before the run fails `setupFailed`. */
+export declare const MAX_CLAIM_FAILURES: number;
+/** How long a run token lives at most; it is revoked as soon as the run leaves its runner. */
+export declare const RUN_TOKEN_TTL_MS: number;
+//# sourceMappingURL=policy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../../../server/core/runs/policy.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,yEAAyE;AACzE,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,+CAA+C;IAC/C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,SAAS,EACzC,GAAG,EAAE;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC3B,QAAQ,CAOV;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAE/B,+CAA+C;AAC/C,wBAAgB,aAAa,CAC3B,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,GACpC,UAAU,CAEZ;AASD,oGAAoG;AACpG,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAG3E;AAED,yFAAyF;AACzF,eAAO,MAAM,kBAAkB,EAAE,MAAU,CAAC;AAE5C,8FAA8F;AAC9F,eAAO,MAAM,gBAAgB,EAAE,MAA6B,CAAC"}

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

@@ -0,0 +1,38 @@
+import { DEFAULT_TOOL_POLICY } from '../../../shared/agents.js';
+/**
+ * The CLI an agent talks to the application with, as the application configures it (`agents.cli`). Only `name` is
+ * needed, the application's id when it is left out: the runner installs the CLI from the tarball this application
+ * serves for its platform (`served`, see `cli-package.ts`) unless `package` names an npm package and version, a tarball,
+ * or `preinstalled` where runners already have it, and the run's token goes in `.<name>/run.json` unless
+ * `credentialFile` says otherwise.
+ */
+export function resolveAgentCli(configured, app) {
+    const name = configured?.name ?? app.id;
+    return {
+        name,
+        package: configured?.package ?? { kind: 'served' },
+        credentialFile: configured?.credentialFile ?? `.${name}/run.json`,
+    };
+}
+export { DEFAULT_TOOL_POLICY };
+/** The agent's overrides over the defaults. */
+export function toolPolicyFor(overrides) {
+    return { ...DEFAULT_TOOL_POLICY, ...(overrides ?? {}) };
+}
+/** Failures of the runner itself retry at once, elsewhere; the tool's own failures back off. */
+const IMMEDIATE = [
+    'runnerOffline',
+    'leaseExpired',
+    'startTimeout',
+];
+/** How long before attempt `attempt + 1` may start, after attempt `attempt` failed for `reason`. */
+export function retryDelayMs(reason, attempt) {
+    if (IMMEDIATE.includes(reason))
+        return 0;
+    return Math.min(10 * 60_000, 30_000 * 2 ** Math.max(0, attempt - 1));
+}
+/** Claims that failed to assemble a run's payload before the run fails `setupFailed`. */
+export const MAX_CLAIM_FAILURES = 3;
+/** How long a run token lives at most; it is revoked as soon as the run leaves its runner. */
+export const RUN_TOKEN_TTL_MS = 7 * 24 * 60 * 60_000;
+//# sourceMappingURL=policy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../../../server/core/runs/policy.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAWhE;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,UAAyC,EACzC,GAA4B;IAE5B,MAAM,IAAI,GAAG,UAAU,EAAE,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;IACxC,OAAO;QACL,IAAI;QACJ,OAAO,EAAE,UAAU,EAAE,OAAO,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;QAClD,cAAc,EAAE,UAAU,EAAE,cAAc,IAAI,IAAI,IAAI,WAAW;KAClE,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAE/B,+CAA+C;AAC/C,MAAM,UAAU,aAAa,CAC3B,SAAqC;IAErC,OAAO,EAAE,GAAG,mBAAmB,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,CAAC;AAC1D,CAAC;AAED,gGAAgG;AAChG,MAAM,SAAS,GAA6B;IAC1C,eAAe;IACf,cAAc;IACd,cAAc;CACf,CAAC;AAEF,oGAAoG;AACpG,MAAM,UAAU,YAAY,CAAC,MAAqB,EAAE,OAAe;IACjE,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,CAAC,CAAC;IACzC,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,yFAAyF;AACzF,MAAM,CAAC,MAAM,kBAAkB,GAAW,CAAC,CAAC;AAE5C,8FAA8F;AAC9F,MAAM,CAAC,MAAM,gBAAgB,GAAW,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC"}

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

@@ -0,0 +1,197 @@
+/**
+ * What the runs domain needs from the domain a run works on, and tells it. The runs domain knows a subject only as
+ * `{ kind, id }`; the application that owns the kind registers a binding for it (this plugin registers its own
+ * `conversation`).
+ */
+import type { RunInput, WorkspaceDir } from '@nocobase/agent-protocol';
+import type { DatabaseConnection } from '@nocobase/db';
+import type { Agent, AgentType, OnlineModelEntry } from '../../../shared/agents.js';
+import type { I18nText } from '../../../shared/i18n.js';
+import type { Runner } from '../../../shared/runners.js';
+import type { Run } from '../../../shared/runs.js';
+import type { Tx } from '../../kernel/tx.js';
+/**
+ * How the agent reaches the application's commands: `cli` for a runner agent (it types `acme issue get PM-12` in its
+ * terminal), `tools` for an online agent (it runs the same command in its sandboxed shell, the `bash` tool). Both name
+ * commands the same way; what differs is where files go (a working directory, or `/tmp`).
+ */
+export type CommandDialect = 'cli' | 'tools';
+/** The dialect a run of `agent` speaks. */
+export declare function dialectOf(agent: Pick<Agent, 'type'>): CommandDialect;
+/**
+ * A command as a brief names it: `` `acme issue get` ``, with a flag named in `flag` after it (`--file`). Both
+ * dialects run the CLI; `dialect` stays for the subject's own wording.
+ */
+export declare function commandRef(_dialect: CommandDialect, cli: string, commandId: string, flag?: string): string;
+/** What a claim (or a brief preview, without a runner) hands the subject's domain. */
+export interface ClaimContext {
+    readonly run: Run;
+    readonly agent: Agent;
+    /** The runner claiming; null for a preview, and for an online run (which the application runs itself). */
+    readonly runner: Runner | null;
+    /** The run's input not yet handled, oldest first. */
+    readonly inputs: readonly RunInput[];
+    /** The application CLI command the agent talks to the application with (`acme`). */
+    readonly cli: string;
+    /** The application's name in prose (`agents.app.name`, such as `Acme`). */
+    readonly appName: string;
+    /** How the agent reaches the commands: name them with `commandRef(claim.dialect, claim.cli, id)`. */
+    readonly dialect: CommandDialect;
+}
+/**
+ * A working directory of the subject, in order (the first is the primary one): a git repository to check out, or a
+ * directory already on one runner (`runnerId`), used as it is, which only that runner may take. `scopeId` is where the
+ * directory's own variables and default skills are kept (scope `workdir`), when it has any.
+ */
+export type SubjectDir = WorkspaceDir & {
+    readonly scopeId?: string;
+    readonly runnerId?: string;
+};
+/** Where the subject keeps variables and default skills beyond its directories': the group it belongs to, say. */
+export interface SubjectScope {
+    /** A scope key the application registered (`agents.scopes`). */
+    readonly scope: string;
+    readonly scopeId: string;
+}
+/** The subject's part of a run payload; the runs domain adds the rules, the workspace and the skills. */
+export interface SubjectAssembly {
+    /**
+     * `key` names the run's working directory (and a checkout's branch, as the subject's domain chooses); `title` and
+     * `url` are what a person sees of the subject; `noun` is what the brief calls it (`ticket`, `document`).
+     */
+    readonly subject: {
+        readonly key: string;
+        readonly title?: string;
+        readonly url: string;
+        readonly noun: string;
+    };
+    /**
+     * The brief's system layer, when the subject's runs follow other rules altogether (a conversation answers in its own
+     * text). Absent: the platform's rules for working on a subject, with `guidance`.
+     */
+    readonly system?: string;
+    /**
+     * The subject's own lines of the platform's rules: how the agent reports progress and results, and which moves it may
+     * make (`rules`, each one line of the rules list), and what it does when it cannot get the environment working
+     * (`whenBlocked`, one line of the environment check). Absent: the agent says so in its last message.
+     */
+    readonly guidance?: {
+        readonly rules: readonly string[];
+        readonly whenBlocked?: string;
+    };
+    /** The brief's task layer: why the agent runs now and how to finish. */
+    readonly task: string;
+    /** The brief's context layer: the subject as it is now. */
+    readonly context: string;
+    readonly turn: {
+        readonly prompt: string;
+        readonly previousSummary?: string;
+    };
+    /** Passed to the agent unchanged (`acme run context`). */
+    readonly data: Readonly<Record<string, unknown>>;
+    readonly dirs: readonly SubjectDir[];
+    /**
+     * Scopes whose variables and default skills the run also gets, before its directories' (the group it belongs to):
+     * variables merge these scopes, in order < directories < agent.
+     */
+    readonly scopes: readonly SubjectScope[];
+    /**
+     * For an online run: the entry of the agent's list the subject asks for (a conversation's choice). Ignored when the
+     * agent does not list it; absent, the run uses the agent's first entry.
+     */
+    readonly model?: OnlineModelEntry;
+}
+export interface ContextProvider {
+    /**
+     * Called inside the claim's transaction, again for `GET /api/agents/runs/current/context`, and for a brief preview (a run
+     * that is not stored, and no runner). Database reads only: no network, no model. Throwing leaves the run queued; a
+     * run that fails to assemble three times fails `setupFailed`.
+     */
+    assemble(conn: DatabaseConnection, claim: ClaimContext): Promise<SubjectAssembly>;
+}
+/**
+ * A made-up subject of a kind, for "Preview full prompt": what a run on one would be told, without a real one. Every
+ * made-up value is marked with `sampleValue`, so nobody mistakes it for data.
+ */
+export interface SubjectSample {
+    /**
+     * The assembly of the made-up subject, as `ContextProvider.assemble` would give it for a real one. Database reads only,
+     * and never of a subject: the application's own settings at most. `claim.run.subject.id` is `sample`.
+     */
+    assemble(conn: DatabaseConnection, claim: ClaimContext): Promise<SubjectAssembly>;
+    /**
+     * What wakes the agent on it, as the run's inputs; without it, one signal saying the previewing person gave it the
+     * subject.
+     */
+    inputs?(user: {
+        readonly id: string;
+        readonly name: string;
+    }, at: string): readonly RunInput[];
+}
+export interface WorkSink {
+    /**
+     * In the transaction that ended the run: completed, cancelled, or failed with no attempt left. A failed run's
+     * `failureReason` says why; this is where the subject's domain asks people what next (retry, reassign, cancel).
+     */
+    onRunFinished?(tx: Tx, run: Run): Promise<void>;
+}
+/** What the reports know of one subject. */
+export interface SubjectFacts {
+    /** What a person reads for it (`TKT-12 Retry callbacks`). */
+    readonly label: string;
+    /** Whether the person asking may see it; runs on a subject they may not see are left out of their reports. */
+    readonly visible: boolean;
+    /** The group it belongs to, which the reports group and filter by. */
+    readonly group: {
+        readonly id: string;
+        readonly name: string;
+    } | null;
+}
+export interface SubjectReports {
+    describe(conn: DatabaseConnection, userId: string, ids: readonly string[]): Promise<ReadonlyMap<string, SubjectFacts>>;
+}
+export interface SubjectBinding {
+    readonly kind: string;
+    /**
+     * Runs on this kind belong to the people they involve (who woke the agent, the owner): no one else sees them, or
+     * their transcripts and briefs, whatever they may manage (a private conversation).
+     */
+    readonly private?: boolean;
+    /** What a person calls one (`Ticket`); the kind when absent. */
+    readonly title?: I18nText;
+    /** What a person calls the group one belongs to (`SubjectFacts.group`, a `Project`), for the usage page. */
+    readonly groupTitle?: I18nText;
+    /** Where the application shows one and its group, `{id}` standing for the id (`/issues/{id}`), for the usage page. */
+    readonly path?: string;
+    readonly groupPath?: string;
+    /** The reasons a run on it starts (`input.payload.trigger`), as the run panel names them. */
+    readonly triggers?: Readonly<Record<string, I18nText>>;
+    /** Offered as a scenario of "Preview full prompt" on the agent page, rendered on a made-up subject of the kind. */
+    readonly preview?: SubjectSample;
+    readonly context: ContextProvider;
+    readonly sink?: WorkSink;
+    /**
+     * How long a run on this kind may wait in the queue, counted from its last change or from when its delay passed;
+     * past that the sweeper fails it as `queuedExpired`. Without it (or 0), queued runs wait for a runner however long it takes.
+     */
+    readonly queuedExpiryMs?: number;
+    /** What the reports may say about the subjects; without it, runs on the kind are reported by id only. */
+    readonly reports?: SubjectReports;
+    /**
+     * The agent types that may run on this kind; `['runner']` when absent. An online agent has no working directory, so a
+     * kind offers `online` only when its runs need none (its assembly has no `dirs`); enqueueing a run of another type is
+     * refused (`AGENT_TYPE_NOT_ALLOWED`).
+     */
+    readonly agentTypes?: readonly AgentType[];
+}
+/** Whether runs of `binding`'s kind may be given to an agent of `type`. */
+export declare function takesType(binding: Pick<SubjectBinding, 'agentTypes'> | undefined, type: AgentType): boolean;
+export interface SubjectRegistry {
+    /** Returns what removes the binding. A kind has one binding. */
+    register(binding: SubjectBinding): () => void;
+    get(kind: string): SubjectBinding | undefined;
+    /** Every binding, in the order they were registered. */
+    list(): SubjectBinding[];
+}
+export declare function createSubjectRegistry(): SubjectRegistry;
+//# sourceMappingURL=ports.d.ts.map