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

package/dist/client/hooks/use-vocabulary.d.ts

@@ -0,0 +1,38 @@
+import type { I18nText } from '../../shared/i18n.js';
+import type { AgentsVocabulary, ScopeVocabulary, SubjectVocabulary } from '../../shared/vocabulary.js';
+export declare function useVocabulary(): AgentsVocabulary;
+/** Translates a contributed text in its own namespace; `fallback` when there is none. */
+export declare function useText(): (text: I18nText | null | undefined, fallback: string) => string;
+interface Named<Name extends string | null> {
+    readonly name: Name;
+    readonly nameText?: I18nText | null;
+}
+/** An agent's name and description as people see them: an application's agent's in the viewer's language. */
+export interface AgentText {
+    /** Its name; null stays null (an agent that no longer exists). */
+    name<Name extends string | null>(agent: Named<Name>): Name;
+    description(agent: {
+        readonly description: string | null;
+        readonly descriptionText?: I18nText | null;
+    }): string | null;
+}
+/**
+ * Translates an agent's `nameText` and `descriptionText` (such as an application's built-in agents), falling back to the text as
+ * written; an agent people named shows its name as is.
+ */
+export declare function useAgentText(): AgentText;
+/**
+ * The scenarios "Preview full prompt" offers, the subject kinds with a sample: the application's first and a
+ * conversation last; empty when there is nothing to preview.
+ */
+export declare function usePreviewSubjects(): readonly SubjectVocabulary[];
+export declare function previewSubjects(subjects: readonly SubjectVocabulary[]): SubjectVocabulary[];
+export declare function subjectOf(vocabulary: AgentsVocabulary, kind: string): SubjectVocabulary | undefined;
+export declare function scopeOf(vocabulary: AgentsVocabulary, key: string): ScopeVocabulary | undefined;
+/**
+ * What started a run, in the viewer's language: the subject's own name for the trigger, else this plugin's (`retry`,
+ * `message`), else the trigger as it is.
+ */
+export declare function useTriggerLabel(): (subjectKind: string, trigger: string) => string;
+export {};
+//# sourceMappingURL=use-vocabulary.d.ts.map

package/dist/client/hooks/use-vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-vocabulary.d.ts","sourceRoot":"","sources":["../../../client/hooks/use-vocabulary.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EAClB,MAAM,4BAA4B,CAAC;AAMpC,wBAAgB,aAAa,IAAI,gBAAgB,CAQhD;AAED,yFAAyF;AACzF,wBAAgB,OAAO,IAAI,CACzB,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,EACjC,QAAQ,EAAE,MAAM,KACb,MAAM,CAOV;AAED,UAAU,KAAK,CAAC,IAAI,SAAS,MAAM,GAAG,IAAI;IACxC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;CACrC;AAED,6GAA6G;AAC7G,MAAM,WAAW,SAAS;IACxB,kEAAkE;IAClE,IAAI,CAAC,IAAI,SAAS,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3D,WAAW,CAAC,KAAK,EAAE;QACjB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QACpC,QAAQ,CAAC,eAAe,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;KAC5C,GAAG,MAAM,GAAG,IAAI,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAexC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,SAAS,iBAAiB,EAAE,CAGjE;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,SAAS,iBAAiB,EAAE,GACrC,iBAAiB,EAAE,CAMrB;AAED,wBAAgB,SAAS,CACvB,UAAU,EAAE,gBAAgB,EAC5B,IAAI,EAAE,MAAM,GACX,iBAAiB,GAAG,SAAS,CAE/B;AAED,wBAAgB,OAAO,CACrB,UAAU,EAAE,gBAAgB,EAC5B,GAAG,EAAE,MAAM,GACV,eAAe,GAAG,SAAS,CAE7B;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,CACjC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,KACZ,MAAM,CAaV"}

package/dist/client/hooks/use-vocabulary.js

