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

package/dist/server/composition.d.ts

@@ -0,0 +1,199 @@
+/**
+ * The one place the plugin's services are assembled from their dependencies. The provider binds the result to
+ * `agentsToken`; tests call it directly against a real database.
+ *
+ * Runner agents run on the runners people connect (`runners/`): one long-poll hands out their runs and the jobs of the
+ * off-by-default runner build method (`jobs/`) from the runners' shared slots, and jobs open the stored variables they
+ * name here. The runner and CLI tarballs the application serves are `distribution/`.
+ *
+ * Subject kinds (what runs work on), scopes, business actions, presets and who holds which action are added later by
+ * the application that assembles the plugin (through `subjects`, `scopes`, `actions`, `presets`, `gate`); this plugin
+ * brings the
+ * `conversation` subject.
+ */
+import type { RunApp } from '@nocobase/agent-protocol';
+import type { DatabaseManager } from '@nocobase/db';
+import { type DownloadTokenService, type DistConfig, type DistService } from './distribution/index.js';
+import { type JobService } from './jobs/index.js';
+import { type Clock } from './kernel/clock.js';
+import { type AgentsSecrets } from './kernel/secrets.js';
+import { type AgentsEventBus } from './kernel/events.js';
+import { type People } from './kernel/people.js';
+import { type ScopeKindRegistry } from './kernel/scopes.js';
+import { type TxRunner } from './kernel/tx.js';
+import { type RunnerService, type RunnerSweeper, type Slots, type WorkSignal } from './runners/index.js';
+import { type AgentActionCatalog, type AgentService } from './core/agents/index.js';
+import { type ChatAttachmentService, type ChatFileStorage, type ChatSettingsService, type ConversationService } from './core/conversations/index.js';
+import { type ConsultationService } from './core/consultations/index.js';
+import { type PresetRegistry } from './core/presets/index.js';
+import { type CallerGate, type CallerIdentity } from './core/callers/index.js';
+import { type PriceService, type ReportService } from './core/reports/index.js';
+import { type SkillDisk, type SkillService } from './core/skills/index.js';
+import { type VariableService } from './core/variables/index.js';
+import { type ModelGateway, type ModelServices, type ServerExecutor, type CommandSurface, type OnlineSkill, type ServerExecutorOptions } from './online/index.js';
+import { type Vectors, type VectorsConfig } from './vectors/index.js';
+import { type AgentCli, type Availability, type BriefPreviewer, type ClaimEligibility, type ClaimService, type RunnerReports, type RepoAccessRegistry, type RunMountRegistry, type RunnerView, type RunService, type SubjectRegistry } from './core/runs/index.js';
+export interface AgentsDeps {
+    readonly database: Pick<DatabaseManager, 'transaction' | 'connection'>;
+    readonly idGenerator: {
+        generateString(): string;
+    };
+    /**
+     * Who hands out work, as runners see it. The plugin passes `agents.app`, else the application's name; left out (tests,
+     * a standalone composition), the CLI's name, else `defaultRunApp`.
+     */
+    readonly app?: RunApp;
+    /** Where the tarballs of the runner and the CLI are, and which channel and versions to serve (`agents.dist`). */
+    readonly dist?: DistConfig;
+    /** The application's secrets service (`secrets.keys`); variables and model keys cannot be stored without it. */
+    readonly secrets?: AgentsSecrets;
+    /** The manifest URL handed to runners, as they reach the server. */
+    readonly manifestUrl?: string;
+    /** The application CLI a run exposes to its agent (`agents.cli`); named after `app` when left out (`resolveAgentCli`). */
+    readonly cli?: Partial<AgentCli>;
+    readonly clock?: Clock;
+    /**
+     * Where the contents of skills' files are stored: the application's drive, asked on each use. Memory when absent,
+     * which only tests and a throwaway application should rely on.
+     */
+    readonly skillDisk?: () => SkillDisk;
+    /**
+     * Where the files people send in chat are stored: the file plugin's repository and Drive in an application. Without
+     * it an upload answers 503 `NOT_IMPLEMENTED`.
+     */
+    readonly chatFiles?: ChatFileStorage;
+    /** The application's public base path (`/app`, or empty), for the URLs of files sent in chat. */
+    readonly basePath?: () => string;
+    readonly onError?: (message: string, error: unknown) => void;
+    /** The server executor of online runs (`agents.server`): model calls per run, its holder id. */
+    readonly server?: ServerExecutorOptions;
+    /**
+     * The vector store of vector collections (`agents.vectors`), apart from the application's database: sqlite-vec in
+     * `storage/vectors.sqlite` by default.
+     */
+    readonly vectors?: VectorsConfig;
+    /** The application's root and storage directories, which the vector store's relative paths resolve against. */
+    readonly paths?: {
+        readonly root: string;
+        readonly storage: string;
+    };
+    /**
+     * An online run's commands from the application's command manifest, sent as the run (`online/cli-command.ts`);
+     * undefined when there is none, and then its shell has no CLI.
+     */
+    readonly commandsOf?: (identity: CallerIdentity, token: string) => Promise<CommandSurface> | undefined;
+}
+export interface Agents {
+    readonly events: AgentsEventBus;
+    readonly tx: TxRunner;
+    readonly clock: Clock;
+    readonly agents: AgentService;
+    /**
+     * Per agent, whether it could start work now (a runner agent: an online runner with its tool enabled, installed and
+     * signed in, among the runners it may use and whose owner's policy lets it; an online agent: its model service offers
+     * its model), and how many of its runs have not finished.
+     */
+    readonly availability: Availability;
+    /**
+     * Whether a runner would actually take an agent's work done as a person, by the claim's rules: trust, features and
+     * whether it may receive the work's variables. For deciding before a run exists; call it outside a transaction.
+     */
+    readonly eligibility: ClaimEligibility;
+    /** Who runners register with: the application's id and name. */
+    readonly app: RunApp;
+    /** The application's CLI (`agents.cli`, resolved): what runs talk to it with and what the install script installs. */
+    readonly cli: AgentCli;
+    /** The runners people connect (each a runtime): registration, keys, heartbeats, what people change about one. */
+    readonly runners: RunnerService;
+    /** Which agents each runner may run and which runs one holds, for the runtimes pages. */
+    readonly runnerView: RunnerView;
+    /**
+     * Jobs: deterministic steps runners execute without a model (a build), of the kinds the application registers; used
+     * by the off-by-default runner build method.
+     */
+    readonly jobs: JobService;
+    /** A runner's slots, shared by its runs and its jobs. */
+    readonly slots: Slots;
+    /** Wakes long-polling runners (and the online executor); notified whenever work may have arrived. */
+    readonly signal: WorkSignal;
+    /** The runner and CLI tarballs the application serves. */
+    readonly dist: DistService;
+    /** Short-lived tokens that let the install script download the CLI for one platform. */
+    readonly downloadTokens: DownloadTokenService;
+    readonly runs: RunService;
+    readonly claims: ClaimService;
+    readonly reports: RunnerReports;
+    /** Marks silent runners offline, then takes back and ends the runs and jobs nobody will finish. */
+    readonly sweeper: RunnerSweeper;
+    /** Variables of agents, working directories and the scopes the application registers. */
+    readonly variables: VariableService;
+    /** The skill library and where skills are attached. */
+    readonly skills: SkillService;
+    /**
+     * What a run of an agent on a subject would be told now, and the sections the application adds to every brief
+     * (`briefs.sections`).
+     */
+    readonly briefs: BriefPreviewer;
+    /**
+     * Directories of files the application places beside the agent: offered per run at claim to runners with the
+     * `mounts` feature, served while the runner holds the run.
+     */
+    readonly mounts: RunMountRegistry;
+    /** Who a run's commits name and the short-lived credentials its checkouts push with, as the application gives them. */
+    readonly repoAccess: RepoAccessRegistry;
+    /** Names of people, from the directory the application plugs in. */
+    readonly people: People;
+    /**
+     * The scopes variables and default skills are kept in besides an agent's own: `workdir`, and the ones the
+     * application registers, with who may see and change what is kept there.
+     */
+    readonly scopes: ScopeKindRegistry;
+    /** Where the domain a run works on plugs in its context and hears how runs end. */
+    readonly subjects: SubjectRegistry;
+    /** Which business actions each caller holds, as the application says (`gate.set`). */
+    readonly gate: CallerGate;
+    /** The business actions an agent may be configured with, as the application offers them. */
+    readonly actions: AgentActionCatalog;
+    /** What runs used and cost (`usage`), and how they went (`runFigures`), for the application's reports. */
+    readonly reporting: ReportService;
+    /** The model prices reports estimate costs from. */
+    readonly prices: PriceService;
+    /** People's conversations with agents: the `conversation` subject kind of runs. */
+    readonly conversations: ConversationService;
+    /** The files people send with chat messages: uploads, reading them, and purging those never sent. */
+    readonly chatAttachments: ChatAttachmentService;
+    /**
+     * Online agents consulting each other (`ask_agent`): the `consultation` subject kind of runs, and where the
+     * application adds rules to a consulted agent's brief (`rules.provide`).
+     */
+    readonly consultations: ConsultationService;
+    /** The system default chat agent, and each person's default and "always confirm". */
+    readonly chat: ChatSettingsService;
+    /** Roles a new agent can start from, as the application registers them. */
+    readonly presets: PresetRegistry;
+    /**
+     * Online agents, run by the application itself: the model services they call (`agModelServices`), the gateway that
+     * calls their models (and the application's embedding, rerank and utility text calls: `embed`, `rerank`,
+     * `generate`), and this instance's executor, which the provider starts at boot.
+     */
+    readonly online: {
+        readonly services: ModelServices;
+        readonly gateway: ModelGateway;
+        readonly executor: ServerExecutor;
+        /** Skills every online run gets besides its own, such as the CLI's: `register` one, a release removes it. */
+        readonly skills: {
+            register(skill: OnlineSkill): () => void;
+            list(): readonly OnlineSkill[];
+        };
+    };
+    /**
+     * Vector collections the application keeps (`collection(spec)`), embedded with the model services' embedding models
+     * through a queue, over a pluggable vector store (`stores`; pgvector by default). The provider starts the queue's
+     * worker at boot.
+     */
+    readonly vectors: Vectors;
+}
+/** The application work comes from when nothing names it: the CLI's name, else a neutral one. */
+export declare function defaultRunApp(cli?: Partial<AgentCli>): RunApp;
+export declare function createAgents(deps: AgentsDeps): Agents;
+//# sourceMappingURL=composition.d.ts.map

