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

package/dist/server/core/runs/input-gate.js

@@ -0,0 +1,54 @@
+import { findAgent } from '../agents/index.js';
+import { inputsRepo, pendingInputs, toInput, toRun, } from './run.store.js';
+/**
+ * Of `inputs` for `run`, the ones its agent may act on now: none when the subject rejects the agent's work on it, else
+ * what the subject selects. Without a policy, all of them.
+ */
+export async function gateInputs(conn, deps, run, agent, inputs) {
+    const context = deps.subjects.get(run.subjectKind)?.context;
+    if (!context || inputs.length === 0)
+        return inputs;
+    const claim = {
+        run: toRun(run),
+        agent,
+        runner: null,
+        inputs,
+        cli: deps.cliName,
+        appName: deps.appName,
+    };
+    if (await context.admit?.(conn, claim))
+        return [];
+    return context.selectInputs
+        ? await context.selectInputs(conn, claim)
+        : inputs;
+}
+/** Marks the inputs of `ids` handled without delivering them: the run is not to act on them. */
+export async function dropInputs(conn, ids, now) {
+    if (ids.length === 0)
+        return;
+    await inputsRepo(conn).updateMany({
+        filter: (f) => f.and([
+            f.or(ids.map((id) => f.string('id').eq(id))),
+            f.date('handledAt').empty(),
+        ]),
+        values: { handledAt: now },
+    });
+}
+/**
+ * Splits `run`'s unhandled input by the subject's policy. Input already delivered stays with the run, whatever
+ * happened since; only input not yet delivered is judged.
+ */
+export async function gatePending(conn, deps, run) {
+    const pending = await pendingInputs(conn, run.id);
+    const fresh = pending.filter((input) => !input.deliveredAt);
+    const agent = fresh.length > 0 ? await findAgent(conn, run.agentId) : null;
+    if (!agent)
+        return { kept: pending, withheld: [] };
+    const admitted = new Set((await gateInputs(conn, deps, run, agent, fresh.map(toInput))).map((input) => input.id));
+    const withheld = fresh.filter((input) => !admitted.has(input.id));
+    return {
+        kept: pending.filter((input) => !withheld.includes(input)),
+        withheld,
+    };
+}
+//# sourceMappingURL=input-gate.js.map

package/dist/server/core/runs/input-gate.js.map

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

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

@@ -0,0 +1,46 @@
+/**
+ * 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 { type ActiveRun, type AgentTool, type CancelAckRequest, type CompleteRequest, type EventsRequest, type EventsResponse, type FailRequest, type FinishResponse, type LeaseResponse, type StartRequest, type StartResponse, type StatusResponse } from '@nocobase/agent-protocol';
+import type { Runner } from '../../../shared/runners.js';
+import { type Clock } from '../../kernel/clock.js';
+import type { IdSource } from '../../kernel/ids.js';
+import { type SecretMemory } from '../../kernel/redaction.js';
+import type { Tx, TxRunner } from '../../kernel/tx.js';
+import { type InputGateDeps } from './input-gate.js';
+import { type TransitionDeps } from './transitions.js';
+export interface RunnerReports {
+    /** Resolves while `runner` holds the run; `LEASE_LOST`, `RUN_NOT_ACTIVE` or `RUN_NOT_OWNED` otherwise. */
+    holds(runner: Pick<Runner, 'id'>, runId: string): Promise<void>;
+    lease(runner: Pick<Runner, 'id'>, runId: string): Promise<LeaseResponse>;
+    start(runner: Pick<Runner, 'id'>, runId: string, request: Pick<StartRequest, 'workDir' | 'acceptsInput' | 'sessionId'>): Promise<StartResponse>;
+    events(runner: Pick<Runner, 'id'>, runId: string, request: EventsRequest): Promise<EventsResponse>;
+    status(runner: Pick<Runner, 'id'>, runId: string): Promise<StatusResponse>;
+    complete(runner: Pick<Runner, 'id'>, runId: string, request: CompleteRequest): Promise<FinishResponse>;
+    fail(runner: Pick<Runner, 'id'>, runId: string, request: FailRequest): Promise<FinishResponse>;
+    cancelAck(runner: Pick<Runner, 'id'>, runId: string, request: CancelAckRequest): Promise<FinishResponse>;
+    /** Compares what a heartbeat says the runner holds with what the server thinks. */
+    reconcile(runner: Runner, active: readonly ActiveRun[]): Promise<{
+        cancelRequested: string[];
+        release: string[];
+    }>;
+}
+export interface RunnerReportsDeps extends TransitionDeps, InputGateDeps {
+    readonly tx: TxRunner;
+    readonly ids: IdSource;
+    readonly clock: Clock;
+    /**
+     * The secrets claims handed out. Events, summaries and failure details are redacted of them and of the common
+     * patterns before they are stored, whatever the runner did (`kernel/redaction.ts`).
+     */
+    readonly secrets?: SecretMemory;
+    /**
+     * A run failed `modelUnavailable` on `runnerId` with its tool and model: the runner's mark that the model is not
+     * offered there (`RunnerService.markModelUnavailable`), in the failure's transaction.
+     */
+    readonly onModelUnavailable?: (unit: Tx, runnerId: string, tool: AgentTool, model: string) => Promise<void>;
+}
+export declare function createRunnerReports(deps: RunnerReportsDeps): RunnerReports;
+//# sourceMappingURL=lifecycle.d.ts.map

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

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

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

