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

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

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

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

@@ -0,0 +1,33 @@
+/** The dialect a run of `agent` speaks. */
+export function dialectOf(agent) {
+    return agent.type === 'online' ? 'tools' : 'cli';
+}
+/**
+ * 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 function commandRef(_dialect, cli, commandId, flag) {
+    const command = `${cli} ${commandId.replaceAll(':', ' ')}`;
+    return flag ? `\`${command} --${flag}\`` : `\`${command}\``;
+}
+/** Whether runs of `binding`'s kind may be given to an agent of `type`. */
+export function takesType(binding, type) {
+    return (binding?.agentTypes ?? ['runner']).includes(type);
+}
+export function createSubjectRegistry() {
+    const bindings = new Map();
+    return {
+        register(binding) {
+            if (bindings.has(binding.kind))
+                throw new Error(`Subject kind already registered: ${binding.kind}`);
+            bindings.set(binding.kind, binding);
+            return () => {
+                if (bindings.get(binding.kind) === binding)
+                    bindings.delete(binding.kind);
+            };
+        },
+        get: (kind) => bindings.get(kind),
+        list: () => [...bindings.values()],
+    };
+}
+//# sourceMappingURL=ports.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../../../server/core/runs/ports.ts"],"names":[],"mappings":"AAyBA,2CAA2C;AAC3C,MAAM,UAAU,SAAS,CAAC,KAA0B;IAClD,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,QAAwB,EACxB,GAAW,EACX,SAAiB,EACjB,IAAa;IAEb,MAAM,OAAO,GAAG,GAAG,GAAG,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;IAC3D,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,IAAI,CAAC;AAC9D,CAAC;AAoLD,2EAA2E;AAC3E,MAAM,UAAU,SAAS,CACvB,OAAuD,EACvD,IAAe;IAEf,OAAO,CAAC,OAAO,EAAE,UAAU,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC5D,CAAC;AAUD,MAAM,UAAU,qBAAqB;IACnC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;IACnD,OAAO;QACL,QAAQ,CAAC,OAAO;YACd,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;gBAC5B,MAAM,IAAI,KAAK,CAAC,oCAAoC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACtE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACpC,OAAO,GAAG,EAAE;gBACV,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO;oBACxC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAClC,CAAC,CAAC;QACJ,CAAC;QACD,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;QACjC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC;KACnC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,47 @@
+/**
+ * Brief previews ("Preview full prompt" on the agent page): what a run of an agent would be sent now in a scenario, a
+ * subject kind that offers a sample (`SubjectBinding.preview`), rendered by the same code a claim uses on a made-up
+ * subject of the kind, stored nowhere and handed to no runner. The run is not real either: it is queued, woken by the
+ * person asking, with the inputs the sample gives (by default, one saying they gave the agent the subject).
+ */
+import type { RunInput } from '@nocobase/agent-protocol';
+import type { BriefPreview } from '../../../shared/briefs.js';
+import type { Clock } from '../../kernel/clock.js';
+import type { TxRunner } from '../../kernel/tx.js';
+import type { SkillService } from '../skills/index.js';
+import { type BriefSectionRegistry } from './extensions.js';
+import { type SubjectRegistry } from './ports.js';
+/** The id a sample subject is previewed under. */
+export declare const SAMPLE_SUBJECT_ID = "sample";
+export interface BriefPreviewer {
+    /** The turn prompt a run is given: what happened since the agent last looked, oldest first. */
+    turnPrompt(inputs: readonly RunInput[], options: {
+        readonly subject: {
+            readonly noun: string;
+            readonly key: string;
+        };
+    }): string;
+    /** The scenario's brief: `scenario` names a subject kind that offers a sample. */
+    preview(agentId: string, scenario: string, user: {
+        readonly id: string;
+        readonly name: string;
+    }): Promise<BriefPreview>;
+    /** Sections the application adds to every brief's context layer, after the subject's own context. */
+    readonly sections: BriefSectionRegistry;
+}
+/**
+ * The system prompt in two: the platform's part, with the runner's placeholders annotated, and the agent's own prompt,
+ * which ends it as written (`joinBrief` puts it last, after a fixed English lead-in that stays with the platform's part).
+ */
+export declare function splitPrompt(prompt: string, instructions: string | null): Pick<BriefPreview, 'platform' | 'agentPrompt'>;
+export declare function createBriefPreviewer(deps: {
+    readonly tx: TxRunner;
+    readonly clock: Clock;
+    readonly subjects: SubjectRegistry;
+    readonly skills: SkillService;
+    readonly cliName: string;
+    /** The application's name in prose (`agents.app.name`). */
+    readonly appName: string;
+    readonly sections: BriefSectionRegistry;
+}): BriefPreviewer;
+//# sourceMappingURL=preview.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../../../server/core/runs/preview.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAOnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAgC,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAGhF,kDAAkD;AAClD,eAAO,MAAM,iBAAiB,WAAW,CAAC;AAE1C,MAAM,WAAW,cAAc;IAC7B,+FAA+F;IAC/F,UAAU,CACR,MAAM,EAAE,SAAS,QAAQ,EAAE,EAC3B,OAAO,EAAE;QACP,QAAQ,CAAC,OAAO,EAAE;YAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;KACnE,GACA,MAAM,CAAC;IACV,kFAAkF;IAClF,OAAO,CACL,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GACnD,OAAO,CAAC,YAAY,CAAC,CAAC;IACzB,qGAAqG;IACrG,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;CACzC;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GAAG,IAAI,GAC1B,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,aAAa,CAAC,CAQhD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;CACzC,GAAG,cAAc,CAiGjB"}

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

