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

package/dist/shared/access.d.ts

@@ -0,0 +1,154 @@
+/**
+ * What this plugin offers to be granted: its pages and its settings items. The application that assembles the plugin
+ * keeps the roles, and composes these declarations with its other plugins' into one role catalog.
+ *
+ * - The pages (`page` grants, action `access`) are the Agent team section: agents, runtimes (with "Add runtime"),
+ *   skills and usage. A page grant only opens the page; what the page shows and changes is governed by the settings
+ *   items below. The usage page's API (`GET agents/usage`) checks
+ *   its grant too, and counts every run for a reader of agents.
+ * - `agents.agents` covers agents, skills and every run; reading lets someone see them (and every runner, to pick
+ *   where an agent runs), managing lets them change agents and skills and cancel or retry any run. Without it, a
+ *   person still sees and cancels the runs they started.
+ * - `agents.runners` covers every runner and every job: reading lets someone see them, managing lets them change,
+ *   revoke and delete any runner and add one shared with the team. Without it, a person still adds personal runners
+ *   and manages the ones they added; reading agents also shows every runner (to pick where an agent runs).
+ * - `agents.prices` covers the model prices costs are estimated from: reading shows them, managing changes them.
+ * - `agents.services` covers the model services online agents call: reading lists them (never their keys), managing
+ *   adds, edits, tests and deletes them, fetches a provider's models and sets their keys. Picking a service and a model
+ *   for an agent needs neither: the catalog names what is offered.
+ * - The `agents.agents` business action `edit` reaches further than none or every agent: for a set of users it reaches
+ *   the agents they own and the skills they created, without managing agents (see `BUSINESS_ACTIONS`). The plugin
+ *   registers it as the `agents` resource type, each level its own action (`edit.related`, `edit.all`).
+ */
+/** The namespace of every title below, in the plugin's locales. */
+export declare const ACCESS_NAMESPACE = "@nocobase/app-plugin-agents";
+export declare function accessText(key: string): {
+    readonly key: string;
+    readonly ns: string;
+};
+/** The app pages a role may open; the client routes (`client/routes.ts`) are named and authorized by the same ids. */
+export declare const PAGES: readonly ["agents", "runtimes", "skills", "usage"];
+export type Page = (typeof PAGES)[number];
+export declare const SETTINGS_ACTIONS: {
+    readonly 'agents.agents': readonly ["read", "manage"];
+    readonly 'agents.runners': readonly ["read", "manage"];
+    readonly 'agents.prices': readonly ["read", "manage"];
+    readonly 'agents.services': readonly ["read", "manage"];
+};
+export type SettingsItem = keyof typeof SETTINGS_ACTIONS;
+export type SettingsAction = 'read' | 'manage';
+/**
+ * Business actions, each reaching every record, none, or the records related to a set of users (`Scope`). The
+ * application that keeps the roles tells the plugin a caller's scope (`agentsAccessToken`); managing agents
+ * (`agents.agents` `manage` above) reaches every record whatever the scope.
+ *
+ * | Action               | What it allows                                                                              |
+ * | -------------------- | ------------------------------------------------------------------------------------------- |
+ * | `agents.agents/edit` | change an agent (its settings, skills and variables; archive, restore and delete it) and   |
+ * |                      | edit a skill (save it, restore a version). Related to a user: the agents they own, the      |
+ * |                      | skills they created. Creating agents and skills, and deleting skills, still needs `manage`. |
+ *
+ * An agent edited this way is still given only what its editor may grant: someone who does not manage agents adds to
+ * an agent only the business actions they hold themselves, and does not hand the agent to another owner.
+ */
+export declare const BUSINESS_ACTIONS: {
+    readonly 'agents.agents': readonly ["edit"];
+};
+export type Business = keyof typeof BUSINESS_ACTIONS;
+export type BusinessAction<B extends Business = Business> = (typeof BUSINESS_ACTIONS)[B][number];
+/** `business/action`, the key of a level. */
+export type BusinessKey = {
+    [B in Business]: `${B}/${BusinessAction<B>}`;
+}[Business];
+/** Every business action, in declaration order. */
+export declare const BUSINESS_KEYS: readonly {
+    readonly business: Business;
+    readonly action: BusinessAction;
+    readonly key: BusinessKey;
+}[];
+/**
+ * How far a business action reaches for a caller: every record, none, or the records related to any of `users`
+ * (`RELATIONS`). The application resolves the level a role gives to this; an empty set reaches nothing.
+ */
+export type Scope = 'all' | 'none' | {
+    readonly users: readonly string[];
+};
+/** Whether `scope` reaches a record related to any of `userIds` (null and undefined relate nothing). */
+export declare function reaches(scope: Scope, ...userIds: readonly (string | null | undefined)[]): boolean;
+/** How a record relates to a user, as the application words it: the agents they own and the skills they created. */
+export type Relation = 'own';
+/** Each business action's relation; null where the action has no records to relate, so it is held or not. */
+export declare const RELATIONS: Readonly<Record<BusinessKey, Relation | null>>;
+/** The authorization resource type the businesses are registered under; every business id starts with it. */
+export declare const RESOURCE_TYPE = "agents";
+/** The permission workspace subsection (under business) that lists the businesses. */
+export declare const BUSINESS_SECTION = "agents.business";
+/**
+ * The levels an action whose records relate to users (`RELATIONS`) is registered at, lowest first, each its own
+ * authorization action: `edit.related` reaches the related records, `edit.all` every one. An action without related
+ * records is registered as itself, held or not. Holding a level reaches at least what the lower ones do, so the
+ * application takes the highest one held.
+ */
+export declare const ACTION_LEVELS: readonly ["related", "all"];
+export type ActionLevel = (typeof ACTION_LEVELS)[number];
+/** The authorization actions a business action is registered as, lowest level first. */
+export declare function levelActionsOf(key: BusinessKey): readonly {
+    readonly level: ActionLevel;
+    readonly name: string;
+}[];
+/** A business's title or its one-line description (`access.businesses.agents.title`). */
+export declare function businessText(business: Business, part: 'title' | 'description'): {
+    readonly key: string;
+    readonly ns: string;
+};
+/**
+ * A business action's title, its one-line description, the title of one of its levels, or the wording of its `related`
+ * level: `relatedLabel`, its short name in a level choice ("in projects I can see"), and `relatedHint`, one line on what
+ * it reaches. An application reads the last two beside the `related` level's registered title.
+ */
+export declare function actionText(key: BusinessKey, part: 'title' | 'description' | ActionLevel | 'relatedLabel' | 'relatedHint'): {
+    readonly key: string;
+    readonly ns: string;
+};
+/** The authorization workspace subsection (under administration) that lists the settings items. */
+export declare const ACCESS_SECTION = "agents";
+/**
+ * One permission a key-scope level covers: a page, a settings action or a business action. The same shape as the API
+ * keys plugin's `AccessRef`, written here so this plugin does not depend on it; the application assembles the groups.
+ */
+export type KeyScopeAccess = {
+    readonly kind: 'page';
+    readonly id: Page;
+} | {
+    readonly kind: 'settings';
+    readonly id: SettingsItem;
+    readonly action: SettingsAction;
+} | {
+    readonly kind: 'business';
+    readonly id: Business;
+    readonly action: BusinessAction;
+};
+/** A permission group a scoped API key may hold, structurally the API keys plugin's `KeyScopeGroupDeclaration`. */
+export interface KeyScopeGroup {
+    readonly id: string;
+    readonly category: 'business' | 'administration' | 'account';
+    readonly title: {
+        readonly key: string;
+        readonly ns: string;
+    };
+    readonly description?: {
+        readonly key: string;
+        readonly ns: string;
+    };
+    readonly levels: {
+        readonly read?: readonly KeyScopeAccess[];
+        readonly write?: readonly KeyScopeAccess[];
+    };
+}
+/**
+ * What a scoped key may be given here. None of them limits to some records: agents and prices have no record-level
+ * checks to enforce a selection. Writing agents covers editing them at whatever level the key's user
+ * holds.
+ */
+export declare const KEY_SCOPE_GROUPS: readonly KeyScopeGroup[];
+//# sourceMappingURL=access.d.ts.map

