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

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

@@ -63,6 +63,8 @@ export function createBriefPreviewer(deps) {
                     subject: { kind: scenario, id: SAMPLE_SUBJECT_ID },
                     threadScope: DEFAULT_THREAD,
                     actorUserId: user.id,
+                    requestedByUserId: user.id,
+                    confirmedByUserId: null,
                     ownerUserId: null,
                     requires: [],
                     acceptsInput: false,

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

@@ -1 +1 @@
-{"version":3,"file":"preview.js","sourceRoot":"","sources":["../../../../server/core/runs/preview.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"preview.js","sourceRoot":"","sources":["../../../../server/core/runs/preview.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EACL,oBAAoB,EACpB,SAAS,EACT,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EACL,iBAAiB,EACjB,YAAY,GAEb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAA2C,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,kDAAkD;AAClD,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAC;AAoB1C;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,MAAc,EACd,YAA2B;IAE3B,MAAM,GAAG,GAAG,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACvC,MAAM,EAAE,GACN,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;IAC3E,OAAO;QACL,QAAQ,EAAE,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACnD,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;KAC9B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IASpC;IACC,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,UAAU,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAC9B,gBAAgB,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QAC7D,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI;YACnC,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC7C,IAAI,CAAC,KAAK;gBAAE,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;YACpC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;YACpD,IAAI,CAAC,MAAM;gBACT,MAAM,OAAO,CAAC,gCAAgC,QAAQ,GAAG,EAAE;oBACzD,KAAK,EAAE,UAAU;iBAClB,CAAC,CAAC;YACL,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;YAC3C,MAAM,MAAM,GAAwB,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI;gBAChE;oBACE,EAAE,EAAE,SAAS;oBACb,IAAI,EAAE,QAAQ;oBACd,EAAE,EAAE,GAAG;oBACP,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;oBACrD,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,kBAAkB,QAAQ,cAAc;oBAC1D,OAAO,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE;iBACjC;aACF,CAAC;YACF,MAAM,KAAK,GAAiB;gBAC1B,GAAG,EAAE;oBACH,EAAE,EAAE,SAAS;oBACb,OAAO,EAAE,KAAK,CAAC,EAAE;oBACjB,SAAS,EAAE,KAAK,CAAC,IAAI;oBACrB,QAAQ,EAAE,IAAI;oBACd,IAAI,EAAE,IAAI;oBACV,YAAY,EAAE,IAAI;oBAClB,KAAK,EAAE,IAAI;oBACX,MAAM,EAAE,IAAI;oBACZ,MAAM,EAAE,QAAQ;oBAChB,QAAQ,EAAE,CAAC;oBACX,OAAO,EAAE,CAAC;oBACV,WAAW,EAAE,KAAK,CAAC,WAAW;oBAC9B,YAAY,EAAE,IAAI;oBAClB,WAAW,EAAE,IAAI;oBACjB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,iBAAiB,EAAE;oBAClD,WAAW,EAAE,cAAc;oBAC3B,WAAW,EAAE,IAAI,CAAC,EAAE;oBACpB,iBAAiB,EAAE,IAAI,CAAC,EAAE;oBAC1B,iBAAiB,EAAE,IAAI;oBACvB,WAAW,EAAE,IAAI;oBACjB,QAAQ,EAAE,EAAE;oBACZ,YAAY,EAAE,KAAK;oBACnB,WAAW,EAAE,IAAI;oBACjB,cAAc,EAAE,IAAI;oBACpB,YAAY,EAAE,IAAI;oBAClB,SAAS,EAAE,IAAI;oBACf,UAAU,EAAE,IAAI;oBAChB,cAAc,EAAE,IAAI;oBACpB,iBAAiB,EAAE,IAAI;oBACvB,aAAa,EAAE,IAAI;oBACnB,aAAa,EAAE,IAAI;oBACnB,OAAO,EAAE,IAAI;oBACb,SAAS,EAAE,GAAG;oBACd,SAAS,EAAE,GAAG;iBACf;gBACD,KAAK;gBACL,MAAM,EAAE,IAAI;gBACZ,MAAM;gBACN,GAAG,EAAE,IAAI,CAAC,OAAO;gBACjB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC;aAC1B,CAAC;YACF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACpD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CACrC,IAAI,EACJ,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,EAC7B,SAAS,CACV,CAAC;YACF,MAAM,KAAK,GAAG,OAAO,CACnB,KAAK,EACL,MAAM,YAAY,CAChB,IAAI,EACJ,IAAI,CAAC,QAAQ,EACb,KAAK,EACL,QAAQ,EACR,MAAM,iBAAiB,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAC7D,EACD,MAAM,EACN,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,OAAO,CACb,CAAC;YACF,OAAO;gBACL,QAAQ;gBACR,OAAO,EAAE;oBACP,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG;oBACzB,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI;iBACtC;gBACD,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,YAAY,CAAC;gBAChD,YAAY,EAAE,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC;aAC5C,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,217 @@
+/**
+ * Run requests: work someone asked of an agent on a subject another person answers for. Work somebody else causes runs
+ * only with the consent of the subject's responsible, or on the asker's own account:
+ *
+ * - `enqueue` with a `responsibleUserId` whose source is someone else, and `execution` `auto`, stores a request here
+ *   instead of queueing anything (`run.service.ts`).
+ * - Only the responsible confirms (queued as them, the input as it was asked, its actor the asker) or rejects it; not
+ *   an administrator, not a manager of agents, not a run acting for anyone. A subject's responsible resolver checks
+ *   that they still answer for it; without one, the application must reassign on changes. Confirming rechecks access.
+ * - The asker withdraws it, or runs it as themselves on a runner they may use (`runAsRequester`).
+ * - When the subject's responsible changes, the application hands the pending requests on (`reassign`).
+ * - Nobody settling it within `RUN_REQUEST_TTL_MS` expires it (the sweeper's `expireDue`), and the asker hears they may
+ *   run it as themselves.
+ *
+ * A request leaves `pending` once and never changes status again.
+ */
+import type { ActorKind, RunInputType, RunStatus } from '@nocobase/agent-protocol';
+import type { DatabaseConnection, Repository } from '@nocobase/db';
+import type { Agent } from '../../../shared/agents.js';
+import type { RunRequest, RunRequestItem, RunRequestStatus } from '../../../shared/runs.js';
+import type { Clock } from '../../kernel/clock.js';
+import type { IdSource } from '../../kernel/ids.js';
+import type { People } from '../../kernel/people.js';
+import type { Tx, TxRunner } from '../../kernel/tx.js';
+/** How long a request waits for its responsible: seven days. */
+export declare const RUN_REQUEST_TTL_MS: number;
+export interface RunRequestRecord {
+    readonly id: string;
+    readonly agentId: string;
+    readonly subjectKind: string;
+    readonly subjectId: string;
+    readonly threadScope: string;
+    readonly responsibleUserId: string;
+    readonly requestedByUserId: string;
+    readonly ownerUserId: string | null;
+    readonly priority: number;
+    readonly requires: readonly unknown[];
+    readonly fireAt: string | null;
+    readonly maxAttempts: number | null;
+    readonly inputType: string;
+    readonly inputActorKind: string;
+    readonly inputActorId: string;
+    readonly inputActorName: string;
+    readonly inputText: string;
+    readonly inputPayload: unknown;
+    readonly status: RunRequestStatus;
+    readonly settledById: string | null;
+    readonly settledAt: string | null;
+    readonly note: string | null;
+    readonly expiresAt: string;
+    readonly runId: string | null;
+    readonly supersededById: string | null;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+export declare function runRequestsRepo(conn: DatabaseConnection): Repository<RunRequestRecord>;
+export declare function toRunRequest(record: RunRequestRecord): RunRequest;
+/** What a new request holds: the work as `enqueue` was asked for it. */
+export interface NewRunRequest {
+    readonly agentId: string;
+    readonly subject: {
+        readonly kind: string;
+        readonly id: string;
+    };
+    readonly threadScope: string;
+    readonly responsibleUserId: string;
+    readonly requestedByUserId: string;
+    readonly ownerUserId: string | null;
+    readonly priority: number;
+    readonly requires: readonly string[];
+    /** Not to be claimed before this moment; null for as soon as it is confirmed. */
+    readonly fireAt: string | null;
+    /** Attempts the run may take; null for the agent's default. */
+    readonly maxAttempts: number | null;
+    readonly input: {
+        readonly type: RunInputType;
+        readonly actor: {
+            readonly kind: ActorKind;
+            readonly id: string;
+            readonly name: string;
+        };
+        readonly text: string;
+        readonly payload?: unknown;
+    };
+}
+/** Stores a pending request in `unit` and announces it; it expires `RUN_REQUEST_TTL_MS` from now. */
+export declare function insertRunRequest(unit: Tx, deps: {
+    readonly ids: IdSource;
+    readonly clock: Clock;
+}, request: NewRunRequest): Promise<RunRequest>;
+/** A run a request went into, as `enqueue` answers it. */
+export interface RequestedRun {
+    readonly runId: string;
+    readonly outcome: 'created' | 'merged' | 'appended';
+    readonly status: RunStatus;
+    /** The request's input, as the run received it. */
+    readonly inputId: string;
+}
+/** Work queued straight away, as `runs.enqueue` queues it once nobody needs to confirm it. */
+export interface DirectRun {
+    readonly agent: Agent;
+    readonly subject: {
+        readonly kind: string;
+        readonly id: string;
+    };
+    readonly threadScope: string;
+    readonly actorUserId: string;
+    readonly requestedByUserId: string;
+    readonly confirmedByUserId: string | null;
+    readonly ownerUserId: string | null;
+    readonly priority: number;
+    readonly requires: readonly string[];
+    readonly fireAt: string | null;
+    readonly maxAttempts: number | null;
+    readonly input: NewRunRequest['input'];
+}
+export interface RunRequestFilter {
+    /** Only the requests this person answers for or asked. */
+    readonly userId: string;
+    /** `responsible`: the ones they answer for; `requester`: the ones they asked; both when left out. */
+    readonly role?: 'responsible' | 'requester';
+    readonly status?: RunRequestStatus;
+    readonly subject?: {
+        readonly kind: string;
+        readonly id?: string;
+    };
+    readonly agentId?: string;
+    readonly limit?: number;
+    /** The newest-first position to read after: the last request of the previous page. */
+    readonly cursor?: {
+        readonly createdAt: string;
+        readonly id: string;
+    };
+}
+/** What handing a subject's pending requests to a new responsible did. */
+export interface RunRequestReassignment {
+    /** The requests handed on, now `superseded`. */
+    readonly superseded: readonly RunRequest[];
+    /** The requests made for the new responsible in their place. */
+    readonly created: readonly RunRequest[];
+    /** Work the new responsible had asked for themselves, queued as them at once. */
+    readonly queued: readonly RequestedRun[];
+    /** Requests past their deadline or without a usable new responsible, expired with a notice instead of handed on. */
+    readonly expired: readonly RunRequest[];
+}
+export interface RunRequestService {
+    /** The request with the names its lists show; 404 when there is none. Whoever calls decides who may see it. */
+    get(requestId: string): Promise<RunRequestItem>;
+    /** The requests a person answers for or asked, newest first. */
+    list(filter: RunRequestFilter): Promise<RunRequestItem[]>;
+    /** The pending requests on a subject, of one agent or of any, oldest first; read on `conn`. */
+    pendingOn(conn: DatabaseConnection, subject: {
+        readonly kind: string;
+        readonly id: string;
+    }, agentId?: string): Promise<RunRequest[]>;
+    /**
+     * The responsible agrees: the work is queued as them with the input as it was asked (its actor the asker), joining
+     * their run on the subject when it can still be told. Only `byUserId` equal to the request's responsible, who may
+     * still wake the agent. The subject's current responsible resolver is checked when bound; otherwise the
+     * application must reassign requests on responsibility changes.
+     */
+    confirm(requestId: string, byUserId: string): Promise<{
+        readonly request: RunRequest;
+        readonly run: RequestedRun;
+    }>;
+    /** The responsible declines; only them. */
+    reject(requestId: string, byUserId: string, note?: string): Promise<RunRequest>;
+    /** The asker takes it back; only them. */
+    withdraw(requestId: string, byUserId: string): Promise<RunRequest>;
+    /**
+     * The asker runs it as themselves now, on a runner they may use (`NO_RUNNER_AVAILABLE` when none can run it): from a
+     * pending request, which is then withdrawn, or from one that expired without going anywhere. Only them.
+     */
+    runAsRequester(requestId: string, byUserId: string): Promise<{
+        readonly request: RunRequest;
+        readonly run: RequestedRun;
+    }>;
+    /**
+     * The subject's responsible changed (or it has none now, `toUserId` null): its pending requests (of one agent, or of
+     * any) are superseded and asked again of the new responsible, who must be able to wake the agent; one the new
+     * responsible had asked is queued as them at once. One whose time already ran out expires instead, neither renewed
+     * nor queued. In `outer`, joins the caller's transaction.
+     */
+    reassign(request: {
+        readonly subject: {
+            readonly kind: string;
+            readonly id: string;
+        };
+        readonly agentId?: string;
+        readonly toUserId: string | null;
+        readonly byUserId: string | null;
+        readonly note?: string;
+    }, outer?: Tx): Promise<RunRequestReassignment>;
+    /** Expires the pending requests whose time is up, and tells their askers; answers how many. */
+    expireDue(): Promise<number>;
+}
+export interface RunRequestDeps {
+    readonly tx: TxRunner;
+    readonly ids: IdSource;
+    readonly clock: Clock;
+    readonly people: Pick<People, 'names'>;
+    /** Undefined when the subject has no resolver; otherwise its current responsible (null when unassigned). */
+    readonly currentResponsible?: (unit: Tx, subject: {
+        readonly kind: string;
+        readonly id: string;
+    }) => Promise<string | null> | undefined;
+    /** Whether the person may wake the agent. */
+    readonly mayInvoke: (agent: Agent, userId: string) => boolean;
+    /** The agent, if it can be woken by `userId`; refuses otherwise (`run.service.ts`'s check). */
+    readonly requireInvocable: (unit: Tx, agentId: string, userId: string) => Promise<Agent>;
+    /** Refuses with `NO_RUNNER_AVAILABLE` when no runner `userId` may use can run the agent now. */
+    readonly requireRunnerFor: (unit: Tx, agent: Agent, userId: string, requires: readonly string[]) => Promise<void>;
+    /** Queues work at once (`run.service.ts`). */
+    readonly direct: (unit: Tx, run: DirectRun) => Promise<RequestedRun>;
+}
+export declare function createRunRequestService(deps: RunRequestDeps): RunRequestService;
+//# sourceMappingURL=run-requests.d.ts.map

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

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