@galaxy-stack/ai-coder-core 0.1.0

package/dist/tools/json-schema.js

@@ -0,0 +1,299 @@
+/**
+ * @author Bùi Trọng Hiếu
+ * @email kevinbui210191@gmail.com
+ * @create date 2026-08-21
+ * @modify date 2026-08-28
+ * @desc Deterministic validator for the JSON Schema subset accepted by AI Coder tools.
+ */
+import { compareAiCoderText } from "../deterministic-order.js";
+const JSON_SCHEMA_TYPES = new Set([
+    "array",
+    "boolean",
+    "integer",
+    "null",
+    "number",
+    "object",
+    "string",
+]);
+const SUPPORTED_KEYWORDS = new Set([
+    "$defs", "$id", "$ref", "$schema", "additionalProperties", "const",
+    "default", "description", "enum", "items", "maxItems", "maxLength",
+    "maximum", "minItems", "minLength", "minimum", "pattern", "properties",
+    "required", "title", "type", "uniqueItems", "oneOf",
+]);
+function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function valueType(value) {
+    if (Array.isArray(value))
+        return "array";
+    if (value === null)
+        return "null";
+    if (Number.isInteger(value))
+        return "integer";
+    return typeof value;
+}
+function decodePointerSegment(segment) {
+    return segment.replace(/~1/g, "/").replace(/~0/g, "~");
+}
+function resolveLocalRef(root, reference) {
+    if (reference === "#")
+        return root;
+    if (!reference.startsWith("#/"))
+        return null;
+    let current = root;
+    for (const rawSegment of reference.slice(2).split("/")) {
+        if (!isRecord(current))
+            return null;
+        current = current[decodePointerSegment(rawSegment)];
+    }
+    return isRecord(current) ? current : null;
+}
+function canonicalValue(value) {
+    if (Array.isArray(value))
+        return `[${value.map(canonicalValue).join(",")}]`;
+    if (isRecord(value)) {
+        return `{${Object.keys(value)
+            .sort(compareAiCoderText)
+            .map((key) => `${JSON.stringify(key)}:${canonicalValue(value[key])}`)
+            .join(",")}}`;
+    }
+    return JSON.stringify(value);
+}
+function validateNode(schema, value, path, errors, root, referenceStack) {
+    if (typeof schema.$ref === "string") {
+        const resolved = resolveLocalRef(root, schema.$ref);
+        if (!resolved) {
+            errors.push(`${path} dùng $ref không resolve được: ${schema.$ref}.`);
+            return;
+        }
+        if (referenceStack.has(schema.$ref)) {
+            errors.push(`${path} gặp vòng lặp $ref không được hỗ trợ: ${schema.$ref}.`);
+            return;
+        }
+        validateNode(resolved, value, path, errors, root, new Set([...referenceStack, schema.$ref]));
+        return;
+    }
+    if ("const" in schema && !Object.is(schema.const, value)) {
+        errors.push(`${path} phải bằng ${String(schema.const)}.`);
+    }
+    if (Array.isArray(schema.oneOf)) {
+        const matchingBranches = schema.oneOf.reduce((count, branch) => {
+            if (!isRecord(branch))
+                return count;
+            const branchErrors = [];
+            validateNode(branch, value, path, branchErrors, root, referenceStack);
+            return branchErrors.length === 0 ? count + 1 : count;
+        }, 0);
+        if (matchingBranches !== 1) {
+            errors.push(`${path} phải khớp chính xác một nhánh oneOf, nhận ${matchingBranches}.`);
+        }
+    }
+    const expected = typeof schema.type === "string" ? schema.type : null;
+    if (expected) {
+        const actual = valueType(value);
+        const typeMatches = expected === "number"
+            ? typeof value === "number" && Number.isFinite(value)
+            : expected === "object" ? isRecord(value) : expected === actual;
+        if (!typeMatches) {
+            errors.push(`${path} phải có type ${expected}, nhận ${actual}.`);
+            return;
+        }
+    }
+    if (Array.isArray(schema.enum) && !schema.enum.some((item) => Object.is(item, value))) {
+        errors.push(`${path} phải thuộc enum ${schema.enum.map(String).join(", ")}.`);
+    }
+    if (typeof value === "string") {
+        if (typeof schema.minLength === "number" && value.length < schema.minLength) {
+            errors.push(`${path} ngắn hơn minLength=${schema.minLength}.`);
+        }
+        if (typeof schema.maxLength === "number" && value.length > schema.maxLength) {
+            errors.push(`${path} dài hơn maxLength=${schema.maxLength}.`);
+        }
+        if (typeof schema.pattern === "string") {
+            try {
+                if (!new RegExp(schema.pattern).test(value))
+                    errors.push(`${path} không khớp pattern ${schema.pattern}.`);
+            }
+            catch {
+                errors.push(`${path} dùng pattern không hợp lệ: ${schema.pattern}.`);
+            }
+        }
+    }
+    if (typeof value === "number") {
+        if (typeof schema.minimum === "number" && value < schema.minimum)
+            errors.push(`${path} nhỏ hơn minimum=${schema.minimum}.`);
+        if (typeof schema.maximum === "number" && value > schema.maximum)
+            errors.push(`${path} lớn hơn maximum=${schema.maximum}.`);
+    }
+    if (Array.isArray(value)) {
+        if (typeof schema.minItems === "number" && value.length < schema.minItems)
+            errors.push(`${path} ít hơn minItems=${schema.minItems}.`);
+        if (typeof schema.maxItems === "number" && value.length > schema.maxItems)
+            errors.push(`${path} vượt maxItems=${schema.maxItems}.`);
+        if (schema.uniqueItems === true) {
+            const canonicalItems = value.map(canonicalValue);
+            if (new Set(canonicalItems).size !== canonicalItems.length)
+                errors.push(`${path} phải có các phần tử duy nhất.`);
+        }
+        const itemSchema = isRecord(schema.items) ? schema.items : null;
+        if (itemSchema)
+            value.forEach((item, index) => validateNode(itemSchema, item, `${path}[${index}]`, errors, root, referenceStack));
+    }
+    if (isRecord(value)) {
+        const properties = isRecord(schema.properties) ? schema.properties : {};
+        const required = Array.isArray(schema.required)
+            ? schema.required.filter((item) => typeof item === "string")
+            : [];
+        required.forEach((key) => {
+            if (!(key in value))
+                errors.push(`${path}.${key} là trường bắt buộc.`);
+        });
+        Object.entries(value).forEach(([key, item]) => {
+            const propertySchema = properties[key];
+            if (propertySchema) {
+                validateNode(propertySchema, item, `${path}.${key}`, errors, root, referenceStack);
+            }
+            else if (schema.additionalProperties === false) {
+                errors.push(`${path}.${key} không được khai báo trong schema.`);
+            }
+            else if (isRecord(schema.additionalProperties)) {
+                validateNode(schema.additionalProperties, item, `${path}.${key}`, errors, root, referenceStack);
+            }
+        });
+    }
+}
+function validateNonNegativeInteger(value, path, errors) {
+    if (value !== undefined && (!Number.isInteger(value) || Number(value) < 0)) {
+        errors.push(`${path} phải là integer không âm.`);
+    }
+}
+function validateSchemaDefinitionNode(schema, path, errors, root) {
+    if (!isRecord(schema)) {
+        errors.push(`${path} phải là JSON Schema object.`);
+        return;
+    }
+    Object.keys(schema).forEach((keyword) => {
+        if (!SUPPORTED_KEYWORDS.has(keyword))
+            errors.push(`${path}.${keyword} không thuộc JSON Schema subset được hỗ trợ.`);
+    });
+    if (schema.type !== undefined && (typeof schema.type !== "string" || !JSON_SCHEMA_TYPES.has(schema.type))) {
+        errors.push(`${path}.type không hợp lệ.`);
+    }
+    if (schema.$ref !== undefined) {
+        if (typeof schema.$ref !== "string" || !schema.$ref.startsWith("#")) {
+            errors.push(`${path} chỉ hỗ trợ local $ref.`);
+        }
+        else if (!resolveLocalRef(root, schema.$ref)) {
+            errors.push(`${path} dùng $ref không resolve được: ${schema.$ref}.`);
+        }
+    }
+    if (schema.pattern !== undefined) {
+        if (typeof schema.pattern !== "string") {
+            errors.push(`${path}.pattern phải là string.`);
+        }
+        else {
+            try {
+                new RegExp(schema.pattern);
+            }
+            catch {
+                errors.push(`${path}.pattern không phải regular expression hợp lệ.`);
+            }
+        }
+    }
+    if (schema.enum !== undefined && (!Array.isArray(schema.enum) || schema.enum.length === 0)) {
+        errors.push(`${path}.enum phải là array không rỗng.`);
+    }
+    if (Array.isArray(schema.enum)) {
+        const canonicalItems = schema.enum.map(canonicalValue);
+        if (new Set(canonicalItems).size !== canonicalItems.length)
+            errors.push(`${path}.enum không được chứa giá trị trùng.`);
+    }
+    if (schema.oneOf !== undefined && (!Array.isArray(schema.oneOf) || schema.oneOf.length === 0)) {
+        errors.push(`${path}.oneOf phải là array schema không rỗng.`);
+    }
+    if (schema.required !== undefined && !Array.isArray(schema.required))
+        errors.push(`${path}.required phải là array.`);
+    if (Array.isArray(schema.required)) {
+        if (schema.required.some((item) => typeof item !== "string" || item.length === 0))
+            errors.push(`${path}.required chỉ được chứa string không rỗng.`);
+        const required = schema.required.filter((item) => typeof item === "string");
+        if (new Set(required).size !== required.length)
+            errors.push(`${path}.required không được chứa tên trùng.`);
+        if (isRecord(schema.properties)) {
+            const declaredProperties = schema.properties;
+            required.forEach((key) => {
+                if (!(key in declaredProperties))
+                    errors.push(`${path}.required chứa property không được khai báo: ${key}.`);
+            });
+        }
+    }
+    if (schema.additionalProperties !== undefined && typeof schema.additionalProperties !== "boolean" && !isRecord(schema.additionalProperties)) {
+        errors.push(`${path}.additionalProperties phải là boolean hoặc schema.`);
+    }
+    if (schema.uniqueItems !== undefined && typeof schema.uniqueItems !== "boolean")
+        errors.push(`${path}.uniqueItems phải là boolean.`);
+    validateNonNegativeInteger(schema.minLength, `${path}.minLength`, errors);
+    validateNonNegativeInteger(schema.maxLength, `${path}.maxLength`, errors);
+    validateNonNegativeInteger(schema.minItems, `${path}.minItems`, errors);
+    validateNonNegativeInteger(schema.maxItems, `${path}.maxItems`, errors);
+    if (typeof schema.minLength === "number" && typeof schema.maxLength === "number" && schema.minLength > schema.maxLength)
+        errors.push(`${path}.minLength không được lớn hơn maxLength.`);
+    if (typeof schema.minItems === "number" && typeof schema.maxItems === "number" && schema.minItems > schema.maxItems)
+        errors.push(`${path}.minItems không được lớn hơn maxItems.`);
+    if (schema.minimum !== undefined && (typeof schema.minimum !== "number" || !Number.isFinite(schema.minimum)))
+        errors.push(`${path}.minimum phải là finite number.`);
+    if (schema.maximum !== undefined && (typeof schema.maximum !== "number" || !Number.isFinite(schema.maximum)))
+        errors.push(`${path}.maximum phải là finite number.`);
+    if (typeof schema.minimum === "number" && typeof schema.maximum === "number" && schema.minimum > schema.maximum)
+        errors.push(`${path}.minimum không được lớn hơn maximum.`);
+    if (schema.items !== undefined)
+        validateSchemaDefinitionNode(schema.items, `${path}.items`, errors, root);
+    if (Array.isArray(schema.oneOf)) {
+        schema.oneOf.forEach((branch, index) => {
+            validateSchemaDefinitionNode(branch, `${path}.oneOf[${index}]`, errors, root);
+        });
+    }
+    if (isRecord(schema.additionalProperties))
+        validateSchemaDefinitionNode(schema.additionalProperties, `${path}.additionalProperties`, errors, root);
+    if (schema.properties !== undefined) {
+        if (!isRecord(schema.properties))
+            errors.push(`${path}.properties phải là object.`);
+        else
+            Object.entries(schema.properties).forEach(([key, child]) => validateSchemaDefinitionNode(child, `${path}.properties.${key}`, errors, root));
+    }
+    if (schema.$defs !== undefined) {
+        if (!isRecord(schema.$defs))
+            errors.push(`${path}.$defs phải là object.`);
+        else
+            Object.entries(schema.$defs).forEach(([key, child]) => validateSchemaDefinitionNode(child, `${path}.$defs.${key}`, errors, root));
+    }
+}
+/** Validates that a schema itself belongs to the deterministic subset supported by this runtime. */
+export function validateAiCoderJsonSchemaDefinition(schema) {
+    const errors = [];
+    if (!isRecord(schema))
+        errors.push("$ phải là JSON Schema object.");
+    else
+        validateSchemaDefinitionNode(schema, "$", errors, schema);
+    return Object.freeze({ valid: errors.length === 0, errors: Object.freeze(errors) });
+}
+export function assertAiCoderJsonSchemaDefinition(schema, label) {
+    const result = validateAiCoderJsonSchemaDefinition(schema);
+    if (!result.valid)
+        throw new Error(`${label} không hợp lệ: ${result.errors.join(" ")}`);
+}
+export function validateAiCoderJsonSchema(schema, value) {
+    const definition = validateAiCoderJsonSchemaDefinition(schema);
+    if (!definition.valid)
+        return definition;
+    const errors = [];
+    validateNode(schema, value, "$", errors, schema, new Set());
+    return Object.freeze({ valid: errors.length === 0, errors: Object.freeze(errors) });
+}
+export function assertAiCoderJsonSchema(schema, value, label) {
+    const result = validateAiCoderJsonSchema(schema, value);
+    if (!result.valid)
+        throw new Error(`${label} không hợp lệ: ${result.errors.join(" ")}`);
+}
+//# sourceMappingURL=json-schema.js.map

