@cogenta/cli 0.4.0 → 0.7.0

package/dist/commands/agent-runtime.d.ts

@@ -0,0 +1,160 @@
+import { type ApprovalQueue, type NotFoundLogReader, type ProviderClient, type RedirectWriter, type ThemeCreatorTargetTheme } from '@cogenta/agents';
+import type { AgentConversationStoreLike, AgentRegistryLike, AgentRunnerLike, AgentSkillRegistryLike, ContentService, PromptTemplateRegistryLike, ProviderRegistryLike } from '@cogenta/api';
+import type { AuditLog } from '@cogenta/auth';
+import type { Logger, MediaStore } from '@cogenta/core';
+import { type McpConnectionStore } from '@cogenta/mcp';
+import { type CollectionDefinition, type SiteSettingsStore } from '@cogenta/schema';
+/**
+ * L22 tasks 1/1bis — where the runtime `@cogenta/agents` provides finally
+ * meets a running site. `@cogenta/agents` knows how to run an agent given a
+ * tool registry, a provider registry and stores for declarations/skills/
+ * provider config; it does not know how to build a `ContentServiceLike` out
+ * of this codebase's real `ContentService`, or where on disk a site keeps
+ * its data — that translation is this module's whole job, the same role
+ * `assistant.ts` already plays for L18's toolset.
+ *
+ * Tool availability is not gated by whether a provider is configured (R2):
+ * the tool registry, the agent/skill/provider stores, and every CRUD route
+ * all work with zero LLM provider set up. Only `AgentRunner.run()` — one
+ * synchronous provider lookup before any network call — refuses, per
+ * `agents/orchestrator.ts`'s own `AGENT_NO_PROVIDER` guarantee.
+ */
+/**
+ * Exported for the same reason `PROVIDERS_SUBDIR` below is — `theme-wiring
+ * .ts` reads the "Cogenta Theme Creator" agent's own admin-configured
+ * `model.preferred`/`model.fallback` from a second `AgentDeclarationStore`
+ * instance pointed at this same directory, rather than duplicating a
+ * hardcoded guess at that agent's provider preference.
+ */
+export declare const AGENTS_SUBDIR = "agents";
+/**
+ * Exported so `theme-wiring.ts` can point its own `ProviderConfigStore` at
+ * the exact same directory `buildAgentRuntime` uses — two independent,
+ * file-backed store instances reading the same encrypted files, the same
+ * consistency model every other per-request store in this app already
+ * relies on. A second, differently-scoped constant here would have let the
+ * two silently drift apart, which is exactly the bug this constant's reuse
+ * closes (L26 task 5's theme generator answering "no provider" from a
+ * config file no admin who configured one through the UI ever touched).
+ */
+export declare const PROVIDERS_SUBDIR = "providers";
+export interface BuildAgentRuntimeOptions {
+    /** `.cogenta/agents-runtime` under the project root, by convention — see `runServe`. */
+    readonly dataDir: string;
+    /** For `deps.scan`, which reads this site's own `package.json`. */
+    readonly projectRoot: string;
+    readonly signingKey: string;
+    readonly site: {
+        readonly name: string;
+        readonly url?: string;
+        readonly locales: readonly string[];
+        readonly defaultLocale: string;
+    };
+    readonly contentService: ContentService;
+    readonly mediaStore: MediaStore;
+    readonly auditLog: AuditLog;
+    readonly logger: Logger;
+    /**
+     * The `assistant.defaultMaxOutputTokens`/`assistant.defaultRequestTimeoutSeconds`/
+     * `assistant.defaultMaxCorrectionAttempts` site settings live here
+     * (`SITE_SETTINGS_REGISTRY` in `@cogenta/schema`) — `createLiveProviderRegistry`
+     * below re-reads them (`resolveProviderTuningDefaults`) on every `refresh()`,
+     * the same "no restart needed" guarantee an edit to a per-provider override
+     * already gets.
+     */
+    readonly siteSettings: SiteSettingsStore;
+    /** The site's schema — for `content.collections`/`content.list` (L22 task 3) to know which collections have a public route, and to compute one. */
+    readonly collections: readonly CollectionDefinition[];
+    /** For `logs.read_not_found` (L22 task 3, the Site Monitor's own tool). */
+    readonly notFoundLog: NotFoundLogReader;
+    /** For `redirects.create` (L22 task 3). */
+    readonly redirects: RedirectWriter;
+    /**
+     * Injectable for tests — defaults to a fresh `createMemoryApprovalQueue()`.
+     * A non-reversible, side-effecting tool call (every core content/media
+     * write tool — `content.write_draft` included) always blocks on this
+     * queue regardless of an agent's own autonomy level (`with-autonomy.ts`'s
+     * `forcedApproval`, R6): nothing decides it on its own. A caller that
+     * wants to observe or decide pending requests (an approvals screen, a
+     * channel `/approve` command, or a test proving the *right* tool was
+     * proposed for a write) needs the same instance this runtime actually
+     * uses — hence this override and `AgentRuntimeAssembly.approvalQueue`
+     * below, rather than a queue this module keeps entirely to itself.
+     */
+    readonly approvalQueue?: ApprovalQueue;
+    /**
+     * Fiche 58 task 4 — external MCP connections this site has configured.
+     * Optional so a caller that builds a runtime without the registry (an
+     * older call site, a test) is unaffected: omitted, no MCP tool is ever
+     * wired in, exactly as if no connection existed.
+     */
+    readonly mcpConnections?: McpConnectionStore;
+    /**
+     * L26 task 5 — the "Cogenta Theme Creator" agent's own tool,
+     * `theme.propose_theme`. Absent whenever no LLM provider is configured
+     * (R2): the tool is then simply not registered, the same posture every
+     * other AI-backed piece of this runtime already takes (`createThemeWiring
+     * `'s own `generator` field, `AssistToolset`'s empty toolset). Built by
+     * `@cogenta/cli`'s `createThemeCreatorToolWiring` (`theme-wiring.ts`),
+     * which resolves the same `ProviderClient` and reads the same
+     * `availableThemes()` the appearance screen's own AI section already
+     * uses — never a second, independently-resolved client.
+     */
+    readonly themeCreator?: {
+        readonly resolveProvider: () => Promise<{
+            readonly client: ProviderClient;
+            readonly model: string;
+        } | undefined>;
+        readonly availableThemes: readonly ThemeCreatorTargetTheme[];
+    };
+}
+export interface AgentRuntimeAssembly {
+    readonly agentRegistry: AgentRegistryLike;
+    readonly agentRunner: AgentRunnerLike;
+    readonly providerRegistry: ProviderRegistryLike;
+    readonly skillRegistry: AgentSkillRegistryLike;
+    /** `/api/agents/:name/conversation` — one file store, same tier as the agent/skill/provider file stores below (R1). */
+    readonly conversations: AgentConversationStoreLike;
+    /** `/api/prompt-templates` (fiche 45) — the same store the assistant's `assist.*` tools resolve their instruction text against, so an edit here really does change what the next tool call sends the model. */
+    readonly promptTemplateRegistry: PromptTemplateRegistryLike;
+    /**
+     * Exposed so `serve.ts` can build the L22 task 3 notice source
+     * (`@cogenta/api`'s `createAgentApprovalsSource`) over the very same
+     * queue `co-pilot` autonomy files into — never a second queue that would
+     * disagree with what the runner actually proposed. Also the exact queue
+     * L22 task 2's channel/chat surfaces (or a future approvals REST route)
+     * would decide a pending write against — see
+     * `BuildAgentRuntimeOptions.approvalQueue`.
+     */
+    readonly approvalQueue: ApprovalQueue;
+    readonly summary: string;
+    /**
+     * Fiche 58 task 4 — rebuilds the MCP portion of this runtime's tool
+     * registry from `BuildAgentRuntimeOptions.mcpConnections`'s *current*
+     * state and swaps it in live. `serve.ts`'s `mcp-connections-router.ts`
+     * `onMutated` hook calls this after every create/enable/disable/remove/
+     * test/expose-tools mutation — the same "no restart needed" guarantee
+     * `/api/providers` already gives (`createLiveProviderRegistry.refresh`).
+     * A no-op when `mcpConnections` was never supplied.
+     */
+    refreshMcpTools(): Promise<void>;
+    /**
+     * Closes every `McpClient` (and removes every sandbox working directory)
+     * the *current* MCP tool assembly holds. A no-op when no MCP connection
+     * was ever wired in. Call once, on server shutdown (`serve.ts`'s
+     * `dispose`) — never mid-run, which would pull a live tool out from
+     * under an agent still using it.
+     */
+    mcpDispose(): Promise<void>;
+}
+/**
+ * Assembles the whole L22 task 1/1bis runtime for one site: three file
+ * stores (agents, agent skills, provider config — all under `dataDir`, R1),
+ * the real tool registry, and the one `AgentRunner` this site's `/api/agents`
+ * `run` route and any future trigger (cron, channel, chat — later tasks)
+ * will share. Idempotent: safe to call on every `cogenta serve` boot,
+ * including an upgrade from a pre-L22 site (`ensureBuiltinAgents`/
+ * `ensureBuiltinAgentSkills` only ever add what is missing).
+ */
+export declare function buildAgentRuntime(options: BuildAgentRuntimeOptions): Promise<AgentRuntimeAssembly>;
+//# sourceMappingURL=agent-runtime.d.ts.map

package/dist/commands/agent-runtime.d.ts.map

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