@mcoda/mswarm 0.1.60 → 0.1.61

package/dist/vendor/codali/docdex/DocdexClient.js

@@ -1,6 +1,16 @@
 import { randomUUID } from "node:crypto";
 import path from "node:path";
 import { pathToFileURL } from "node:url";
+export class DocdexRuntimeError extends Error {
+    constructor(code, message, options = {}) {
+        super(message);
+        this.name = code;
+        this.code = code;
+        this.status = options.status;
+        this.retryable = options.retryable ?? code === "docdex_unavailable";
+        this.details = options.details;
+    }
+}
 const CAPABILITY_KEYS = [
     "score_breakdown",
     "rerank",
@@ -8,6 +18,93 @@ const CAPABILITY_KEYS = [
     "retrieval_explanation",
     "batch_search",
 ];
+const DOCDEX_RUNTIME_ERROR_CODES = new Set([
+    "docdex_context_missing",
+    "docdex_api_key_missing",
+    "docdex_operation_not_allowed",
+    "docdex_auth_failed",
+    "docdex_repo_access_denied",
+    "docdex_unavailable",
+]);
+const DOCDEX_RUNTIME_OPERATIONS = new Set([
+    "health",
+    "initialize",
+    "search",
+    "snippet",
+    "open",
+    "symbols",
+    "ast",
+    "impact_graph",
+    "impact_diagnostics",
+    "dag_export",
+    "tree",
+    "memory_save",
+    "memory_recall",
+    "profile_read",
+    "profile_write",
+    "web_research",
+    "chat_context",
+    "rerank",
+    "batch_search",
+    "capabilities",
+    "stats",
+    "files",
+    "repo_inspect",
+    "index_rebuild",
+    "index_ingest",
+    "delegate",
+    "hooks_validate",
+]);
+const MCP_OPERATION_BY_METHOD = {
+    docdex_symbols: "symbols",
+    docdex_ast: "ast",
+    docdex_stats: "stats",
+    docdex_files: "files",
+    docdex_repo_inspect: "repo_inspect",
+    docdex_memory_save: "memory_save",
+    docdex_memory_recall: "memory_recall",
+    docdex_tree: "tree",
+    docdex_open: "open",
+    docdex_get_profile: "profile_read",
+    docdex_save_preference: "profile_write",
+    docdex_web_research: "web_research",
+    docdex_rerank: "rerank",
+    docdex_batch_search: "batch_search",
+    docdex_capabilities: "capabilities",
+};
+export const isDocdexRuntimeErrorCode = (value) => {
+    return typeof value === "string" && DOCDEX_RUNTIME_ERROR_CODES.has(value);
+};
+export const normalizeDocdexRuntimeOperation = (value) => {
+    const normalized = value.trim().replace(/[.-]/g, "_").toLowerCase();
+    const aliases = {
+        impact: "impact_graph",
+        diagnostics: "impact_diagnostics",
+        impact_diagnostics: "impact_diagnostics",
+        web: "web_research",
+        web_search: "web_research",
+        chat: "chat_context",
+        chat_completions: "chat_context",
+        context_chat: "chat_context",
+        open_file: "open",
+        snippet_fetch: "snippet",
+        profile: "profile_read",
+        get_profile: "profile_read",
+        save_preference: "profile_write",
+        memory: "memory_recall",
+        index: "index_rebuild",
+        hooks: "hooks_validate",
+    };
+    const aliased = aliases[normalized];
+    if (aliased)
+        return aliased;
+    return DOCDEX_RUNTIME_OPERATIONS.has(normalized)
+        ? normalized
+        : undefined;
+};
+const escapeRegExp = (value) => {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+};
 export class DocdexClient {
     constructor(options) {
         this.options = options;
@@ -34,14 +131,80 @@ export class DocdexClient {
     clearCapabilityCache() {
         this.capabilitySnapshot = undefined;
     }
+    runtimeAllowedOperations() {
+        if (!this.options.allowedOperations?.length)
+            return undefined;
+        const operations = this.options.allowedOperations
+            .map((entry) => normalizeDocdexRuntimeOperation(entry))
+            .filter((entry) => Boolean(entry));
+        return operations.length ? new Set(operations) : new Set();
+    }
+    runtimeCapability(operation) {
+        if (!this.options.capabilities)
+            return undefined;
+        for (const [key, value] of Object.entries(this.options.capabilities)) {
+            const normalized = normalizeDocdexRuntimeOperation(key);
+            if (normalized === operation && typeof value === "boolean") {
+                return value;
+            }
+        }
+        return undefined;
+    }
+    redactSensitiveText(text) {
+        let output = text;
+        for (const secret of [this.options.apiKey, this.options.authToken]) {
+            if (typeof secret === "string" && secret.length >= 4) {
+                output = output.replace(new RegExp(escapeRegExp(secret), "g"), "[redacted]");
+            }
+        }
+        output = output.replace(/("(?:x-api-key|authorization|api[_-]?key|token|secret)"\s*:\s*")[^"]+(")/gi, "$1[redacted]$2");
+        output = output.replace(/((?:x-api-key|authorization|api[_-]?key|token|secret)\s*[:=]\s*)(?:Bearer\s+)?[^\s,;}]+/gi, "$1[redacted]");
+        return output;
+    }
+    runtimeError(code, message, options = {}) {
+        return new DocdexRuntimeError(code, this.redactSensitiveText(message), options);
+    }
+    assertRuntimeContext(operation) {
+        const credentialSource = this.options.credentialSource;
+        const requiresAttachedKey = credentialSource === "attached_mswarm_api_key";
+        if (requiresAttachedKey && (!this.options.apiKey || this.options.apiKey.trim().length === 0)) {
+            throw this.runtimeError("docdex_api_key_missing", "Docdex attached mswarm API key is required but was not provided.", { retryable: false, details: { operation, credential_source: credentialSource } });
+        }
+        if (this.options.required && this.resolveBaseUrl().length === 0) {
+            throw this.runtimeError("docdex_context_missing", "Docdex base_url is required for this job.", {
+                retryable: false,
+                details: { operation },
+            });
+        }
+        if (this.options.required && requiresAttachedKey && !this.repoId) {
+            throw this.runtimeError("docdex_context_missing", "Docdex repo_id is required for this job.", {
+                retryable: false,
+                details: { operation },
+            });
+        }
+    }
+    assertOperationAllowed(operation) {
+        this.assertRuntimeContext(operation);
+        const allowedOperations = this.runtimeAllowedOperations();
+        if (allowedOperations && !allowedOperations.has(operation)) {
+            throw this.runtimeError("docdex_operation_not_allowed", `Docdex operation is not allowed by this job: ${operation}`, { retryable: false, details: { operation } });
+        }
+        if (this.runtimeCapability(operation) === false) {
+            throw this.runtimeError("docdex_operation_not_allowed", `Docdex operation is disabled by this job capability map: ${operation}`, { retryable: false, details: { operation } });
+        }
+    }
     resolveBaseUrl() {
         const base = this.options.baseUrl.trim();
         return base.endsWith("/") ? base.slice(0, -1) : base;
     }
     buildHeaders(dagSessionId) {
         const headers = { "content-type": "application/json" };
-        if (this.options.authToken)
+        if (this.options.apiKey) {
+            headers["x-api-key"] = this.options.apiKey;
+        }
+        else if (this.options.authToken) {
             headers.authorization = `Bearer ${this.options.authToken}`;
+        }
         if (this.repoId)
             headers["x-docdex-repo-id"] = this.repoId;
         if (this.options.repoRoot)
@@ -54,17 +217,37 @@ export class DocdexClient {
     async ensureHealth() {
         if (this.healthChecked)
             return;
-        const ok = await this.healthCheck();
+        let ok = false;
+        try {
+            ok = await this.healthCheck();
+        }
+        catch (error) {
+            if (error instanceof DocdexRuntimeError)
+                throw error;
+            throw this.runtimeError("docdex_unavailable", `Docdex health check failed: ${error instanceof Error ? error.message : String(error)}`, { retryable: true });
+        }
         if (!ok) {
-            throw new Error("Docdex health check failed");
+            throw this.runtimeError("docdex_unavailable", "Docdex health check failed", {
+                retryable: true,
+            });
         }
     }
     async healthCheck() {
-        const response = await fetch(`${this.resolveBaseUrl()}/healthz`);
+        let response;
+        try {
+            response = await fetch(`${this.resolveBaseUrl()}/healthz`);
+        }
+        catch (error) {
+            throw this.runtimeError("docdex_unavailable", `Docdex health check failed: ${error instanceof Error ? error.message : String(error)}`, { retryable: true });
+        }
         this.healthChecked = response.ok;
         return response.ok;
     }
     async initialize(rootUri) {
+        this.assertOperationAllowed("initialize");
+        return this.initializeRepo(rootUri);
+    }
+    async initializeRepo(rootUri) {
         await this.ensureHealth();
         const response = await fetch(`${this.resolveBaseUrl()}/v1/initialize`, {
             method: "POST",
@@ -72,8 +255,7 @@ export class DocdexClient {
             body: JSON.stringify({ rootUri }),
         });
         if (!response.ok) {
-            const body = await response.text();
-            throw new Error(`Docdex initialize failed (${response.status}): ${body}`);
+            await this.throwResponseError(response, "initialize");
         }
         const payload = (await response.json());
         const repoId = (payload.repo_id ?? payload.repoId ?? payload.repo);
@@ -87,7 +269,7 @@ export class DocdexClient {
             return;
         this.repoInitializeAttempted = true;
         try {
-            await this.initialize(pathToFileURL(path.resolve(this.options.repoRoot)).toString());
+            await this.initializeRepo(pathToFileURL(path.resolve(this.options.repoRoot)).toString());
         }
         catch {
             // Keep endpoint-specific calls responsible for reporting the final failure.
@@ -100,7 +282,47 @@ export class DocdexClient {
         if (this.options.repoRoot)
             params.set("repo_root", path.resolve(this.options.repoRoot));
     }
+    extractErrorCode(body) {
+        const parsed = this.tryParseJson(body);
+        if (!parsed || typeof parsed !== "object")
+            return undefined;
+        const record = parsed;
+        const error = record.error && typeof record.error === "object"
+            ? record.error
+            : undefined;
+        const code = error?.code ?? record.code;
+        return typeof code === "string" ? code : undefined;
+    }
+    mapResponseErrorCode(status, body) {
+        const extracted = this.extractErrorCode(body);
+        if (isDocdexRuntimeErrorCode(extracted))
+            return extracted;
+        const normalized = `${extracted ?? ""} ${body}`.toLowerCase();
+        if (/introspection_unavailable|unavailable|timeout|timed out|econnrefused|enotfound/.test(normalized)) {
+            return "docdex_unavailable";
+        }
+        if (/repo_access_denied|unknown_repo|repo.*denied|denied.*repo/.test(normalized)) {
+            return "docdex_repo_access_denied";
+        }
+        if (/scope_denied|operation_not_allowed|encrypted_operation_disabled|not allowed|forbidden_operation/.test(normalized)) {
+            return "docdex_operation_not_allowed";
+        }
+        if (status === 401 || status === 403 || /invalid_credentials|missing_credentials|ambiguous_credentials/.test(normalized)) {
+            return "docdex_auth_failed";
+        }
+        return "docdex_unavailable";
+    }
+    async throwResponseError(response, operation) {
+        const body = await response.text();
+        const code = this.mapResponseErrorCode(response.status, body);
+        throw this.runtimeError(code, `Docdex ${operation} failed (${response.status}): ${body}`, {
+            status: response.status,
+            retryable: code === "docdex_unavailable" && response.status >= 500,
+            details: { operation },
+        });
+    }
     async search(query, options = {}) {
+        this.assertOperationAllowed("search");
         await this.ensureHealth();
         await this.ensureRepoInitialized();
         const params = new URLSearchParams({ q: query });
@@ -114,12 +336,12 @@ export class DocdexClient {
             headers: this.buildHeaders(dagSessionId),
         });
         if (!response.ok) {
-            const body = await response.text();
-            throw new Error(`Docdex search failed (${response.status}): ${body}`);
+            await this.throwResponseError(response, "search");
         }
         return response.json();
     }
     async openSnippet(docId, options = {}) {
+        this.assertOperationAllowed("snippet");
         await this.ensureHealth();
         await this.ensureRepoInitialized();
         const params = new URLSearchParams();
@@ -132,8 +354,7 @@ export class DocdexClient {
             headers: this.buildHeaders(),
         });
         if (!response.ok) {
-            const body = await response.text();
-            throw new Error(`Docdex snippet failed (${response.status}): ${body}`);
+            await this.throwResponseError(response, "snippet");
         }
         const contentType = response.headers.get("content-type") ?? "";
         if (contentType.includes("application/json")) {
@@ -142,6 +363,7 @@ export class DocdexClient {
         return response.text();
     }
     async impactGraph(file, options = {}) {
+        this.assertOperationAllowed("impact_graph");
         await this.ensureHealth();
         await this.ensureRepoInitialized();
         const params = new URLSearchParams({ file });
@@ -156,12 +378,12 @@ export class DocdexClient {
             headers: this.buildHeaders(),
         });
         if (!response.ok) {
-            const body = await response.text();
-            throw new Error(`Docdex impact graph failed (${response.status}): ${body}`);
+            await this.throwResponseError(response, "impact graph");
         }
         return response.json();
     }
     async impactDiagnostics(options = {}) {
+        this.assertOperationAllowed("impact_diagnostics");
         await this.ensureHealth();
         await this.ensureRepoInitialized();
         const params = new URLSearchParams();
@@ -176,12 +398,12 @@ export class DocdexClient {
             headers: this.buildHeaders(),
         });
         if (!response.ok) {
-            const body = await response.text();
-            throw new Error(`Docdex impact diagnostics failed (${response.status}): ${body}`);
+            await this.throwResponseError(response, "impact diagnostics");
         }
         return response.json();
     }
     async indexRebuild(libsSources) {
+        this.assertOperationAllowed("index_rebuild");
         await this.ensureHealth();
         const response = await fetch(`${this.resolveBaseUrl()}/v1/index/rebuild`, {
             method: "POST",
@@ -189,12 +411,12 @@ export class DocdexClient {
             body: JSON.stringify(libsSources ? { libs_sources: libsSources } : {}),
         });
         if (!response.ok) {
-            const body = await response.text();
-            throw new Error(`Docdex index rebuild failed (${response.status}): ${body}`);
+            await this.throwResponseError(response, "index rebuild");
         }
         return response.json();
     }
     async indexIngest(file) {
+        this.assertOperationAllowed("index_ingest");
         await this.ensureHealth();
         const response = await fetch(`${this.resolveBaseUrl()}/v1/index/ingest`, {
             method: "POST",
@@ -202,12 +424,12 @@ export class DocdexClient {
             body: JSON.stringify({ file }),
         });
         if (!response.ok) {
-            const body = await response.text();
-            throw new Error(`Docdex index ingest failed (${response.status}): ${body}`);
+            await this.throwResponseError(response, "index ingest");
         }
         return response.json();
     }
     async hooksValidate(files) {
+        this.assertOperationAllowed("hooks_validate");
         await this.ensureHealth();
         const response = await fetch(`${this.resolveBaseUrl()}/v1/hooks/validate`, {
             method: "POST",
@@ -215,12 +437,12 @@ export class DocdexClient {
             body: JSON.stringify({ files }),
         });
         if (!response.ok) {
-            const body = await response.text();
-            throw new Error(`Docdex hooks validate failed (${response.status}): ${body}`);
+            await this.throwResponseError(response, "hooks validate");
         }
         return response.json();
     }
     async delegate(payload) {
+        this.assertOperationAllowed("delegate");
         await this.ensureHealth();
         const response = await fetch(`${this.resolveBaseUrl()}/v1/delegate`, {
             method: "POST",
@@ -228,12 +450,38 @@ export class DocdexClient {
             body: JSON.stringify(payload),
         });
         if (!response.ok) {
-            const body = await response.text();
-            throw new Error(`Docdex delegate failed (${response.status}): ${body}`);
+            await this.throwResponseError(response, "delegate");
+        }
+        return response.json();
+    }
+    async chatContext(messages, options = {}) {
+        this.assertOperationAllowed("chat_context");
+        await this.ensureHealth();
+        await this.ensureRepoInitialized();
+        const body = {
+            messages,
+            stream: false,
+        };
+        if (options.model)
+            body.model = options.model;
+        if (options.maxTokens !== undefined)
+            body.max_tokens = options.maxTokens;
+        if (options.temperature !== undefined)
+            body.temperature = options.temperature;
+        if (options.docdex)
+            body.docdex = options.docdex;
+        const response = await fetch(`${this.resolveBaseUrl()}/v1/chat/completions`, {
+            method: "POST",
+            headers: this.buildHeaders(this.dagSessionId),
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            await this.throwResponseError(response, "chat context");
         }
         return response.json();
     }
     async dagExport(sessionId, options = {}) {
+        this.assertOperationAllowed("dag_export");
         await this.ensureHealth();
         await this.ensureRepoInitialized();
         const params = new URLSearchParams({ session_id: sessionId });
@@ -247,7 +495,12 @@ export class DocdexClient {
         });
         const body = await response.text();
         if (!response.ok) {
-            throw new Error(`Docdex dag export failed (${response.status}): ${body}`);
+            const code = this.mapResponseErrorCode(response.status, body);
+            throw this.runtimeError(code, `Docdex dag export failed (${response.status}): ${body}`, {
+                status: response.status,
+                retryable: code === "docdex_unavailable" && response.status >= 500,
+                details: { operation: "dag_export" },
+            });
         }
         const contentType = response.headers.get("content-type") ?? "";
         if (contentType.includes("application/json")) {
@@ -261,6 +514,10 @@ export class DocdexClient {
         return body;
     }
     async callMcp(method, params) {
+        const operation = MCP_OPERATION_BY_METHOD[method];
+        if (operation) {
+            this.assertOperationAllowed(operation);
+        }
         await this.ensureHealth();
         const payload = {
             jsonrpc: "2.0",
@@ -274,12 +531,16 @@ export class DocdexClient {
             body: JSON.stringify(payload),
         });
         if (!response.ok) {
-            const body = await response.text();
-            throw new Error(`Docdex MCP failed (${response.status}): ${body}`);
+            await this.throwResponseError(response, "MCP");
         }
         const raw = (await response.json());
         if (raw.error) {
-            throw new Error(raw.error.message ?? "Docdex MCP error");
+            const body = JSON.stringify(raw.error);
+            const code = this.mapResponseErrorCode(500, body);
+            throw this.runtimeError(code, raw.error.message ?? "Docdex MCP error", {
+                retryable: code === "docdex_unavailable",
+                details: { method },
+            });
         }
         return this.normalizeMcpResult(raw.result);
     }
@@ -451,6 +712,7 @@ export class DocdexClient {
         })).catch(() => this.webResearchHttp(query, options));
     }
     async webResearchHttp(query, options = {}) {
+        this.assertOperationAllowed("web_research");
         await this.ensureHealth();
         await this.ensureRepoInitialized();
         const params = new URLSearchParams({ q: query });
@@ -469,8 +731,7 @@ export class DocdexClient {
             headers: this.buildHeaders(this.dagSessionId),
         });
         if (!response.ok) {
-            const body = await response.text();
-            throw new Error(`Docdex web research failed (${response.status}): ${body}`);
+            await this.throwResponseError(response, "web research");
         }
         return response.json();
     }

package/dist/vendor/codali/runtime/CodaliRuntime.d.ts

@@ -14,10 +14,16 @@ export interface CodaliRuntimeProviderInput {
     timeoutMs?: number;
 }
 export interface CodaliRuntimeDocdexInput {
+    enabled?: boolean;
     baseUrl?: string;
     repoRoot?: string;
     repoId?: string;
     dagSessionId?: string;
+    apiKey?: string;
+    credentialSource?: "attached_mswarm_api_key" | string;
+    required?: boolean;
+    allowedOperations?: string[];
+    capabilities?: Record<string, boolean | undefined>;
     initialize?: boolean;
     allowWeb?: boolean;
     allowMemoryWrite?: boolean;

package/dist/vendor/codali/runtime/CodaliRuntime.d.ts.map

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

package/dist/vendor/codali/runtime/CodaliRuntime.js

@@ -4,7 +4,7 @@ import { createProvider } from "../providers/ProviderRegistry.js";
 import { OpenAiCompatibleProvider } from "../providers/OpenAiCompatibleProvider.js";
 import { OllamaRemoteProvider } from "../providers/OllamaRemoteProvider.js";
 import { CodexCliProvider } from "../providers/CodexCliProvider.js";
-import { DocdexClient } from "../docdex/DocdexClient.js";
+import { DocdexClient, normalizeDocdexRuntimeOperation, } from "../docdex/DocdexClient.js";
 import { createDiffTool } from "../tools/diff/DiffTool.js";
 import { createDocdexTools } from "../tools/docdex/DocdexTools.js";
 import { createFileTools } from "../tools/filesystem/FileTools.js";
@@ -29,6 +29,35 @@ const WEB_TOOL_NAMES = new Set(["docdex_web_research"]);
 const MEMORY_WRITE_TOOL_NAMES = new Set(["docdex_memory_save"]);
 const PROFILE_WRITE_TOOL_NAMES = new Set(["docdex_save_preference"]);
 const INDEX_REBUILD_TOOL_NAMES = new Set(["docdex_index_rebuild", "docdex_index_ingest"]);
+const DOCDEX_TOOL_OPERATIONS = new Map([
+    ["docdex_health", ["health"]],
+    ["docdex_initialize", ["initialize"]],
+    ["docdex_search", ["search"]],
+    ["docdex_open", ["open", "snippet"]],
+    ["docdex_open_file", ["open"]],
+    ["docdex_symbols", ["symbols"]],
+    ["docdex_ast", ["ast"]],
+    ["docdex_impact_graph", ["impact_graph"]],
+    ["docdex_impact_diagnostics", ["impact_diagnostics"]],
+    ["docdex_dag_export", ["dag_export"]],
+    ["docdex_tree", ["tree"]],
+    ["docdex_memory_save", ["memory_save"]],
+    ["docdex_memory_recall", ["memory_recall"]],
+    ["docdex_get_profile", ["profile_read"]],
+    ["docdex_save_preference", ["profile_write"]],
+    ["docdex_web_research", ["web_research"]],
+    ["docdex_chat_context", ["chat_context"]],
+    ["docdex_rerank", ["rerank"]],
+    ["docdex_batch_search", ["batch_search"]],
+    ["docdex_capabilities", ["capabilities"]],
+    ["docdex_stats", ["stats"]],
+    ["docdex_files", ["files"]],
+    ["docdex_repo_inspect", ["repo_inspect"]],
+    ["docdex_index_rebuild", ["index_rebuild"]],
+    ["docdex_index_ingest", ["index_ingest"]],
+    ["docdex_delegate", ["delegate"]],
+    ["docdex_hooks_validate", ["hooks_validate"]],
+]);
 const RUNTIME_TO_PROTOCOL_NEEDS = new Map([
     ["docdex_search", ["docdex.search"]],
     ["docdex_open", ["docdex.open", "docdex.snippet"]],
@@ -36,6 +65,7 @@ const RUNTIME_TO_PROTOCOL_NEEDS = new Map([
     ["docdex_symbols", ["docdex.symbols"]],
     ["docdex_ast", ["docdex.ast"]],
     ["docdex_web_research", ["docdex.web"]],
+    ["docdex_chat_context", ["docdex.chat_context"]],
     ["docdex_impact_graph", ["docdex.impact"]],
     ["docdex_impact_diagnostics", ["docdex.impact_diagnostics"]],
     ["docdex_tree", ["docdex.tree"]],
@@ -51,6 +81,7 @@ const PROTOCOL_TO_RUNTIME_TOOL_NAMES = new Map([
     ["docdex.symbols", ["docdex_symbols"]],
     ["docdex.ast", ["docdex_ast"]],
     ["docdex.web", ["docdex_web_research"]],
+    ["docdex.chat_context", ["docdex_chat_context"]],
     ["docdex.impact", ["docdex_impact_graph"]],
     ["docdex.impact_diagnostics", ["docdex_impact_diagnostics"]],
     ["docdex.tree", ["docdex_tree"]],
@@ -516,10 +547,43 @@ const isRuntimeToolAllowed = (toolName, policy) => {
     }
     return true;
 };
+const allowedDocdexOperations = (docdex) => {
+    if (!docdex?.allowedOperations?.length)
+        return undefined;
+    const operations = docdex.allowedOperations
+        .map((entry) => normalizeDocdexRuntimeOperation(entry))
+        .filter((entry) => Boolean(entry));
+    return operations.length ? new Set(operations) : new Set();
+};
+const docdexCapabilityAllows = (docdex, operation) => {
+    if (!docdex?.capabilities)
+        return true;
+    for (const [key, value] of Object.entries(docdex.capabilities)) {
+        if (normalizeDocdexRuntimeOperation(key) === operation && value === false) {
+            return false;
+        }
+    }
+    return true;
+};
+const isDocdexRuntimeOperationAllowed = (toolName, docdex) => {
+    const operations = DOCDEX_TOOL_OPERATIONS.get(toolName);
+    if (!operations?.length)
+        return true;
+    const allowedOperations = allowedDocdexOperations(docdex);
+    return operations.some((operation) => {
+        if (allowedOperations && !allowedOperations.has(operation)) {
+            return false;
+        }
+        return docdexCapabilityAllows(docdex, operation);
+    });
+};
 const isDocdexToolAllowed = (toolName, docdex) => {
     if (!toolName.startsWith("docdex_")) {
         return true;
     }
+    if (docdex?.enabled === false) {
+        return false;
+    }
     if (docdex?.allowWeb === false && WEB_TOOL_NAMES.has(toolName)) {
         return false;
     }
@@ -532,6 +596,9 @@ const isDocdexToolAllowed = (toolName, docdex) => {
     if (docdex?.allowIndexRebuild === false && INDEX_REBUILD_TOOL_NAMES.has(toolName)) {
         return false;
     }
+    if (!isDocdexRuntimeOperationAllowed(toolName, docdex)) {
+        return false;
+    }
     return true;
 };
 const registerRuntimeTool = (registry, tool, policy, docdex) => {
@@ -563,6 +630,11 @@ const buildRuntimeToolRegistry = (input) => {
         repoId: input.docdex?.repoId,
         repoRoot: input.docdex?.repoRoot ?? input.workspace.root,
         dagSessionId: input.docdex?.dagSessionId ?? input.metadata?.requestId,
+        apiKey: input.docdex?.apiKey,
+        credentialSource: input.docdex?.credentialSource,
+        required: input.docdex?.required,
+        allowedOperations: input.docdex?.allowedOperations,
+        capabilities: input.docdex?.capabilities,
     });
     for (const tool of createDocdexTools(docdexClient))
         register(tool);