@@ -0,0 +1,77 @@
+/**
+ * What the application calls the things agents work with (`GET agents/admin/vocabulary`), and its texts in the
+ * viewer's language. Read once per page; while it loads, or when it cannot be read, names fall back to their keys.
+ */
+import { useTranslation } from '@nocobase/i18n/client';
+import { useQuery } from '@tanstack/react-query';
+import { useCallback, useMemo } from 'react';
+import { ACCESS_NAMESPACE } from '../../shared/access.js';
+import { CONVERSATION_SUBJECT } from '../../shared/conversations.js';
+import { agentsKeys } from '../api/keys.js';
+import { useAgentsApi } from './use-agents-api.js';
+const EMPTY = { subjects: [], sources: [], scopes: [] };
+export function useVocabulary() {
+    const api = useAgentsApi();
+    const vocabulary = useQuery({
+        queryKey: agentsKeys.vocabulary,
+        queryFn: () => api.vocabulary(),
+        staleTime: 5 * 60_000,
+    });
+    return vocabulary.data ?? EMPTY;
+}
+/** Translates a contributed text in its own namespace; `fallback` when there is none. */
+export function useText() {
+    const { t } = useTranslation();
+    return useCallback((text, fallback) => text ? t(text.key, { ns: text.ns, defaultValue: fallback }) : fallback, [t]);
+}
+/**
+ * Translates an agent's `nameText` and `descriptionText` (such as an application's built-in agents), falling back to the text as
+ * written; an agent people named shows its name as is.
+ */
+export function useAgentText() {
+    const text = useText();
+    return useMemo(() => {
+        function name(agent) {
+            return agent.name === null ? null : text(agent.nameText, agent.name);
+        }
+        return {
+            name,
+            description: (agent) => agent.description === null
+                ? null
+                : text(agent.descriptionText, agent.description),
+        };
+    }, [text]);
+}
+/**
+ * The scenarios "Preview full prompt" offers, the subject kinds with a sample: the application's first and a
+ * conversation last; empty when there is nothing to preview.
+ */
+export function usePreviewSubjects() {
+    const { subjects } = useVocabulary();
+    return useMemo(() => previewSubjects(subjects), [subjects]);
+}
+export function previewSubjects(subjects) {
+    const offered = subjects.filter((subject) => subject.preview);
+    return [
+        ...offered.filter((subject) => subject.kind !== CONVERSATION_SUBJECT),
+        ...offered.filter((subject) => subject.kind === CONVERSATION_SUBJECT),
+    ];
+}
+export function subjectOf(vocabulary, kind) {
+    return vocabulary.subjects.find((subject) => subject.kind === kind);
+}
+export function scopeOf(vocabulary, key) {
+    return vocabulary.scopes.find((scope) => scope.key === key);
+}
+/**
+ * What started a run, in the viewer's language: the subject's own name for the trigger, else this plugin's (`retry`,
+ * `message`), else the trigger as it is.
+ */
+export function useTriggerLabel() {
+    const vocabulary = useVocabulary();
+    const text = useText();
+    // This plugin's own triggers, in its namespace whichever page asks.
+    const { t } = useTranslation(ACCESS_NAMESPACE);
+    return useCallback((subjectKind, trigger) => text(subjectOf(vocabulary, subjectKind)?.triggers[trigger], t(`runs.trigger.${trigger}`, { defaultValue: trigger })), [vocabulary, text, t]);
+}
+//# sourceMappingURL=use-vocabulary.js.map

package/dist/client/hooks/use-vocabulary.js.map

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

package/dist/client/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './plugin.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../client/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,4 @@
+// The plugin's public client surface. The default export is the registration factory an application lists in
+// its client/plugins.ts.
+export { default } from './plugin.js';
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../client/index.ts"],"names":[],"mappings":"AAAA,6GAA6G;AAC7G,yBAAyB;AACzB,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC"}

package/dist/client/kit.d.ts