@@ -0,0 +1,104 @@
+import { invalid, notFound } from '../../kernel/errors.js';
+import { findAgent } from '../agents/index.js';
+import { annotatePlaceholders, firstTurn, renderTurnPrompt, } from '../brief/index.js';
+import { briefOf, skillTargets } from './claim.js';
+import { prepareExtensions, withSections, } from './extensions.js';
+import { dialectOf } from './ports.js';
+import { DEFAULT_THREAD } from './run.service.js';
+/** The id a sample subject is previewed under. */
+export const SAMPLE_SUBJECT_ID = 'sample';
+/**
+ * The system prompt in two: the platform's part, with the runner's placeholders annotated, and the agent's own prompt,
+ * which ends it as written (`joinBrief` puts it last, after a fixed English lead-in that stays with the platform's part).
+ */
+export function splitPrompt(prompt, instructions) {
+    const own = instructions?.trim() ?? '';
+    const at = own && prompt.endsWith(own) ? prompt.length - own.length : prompt.length;
+    return {
+        platform: annotatePlaceholders(prompt.slice(0, at)),
+        agentPrompt: prompt.slice(at),
+    };
+}
+export function createBriefPreviewer(deps) {
+    return {
+        sections: deps.sections,
+        turnPrompt: (inputs, options) => renderTurnPrompt(inputs, { ...options, cli: deps.cliName }),
+        async preview(agentId, scenario, user) {
+            const conn = deps.tx.read();
+            const agent = await findAgent(conn, agentId);
+            if (!agent)
+                throw notFound('Agent');
+            const sample = deps.subjects.get(scenario)?.preview;
+            if (!sample)
+                throw invalid(`Nothing can be previewed for ${scenario}.`, {
+                    field: 'scenario',
+                });
+            const now = deps.clock.now().toISOString();
+            const inputs = sample.inputs?.(user, now) ?? [
+                {
+                    id: 'preview',
+                    type: 'signal',
+                    at: now,
+                    actor: { kind: 'user', id: user.id, name: user.name },
+                    text: `${user.name} gave you this ${scenario} to work on.`,
+                    payload: { trigger: 'assigned' },
+                },
+            ];
+            const claim = {
+                run: {
+                    id: 'preview',
+                    agentId: agent.id,
+                    agentType: agent.type,
+                    runnerId: null,
+                    tool: null,
+                    modelService: null,
+                    model: null,
+                    effort: null,
+                    status: 'queued',
+                    priority: 0,
+                    attempt: 1,
+                    maxAttempts: agent.maxAttempts,
+                    retryOfRunId: null,
+                    parentRunId: null,
+                    subject: { kind: scenario, id: SAMPLE_SUBJECT_ID },
+                    threadScope: DEFAULT_THREAD,
+                    actorUserId: user.id,
+                    ownerUserId: null,
+                    requires: [],
+                    acceptsInput: false,
+                    availableAt: null,
+                    leaseExpiresAt: null,
+                    dispatchedAt: null,
+                    startedAt: null,
+                    finishedAt: null,
+                    lastActivityAt: null,
+                    cancelRequestedAt: null,
+                    failureReason: null,
+                    failureDetail: null,
+                    summary: null,
+                    createdAt: now,
+                    updatedAt: now,
+                },
+                agent,
+                runner: null,
+                inputs,
+                cli: deps.cliName,
+                appName: deps.appName,
+                dialect: dialectOf(agent),
+            };
+            const assembly = await sample.assemble(conn, claim);
+            const skills = await deps.skills.forRun(conn, skillTargets(agent, assembly), 'preview');
+            const brief = briefOf(agent, await withSections(conn, deps.sections, claim, assembly, await prepareExtensions(claim.run, deps.sections, undefined)), skills, deps.cliName, deps.appName);
+            return {
+                scenario,
+                subject: {
+                    key: assembly.subject.key,
+                    title: assembly.subject.title ?? null,
+                },
+                ...splitPrompt(brief.prompt, agent.instructions),
+                firstMessage: firstTurn(brief.turn, inputs),
+            };
+        },
+    };
+}
+//# sourceMappingURL=preview.js.map

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

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

