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

package/dist/shared/conversations.js

@@ -0,0 +1,163 @@
+/** The run subject kind of a conversation. */
+export const CONVERSATION_SUBJECT = 'conversation';
+/** The automatic title: the first message's first characters, without Markdown punctuation. */
+export const CONVERSATION_TITLE_AUTO_CHARS = 30;
+/** The longest title an agent may set. */
+export const CONVERSATION_TITLE_AGENT_MAX = 40;
+/** The longest title a person may set. */
+export const CONVERSATION_TITLE_MAX = 200;
+/** The longest message a person may send, in characters. */
+export const MESSAGE_CONTENT_MAX = 50_000;
+/** Per file sent with a message, in bytes. */
+export const CHAT_ATTACHMENT_SIZE_MAX = 20 * 1024 * 1024;
+/** Files sent with one message. */
+export const CHAT_ATTACHMENTS_PER_MESSAGE_MAX = 10;
+/** How long an upload not sent with a message is kept. */
+export const CHAT_ATTACHMENT_ORPHAN_HOURS = 24;
+/** The raster images shown inline, by extension: the declared type must be the one listed. */
+export const INLINE_IMAGE_TYPES = {
+    png: 'image/png',
+    jpg: 'image/jpeg',
+    jpeg: 'image/jpeg',
+    gif: 'image/gif',
+    webp: 'image/webp',
+    avif: 'image/avif',
+};
+/** A safe raster image, whose declared type matches its extension; anything else is only downloaded. */
+export function isInlineImage(mimeType, ext) {
+    const type = mimeType.split(';')[0]?.trim().toLowerCase() ?? '';
+    return INLINE_IMAGE_TYPES[ext.toLowerCase()] === type;
+}
+/** Messages a fresh session's prompt carries from the conversation's history. */
+export const CONVERSATION_HISTORY_IN_PROMPT = 20;
+/** Pages of the history list and of messages. */
+export const CONVERSATION_PAGE_DEFAULT = 30;
+export const CONVERSATION_PAGE_MAX = 100;
+export const MESSAGE_PAGE_DEFAULT = 50;
+export const MESSAGE_PAGE_MAX = 200;
+/** Who gave the conversation its title. */
+export const TITLE_SOURCES = ['auto', 'agent', 'user'];
+/** The source of a conversation started from the chat panel. */
+export const PANEL_SOURCE = 'panel';
+/** `^[a-zA-Z][a-zA-Z0-9._-]{0,31}$` */
+export const CONVERSATION_SOURCE_PATTERN = /^[a-zA-Z][a-zA-Z0-9._-]{0,31}$/u;
+export const MESSAGE_ROLES = ['user', 'assistant', 'system'];
+// ---------------------------------------------------------------------------------------------------------------------
+// Page context
+// ---------------------------------------------------------------------------------------------------------------------
+/** The limits a page context is checked against; a request over any of them answers 400 `INVALID_REQUEST`. */
+export const PAGE_CONTEXT_LIMITS = {
+    /** Characters of `route`. */
+    route: 500,
+    /** References in `items`. */
+    items: 10,
+    /** Keys of `filter.params`. */
+    filterKeys: 20,
+    /** Characters of each `filter.params` value. */
+    filterValue: 500,
+    /** Characters of `filter.label`. */
+    filterLabel: 200,
+    /** Characters of `selection.text`. */
+    selection: 2000,
+};
+/**
+ * The kinds of objects a page may reference that this plugin resolves: agents and runs. The application registers a
+ * resolver for each kind of its own (`agents.conversations.contextKinds`); references of a kind nobody resolves are
+ * dropped. A kind is a short identifier, so new kinds need no change here.
+ */
+export const PAGE_CONTEXT_KINDS = ['agent', 'run'];
+/** `^[a-zA-Z][a-zA-Z0-9._-]{0,31}$` */
+export const PAGE_CONTEXT_KIND_PATTERN = /^[a-zA-Z][a-zA-Z0-9._-]{0,31}$/u;
+/** Why a conversation's agent cannot answer now. */
+export const OFFLINE_REASONS = [
+    /** The agent was deleted. */
+    'agentMissing',
+    /** The agent is not enabled. */
+    'agentArchived',
+    /** The owner may no longer wake the agent. */
+    'forbidden',
+    /** No online runner that has the agent's tool and model may run the owner's work. */
+    'noRunner',
+    /** Only other people's personal runners have the agent's tool and model. */
+    'othersPersonal',
+];
+/** How a consultation went: asked and not answered yet, answered, failed, or refused before it started. */
+export const CONSULTATION_STATES = [
+    'running',
+    'completed',
+    'failed',
+    'refused',
+];
+// ---------------------------------------------------------------------------------------------------------------------
+// HTTP API
+// ---------------------------------------------------------------------------------------------------------------------
+/**
+ * Paths under the application's API base (`/api`), signed in. Every answer is `{ data }` (`{ data, meta }` for a list);
+ * a failure is the standard error body of domain `agents`. A conversation someone else owns answers 404
+ * `CONVERSATION_NOT_FOUND`.
+ *
+ * | Method | Route           | Body / query                                      | `data`                     |
+ * | ------ | --------------- | ------------------------------------------------- | -------------------------- |
+ * | GET    | `conversations` | `ConversationListQuery` (cursor paging)           | `ConversationSummary[]`    |
+ * | POST   | `conversations` | `CreateConversationRequest`                       | `ConversationDetail` (201) |
+ * | POST   | `start`         | `StartConversationRequest`                        | `SendMessageResult`        |
+ * | GET    | `conversation`  |                                                   | `ConversationDetail`       |
+ * | PATCH  | `conversation`  | `ConversationPatch` (rename, archive / unarchive) | `ConversationDetail`       |
+ * | GET    | `messages`      | `MessageListQuery` (cursor paging)                | `ConversationMessage[]`    |
+ * | POST   | `messages`      | `SendMessageRequest`                              | `SendMessageResult` (201)  |
+ * | POST   | `markRead`      |                                                   | `ConversationDetail`       |
+ * | POST   | `stop`          |                                                   | `ConversationDetail`       |
+ * | POST   | `fallback`      |                                                   | `ConversationDetail`       |
+ * | POST   | `restore`       |                                                   | `ConversationDetail`       |
+ * | GET    | `agents`        |                                                   | `ChatAgent[]`              |
+ * | GET    | `preferences`   |                                                   | `ChatPreferences`          |
+ * | PATCH  | `preferences`   | `ChatPreferencesPatch`                            | `ChatPreferences`          |
+ * | GET    | `settings`      |                                                   | `ChatSettings`             |
+ * | PATCH  | `settings`      | `ChatSettingsPatch` (`agents.agents` manage)      | `ChatSettings`             |
+ * | POST   | `attachments`   | multipart, one `file`                             | `MessageAttachment` (201)  |
+ * | DELETE | `attachment`    | an upload not sent yet, by its uploader           | 204                        |
+ * | GET    | `attachmentContent` | `?download=true` to save; a person or a run   | the bytes                  |
+ *
+ * A conversation whose state forbids the request answers 400 `CONVERSATION_CONFLICT` with `metadata.reason`
+ * (`ConversationConflict`).
+ */
+export const CHAT_ROUTES = {
+    conversations: 'agents/conversations',
+    conversation: 'agents/conversations/:conversationId',
+    messages: 'agents/conversations/:conversationId/messages',
+    markRead: 'agents/conversations/:conversationId/markRead',
+    stop: 'agents/conversations/:conversationId/stop',
+    fallback: 'agents/conversations/:conversationId/fallback',
+    restore: 'agents/conversations/:conversationId/restore',
+    start: 'agents/conversations/start',
+    agents: 'agents/chatAgents',
+    preferences: 'agents/chatPreferences',
+    settings: 'agents/chatSettings',
+    attachments: 'agents/chatAttachments',
+    attachment: 'agents/chatAttachments/:attachmentId',
+    attachmentContent: 'agents/chatAttachments/:attachmentId/content',
+};
+/** A route's path with its id parameter filled in (URI-encoded). */
+export function chatPath(route, id) {
+    const path = CHAT_ROUTES[route];
+    return id === undefined
+        ? path
+        : path.replace(/:[A-Za-z]+/u, encodeURIComponent(id));
+}
+/** `metadata.reason` of a `CONVERSATION_CONFLICT`. */
+export const CONVERSATION_CONFLICTS = [
+    /** No agent was named, the owner has no usable default, and no system default is set. */
+    'noChatAgent',
+    /** The agent tried to set the title after the owner renamed the conversation. */
+    'titleLocked',
+    /** `fallback`: the conversation already uses another agent in place of its own, or the system default cannot answer. */
+    'noFallback',
+    /** `restore`: the conversation is not on the system default, or its own agent is still unavailable. */
+    'noRestore',
+];
+// ---------------------------------------------------------------------------------------------------------------------
+// Realtime
+// ---------------------------------------------------------------------------------------------------------------------
+/** A per-user topic: each announcement reaches only the conversation owner's connections. */
+export const CONVERSATIONS_TOPIC = 'agents:conversations';
+//# sourceMappingURL=conversations.js.map