package/dist/tools/json-schema.js.map

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

package/dist/tools/settings-types.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @author Bùi Trọng Hiếu
+ * @email kevinbui210191@gmail.com
+ * @create date 2026-08-21
+ * @modify date 2026-08-28
+ * @desc Versioned runtime-only settings for the single coding agent.
+ */
+/** The core deliberately exposes no multi-agent execution mode. */
+export type AiCoderExecutionMode = "single";
+export type AiCoderTokenProfile = "balanced" | "conservative" | "extended";
+export type AiCoderApprovalProfile = "strict" | "balanced" | "trusted-workspace";
+export type AiCoderProviderKind = "anthropic" | "openai" | "gemini" | "ollama" | "openai-compatible" | "host";
+export type AiCoderCredentialSource = "manual-config" | "secret-handle";
+export type AiCoderSingleAgentSettings = Readonly<{
+    baseUrl: string;
+    credentialSource: AiCoderCredentialSource;
+    maxParallelToolCalls: number;
+    maxRetries: number;
+    maxToolCalls: number;
+    maxToolRounds: number;
+    maxTurns: number;
+    model: string;
+    preserveThinking: boolean;
+    provider: AiCoderProviderKind;
+    requestTimeoutMs: number;
+    temperature: number;
+    tokenProfile: AiCoderTokenProfile;
+}>;
+export type AiCoderSafetySettings = Readonly<{
+    approvalProfile: AiCoderApprovalProfile;
+}>;
+export type AiCoderCoreSettings = Readonly<{
+    executionMode: "single";
+    safety: AiCoderSafetySettings;
+    schemaVersion: 2;
+    singleAgent: AiCoderSingleAgentSettings;
+}>;
+export declare const DEFAULT_AI_CODER_CORE_SETTINGS: AiCoderCoreSettings;
+/** Runtime guard used when loading untrusted JSON from host settings storage. */
+export declare function isAiCoderCoreSettings(value: unknown): value is AiCoderCoreSettings;
+//# sourceMappingURL=settings-types.d.ts.map

