@mcoda/core 0.1.36 → 0.1.38

package/dist/api/MswarmApi.d.ts

@@ -0,0 +1,94 @@
+import { GlobalRepository } from "@mcoda/db";
+export interface MswarmCloudAgent {
+    slug: string;
+    provider: string;
+    default_model: string;
+    cost_per_million?: number;
+    rating?: number;
+    reasoning_rating?: number;
+    max_complexity?: number;
+    capabilities: string[];
+    health_status?: string;
+    context_window?: number;
+    supports_tools: boolean;
+    model_id?: string;
+    display_name?: string;
+    description?: string;
+    supports_reasoning?: boolean;
+    pricing_snapshot_id?: string;
+    pricing_version?: string;
+    sync?: Record<string, unknown>;
+}
+export interface MswarmCloudAgentDetail extends MswarmCloudAgent {
+    pricing?: Record<string, unknown>;
+    supported_parameters?: string[];
+    status?: string;
+    moderation_status?: string;
+    mcoda_shape?: Record<string, unknown>;
+}
+export interface ListMswarmCloudAgentsOptions {
+    provider?: string;
+    limit?: number;
+}
+export interface MswarmApiOptions {
+    baseUrl?: string;
+    openAiBaseUrl?: string;
+    apiKey?: string;
+    timeoutMs?: number;
+    agentSlugPrefix?: string;
+}
+interface ResolvedMswarmApiOptions {
+    baseUrl: string;
+    openAiBaseUrl?: string;
+    apiKey: string;
+    timeoutMs: number;
+    agentSlugPrefix: string;
+}
+export interface ManagedMswarmCloudConfig {
+    managed: true;
+    remoteSlug: string;
+    provider: string;
+    modelId?: string;
+    displayName?: string;
+    description?: string;
+    supportsReasoning?: boolean;
+    pricingSnapshotId?: string;
+    pricingVersion?: string;
+    catalogBaseUrl: string;
+    openAiBaseUrl: string;
+    sync?: Record<string, unknown>;
+    syncedAt: string;
+}
+export interface ManagedMswarmAgentConfig extends Record<string, unknown> {
+    baseUrl: string;
+    apiBaseUrl: string;
+    mswarmCloud: ManagedMswarmCloudConfig;
+}
+export interface MswarmSyncRecord {
+    remoteSlug: string;
+    localSlug: string;
+    action: "created" | "updated";
+    provider: string;
+    defaultModel: string;
+    pricingVersion?: string;
+}
+export interface MswarmSyncSummary {
+    created: number;
+    updated: number;
+    agents: MswarmSyncRecord[];
+}
+export declare class MswarmApi {
+    private readonly repo;
+    private readonly options;
+    readonly baseUrl: string;
+    readonly agentSlugPrefix: string;
+    constructor(repo: GlobalRepository, options: ResolvedMswarmApiOptions);
+    static create(options?: MswarmApiOptions): Promise<MswarmApi>;
+    close(): Promise<void>;
+    private requestJson;
+    listCloudAgents(options?: ListMswarmCloudAgentsOptions): Promise<MswarmCloudAgent[]>;
+    getCloudAgent(slug: string): Promise<MswarmCloudAgentDetail>;
+    syncCloudAgents(options?: ListMswarmCloudAgentsOptions): Promise<MswarmSyncSummary>;
+}
+export {};
+//# sourceMappingURL=MswarmApi.d.ts.map

package/dist/api/MswarmApi.d.ts.map

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

package/dist/api/MswarmApi.js

