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

package/dist/server/online/executor.d.ts

@@ -0,0 +1,83 @@
+import { type ToolSet } from 'ai';
+import { type FailureReason, type RunSkill } from '@nocobase/agent-protocol';
+import type { Clock } from '../kernel/clock.js';
+import type { CallerIdentity } from '../core/callers/index.js';
+import type { WorkSignal } from '../runners/signal.js';
+import type { ConsultationService } from '../core/consultations/index.js';
+import type { ConversationService } from '../core/conversations/index.js';
+import type { ClaimService, RunnerReports, RunService, ServerClaim } from '../core/runs/index.js';
+import { type ModelErrorCode, type ModelGateway } from './gateway.js';
+import { type CommandSurface } from './cli-command.js';
+import { type OnlineSkill } from './sandbox.js';
+import { type ServerTool } from './tools.js';
+/**
+ * The session id a run's model calls send in the session header an OpenCode base URL requires
+ * (`x-opencode-session`): the same for every run of one conversation — its subject and thread — so the provider
+ * routes and caches it as one, and a hash, so it names neither.
+ */
+export declare function sessionOf(run: Pick<ServerClaim['run'], 'subject' | 'threadScope'>): string;
+/** Model calls a run may make before it fails `stepLimit`. */
+export declare const DEFAULT_MAX_STEPS = 16;
+/** How long a consultation may take, by default. */
+export declare const DEFAULT_CONSULT_TIMEOUT_MS = 120000;
+/** The tokens a consultation may use (input and output, of every model call), by default. */
+export declare const DEFAULT_CONSULT_TOKEN_BUDGET = 200000;
+export interface ServerExecutorOptions {
+    /** Model calls per run; `DEFAULT_MAX_STEPS`. */
+    readonly maxSteps?: number;
+    /** How long to wait for work when not signalled; 2 s. */
+    readonly idlePollMs?: number;
+    /** `server:<random>` by default; set in tests to tell instances apart. */
+    readonly holderId?: string;
+    /** How often the SDK retries a failed model request itself; 2. */
+    readonly maxRetries?: number;
+    /** A consultation's bounds (`ask_agent`): `timeoutMs` (2 minutes) and `tokenBudget` (200,000). */
+    readonly consult?: {
+        readonly timeoutMs?: number;
+        readonly tokenBudget?: number;
+    };
+}
+export interface ServerExecutorDeps {
+    readonly clock: Clock;
+    readonly claims: Pick<ClaimService, 'claimServer' | 'claimChild'>;
+    readonly reports: RunnerReports;
+    readonly runs: Pick<RunService, 'authenticateToken' | 'get'>;
+    readonly conversations: Pick<ConversationService, 'streamDraft' | 'syncRun' | 'consultation'>;
+    /** Where `ask_agent` starts a consultation; runs never consult without it. */
+    readonly consultations?: Pick<ConsultationService, 'start'>;
+    /** The application's commands a run may run, called with its token; none without a command manifest. */
+    readonly commands: (identity: CallerIdentity, token: string) => Promise<CommandSurface | undefined>;
+    /** One of the run's skills, read for its shell. */
+    readonly skill: (skill: RunSkill) => Promise<OnlineSkill>;
+    /** Skills every online run gets besides its own (`online.skills`). */
+    readonly builtInSkills?: () => readonly OnlineSkill[];
+    /**
+     * The images among the files sent with a conversation's message (its input's `payload.attachmentIds`), at most
+     * `maxBytes` each, shown to the model with the message; without it the files are only listed by name.
+     */
+    readonly images?: (conversationId: string, ids: readonly string[], maxBytes: number) => Promise<{
+        readonly mediaType: string;
+        readonly data: Uint8Array;
+    }[]>;
+    readonly gateway: Pick<ModelGateway, 'languageModel'>;
+    readonly signal: WorkSignal;
+    readonly onError?: (message: string, error: unknown) => void;
+}
+export interface ServerExecutor {
+    /** This instance's holder id (`server:…`). */
+    readonly id: string;
+    /** Starts taking online runs as they are queued. */
+    start(): void;
+    /** Stops taking runs, hands back the ones it holds, and waits for them. */
+    stop(): Promise<void>;
+    /** Takes what is queued now and runs it to its end; the number of runs taken. For tests and one-off use. */
+    drain(): Promise<number>;
+    /** Runs held now. */
+    active(): number;
+}
+/** The failure reason of a model error code. */
+export declare function failureOf(code: ModelErrorCode): FailureReason;
+/** The run's tools as the SDK runs them: each answers `{ ok, output }`, and the model reads `output`. */
+export declare function toolSetOf(tools: readonly ServerTool[]): ToolSet;
+export declare function createServerExecutor(deps: ServerExecutorDeps, options?: ServerExecutorOptions): ServerExecutor;
+//# sourceMappingURL=executor.d.ts.map

package/dist/server/online/executor.d.ts.map

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