package/dist/tools/settings-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-types.d.ts","sourceRoot":"","sources":["../../src/tools/settings-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,mEAAmE;AACnE,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;AAC5C,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,cAAc,GAAG,UAAU,CAAC;AAC3E,MAAM,MAAM,sBAAsB,GAC9B,QAAQ,GACR,UAAU,GACV,mBAAmB,CAAC;AACxB,MAAM,MAAM,mBAAmB,GAC3B,WAAW,GACX,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,mBAAmB,GACnB,MAAM,CAAC;AACX,MAAM,MAAM,uBAAuB,GAAG,eAAe,GAAG,eAAe,CAAC;AAExE,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,uBAAuB,CAAC;IAC1C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,mBAAmB,CAAC;CACnC,CAAC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAC3C,eAAe,EAAE,sBAAsB,CAAC;CACzC,CAAC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACzC,aAAa,EAAE,QAAQ,CAAC;IACxB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,aAAa,EAAE,CAAC,CAAC;IACjB,WAAW,EAAE,0BAA0B,CAAC;CACzC,CAAC,CAAC;AAEH,eAAO,MAAM,8BAA8B,EAAE,mBAmB3C,CAAC;AAUH,iFAAiF;AACjF,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,mBAAmB,CAqD9B"}

package/dist/tools/settings-types.js

