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

package/dist/client/runs/format-wait.d.ts

@@ -0,0 +1,21 @@
+/** A translation function, as `useTranslation().t` gives it. */
+export type RunWaitTranslate = (key: string, options?: Readonly<Record<string, unknown>>) => string;
+/** A wait as the server describes it; the fields besides `reason` and `params` are what servers sent before `params`. */
+export interface RunWaitDescription {
+    readonly reason: string;
+    readonly params?: Readonly<Record<string, string | number | readonly string[]>>;
+    readonly until?: string | null;
+    readonly tool?: string | null;
+    readonly missing?: readonly string[];
+    readonly detail?: string | null;
+}
+export interface FormatRunWaitOptions {
+    /** The language `until` is written in; the runtime's by default. */
+    readonly locale?: string;
+}
+/** The reasons that need someone to act (an administrator, an agent's owner) rather than time. */
+export declare const BLOCKING_RUN_WAIT_REASONS: readonly string[];
+/** Whether a wait needs someone to act rather than time; false for a reason this version does not know. */
+export declare function runWaitBlocks(wait: Pick<RunWaitDescription, 'reason'>): boolean;
+export declare function formatRunWait(t: RunWaitTranslate, wait: RunWaitDescription, options?: FormatRunWaitOptions): string;
+//# sourceMappingURL=format-wait.d.ts.map

package/dist/client/runs/format-wait.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-wait.d.ts","sourceRoot":"","sources":["../../../client/runs/format-wait.ts"],"names":[],"mappings":"AASA,gEAAgE;AAChE,MAAM,MAAM,gBAAgB,GAAG,CAC7B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KACxC,MAAM,CAAC;AAEZ,yHAAyH;AACzH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CACxB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC,CACpD,CAAC;IACF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,oEAAoE;IACpE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,kGAAkG;AAClG,eAAO,MAAM,yBAAyB,EAAE,SAAS,MAAM,EAStD,CAAC;AAEF,2GAA2G;AAC3G,wBAAgB,aAAa,CAC3B,IAAI,EAAE,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAC,GACvC,OAAO,CAET;AAeD,wBAAgB,aAAa,CAC3B,CAAC,EAAE,gBAAgB,EACnB,IAAI,EAAE,kBAAkB,EACxB,OAAO,GAAE,oBAAyB,GACjC,MAAM,CAkCR"}

package/dist/client/runs/format-wait.js

@@ -0,0 +1,76 @@
+/**
+ * Why a queued run waits, in words. The server sends a stable reason code and the values its words need
+ * (`RunWait.params`, `shared/runs.ts`) and never text; this words them with the caller's `t`, so the language follows
+ * the page. The texts are this plugin's (`runWait.reasons.<reason>` in its namespace), so an application overrides one
+ * in its own resources for that namespace, or adds one for a reason this version does not know, or formats waits
+ * itself. A reason with no text reads as `runWait.unknown`, naming the code.
+ */
+import { ACCESS_NAMESPACE } from '../../shared/access.js';
+/** The reasons that need someone to act (an administrator, an agent's owner) rather than time. */
+export const BLOCKING_RUN_WAIT_REASONS = [
+    'agentArchived',
+    'noRunnerOnline',
+    'runnersOffline',
+    'toolUnavailable',
+    'noSharedRunner',
+    'missingFeatures',
+    'secretsNotAllowed',
+    'setupRetrying',
+];
+/** Whether a wait needs someone to act rather than time; false for a reason this version does not know. */
+export function runWaitBlocks(wait) {
+    return BLOCKING_RUN_WAIT_REASONS.includes(wait.reason);
+}
+/** The values a reason's text may name; each one the server did not send reads as `runWait.unknownValue`. */
+const NAMES = [
+    'until',
+    'tool',
+    'features',
+    'variables',
+    'active',
+    'limit',
+    'used',
+    'runners',
+    'detail',
+];
+export function formatRunWait(t, wait, options = {}) {
+    const ns = ACCESS_NAMESPACE;
+    const unknownValue = t('runWait.unknownValue', { ns });
+    const given = {
+        ...(wait.until ? { until: wait.until } : {}),
+        ...(wait.tool ? { tool: wait.tool } : {}),
+        ...(wait.missing && wait.missing.length > 0
+            ? { features: wait.missing }
+            : {}),
+        ...(wait.detail ? { detail: wait.detail } : {}),
+        ...wait.params,
+    };
+    const values = { reason: wait.reason };
+    for (const name of NAMES)
+        values[name] = unknownValue;
+    for (const [name, value] of Object.entries(given)) {
+        if (Array.isArray(value)) {
+            if (value.length > 0)
+                values[name] = value.join(', ');
+        }
+        else if (name === 'until' && typeof value === 'string') {
+            const at = new Date(value);
+            values[name] = Number.isNaN(at.getTime())
+                ? value
+                : new Intl.DateTimeFormat(options.locale, {
+                    month: 'short',
+                    day: 'numeric',
+                    hour: '2-digit',
+                    minute: '2-digit',
+                }).format(at);
+        }
+        else if (value !== '')
+            values[name] = value;
+    }
+    return t(`runWait.reasons.${wait.reason}`, {
+        ns,
+        ...values,
+        defaultValue: t('runWait.unknown', { ns, reason: wait.reason }),
+    });
+}
+//# sourceMappingURL=format-wait.js.map