@@ -0,0 +1,62 @@
+import { type ComponentType } from 'react';
+import type { ChatAgent } from '../shared/conversations.js';
+import { type VariableScopeOption } from './components/variables/variables-panel.js';
+export { AgentAvatar, type AgentAvatarSize, } from './components/agent-avatar.js';
+export { useAgentText, type AgentText } from './hooks/use-vocabulary.js';
+export { useFormatters, type Formatters } from './lib/format.js';
+export interface ScopeSectionProps {
+    /** `workdir`, or a scope key the application registered. */
+    readonly scope: string;
+    readonly scopeId: string;
+    /** Whether the viewer may change it (the scope's kind decides on the server as well). */
+    readonly canEdit: boolean;
+    /** What the section says the values are for, in the viewer's language; a general line when absent. */
+    readonly description?: string;
+}
+export type { VariableScopeOption };
+export interface ScopedVariablesSectionProps {
+    /** The scopes listed, the broadest first; each named in the Scope column. */
+    readonly scopes: readonly VariableScopeOption[];
+    readonly canEdit: boolean;
+    /** What the section says the values are for; a general line when absent. */
+    readonly description?: string;
+    /** Said under the table, such as which scope wins when two set the same name. */
+    readonly note?: string;
+}
+export interface PickerOption {
+    readonly value: string;
+    readonly label: string;
+    /** Such as `darwin/arm64 · online`. */
+    readonly description?: string;
+}
+export interface RunnerOptions {
+    readonly options: readonly PickerOption[];
+    readonly loading: boolean;
+    /** How many of them are online now, able to take work. */
+    readonly online: number;
+}
+/** An agent as a picker offers it. */
+export type AgentPickerOption = PickerOption;
+export interface AgentOptions {
+    readonly options: readonly AgentPickerOption[];
+    /** The same agents as the agent picker takes them, with their availability. */
+    readonly agents: readonly ChatAgent[];
+    readonly loading: boolean;
+    /** The viewer may not list agents. */
+    readonly failed: boolean;
+    /** An agent's name, or null when the viewer cannot see it. */
+    nameOf(agentId: string): string | null;
+}
+export declare const VariablesSection: ComponentType<ScopeSectionProps>;
+export declare const ScopedVariablesSection: ComponentType<ScopedVariablesSectionProps>;
+/**
+ * The agents discovered from runners, as the Agent page lists them, with enabling and editing for those who manage
+ * agents: for an application that composes its own Agent page.
+ */
+export declare const RunnerAgentsSection: ComponentType;
+export declare const DefaultSkillsSection: ComponentType<ScopeSectionProps>;
+/** The runners the viewer may see, as picker options. A hook: reads this plugin's cache from any tree. */
+export declare function useRunnerOptions(): RunnerOptions;
+/** The enabled agents, as picker options. A hook for any tree. */
+export declare function useAgentOptions(): AgentOptions;
+//# sourceMappingURL=kit.d.ts.map

package/dist/client/kit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kit.d.ts","sourceRoot":"","sources":["../../client/kit.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAiB,KAAK,aAAa,EAAqB,MAAM,OAAO,CAAC;AAG7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAG5D,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,2CAA2C,CAAC;AAOnD,OAAO,EACL,WAAW,EACX,KAAK,eAAe,GACrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEjE,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yFAAyF;IACzF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,sGAAsG;IACtG,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC,MAAM,WAAW,2BAA2B;IAC1C,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,iFAAiF;IACjF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,sCAAsC;AACtC,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAE7C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC/C,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,sCAAsC;IACtC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,8DAA8D;IAC9D,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACxC;AA4CD,eAAO,MAAM,gBAAgB,EAAE,aAAa,CAAC,iBAAiB,CAClC,CAAC;AAC7B,eAAO,MAAM,sBAAsB,EAAE,aAAa,CAAC,2BAA2B,CACjD,CAAC;AAC9B;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,aAAwC,CAAC;AAE3E,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC,iBAAiB,CACzC,CAAC;AAE1B,0GAA0G;AAC1G,wBAAgB,gBAAgB,IAAI,aAAa,CA2BhD;AAED,kEAAkE;AAClE,wBAAgB,eAAe,IAAI,YAAY,CA2B9C"}

package/dist/client/kit.js

