@adonis-agora/agent/dist/configure.js

Governed, durable-backed AI agent (chat + tool-calling + governance) for AdonisJS — part of the Agora ecosystem.

import { stubsRoot } from './stubs/main.js';
/**
 * `node ace configure @adonis-agora/agent` — auto-wires the package:
 *
 * 1. registers the agent service provider in `adonisrc.ts`;
 * 2. registers the embedded dashboard provider — the governance console SPA, bundled into this
 *    package's own `dist/` (`@adonis-agora/agent-dashboard`'s build output, copied in at build time),
 *    served with no separate install. Toggle/relocate it with the optional `config('agent').dashboard`
 *    block (see `config/agent.ts`); it mounts only once `governanceAuthorize` is configured — see the
 *    provider's own doc comment for why;
 * 3. registers the Assembler `init` hook that generates the typed `app/agent_tools` barrel at
 *    build/dev time (the provider imports it instead of scanning at runtime; it falls back to the
 *    runtime scan when the barrel is absent);
 * 4. registers the Assembler `init` hook that writes the sandbox kit docs (see `hooks/genui_kit`);
 * 5. publishes `config/agent.ts`;
 * 6. publishes `config/mcp.ts` (the MCP endpoint config; the MCP provider is separate);
 * 7. publishes the Lucid migrations for the agent tables — the base tables plus the two forward-only
 *    action-proposal upgrades (run `node ace migration:run`; delete them if you only use the
 *    in-memory store). They delegate to `createAgentTables`, so they are idempotent and safe to run
 *    against a database the library already auto-created;
 * 8. publishes the Postgres migrations for the RAG chunk table (pgvector; delete it unless you use
 *    `retrievers.pgvector({...})`) and the document-tree tables (delete it unless you use
 *    `PgDocumentTreeStore`).
 */
export async function configure(command) {
    const codemods = await command.createCodemods();
    await codemods.updateRcFile((rcFile) => {
        rcFile.addProvider('@adonis-agora/agent/agent_provider');
        rcFile.addProvider('@adonis-agora/agent/dashboard_provider');
        // Generate the typed app/agent_tools barrel at build/dev time (replaces the runtime readdir scan).
        rcFile.addAssemblerHook('init', '@adonis-agora/agent/hooks/tools');
        // Write the sandbox kit's docs (components and props, from their types) on serve/build, for an
        // app whose Vite is not in-process. A no-op without a kit (`components/ui`).
        rcFile.addAssemblerHook('init', '@adonis-agora/agent/hooks/genui_kit');
    });
    await codemods.makeUsingStub(stubsRoot, 'config/agent.stub', {});
    await codemods.makeUsingStub(stubsRoot, 'config/mcp.stub', {});
    await codemods.makeUsingStub(stubsRoot, 'database/migrations/create_agent_tables.stub', {});
    await codemods.makeUsingStub(stubsRoot, 'database/migrations/add_action_proposal_discovery.stub', {});
    await codemods.makeUsingStub(stubsRoot, 'database/migrations/add_action_proposal_runtime.stub', {});
    await codemods.makeUsingStub(stubsRoot, 'database/migrations/create_agent_rag_chunks.stub', {});
    await codemods.makeUsingStub(stubsRoot, 'database/migrations/create_agent_rag_trees.stub', {});
}
//# sourceMappingURL=configure.js.map