package/dist/server/composition.d.ts.map

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

package/dist/server/composition.js

@@ -0,0 +1,373 @@
+import { createDistService, createDownloadTokenService, upgradeFor, } from './distribution/index.js';
+import { createJobKindRegistry, createJobService, } from './jobs/index.js';
+import { systemClock } from './kernel/clock.js';
+import { createSealer, MODEL_SERVICE_KEY_SECRET_PURPOSE, VARIABLES_SECRET_PURPOSE, } from './kernel/secrets.js';
+import { createEventBus } from './kernel/events.js';
+import { createIdSource } from './kernel/ids.js';
+import { createPeople } from './kernel/people.js';
+import { createSecretMemory } from './kernel/redaction.js';
+import { createScopeKinds } from './kernel/scopes.js';
+import { createTxRunner } from './kernel/tx.js';
+import { createRunnerService, createRunnerSweeper, createSlots, createWorkSignal, } from './runners/index.js';
+import { createAgentActionCatalog, createAgentService, } from './core/agents/index.js';
+import { createChatAttachments, createChatFileStorage, createChatSettingsService, createConversationService, createPageContextKinds, } from './core/conversations/index.js';
+import { createConsultationService, } from './core/consultations/index.js';
+import { createPresetRegistry, } from './core/presets/index.js';
+import { createCallerGate, } from './core/callers/index.js';
+import { createModelUsageRecorder, createPriceService, createReportService, } from './core/reports/index.js';
+import { createSkillBlobs, createSkillService, memoryDisk, } from './core/skills/index.js';
+import { createVariableService, } from './core/variables/index.js';
+import { createModelGateway, createModelServices, createServerExecutor, } from './online/index.js';
+import { createVectors, } from './vectors/index.js';
+import { createBriefPreviewer, createBriefSectionRegistry, createClaimEligibility, createClaimService, createRepoAccessRegistry, createRunMountRegistry, createRunnerReports, createRunService, createAvailability, createSubjectRegistry, createRunnerView, createSweeper, resolveAgentCli, runsHeldBy, runsHeldByTool, openCounts, } from './core/runs/index.js';
+/** The application work comes from when nothing names it: the CLI's name, else a neutral one. */
+export function defaultRunApp(cli) {
+    const id = cli?.name ?? 'app';
+    return { id, name: id };
+}
+export function createAgents(deps) {
+    const onError = deps.onError ??
+        ((message, error) => console.error(message, error));
+    const events = createEventBus((error) => onError('Agents event listener failed.', error));
+    const tx = createTxRunner(deps.database, events);
+    const ids = createIdSource(deps.idGenerator);
+    const clock = deps.clock ?? systemClock;
+    const subjects = createSubjectRegistry();
+    const signal = createWorkSignal();
+    const transitions = { clock, subjects };
+    const app = deps.app ?? defaultRunApp(deps.cli);
+    const cli = resolveAgentCli(deps.cli, app);
+    const people = createPeople();
+    const dist = createDistService(deps.dist);
+    const slots = createSlots(runsHeldBy, runsHeldByTool);
+    const runners = createRunnerService({
+        tx,
+        ids,
+        clock,
+        app,
+        people,
+        latestRunner: async (runner) => (await upgradeFor(dist, runner))?.latestVersion ?? null,
+    });
+    const jobs = createJobService({
+        tx,
+        ids,
+        clock,
+        events,
+        kinds: createJobKindRegistry(),
+        app,
+        slotsUsed: (conn, runnerId) => slots.used(conn, runnerId),
+        onError,
+    });
+    const modelServices = createModelServices({
+        tx,
+        clock,
+        box: createSealer(deps.secrets, MODEL_SERVICE_KEY_SECRET_PURPOSE),
+    });
+    // Embeddings, reranking and utility texts the application asks for are recorded apart from runs (`agModelUsage`).
+    const gateway = createModelGateway(modelServices, {
+        usage: createModelUsageRecorder({ tx, ids, clock }),
+        onError,
+    });
+    const vectors = createVectors({
+        tx,
+        ids,
+        clock,
+        embed: (request) => gateway.embed(request),
+        dimensionsOf: async (ref) => {
+            try {
+                return (await modelServices.endpointFor(ref, 'embedding')).dimensions;
+            }
+            catch {
+                return null;
+            }
+        },
+        ...(deps.vectors ? { config: deps.vectors } : {}),
+        ...(deps.paths ? { paths: deps.paths } : {}),
+        onError,
+    });
+    const actions = createAgentActionCatalog();
+    const scopes = createScopeKinds();
+    const variables = createVariableService({
+        tx,
+        ids,
+        clock,
+        box: createSealer(deps.secrets, VARIABLES_SECRET_PURPOSE),
+        people,
+        cli: cli.name,
+        // An agent's variables are part of its configuration: their changes go into its history, without values.
+        onChange: (conn, target, change) => target.scope === 'agent'
+            ? agents.noteVariable(conn, target.scopeId, change)
+            : Promise.resolve(),
+    });
+    const fallbackDisk = deps.skillDisk ? undefined : memoryDisk();
+    const skills = createSkillService({
+        tx,
+        ids,
+        clock,
+        people,
+        blobs: createSkillBlobs({
+            tx,
+            clock,
+            disk: deps.skillDisk ?? (() => fallbackDisk),
+        }),
+    });
+    const agents = createAgentService({
+        tx,
+        ids,
+        clock,
+        people,
+        models: () => gateway.catalog(),
+        actionTypes: (key) => actions.list().find((option) => option.key === key)?.types,
+        owned: {
+            openRuns: async (conn, agentId) => (await openCounts(conn, [agentId])).get(agentId) ?? 0,
+            clearVariables: (conn, agentId) => variables.clear(conn, { scope: 'agent', scopeId: agentId }),
+            withdrawQueued: async (unit, agentId, byUserId) => {
+                await runs.withdrawQueued({ agentId, byUserId, detail: 'The agent was archived.' }, unit);
+            },
+        },
+    });
+    const eligibility = createClaimEligibility({
+        runners,
+        variables,
+    });
+    const availability = createAvailability({
+        runners,
+        eligibility,
+        openRuns: openCounts,
+        models: gateway,
+    });
+    const runs = createRunService({
+        ...transitions,
+        tx,
+        ids,
+        agents,
+        cliName: cli.name,
+        appName: app.name,
+        runners: {
+            all: (conn) => runners.all(conn),
+            find: (conn, id) => runners.find(conn, id),
+            jobsByRunner: (conn) => slots.jobsByRunner(conn),
+        },
+    });
+    const sections = createBriefSectionRegistry();
+    const mounts = createRunMountRegistry();
+    const repoAccess = createRepoAccessRegistry();
+    // The secrets claims hand out, so what runners report is redacted of them before it is stored.
+    const secrets = createSecretMemory();
+    const consultations = createConsultationService({
+        tx,
+        runs,
+        mayInvoke: (agent, userId) => agents.mayInvoke(agent, userId),
+        people,
+    });
+    subjects.register(consultations.binding);
+    const builtInSkills = new Map();
+    const onlineSkills = {
+        register(skill) {
+            builtInSkills.set(skill.slug, skill);
+            return () => {
+                if (builtInSkills.get(skill.slug) === skill)
+                    builtInSkills.delete(skill.slug);
+            };
+        },
+        list: () => [...builtInSkills.values()],
+    };
+    const claims = createClaimService({
+        sections,
+        mounts,
+        repoAccess,
+        dist,
+        slotsUsed: (conn, runnerId) => slots.used(conn, runnerId),
+        ...transitions,
+        tx,
+        ids,
+        variables,
+        skills,
+        manifestUrl: deps.manifestUrl ?? '/api/cli/manifest',
+        app,
+        cli,
+        secrets,
+        onlineSkills: onlineSkills.list,
+        consultations,
+        onClaimFailure: (runId, error) => onError(`Agents could not assemble run ${runId}.`, error),
+        defaultModel: async (conn) => (await modelServices.defaults(conn)).effectiveChat,
+    });
+    const reports = createRunnerReports({ ...transitions, tx, ids, secrets });
+    const sweeper = createRunnerSweeper({
+        clock,
+        runners,
+        runs: createSweeper({ ...transitions, tx, ids, runners }),
+        jobs,
+    });
+    // Jobs open the stored variables they name here.
+    jobs.provideSecrets({
+        open: (conn, refs, delivery) => variables.forJob(conn, refs, delivery),
+    });
+    const chat = createChatSettingsService({ tx, clock, agents });
+    const basePath = deps.basePath ?? (() => '');
+    const chatAttachments = createChatAttachments({
+        tx,
+        basePath,
+        now: () => clock.now(),
+        storage: deps.chatFiles ??
+            createChatFileStorage({
+                uploader: () => null,
+                disks: () => null,
+                disk: () => 'local',
+            }),
+    });
+    const conversations = createConversationService({
+        tx,
+        ids,
+        clock,
+        agents,
+        runners,
+        eligibility,
+        runs,
+        people,
+        settings: chat,
+        contextKinds: createPageContextKinds(),
+        models: gateway,
+        attachments: chatAttachments.links,
+        basePath,
+    });
+    subjects.register(conversations.binding);
+    registerCoreContextKinds(conversations, agents, runs);
+    const gate = createCallerGate();
+    const executor = createServerExecutor({
+        clock,
+        claims,
+        reports,
+        runs,
+        conversations,
+        consultations,
+        images: (conversationId, ids, maxBytes) => chatAttachments.service.images(conversationId, ids, maxBytes),
+        commands: (identity, token) => deps.commandsOf?.(identity, token) ?? Promise.resolve(undefined),
+        skill: async (skill) => {
+            const snapshot = await skills.snapshot(skill.slug, skill.hash);
+            return {
+                ...snapshot,
+                name: skill.name,
+                description: skill.description,
+            };
+        },
+        builtInSkills: onlineSkills.list,
+        gateway,
+        signal,
+        onError,
+    }, deps.server);
+    events.on('run.queued', () => signal.notify());
+    events.on('run.requeued', () => signal.notify());
+    events.on('agent.changed', () => signal.notify());
+    events.on('job.queued', () => signal.notify());
+    events.on('runner.changed', () => signal.notify());
+    // The agent's text in a conversation becomes messages as the runner reports it; the run's end and reading the
+    // messages catch up on anything missed here.
+    events.on('run.events', (event) => {
+        conversations
+            .syncRun(event.runId)
+            .catch((error) => onError(`Agents could not record the replies of run ${event.runId}.`, error));
+    });
+    // The panel shows whether the agent is working: tell the owner when a conversation's run changes.
+    events.on('run.changed', (event) => {
+        runs
+            .get(event.runId)
+            .then(async (run) => {
+            // A consultation's changes show on the card of the conversation that asked it.
+            const conversation = await conversations.homeOf(tx.read(), run);
+            if (conversation)
+                events.emit({
+                    type: 'conversation.changed',
+                    conversationId: conversation.id,
+                    userId: conversation.userId,
+                });
+        })
+            .catch(() => undefined);
+    });
+    return {
+        events,
+        tx,
+        clock,
+        agents,
+        availability,
+        eligibility,
+        app,
+        cli,
+        runners,
+        runnerView: createRunnerView({ agents, subjects, tx }),
+        jobs,
+        slots,
+        signal,
+        dist,
+        downloadTokens: createDownloadTokenService({
+            tx,
+            ids,
+            clock,
+            product: cli.name,
+        }),
+        runs,
+        claims,
+        reports,
+        sweeper,
+        variables,
+        skills,
+        briefs: createBriefPreviewer({
+            tx,
+            clock,
+            subjects,
+            skills,
+            cliName: cli.name,
+            appName: app.name,
+            sections,
+        }),
+        mounts,
+        repoAccess,
+        people,
+        scopes,
+        subjects,
+        gate,
+        actions,
+        reporting: createReportService({ tx, clock, people, subjects }),
+        prices: createPriceService({ tx, ids, clock }),
+        conversations,
+        chatAttachments: chatAttachments.service,
+        consultations,
+        chat,
+        presets: createPresetRegistry(() => actions.keys()),
+        online: {
+            services: modelServices,
+            gateway,
+            executor,
+            skills: onlineSkills,
+        },
+        vectors,
+    };
+}
+/** The page context kinds this plugin knows: agents the person may wake, and runs they started or own. */
+function registerCoreContextKinds(conversations, agents, runs) {
+    conversations.contextKinds.register('agent', async (conn, userId, ids) => {
+        const found = new Map();
+        for (const id of ids) {
+            const agent = await agents.find(conn, id);
+            if (agent && agents.mayInvoke(agent, userId))
+                found.set(id, { title: agent.name, key: null, url: null });
+        }
+        return found;
+    });
+    conversations.contextKinds.register('run', async (conn, userId, ids) => {
+        const found = new Map();
+        for (const id of ids) {
+            const run = await runs.get(id).catch(() => null);
+            if (run && (run.actorUserId === userId || run.ownerUserId === userId)) {
+                const agent = await agents.find(conn, run.agentId);
+                found.set(id, {
+                    title: `${agent?.name ?? run.agentId} on ${run.subject.kind} ${run.subject.id}`,
+                    key: null,
+                    url: null,
+                });
+            }
+        }
+        return found;
+    });
+}
+//# sourceMappingURL=composition.js.map

