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

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

@@ -0,0 +1,27 @@
+import { ApiClientError, useToaster } from '@nocobase/app-client';
+import { useTranslation } from '@nocobase/i18n/client';
+import { useMemo } from 'react';
+/** Toasts through the application's toaster, with one reading of API errors for every page. */
+export function useNotify() {
+    const toaster = useToaster();
+    const { t } = useTranslation();
+    return useMemo(() => ({
+        success: (title) => void toaster.show({ type: 'success', title }),
+        error: (error, fallback) => void toaster.show({
+            type: 'error',
+            title: errorText(t, error, fallback ?? t('common.requestFailed')),
+        }),
+    }), [toaster, t]);
+}
+export function errorText(t, error, fallback) {
+    if (!(error instanceof ApiClientError))
+        return fallback;
+    if (error.status === 403)
+        return t('common.forbidden');
+    if (error.reason)
+        return t(`errors.${error.reason}`, {
+            defaultValue: error.message || fallback,
+        });
+    return error.message || fallback;
+}
+//# sourceMappingURL=use-notify.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-notify.js","sourceRoot":"","sources":["../../../client/hooks/use-notify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAQhC,+FAA+F;AAC/F,MAAM,UAAU,SAAS;IACvB,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,EAAE,CAAC,EAAE,GAAG,cAAc,EAAE,CAAC;IAC/B,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC;QACL,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QACjE,KAAK,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CACzB,KAAK,OAAO,CAAC,IAAI,CAAC;YAChB,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,IAAI,CAAC,CAAC,sBAAsB,CAAC,CAAC;SAClE,CAAC;KACL,CAAC,EACF,CAAC,OAAO,EAAE,CAAC,CAAC,CACb,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,CAA6D,EAC7D,KAAc,EACd,QAAgB;IAEhB,IAAI,CAAC,CAAC,KAAK,YAAY,cAAc,CAAC;QAAE,OAAO,QAAQ,CAAC;IACxD,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,CAAC;IACvD,IAAI,KAAK,CAAC,MAAM;QACd,OAAO,CAAC,CAAC,UAAU,KAAK,CAAC,MAAM,EAAE,EAAE;YACjC,YAAY,EAAE,KAAK,CAAC,OAAO,IAAI,QAAQ;SACxC,CAAC,CAAC;IACL,OAAO,KAAK,CAAC,OAAO,IAAI,QAAQ,CAAC;AACnC,CAAC"}

package/dist/client/hooks/use-realtime-topic.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Calls `listener` with each payload published on `topic`, and with `undefined` after a reconnect, since anything
+ * published while disconnected was missed. No topic, no subscription.
+ */
+export declare function useRealtimeTopic(topic: string | null, listener: (payload: unknown) => void): void;
+//# sourceMappingURL=use-realtime-topic.d.ts.map

package/dist/client/hooks/use-realtime-topic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-realtime-topic.d.ts","sourceRoot":"","sources":["../../../client/hooks/use-realtime-topic.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GACnC,IAAI,CAmBN"}

package/dist/client/hooks/use-realtime-topic.js

@@ -0,0 +1,24 @@
+import { realtimeClientToken, useService } from '@nocobase/app-client';
+import { useEffect, useRef } from 'react';
+/**
+ * Calls `listener` with each payload published on `topic`, and with `undefined` after a reconnect, since anything
+ * published while disconnected was missed. No topic, no subscription.
+ */
+export function useRealtimeTopic(topic, listener) {
+    const realtime = useService(realtimeClientToken);
+    const listenerRef = useRef(listener);
+    useEffect(() => {
+        listenerRef.current = listener;
+    });
+    useEffect(() => {
+        if (!topic)
+            return undefined;
+        const unsubscribe = realtime.subscribe(topic, ({ payload }) => listenerRef.current(payload));
+        const unsubscribeOpen = realtime.onOpen(() => listenerRef.current(undefined));
+        return () => {
+            unsubscribe();
+            unsubscribeOpen();
+        };
+    }, [realtime, topic]);
+}
+//# sourceMappingURL=use-realtime-topic.js.map

package/dist/client/hooks/use-realtime-topic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-realtime-topic.js","sourceRoot":"","sources":["../../../client/hooks/use-realtime-topic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE1C;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAoB,EACpB,QAAoC;IAEpC,MAAM,QAAQ,GAAG,UAAU,CAAC,mBAAmB,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrC,SAAS,CAAC,GAAG,EAAE;QACb,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAC;IACjC,CAAC,CAAC,CAAC;IACH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7B,MAAM,WAAW,GAAG,QAAQ,CAAC,SAAS,CAAU,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CACrE,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAC7B,CAAC;QACF,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,CAC3C,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAC/B,CAAC;QACF,OAAO,GAAG,EAAE;YACV,WAAW,EAAE,CAAC;YACd,eAAe,EAAE,CAAC;QACpB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;AACxB,CAAC"}