@@ -0,0 +1,88 @@
+/**
+ * @author Bùi Trọng Hiếu
+ * @email kevinbui210191@gmail.com
+ * @create date 2026-08-21
+ * @modify date 2026-08-28
+ * @desc Versioned runtime-only settings for the single coding agent.
+ */
+export const DEFAULT_AI_CODER_CORE_SETTINGS = Object.freeze({
+    executionMode: "single",
+    safety: Object.freeze({ approvalProfile: "balanced" }),
+    schemaVersion: 2,
+    singleAgent: Object.freeze({
+        baseUrl: "https://ollama.com",
+        credentialSource: "manual-config",
+        maxParallelToolCalls: 1,
+        maxRetries: 3,
+        maxToolCalls: 48,
+        maxToolRounds: 24,
+        maxTurns: 24,
+        model: "glm-5.3-flash:cloud",
+        preserveThinking: true,
+        provider: "ollama",
+        requestTimeoutMs: 180_000,
+        temperature: 0,
+        tokenProfile: "balanced",
+    }),
+});
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isPositiveInteger(value) {
+    return Number.isInteger(value) && typeof value === "number" && value > 0;
+}
+/** Runtime guard used when loading untrusted JSON from host settings storage. */
+export function isAiCoderCoreSettings(value) {
+    if (!isRecord(value) || value.schemaVersion !== 2)
+        return false;
+    if (value.executionMode !== "single")
+        return false;
+    if (!isRecord(value.safety) || !isRecord(value.singleAgent))
+        return false;
+    const safety = value.safety;
+    const singleAgent = value.singleAgent;
+    const approvalProfiles = [
+        "strict",
+        "balanced",
+        "trusted-workspace",
+    ];
+    const credentialSources = [
+        "manual-config",
+        "secret-handle",
+    ];
+    const providers = [
+        "anthropic",
+        "openai",
+        "gemini",
+        "ollama",
+        "openai-compatible",
+        "host",
+    ];
+    const tokenProfiles = [
+        "balanced",
+        "conservative",
+        "extended",
+    ];
+    return (approvalProfiles.includes(safety.approvalProfile) &&
+        typeof singleAgent.baseUrl === "string" &&
+        singleAgent.baseUrl.length > 0 &&
+        credentialSources.includes(singleAgent.credentialSource) &&
+        isPositiveInteger(singleAgent.maxParallelToolCalls) &&
+        Number.isInteger(singleAgent.maxRetries) &&
+        typeof singleAgent.maxRetries === "number" &&
+        singleAgent.maxRetries >= 0 &&
+        isPositiveInteger(singleAgent.maxToolCalls) &&
+        isPositiveInteger(singleAgent.maxToolRounds) &&
+        isPositiveInteger(singleAgent.maxTurns) &&
+        typeof singleAgent.model === "string" &&
+        singleAgent.model.length > 0 &&
+        typeof singleAgent.preserveThinking === "boolean" &&
+        providers.includes(singleAgent.provider) &&
+        isPositiveInteger(singleAgent.requestTimeoutMs) &&
+        typeof singleAgent.temperature === "number" &&
+        Number.isFinite(singleAgent.temperature) &&
+        singleAgent.temperature >= 0 &&
+        singleAgent.temperature <= 2 &&
+        tokenProfiles.includes(singleAgent.tokenProfile));
+}
+//# sourceMappingURL=settings-types.js.map