package/dist/client/runs/format-wait.js.map

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

package/dist/client/runs/run-hooks.d.ts

@@ -0,0 +1,35 @@
+/**
+ * The headless parts of a subject's runs, for the application that presents them (for example, with the UI Library's
+ * `agent-run-history`): a run with its live transcript, stopping and retrying a run, the brief it was given, and cleaning the
+ * subject's working directory. Every hook reads and writes this plugin's shared cache, whichever cache is above it.
+ */
+import type { RunEvent } from '@nocobase/agent-protocol';
+import { type UseMutationResult, type UseQueryResult } from '@tanstack/react-query';
+import type { RunBrief } from '../../shared/briefs.js';
+import type { Run, RunDetail } from '../../shared/runs.js';
+export interface RunWithTranscript {
+    readonly run: UseQueryResult<RunDetail>;
+    /** What started the run, in the viewer's words: the subject's name for the trigger, else this plugin's. */
+    readonly trigger: string | null;
+    /** The events so far, oldest first; `undefined` until the first page arrives. */
+    readonly events: readonly RunEvent[] | undefined;
+    /** The last fetch failed. */
+    readonly failed: boolean;
+}
+/**
+ * One run and its transcript, fetched after the last `seq` seen when the run's realtime topic announces events, and
+ * polled while the run is open.
+ */
+export declare function useRunWithTranscript(runId: string): RunWithTranscript;
+/** Asks a run to stop; what it already changed stays. */
+export declare function useStopRun(): UseMutationResult<Run, unknown, string>;
+/** Runs a failed or cancelled run again; answers the new run. */
+export declare function useRetryRun(): UseMutationResult<Run, unknown, string>;
+/** The brief a run's latest attempt was given; a 404 before its first claim. */
+export declare function useRunBrief(runId: string, enabled: boolean): UseQueryResult<RunBrief>;
+/**
+ * The next run on the subject starts from a fresh checkout, on whichever runner takes it. Work not pushed is lost
+ * there, so the application confirms first.
+ */
+export declare function useWorkspaceReset(subjectKind: string, subjectId: string): UseMutationResult<void, unknown, void>;
+//# sourceMappingURL=run-hooks.d.ts.map

package/dist/client/runs/run-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-hooks.d.ts","sourceRoot":"","sources":["../../../client/runs/run-hooks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAiB3D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACxC,2GAA2G;IAC3G,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,iFAAiF;IACjF,QAAQ,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,GAAG,SAAS,CAAC;IACjD,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,CA+BrE;AAkBD,yDAAyD;AACzD,wBAAgB,UAAU,IAAI,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,CASpE;AAED,iEAAiE;AACjE,wBAAgB,WAAW,IAAI,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,CASrE;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,GACf,cAAc,CAAC,QAAQ,CAAC,CAU1B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAMxC"}

package/dist/client/runs/run-hooks.js