@@ -0,0 +1,122 @@
+/**
+ * What the agents plugin offers the application's own pages (for example, in `client/agents/`):
+ *
+ * - `VariablesSection`: the variables and secrets of a scope (`workdir`, or a scope the application registers on the
+ *   server), write-only and audited as on an agent;
+ * - `ScopedVariablesSection`: the same for several scopes in one table with a Scope column (a project and its working
+ *   directories), adding a variable choosing its scope;
+ * - `DefaultSkillsSection`: the skills every run in that scope gets;
+ * - `useRunnerOptions`: the runners a directory used in place may be on, for a runner picker;
+ * - `useAgentOptions`: the enabled agents, for an agent picker, with their names and what each is good at, and as
+ *   `ChatAgent`s for the UI Library's `AgentPicker`;
+ * - `AgentAvatar`: an agent's generated avatar, the same on the application's pages as on this plugin's;
+ * - `useAgentText`: an agent's name and description in the viewer's language, for agents the application's own API
+ *   returns with their `nameText` and `descriptionText`.
+ *
+ * Each component brings this plugin's translations and query cache; the hooks read that cache from any tree.
+ */
+import { useTranslation } from '@nocobase/i18n/client';
+import { useQuery } from '@tanstack/react-query';
+import { createElement } from 'react';
+import { ACCESS_NAMESPACE } from '../shared/access.js';
+import { agentsKeys } from './api/keys.js';
+import { DefaultSkillsPanel } from './components/default-skills.js';
+import { VariablesPanel, } from './components/variables/variables-panel.js';
+import { useAgentsApi } from './hooks/use-agents-api.js';
+import { useAgentText } from './hooks/use-vocabulary.js';
+import { pickerAgentOf } from './lib/agents.js';
+import { RunnerAgentsSection as RunnerAgents } from './pages/agents/runner-agents.js';
+import { agentsQueryClient, withAgents } from './query.js';
+export { AgentAvatar, } from './components/agent-avatar.js';
+export { useAgentText } from './hooks/use-vocabulary.js';
+export { useFormatters } from './lib/format.js';
+function ScopeVariables({ scope, scopeId, canEdit, description, }) {
+    const { t } = useTranslation();
+    return createElement(VariablesPanel, {
+        scope,
+        scopeId,
+        canEdit,
+        title: t('scopeVariables.title'),
+        description: description ?? t('scopeVariables.description'),
+        className: 'max-w-none',
+    });
+}
+function ScopedVariables({ scopes, canEdit, description, note, }) {
+    const { t } = useTranslation();
+    return createElement(VariablesPanel, {
+        scopes,
+        canEdit,
+        title: t('scopeVariables.title'),
+        description: description ?? t('scopeVariables.description'),
+        ...(note ? { note } : {}),
+        className: 'max-w-none',
+    });
+}
+function ScopeSkills(props) {
+    // As wide as the card or dialog it is placed in, like the variables.
+    return createElement(DefaultSkillsPanel, {
+        ...props,
+        className: 'max-w-none',
+    });
+}
+export const VariablesSection = withAgents(ScopeVariables);
+export const ScopedVariablesSection = withAgents(ScopedVariables);
+/**
+ * The agents discovered from runners, as the Agent page lists them, with enabling and editing for those who manage
+ * agents: for an application that composes its own Agent page.
+ */
+export const RunnerAgentsSection = withAgents(RunnerAgents);
+export const DefaultSkillsSection = withAgents(ScopeSkills);
+/** The runners the viewer may see, as picker options. A hook: reads this plugin's cache from any tree. */
+export function useRunnerOptions() {
+    const api = useAgentsApi();
+    const { t } = useTranslation(ACCESS_NAMESPACE);
+    const runners = useQuery({
+        queryKey: agentsKeys.runners,
+        queryFn: () => api.runners(),
+    }, agentsQueryClient());
+    return {
+        loading: runners.isPending,
+        online: (runners.data ?? []).filter((runner) => runner.status === 'online')
+            .length,
+        options: (runners.data ?? [])
+            .filter((runner) => runner.status !== 'revoked')
+            .map((runner) => ({
+            value: runner.id,
+            label: runner.name,
+            description: [
+                `${runner.os}/${runner.arch}`,
+                t(`runtimes.status.${runner.status}`),
+            ]
+                .filter(Boolean)
+                .join(' · '),
+        })),
+    };
+}
+/** The enabled agents, as picker options. A hook for any tree. */
+export function useAgentOptions() {
+    const text = useAgentText();
+    const api = useAgentsApi();
+    const agents = useQuery({
+        queryKey: agentsKeys.agents,
+        queryFn: () => api.agents(),
+        staleTime: 30_000,
+    }, agentsQueryClient());
+    const list = agents.data ?? [];
+    const offered = list.filter((agent) => agent.status === 'enabled');
+    return {
+        loading: agents.isPending,
+        failed: agents.isError,
+        agents: offered.map((agent) => pickerAgentOf(agent, text.name(agent))),
+        options: offered.map((agent) => ({
+            value: agent.id,
+            label: text.name(agent),
+            description: text.description(agent) ?? undefined,
+        })),
+        nameOf: (agentId) => {
+            const agent = list.find((item) => item.id === agentId);
+            return agent ? text.name(agent) : null;
+        },
+    };
+}
+//# sourceMappingURL=kit.js.map

