@mcoda/db 0.1.4

package/dist/repositories/global/GlobalRepository.d.ts

@@ -0,0 +1,71 @@
+import { Database } from "sqlite";
+import { Agent, AgentAuthMetadata, AgentAuthSecret, AgentHealth, AgentModel, AgentPromptManifest, CreateAgentInput, UpdateAgentInput, WorkspaceDefault } from "@mcoda/shared";
+import { Connection } from "../../sqlite/connection.js";
+export type GlobalCommandStatus = "running" | "succeeded" | "failed";
+export interface GlobalCommandRunInsert {
+    commandName: string;
+    startedAt: string;
+    status: GlobalCommandStatus;
+    exitCode?: number | null;
+    errorSummary?: string | null;
+    payload?: Record<string, unknown>;
+}
+export interface GlobalCommandRun extends GlobalCommandRunInsert {
+    id: string;
+    completedAt?: string | null;
+    result?: Record<string, unknown>;
+}
+export interface GlobalTokenUsageInsert {
+    agentId?: string | null;
+    commandRunId?: string | null;
+    modelName?: string | null;
+    tokensPrompt?: number | null;
+    tokensCompletion?: number | null;
+    tokensTotal?: number | null;
+    costEstimate?: number | null;
+    durationSeconds?: number | null;
+    timestamp: string;
+    metadata?: Record<string, unknown>;
+}
+export declare class GlobalRepository {
+    private db;
+    private connection?;
+    constructor(db: Database, connection?: Connection | undefined);
+    static create(): Promise<GlobalRepository>;
+    close(): Promise<void>;
+    listAgents(): Promise<Agent[]>;
+    getAgentById(id: string): Promise<Agent | undefined>;
+    getAgentBySlug(slug: string): Promise<Agent | undefined>;
+    createAgent(input: CreateAgentInput): Promise<Agent>;
+    updateAgent(id: string, patch: UpdateAgentInput): Promise<Agent | undefined>;
+    deleteAgent(id: string): Promise<void>;
+    setAgentCapabilities(agentId: string, capabilities: string[]): Promise<void>;
+    getAgentCapabilities(agentId: string): Promise<string[]>;
+    setAgentModels(agentId: string, models: AgentModel[]): Promise<void>;
+    getAgentModels(agentId: string): Promise<AgentModel[]>;
+    setAgentPrompts(agentId: string, prompts: AgentPromptManifest): Promise<void>;
+    getAgentPrompts(agentId: string): Promise<AgentPromptManifest | undefined>;
+    setAgentAuth(agentId: string, encryptedSecret: string, lastVerifiedAt?: string): Promise<void>;
+    getAgentAuthMetadata(agentId: string): Promise<AgentAuthMetadata>;
+    getAgentAuthSecret(agentId: string): Promise<AgentAuthSecret | undefined>;
+    setAgentHealth(health: AgentHealth): Promise<void>;
+    getAgentHealth(agentId: string): Promise<AgentHealth | undefined>;
+    listAgentHealthSummary(): Promise<AgentHealth[]>;
+    setWorkspaceDefault(workspaceId: string, commandName: string, agentId: string, options?: {
+        qaProfile?: string;
+        docdexScope?: string;
+    }): Promise<void>;
+    getWorkspaceDefaults(workspaceId: string): Promise<WorkspaceDefault[]>;
+    removeWorkspaceDefault(workspaceId: string, commandName: string): Promise<void>;
+    findWorkspaceReferences(agentId: string): Promise<WorkspaceDefault[]>;
+    createCommandRun(record: GlobalCommandRunInsert): Promise<GlobalCommandRun>;
+    completeCommandRun(id: string, update: {
+        status: GlobalCommandStatus;
+        completedAt: string;
+        exitCode?: number | null;
+        errorSummary?: string | null;
+        result?: Record<string, unknown>;
+    }): Promise<void>;
+    recordTokenUsage(entry: GlobalTokenUsageInsert): Promise<void>;
+}
+//# sourceMappingURL=GlobalRepository.d.ts.map

package/dist/repositories/global/GlobalRepository.d.ts.map

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

package/dist/repositories/global/GlobalRepository.js