package/dist/server/core/runs/run-tokens.d.ts

@@ -0,0 +1,21 @@
+import type { DatabaseConnection } from '@nocobase/db';
+import { type Clock } from '../../kernel/clock.js';
+import type { IdSource } from '../../kernel/ids.js';
+import { type RunRecord, type TokenRecord } from './run.store.js';
+export interface MintedToken {
+    readonly value: string;
+    readonly expiresAt: string;
+}
+export declare function mintRunToken(conn: DatabaseConnection, deps: {
+    readonly ids: IdSource;
+    readonly clock: Clock;
+}, run: RunRecord, runnerId: string): Promise<MintedToken>;
+export interface RunTokenIdentity {
+    readonly token: TokenRecord;
+    readonly run: RunRecord;
+}
+/** The run a token belongs to, while it is valid; `RUN_TOKEN_INVALID` otherwise. */
+export declare function authenticateRunToken(conn: DatabaseConnection, clock: Clock, value: string): Promise<RunTokenIdentity>;
+/** Whether `runnerId` was ever given a token for the run, that is, ever held it. */
+export declare function everHeld(conn: DatabaseConnection, runId: string, runnerId: string): Promise<boolean>;
+//# sourceMappingURL=run-tokens.d.ts.map

package/dist/server/core/runs/run-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-tokens.d.ts","sourceRoot":"","sources":["../../../../server/core/runs/run-tokens.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,EAAS,KAAK,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAM1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,WAAW,EACjB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,kBAAkB,EACxB,IAAI,EAAE;IAAE,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;CAAE,EACvD,GAAG,EAAE,SAAS,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC,CAkBtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;CACzB;AAED,oFAAoF;AACpF,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,kBAAkB,EACxB,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,gBAAgB,CAAC,CAmB3B;AAED,oFAAoF;AACpF,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,kBAAkB,EACxB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC,CAElB"}

package/dist/server/core/runs/run-tokens.js