package/dist/client/kit.js.map

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

package/dist/client/lib/action-catalog.d.ts

@@ -0,0 +1,13 @@
+import type { AgentActionOption } from '../../shared/agents.js';
+export type { AgentActionOption };
+export interface AgentActionCatalog {
+    /** Every action an agent may be granted. */
+    list(): Promise<readonly AgentActionOption[]>;
+}
+/** Null: the server's catalog. */
+export declare const AgentActionCatalogContext: React.Context<AgentActionCatalog | null>;
+/** The catalog's actions, or undefined while it loads. An action an agent already has stays listed. */
+export declare function useAgentActions(current: readonly string[]): readonly AgentActionOption[] | undefined;
+/** The keys a new agent starts with: the actions marked `defaultOn`. */
+export declare function defaultActionKeys(options: readonly AgentActionOption[] | undefined): string[];
+//# sourceMappingURL=action-catalog.d.ts.map

package/dist/client/lib/action-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-catalog.d.ts","sourceRoot":"","sources":["../../../client/lib/action-catalog.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGhE,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,IAAI,IAAI,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC,CAAC;CAC/C;AAED,kCAAkC;AAClC,eAAO,MAAM,yBAAyB,EAAE,KAAK,CAAC,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAC/B,CAAC;AAEjD,uGAAuG;AACvG,wBAAgB,eAAe,CAC7B,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,SAAS,iBAAiB,EAAE,GAAG,SAAS,CA8B1C;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,iBAAiB,EAAE,GAAG,SAAS,GAChD,MAAM,EAAE,CAIV"}

package/dist/client/lib/action-catalog.js

@@ -0,0 +1,45 @@
+/**
+ * The business actions an agent can be allowed, for the agent editor's checkboxes. By default they come from the
+ * server (`GET /api/agents/admin/actions`), which offers what the application's commands name, with their titles and
+ * which ones a new agent starts with; an application may supply another catalog with `AgentActionCatalogContext`.
+ */
+import { createContext, useContext, useEffect, useMemo, useState } from 'react';
+import { useAgentsApi } from '../hooks/use-agents-api.js';
+/** Null: the server's catalog. */
+export const AgentActionCatalogContext = createContext(null);
+/** The catalog's actions, or undefined while it loads. An action an agent already has stays listed. */
+export function useAgentActions(current) {
+    const given = useContext(AgentActionCatalogContext);
+    const api = useAgentsApi();
+    const catalog = useMemo(() => given ?? { list: () => api.agentActions() }, [given, api]);
+    const [options, setOptions] = useState();
+    useEffect(() => {
+        let alive = true;
+        catalog.list().then((list) => {
+            if (alive)
+                setOptions(list);
+        }, () => {
+            if (alive)
+                setOptions([]);
+        });
+        return () => {
+            alive = false;
+        };
+    }, [catalog]);
+    if (!options)
+        return undefined;
+    const known = new Set(options.map((option) => option.key));
+    return [
+        ...options,
+        ...current
+            .filter((key) => !known.has(key))
+            .map((key) => ({ key, group: key.split('/', 1)[0] ?? key })),
+    ];
+}
+/** The keys a new agent starts with: the actions marked `defaultOn`. */
+export function defaultActionKeys(options) {
+    return (options ?? [])
+        .filter((option) => option.defaultOn && option.grantable !== false)
+        .map((option) => option.key);
+}
+//# sourceMappingURL=action-catalog.js.map