package/dist/server/composition.js.map

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

package/dist/server/core/agents/actions.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The business actions an agent may be configured with: whatever the application offers (the actions its commands
+ * name), with their titles and which ones a new agent starts with, and those it lists only to show what is never
+ * granted to an agent. Without a source, there are none to offer.
+ */
+import type { AgentActionOption } from '../../../shared/agents.js';
+export interface AgentActionCatalog {
+    /** Sets where the actions come from; returns what removes it. */
+    provide(source: () => readonly AgentActionOption[]): () => void;
+    /** The actions, each key once, in the source's order. */
+    list(): readonly AgentActionOption[];
+    /** The keys of those that may be granted (not `grantable: false`). */
+    keys(): readonly string[];
+}
+export declare function createAgentActionCatalog(): AgentActionCatalog;
+//# sourceMappingURL=actions.d.ts.map

package/dist/server/core/agents/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../../server/core/agents/actions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,OAAO,CAAC,MAAM,EAAE,MAAM,SAAS,iBAAiB,EAAE,GAAG,MAAM,IAAI,CAAC;IAChE,yDAAyD;IACzD,IAAI,IAAI,SAAS,iBAAiB,EAAE,CAAC;IACrC,sEAAsE;IACtE,IAAI,IAAI,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED,wBAAgB,wBAAwB,IAAI,kBAAkB,CAuB7D"}