package/dist/shared/conversations.js.map

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

package/dist/shared/i18n.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Text that is translated where it is shown: an i18n key in a namespace (a package name, or the application's). The
+ * agents plugin shows text the application contributes (a subject's name, a scope's title, a business action's label)
+ * without knowing its wording; the contributor names its own key and namespace.
+ */
+export interface I18nText {
+    readonly key: string;
+    readonly ns: string;
+}
+//# sourceMappingURL=i18n.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../shared/i18n.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB"}

package/dist/shared/i18n.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=i18n.js.map

package/dist/shared/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../shared/i18n.ts"],"names":[],"mappings":""}

package/dist/shared/jobs.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Jobs as the browser, the admin API and the application exchange them. A job is a deterministic step a runner
+ * executes without a model (`@nocobase/agent-protocol`'s `jobs.ts`): a build. It is not a run: no agent,
+ * no brief, and it never wakes one.
+ */
+import type { JobEventType, JobFailureReason, JobKind, JobStatus } from '@nocobase/agent-protocol';
+/** How a job was started: by a person, by a rule a person configured, by an agent (on behalf of who woke it). */
+export declare const JOB_VIAS: readonly ["human", "rule", "agent", "system"];
+export type JobVia = (typeof JOB_VIAS)[number];
+export interface Job {
+    readonly id: string;
+    /** The kind the application registered. */
+    readonly kind: string;
+    /** What the runner executes for it. */
+    readonly executor: JobKind;
+    readonly status: JobStatus;
+    readonly title: string | null;
+    /** What the job is for, as the application names it. */
+    readonly subject: {
+        readonly kind: string;
+        readonly id: string;
+    } | null;
+    readonly actorUserId: string;
+    readonly via: JobVia;
+    readonly priority: number;
+    readonly attempt: number;
+    readonly maxAttempts: number;
+    /** The runners it may run on; null for any runner that fits. */
+    readonly runnerIds: readonly string[] | null;
+    readonly runnerId: string | null;
+    /** What the runner reported on completion (`JobResult`), or null. */
+    readonly result: unknown;
+    /** The command's exit code and the commit, as far as the runner got. */
+    readonly exitCode: number | null;
+    readonly sha: string | null;
+    readonly failureReason: JobFailureReason | null;
+    readonly failureDetail: string | null;
+    readonly cancelRequestedAt: string | null;
+    readonly cancelledById: string | null;
+    readonly availableAt: string | null;
+    readonly dispatchedAt: string | null;
+    readonly startedAt: string | null;
+    readonly finishedAt: string | null;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+/** A job in the admin list: with names for people. */
+export interface JobSummary extends Job {
+    readonly actorName: string | null;
+    readonly runnerName: string | null;
+    /** The viewer may cancel it. */
+    readonly canCancel: boolean;
+}
+/** One line of a job's log. */
+export interface JobEventView {
+    readonly seq: number;
+    readonly at: string;
+    readonly type: JobEventType;
+    readonly stream: 'stdout' | 'stderr' | 'runner' | null;
+    readonly phase: string | null;
+    readonly content: string | null;
+    readonly truncated: boolean;
+}
+/** What `agents.jobs.list` filters by. */
+export interface JobFilter {
+    readonly status?: JobStatus;
+    readonly kind?: string;
+    readonly runnerId?: string;
+    readonly subjectKind?: string;
+    readonly subjectId?: string;
+    readonly limit?: number;
+}
+//# sourceMappingURL=jobs.d.ts.map

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

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

package/dist/shared/jobs.js

@@ -0,0 +1,3 @@
+/** How a job was started: by a person, by a rule a person configured, by an agent (on behalf of who woke it). */
+export const JOB_VIAS = ['human', 'rule', 'agent', 'system'];
+//# sourceMappingURL=jobs.js.map

package/dist/shared/jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../../shared/jobs.ts"],"names":[],"mappings":"AAYA,iHAAiH;AACjH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAU,CAAC"}

package/dist/shared/locales/access.en-US.d.ts

@@ -0,0 +1,47 @@
+/**
+ * The titles this plugin registers with the authorization plugin (`{ key, ns }` descriptors under `access.*`). The
+ * server and the client locales both spread them.
+ */
+export interface AccessLocale {
+    readonly access: {
+        readonly section: string;
+        readonly settings: {
+            readonly agents: {
+                readonly agents: string;
+                readonly runners: string;
+                readonly prices: string;
+                readonly services: string;
+            };
+        };
+        readonly actions: {
+            readonly read: string;
+            readonly manage: string;
+        };
+        readonly businessSection: string;
+        readonly businesses: {
+            readonly agents: {
+                readonly title: string;
+                readonly description: string;
+                readonly actions: {
+                    readonly edit: {
+                        readonly title: string;
+                        readonly description: string;
+                        readonly related: string;
+                        readonly relatedLabel: string;
+                        readonly relatedHint: string;
+                        readonly all: string;
+                    };
+                };
+            };
+        };
+        readonly keyScopes: {
+            readonly [K in 'agents' | 'runners' | 'prices' | 'services']: {
+                readonly title: string;
+                readonly description: string;
+            };
+        };
+    };
+}
+declare const accessEnUS: AccessLocale;
+export default accessEnUS;
+//# sourceMappingURL=access.en-US.d.ts.map

package/dist/shared/locales/access.en-US.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.en-US.d.ts","sourceRoot":"","sources":["../../../shared/locales/access.en-US.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,QAAQ,EAAE;YACjB,QAAQ,CAAC,MAAM,EAAE;gBACf,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;aAC3B,CAAC;SACH,CAAC;QACF,QAAQ,CAAC,OAAO,EAAE;YAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QACrE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;QACjC,QAAQ,CAAC,UAAU,EAAE;YACnB,QAAQ,CAAC,MAAM,EAAE;gBACf,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBAC7B,QAAQ,CAAC,OAAO,EAAE;oBAChB,QAAQ,CAAC,IAAI,EAAE;wBACb,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;wBACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;wBAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;wBACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;wBAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;wBAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;qBACtB,CAAC;iBACH,CAAC;aACH,CAAC;SACH,CAAC;QACF,QAAQ,CAAC,SAAS,EAAE;YAClB,QAAQ,EAAE,CAAC,IAAI,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG;gBAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;aAC9B;SACF,CAAC;KACH,CAAC;CACH;AAED,QAAA,MAAM,UAAU,EAAE,YAqDjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/shared/locales/access.en-US.js

@@ -0,0 +1,51 @@
+const accessEnUS = {
+    access: {
+        section: 'Agent team',
+        businessSection: 'Agent team',
+        businesses: {
+            agents: {
+                title: 'Agents and skills',
+                description: 'The agents of the team and the skills they use.',
+                actions: {
+                    edit: {
+                        title: 'Change agents and skills',
+                        description: "Change an agent's settings, skills and variables, archive, restore and delete it, and edit skills. An agent is given no capability beyond the editor's own",
+                        related: 'Change agents and skills (agents they own and skills they created)',
+                        relatedLabel: 'Agents I own and skills I created',
+                        relatedHint: 'Agents I am the owner of, and skills I created',
+                        all: 'Change agents and skills (all)',
+                    },
+                },
+            },
+        },
+        settings: {
+            agents: {
+                agents: 'Agents',
+                runners: 'Runtimes',
+                prices: 'Model prices',
+                services: 'Model services',
+            },
+        },
+        actions: { read: 'View', manage: 'Manage' },
+        keyScopes: {
+            agents: {
+                title: 'Agents',
+                description: 'See agents, skills and runs; change agents and skills, cancel and retry runs.',
+            },
+            runners: {
+                title: 'Runtimes',
+                description: 'See runners and registration tokens; manage runners.',
+            },
+            prices: {
+                title: 'Model prices',
+                description: 'See the model prices costs are estimated from; change them.',
+            },
+            services: {
+                title: 'Model services',
+                description: 'See the model services and the models they offer, never their keys.',
+            },
+        },
+    },
+};
+export default accessEnUS;
+//# sourceMappingURL=access.en-US.js.map

package/dist/shared/locales/access.en-US.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.en-US.js","sourceRoot":"","sources":["../../../shared/locales/access.en-US.ts"],"names":[],"mappings":"AA0CA,MAAM,UAAU,GAAiB;IAC/B,MAAM,EAAE;QACN,OAAO,EAAE,YAAY;QACrB,eAAe,EAAE,YAAY;QAC7B,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,KAAK,EAAE,mBAAmB;gBAC1B,WAAW,EAAE,iDAAiD;gBAC9D,OAAO,EAAE;oBACP,IAAI,EAAE;wBACJ,KAAK,EAAE,0BAA0B;wBACjC,WAAW,EACT,4JAA4J;wBAC9J,OAAO,EACL,oEAAoE;wBACtE,YAAY,EAAE,mCAAmC;wBACjD,WAAW,EAAE,gDAAgD;wBAC7D,GAAG,EAAE,gCAAgC;qBACtC;iBACF;aACF;SACF;QACD,QAAQ,EAAE;YACR,MAAM,EAAE;gBACN,MAAM,EAAE,QAAQ;gBAChB,OAAO,EAAE,UAAU;gBACnB,MAAM,EAAE,cAAc;gBACtB,QAAQ,EAAE,gBAAgB;aAC3B;SACF;QACD,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE;QAC3C,SAAS,EAAE;YACT,MAAM,EAAE;gBACN,KAAK,EAAE,QAAQ;gBACf,WAAW,EACT,+EAA+E;aAClF;YACD,OAAO,EAAE;gBACP,KAAK,EAAE,UAAU;gBACjB,WAAW,EAAE,sDAAsD;aACpE;YACD,MAAM,EAAE;gBACN,KAAK,EAAE,cAAc;gBACrB,WAAW,EACT,6DAA6D;aAChE;YACD,QAAQ,EAAE;gBACR,KAAK,EAAE,gBAAgB;gBACvB,WAAW,EACT,qEAAqE;aACxE;SACF;KACF;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/shared/locales/access.zh-CN.d.ts

@@ -0,0 +1,4 @@
+import type { AccessLocale } from './access.en-US.js';
+declare const accessZhCN: AccessLocale;
+export default accessZhCN;
+//# sourceMappingURL=access.zh-CN.d.ts.map

package/dist/shared/locales/access.zh-CN.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.zh-CN.d.ts","sourceRoot":"","sources":["../../../shared/locales/access.zh-CN.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,QAAA,MAAM,UAAU,EAAE,YAkDjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/shared/locales/access.zh-CN.js

@@ -0,0 +1,51 @@
+const accessZhCN = {
+    access: {
+        section: 'Agent 团队',
+        businessSection: 'Agent 团队',
+        businesses: {
+            agents: {
+                title: 'Agent 和技能',
+                description: '团队的 Agent 以及它们使用的技能。',
+                actions: {
+                    edit: {
+                        title: '修改 Agent 和技能',
+                        description: '修改 Agent 的设置、技能和环境变量，归档、恢复和删除 Agent，编辑技能。授予 Agent 的能力不能超出自己的权限',
+                        related: '修改 Agent 和技能（自己负责的 Agent 和自己创建的技能）',
+                        relatedLabel: '我负责的 Agent 和我创建的技能',
+                        relatedHint: '我是负责人的 Agent，以及我创建的技能',
+                        all: '修改 Agent 和技能（全部）',
+                    },
+                },
+            },
+        },
+        settings: {
+            agents: {
+                agents: 'Agent',
+                runners: '运行环境',
+                prices: '模型价格',
+                services: '模型服务',
+            },
+        },
+        actions: { read: '查看', manage: '管理' },
+        keyScopes: {
+            agents: {
+                title: 'Agent',
+                description: '查看 Agent、技能和运行；修改 Agent 和技能，取消和重试运行。',
+            },
+            runners: {
+                title: '运行环境',
+                description: '查看运行环境和注册令牌；管理运行环境。',
+            },
+            prices: {
+                title: '模型价格',
+                description: '查看用于估算成本的模型价格；修改它们。',
+            },
+            services: {
+                title: '模型服务',
+                description: '查看模型服务及其提供的模型，不含密钥。',
+            },
+        },
+    },
+};
+export default accessZhCN;
+//# sourceMappingURL=access.zh-CN.js.map

package/dist/shared/locales/access.zh-CN.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.zh-CN.js","sourceRoot":"","sources":["../../../shared/locales/access.zh-CN.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAiB;IAC/B,MAAM,EAAE;QACN,OAAO,EAAE,UAAU;QACnB,eAAe,EAAE,UAAU;QAC3B,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,KAAK,EAAE,WAAW;gBAClB,WAAW,EAAE,sBAAsB;gBACnC,OAAO,EAAE;oBACP,IAAI,EAAE;wBACJ,KAAK,EAAE,cAAc;wBACrB,WAAW,EACT,gEAAgE;wBAClE,OAAO,EAAE,oCAAoC;wBAC7C,YAAY,EAAE,oBAAoB;wBAClC,WAAW,EAAE,uBAAuB;wBACpC,GAAG,EAAE,kBAAkB;qBACxB;iBACF;aACF;SACF;QACD,QAAQ,EAAE;YACR,MAAM,EAAE;gBACN,MAAM,EAAE,OAAO;gBACf,OAAO,EAAE,MAAM;gBACf,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,MAAM;aACjB;SACF;QACD,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;QACrC,SAAS,EAAE;YACT,MAAM,EAAE;gBACN,KAAK,EAAE,OAAO;gBACd,WAAW,EACT,sCAAsC;aACzC;YACD,OAAO,EAAE;gBACP,KAAK,EAAE,MAAM;gBACb,WAAW,EAAE,qBAAqB;aACnC;YACD,MAAM,EAAE;gBACN,KAAK,EAAE,MAAM;gBACb,WAAW,EAAE,qBAAqB;aACnC;YACD,QAAQ,EAAE;gBACR,KAAK,EAAE,MAAM;gBACb,WAAW,EAAE,qBAAqB;aACnC;SACF;KACF;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/shared/model-catalog.d.ts

@@ -0,0 +1,48 @@
+/**
+ * The models agents are named after. Runners report each coding tool's models by the ids the tool lists them under;
+ * the server keeps one agent per tool and model (`agents.ts`), so the same model reported under two spellings has to
+ * become one agent: `normalizeModel` turns what a runner reports into the id the agent keeps, and `agentNameOf` names
+ * it, such as "Claude · Opus 5.5" for Claude Code's `claude-opus-5-5`.
+ *
+ * The catalog ships with the plugin. A model it does not know still becomes an agent, named after its id, with nothing
+ * suggested for what it is good at. Keep it to the models the tools offer today, checked against the same lists as
+ * `TOOL_MODEL_SUGGESTIONS` in `@nocobase/agent-protocol`; a model leaving it only loses its suggestion and its label.
+ */
+import type { AgentTool } from '@nocobase/agent-protocol';
+/** A coding tool as agent names show it. */
+export declare const TOOL_LABELS: Readonly<Record<AgentTool, string>>;
+/** What the catalog knows about one model. */
+export interface CatalogModel {
+    /** The model's id without a provider, as Claude Code or Codex take it. */
+    readonly id: string;
+    /** How names show it: `Opus 5.5`. */
+    readonly label: string;
+    /** Other ids the same model is listed under, such as Claude Code's `opus`. */
+    readonly aliases?: readonly string[];
+    /** What it is good at, suggested when someone enables its agent. */
+    readonly goodAt: {
+        readonly en: string;
+        readonly zh: string;
+    };
+}
+/** The models the catalog names. OpenCode and Pi list them as `provider/<id>` and are matched by `<id>`. */
+export declare const MODEL_CATALOG: readonly CatalogModel[];
+/**
+ * The id an agent keeps for what a runner reports: without a dated release suffix (`claude-haiku-4-5-20251001`), an
+ * alias (`opus`) resolved to the model it names, and for OpenCode and Pi the provider kept in front
+ * (`anthropic/claude-opus-5-5`; a nested id such as `alibaba-cn/kimi/kimi-k2.5` keeps everything after the provider).
+ * Case is kept: OpenCode and Pi take ids such as `minimax/MiniMax-M2.7` as written. Versions are never folded together:
+ * `gpt-6-sol` and `gpt-6.1-sol` are two models.
+ */
+export declare function normalizeModel(tool: AgentTool, reported: string): string;
+/** What the catalog knows about a tool's model, normalized or not; undefined for a model it does not know. */
+export declare function catalogEntry(tool: AgentTool, model: string): CatalogModel | undefined;
+/** How names show a tool's model: the catalog's label, else its id without the provider. */
+export declare function modelLabel(tool: AgentTool, model: string): string;
+/** An agent's name for a tool and model: "Claude · Opus 5.5". */
+export declare function agentNameOf(tool: AgentTool, model: string): string;
+/** Whether two ids of one tool's model name the same model. */
+export declare function sameModel(tool: AgentTool, a: string, b: string): boolean;
+/** Display identity only. Unknown models retain their provider; execution identity never changes. */
+export declare function discoveryKey(tool: AgentTool, model: string): string;
+//# sourceMappingURL=model-catalog.d.ts.map

package/dist/shared/model-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-catalog.d.ts","sourceRoot":"","sources":["../../shared/model-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,4CAA4C;AAC5C,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAK3D,CAAC;AAEF,8CAA8C;AAC9C,MAAM,WAAW,YAAY;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/D;AAED,4GAA4G;AAC5G,eAAO,MAAM,aAAa,EAAE,SAAS,YAAY,EAiFhD,CAAC;AAkBF;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWxE;AAED,8GAA8G;AAC9G,wBAAgB,YAAY,CAC1B,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,MAAM,GACZ,YAAY,GAAG,SAAS,CAI1B;AAED,4FAA4F;AAC5F,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMjE;AAED,iEAAiE;AACjE,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,+DAA+D;AAC/D,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAExE;AAED,qGAAqG;AACrG,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnE"}