package/dist/tools/settings-types.js.map

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

package/dist/tools/tool-effect-profile.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Canonical host-effect policy for the built-in AI Coder tool catalog.
+ *
+ * Hosts must consume this profile instead of maintaining a local copy. The
+ * runtime treats these entries as a maximum authority boundary: a tool may
+ * omit an allowed effect, but it must never emit an effect absent here.
+ */
+import type { AiCoderToolDescriptor } from "./tool-registry-types.js";
+declare const EFFECT_CAPABILITY_NAMES: readonly ["approval", "criterion_satisfy", "criterion_waive", "diff_review", "inspect", "plan", "research", "state_version", "validate", "write"];
+export type AiCoderToolEffectCapability = (typeof EFFECT_CAPABILITY_NAMES)[number];
+export declare const AI_CODER_TOOL_EFFECT_CAPABILITIES: readonly AiCoderToolEffectCapability[];
+export declare const AI_CODER_CORE_TOOL_EFFECT_PROFILE_VERSION = "1.1.0";
+/**
+ * Exact effect capabilities for all 21 built-in tools. An empty or omitted
+ * effect is always valid; these arrays only describe effects a host may attest.
+ * Acceptance-criterion effects intentionally remain unavailable to built-in
+ * tools until a dedicated evidence-bearing contract is introduced.
+ */
+export declare const AI_CODER_CORE_TOOL_EFFECT_PROFILE: Readonly<Record<string, readonly AiCoderToolEffectCapability[]>>;
+export type AiCoderCoreToolEffectMetadata = Readonly<{
+    canonicalToolIds: Readonly<Record<string, string>>;
+    effectCapabilities: Readonly<Record<string, readonly AiCoderToolEffectCapability[]>>;
+}>;
+type EffectProfileInput = Readonly<{
+    descriptors?: readonly Pick<AiCoderToolDescriptor, "id" | "modelName">[];
+    effectCapabilities?: Readonly<Record<string, readonly string[]>>;
+}>;
+/** Return every catalog/profile drift issue without throwing at the first one. */
+export declare function validateAiCoderCoreToolEffectProfile(input?: EffectProfileInput): readonly string[];
+export declare function assertAiCoderCoreToolEffectProfile(input?: EffectProfileInput): void;
+/**
+ * Fail closed when a host changes the authority of a built-in tool. Unknown
+ * canonical IDs are extension/MCP tools and remain governed by the host's
+ * explicitly declared profile.
+ */
+export declare function assertAiCoderCoreToolEffectCapabilities(canonicalToolId: string, actual: readonly string[]): void;
+/**
+ * Build the exact active model-name mapping plus the complete stable effect
+ * policy expected by `AiCoderRuntimeToolSet`. Hosts should call this for the
+ * registry's active descriptors on every tool-set snapshot.
+ */
+export declare function createAiCoderCoreToolEffectMetadata(descriptors: readonly Pick<AiCoderToolDescriptor, "id" | "modelName">[]): AiCoderCoreToolEffectMetadata;
+export {};
+//# sourceMappingURL=tool-effect-profile.d.ts.map

