@mcoda/mswarm 0.1.56 → 0.1.60

package/dist/vendor/codali/agents/AgentProtocol.d.ts

@@ -0,0 +1,287 @@
+export type AgentNeed = {
+    type: "docdex.search";
+    query: string;
+    limit?: number;
+} | {
+    type: "docdex.open";
+    path: string;
+    start_line?: number;
+    end_line?: number;
+    head?: number;
+    clamp?: boolean;
+} | {
+    type: "docdex.snippet";
+    doc_id: string;
+    window?: number;
+} | {
+    type: "docdex.symbols";
+    file: string;
+} | {
+    type: "docdex.ast";
+    file: string;
+    max_nodes?: number;
+} | {
+    type: "docdex.web";
+    query: string;
+    force_web?: boolean;
+} | {
+    type: "docdex.impact";
+    file: string;
+} | {
+    type: "docdex.impact_diagnostics";
+    file?: string;
+    limit?: number;
+    offset?: number;
+} | {
+    type: "docdex.tree";
+    path?: string;
+    max_depth?: number;
+    dirs_only?: boolean;
+    include_hidden?: boolean;
+} | {
+    type: "docdex.dag_export";
+    session_id?: string;
+    format?: "json" | "text" | "dot";
+    max_nodes?: number;
+} | {
+    type: "file.read";
+    path: string;
+} | {
+    type: "file.list";
+    root: string;
+    pattern?: string;
+} | {
+    type: "file.diff";
+    paths?: string[];
+} | {
+    type: "agent.delegate";
+    role?: "explorer" | "reviewer" | "worker" | "verifier" | "custom";
+    goal: string;
+    tools?: string[];
+    allowed_paths?: string[];
+    write_paths?: string[];
+    read_only?: boolean;
+    max_steps?: number;
+    max_tool_calls?: number;
+    timeout_ms?: number;
+};
+export type AgentRequest = {
+    version: "v1";
+    role: string;
+    request_id: string;
+    needs: AgentNeed[];
+    context?: {
+        summary?: string;
+    };
+};
+export type ParseAgentRequestOptions = {
+    defaultRequestId?: string;
+};
+export type CodaliResponseResult = {
+    type: "docdex.search";
+    query: string;
+    hits: unknown[];
+} | {
+    type: "docdex.open";
+    path: string;
+    content: string;
+} | {
+    type: "docdex.snippet";
+    doc_id: string;
+    content: string;
+} | {
+    type: "docdex.symbols";
+    file: string;
+    symbols: unknown;
+} | {
+    type: "docdex.ast";
+    file: string;
+    nodes: unknown;
+} | {
+    type: "docdex.web";
+    query: string;
+    results: unknown[];
+} | {
+    type: "docdex.impact";
+    file: string;
+    inbound: unknown[];
+    outbound: unknown[];
+} | {
+    type: "docdex.impact_diagnostics";
+    file?: string;
+    diagnostics: unknown;
+} | {
+    type: "docdex.tree";
+    tree: string;
+} | {
+    type: "docdex.dag_export";
+    session_id: string;
+    format?: "json" | "text" | "dot";
+    content: unknown;
+} | {
+    type: "file.read";
+    path: string;
+    content: string;
+} | {
+    type: "file.list";
+    root: string;
+    files: string[];
+} | {
+    type: "file.diff";
+    paths?: string[];
+    diff: string;
+} | {
+    type: "agent.delegate";
+    role: string;
+    goal: string;
+    results: unknown[];
+} | {
+    type: "patch.apply_failure";
+    error: string;
+    patches: string[];
+    rollback: {
+        attempted: boolean;
+        ok: boolean;
+        error?: string;
+    };
+} | {
+    type: "critic.result";
+    status: "PASS" | "FAIL";
+    reasons: string[];
+    suggested_fixes?: string[];
+    touched_files?: string[];
+    plan_targets?: string[];
+    guardrail?: {
+        disposition: "retryable" | "non_retryable";
+        reason_code: string;
+    };
+    high_confidence?: boolean;
+    verification?: {
+        schema_version: 1;
+        outcome: "verified_passed" | "verified_failed" | "unverified_with_reason";
+        reason_codes: string[];
+        policy: {
+            policy_name: string;
+            minimum_checks: number;
+            enforce_high_confidence: boolean;
+        };
+        checks: unknown[];
+        totals: {
+            configured: number;
+            runnable: number;
+            attempted: number;
+            passed: number;
+            failed: number;
+            unverified: number;
+        };
+        touched_files?: string[];
+        language_signals?: string[];
+    };
+};
+export type CodaliResponse = {
+    version: "v1";
+    request_id: string;
+    results: CodaliResponseResult[];
+    meta?: {
+        repo_root?: string;
+        warnings?: string[];
+    };
+};
+export type NormalizedNeed = {
+    tool: "docdex.search";
+    params: {
+        query: string;
+        limit?: number;
+    };
+} | {
+    tool: "docdex.open";
+    params: {
+        path: string;
+        start_line?: number;
+        end_line?: number;
+        head?: number;
+        clamp?: boolean;
+    };
+} | {
+    tool: "docdex.snippet";
+    params: {
+        doc_id: string;
+        window?: number;
+    };
+} | {
+    tool: "docdex.symbols";
+    params: {
+        file: string;
+    };
+} | {
+    tool: "docdex.ast";
+    params: {
+        file: string;
+        max_nodes?: number;
+    };
+} | {
+    tool: "docdex.web";
+    params: {
+        query: string;
+        force_web?: boolean;
+    };
+} | {
+    tool: "docdex.impact";
+    params: {
+        file: string;
+    };
+} | {
+    tool: "docdex.impact_diagnostics";
+    params: {
+        file?: string;
+        limit?: number;
+        offset?: number;
+    };
+} | {
+    tool: "docdex.tree";
+    params: {
+        path?: string;
+        max_depth?: number;
+        dirs_only?: boolean;
+        include_hidden?: boolean;
+    };
+} | {
+    tool: "docdex.dag_export";
+    params: {
+        session_id?: string;
+        format?: "json" | "text" | "dot";
+        max_nodes?: number;
+    };
+} | {
+    tool: "file.read";
+    params: {
+        path: string;
+    };
+} | {
+    tool: "file.list";
+    params: {
+        root: string;
+        pattern?: string;
+    };
+} | {
+    tool: "file.diff";
+    params: {
+        paths?: string[];
+    };
+} | {
+    tool: "agent.delegate";
+    params: {
+        role: "explorer" | "reviewer" | "worker" | "verifier" | "custom";
+        goal: string;
+        tools?: string[];
+        allowed_paths?: string[];
+        write_paths?: string[];
+        read_only?: boolean;
+        max_steps?: number;
+        max_tool_calls?: number;
+        timeout_ms?: number;
+    };
+};
+export declare const parseAgentRequest: (input: string, options?: ParseAgentRequestOptions) => AgentRequest;
+export declare const normalizeAgentRequest: (request: AgentRequest) => NormalizedNeed[];
+//# sourceMappingURL=AgentProtocol.d.ts.map