@@ -0,0 +1,92 @@
+import { useMutation, useQuery, } from '@tanstack/react-query';
+import { runTopic } from '../../shared/realtime.js';
+import { agentsKeys } from '../api/keys.js';
+import { useAgentsApi } from '../hooks/use-agents-api.js';
+import { useRealtimeTopic } from '../hooks/use-realtime-topic.js';
+import { useTriggerLabel } from '../hooks/use-vocabulary.js';
+import { isOpen } from '../lib/runs.js';
+import { agentsQueryClient } from '../query.js';
+import { EVENT_POLL_MS, useRunEvents } from './use-run-events.js';
+function isRunChanged(payload) {
+    return (typeof payload === 'object' &&
+        payload !== null &&
+        typeof payload.kind === 'string');
+}
+/**
+ * One run and its transcript, fetched after the last `seq` seen when the run's realtime topic announces events, and
+ * polled while the run is open.
+ */
+export function useRunWithTranscript(runId) {
+    const api = useAgentsApi();
+    const client = agentsQueryClient();
+    const run = useQuery({
+        queryKey: agentsKeys.run(runId),
+        queryFn: () => api.run(runId),
+        refetchInterval: (query) => query.state.data && isOpen(query.state.data) ? EVENT_POLL_MS : false,
+    }, client);
+    const open = run.data ? isOpen(run.data) : true;
+    const events = useRunEvents(api, runId, open);
+    useRealtimeTopic(runTopic(runId), (payload) => {
+        if (!isRunChanged(payload) || payload.kind === 'run.events')
+            events.fetchMore();
+        if (!isRunChanged(payload) || payload.kind !== 'run.events') {
+            void client.invalidateQueries({ queryKey: agentsKeys.run(runId) });
+            void client.invalidateQueries({ queryKey: ['agents', 'runs'] });
+        }
+    });
+    const triggerLabel = useTriggerLabel();
+    const trigger = run.data ? runTrigger(run.data.inputs) : null;
+    return {
+        run,
+        trigger: run.data && trigger ? triggerLabel(run.data.subject.kind, trigger) : null,
+        events: events.loaded ? events.events : undefined,
+        failed: Boolean(events.error),
+    };
+}
+/** What started a run, from its first input (`payload.trigger`). */
+function runTrigger(inputs) {
+    const payload = inputs[0]?.payload;
+    if (typeof payload !== 'object' || payload === null)
+        return null;
+    const trigger = payload.trigger;
+    return typeof trigger === 'string' && trigger ? trigger : null;
+}
+function refreshRuns(runId) {
+    const client = agentsQueryClient();
+    void client.invalidateQueries({ queryKey: agentsKeys.run(runId) });
+    void client.invalidateQueries({ queryKey: ['agents', 'runs'] });
+}
+/** Asks a run to stop; what it already changed stays. */
+export function useStopRun() {
+    const api = useAgentsApi();
+    return useMutation({
+        mutationFn: (runId) => api.cancelRun(runId),
+        onSettled: (_data, _error, runId) => refreshRuns(runId),
+    }, agentsQueryClient());
+}
+/** Runs a failed or cancelled run again; answers the new run. */
+export function useRetryRun() {
+    const api = useAgentsApi();
+    return useMutation({
+        mutationFn: (runId) => api.retryRun(runId),
+        onSettled: (_data, _error, runId) => refreshRuns(runId),
+    }, agentsQueryClient());
+}
+/** The brief a run's latest attempt was given; a 404 before its first claim. */
+export function useRunBrief(runId, enabled) {
+    const api = useAgentsApi();
+    return useQuery({
+        queryKey: agentsKeys.runBrief(runId),
+        queryFn: () => api.runBrief(runId),
+        enabled,
+    }, agentsQueryClient());
+}
+/**
+ * The next run on the subject starts from a fresh checkout, on whichever runner takes it. Work not pushed is lost
+ * there, so the application confirms first.
+ */
+export function useWorkspaceReset(subjectKind, subjectId) {
+    const api = useAgentsApi();
+    return useMutation({ mutationFn: () => api.resetWorkspace(subjectKind, subjectId) }, agentsQueryClient());
+}
+//# sourceMappingURL=run-hooks.js.map