package/dist/client/hooks/use-server-url.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The application's public address including its base path, for commands shown to people (the router's basename is
+ * that path); not used to call the API.
+ */
+export declare function useServerUrl(): string;
+//# sourceMappingURL=use-server-url.d.ts.map

package/dist/client/hooks/use-server-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-server-url.d.ts","sourceRoot":"","sources":["../../../client/hooks/use-server-url.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAGrC"}

package/dist/client/hooks/use-server-url.js

@@ -0,0 +1,10 @@
+import { useHref } from 'react-router';
+/**
+ * The application's public address including its base path, for commands shown to people (the router's basename is
+ * that path); not used to call the API.
+ */
+export function useServerUrl() {
+    const basePath = useHref('/');
+    return new URL(basePath, window.location.origin).href.replace(/\/+$/u, '');
+}
+//# sourceMappingURL=use-server-url.js.map

package/dist/client/hooks/use-server-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-server-url.js","sourceRoot":"","sources":["../../../client/hooks/use-server-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,OAAO,IAAI,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC7E,CAAC"}

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,65 @@
+import { type ComponentType } from 'react';
+import type { AgentType } from '../shared/agents.js';
+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, with its type. */
+export interface AgentPickerOption extends PickerOption {
+    readonly type: AgentType;
+}
+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>;
+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 agents the viewer may see, as picker options, archived ones left out; only agents of `type` when given. A hook
+ * for any tree.
+ */
+export declare function useAgentOptions(filter?: {
+    readonly type?: AgentType;
+}): 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":"AAoBA,OAAO,EAAiB,KAAK,aAAa,EAAqB,MAAM,OAAO,CAAC;AAG7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAG5D,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,2CAA2C,CAAC;AAMnD,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,qDAAqD;AACrD,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;CAC1B;AAED,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,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC,iBAAiB,CACzC,CAAC;AAE1B,0GAA0G;AAC1G,wBAAgB,gBAAgB,IAAI,aAAa,CA2BhD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,MAAM,GAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAA;CAAO,GACzC,YAAY,CAkCd"}

package/dist/client/kit.js

@@ -0,0 +1,124 @@
+/**
+ * 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 agents the viewer may see, for an agent picker, with their names and types (Online or Runner),
+ *   optionally only one type (an issue's executor is a runner agent), 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 { 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);
+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 agents the viewer may see, as picker options, archived ones left out; only agents of `type` when given. A hook
+ * for any tree.
+ */
+export function useAgentOptions(filter = {}) {
+    const { t } = useTranslation(ACCESS_NAMESPACE);
+    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.archivedAt && (!filter.type || agent.type === filter.type));
+    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),
+            type: agent.type,
+            description: [t(`agentTypes.${agent.type}`), text.description(agent)]
+                .filter(Boolean)
+                .join(' · '),
+        })),
+        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,15 @@
+import type { AgentTool } from '@nocobase/agent-protocol';
+import { type AgentModelEntry, type AgentSummary } from '../../shared/agents.js';
+import type { ChatAgent, ChatAvailability } from '../../shared/conversations.js';
+import { type RunnerSummary } from '../../shared/runners.js';
+/** Whether the agent can answer now, as the agents list counts it: a runner online for it, or its model offered. */
+export declare function availabilityOf(agent: AgentSummary): ChatAvailability;
+/** An agent of the agents list as the agent picker takes it, named `name` (such as in the viewer's language). */
+export declare function pickerAgentOf(agent: AgentSummary, name: string, isSystemDefault?: boolean): ChatAgent;
+/** An entry of an agent's tools and models as one line: `Claude Code · opus`, `openai · gpt-5`. */
+export declare function entryText(entry: AgentModelEntry, t: (key: string) => string): string;
+/** Whether `runner` is online and has `tool` enabled, installed and signed in: it can take that tool's work now. */
+export declare function offersTool(runner: RunnerSummary, tool: AgentTool): boolean;
+/** How many runners can take `tool`'s work now, among `runnerIds` when it names any. */
+export declare function onlineFor(runners: readonly RunnerSummary[], tool: AgentTool, runnerIds?: readonly string[]): number;
+//# 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,0BAA0B,CAAC;AAE1D,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,YAAY,EAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EACV,SAAS,EACT,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAY,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAEvE,oHAAoH;AACpH,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,gBAAgB,CAQpE;AAED,iHAAiH;AACjH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,MAAM,EACZ,eAAe,GAAE,OAAe,GAC/B,SAAS,CAgBX;AAED,mGAAmG;AACnG,wBAAgB,SAAS,CACvB,KAAK,EAAE,eAAe,EACtB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GACzB,MAAM,CAOR;AAED,oHAAoH;AACpH,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAE1E;AAED,wFAAwF;AACxF,wBAAgB,SAAS,CACvB,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,IAAI,EAAE,SAAS,EACf,SAAS,GAAE,SAAS,MAAM,EAAO,GAChC,MAAM,CAMR"}