@@ -0,0 +1,306 @@
+import { GlobalRepository } from "@mcoda/db";
+import { CryptoHelper, } from "@mcoda/shared";
+import { MswarmConfigStore } from "./MswarmConfigStore.js";
+const DEFAULT_BASE_URL = "https://api.mswarm.org/";
+const DEFAULT_TIMEOUT_MS = 15000;
+const DEFAULT_AGENT_SLUG_PREFIX = "mswarm-cloud";
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const resolveString = (value) => typeof value === "string" && value.trim() ? value : undefined;
+const resolveNumber = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
+const resolveBoolean = (value) => typeof value === "boolean" ? value : undefined;
+const resolveStringArray = (value) => {
+    if (!Array.isArray(value))
+        return [];
+    return value.filter((entry) => typeof entry === "string" && entry.trim().length > 0);
+};
+const normalizeBaseUrl = (value, label) => {
+    const trimmed = value?.trim();
+    if (!trimmed) {
+        throw new Error(`${label} is required`);
+    }
+    let parsed;
+    try {
+        parsed = new URL(trimmed);
+    }
+    catch {
+        throw new Error(`${label} must be an absolute URL`);
+    }
+    return parsed.toString();
+};
+const normalizePositiveInt = (value, label, fallback) => {
+    if (value === undefined)
+        return fallback;
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new Error(`${label} must be a positive integer`);
+    }
+    return Math.trunc(value);
+};
+const resolveOptions = async (options = {}) => {
+    const envTimeoutRaw = process.env.MCODA_MSWARM_TIMEOUT_MS;
+    const envTimeout = envTimeoutRaw ? Number.parseInt(envTimeoutRaw, 10) : undefined;
+    const directBaseUrl = options.baseUrl ?? process.env.MCODA_MSWARM_BASE_URL;
+    const directOpenAiBaseUrl = options.openAiBaseUrl ?? process.env.MCODA_MSWARM_OPENAI_BASE_URL;
+    const directApiKey = options.apiKey ?? process.env.MCODA_MSWARM_API_KEY;
+    const directTimeout = options.timeoutMs ?? envTimeout;
+    const directAgentSlugPrefix = options.agentSlugPrefix ?? process.env.MCODA_MSWARM_AGENT_SLUG_PREFIX;
+    const needsStoredFallback = directBaseUrl === undefined ||
+        directApiKey === undefined ||
+        directTimeout === undefined ||
+        directAgentSlugPrefix === undefined;
+    const stored = needsStoredFallback ? await new MswarmConfigStore().readState() : {};
+    return {
+        baseUrl: normalizeBaseUrl(directBaseUrl ?? stored.baseUrl ?? DEFAULT_BASE_URL, "MCODA_MSWARM_BASE_URL"),
+        openAiBaseUrl: directOpenAiBaseUrl
+            ? normalizeBaseUrl(directOpenAiBaseUrl, "MCODA_MSWARM_OPENAI_BASE_URL")
+            : undefined,
+        apiKey: resolveString(directApiKey ?? stored.apiKey) ?? (() => {
+            throw new Error("MCODA_MSWARM_API_KEY is required");
+        })(),
+        timeoutMs: normalizePositiveInt(directTimeout ?? stored.timeoutMs, "MCODA_MSWARM_TIMEOUT_MS", DEFAULT_TIMEOUT_MS),
+        agentSlugPrefix: resolveString(directAgentSlugPrefix ?? stored.agentSlugPrefix) ?? DEFAULT_AGENT_SLUG_PREFIX,
+    };
+};
+const uniqueStrings = (values) => Array.from(new Set(values.filter((value) => value.trim().length > 0)));
+const toManagedLocalSlug = (prefix, remoteSlug) => {
+    const normalized = remoteSlug
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return `${prefix}-${normalized || "agent"}`;
+};
+const toHealthStatus = (value) => {
+    const normalized = value?.trim().toLowerCase();
+    if (!normalized)
+        return undefined;
+    if (normalized === "healthy")
+        return "healthy";
+    if (normalized === "degraded" || normalized === "unknown" || normalized === "limited")
+        return "degraded";
+    if (normalized === "unreachable" || normalized === "offline")
+        return "unreachable";
+    return undefined;
+};
+const isManagedMswarmConfig = (config) => {
+    if (!isRecord(config))
+        return false;
+    if (!isRecord(config.mswarmCloud))
+        return false;
+    return config.mswarmCloud.managed === true;
+};
+const toManagedConfig = (existingConfig, catalogBaseUrl, openAiBaseUrl, agent, syncedAt) => {
+    const nextConfig = {
+        ...(existingConfig ?? {}),
+        baseUrl: openAiBaseUrl,
+        apiBaseUrl: openAiBaseUrl,
+        mswarmCloud: {
+            managed: true,
+            remoteSlug: agent.slug,
+            provider: agent.provider,
+            modelId: agent.model_id,
+            displayName: agent.display_name,
+            description: agent.description,
+            supportsReasoning: agent.supports_reasoning,
+            pricingSnapshotId: agent.pricing_snapshot_id,
+            pricingVersion: agent.pricing_version,
+            catalogBaseUrl,
+            openAiBaseUrl,
+            sync: isRecord(agent.sync) ? agent.sync : undefined,
+            syncedAt,
+        },
+    };
+    return nextConfig;
+};
+const toCloudAgent = (value) => {
+    if (!isRecord(value)) {
+        throw new Error("mswarm returned an invalid cloud-agent payload");
+    }
+    const slug = resolveString(value.slug);
+    const provider = resolveString(value.provider);
+    const defaultModel = resolveString(value.default_model);
+    const supportsTools = resolveBoolean(value.supports_tools);
+    if (!slug || !provider || !defaultModel || supportsTools === undefined) {
+        throw new Error("mswarm cloud-agent payload is missing required fields");
+    }
+    return {
+        slug,
+        provider,
+        default_model: defaultModel,
+        cost_per_million: resolveNumber(value.cost_per_million),
+        rating: resolveNumber(value.rating),
+        reasoning_rating: resolveNumber(value.reasoning_rating),
+        max_complexity: resolveNumber(value.max_complexity),
+        capabilities: resolveStringArray(value.capabilities),
+        health_status: resolveString(value.health_status),
+        context_window: resolveNumber(value.context_window),
+        supports_tools: supportsTools,
+        model_id: resolveString(value.model_id),
+        display_name: resolveString(value.display_name),
+        description: resolveString(value.description),
+        supports_reasoning: resolveBoolean(value.supports_reasoning),
+        pricing_snapshot_id: resolveString(value.pricing_snapshot_id),
+        pricing_version: resolveString(value.pricing_version),
+        sync: isRecord(value.sync) ? value.sync : undefined,
+    };
+};
+const toCloudAgentDetail = (value) => {
+    const agent = toCloudAgent(value);
+    const record = isRecord(value) ? value : {};
+    return {
+        ...agent,
+        pricing: isRecord(record.pricing) ? record.pricing : undefined,
+        supported_parameters: resolveStringArray(record.supported_parameters),
+        status: resolveString(record.status),
+        moderation_status: resolveString(record.moderation_status),
+        mcoda_shape: isRecord(record.mcoda_shape) ? record.mcoda_shape : undefined,
+    };
+};
+const toAgentModels = (agentId, entry) => [
+    {
+        agentId,
+        modelName: entry.default_model,
+        isDefault: true,
+        config: {
+            provider: entry.provider,
+            remoteSlug: entry.slug,
+            modelId: entry.model_id,
+            pricingVersion: entry.pricing_version,
+        },
+    },
+];
+export class MswarmApi {
+    constructor(repo, options) {
+        this.repo = repo;
+        this.options = options;
+        this.baseUrl = options.baseUrl;
+        this.agentSlugPrefix = options.agentSlugPrefix;
+    }
+    static async create(options = {}) {
+        const repo = await GlobalRepository.create();
+        return new MswarmApi(repo, await resolveOptions(options));
+    }
+    async close() {
+        await this.repo.close();
+    }
+    async requestJson(pathname, query) {
+        const url = new URL(pathname, this.options.baseUrl);
+        if (query) {
+            for (const [key, value] of Object.entries(query)) {
+                if (value === undefined)
+                    continue;
+                url.searchParams.set(key, String(value));
+            }
+        }
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this.options.timeoutMs);
+        try {
+            const response = await fetch(url.toString(), {
+                headers: {
+                    accept: "application/json",
+                    "x-api-key": this.options.apiKey,
+                },
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const body = await response.text().catch(() => "");
+                throw new Error(`mswarm request failed (${response.status}): ${body || response.statusText}`);
+            }
+            try {
+                return (await response.json());
+            }
+            catch (error) {
+                throw new Error(`mswarm response was not valid JSON: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === "AbortError") {
+                throw new Error(`mswarm request timed out after ${this.options.timeoutMs}ms`);
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    async listCloudAgents(options = {}) {
+        const payload = await this.requestJson("/v1/swarm/cloud/agents", {
+            shape: "mcoda",
+            provider: options.provider,
+            limit: options.limit,
+        });
+        const agents = Array.isArray(payload.agents) ? payload.agents : [];
+        return agents.map(toCloudAgent);
+    }
+    async getCloudAgent(slug) {
+        if (!slug.trim()) {
+            throw new Error("Cloud-agent slug is required");
+        }
+        const payload = await this.requestJson(`/v1/swarm/cloud/agents/${encodeURIComponent(slug)}`);
+        return toCloudAgentDetail(payload);
+    }
+    async syncCloudAgents(options = {}) {
+        const agents = await this.listCloudAgents(options);
+        const openAiBaseUrl = this.options.openAiBaseUrl ?? new URL("/v1/swarm/openai/", this.options.baseUrl).toString();
+        const syncedAt = new Date().toISOString();
+        const encryptedApiKey = await CryptoHelper.encryptSecret(this.options.apiKey);
+        const records = [];
+        for (const agent of agents) {
+            const localSlug = toManagedLocalSlug(this.options.agentSlugPrefix, agent.slug);
+            const existing = await this.repo.getAgentBySlug(localSlug);
+            if (existing && (!isManagedMswarmConfig(existing.config) || existing.config.mswarmCloud.remoteSlug !== agent.slug)) {
+                throw new Error(`Refusing to overwrite non-mswarm agent ${localSlug}`);
+            }
+            const existingConfig = existing && isRecord(existing.config) ? existing.config : undefined;
+            const nextConfig = toManagedConfig(existingConfig, this.options.baseUrl, openAiBaseUrl, agent, syncedAt);
+            const baseInput = {
+                slug: localSlug,
+                adapter: "openai-api",
+                defaultModel: agent.default_model,
+                openaiCompatible: true,
+                contextWindow: agent.context_window,
+                supportsTools: agent.supports_tools,
+                rating: agent.rating,
+                reasoningRating: agent.reasoning_rating,
+                costPerMillion: agent.cost_per_million,
+                maxComplexity: agent.max_complexity,
+                config: nextConfig,
+                capabilities: uniqueStrings(agent.capabilities),
+            };
+            const stored = existing
+                ? await this.repo.updateAgent(existing.id, baseInput)
+                : await this.repo.createAgent(baseInput);
+            if (!stored) {
+                throw new Error(`Failed to persist synced agent ${localSlug}`);
+            }
+            await this.repo.setAgentModels(stored.id, toAgentModels(stored.id, agent));
+            await this.repo.setAgentAuth(stored.id, encryptedApiKey);
+            const mappedHealth = toHealthStatus(agent.health_status);
+            if (mappedHealth) {
+                const health = {
+                    agentId: stored.id,
+                    status: mappedHealth,
+                    lastCheckedAt: syncedAt,
+                    details: {
+                        source: "mswarm",
+                        remoteSlug: agent.slug,
+                        remoteHealthStatus: agent.health_status,
+                    },
+                };
+                await this.repo.setAgentHealth(health);
+            }
+            records.push({
+                remoteSlug: agent.slug,
+                localSlug,
+                action: existing ? "updated" : "created",
+                provider: agent.provider,
+                defaultModel: agent.default_model,
+                pricingVersion: agent.pricing_version,
+            });
+        }
+        return {
+            created: records.filter((record) => record.action === "created").length,
+            updated: records.filter((record) => record.action === "updated").length,
+            agents: records,
+        };
+    }
+}

package/dist/api/MswarmConfigStore.d.ts

@@ -0,0 +1,25 @@
+export interface StoredMswarmConfigState {
+    baseUrl?: string;
+    encryptedApiKey?: string;
+    timeoutMs?: number;
+    agentSlugPrefix?: string;
+}
+export interface MswarmConfigFileState extends Record<string, unknown> {
+    mswarm?: StoredMswarmConfigState;
+}
+export interface MswarmConfigState {
+    baseUrl?: string;
+    apiKey?: string;
+    timeoutMs?: number;
+    agentSlugPrefix?: string;
+}
+export declare class MswarmConfigStore {
+    private readonly configFilePath;
+    constructor(configFilePath?: string);
+    configPath(): string;
+    readState(): Promise<MswarmConfigState>;
+    saveApiKey(apiKey: string): Promise<MswarmConfigState>;
+    private readConfigFile;
+    private writeConfigFile;
+}
+//# sourceMappingURL=MswarmConfigStore.d.ts.map

package/dist/api/MswarmConfigStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MswarmConfigStore.d.ts","sourceRoot":"","sources":["../../src/api/MswarmConfigStore.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAsB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACpE,MAAM,CAAC,EAAE,uBAAuB,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAAd,cAAc,GAAE,MAAyC;IAEtF,UAAU,IAAI,MAAM;IAId,SAAS,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAqBvC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAiB9C,cAAc;YAad,eAAe;CAI9B"}

package/dist/api/MswarmConfigStore.js

@@ -0,0 +1,63 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { CryptoHelper, PathHelper } from "@mcoda/shared";
+export class MswarmConfigStore {
+    constructor(configFilePath = PathHelper.getGlobalConfigPath()) {
+        this.configFilePath = configFilePath;
+    }
+    configPath() {
+        return this.configFilePath;
+    }
+    async readState() {
+        const fileState = await this.readConfigFile();
+        const stored = fileState.mswarm ?? {};
+        let apiKey;
+        if (stored.encryptedApiKey) {
+            try {
+                apiKey = await CryptoHelper.decryptSecret(stored.encryptedApiKey);
+            }
+            catch (error) {
+                throw new Error(`Stored mswarm API key at ${this.configPath()} could not be decrypted: ${error.message ?? String(error)}`);
+            }
+        }
+        return {
+            baseUrl: stored.baseUrl,
+            apiKey,
+            timeoutMs: stored.timeoutMs,
+            agentSlugPrefix: stored.agentSlugPrefix,
+        };
+    }
+    async saveApiKey(apiKey) {
+        const trimmed = apiKey.trim();
+        if (!trimmed) {
+            throw new Error("mswarm api key is required");
+        }
+        const fileState = await this.readConfigFile();
+        const encryptedApiKey = await CryptoHelper.encryptSecret(trimmed);
+        await this.writeConfigFile({
+            ...fileState,
+            mswarm: {
+                ...(fileState.mswarm ?? {}),
+                encryptedApiKey,
+            },
+        });
+        return this.readState();
+    }
+    async readConfigFile() {
+        try {
+            const raw = await fs.readFile(this.configPath(), "utf8");
+            const parsed = JSON.parse(raw);
+            if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+                return parsed;
+            }
+        }
+        catch {
+            return {};
+        }
+        return {};
+    }
+    async writeConfigFile(config) {
+        await PathHelper.ensureDir(path.dirname(this.configPath()));
+        await fs.writeFile(this.configPath(), JSON.stringify(config, null, 2), "utf8");
+    }
+}

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export * from "./api/AgentsApi.js";
+export * from "./api/MswarmApi.js";
+export * from "./api/MswarmConfigStore.js";
 export * from "./services/docs/DocsService.js";
 export * from "./services/openapi/OpenApiService.js";
 export * from "./services/jobs/JobService.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sCAAsC,CAAC;AACrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,+CAA+C,CAAC;AAC9D,cAAc,mCAAmC,CAAC;AAClD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,0CAA0C,CAAC;AACzD,cAAc,yCAAyC,CAAC;AACxD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wCAAwC,CAAC;AACvD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wCAAwC,CAAC;AACvD,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sCAAsC,CAAC;AACrD,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,uCAAuC,CAAC;AACtD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,qCAAqC,CAAC;AACpD,cAAc,0CAA0C,CAAC;AACzD,cAAc,qCAAqC,CAAC;AACpD,cAAc,yCAAyC,CAAC;AACxD,cAAc,yCAAyC,CAAC;AACxD,cAAc,sCAAsC,CAAC;AACrD,cAAc,iCAAiC,CAAC;AAChD,cAAc,0CAA0C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sCAAsC,CAAC;AACrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,+CAA+C,CAAC;AAC9D,cAAc,mCAAmC,CAAC;AAClD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,0CAA0C,CAAC;AACzD,cAAc,yCAAyC,CAAC;AACxD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wCAAwC,CAAC;AACvD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wCAAwC,CAAC;AACvD,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sCAAsC,CAAC;AACrD,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,uCAAuC,CAAC;AACtD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,qCAAqC,CAAC;AACpD,cAAc,0CAA0C,CAAC;AACzD,cAAc,qCAAqC,CAAC;AACpD,cAAc,yCAAyC,CAAC;AACxD,cAAc,yCAAyC,CAAC;AACxD,cAAc,sCAAsC,CAAC;AACrD,cAAc,iCAAiC,CAAC;AAChD,cAAc,0CAA0C,CAAC"}

package/dist/index.js

@@ -1,4 +1,6 @@
 export * from "./api/AgentsApi.js";
+export * from "./api/MswarmApi.js";
+export * from "./api/MswarmConfigStore.js";
 export * from "./services/docs/DocsService.js";
 export * from "./services/openapi/OpenApiService.js";
 export * from "./services/jobs/JobService.js";

package/dist/services/estimate/VelocityService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VelocityService.d.ts","sourceRoot":"","sources":["../../../src/services/estimate/VelocityService.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAkB,eAAe,EAAoB,MAAM,YAAY,CAAC;AAKvG,qBAAa,eAAe;IAExB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,cAAc,CAAC;IAJzB,OAAO;WAOM,MAAM,CAAC,SAAS,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAOvE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;mBAIP,wBAAwB;IAiB7C,OAAO,CAAC,aAAa;YAuCP,eAAe;IAgC7B,OAAO,CAAC,gBAAgB;YAuBV,iBAAiB;YA2BjB,yBAAyB;YAsHzB,+BAA+B;YAmD/B,mCAAmC;YAoEnC,mBAAmB;IAqBjC,OAAO,CAAC,qBAAqB;IAQvB,oBAAoB,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAmFtF"}
+{"version":3,"file":"VelocityService.d.ts","sourceRoot":"","sources":["../../../src/services/estimate/VelocityService.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAkB,eAAe,EAAoB,MAAM,YAAY,CAAC;AAKvG,qBAAa,eAAe;IAExB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,cAAc,CAAC;IAJzB,OAAO;WAOM,MAAM,CAAC,SAAS,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAOvE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;mBAIP,wBAAwB;IAiB7C,OAAO,CAAC,aAAa;YAuCP,eAAe;IAgC7B,OAAO,CAAC,gBAAgB;YAuBV,iBAAiB;YA2BjB,yBAAyB;YAsHzB,+BAA+B;YAmD/B,mCAAmC;YAoEnC,mBAAmB;IAqBjC,OAAO,CAAC,qBAAqB;IAQvB,oBAAoB,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAmFtF"}

package/dist/services/estimate/VelocityService.js

@@ -1,5 +1,4 @@
 import fs from "node:fs/promises";
-import path from "node:path";
 import { randomUUID } from "node:crypto";
 import { Connection } from "@mcoda/db";
 import { PathHelper, READY_TO_CODE_REVIEW } from "@mcoda/shared";
@@ -22,7 +21,7 @@ export class VelocityService {
         await this.connection.close();
     }
     static async readGlobalVelocityConfig() {
-        const configPath = path.join(PathHelper.getGlobalMcodaDir(), "config.json");
+        const configPath = PathHelper.getGlobalConfigPath();
         try {
             const raw = await fs.readFile(configPath, "utf8");
             const parsed = JSON.parse(raw);