package/dist/client/runs/run-hooks.js.map

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

package/dist/client/runs/subject-runs.d.ts

@@ -0,0 +1,12 @@
+import type { Run } from '../../shared/runs.js';
+/** A run with whether it may still change. */
+export type SubjectRun = Run & {
+    readonly open: boolean;
+};
+/**
+ * For the application's page of a subject: the subject's runs from this plugin's shared cache, whichever cache is above; empty until loaded, or when the viewer may not read them.
+ */
+export declare function useSubjectRuns(subjectKind: string, subjectId: string, refreshSignal?: unknown): readonly SubjectRun[];
+/** The agents' names in the viewer's language, for people who may read agents; anyone else sees runs without one. */
+export declare function useAgentNames(): (agentId: string) => string | null;
+//# sourceMappingURL=subject-runs.d.ts.map

package/dist/client/runs/subject-runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subject-runs.d.ts","sourceRoot":"","sources":["../../../client/runs/subject-runs.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAoChD,8CAA8C;AAC9C,MAAM,MAAM,UAAU,GAAG,GAAG,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAI1D;;GAEG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,OAAO,GACtB,SAAS,UAAU,EAAE,CAYvB;AAED,qHAAqH;AACrH,wBAAgB,aAAa,IAAI,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAgBlE"}

package/dist/client/runs/subject-runs.js

@@ -0,0 +1,56 @@
+/**
+ * The runs on one subject, newest first, as every run view of a page reads them: one query, refetched while any run is
+ * open and when the page says it learned of new work (`refreshSignal`), so the panel, the live badge and the activity
+ * rows agree.
+ */
+import { useQuery } from '@tanstack/react-query';
+import { useEffect, useMemo } from 'react';
+import { agentsKeys } from '../api/keys.js';
+import { useAgentsApi } from '../hooks/use-agents-api.js';
+import { useAgentText } from '../hooks/use-vocabulary.js';
+import { isOpen } from '../lib/runs.js';
+import { agentsQueryClient } from '../query.js';
+import { EVENT_POLL_MS } from './use-run-events.js';
+function subjectRunsOptions(api, subjectKind, subjectId) {
+    return {
+        queryKey: agentsKeys.runs(subjectKind, subjectId),
+        queryFn: () => api.runs({ subjectKind, subjectId }),
+        refetchInterval: (query) => query.state.data?.some(isOpen) ? EVENT_POLL_MS : false,
+    };
+}
+function useRefresh(client, subjectKind, subjectId, refreshSignal) {
+    useEffect(() => {
+        if (refreshSignal === undefined)
+            return;
+        void client.invalidateQueries({
+            queryKey: agentsKeys.runs(subjectKind, subjectId),
+        });
+    }, [refreshSignal, client, subjectKind, subjectId]);
+}
+const NONE = [];
+/**
+ * For the application's page of a subject: the subject's runs from this plugin's shared cache, whichever cache is above; empty until loaded, or when the viewer may not read them.
+ */
+export function useSubjectRuns(subjectKind, subjectId, refreshSignal) {
+    const api = useAgentsApi();
+    const client = agentsQueryClient();
+    useRefresh(client, subjectKind, subjectId, refreshSignal);
+    const runs = useQuery(subjectRunsOptions(api, subjectKind, subjectId), client);
+    return useMemo(() => runs.data?.map((run) => ({ ...run, open: isOpen(run) })) ?? NONE, [runs.data]);
+}
+/** The agents' names in the viewer's language, for people who may read agents; anyone else sees runs without one. */
+export function useAgentNames() {
+    const api = useAgentsApi();
+    const agents = useQuery({
+        queryKey: agentsKeys.agents,
+        queryFn: () => api.agents(true),
+        retry: false,
+        staleTime: 60_000,
+    }, agentsQueryClient());
+    const text = useAgentText();
+    return (agentId) => {
+        const agent = agents.data?.find((item) => item.id === agentId);
+        return agent ? text.name(agent) : null;
+    };
+}
+//# sourceMappingURL=subject-runs.js.map