package/dist/tools/tool-effect-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-effect-profile.d.ts","sourceRoot":"","sources":["../../src/tools/tool-effect-profile.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEtE,QAAA,MAAM,uBAAuB,mJAWnB,CAAC;AAEX,MAAM,MAAM,2BAA2B,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnF,eAAO,MAAM,iCAAiC,EAAE,SAAS,2BAA2B,EAEnF,CAAC;AAEF,eAAO,MAAM,yCAAyC,UAAU,CAAC;AAQjE;;;;;GAKG;AACH,eAAO,MAAM,iCAAiC,EAAE,QAAQ,CACtD,MAAM,CAAC,MAAM,EAAE,SAAS,2BAA2B,EAAE,CAAC,CAuBtD,CAAC;AAEH,MAAM,MAAM,6BAA6B,GAAG,QAAQ,CAAC;IACnD,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,2BAA2B,EAAE,CAAC,CAAC,CAAC;CACtF,CAAC,CAAC;AAEH,KAAK,kBAAkB,GAAG,QAAQ,CAAC;IACjC,WAAW,CAAC,EAAE,SAAS,IAAI,CAAC,qBAAqB,EAAE,IAAI,GAAG,WAAW,CAAC,EAAE,CAAC;IACzE,kBAAkB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;CAClE,CAAC,CAAC;AAMH,kFAAkF;AAClF,wBAAgB,oCAAoC,CAClD,KAAK,GAAE,kBAAuB,GAC7B,SAAS,MAAM,EAAE,CAsCnB;AAED,wBAAgB,kCAAkC,CAAC,KAAK,GAAE,kBAAuB,GAAG,IAAI,CAGvF;AAED;;;;GAIG;AACH,wBAAgB,uCAAuC,CACrD,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB,IAAI,CAWN;AAED;;;;GAIG;AACH,wBAAgB,mCAAmC,CACjD,WAAW,EAAE,SAAS,IAAI,CAAC,qBAAqB,EAAE,IAAI,GAAG,WAAW,CAAC,EAAE,GACtE,6BAA6B,CAqB/B"}