package/dist/server/core/agents/actions.js

@@ -0,0 +1,26 @@
+export function createAgentActionCatalog() {
+    let source;
+    const list = () => {
+        const seen = new Set();
+        return (source?.() ?? []).filter((option) => {
+            if (seen.has(option.key))
+                return false;
+            seen.add(option.key);
+            return true;
+        });
+    };
+    return {
+        provide(next) {
+            source = next;
+            return () => {
+                if (source === next)
+                    source = undefined;
+            };
+        },
+        list,
+        keys: () => list()
+            .filter((option) => option.grantable !== false)
+            .map((option) => option.key),
+    };
+}
+//# sourceMappingURL=actions.js.map

package/dist/server/core/agents/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../../../server/core/agents/actions.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,wBAAwB;IACtC,IAAI,MAAwD,CAAC;IAC7D,MAAM,IAAI,GAAG,GAAwB,EAAE;QACrC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,OAAO,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE;YAC1C,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC;gBAAE,OAAO,KAAK,CAAC;YACvC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IACF,OAAO;QACL,OAAO,CAAC,IAAI;YACV,MAAM,GAAG,IAAI,CAAC;YACd,OAAO,GAAG,EAAE;gBACV,IAAI,MAAM,KAAK,IAAI;oBAAE,MAAM,GAAG,SAAS,CAAC;YAC1C,CAAC,CAAC;QACJ,CAAC;QACD,IAAI;QACJ,IAAI,EAAE,GAAG,EAAE,CACT,IAAI,EAAE;aACH,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,KAAK,KAAK,CAAC;aAC9C,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC;KACjC,CAAC;AACJ,CAAC"}