@@ -0,0 +1,281 @@
+import { randomUUID } from "node:crypto";
+import { Connection } from "../../sqlite/connection.js";
+import { GlobalMigrations } from "../../migrations/global/GlobalMigrations.js";
+const mapAgentRow = (row) => ({
+    id: row.id,
+    slug: row.slug,
+    adapter: row.adapter,
+    defaultModel: row.default_model ?? undefined,
+    rating: row.rating ?? undefined,
+    reasoningRating: row.reasoning_rating ?? undefined,
+    bestUsage: row.best_usage ?? undefined,
+    costPerMillion: row.cost_per_million ?? undefined,
+    config: row.config_json ? JSON.parse(row.config_json) : undefined,
+    createdAt: row.created_at,
+    updatedAt: row.updated_at,
+});
+export class GlobalRepository {
+    constructor(db, connection) {
+        this.db = db;
+        this.connection = connection;
+    }
+    static async create() {
+        const connection = await Connection.openGlobal();
+        await GlobalMigrations.run(connection.db);
+        return new GlobalRepository(connection.db, connection);
+    }
+    async close() {
+        if (this.connection) {
+            await this.connection.close();
+        }
+    }
+    async listAgents() {
+        const rows = await this.db.all("SELECT id, slug, adapter, default_model, rating, reasoning_rating, best_usage, cost_per_million, config_json, created_at, updated_at FROM agents ORDER BY slug ASC");
+        return rows.map(mapAgentRow);
+    }
+    async getAgentById(id) {
+        const row = await this.db.get("SELECT id, slug, adapter, default_model, rating, reasoning_rating, best_usage, cost_per_million, config_json, created_at, updated_at FROM agents WHERE id = ?", id);
+        return row ? mapAgentRow(row) : undefined;
+    }
+    async getAgentBySlug(slug) {
+        const row = await this.db.get("SELECT id, slug, adapter, default_model, rating, reasoning_rating, best_usage, cost_per_million, config_json, created_at, updated_at FROM agents WHERE slug = ?", slug);
+        return row ? mapAgentRow(row) : undefined;
+    }
+    async createAgent(input) {
+        const now = new Date().toISOString();
+        const id = randomUUID();
+        await this.db.run(`INSERT INTO agents (id, slug, adapter, default_model, rating, reasoning_rating, best_usage, cost_per_million, config_json, created_at, updated_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, id, input.slug, input.adapter, input.defaultModel ?? null, input.rating ?? null, input.reasoningRating ?? null, input.bestUsage ?? null, input.costPerMillion ?? null, input.config ? JSON.stringify(input.config) : null, now, now);
+        if (input.capabilities) {
+            await this.setAgentCapabilities(id, input.capabilities);
+        }
+        if (input.models) {
+            await this.setAgentModels(id, input.models);
+        }
+        if (input.prompts) {
+            await this.setAgentPrompts(id, { ...input.prompts, agentId: id });
+        }
+        return (await this.getAgentById(id));
+    }
+    async updateAgent(id, patch) {
+        const updates = [];
+        const params = [];
+        if (patch.adapter !== undefined) {
+            updates.push("adapter = ?");
+            params.push(patch.adapter);
+        }
+        if (patch.defaultModel !== undefined) {
+            updates.push("default_model = ?");
+            params.push(patch.defaultModel);
+        }
+        if (patch.rating !== undefined) {
+            updates.push("rating = ?");
+            params.push(patch.rating);
+        }
+        if (patch.reasoningRating !== undefined) {
+            updates.push("reasoning_rating = ?");
+            params.push(patch.reasoningRating);
+        }
+        if (patch.bestUsage !== undefined) {
+            updates.push("best_usage = ?");
+            params.push(patch.bestUsage);
+        }
+        if (patch.costPerMillion !== undefined) {
+            updates.push("cost_per_million = ?");
+            params.push(patch.costPerMillion);
+        }
+        if (patch.config !== undefined) {
+            updates.push("config_json = ?");
+            params.push(patch.config ? JSON.stringify(patch.config) : null);
+        }
+        if (updates.length > 0) {
+            updates.push("updated_at = ?");
+            params.push(new Date().toISOString());
+            params.push(id);
+            await this.db.run(`UPDATE agents SET ${updates.join(", ")} WHERE id = ?`, ...params);
+        }
+        if (patch.capabilities) {
+            await this.setAgentCapabilities(id, patch.capabilities);
+        }
+        if (patch.models) {
+            await this.setAgentModels(id, patch.models);
+        }
+        if (patch.prompts) {
+            await this.setAgentPrompts(id, { ...patch.prompts, agentId: id });
+        }
+        return this.getAgentById(id);
+    }
+    async deleteAgent(id) {
+        await this.db.run("DELETE FROM agents WHERE id = ?", id);
+    }
+    async setAgentCapabilities(agentId, capabilities) {
+        await this.db.run("DELETE FROM agent_capabilities WHERE agent_id = ?", agentId);
+        for (const capability of [...new Set(capabilities)]) {
+            await this.db.run("INSERT INTO agent_capabilities (agent_id, capability) VALUES (?, ?)", agentId, capability);
+        }
+    }
+    async getAgentCapabilities(agentId) {
+        const rows = await this.db.all("SELECT capability FROM agent_capabilities WHERE agent_id = ? ORDER BY capability ASC", agentId);
+        return rows.map((r) => r.capability);
+    }
+    async setAgentModels(agentId, models) {
+        await this.db.run("DELETE FROM agent_models WHERE agent_id = ?", agentId);
+        for (const model of models) {
+            await this.db.run("INSERT INTO agent_models (agent_id, model_name, is_default, config_json) VALUES (?, ?, ?, ?)", agentId, model.modelName, model.isDefault ? 1 : 0, model.config ? JSON.stringify(model.config) : null);
+        }
+    }
+    async getAgentModels(agentId) {
+        const rows = await this.db.all("SELECT agent_id, model_name, is_default, config_json FROM agent_models WHERE agent_id = ? ORDER BY model_name ASC", agentId);
+        return rows.map((row) => ({
+            agentId: row.agent_id,
+            modelName: row.model_name,
+            isDefault: Boolean(row.is_default),
+            config: row.config_json ? JSON.parse(row.config_json) : undefined,
+        }));
+    }
+    async setAgentPrompts(agentId, prompts) {
+        const now = new Date().toISOString();
+        const commandPromptsJson = prompts.commandPrompts ? JSON.stringify(prompts.commandPrompts) : null;
+        await this.db.run(`INSERT INTO agent_prompts (agent_id, job_prompt, character_prompt, command_prompts_json, job_path, character_path, created_at, updated_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+       ON CONFLICT(agent_id) DO UPDATE SET
+         job_prompt=excluded.job_prompt,
+         character_prompt=excluded.character_prompt,
+         command_prompts_json=excluded.command_prompts_json,
+         job_path=excluded.job_path,
+         character_path=excluded.character_path,
+         updated_at=excluded.updated_at`, agentId, prompts.jobPrompt ?? null, prompts.characterPrompt ?? null, commandPromptsJson, prompts.jobPath ?? null, prompts.characterPath ?? null, now, now);
+    }
+    async getAgentPrompts(agentId) {
+        const row = await this.db.get(`SELECT job_prompt, character_prompt, command_prompts_json, job_path, character_path
+       FROM agent_prompts WHERE agent_id = ?`, agentId);
+        if (!row)
+            return undefined;
+        return {
+            agentId,
+            jobPrompt: row.job_prompt ?? undefined,
+            characterPrompt: row.character_prompt ?? undefined,
+            commandPrompts: row.command_prompts_json ? JSON.parse(row.command_prompts_json) : undefined,
+            jobPath: row.job_path ?? undefined,
+            characterPath: row.character_path ?? undefined,
+        };
+    }
+    async setAgentAuth(agentId, encryptedSecret, lastVerifiedAt) {
+        const now = new Date().toISOString();
+        await this.db.run(`INSERT INTO agent_auth (agent_id, encrypted_secret, last_verified_at, created_at, updated_at)
+       VALUES (?, ?, ?, ?, ?)
+       ON CONFLICT(agent_id) DO UPDATE SET
+         encrypted_secret=excluded.encrypted_secret,
+         last_verified_at=excluded.last_verified_at,
+         updated_at=excluded.updated_at`, agentId, encryptedSecret, lastVerifiedAt ?? null, now, now);
+    }
+    async getAgentAuthMetadata(agentId) {
+        const row = await this.db.get("SELECT agent_id, encrypted_secret, last_verified_at, updated_at FROM agent_auth WHERE agent_id = ?", agentId);
+        return {
+            agentId,
+            configured: Boolean(row?.encrypted_secret),
+            lastUpdatedAt: row?.updated_at,
+            lastVerifiedAt: row?.last_verified_at ?? undefined,
+        };
+    }
+    async getAgentAuthSecret(agentId) {
+        const row = await this.db.get("SELECT agent_id, encrypted_secret, last_verified_at, updated_at FROM agent_auth WHERE agent_id = ?", agentId);
+        if (!row)
+            return undefined;
+        return {
+            agentId,
+            configured: true,
+            encryptedSecret: row.encrypted_secret,
+            lastVerifiedAt: row.last_verified_at ?? undefined,
+            lastUpdatedAt: row.updated_at,
+        };
+    }
+    async setAgentHealth(health) {
+        await this.db.run(`INSERT INTO agent_health (agent_id, status, last_checked_at, latency_ms, details_json)
+       VALUES (?, ?, ?, ?, ?)
+       ON CONFLICT(agent_id) DO UPDATE SET
+         status=excluded.status,
+         last_checked_at=excluded.last_checked_at,
+         latency_ms=excluded.latency_ms,
+         details_json=excluded.details_json`, health.agentId, health.status, health.lastCheckedAt, health.latencyMs ?? null, health.details ? JSON.stringify(health.details) : null);
+    }
+    async getAgentHealth(agentId) {
+        const row = await this.db.get("SELECT agent_id, status, last_checked_at, latency_ms, details_json FROM agent_health WHERE agent_id = ?", agentId);
+        if (!row)
+            return undefined;
+        return {
+            agentId,
+            status: row.status,
+            lastCheckedAt: row.last_checked_at,
+            latencyMs: row.latency_ms ?? undefined,
+            details: row.details_json ? JSON.parse(row.details_json) : undefined,
+        };
+    }
+    async listAgentHealthSummary() {
+        const rows = await this.db.all("SELECT agent_id, status, last_checked_at, latency_ms, details_json FROM agent_health");
+        return rows.map((row) => ({
+            agentId: row.agent_id,
+            status: row.status,
+            lastCheckedAt: row.last_checked_at,
+            latencyMs: row.latency_ms ?? undefined,
+            details: row.details_json ? JSON.parse(row.details_json) : undefined,
+        }));
+    }
+    async setWorkspaceDefault(workspaceId, commandName, agentId, options = {}) {
+        const now = new Date().toISOString();
+        await this.db.run(`INSERT INTO workspace_defaults (workspace_id, command_name, agent_id, qa_profile, docdex_scope, updated_at)
+       VALUES (?, ?, ?, ?, ?, ?)
+       ON CONFLICT(workspace_id, command_name) DO UPDATE SET
+         agent_id=excluded.agent_id,
+         qa_profile=excluded.qa_profile,
+         docdex_scope=excluded.docdex_scope,
+         updated_at=excluded.updated_at`, workspaceId, commandName, agentId, options.qaProfile ?? null, options.docdexScope ?? null, now);
+    }
+    async getWorkspaceDefaults(workspaceId) {
+        const rows = await this.db.all("SELECT workspace_id, command_name, agent_id, qa_profile, docdex_scope, updated_at FROM workspace_defaults WHERE workspace_id = ?", workspaceId);
+        return rows.map((row) => ({
+            workspaceId: row.workspace_id,
+            commandName: row.command_name,
+            agentId: row.agent_id,
+            qaProfile: row.qa_profile ?? undefined,
+            docdexScope: row.docdex_scope ?? undefined,
+            updatedAt: row.updated_at,
+        }));
+    }
+    async removeWorkspaceDefault(workspaceId, commandName) {
+        await this.db.run("DELETE FROM workspace_defaults WHERE workspace_id = ? AND command_name = ?", workspaceId, commandName);
+    }
+    async findWorkspaceReferences(agentId) {
+        const rows = await this.db.all("SELECT workspace_id, command_name, agent_id, qa_profile, docdex_scope, updated_at FROM workspace_defaults WHERE agent_id = ?", agentId);
+        return rows.map((row) => ({
+            workspaceId: row.workspace_id,
+            commandName: row.command_name,
+            agentId: row.agent_id,
+            qaProfile: row.qa_profile ?? undefined,
+            docdexScope: row.docdex_scope ?? undefined,
+            updatedAt: row.updated_at,
+        }));
+    }
+    async createCommandRun(record) {
+        const id = randomUUID();
+        await this.db.run(`INSERT INTO command_runs (id, command_name, started_at, status, exit_code, error_summary, payload_json)
+       VALUES (?, ?, ?, ?, ?, ?, ?)`, id, record.commandName, record.startedAt, record.status, record.exitCode ?? null, record.errorSummary ?? null, record.payload ? JSON.stringify(record.payload) : null);
+        return {
+            id,
+            ...record,
+            completedAt: null,
+        };
+    }
+    async completeCommandRun(id, update) {
+        await this.db.run(`UPDATE command_runs
+       SET status = ?, completed_at = ?, exit_code = ?, error_summary = ?, result_json = ?
+       WHERE id = ?`, update.status, update.completedAt, update.exitCode ?? null, update.errorSummary ?? null, update.result ? JSON.stringify(update.result) : null, id);
+    }
+    async recordTokenUsage(entry) {
+        const id = randomUUID();
+        await this.db.run(`INSERT INTO token_usage (
+        id, agent_id, command_run_id, model_name, tokens_prompt, tokens_completion, tokens_total,
+        cost_estimate, duration_seconds, timestamp, metadata_json
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, id, entry.agentId ?? null, entry.commandRunId ?? null, entry.modelName ?? null, entry.tokensPrompt ?? null, entry.tokensCompletion ?? null, entry.tokensTotal ?? null, entry.costEstimate ?? null, entry.durationSeconds ?? null, entry.timestamp, entry.metadata ? JSON.stringify(entry.metadata) : null);
+    }
+}