package/dist/client/runs/subject-runs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subject-runs.js","sourceRoot":"","sources":["../../../client/runs/subject-runs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAoB,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAI3C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,SAAS,kBAAkB,CACzB,GAAc,EACd,WAAmB,EACnB,SAAiB;IAEjB,OAAO;QACL,QAAQ,EAAE,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC;QACjD,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;QACnD,eAAe,EAAE,CAAC,KAAkC,EAAE,EAAE,CACtD,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK;KAChD,CAAC;AACb,CAAC;AAED,SAAS,UAAU,CACjB,MAAmB,EACnB,WAAmB,EACnB,SAAiB,EACjB,aAAsB;IAEtB,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,aAAa,KAAK,SAAS;YAAE,OAAO;QACxC,KAAK,MAAM,CAAC,iBAAiB,CAAC;YAC5B,QAAQ,EAAE,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC;SAClD,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;AACtD,CAAC;AAKD,MAAM,IAAI,GAA0B,EAAE,CAAC;AAEvC;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,WAAmB,EACnB,SAAiB,EACjB,aAAuB;IAEvB,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACnC,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,QAAQ,CACnB,kBAAkB,CAAC,GAAG,EAAE,WAAW,EAAE,SAAS,CAAC,EAC/C,MAAM,CACP,CAAC;IACF,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,EACtE,CAAC,IAAI,CAAC,IAAI,CAAC,CACZ,CAAC;AACJ,CAAC;AAED,qHAAqH;AACrH,MAAM,UAAU,aAAa;IAC3B,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,QAAQ,CACrB;QACE,QAAQ,EAAE,UAAU,CAAC,MAAM;QAC3B,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAC/B,KAAK,EAAE,KAAK;QACZ,SAAS,EAAE,MAAM;KAClB,EACD,iBAAiB,EAAE,CACpB,CAAC;IACF,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC;IAC5B,OAAO,CAAC,OAAO,EAAE,EAAE;QACjB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;QAC/D,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACzC,CAAC,CAAC;AACJ,CAAC"}

package/dist/client/runs/use-run-events.d.ts

@@ -0,0 +1,24 @@
+import type { RunEvent } from '@nocobase/agent-protocol';
+import type { AgentsApi } from '../api/client.js';
+export interface RunEventsState {
+    readonly events: readonly RunEvent[];
+    readonly loaded: boolean;
+    readonly error: unknown;
+}
+/** How many events one request asks for; a full page means there may be more. */
+export declare const EVENT_PAGE = 500;
+/** How often an open run's transcript is fetched when no realtime announcement comes (other instances, lost signals). */
+export declare const EVENT_POLL_MS = 5000;
+/** Merges a batch into the list by `seq`; a repeated delivery is ignored. */
+export declare function mergeRunEvents(current: readonly RunEvent[], batch: readonly RunEvent[]): readonly RunEvent[];
+/**
+ * A run's transcript, fetched incrementally after the last `seq` seen (`GET /runs/:id/events?after=`).
+ *
+ * `fetchMore` is safe to call from anywhere (a realtime announcement, the poll, a button): concurrent calls collapse
+ * into one request followed by one catch-up request, so nothing is fetched twice and nothing that arrives mid-request
+ * is missed. While `polling`, the hook also fetches every `EVENT_POLL_MS`.
+ */
+export declare function useRunEvents(api: AgentsApi, runId: string, polling: boolean): RunEventsState & {
+    readonly fetchMore: () => void;
+};
+//# sourceMappingURL=use-run-events.d.ts.map

package/dist/client/runs/use-run-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-run-events.d.ts","sourceRoot":"","sources":["../../../client/runs/use-run-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,iFAAiF;AACjF,eAAO,MAAM,UAAU,MAAM,CAAC;AAC9B,yHAAyH;AACzH,eAAO,MAAM,aAAa,OAAO,CAAC;AAElC,6EAA6E;AAC7E,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS,QAAQ,EAAE,EAC5B,KAAK,EAAE,SAAS,QAAQ,EAAE,GACzB,SAAS,QAAQ,EAAE,CAKrB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,SAAS,EACd,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,GACf,cAAc,GAAG;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,CAAA;CAAE,CAyDrD"}

package/dist/client/runs/use-run-events.js