package/dist/client/lib/action-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-catalog.js","sourceRoot":"","sources":["../../../client/lib/action-catalog.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGhF,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAS1D,kCAAkC;AAClC,MAAM,CAAC,MAAM,yBAAyB,GACpC,aAAa,CAA4B,IAAI,CAAC,CAAC;AAEjD,uGAAuG;AACvG,MAAM,UAAU,eAAe,CAC7B,OAA0B;IAE1B,MAAM,KAAK,GAAG,UAAU,CAAC,yBAAyB,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,OAAO,CACrB,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,EACjD,CAAC,KAAK,EAAE,GAAG,CAAC,CACb,CAAC;IACF,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,EAAgC,CAAC;IACvE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,KAAK,GAAG,IAAI,CAAC;QACjB,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,CACjB,CAAC,IAAI,EAAE,EAAE;YACP,IAAI,KAAK;gBAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC,EACD,GAAG,EAAE;YACH,IAAI,KAAK;gBAAE,UAAU,CAAC,EAAE,CAAC,CAAC;QAC5B,CAAC,CACF,CAAC;QACF,OAAO,GAAG,EAAE;YACV,KAAK,GAAG,KAAK,CAAC;QAChB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACd,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3D,OAAO;QACL,GAAG,OAAO;QACV,GAAG,OAAO;aACP,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;aAChC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;KAC/D,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,iBAAiB,CAC/B,OAAiD;IAEjD,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;SACnB,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,KAAK,KAAK,CAAC;SAClE,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AACjC,CAAC"}

package/dist/client/lib/agents.d.ts

@@ -0,0 +1,7 @@
+import type { AgentView } from '../../shared/agents.js';
+import type { ChatAgent, ChatAvailability } from '../../shared/conversations.js';
+/** Whether the agent can take the viewer's work now, as the agent picker shows it. */
+export declare function availabilityOf(agent: AgentView): ChatAvailability;
+/** An agent of the Agent page's list as the agent picker takes it, named `name` (such as in the viewer's language). */
+export declare function pickerAgentOf(agent: AgentView, name: string, isSystemDefault?: boolean): ChatAgent;
+//# sourceMappingURL=agents.d.ts.map

package/dist/client/lib/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../client/lib/agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EACV,SAAS,EACT,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AAEvC,sFAAsF;AACtF,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,gBAAgB,CAiBjE;AAED,uHAAuH;AACvH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,MAAM,EACZ,eAAe,GAAE,OAAe,GAC/B,SAAS,CAaX"}

package/dist/client/lib/agents.js

@@ -0,0 +1,33 @@
+/** Whether the agent can take the viewer's work now, as the agent picker shows it. */
+export function availabilityOf(agent) {
+    const onlineRunners = agent.runners.team + agent.runners.mine > 0
+        ? agent.runners.team + agent.runners.mine
+        : 0;
+    if (agent.unusable === null)
+        return { online: true, reason: null, onlineRunners };
+    return {
+        online: false,
+        reason: agent.unusable === 'othersPersonal'
+            ? 'othersPersonal'
+            : agent.unusable === 'noRunner' || agent.unusable === 'unreported'
+                ? 'noRunner'
+                : 'agentArchived',
+        onlineRunners: 0,
+    };
+}
+/** An agent of the Agent page's list as the agent picker takes it, named `name` (such as in the viewer's language). */
+export function pickerAgentOf(agent, name, isSystemDefault = false) {
+    return {
+        id: agent.id,
+        name,
+        description: agent.description,
+        nameText: null,
+        descriptionText: null,
+        avatar: agent.avatar,
+        isSystemDefault,
+        isMyDefault: false,
+        availability: availabilityOf(agent),
+        personalOnly: agent.personalOnly,
+    };
+}
+//# sourceMappingURL=agents.js.map