@@ -0,0 +1,51 @@
+/**
+ * Run tokens: the credential an agent's CLI calls the server with during its run. A token is minted when a runner
+ * claims the run, works only while that runner holds the run, and is revoked when the run leaves it (ends, or goes
+ * back to the queue).
+ */
+import { ProtocolError } from '@nocobase/agent-protocol';
+import { later } from '../../kernel/clock.js';
+import { CREDENTIAL_PREFIX, createCredential, hashCredential, } from '../../kernel/crypto.js';
+import { RUN_TOKEN_TTL_MS } from './policy.js';
+import { findRunRecord, isActive, tokensRepo, } from './run.store.js';
+export async function mintRunToken(conn, deps, run, runnerId) {
+    const now = deps.clock.now();
+    const value = createCredential(CREDENTIAL_PREFIX.runToken);
+    const expiresAt = later(now, RUN_TOKEN_TTL_MS);
+    await tokensRepo(conn).createOne({
+        values: {
+            id: deps.ids.next(),
+            tokenHash: hashCredential(value),
+            runId: run.id,
+            runnerId,
+            agentId: run.agentId,
+            actorUserId: run.actorUserId,
+            expiresAt,
+            revokedAt: null,
+            createdAt: now.toISOString(),
+        },
+    });
+    return { value, expiresAt };
+}
+/** The run a token belongs to, while it is valid; `RUN_TOKEN_INVALID` otherwise. */
+export async function authenticateRunToken(conn, clock, value) {
+    const invalid = new ProtocolError('RUN_TOKEN_INVALID', 'The run token is not valid: the run ended or moved to another runner.');
+    if (!value)
+        throw invalid;
+    const token = await tokensRepo(conn).findOne({
+        filter: { tokenHash: hashCredential(value) },
+    });
+    if (!token ||
+        token.revokedAt ||
+        Date.parse(token.expiresAt) <= clock.now().getTime())
+        throw invalid;
+    const run = await findRunRecord(conn, token.runId);
+    if (!run || !isActive(run.status) || run.runnerId !== token.runnerId)
+        throw invalid;
+    return { token, run };
+}
+/** Whether `runnerId` was ever given a token for the run, that is, ever held it. */
+export async function everHeld(conn, runId, runnerId) {
+    return tokensRepo(conn).exists({ filter: { runId, runnerId } });
+}
+//# sourceMappingURL=run-tokens.js.map

package/dist/server/core/runs/run-tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-tokens.js","sourceRoot":"","sources":["../../../../server/core/runs/run-tokens.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGzD,OAAO,EAAE,KAAK,EAAc,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,GACf,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EACL,aAAa,EACb,QAAQ,EACR,UAAU,GAGX,MAAM,gBAAgB,CAAC;AAOxB,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAwB,EACxB,IAAuD,EACvD,GAAc,EACd,QAAgB;IAEhB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,gBAAgB,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;IAC/C,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC;QAC/B,MAAM,EAAE;YACN,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;YACnB,SAAS,EAAE,cAAc,CAAC,KAAK,CAAC;YAChC,KAAK,EAAE,GAAG,CAAC,EAAE;YACb,QAAQ;YACR,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,SAAS;YACT,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE;SAC7B;KACF,CAAC,CAAC;IACH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC9B,CAAC;AAOD,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAwB,EACxB,KAAY,EACZ,KAAa;IAEb,MAAM,OAAO,GAAG,IAAI,aAAa,CAC/B,mBAAmB,EACnB,uEAAuE,CACxE,CAAC;IACF,IAAI,CAAC,KAAK;QAAE,MAAM,OAAO,CAAC;IAC1B,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC;QAC3C,MAAM,EAAE,EAAE,SAAS,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE;KAC7C,CAAC,CAAC;IACH,IACE,CAAC,KAAK;QACN,KAAK,CAAC,SAAS;QACf,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE;QAEpD,MAAM,OAAO,CAAC;IAChB,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACnD,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ;QAClE,MAAM,OAAO,CAAC;IAChB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AACxB,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAwB,EACxB,KAAa,EACb,QAAgB;IAEhB,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;AAClE,CAAC"}