@@ -0,0 +1,80 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+/** How many events one request asks for; a full page means there may be more. */
+export const EVENT_PAGE = 500;
+/** How often an open run's transcript is fetched when no realtime announcement comes (other instances, lost signals). */
+export const EVENT_POLL_MS = 5000;
+/** Merges a batch into the list by `seq`; a repeated delivery is ignored. */
+export function mergeRunEvents(current, batch) {
+    if (batch.length === 0)
+        return current;
+    const bySeq = new Map(current.map((event) => [event.seq, event]));
+    for (const event of batch)
+        bySeq.set(event.seq, event);
+    return [...bySeq.values()].sort((a, b) => a.seq - b.seq);
+}
+/**
+ * A run's transcript, fetched incrementally after the last `seq` seen (`GET /runs/:id/events?after=`).
+ *
+ * `fetchMore` is safe to call from anywhere (a realtime announcement, the poll, a button): concurrent calls collapse
+ * into one request followed by one catch-up request, so nothing is fetched twice and nothing that arrives mid-request
+ * is missed. While `polling`, the hook also fetches every `EVENT_POLL_MS`.
+ */
+export function useRunEvents(api, runId, polling) {
+    const [state, setState] = useState({
+        events: [],
+        loaded: false,
+        error: undefined,
+    });
+    const lastRef = useRef(0);
+    const inflightRef = useRef(false);
+    const againRef = useRef(false);
+    const aliveRef = useRef(true);
+    const fetchMore = useCallback(() => {
+        if (inflightRef.current) {
+            againRef.current = true;
+            return;
+        }
+        inflightRef.current = true;
+        const run = async () => {
+            try {
+                let full = false;
+                do {
+                    againRef.current = false;
+                    const page = await api.runEvents(runId, lastRef.current, EVENT_PAGE);
+                    if (!aliveRef.current)
+                        return;
+                    lastRef.current = Math.max(lastRef.current, page.lastSeq);
+                    full = page.events.length >= EVENT_PAGE;
+                    setState((previous) => ({
+                        events: mergeRunEvents(previous.events, page.events),
+                        loaded: true,
+                        error: undefined,
+                    }));
+                } while (againRef.current || full);
+            }
+            catch (error) {
+                if (aliveRef.current)
+                    setState((previous) => ({ ...previous, loaded: true, error }));
+            }
+            finally {
+                inflightRef.current = false;
+            }
+        };
+        void run();
+    }, [api, runId]);
+    useEffect(() => {
+        aliveRef.current = true;
+        fetchMore();
+        return () => {
+            aliveRef.current = false;
+        };
+    }, [fetchMore]);
+    useEffect(() => {
+        if (!polling)
+            return undefined;
+        const timer = window.setInterval(fetchMore, EVENT_POLL_MS);
+        return () => window.clearInterval(timer);
+    }, [polling, fetchMore]);
+    return { ...state, fetchMore };
+}
+//# sourceMappingURL=use-run-events.js.map

package/dist/client/runs/use-run-events.js.map

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