package/dist/client/lib/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../../client/lib/agents.ts"],"names":[],"mappings":"AAMA,sFAAsF;AACtF,MAAM,UAAU,cAAc,CAAC,KAAgB;IAC7C,MAAM,aAAa,GACjB,KAAK,CAAC,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC;QACzC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI;QACzC,CAAC,CAAC,CAAC,CAAC;IACR,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI;QACzB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IACvD,OAAO;QACL,MAAM,EAAE,KAAK;QACb,MAAM,EACJ,KAAK,CAAC,QAAQ,KAAK,gBAAgB;YACjC,CAAC,CAAC,gBAAgB;YAClB,CAAC,CAAC,KAAK,CAAC,QAAQ,KAAK,UAAU,IAAI,KAAK,CAAC,QAAQ,KAAK,YAAY;gBAChE,CAAC,CAAC,UAAU;gBACZ,CAAC,CAAC,eAAe;QACvB,aAAa,EAAE,CAAC;KACjB,CAAC;AACJ,CAAC;AAED,uHAAuH;AACvH,MAAM,UAAU,aAAa,CAC3B,KAAgB,EAChB,IAAY,EACZ,kBAA2B,KAAK;IAEhC,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI;QACJ,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,QAAQ,EAAE,IAAI;QACd,eAAe,EAAE,IAAI;QACrB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,eAAe;QACf,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,cAAc,CAAC,KAAK,CAAC;QACnC,YAAY,EAAE,KAAK,CAAC,YAAY;KACjC,CAAC;AACJ,CAAC"}

package/dist/client/lib/diff.d.ts

@@ -0,0 +1,8 @@
+/** A line diff (longest common subsequence), for comparing skill versions. */
+export interface DiffLine {
+    readonly kind: 'same' | 'added' | 'removed';
+    readonly text: string;
+}
+/** The lines that turn `before` into `after`. Quadratic; skills are small (≤ 200 KB). */
+export declare function diffLines(before: string, after: string): DiffLine[];
+//# sourceMappingURL=diff.d.ts.map

package/dist/client/lib/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../client/lib/diff.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAE9E,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,yFAAyF;AACzF,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE,CAqDnE"}

package/dist/client/lib/diff.js

@@ -0,0 +1,55 @@
+/** A line diff (longest common subsequence), for comparing skill versions. */
+/** The lines that turn `before` into `after`. Quadratic; skills are small (≤ 200 KB). */
+export function diffLines(before, after) {
+    const a = before === '' ? [] : before.split('\n');
+    const b = after === '' ? [] : after.split('\n');
+    // Trim the common head and tail first: most edits touch a few lines.
+    let start = 0;
+    while (start < a.length && start < b.length && a[start] === b[start])
+        start += 1;
+    let endA = a.length;
+    let endB = b.length;
+    while (endA > start && endB > start && a[endA - 1] === b[endB - 1]) {
+        endA -= 1;
+        endB -= 1;
+    }
+    const midA = a.slice(start, endA);
+    const midB = b.slice(start, endB);
+    const rows = midA.length + 1;
+    const cols = midB.length + 1;
+    const table = new Uint32Array(rows * cols);
+    for (let i = midA.length - 1; i >= 0; i -= 1)
+        for (let j = midB.length - 1; j >= 0; j -= 1)
+            table[i * cols + j] =
+                midA[i] === midB[j]
+                    ? (table[(i + 1) * cols + j + 1] ?? 0) + 1
+                    : Math.max(table[(i + 1) * cols + j] ?? 0, table[i * cols + j + 1] ?? 0);
+    const result = a
+        .slice(0, start)
+        .map((text) => ({ kind: 'same', text }));
+    let i = 0;
+    let j = 0;
+    while (i < midA.length && j < midB.length) {
+        if (midA[i] === midB[j]) {
+            result.push({ kind: 'same', text: midA[i] ?? '' });
+            i += 1;
+            j += 1;
+        }
+        else if ((table[(i + 1) * cols + j] ?? 0) >= (table[i * cols + j + 1] ?? 0)) {
+            result.push({ kind: 'removed', text: midA[i] ?? '' });
+            i += 1;
+        }
+        else {
+            result.push({ kind: 'added', text: midB[j] ?? '' });
+            j += 1;
+        }
+    }
+    for (; i < midA.length; i += 1)
+        result.push({ kind: 'removed', text: midA[i] ?? '' });
+    for (; j < midB.length; j += 1)
+        result.push({ kind: 'added', text: midB[j] ?? '' });
+    for (const text of a.slice(endA))
+        result.push({ kind: 'same', text });
+    return result;
+}
+//# sourceMappingURL=diff.js.map