package/dist/client/lib/agents.js

@@ -0,0 +1,49 @@
+import { isRunnerEntry, } from '../../shared/agents.js';
+import { runsTool } from '../../shared/runners.js';
+/** Whether the agent can answer now, as the agents list counts it: a runner online for it, or its model offered. */
+export function availabilityOf(agent) {
+    return agent.onlineRunners > 0
+        ? { online: true, reason: null, onlineRunners: agent.onlineRunners }
+        : {
+            online: false,
+            reason: agent.type === 'runner' ? 'noRunner' : 'modelUnavailable',
+            onlineRunners: 0,
+        };
+}
+/** An agent of the agents 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,
+        type: agent.type,
+        models: [],
+        personal: false,
+        isSystemDefault,
+        isMyDefault: false,
+        availability: availabilityOf(agent),
+        fallbackAgentId: null,
+    };
+}
+/** An entry of an agent's tools and models as one line: `Claude Code · opus`, `openai · gpt-5`. */
+export function entryText(entry, t) {
+    const effort = entry.effort
+        ? ` · ${t(`agentForm.efforts.${entry.effort}`)}`
+        : '';
+    return isRunnerEntry(entry)
+        ? `${t(`tools.${entry.tool}`)} · ${entry.model ?? t('agents.defaultModel')}${effort}`
+        : `${entry.modelService} · ${entry.model}${effort}`;
+}
+/** Whether `runner` is online and has `tool` enabled, installed and signed in: it can take that tool's work now. */
+export function offersTool(runner, tool) {
+    return runner.status === 'online' && runsTool(runner, tool);
+}
+/** How many runners can take `tool`'s work now, among `runnerIds` when it names any. */
+export function onlineFor(runners, tool, runnerIds = []) {
+    return runners.filter((runner) => offersTool(runner, tool) &&
+        (runnerIds.length === 0 || runnerIds.includes(runner.id))).length;
+}
+//# 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":"AAEA,OAAO,EACL,aAAa,GAGd,MAAM,wBAAwB,CAAC;AAKhC,OAAO,EAAE,QAAQ,EAAsB,MAAM,yBAAyB,CAAC;AAEvE,oHAAoH;AACpH,MAAM,UAAU,cAAc,CAAC,KAAmB;IAChD,OAAO,KAAK,CAAC,aAAa,GAAG,CAAC;QAC5B,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE;QACpE,CAAC,CAAC;YACE,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,kBAAkB;YACjE,aAAa,EAAE,CAAC;SACjB,CAAC;AACR,CAAC;AAED,iHAAiH;AACjH,MAAM,UAAU,aAAa,CAC3B,KAAmB,EACnB,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,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE,KAAK;QACf,eAAe;QACf,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,cAAc,CAAC,KAAK,CAAC;QACnC,eAAe,EAAE,IAAI;KACtB,CAAC;AACJ,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,SAAS,CACvB,KAAsB,EACtB,CAA0B;IAE1B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM;QACzB,CAAC,CAAC,MAAM,CAAC,CAAC,qBAAqB,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE;QAChD,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,aAAa,CAAC,KAAK,CAAC;QACzB,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,qBAAqB,CAAC,GAAG,MAAM,EAAE;QACrF,CAAC,CAAC,GAAG,KAAK,CAAC,YAAY,MAAM,KAAK,CAAC,KAAK,GAAG,MAAM,EAAE,CAAC;AACxD,CAAC;AAED,oHAAoH;AACpH,MAAM,UAAU,UAAU,CAAC,MAAqB,EAAE,IAAe;IAC/D,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAC9D,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,SAAS,CACvB,OAAiC,EACjC,IAAe,EACf,YAA+B,EAAE;IAEjC,OAAO,OAAO,CAAC,MAAM,CACnB,CAAC,MAAM,EAAE,EAAE,CACT,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC;QACxB,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAC5D,CAAC,MAAM,CAAC;AACX,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"}