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

package/dist/shared/model-catalog.js

@@ -0,0 +1,148 @@
+/** A coding tool as agent names show it. */
+export const TOOL_LABELS = {
+    claude: 'Claude',
+    codex: 'Codex',
+    opencode: 'OpenCode',
+    pi: 'Pi',
+};
+/** The models the catalog names. OpenCode and Pi list them as `provider/<id>` and are matched by `<id>`. */
+export const MODEL_CATALOG = [
+    ...[
+        ['claude-opus-4-6', 'Opus 4.6'],
+        ['claude-sonnet-4-6', 'Sonnet 4.6'],
+        ['gpt-5.5', 'GPT-5.5'],
+        ['gpt-4', 'GPT-4'],
+        ['o1', 'o1'],
+        ['gpt-4o', 'GPT-4o'],
+        ['gpt-4o-2024-05-13', 'GPT-4o (2024-05-13)'],
+    ].map(([id, label]) => ({
+        id: id,
+        label: label,
+        goodAt: { en: '', zh: '' },
+    })),
+    {
+        id: 'claude-opus-5-5',
+        label: 'Opus 5.5',
+        aliases: ['opus'],
+        goodAt: {
+            en: 'Designs, architecture, hard investigations and reviews of important changes.',
+            zh: '方案、架构、疑难排查、重要改动的评审。',
+        },
+    },
+    {
+        id: 'claude-sonnet-5',
+        label: 'Sonnet 5',
+        aliases: ['sonnet'],
+        goodAt: {
+            en: 'Well-scoped implementation, small fixes, tests and wording.',
+            zh: '范围清楚的常规实现、小修复、补测试、文案。',
+        },
+    },
+    {
+        id: 'claude-haiku-4-5',
+        label: 'Haiku 4.5',
+        aliases: ['haiku'],
+        goodAt: {
+            en: 'Small, mechanical changes; cheap and fast.',
+            zh: '小改动、机械性修改，便宜、快。',
+        },
+    },
+    {
+        id: 'claude-fable-5-1',
+        label: 'Fable 5.1',
+        goodAt: {
+            en: 'Understanding requirements, writing proposals and explanations.',
+            zh: '理解需求、写方案和说明。',
+        },
+    },
+    {
+        id: 'gpt-6.1-sol',
+        label: 'GPT-6.1 Sol',
+        goodAt: {
+            en: 'Larger implementations, changes across packages and refactoring.',
+            zh: '较大的实现、跨包改动、重构。',
+        },
+    },
+    {
+        id: 'gpt-6-sol',
+        label: 'GPT-6 Sol',
+        goodAt: {
+            en: 'Larger implementations, changes across packages and refactoring.',
+            zh: '较大的实现、跨包改动、重构。',
+        },
+    },
+    {
+        id: 'gpt-6-astra',
+        label: 'GPT-6 Astra',
+        goodAt: {
+            en: 'Code review and reading CI failures.',
+            zh: '代码评审、读 CI 失败。',
+        },
+    },
+    {
+        id: 'gpt-6-luna',
+        label: 'GPT-6 Luna',
+        goodAt: {
+            en: 'Small, mechanical changes; cheap and fast.',
+            zh: '小改动、机械性修改，便宜、快。',
+        },
+    },
+];
+/** Whether a tool names models `provider/model`. */
+function providerQualified(tool) {
+    return tool === 'opencode' || tool === 'pi';
+}
+/** A dated release suffix (`-20261001`) or `-latest`, which name the same model. */
+const RELEASE_SUFFIX = /-(?:\d{8}|latest)$/u;
+/** The catalog entry an id (without a provider) names, by id or alias in any case, once its release suffix is dropped. */
+function catalogById(id) {
+    const bare = id.replace(RELEASE_SUFFIX, '').toLowerCase();
+    return MODEL_CATALOG.find((model) => model.id === bare || (model.aliases ?? []).includes(bare));
+}
+/**
+ * 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 function normalizeModel(tool, reported) {
+    const id = reported.trim();
+    if (providerQualified(tool)) {
+        const slash = id.indexOf('/');
+        if (slash > 0) {
+            const provider = id.slice(0, slash);
+            const model = id.slice(slash + 1);
+            return `${provider}/${catalogById(model)?.id ?? model.replace(RELEASE_SUFFIX, '')}`;
+        }
+    }
+    return catalogById(id)?.id ?? id.replace(RELEASE_SUFFIX, '');
+}
+/** What the catalog knows about a tool's model, normalized or not; undefined for a model it does not know. */
+export function catalogEntry(tool, model) {
+    const id = normalizeModel(tool, model);
+    const slash = providerQualified(tool) ? id.indexOf('/') : -1;
+    return catalogById(slash > 0 ? id.slice(slash + 1) : id);
+}
+/** How names show a tool's model: the catalog's label, else its id without the provider. */
+export function modelLabel(tool, model) {
+    const known = catalogEntry(tool, model);
+    if (known)
+        return known.label;
+    const id = normalizeModel(tool, model);
+    const slash = id.lastIndexOf('/');
+    return slash >= 0 ? id.slice(slash + 1) : id;
+}
+/** An agent's name for a tool and model: "Claude · Opus 5.5". */
+export function agentNameOf(tool, model) {
+    return `${TOOL_LABELS[tool]} · ${modelLabel(tool, model)}`;
+}
+/** Whether two ids of one tool's model name the same model. */
+export function sameModel(tool, a, b) {
+    return normalizeModel(tool, a) === normalizeModel(tool, b);
+}
+/** Display identity only. Unknown models retain their provider; execution identity never changes. */
+export function discoveryKey(tool, model) {
+    return `${tool}:${catalogEntry(tool, model)?.id ?? model}`;
+}
+//# sourceMappingURL=model-catalog.js.map