package/dist/shared/access.d.ts.map

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

package/dist/shared/access.js

@@ -0,0 +1,166 @@
+/**
+ * What this plugin offers to be granted: its pages and its settings items. The application that assembles the plugin
+ * keeps the roles, and composes these declarations with its other plugins' into one role catalog.
+ *
+ * - The pages (`page` grants, action `access`) are the Agent team section: agents, runtimes (with "Add runtime"),
+ *   skills and usage. A page grant only opens the page; what the page shows and changes is governed by the settings
+ *   items below. The usage page's API (`GET agents/usage`) checks
+ *   its grant too, and counts every run for a reader of agents.
+ * - `agents.agents` covers agents, skills and every run; reading lets someone see them (and every runner, to pick
+ *   where an agent runs), managing lets them change agents and skills and cancel or retry any run. Without it, a
+ *   person still sees and cancels the runs they started.
+ * - `agents.runners` covers every runner and every job: reading lets someone see them, managing lets them change,
+ *   revoke and delete any runner and add one shared with the team. Without it, a person still adds personal runners
+ *   and manages the ones they added; reading agents also shows every runner (to pick where an agent runs).
+ * - `agents.prices` covers the model prices costs are estimated from: reading shows them, managing changes them.
+ * - `agents.services` covers the model services online agents call: reading lists them (never their keys), managing
+ *   adds, edits, tests and deletes them, fetches a provider's models and sets their keys. Picking a service and a model
+ *   for an agent needs neither: the catalog names what is offered.
+ * - The `agents.agents` business action `edit` reaches further than none or every agent: for a set of users it reaches
+ *   the agents they own and the skills they created, without managing agents (see `BUSINESS_ACTIONS`). The plugin
+ *   registers it as the `agents` resource type, each level its own action (`edit.related`, `edit.all`).
+ */
+/** The namespace of every title below, in the plugin's locales. */
+export const ACCESS_NAMESPACE = '@nocobase/app-plugin-agents';
+export function accessText(key) {
+    return { key: `access.${key}`, ns: ACCESS_NAMESPACE };
+}
+/** The app pages a role may open; the client routes (`client/routes.ts`) are named and authorized by the same ids. */
+export const PAGES = ['agents', 'runtimes', 'skills', 'usage'];
+export const SETTINGS_ACTIONS = {
+    'agents.agents': ['read', 'manage'],
+    'agents.runners': ['read', 'manage'],
+    'agents.prices': ['read', 'manage'],
+    'agents.services': ['read', 'manage'],
+};
+/**
+ * Business actions, each reaching every record, none, or the records related to a set of users (`Scope`). The
+ * application that keeps the roles tells the plugin a caller's scope (`agentsAccessToken`); managing agents
+ * (`agents.agents` `manage` above) reaches every record whatever the scope.
+ *
+ * | Action               | What it allows                                                                              |
+ * | -------------------- | ------------------------------------------------------------------------------------------- |
+ * | `agents.agents/edit` | change an agent (its settings, skills and variables; archive, restore and delete it) and   |
+ * |                      | edit a skill (save it, restore a version). Related to a user: the agents they own, the      |
+ * |                      | skills they created. Creating agents and skills, and deleting skills, still needs `manage`. |
+ *
+ * An agent edited this way is still given only what its editor may grant: someone who does not manage agents adds to
+ * an agent only the business actions they hold themselves, and does not hand the agent to another owner.
+ */
+export const BUSINESS_ACTIONS = {
+    'agents.agents': ['edit'],
+};
+/** Every business action, in declaration order. */
+export const BUSINESS_KEYS = Object.entries(BUSINESS_ACTIONS).flatMap(([business, actions]) => actions.map((action) => ({
+    business: business,
+    action: action,
+    key: `${business}/${action}`,
+})));
+/** Whether `scope` reaches a record related to any of `userIds` (null and undefined relate nothing). */
+export function reaches(scope, ...userIds) {
+    if (scope === 'all')
+        return true;
+    if (scope === 'none')
+        return false;
+    return userIds.some((id) => !!id && scope.users.includes(id));
+}
+/** Each business action's relation; null where the action has no records to relate, so it is held or not. */
+export const RELATIONS = {
+    'agents.agents/edit': 'own',
+};
+/** The authorization resource type the businesses are registered under; every business id starts with it. */
+export const RESOURCE_TYPE = 'agents';
+/** The permission workspace subsection (under business) that lists the businesses. */
+export const BUSINESS_SECTION = 'agents.business';
+/**
+ * The levels an action whose records relate to users (`RELATIONS`) is registered at, lowest first, each its own
+ * authorization action: `edit.related` reaches the related records, `edit.all` every one. An action without related
+ * records is registered as itself, held or not. Holding a level reaches at least what the lower ones do, so the
+ * application takes the highest one held.
+ */
+export const ACTION_LEVELS = ['related', 'all'];
+/** The authorization actions a business action is registered as, lowest level first. */
+export function levelActionsOf(key) {
+    const action = key.slice(key.indexOf('/') + 1);
+    return RELATIONS[key]
+        ? ACTION_LEVELS.map((level) => ({ level, name: `${action}.${level}` }))
+        : [{ level: 'all', name: action }];
+}
+const localName = (business) => business.slice(business.indexOf('.') + 1);
+/** A business's title or its one-line description (`access.businesses.agents.title`). */
+export function businessText(business, part) {
+    return accessText(`businesses.${localName(business)}.${part}`);
+}
+/**
+ * A business action's title, its one-line description, the title of one of its levels, or the wording of its `related`
+ * level: `relatedLabel`, its short name in a level choice ("in projects I can see"), and `relatedHint`, one line on what
+ * it reaches. An application reads the last two beside the `related` level's registered title.
+ */
+export function actionText(key, part) {
+    const [business = '', action = ''] = key.split('/');
+    return accessText(`businesses.${localName(business)}.actions.${action}.${part}`);
+}
+/** The authorization workspace subsection (under administration) that lists the settings items. */
+export const ACCESS_SECTION = 'agents';
+const setting = (id, action) => ({
+    kind: 'settings',
+    id,
+    action,
+});
+/**
+ * What a scoped key may be given here. None of them limits to some records: agents and prices have no record-level
+ * checks to enforce a selection. Writing agents covers editing them at whatever level the key's user
+ * holds.
+ */
+export const KEY_SCOPE_GROUPS = [
+    {
+        id: 'agents.agents',
+        category: 'business',
+        title: accessText('keyScopes.agents.title'),
+        description: accessText('keyScopes.agents.description'),
+        levels: {
+            read: [
+                { kind: 'page', id: 'agents' },
+                { kind: 'page', id: 'skills' },
+                setting('agents.agents', 'read'),
+            ],
+            write: [
+                setting('agents.agents', 'manage'),
+                { kind: 'business', id: 'agents.agents', action: 'edit' },
+            ],
+        },
+    },
+    {
+        id: 'agents.prices',
+        category: 'administration',
+        title: accessText('keyScopes.prices.title'),
+        description: accessText('keyScopes.prices.description'),
+        levels: {
+            read: [setting('agents.prices', 'read')],
+            write: [setting('agents.prices', 'manage')],
+        },
+    },
+    {
+        id: 'agents.runners',
+        category: 'administration',
+        title: accessText('keyScopes.runners.title'),
+        description: accessText('keyScopes.runners.description'),
+        levels: {
+            read: [
+                { kind: 'page', id: 'runtimes' },
+                setting('agents.runners', 'read'),
+            ],
+            write: [setting('agents.runners', 'manage')],
+        },
+    },
+    {
+        // Reading only: managing sets provider keys, which a person does (the application lists `agents.services/manage`
+        // among what no key holds).
+        id: 'agents.services',
+        category: 'administration',
+        title: accessText('keyScopes.services.title'),
+        description: accessText('keyScopes.services.description'),
+        levels: { read: [setting('agents.services', 'read')] },
+    },
+];
+//# sourceMappingURL=access.js.map