package/dist/server/core/runs/run.service.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Runs as the rest of the application starts and follows them: queueing work for an agent, adding input to a run,
+ * cancelling and retrying, and reading runs and their transcripts. Who may read or change a run is decided by the
+ * callers (the admin routes, the application); this service checks only that the person who wakes an agent may wake it.
+ *
+ * Work is keyed by (agent, subject, thread). New work for a key joins the run already working on it while it can
+ * still be told (dispatched, or running with input), else the run waiting for it (queued), else starts a new run.
+ */
+import { type ActorRef, type RunInput, type RunInputType, type RunnerFeature, type RunSelf, type RunStatus } from '@nocobase/agent-protocol';
+import type { Runner } from '../../../shared/runners.js';
+import type { DatabaseConnection } from '@nocobase/db';
+import type { RunBrief } from '../../../shared/briefs.js';
+import type { Run, RunDetail, RunEventPage, Workload, WorkloadQuery } from '../../../shared/runs.js';
+import type { Clock } from '../../kernel/clock.js';
+import type { IdSource } from '../../kernel/ids.js';
+import type { Tx, TxRunner } from '../../kernel/tx.js';
+import type { AgentService } from '../agents/index.js';
+import { type RunTokenIdentity } from './run-tokens.js';
+import { type SubjectRegistry } from './ports.js';
+import { type WorkloadRunners } from './workload.js';
+import { type TransitionDeps } from './transitions.js';
+export declare const DEFAULT_THREAD = "main";
+export interface NewInput {
+    readonly type: RunInputType;
+    readonly actor: ActorRef;
+    readonly text: string;
+    readonly payload?: unknown;
+}
+export interface EnqueueRequest {
+    readonly agentId: string;
+    readonly subject: {
+        readonly kind: string;
+        readonly id: string;
+    };
+    /** Separates conversations about one subject; `main` by default. */
+    readonly threadScope?: string;
+    /** Who woke the agent: their permissions bound the run. */
+    readonly actorUserId: string;
+    readonly ownerUserId?: string | null;
+    /** Lower runs first; 0 by default. Work merged into a waiting run raises it to the more urgent of the two. */
+    readonly priority?: number;
+    /**
+     * Not claimed before this moment (a delayed run); now by default. Work merged into a waiting run makes it claimable
+     * at the earlier of the two moments.
+     */
+    readonly fireAt?: Date | string;
+    /** Runner features this run needs beyond what its payload does (which the claim works out). */
+    readonly requires?: readonly RunnerFeature[];
+    /**
+     * A consultation (`ask_agent`): the run that asks. Such a run is never claimed from the queue: the holder of the run
+     * that asks takes it at once and waits for its answer.
+     */
+    readonly parentRunId?: string;
+    /** Attempts the run may take; the agent's `maxAttempts` by default. */
+    readonly maxAttempts?: number;
+    readonly input: NewInput;
+}
+export interface EnqueueResult {
+    readonly runId: string;
+    /** `created` a new run, `merged` into a queued one, `appended` to one a runner holds. */
+    readonly outcome: 'created' | 'merged' | 'appended';
+    readonly status: RunStatus;
+    readonly inputId: string;
+}
+export interface RunFilter {
+    readonly subjectKind?: string;
+    readonly subjectId?: string;
+    readonly agentId?: string;
+    readonly status?: RunStatus;
+    /** Only runs this user started or is owner of. */
+    readonly involvingUserId?: string;
+    readonly limit?: number;
+    /** The newest-first position to read after: the last run of the previous page. */
+    readonly cursor?: {
+        readonly createdAt: string;
+        readonly id: string;
+    };
+}
+export interface RunService {
+    /** Queues work for an agent. In `outer`, joins the caller's transaction (the caller publishes its events). */
+    enqueue(request: EnqueueRequest, outer?: Tx): Promise<EnqueueResult>;
+    /** Adds input to a run that has not ended. */
+    addInput(runId: string, input: NewInput, outer?: Tx): Promise<string>;
+    /** A queued run ends at once; a held one is asked to stop. In `outer`, joins the caller's transaction. */
+    cancel(runId: string, byUserId: string, outer?: Tx): Promise<Run>;
+    /**
+     * Ends the queued runs on a subject, of one agent or of any, or of one agent on every subject; optionally only those
+     * `actorUserId` woke. Held runs are left alone. Answers the runs it ended. In `outer`, joins the caller's transaction.
+     */
+    withdrawQueued(request: {
+        /** Every subject when left out, which then needs `agentId`. */
+        readonly subject?: {
+            readonly kind: string;
+            readonly id: string;
+        };
+        readonly agentId?: string;
+        readonly actorUserId?: string;
+        readonly byUserId: string | null;
+        /** Why, in words, kept as the run's failure detail. */
+        readonly detail?: string;
+    }, outer?: Tx): Promise<Run[]>;
+    /** Starts a failed or cancelled run's work again as a new run, with its unhandled input, as `byUserId`. */
+    retry(runId: string, byUserId: string): Promise<Run>;
+    get(runId: string): Promise<Run>;
+    detail(runId: string): Promise<RunDetail>;
+    list(filter: RunFilter): Promise<Run[]>;
+    /** The newest ended run of each agent on each of the subjects (`subjectIds` of `subjectKind`), in no order. */
+    lastEnded(subjectKind: string, subjectIds: readonly string[]): Promise<Run[]>;
+    /**
+     * The open runs on one kind of subject, held ones with their runner and newest activity, queued ones with their
+     * place in the claim order and what holds them; with every agent's load and the runners' (`shared/runs.ts`).
+     * Whoever calls decides what of it a person may see.
+     */
+    workload(query: WorkloadQuery): Promise<Workload>;
+    events(runId: string, afterSeq: number, limit: number): Promise<RunEventPage>;
+    /** The run a run token belongs to; `RUN_TOKEN_INVALID` otherwise. */
+    authenticateToken(value: string): Promise<RunTokenIdentity>;
+    self(identity: RunTokenIdentity): Promise<RunSelf>;
+    /** The brief the run's latest attempt was given; 404 before its first claim. */
+    brief(runId: string): Promise<RunBrief>;
+    /** The subject's next run starts from a fresh working directory; its sessions are forgotten. */
+    resetWorkspace(subject: {
+        readonly kind: string;
+        readonly id: string;
+    }, byUserId: string): Promise<void>;
+    /** The run's subject context, assembled again. */
+    context(identity: RunTokenIdentity): Promise<Readonly<Record<string, unknown>>>;
+    /** The runs on a subject that have not ended (queued or held), of one agent or of any, oldest first; read on `conn`. */
+    openOn(conn: DatabaseConnection, subject: {
+        readonly kind: string;
+        readonly id: string;
+    }, agentId?: string): Promise<Run[]>;
+    /** The run's input not yet reported as handled, oldest first; read on `conn`. */
+    pendingInputs(conn: DatabaseConnection, runId: string): Promise<RunInput[]>;
+    /** The inputs given to runs on a subject since `since`, with the agent of their run and their payload as an object. */
+    inputsSince(conn: DatabaseConnection, subject: {
+        readonly kind: string;
+        readonly id: string;
+    }, since: Date): Promise<{
+        readonly agentId: string;
+        readonly type: string;
+        readonly payload: Record<string, unknown>;
+    }[]>;
+    /** The summary of the newest completed run of an agent on a subject, other than `exceptRunId`. */
+    lastSummary(conn: DatabaseConnection, key: {
+        readonly agentId: string;
+        readonly subjectKind: string;
+        readonly subjectId: string;
+    }, exceptRunId: string): Promise<string | null>;
+}
+export interface RunServiceDeps extends TransitionDeps {
+    readonly tx: TxRunner;
+    readonly ids: IdSource;
+    readonly clock: Clock;
+    readonly agents: Pick<AgentService, 'mayInvoke'>;
+    readonly subjects: SubjectRegistry;
+    /** The application CLI command, as a subject's context hears it. */
+    readonly cliName: string;
+    /** The application's name in prose (`agents.app.name`). */
+    readonly appName: string;
+    /** The runners and the jobs they hold. */
+    readonly runners: WorkloadRunners & {
+        find(conn: DatabaseConnection, id: string): Promise<Runner | null>;
+    };
+}
+export declare function createRunService(deps: RunServiceDeps): RunService;
+//# sourceMappingURL=run.service.d.ts.map

package/dist/server/core/runs/run.service.d.ts.map

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