package/dist/shared/model-catalog.js.map

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

package/dist/shared/models.d.ts

@@ -0,0 +1,196 @@
+/**
+ * The models online agents talk to, as the browser and the API exchange them: the model services this plugin keeps
+ * (`agModelServices`), the providers a service can use, and the catalog of what the enabled services offer. Every
+ * answer is `{ data }`; a list is `{ data, meta: { total } }`.
+ *
+ * | Method | Path                                 | Needs                    | Body                          | `data`                     |
+ * | ------ | ------------------------------------ | ------------------------ | ----------------------------- | -------------------------- |
+ * | GET    | `agents/models`                      | a session                | `?kind=` (chat by default)    | `ModelService[]` (catalog) |
+ * | POST   | `agents/checkModel`                  | `agents.agents` read     | `ModelRef`                    | `ModelCheck`               |
+ * | GET    | `agents/services`                    | `agents.services` read   |                               | `ModelServiceView[]`       |
+ * | POST   | `agents/services`                    | `agents.services` manage | `CreateModelServiceRequest`   | `ModelServiceView` (201)   |
+ * | PATCH  | `agents/services/:serviceName`       | `agents.services` manage | `UpdateModelServiceRequest`   | `ModelServiceView`         |
+ * | DELETE | `agents/services/:serviceName`       | `agents.services` manage |                               | 204                        |
+ * | POST   | `agents/discoverModels`              | `agents.services` manage | `ModelConnectionRequest`      | `ProviderModels`           |
+ * | POST   | `agents/checkConnection`             | `agents.services` manage | `ModelConnectionCheckRequest` | `ModelCheck`               |
+ * | GET    | `agents/defaultModels`               | a session                |                               | `DefaultModels`            |
+ * | PUT    | `agents/defaultModels/chat`          | `agents.services` manage | `ModelRef`                    | `DefaultModels`            |
+ *
+ * The catalog names services and models, never keys or URLs. An API key is write-only: a service answers whether it
+ * has one (`apiKeySet`). Listing models and checking take a connection being edited (`provider`, `baseUrl`, `apiKey`)
+ * over a saved service (`service`), so a form can try a new key before saving it and an unchanged one without sending
+ * it; neither fails for the provider's sake, they answer what it said.
+ *
+ * Every request to a provider says who sends it (`User-Agent: nocobase-agents/<version>`). A call to an OpenCode
+ * base URL (Zen or Go) additionally carries `x-opencode-session` with a session id the server derives: the same one
+ * for every model call of a conversation, a new one for each call outside any.
+ */
+export type ModelProviderName = 'openai' | 'anthropic' | 'google' | 'deepseek' | 'alibaba' | 'moonshotai' | 'ollama' | 'cohere' | 'openai-compatible';
+/**
+ * What a model of a service is for: `chat` (online agents talk to it), `embedding` (turns text into vectors for a
+ * vector index) or `rerank` (orders documents by how well they answer a query). Agents only ever see chat models.
+ */
+export type ModelKind = 'chat' | 'embedding' | 'rerank';
+export declare const MODEL_KINDS: readonly ModelKind[];
+/** A provider a service can use. */
+export interface ModelProviderOption {
+    /** Its key, such as `openai`. */
+    readonly name: ModelProviderName;
+    readonly title: string;
+    /** The base URL it calls when a service sets none; null when a service must set one. */
+    readonly defaultBaseUrl: string | null;
+    /** Whether it answers nothing without an API key. */
+    readonly keyRequired: boolean;
+    /** The kinds of model it serves, through its Vercel AI SDK provider (`server/online/providers.ts`). */
+    readonly kinds: readonly ModelKind[];
+}
+/** The providers a service can use, each through its Vercel AI SDK provider package (`server/online/providers.ts`). */
+export declare const MODEL_PROVIDERS: readonly ModelProviderOption[];
+export declare const MODEL_PROVIDER_NAMES: readonly ModelProviderName[];
+export declare function providerOf(name: string): ModelProviderOption | null;
+/** The session header OpenCode Zen and Go require; a call to an OpenCode base URL sends it without being asked. */
+export declare const OPENCODE_SESSION_HEADER = "x-opencode-session";
+/** Whether a base URL is OpenCode's (Zen or Go), which requires `OPENCODE_SESSION_HEADER`. */
+export declare function isOpenCodeUrl(baseUrl: string | null | undefined): boolean;
+export interface ModelOption {
+    /** The provider's model id. */
+    readonly value: string;
+    readonly label: string;
+    readonly kind: ModelKind;
+    /** For an embedding model, the size of the vectors asked for; null takes the model's own. Null for other kinds. */
+    readonly dimensions: number | null;
+}
+/** An enabled service with the models of one kind it offers. */
+export interface ModelService {
+    /** Its name, which an agent stores (`OnlineModelEntry.modelService`). */
+    readonly name: string;
+    readonly title: string;
+    /** Its provider's key, such as `openai`. */
+    readonly provider: string;
+    readonly models: readonly ModelOption[];
+}
+export interface ModelCatalog {
+    /** The enabled services that offer at least one model of the kind asked for (chat unless said otherwise). */
+    readonly services: readonly ModelService[];
+    /**
+     * In a chat catalog the server reads, the system default chat model online agents with no models of their own use
+     * (`DefaultModels.effectiveChat`); null when no service offers a chat model.
+     */
+    readonly defaultModel?: ModelRef | null;
+}
+export interface ModelRef {
+    readonly modelService: string;
+    readonly model: string;
+}
+/** Whether a model answered a short test request. */
+export interface ModelCheck {
+    readonly ok: boolean;
+    /** Why not, in the provider's words. */
+    readonly message: string | null;
+    /**
+     * When it did not answer as the kind it was checked as but did as another kind its provider serves, that kind: the
+     * model looks like a model of another kind. Null or absent otherwise.
+     */
+    readonly looksLike?: ModelKind | null;
+}
+/** The system default chat model, as `agents/defaultModels` answers it. */
+export interface DefaultChatModel extends ModelRef {
+    /** Its service's title. */
+    readonly serviceTitle: string;
+    /** Its label in the service. */
+    readonly modelLabel: string;
+}
+/**
+ * The models used where nothing names one: online agents with no models of their own answer with the default chat
+ * model. It is set on the Models page; when none is set, the first chat model an enabled service offers is used, and
+ * the first one enabled becomes the default.
+ */
+export interface DefaultModels {
+    /** The default chat model as set; null when none is. */
+    readonly chat: ModelRef | null;
+    /** The chat model used now: the one set while it is offered, else the first offered; null when none is. */
+    readonly effectiveChat: DefaultChatModel | null;
+}
+/** Whether the catalog offers `model` of `modelService`. */
+export declare function offers(catalog: Pick<ModelCatalog, 'services'>, modelService: string | null, model: string | null): boolean;
+/** Whether the catalog offers an online agent's entry; false for none. */
+export declare function offersEntry(catalog: Pick<ModelCatalog, 'services'>, entry: ModelRef | null): boolean;
+/** A service, as `GET agents/services` lists it. */
+export interface ModelServiceView {
+    /** What agents and model prices store to name it; made from the title when it is added, and never changed. */
+    readonly name: string;
+    readonly title: string;
+    readonly provider: ModelProviderName;
+    readonly baseUrl: string | null;
+    /** Whether an API key is set; the key itself is never answered. */
+    readonly apiKeySet: boolean;
+    readonly enabled: boolean;
+    /** The models it offers, in order. */
+    readonly models: readonly ModelOption[];
+}
+export interface ModelInput {
+    readonly value: string;
+    readonly label?: string;
+    /** `chat` when absent; must be a kind the service's provider serves. */
+    readonly kind?: ModelKind;
+    /** An embedding model's vector size (1–8192); absent or null takes the model's own. */
+    readonly dimensions?: number | null;
+}
+/** `POST agents/services`. */
+export interface CreateModelServiceRequest {
+    readonly title: string;
+    readonly provider: ModelProviderName;
+    readonly baseUrl?: string | null;
+    readonly apiKey?: string | null;
+    readonly models?: readonly ModelInput[];
+    /** True when absent. */
+    readonly enabled?: boolean;
+}
+/** `PATCH agents/services/:serviceName`: what is absent stays; `apiKey` null clears the key. */
+export interface UpdateModelServiceRequest {
+    readonly title?: string;
+    readonly baseUrl?: string | null;
+    readonly apiKey?: string | null;
+    readonly models?: readonly ModelInput[];
+    readonly enabled?: boolean;
+}
+/**
+ * A connection to try: a saved service (`service`), what is being edited, or both, the edited values winning. `apiKey`
+ * null tries without a key; absent, the saved service's key.
+ */
+export interface ModelConnectionRequest {
+    readonly service?: string;
+    readonly provider?: ModelProviderName;
+    readonly baseUrl?: string | null;
+    readonly apiKey?: string | null;
+}
+/**
+ * `POST agents/checkConnection`: tries `model` over the connection as its kind says: a chat model answers a short
+ * question, an embedding model embeds a short text (with `dimensions`), a rerank model orders two short documents.
+ */
+export interface ModelConnectionCheckRequest extends ModelConnectionRequest {
+    readonly model: string;
+    /** `chat` when absent. */
+    readonly kind?: ModelKind;
+    readonly dimensions?: number | null;
+}
+/** A model a provider lists, with the kind its id suggests (`guessModelKind`); people may change it. */
+export interface ProviderModel {
+    readonly id: string;
+    readonly kind: ModelKind;
+}
+/** The models a provider lists over a connection, or why it would not. */
+export type ProviderModels = {
+    readonly ok: true;
+    readonly items: readonly ProviderModel[];
+} | {
+    readonly ok: false;
+    readonly message: string;
+};
+/**
+ * The kind a model id suggests, among `kinds` (those its provider serves): `rerank` for an id naming reranking,
+ * `embedding` for one naming embeddings (`embed`, `embedding`), else `chat`; the provider's first kind when it serves
+ * no such kind.
+ */
+export declare function guessModelKind(id: string, kinds: readonly ModelKind[]): ModelKind;
+//# sourceMappingURL=models.d.ts.map

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

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