package/dist/client/runs.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The headless parts of a subject's runs, for the application's page that shows the subject (the assembling application presents them with
+ * the UI Library's `agent-run-history`): the runs themselves (`useSubjectRuns`), the agents' names, one run with its live
+ * transcript, stopping and retrying a run, its brief, and cleaning the subject's working directory. Every hook reads
+ * this plugin's shared cache, whichever cache is above it.
+ */
+export { useAgentNames, useSubjectRuns, type SubjectRun, } from './runs/subject-runs.js';
+export { useRetryRun, useRunBrief, useRunWithTranscript, useStopRun, useWorkspaceReset, type RunWithTranscript, } from './runs/run-hooks.js';
+/** A run's transcript fetched incrementally (`fetchMore` after each `runTopic(runId)` announcement), for a chat UI's live steps. */
+export { useRunEvents, type RunEventsState } from './runs/use-run-events.js';
+/** Why a queued run waits, in words, from the reason and `params` the server sends; for queue and progress views. */
+export { BLOCKING_RUN_WAIT_REASONS, formatRunWait, runWaitBlocks, type FormatRunWaitOptions, type RunWaitDescription, type RunWaitTranslate, } from './runs/format-wait.js';
+export { useRealtimeTopic } from './hooks/use-realtime-topic.js';
+export { useAgentsApi } from './hooks/use-agents-api.js';
+export type { AgentsApi } from './api/client.js';
+//# sourceMappingURL=runs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../client/runs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,aAAa,EACb,cAAc,EACd,KAAK,UAAU,GAChB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,WAAW,EACX,WAAW,EACX,oBAAoB,EACpB,UAAU,EACV,iBAAiB,EACjB,KAAK,iBAAiB,GACvB,MAAM,qBAAqB,CAAC;AAE7B,oIAAoI;AACpI,OAAO,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC7E,qHAAqH;AACrH,OAAO,EACL,yBAAyB,EACzB,aAAa,EACb,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/client/runs.js

@@ -0,0 +1,15 @@
+/**
+ * The headless parts of a subject's runs, for the application's page that shows the subject (the assembling application presents them with
+ * the UI Library's `agent-run-history`): the runs themselves (`useSubjectRuns`), the agents' names, one run with its live
+ * transcript, stopping and retrying a run, its brief, and cleaning the subject's working directory. Every hook reads
+ * this plugin's shared cache, whichever cache is above it.
+ */
+export { useAgentNames, useSubjectRuns, } from './runs/subject-runs.js';
+export { useRetryRun, useRunBrief, useRunWithTranscript, useStopRun, useWorkspaceReset, } from './runs/run-hooks.js';
+/** A run's transcript fetched incrementally (`fetchMore` after each `runTopic(runId)` announcement), for a chat UI's live steps. */
+export { useRunEvents } from './runs/use-run-events.js';
+/** Why a queued run waits, in words, from the reason and `params` the server sends; for queue and progress views. */
+export { BLOCKING_RUN_WAIT_REASONS, formatRunWait, runWaitBlocks, } from './runs/format-wait.js';
+export { useRealtimeTopic } from './hooks/use-realtime-topic.js';
+export { useAgentsApi } from './hooks/use-agents-api.js';
+//# sourceMappingURL=runs.js.map

package/dist/client/runs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs.js","sourceRoot":"","sources":["../../client/runs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,aAAa,EACb,cAAc,GAEf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,WAAW,EACX,WAAW,EACX,oBAAoB,EACpB,UAAU,EACV,iBAAiB,GAElB,MAAM,qBAAqB,CAAC;AAE7B,oIAAoI;AACpI,OAAO,EAAE,YAAY,EAAuB,MAAM,0BAA0B,CAAC;AAC7E,qHAAqH;AACrH,OAAO,EACL,yBAAyB,EACzB,aAAa,EACb,aAAa,GAId,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/database/migrations/.manifest.json

@@ -0,0 +1,61 @@
+{
+  "version": 1,
+  "files": {
+    "202610020001_ag_create_agents.js": {
+      "sourceChecksum": "3f94284010da0780d761ce501c770301f49575b5eba889c0e448615e2290587e",
+      "artifactChecksum": "7cb38c3531bc482ee5c0ad1fdd3eac4da3e4c818cf12335db4d01b2401734391"
+    },
+    "202610020002_ag_create_runners.js": {
+      "sourceChecksum": "6f6167043484199d34e8ba4be50b6a07047f348c749f48d4a58dd35597bc8d51",
+      "artifactChecksum": "62277cdfcf0c7115061cf1d698535c431bdf0eb76b69e4c82638d963a5e62508"
+    },
+    "202610020003_ag_create_runs.js": {
+      "sourceChecksum": "2180bfe811de3456d2c019c21c916c9f2830191715add273b270ab506d2fea23",
+      "artifactChecksum": "c329dd3e80c7f81c3f0e8405cd7c8cea6c798eb074a890cc58cf36b49481e1c4"
+    },
+    "202610020004_ag_create_variables.js": {
+      "sourceChecksum": "ec0a8d2d21f859db08cd879f6bf0ef96f4231acf58810cfe20b3b2289867d7fb",
+      "artifactChecksum": "2649d14f0b4296218bd4df103788d65002dbd87fe2c49ae8d712fc3e7af2e15c"
+    },
+    "202610020005_ag_create_skills.js": {
+      "sourceChecksum": "3687afed58bbc1324ce77a3f4f6728e2e7f84ec482a8019228fd3220c400023c",
+      "artifactChecksum": "7c4b98ac2c0014c9c7fef636978e5c214cf2b35d0abe5da215134037ac682ca0"
+    },
+    "202610020006_ag_create_model_prices.js": {
+      "sourceChecksum": "192a520f89290ff2e46bcb3455e55152afa01673dfba7d0bdd71c97589cce1fe",
+      "artifactChecksum": "eea7d35cc458753bfb073a55eb13aa8fed7ac31e9410bbe5d9fff782f9966394"
+    },
+    "202610020008_ag_create_conversations.js": {
+      "sourceChecksum": "0a0458ae1dc5bfb35b0e7c3cead8c9dd1ec4f3004b44778ca04534af66ac7534",
+      "artifactChecksum": "beabac1310ba94dc12ed83df96b78e388ef4f6eec40d652fb8a6f4387e4288c6"
+    },
+    "202610020009_ag_create_jobs.js": {
+      "sourceChecksum": "12ab1c541e13f0e8825912cdec34719af52a920f258ce1b1b4d6e16c159ee515",
+      "artifactChecksum": "faaabb69a40043bdaa1f0eeaabcb69a6f205236b96dec5ad260e82ca45575e77"
+    },
+    "202610020010_ag_create_model_services.js": {
+      "sourceChecksum": "e23cd715379c484d0b2281f6342fadc582de01c752d4e1c80e4cd6bb96fc4846",
+      "artifactChecksum": "238210cc85992ec5d6b04de26395619f7f93025186824a81ff6d00ab5ae72f11"
+    },
+    "202610020011_ag_create_vectors.js": {
+      "sourceChecksum": "b8608995cf269184f35f85a7e28a6add046f1c2b3e9165bd09f4050bfe37a3f7",
+      "artifactChecksum": "40a27f13f8f9fb7b8806e1d963819df8020d2e2e51a4afc216e11392ec65eab5"
+    },
+    "202610060001_ag_add_runner_product.js": {
+      "sourceChecksum": "d1f00d8d650ead743891fcb21f581d33a5e90c540d8e336f083dfdbbb6890205",
+      "artifactChecksum": "572666d86426b0e57c6b8580fb9f68eab1838ce226f3d3f4049ebfc18cc5dd12"
+    },
+    "202610070001_ag_create_chat_attachments.js": {
+      "sourceChecksum": "08a1e92d80cb288e16a8771fe749c0882f952280d0ecd60997f62300fd6fb553",
+      "artifactChecksum": "a5484b3bc388cf0bd4e0bf687dcc63ade90092cf575d2d91464e106670f1f53c"
+    },
+    "202610080001_ag_add_runner_tool_slots.js": {
+      "sourceChecksum": "a8756535826a31f9c16a1920165f64771d177e0a44325ed9a1ce16398d1d39af",
+      "artifactChecksum": "6862d2be26245128b49cfd568fc7cda3a0276307b5b1a225eabc1e2f1acef8e2"
+    },
+    "202610090001_ag_add_team_runner_variables.js": {
+      "sourceChecksum": "7141d9615c4fdfdc8f26a50addc6b948426dca073b3fd1a747bd06506ac053d8",
+      "artifactChecksum": "1ed9075f7dc96de790e5523975dd72556d8310eee6455932eee4b3b8c1d256d0"
+    }
+  }
+}

package/dist/database/migrations/202610020001_ag_create_agents.d.ts

@@ -0,0 +1,4 @@
+import { type MigrationDefinition } from '@nocobase/db';
+declare const migration: MigrationDefinition;
+export default migration;
+//# sourceMappingURL=202610020001_ag_create_agents.d.ts.map

package/dist/database/migrations/202610020001_ag_create_agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"202610020001_ag_create_agents.d.ts","sourceRoot":"","sources":["../../../database/migrations/202610020001_ag_create_agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEzE,QAAA,MAAM,SAAS,EAAE,mBAyGf,CAAC;AAEH,eAAe,SAAS,CAAC"}