package/dist/vendor/codali/agents/AgentProtocol.d.ts.map

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

package/dist/vendor/codali/agents/AgentProtocol.js

@@ -0,0 +1,365 @@
+const parseQuotedValue = (value) => {
+    const trimmed = value.trim();
+    if ((trimmed.startsWith("\"") && trimmed.endsWith("\"")) ||
+        (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
+        return trimmed.slice(1, -1);
+    }
+    return trimmed;
+};
+const parseYamlKeyValue = (line) => {
+    const idx = line.indexOf(":");
+    if (idx === -1)
+        return null;
+    const key = line.slice(0, idx).trim();
+    const value = line.slice(idx + 1).trim();
+    if (!key)
+        return null;
+    return { key, value };
+};
+const parseOptionalNumber = (value) => {
+    if (!value)
+        return undefined;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+};
+const parseOptionalBoolean = (value) => {
+    if (value === undefined)
+        return undefined;
+    return value.trim().toLowerCase() === "true";
+};
+const parseOptionalStringList = (value) => {
+    if (!value)
+        return undefined;
+    const normalized = value.trim().replace(/^\[/, "").replace(/\]$/, "");
+    const parsed = normalized
+        .split(",")
+        .map((entry) => parseQuotedValue(entry.trim()))
+        .filter(Boolean);
+    return parsed.length ? parsed : undefined;
+};
+const coerceNeed = (need) => {
+    const type = need.type?.trim();
+    if (!type) {
+        throw new Error("Agent request need missing type");
+    }
+    if (type === "docdex.search") {
+        const query = need.query?.trim();
+        if (!query)
+            throw new Error("docdex.search requires query");
+        const limit = parseOptionalNumber(need.limit);
+        return { type, query, limit };
+    }
+    if (type === "docdex.open") {
+        const path = need.path?.trim();
+        if (!path)
+            throw new Error("docdex.open requires path");
+        const start_line = parseOptionalNumber(need.start_line);
+        const end_line = parseOptionalNumber(need.end_line);
+        const head = parseOptionalNumber(need.head);
+        const clamp = parseOptionalBoolean(need.clamp);
+        return { type, path, start_line, end_line, head, clamp };
+    }
+    if (type === "docdex.snippet") {
+        const doc_id = need.doc_id?.trim();
+        if (!doc_id)
+            throw new Error("docdex.snippet requires doc_id");
+        const window = parseOptionalNumber(need.window);
+        return { type, doc_id, window };
+    }
+    if (type === "docdex.symbols") {
+        const file = need.file?.trim();
+        if (!file)
+            throw new Error("docdex.symbols requires file");
+        return { type, file };
+    }
+    if (type === "docdex.ast") {
+        const file = need.file?.trim();
+        if (!file)
+            throw new Error("docdex.ast requires file");
+        const max_nodes = parseOptionalNumber(need.max_nodes);
+        return { type, file, max_nodes };
+    }
+    if (type === "docdex.web") {
+        const query = need.query?.trim();
+        if (!query)
+            throw new Error("docdex.web requires query");
+        const force_web = parseOptionalBoolean(need.force_web);
+        return { type, query, force_web };
+    }
+    if (type === "docdex.impact") {
+        const file = need.file?.trim();
+        if (!file)
+            throw new Error("docdex.impact requires file");
+        return { type, file };
+    }
+    if (type === "docdex.impact_diagnostics") {
+        const file = need.file?.trim();
+        const limit = parseOptionalNumber(need.limit);
+        const offset = parseOptionalNumber(need.offset);
+        return { type, file: file || undefined, limit, offset };
+    }
+    if (type === "docdex.tree") {
+        const path = need.path?.trim();
+        const max_depth = parseOptionalNumber(need.max_depth);
+        const dirs_only = parseOptionalBoolean(need.dirs_only);
+        const include_hidden = parseOptionalBoolean(need.include_hidden);
+        return { type, path: path || undefined, max_depth, dirs_only, include_hidden };
+    }
+    if (type === "docdex.dag_export") {
+        const session_id = need.session_id?.trim();
+        const formatValue = need.format?.trim();
+        const format = formatValue && ["json", "text", "dot"].includes(formatValue)
+            ? formatValue
+            : undefined;
+        if (formatValue && !format) {
+            throw new Error("docdex.dag_export format must be json, text, or dot");
+        }
+        const max_nodes = parseOptionalNumber(need.max_nodes);
+        return { type, session_id: session_id || undefined, format, max_nodes };
+    }
+    if (type === "file.read") {
+        const path = need.path?.trim();
+        if (!path)
+            throw new Error("file.read requires path");
+        return { type, path };
+    }
+    if (type === "file.list") {
+        const root = need.root?.trim();
+        if (!root)
+            throw new Error("file.list requires root");
+        const pattern = need.pattern?.trim();
+        return { type, root, pattern: pattern || undefined };
+    }
+    if (type === "file.diff") {
+        const rawPaths = need.paths?.trim();
+        const paths = rawPaths
+            ? rawPaths
+                .split(",")
+                .map((entry) => entry.trim())
+                .filter(Boolean)
+            : undefined;
+        return { type, paths };
+    }
+    if (type === "agent.delegate") {
+        const goal = need.goal?.trim();
+        if (!goal)
+            throw new Error("agent.delegate requires goal");
+        const roleValue = need.role?.trim();
+        const role = roleValue && ["explorer", "reviewer", "worker", "verifier", "custom"].includes(roleValue)
+            ? roleValue
+            : undefined;
+        if (roleValue && !role) {
+            throw new Error("agent.delegate role must be explorer, reviewer, worker, verifier, or custom");
+        }
+        return {
+            type,
+            role,
+            goal,
+            tools: parseOptionalStringList(need.tools),
+            allowed_paths: parseOptionalStringList(need.allowed_paths),
+            write_paths: parseOptionalStringList(need.write_paths),
+            read_only: parseOptionalBoolean(need.read_only),
+            max_steps: parseOptionalNumber(need.max_steps),
+            max_tool_calls: parseOptionalNumber(need.max_tool_calls),
+            timeout_ms: parseOptionalNumber(need.timeout_ms),
+        };
+    }
+    throw new Error(`Unsupported need type: ${type}`);
+};
+export const parseAgentRequest = (input, options = {}) => {
+    const trimmed = input.trim();
+    if (!trimmed) {
+        throw new Error("Agent request is empty");
+    }
+    if (trimmed.startsWith("{")) {
+        const parsed = JSON.parse(trimmed);
+        if (!parsed.request_id && !options.defaultRequestId)
+            throw new Error("Agent request missing request_id");
+        if (!parsed.needs || !Array.isArray(parsed.needs) || parsed.needs.length === 0) {
+            throw new Error("Agent request needs must be a non-empty array");
+        }
+        return {
+            version: "v1",
+            role: parsed.role ?? "unknown",
+            request_id: parsed.request_id ?? options.defaultRequestId,
+            needs: parsed.needs,
+            context: parsed.context,
+        };
+    }
+    const lines = trimmed.split(/\r?\n/);
+    const header = lines.shift()?.trim();
+    if (!header || !/^AGENT_REQUEST\s+v1$/i.test(header)) {
+        throw new Error("Agent request missing AGENT_REQUEST v1 header");
+    }
+    let role = "unknown";
+    let request_id = "";
+    const needs = [];
+    let contextSummary;
+    let mode = "none";
+    let currentNeed = null;
+    for (const rawLine of lines) {
+        const line = rawLine.trimEnd();
+        if (!line.trim())
+            continue;
+        const trimmedLine = line.trim();
+        const isTopLevel = !/^\s/.test(rawLine);
+        if (trimmedLine.startsWith("needs:")) {
+            mode = "needs";
+            continue;
+        }
+        if (trimmedLine.startsWith("context:")) {
+            if (currentNeed) {
+                needs.push(coerceNeed(currentNeed));
+                currentNeed = null;
+            }
+            mode = "context";
+            continue;
+        }
+        if (isTopLevel) {
+            const kv = parseYamlKeyValue(trimmedLine);
+            if (kv && (kv.key === "role" || kv.key === "request_id")) {
+                if (currentNeed) {
+                    needs.push(coerceNeed(currentNeed));
+                    currentNeed = null;
+                }
+                if (kv.key === "role")
+                    role = parseQuotedValue(kv.value);
+                if (kv.key === "request_id")
+                    request_id = parseQuotedValue(kv.value);
+                continue;
+            }
+        }
+        if (mode === "needs") {
+            if (trimmedLine.startsWith("-")) {
+                if (currentNeed) {
+                    needs.push(coerceNeed(currentNeed));
+                }
+                currentNeed = {};
+                const rest = line.replace(/^\s*-\s*/, "");
+                if (rest) {
+                    const kv = parseYamlKeyValue(rest);
+                    if (kv) {
+                        currentNeed[kv.key] = parseQuotedValue(kv.value);
+                    }
+                }
+                continue;
+            }
+            if (currentNeed) {
+                const kv = parseYamlKeyValue(trimmedLine);
+                if (kv) {
+                    currentNeed[kv.key] = parseQuotedValue(kv.value);
+                }
+                continue;
+            }
+        }
+        if (mode === "context") {
+            const kv = parseYamlKeyValue(trimmedLine);
+            if (kv && kv.key === "summary") {
+                contextSummary = parseQuotedValue(kv.value);
+            }
+            continue;
+        }
+        const kv = parseYamlKeyValue(trimmedLine);
+        if (!kv)
+            continue;
+        if (kv.key === "role")
+            role = parseQuotedValue(kv.value);
+        if (kv.key === "request_id")
+            request_id = parseQuotedValue(kv.value);
+    }
+    if (currentNeed) {
+        needs.push(coerceNeed(currentNeed));
+    }
+    if (!request_id) {
+        if (!options.defaultRequestId)
+            throw new Error("Agent request missing request_id");
+        request_id = options.defaultRequestId;
+    }
+    if (needs.length === 0)
+        throw new Error("Agent request needs must be a non-empty array");
+    return {
+        version: "v1",
+        role,
+        request_id,
+        needs,
+        context: contextSummary ? { summary: contextSummary } : undefined,
+    };
+};
+export const normalizeAgentRequest = (request) => request.needs.map((need) => {
+    if (need.type === "docdex.search") {
+        return { tool: "docdex.search", params: { query: need.query, limit: need.limit } };
+    }
+    if (need.type === "docdex.open") {
+        return {
+            tool: "docdex.open",
+            params: {
+                path: need.path,
+                start_line: need.start_line,
+                end_line: need.end_line,
+                head: need.head,
+                clamp: need.clamp,
+            },
+        };
+    }
+    if (need.type === "docdex.snippet") {
+        return { tool: "docdex.snippet", params: { doc_id: need.doc_id, window: need.window } };
+    }
+    if (need.type === "docdex.symbols") {
+        return { tool: "docdex.symbols", params: { file: need.file } };
+    }
+    if (need.type === "docdex.ast") {
+        return { tool: "docdex.ast", params: { file: need.file, max_nodes: need.max_nodes } };
+    }
+    if (need.type === "docdex.web") {
+        return { tool: "docdex.web", params: { query: need.query, force_web: need.force_web } };
+    }
+    if (need.type === "docdex.impact") {
+        return { tool: "docdex.impact", params: { file: need.file } };
+    }
+    if (need.type === "docdex.impact_diagnostics") {
+        return {
+            tool: "docdex.impact_diagnostics",
+            params: { file: need.file, limit: need.limit, offset: need.offset },
+        };
+    }
+    if (need.type === "docdex.tree") {
+        return {
+            tool: "docdex.tree",
+            params: {
+                path: need.path,
+                max_depth: need.max_depth,
+                dirs_only: need.dirs_only,
+                include_hidden: need.include_hidden,
+            },
+        };
+    }
+    if (need.type === "docdex.dag_export") {
+        return {
+            tool: "docdex.dag_export",
+            params: { session_id: need.session_id, format: need.format, max_nodes: need.max_nodes },
+        };
+    }
+    if (need.type === "file.list") {
+        return { tool: "file.list", params: { root: need.root, pattern: need.pattern } };
+    }
+    if (need.type === "file.diff") {
+        return { tool: "file.diff", params: { paths: need.paths } };
+    }
+    if (need.type === "agent.delegate") {
+        return {
+            tool: "agent.delegate",
+            params: {
+                role: need.role ?? "explorer",
+                goal: need.goal,
+                tools: need.tools,
+                allowed_paths: need.allowed_paths,
+                write_paths: need.write_paths,
+                read_only: need.read_only,
+                max_steps: need.max_steps,
+                max_tool_calls: need.max_tool_calls,
+                timeout_ms: need.timeout_ms,
+            },
+        };
+    }
+    return { tool: "file.read", params: { path: need.path } };
+});

package/dist/vendor/codali/agents/AgentResolver.d.ts

@@ -0,0 +1,23 @@
+import { GlobalRepository } from "@mcoda/db";
+import { type Agent } from "@mcoda/shared";
+export interface AgentResolutionOverrides {
+    provider?: string;
+    model?: string;
+    baseUrl?: string;
+    apiKey?: string;
+}
+export interface ResolvedAgentConfig {
+    agent: Agent;
+    provider: string;
+    model: string;
+    baseUrl?: string;
+    apiKey?: string;
+    requiresApiKey: boolean;
+}
+export declare const resolveProviderFromAdapter: (adapter: string, explicitProvider?: string) => {
+    provider: string;
+    requiresApiKey: boolean;
+};
+export declare const resolveAgentConfigFromRecord: (agent: Agent, repo: GlobalRepository, overrides?: AgentResolutionOverrides) => Promise<ResolvedAgentConfig>;
+export declare const resolveAgentConfig: (agentRef: string, overrides?: AgentResolutionOverrides) => Promise<ResolvedAgentConfig>;
+//# sourceMappingURL=AgentResolver.d.ts.map

package/dist/vendor/codali/agents/AgentResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentResolver.d.ts","sourceRoot":"","sources":["../../src/agents/AgentResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAgB,KAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AAEzD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,OAAO,CAAC;CACzB;AAoBD,eAAO,MAAM,0BAA0B,GACrC,SAAS,MAAM,EACf,mBAAmB,MAAM,KACxB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,OAAO,CAAA;CAwB7C,CAAC;AAEF,eAAO,MAAM,4BAA4B,GACvC,OAAO,KAAK,EACZ,MAAM,gBAAgB,EACtB,YAAW,wBAA6B,KACvC,OAAO,CAAC,mBAAmB,CAsC7B,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC7B,UAAU,MAAM,EAChB,YAAW,wBAA6B,KACvC,OAAO,CAAC,mBAAmB,CAY7B,CAAC"}