package/dist/shared/models.js

@@ -0,0 +1,142 @@
+/**
+ * The models online agents talk to, as the browser and the API exchange them: the model services this plugin keeps
+ * (`agModelServices`), the providers a service can use, and the catalog of what the enabled services offer. Every
+ * answer is `{ data }`; a list is `{ data, meta: { total } }`.
+ *
+ * | Method | Path                                 | Needs                    | Body                          | `data`                     |
+ * | ------ | ------------------------------------ | ------------------------ | ----------------------------- | -------------------------- |
+ * | GET    | `agents/models`                      | a session                | `?kind=` (chat by default)    | `ModelService[]` (catalog) |
+ * | POST   | `agents/checkModel`                  | `agents.agents` read     | `ModelRef`                    | `ModelCheck`               |
+ * | GET    | `agents/services`                    | `agents.services` read   |                               | `ModelServiceView[]`       |
+ * | POST   | `agents/services`                    | `agents.services` manage | `CreateModelServiceRequest`   | `ModelServiceView` (201)   |
+ * | PATCH  | `agents/services/:serviceName`       | `agents.services` manage | `UpdateModelServiceRequest`   | `ModelServiceView`         |
+ * | DELETE | `agents/services/:serviceName`       | `agents.services` manage |                               | 204                        |
+ * | POST   | `agents/discoverModels`              | `agents.services` manage | `ModelConnectionRequest`      | `ProviderModels`           |
+ * | POST   | `agents/checkConnection`             | `agents.services` manage | `ModelConnectionCheckRequest` | `ModelCheck`               |
+ * | GET    | `agents/defaultModels`               | a session                |                               | `DefaultModels`            |
+ * | PUT    | `agents/defaultModels/chat`          | `agents.services` manage | `ModelRef`                    | `DefaultModels`            |
+ *
+ * The catalog names services and models, never keys or URLs. An API key is write-only: a service answers whether it
+ * has one (`apiKeySet`). Listing models and checking take a connection being edited (`provider`, `baseUrl`, `apiKey`)
+ * over a saved service (`service`), so a form can try a new key before saving it and an unchanged one without sending
+ * it; neither fails for the provider's sake, they answer what it said.
+ *
+ * Every request to a provider says who sends it (`User-Agent: nocobase-agents/<version>`). A call to an OpenCode
+ * base URL (Zen or Go) additionally carries `x-opencode-session` with a session id the server derives: the same one
+ * for every model call of a conversation, a new one for each call outside any.
+ */
+export const MODEL_KINDS = [
+    'chat',
+    'embedding',
+    'rerank',
+];
+/** The providers a service can use, each through its Vercel AI SDK provider package (`server/online/providers.ts`). */
+export const MODEL_PROVIDERS = [
+    {
+        name: 'openai',
+        title: 'OpenAI',
+        defaultBaseUrl: 'https://api.openai.com/v1',
+        keyRequired: true,
+        kinds: ['chat', 'embedding'],
+    },
+    {
+        name: 'anthropic',
+        title: 'Anthropic',
+        defaultBaseUrl: 'https://api.anthropic.com/v1',
+        keyRequired: true,
+        kinds: ['chat'],
+    },
+    {
+        name: 'google',
+        title: 'Google Gemini',
+        defaultBaseUrl: 'https://generativelanguage.googleapis.com/v1beta',
+        keyRequired: true,
+        kinds: ['chat', 'embedding'],
+    },
+    {
+        name: 'deepseek',
+        title: 'DeepSeek',
+        defaultBaseUrl: 'https://api.deepseek.com',
+        keyRequired: true,
+        kinds: ['chat'],
+    },
+    {
+        name: 'alibaba',
+        title: 'Alibaba Qwen',
+        defaultBaseUrl: 'https://dashscope.aliyuncs.com/compatible-mode/v1',
+        keyRequired: true,
+        kinds: ['chat', 'embedding'],
+    },
+    {
+        name: 'moonshotai',
+        title: 'Moonshot Kimi',
+        defaultBaseUrl: 'https://api.moonshot.ai/v1',
+        keyRequired: true,
+        kinds: ['chat'],
+    },
+    {
+        name: 'ollama',
+        title: 'Ollama',
+        defaultBaseUrl: 'http://127.0.0.1:11434/api',
+        keyRequired: false,
+        kinds: ['chat', 'embedding'],
+    },
+    {
+        name: 'cohere',
+        title: 'Cohere',
+        defaultBaseUrl: 'https://api.cohere.com/v2',
+        keyRequired: true,
+        kinds: ['chat', 'embedding', 'rerank'],
+    },
+    {
+        name: 'openai-compatible',
+        title: 'OpenAI-compatible',
+        defaultBaseUrl: null,
+        keyRequired: false,
+        kinds: ['chat', 'embedding', 'rerank'],
+    },
+];
+export const MODEL_PROVIDER_NAMES = MODEL_PROVIDERS.map((provider) => provider.name);
+export function providerOf(name) {
+    return MODEL_PROVIDERS.find((provider) => provider.name === name) ?? null;
+}
+/** The session header OpenCode Zen and Go require; a call to an OpenCode base URL sends it without being asked. */
+export const OPENCODE_SESSION_HEADER = 'x-opencode-session';
+/** Whether a base URL is OpenCode's (Zen or Go), which requires `OPENCODE_SESSION_HEADER`. */
+export function isOpenCodeUrl(baseUrl) {
+    if (!baseUrl)
+        return false;
+    try {
+        const host = new URL(baseUrl).hostname.toLowerCase();
+        return host === 'opencode.ai' || host.endsWith('.opencode.ai');
+    }
+    catch {
+        return false;
+    }
+}
+/** Whether the catalog offers `model` of `modelService`. */
+export function offers(catalog, modelService, model) {
+    return Boolean(modelService &&
+        model &&
+        catalog.services.some((service) => service.name === modelService &&
+            service.models.some((option) => option.value === model)));
+}
+/** Whether the catalog offers an online agent's entry; false for none. */
+export function offersEntry(catalog, entry) {
+    return offers(catalog, entry?.modelService ?? null, entry?.model ?? null);
+}
+/**
+ * The kind a model id suggests, among `kinds` (those its provider serves): `rerank` for an id naming reranking,
+ * `embedding` for one naming embeddings (`embed`, `embedding`), else `chat`; the provider's first kind when it serves
+ * no such kind.
+ */
+export function guessModelKind(id, kinds) {
+    const lower = id.toLowerCase();
+    const guess = lower.includes('rerank')
+        ? 'rerank'
+        : lower.includes('embed')
+            ? 'embedding'
+            : 'chat';
+    return kinds.includes(guess) ? guess : (kinds[0] ?? 'chat');
+}
+//# sourceMappingURL=models.js.map