package/dist/client/lib/diff.js.map

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

package/dist/client/lib/download.d.ts

@@ -0,0 +1,5 @@
+/** Saves `blob` as a download named `filename`. */
+export declare function saveBlob(blob: Blob, filename: string): void;
+/** The last part of a path, for a file's download name. */
+export declare function baseName(path: string): string;
+//# sourceMappingURL=download.d.ts.map

package/dist/client/lib/download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../../client/lib/download.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAU3D;AAED,2DAA2D;AAC3D,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C"}

package/dist/client/lib/download.js

@@ -0,0 +1,17 @@
+/** Saves `blob` as a download named `filename`. */
+export function saveBlob(blob, filename) {
+    const url = URL.createObjectURL(blob);
+    const anchor = document.createElement('a');
+    anchor.href = url;
+    anchor.download = filename;
+    anchor.rel = 'noopener';
+    document.body.append(anchor);
+    anchor.click();
+    anchor.remove();
+    setTimeout(() => URL.revokeObjectURL(url), 0);
+}
+/** The last part of a path, for a file's download name. */
+export function baseName(path) {
+    return path.split('/').pop() || path;
+}
+//# sourceMappingURL=download.js.map

package/dist/client/lib/download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.js","sourceRoot":"","sources":["../../../client/lib/download.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,MAAM,UAAU,QAAQ,CAAC,IAAU,EAAE,QAAgB;IACnD,MAAM,GAAG,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC;IAClB,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,MAAM,CAAC,GAAG,GAAG,UAAU,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7B,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,MAAM,CAAC,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC;AACvC,CAAC"}

package/dist/client/lib/format.d.ts

@@ -0,0 +1,15 @@
+export interface Formatters {
+    /** Date and time in the current language, or "—" for an empty value. */
+    readonly dateTime: (iso: string | null | undefined) => string;
+    /** Time of day only, for transcript rows. */
+    readonly time: (iso: string | null | undefined) => string;
+    /** "3 minutes ago" in the current language, or "—". */
+    readonly relative: (iso: string | null | undefined) => string;
+}
+/** Formatters that follow the interface language. */
+export declare function useFormatters(): Formatters;
+/** "1m 05s" between two instants, or null when either is missing. */
+export declare function durationText(from: string | null | undefined, to: string | null | undefined): string | null;
+/** Splits "a, b  c" into distinct trimmed labels, in order. */
+export declare function parseList(text: string): string[];
+//# sourceMappingURL=format.d.ts.map

package/dist/client/lib/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../client/lib/format.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,KAAK,MAAM,CAAC;IAC9D,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,KAAK,MAAM,CAAC;IAC1D,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,KAAK,MAAM,CAAC;CAC/D;AAkBD,qDAAqD;AACrD,wBAAgB,aAAa,IAAI,UAAU,CA6B1C;AAED,qEAAqE;AACrE,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC5B,MAAM,GAAG,IAAI,CAcf;AAED,+DAA+D;AAC/D,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAOhD"}