package/dist/shared/access.js.map

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

package/dist/shared/agents.d.ts

@@ -0,0 +1,284 @@
+/**
+ * Agents as the browser and the server's admin API exchange them.
+ *
+ * An agent is who works and how: its name and instructions, its type, the business actions it may perform. Its type is
+ * chosen when it is created and never changes:
+ *
+ * - `runner`: it drives a coding tool on a runner, with its skills, its tool policy and its own
+ *   variables. Where it runs is not configured beyond an optional list of runners: a run goes to any online runner that
+ *   has one of its tools installed and signed in, may run the waking person's work, and has a free slot.
+ * - `online`: it talks to a model of a model service directly, on the server: no runner, no working directory, no
+ *   variables. Its tools are the application's commands it may run, and whatever else the application offers
+ *   (knowledge search). It answers in seconds and runs only on subjects that need no working directory, such as
+ *   conversations.
+ *
+ * Which tool or model it works with, and with what reasoning effort, is an ordered list (`modelEntries`), the first
+ * being its default. A runner takes a runner agent's run with the first entry whose tool it has enabled and signed in;
+ * nobody chooses. An online agent's runs use the first entry, except in a conversation, whose owner may pick another of
+ * its entries. The run records the entry it used (`Run.tool`, `Run.modelService`, `Run.model`, `Run.effort`).
+ *
+ * An online agent with no entry is not configured yet (such as an application's built-in assistant before a model service exists): it is
+ * kept, shown as needing a model, and offered no work until an entry is added. A runner agent always has one.
+ */
+import { type AgentTool, type ToolPolicy } from '@nocobase/agent-protocol';
+import type { I18nText } from './i18n.js';
+/** Who may wake an agent: its owner, the listed users, or everyone. */
+export declare const AGENT_ACCESS: readonly ["ownerOnly", "users", "everyone"];
+export type AgentAccess = (typeof AGENT_ACCESS)[number];
+/** What kind of agent it is; chosen at creation and never changed (`runner`: a coding tool on a runner, `online`: a model on the server). */
+export declare const AGENT_TYPES: readonly ["online", "runner"];
+export type AgentType = (typeof AGENT_TYPES)[number];
+/**
+ * When an agent in a conversation asks the person before changing data for them: `always` (every change goes through an
+ * operation plan they confirm) or `larger` (small changes are made directly, within the application's direct-write
+ * rules, and anything larger goes through a plan). There is no "never": what the rules call larger (waking an agent,
+ * finishing an issue, changing an owner, …) always needs the person's confirmation.
+ */
+export declare const CONFIRM_CHANGES: readonly ["always", "larger"];
+export type ConfirmChanges = (typeof CONFIRM_CHANGES)[number];
+/** The reasoning efforts an online agent's entry may name, weakest first, as the model gateway passes them to providers. */
+export declare const ONLINE_EFFORTS: readonly ["minimal", "low", "medium", "high", "xhigh"];
+/**
+ * An entry of a runner agent's list: a coding tool, its model (null: the tool's default) and its reasoning effort, one
+ * of the tool's (`TOOL_EFFORTS`; null or absent: the tool's default).
+ */
+export interface RunnerModelEntry {
+    readonly tool: AgentTool;
+    readonly model: string | null;
+    readonly effort?: string | null;
+}
+/**
+ * An entry of an online agent's list: a model service (its name among the application's), one of its models, and its
+ * reasoning effort (`ONLINE_EFFORTS`; null or absent: the provider's default).
+ */
+export interface OnlineModelEntry {
+    readonly modelService: string;
+    readonly model: string;
+    readonly effort?: string | null;
+}
+/** A tool and model an agent may work with; a runner agent's entries are all `RunnerModelEntry`, an online agent's all `OnlineModelEntry`. */
+export type AgentModelEntry = RunnerModelEntry | OnlineModelEntry;
+/** The most entries an agent's list holds. */
+export declare const MAX_MODEL_ENTRIES = 20;
+export declare function isRunnerEntry(entry: AgentModelEntry): entry is RunnerModelEntry;
+export declare function isOnlineEntry(entry: AgentModelEntry): entry is OnlineModelEntry;
+/** The reasoning efforts `entry` may name: its tool's for a runner entry, `ONLINE_EFFORTS` for an online one. */
+export declare function effortsFor(entry: {
+    readonly tool: AgentTool;
+} | {
+    readonly modelService: string;
+}): readonly string[];
+/** A runner agent's entries, in order; empty for an online agent. */
+export declare function runnerEntries(agent: {
+    readonly modelEntries: readonly AgentModelEntry[];
+}): RunnerModelEntry[];
+/** An online agent's entries, in order; empty for a runner agent. */
+export declare function onlineEntries(agent: {
+    readonly modelEntries: readonly AgentModelEntry[];
+}): OnlineModelEntry[];
+/**
+ * The entries an online agent answers with: its own, or, when it lists none, the system default chat model
+ * (`DefaultModels`) as its only one; empty for a runner agent or when there is no default either.
+ */
+export declare function onlineEntriesOrDefault(agent: {
+    readonly type: AgentType;
+    readonly modelEntries: readonly AgentModelEntry[];
+}, defaultModel: {
+    readonly modelService: string;
+    readonly model: string;
+} | null): OnlineModelEntry[];
+/** The coding tools a runner agent's entries name, in order and once each; empty for an online agent. */
+export declare function entryTools(agent: {
+    readonly modelEntries: readonly AgentModelEntry[];
+}): AgentTool[];
+/** Whether two entries name the same tool or service and model, whatever their efforts. */
+export declare function sameEntry(a: AgentModelEntry, b: AgentModelEntry): boolean;
+export interface Agent {
+    readonly id: string;
+    /** As written; for an agent the application ships, the English its `nameText` translates. */
+    readonly name: string;
+    readonly description: string | null;
+    /**
+     * For an agent the application ships (such as an application's built-in agents): its name and description as i18n references, shown
+     * in the viewer's language in place of `name` and `description`. Editing a field drops its reference, so the text
+     * someone wrote shows as written. Null otherwise.
+     */
+    readonly nameText: I18nText | null;
+    readonly descriptionText: I18nText | null;
+    /** An image URL; null shows the bot icon. */
+    readonly avatar: string | null;
+    /** Immutable. */
+    readonly type: AgentType;
+    /**
+     * The tools and models it works with, each with its reasoning effort, in order; the first is its default. Never empty
+     * for a runner agent; empty for an online agent not configured yet.
+     */
+    readonly modelEntries: readonly AgentModelEntry[];
+    /** Rendered as the last layer of the brief; they are preferences and never override the rules or the task. */
+    readonly instructions: string | null;
+    /** Business action keys the agent may perform, within what the person who woke it may do. */
+    readonly actions: readonly string[];
+    /** In conversations: whether it asks before every change or only before larger ones. */
+    readonly confirmChanges: ConfirmChanges;
+    readonly access: AgentAccess;
+    /** For access `users`. */
+    readonly userIds: readonly string[];
+    readonly ownerUserId: string;
+    /** Run only on these runners; empty: any runner that fits. */
+    readonly runnerIds: readonly string[];
+    /** The skills attached to the agent, in the skill library. */
+    readonly skillIds: readonly string[];
+    readonly maxConcurrentRuns: number;
+    readonly maxAttempts: number;
+    /** Overrides of the default tool policy (`DEFAULT_TOOL_POLICY`). */
+    readonly toolPolicy: Partial<ToolPolicy> | null;
+    readonly archivedAt: string | null;
+    /**
+     * Raised by every change to its configuration (editing, archiving, restoring). An edit names the revision it was
+     * made against (`AgentPatch.expectedRevision`) and is refused with 409 when the agent changed since.
+     */
+    readonly revision: number;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+/** An agent in the list: with what the list shows about its runs and runners. */
+export interface AgentSummary extends Agent {
+    readonly ownerName: string | null;
+    /** Runs dispatched or running now. */
+    readonly activeRuns: number;
+    /**
+     * `runner`: online runners that have the agent's tool installed and signed in, among `runnerIds` when it names any.
+     * `online`: 1 while its model service offers its model, else 0.
+     */
+    readonly onlineRunners: number;
+    /**
+     * Whether the caller may change it: edit, archive, restore and delete it and set its variables. Managers of agents
+     * may change every agent; others the agents their role's "related" level reaches (the ones they own).
+     */
+    readonly canEdit: boolean;
+    /** Whether the caller may wake it, and so make a private copy of it for themselves (`ChatApi.copyAgent`). */
+    readonly canCopy: boolean;
+}
+/** An agent the caller may give work to: what it is good at, and whether it can take work now. */
+export interface AvailableAgent {
+    readonly id: string;
+    readonly name: string;
+    /** Its description. */
+    readonly goodAt: string;
+    readonly type: AgentType;
+    /** A runner agent's default coding tool (its first entry's); null for an online agent. */
+    readonly tool: AgentTool | null;
+    /** Whether it could start work now: an online runner that fits it, or its model offered. */
+    readonly online: boolean;
+    /** Its runs that have not finished. */
+    readonly busy: number;
+}
+/**
+ * What creating an agent takes; updating takes any subset but `type`, which an agent keeps for good. A `runner` agent
+ * needs at least one entry in `modelEntries`, each naming a coding tool; an `online` agent's entries name model services
+ * and their models, and it may have none until one is configured. Each entry may name a reasoning effort its tool or
+ * service takes (`effortsFor`). An `online` agent takes no runners, tool policy or variables.
+ */
+export interface AgentInput {
+    readonly name: string;
+    readonly description?: string | null;
+    readonly avatar?: string | null;
+    /** `runner` by default. */
+    readonly type?: AgentType;
+    readonly modelEntries?: readonly AgentModelEntry[];
+    readonly instructions?: string | null;
+    readonly actions?: readonly string[];
+    /** `larger` by default. */
+    readonly confirmChanges?: ConfirmChanges;
+    readonly access?: AgentAccess;
+    readonly userIds?: readonly string[];
+    /** Defaults to the creator. */
+    readonly ownerUserId?: string;
+    readonly runnerIds?: readonly string[];
+    readonly skillIds?: readonly string[];
+    readonly maxConcurrentRuns?: number;
+    readonly maxAttempts?: number;
+    readonly toolPolicy?: Partial<ToolPolicy> | null;
+}
+/**
+ * What updating an agent takes (`PATCH /api/agents/:agentId`): any fields of the input, and the revision the edit was made
+ * against. A stale revision is refused with 409 `REVISION_CONFLICT` (`metadata.revision` the
+ * current one).
+ */
+export type AgentPatch = Partial<Omit<AgentInput, 'type'>> & {
+    readonly expectedRevision: number;
+};
+/** What a change to an agent's configuration was. */
+export declare const AGENT_CHANGE_ACTIONS: readonly ["created", "updated", "archived", "restored", "variables"];
+export type AgentChangeAction = (typeof AGENT_CHANGE_ACTIONS)[number];
+/** The fields of an agent whose changes its history records, in the order the history shows them. */
+export declare const AGENT_HISTORY_FIELDS: readonly ["name", "description", "avatar", "instructions", "type", "modelEntries", "skillIds", "actions", "confirmChanges", "toolPolicy", "runnerIds", "maxConcurrentRuns", "maxAttempts", "access", "userIds", "ownerUserId"];
+export type AgentHistoryField = (typeof AGENT_HISTORY_FIELDS)[number];
+/** Fields no longer recorded that older history entries still carry, so the history can still name them. */
+export declare const RETIRED_AGENT_HISTORY_FIELDS: readonly ["tool", "model", "llmService", "modelService", "reasoningEffort"];
+/**
+ * One field that changed. A variable is a secret: it is named (`name`) with what happened to it (`change`), never with
+ * its value.
+ */
+export type AgentFieldChange = {
+    readonly field: AgentHistoryField;
+    readonly before: unknown;
+    readonly after: unknown;
+} | {
+    readonly field: 'variable';
+    readonly name: string;
+    readonly change: 'added' | 'changed' | 'removed';
+};
+/** An entry of an agent's history (`GET /api/agents/:agentId/history`), newest first. */
+export interface AgentChange {
+    readonly id: string;
+    readonly agentId: string;
+    /** The agent's revision after the change. */
+    readonly revision: number;
+    readonly action: AgentChangeAction;
+    readonly actorUserId: string | null;
+    readonly actorName: string | null;
+    readonly changes: readonly AgentFieldChange[];
+    readonly createdAt: string;
+}
+/**
+ * A business action an agent may be configured with (`GET /api/agents/actions`), as the application offers it:
+ * the key its commands name, and how the editor shows it.
+ */
+export interface AgentActionOption {
+    /** The business action key the server stores, such as `crm.deals/comment`. */
+    readonly key: string;
+    /** What groups it in the editor, such as `crm.deals`. */
+    readonly group: string;
+    /** The checkbox label; the key when absent. */
+    readonly title?: I18nText;
+    /** The group's heading; the group when absent. */
+    readonly groupTitle?: I18nText;
+    /** One line under the label saying what it lets the agent do. */
+    readonly description?: I18nText;
+    /** Ticked in the new-agent dialog. */
+    readonly defaultOn?: boolean;
+    /**
+     * False for an action listed only to show where the boundary is: the agent page shows it greyed out with `reason`,
+     * and it is never offered or granted. Grantable when absent.
+     */
+    readonly grantable?: boolean;
+    /** Why it can never be granted to an agent, for a `grantable: false` action. */
+    readonly reason?: I18nText;
+    /**
+     * The agent types it may be given; both when absent. An action that needs a working directory (attaching a file
+     * from one) is `['runner']`.
+     */
+    readonly types?: readonly AgentType[];
+}
+/** A person, as pickers and audit lines show them (`GET /api/agents/users`). */
+export interface UserRef {
+    readonly id: string;
+    readonly name: string;
+}
+/**
+ * The tool policy an agent starts from; an agent's `toolPolicy` overrides fields of it. The editor shows it so people
+ * see what they override.
+ */
+export declare const DEFAULT_TOOL_POLICY: ToolPolicy;
+//# sourceMappingURL=agents.d.ts.map

package/dist/shared/agents.d.ts.map

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