package/dist/shared/models.js.map

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

package/dist/shared/realtime.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Realtime topics. Payloads say only what changed, never content: a page that hears one fetches through the API,
+ * which checks who may see it. A page also polls, because announcements reach only the browsers connected to the
+ * instance that made the change.
+ */
+import type { RunStatus } from '@nocobase/agent-protocol';
+/** One run's status and transcript: `agents:runs:<runId>`. */
+export declare function runTopic(runId: string): string;
+export type RunChanged = {
+    readonly kind: 'run.status';
+    readonly runId: string;
+    readonly status: RunStatus;
+} | {
+    readonly kind: 'run.events';
+    readonly runId: string;
+    readonly lastSeq: number;
+} | {
+    readonly kind: 'run.input';
+    readonly runId: string;
+};
+/** Runners came online, went offline or changed. */
+export declare const RUNNERS_TOPIC = "agents:runners";
+export interface RunnersChanged {
+    readonly kind: 'runners.changed';
+    readonly runnerId: string;
+}
+//# sourceMappingURL=realtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.d.ts","sourceRoot":"","sources":["../../shared/realtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,8DAA8D;AAC9D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,MAAM,MAAM,UAAU,GAClB;IACE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;CAC5B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,oDAAoD;AACpD,eAAO,MAAM,aAAa,mBAAmB,CAAC;AAE9C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B"}

package/dist/shared/realtime.js

@@ -0,0 +1,7 @@
+/** One run's status and transcript: `agents:runs:<runId>`. */
+export function runTopic(runId) {
+    return `agents:runs:${runId}`;
+}
+/** Runners came online, went offline or changed. */
+export const RUNNERS_TOPIC = 'agents:runners';
+//# sourceMappingURL=realtime.js.map

package/dist/shared/realtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.js","sourceRoot":"","sources":["../../shared/realtime.ts"],"names":[],"mappings":"AAOA,8DAA8D;AAC9D,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,OAAO,eAAe,KAAK,EAAE,CAAC;AAChC,CAAC;AAeD,oDAAoD;AACpD,MAAM,CAAC,MAAM,aAAa,GAAG,gBAAgB,CAAC"}