@@ -0,0 +1,390 @@
+/**
+ * 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, UsageSchema, } from '@nocobase/agent-protocol';
+import { z } from 'zod';
+import { runnersRepo } from '../../runners/runner.store.js';
+import { later } from '../../kernel/clock.js';
+import { createSecretMemory, runSecretsKey, } from '../../kernel/redaction.js';
+import { asJson, jsonObject, truncateBytes } from '../../kernel/values.js';
+import { recordActualModels } from './execution.js';
+import { dropInputs, gatePending } from './input-gate.js';
+import { everHeld } from './run-tokens.js';
+import { eventsRepo, findRunRecord, inputsRepo, isActive, isTerminal, markDelivered, reposRepo, runsRepo, sessionsRepo, toInput, usageRepo, } from './run.store.js';
+import { finishRun, requeueRun } from './transitions.js';
+const executionReport = z.object({
+    effort: z.string().trim().min(1).max(200).nullable(),
+    source: z.string().trim().min(1).max(200),
+});
+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;
+    }
+    /**
+     * The run's unhandled input, marking what is new delivered. New input passes the subject's policy first, as it would
+     * at a claim: what the run's agent may not act on now is marked handled instead and never reaches the runner.
+     */
+    async function deliver(conn, run) {
+        const now = clock.now().toISOString();
+        const pending = await settlePending(conn, run, now);
+        await markDelivered(conn, pending, now);
+        return pending.map(toInput);
+    }
+    /** The run's unhandled input it may act on, marking what it may no longer act on handled. */
+    async function settlePending(conn, run, now) {
+        const { kept, withheld } = await gatePending(conn, deps, run);
+        await dropInputs(conn, withheld.map((input) => input.id), now);
+        return kept;
+    }
+    /** 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,
+                },
+            });
+        await recordActualModels(conn, run, report.usage ?? [], 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,
+                failureReason: repo.failure?.reason ?? null,
+                failureDetail: repo.failure === undefined
+                    ? null
+                    : redactorOf(run.id).text(repo.failure.message).slice(0, 2000),
+                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);
+        },
+        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),
+            };
+        }),
+        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),
+            };
+        }),
+        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;
+            const reportedUsage = [];
+            const efforts = [];
+            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;
+                if (event.type === 'usage') {
+                    const usage = UsageSchema.array().safeParse(jsonObject(redact.value(event.meta)).usage);
+                    if (usage.success)
+                        reportedUsage.push(...usage.data);
+                }
+                if (event.type === 'status' && event.tool === run.tool) {
+                    const meta = jsonObject(redact.value(event.meta));
+                    const report = executionReport.safeParse(meta.execution);
+                    if (report.success)
+                        efforts.push({
+                            ...report.data,
+                            at: Number.isNaN(Date.parse(event.at))
+                                ? now
+                                : new Date(event.at).toISOString(),
+                        });
+                }
+            }
+            await runsRepo(conn).updateMany({
+                filter: { id: run.id },
+                values: { lastActivityAt: now },
+            });
+            await recordActualModels(conn, run, reportedUsage, now, efforts, true);
+            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),
+                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);
+            // Input the run may no longer act on does not hold it open: the runner would get none of it.
+            const missing = (await settlePending(unit.conn, run, clock.now().toISOString())).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 machine = reported.reason === 'runnerDiskFull'
+                ? await runnersRepo(unit.conn).findOne({
+                    filter: { id: runner.id },
+                })
+                : undefined;
+            const named = reported.reason === 'runnerDiskFull'
+                ? {
+                    ...reported,
+                    detail: `Runner ${machine?.name ?? runner.id} is out of disk space${reported.detail ? `: ${reported.detail}` : '.'}`,
+                }
+                : reported;
+            const request = named.detail === undefined
+                ? named
+                : {
+                    ...named,
+                    detail: redactorOf(run.id).text(named.detail),
+                };
+            await recordOutcome(unit, run, request.reason === 'runnerUpgrade'
+                ? { ...request, handledInputIds: [] }
+                : request);
+            if (request.reason === 'modelUnavailable' && run.tool && run.model)
+                await deps.onModelUnavailable?.(unit, runner.id, run.tool, run.model);
+            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);
+            await rememberSession(unit, run, request.sessionId, false);
+            const ended = await finishRun(unit, deps, run, {
+                status: 'cancelled',
+                reason: 'cancelled',
+                ...(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 };
+        }),
+        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,41 @@
+/**
+ * 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;
+/**
+ * How long a run may keep waiting for its subject's working directory while another live run holds it
+ * (`workspaceBusy`), counted from the first of its consecutive attempts that found it held. Such waits do not use up
+ * the run's attempts, so this is what bounds them; past it the run fails `workspaceBusy`.
+ */
+export declare const WORKSPACE_WAIT_LIMIT_MS: number;
+/** How long before the next try after the `busyAttempts`-th consecutive attempt that found the workspace held. */
+export declare function workspaceBusyDelayMs(busyAttempts: number): 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;AAE7D;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAwB,CAAC;AAE/D,kHAAkH;AAClH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEjE"}

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

@@ -0,0 +1,48 @@
+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;
+/**
+ * How long a run may keep waiting for its subject's working directory while another live run holds it
+ * (`workspaceBusy`), counted from the first of its consecutive attempts that found it held. Such waits do not use up
+ * the run's attempts, so this is what bounds them; past it the run fails `workspaceBusy`.
+ */
+export const WORKSPACE_WAIT_LIMIT_MS = 6 * 60 * 60_000;
+/** How long before the next try after the `busyAttempts`-th consecutive attempt that found the workspace held. */
+export function workspaceBusyDelayMs(busyAttempts) {
+    return Math.min(2 * 60_000, 30_000 * 2 ** Math.max(0, busyAttempts - 1));
+}
+//# 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;AAE7D;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAW,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC;AAE/D,kHAAkH;AAClH,MAAM,UAAU,oBAAoB,CAAC,YAAoB;IACvD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,EAAE,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC;AAC3E,CAAC"}