@marifold/core 0.60.0 → 0.64.0

package/dist/agent/tools/SearchAttachmentTool.d.ts

@@ -0,0 +1,33 @@
+import type { JSONValue } from '@priest-ai/core';
+import { AgentTool, ToolExecutionContext, ToolExecutionResult, ToolRiskAssessment } from '../ToolRegistry';
+export declare class SearchAttachmentTool implements AgentTool {
+    readonly kind: 'read';
+    readonly definition: {
+        name: string;
+        description: string;
+        parameters: {
+            type: string;
+            properties: {
+                attachment_id: {
+                    type: string;
+                    description: string;
+                };
+                query: {
+                    type: string;
+                    description: string;
+                };
+                max_results: {
+                    type: string;
+                    minimum: number;
+                    maximum: number;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    summarizeCall(input: Record<string, JSONValue>): string;
+    assessRisk(): ToolRiskAssessment;
+    execute(input: Record<string, JSONValue>, ctx: ToolExecutionContext): Promise<ToolExecutionResult>;
+}
+//# sourceMappingURL=SearchAttachmentTool.d.ts.map

package/dist/agent/tools/SearchAttachmentTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchAttachmentTool.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/SearchAttachmentTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAOjD,OAAO,EACL,SAAS,EAET,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AAEzB,qBAAa,oBAAqB,YAAW,SAAS;IACpD,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAU;IAChC,QAAQ,CAAC,UAAU;;;;;;;oBAUI,IAAI;oBAAY,WAAW;;;oBACnC,IAAI;oBAAY,WAAW;;;;;;;;;;;MAUxC;IAEF,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM,CAItD;IAED,UAAU,IAAI,kBAAkB,CAE/B;IAEK,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAgCvG;CACF"}

package/dist/agent/tools/SearchAttachmentTool.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchAttachmentTool = void 0;
+const AttachmentResources_1 = require("../AttachmentResources");
+const ToolRegistry_1 = require("../ToolRegistry");
+class SearchAttachmentTool {
+    kind = 'read';
+    definition = {
+        name: 'search_attachment',
+        description: [
+            'Search the derived readable view of one uploaded attachment and return bounded line matches.',
+            'When to use: locate a heading, identifier, name, table label, or passage without loading the complete document into model context.',
+            'When NOT to use: transform a file, search an arbitrary filesystem path, or repeatedly enumerate an entire document. Use a local format-specific tool for complete-file processing.',
+        ].join(' '),
+        parameters: {
+            type: 'object',
+            properties: {
+                attachment_id: { type: 'string', description: 'Opaque attachment ID from the current run manifest.' },
+                query: { type: 'string', description: 'Case-insensitive literal text to find.' },
+                max_results: {
+                    type: 'integer',
+                    minimum: 1,
+                    maximum: AttachmentResources_1.MAX_ATTACHMENT_SEARCH_RESULTS,
+                    description: `Maximum matches to return. Defaults to ${AttachmentResources_1.DEFAULT_ATTACHMENT_SEARCH_RESULTS}.`,
+                },
+            },
+            required: ['attachment_id', 'query'],
+        },
+    };
+    summarizeCall(input) {
+        const id = typeof input.attachment_id === 'string' ? input.attachment_id : '<missing attachment>';
+        const query = typeof input.query === 'string' ? input.query : '<missing query>';
+        return `search ${id} for ${JSON.stringify(query)}`;
+    }
+    assessRisk() {
+        return { escalate: false, trusted: true };
+    }
+    async execute(input, ctx) {
+        const id = (0, ToolRegistry_1.requireStringInput)(input, 'attachment_id', 'search_attachment');
+        const query = (0, ToolRegistry_1.requireStringInput)(input, 'query', 'search_attachment');
+        const attachment = ctx.workspace?.attachments.find(candidate => candidate.id === id);
+        if (!attachment) {
+            const available = ctx.workspace?.attachments.map(candidate => candidate.id).join(', ') || '(none)';
+            return {
+                content: `Attachment '${id}' is not available in this run. Available attachment IDs: ${available}.`,
+                summary: `attachment ${id} not found`,
+                isError: true,
+            };
+        }
+        const maxResults = integerInput(input.max_results, AttachmentResources_1.DEFAULT_ATTACHMENT_SEARCH_RESULTS);
+        if (maxResults < 1 || maxResults > AttachmentResources_1.MAX_ATTACHMENT_SEARCH_RESULTS) {
+            return {
+                content: `search_attachment requires max_results between 1 and ${AttachmentResources_1.MAX_ATTACHMENT_SEARCH_RESULTS}.`,
+                summary: `invalid search limit for ${attachment.name}`,
+                isError: true,
+            };
+        }
+        const result = new AttachmentResources_1.AttachmentResource(attachment).search(query, maxResults);
+        if (!result) {
+            return {
+                content: `No built-in searchable view is available for ${attachment.name}. Use a format-specific local tool against ${attachment.path ?? 'its staged run path'}.`,
+                summary: `no searchable view for ${attachment.name}`,
+                isError: true,
+            };
+        }
+        return {
+            content: (0, AttachmentResources_1.formatAttachmentSearch)(result, query),
+            summary: `found ${result.matches.length} match${result.matches.length === 1 ? '' : 'es'} in ${attachment.name}`,
+        };
+    }
+}
+exports.SearchAttachmentTool = SearchAttachmentTool;
+function integerInput(value, fallback) {
+    return typeof value === 'number' && Number.isInteger(value) ? value : fallback;
+}
+//# sourceMappingURL=SearchAttachmentTool.js.map

package/dist/agent/tools/SearchAttachmentTool.js.map

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

package/dist/agent/tools/SkillManagementTool.d.ts

@@ -0,0 +1,75 @@
+import type { JSONValue } from '@priest-ai/core';
+import { SkillStore } from '../../skill/SkillStore';
+import { AgentTool, ToolExecutionContext, ToolExecutionResult, ToolRiskAssessment } from '../ToolRegistry';
+export interface SkillManagementToolOptions {
+    store: SkillStore;
+    profile: string;
+    globalDir: string;
+    profileDir: string;
+}
+/** Validated mutation boundary used by Marifold's protected management skills. */
+export declare class SkillManagementTool implements AgentTool {
+    private readonly options;
+    readonly kind: 'write';
+    readonly definition: {
+        name: string;
+        description: string;
+        parameters: {
+            type: string;
+            properties: {
+                action: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                scope: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                name: {
+                    type: string;
+                    description: string;
+                };
+                source: {
+                    type: string;
+                    description: string;
+                };
+                content: {
+                    type: string;
+                    description: string;
+                };
+                files: {
+                    type: string;
+                    description: string;
+                    items: {
+                        type: string;
+                        properties: {
+                            path: {
+                                type: string;
+                            };
+                            content: {
+                                type: string;
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+            };
+            required: string[];
+        };
+    };
+    constructor(options: SkillManagementToolOptions);
+    summarizeCall(input: Record<string, JSONValue>): string;
+    assessRisk(input: Record<string, JSONValue>): ToolRiskAssessment;
+    execute(input: Record<string, JSONValue>, ctx: ToolExecutionContext): Promise<ToolExecutionResult>;
+    private create;
+    private install;
+    private update;
+    private remove;
+    private exactSkill;
+    private verify;
+    private dirForScope;
+    private scopeLabel;
+}
+//# sourceMappingURL=SkillManagementTool.d.ts.map

package/dist/agent/tools/SkillManagementTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillManagementTool.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/SkillManagementTool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,EAA+B,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGjF,OAAO,EACL,SAAS,EAET,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AAOzB,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,kFAAkF;AAClF,qBAAa,mBAAoB,YAAW,SAAS;IAoDvC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAnDpC,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IACjC,QAAQ,CAAC,UAAU;QACjB,IAAI;QACJ,WAAW;QAMX,UAAU;YACR,IAAI;YACJ,UAAU;gBACR,MAAM;oBACJ,IAAI;oBACJ,IAAI;oBACJ,WAAW;;gBAEb,KAAK;oBACH,IAAI;oBACJ,IAAI;oBACJ,WAAW;;gBAEb,IAAI;oBACF,IAAI;oBACJ,WAAW;;gBAEb,MAAM;oBACJ,IAAI;oBACJ,WAAW;;gBAEb,OAAO;oBACL,IAAI;oBACJ,WAAW;;gBAEb,KAAK;oBACH,IAAI;oBACJ,WAAW;oBACX,KAAK;wBACH,IAAI;wBACJ,UAAU;4BACR,IAAI;gCAAI,IAAI;;4BACZ,OAAO;gCAAI,IAAI;;;wBAEjB,QAAQ;;;;YAId,QAAQ;;MAEV;IAEF,YAA6B,OAAO,EAAE,0BAA0B,EAAI;IAEpE,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM,CAStD;IAED,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,kBAAkB,CAa/D;IAEK,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA2BvG;IAED,OAAO,CAAC,MAAM;IAgCd,OAAO,CAAC,OAAO;IAoBf,OAAO,CAAC,MAAM;IAwBd,OAAO,CAAC,MAAM;IAkBd,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,UAAU;CAGnB"}

package/dist/agent/tools/SkillManagementTool.js

@@ -0,0 +1,312 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SkillManagementTool = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const MarifoldError_1 = require("../../errors/MarifoldError");
+const BuiltInSkills_1 = require("../../skill/BuiltInSkills");
+const SkillStore_1 = require("../../skill/SkillStore");
+const SkillValidator_1 = require("../../skill/SkillValidator");
+const WorkspacePaths_1 = require("../../workspace/WorkspacePaths");
+const ToolRegistry_1 = require("../ToolRegistry");
+/** Validated mutation boundary used by Marifold's protected management skills. */
+class SkillManagementTool {
+    options;
+    kind = 'write';
+    definition = {
+        name: 'manage_skill',
+        description: [
+            'Create, install, update, or remove a user-managed Marifold skill in the active profile or configured global skill directory.',
+            'When to use: Marifold skill management after the user invokes a protected management skill or explicitly asks the agent to change a skill.',
+            'When NOT to use: running a skill, editing unrelated files, managing protected built-ins, fetching network sources, or changing both scopes at once.',
+            'Profile scope is the default user-facing scope; pass the exact intended scope on every call.',
+        ].join(' '),
+        parameters: {
+            type: 'object',
+            properties: {
+                action: {
+                    type: 'string',
+                    enum: ['create', 'install', 'update', 'remove'],
+                    description: 'The validated skill mutation to perform.',
+                },
+                scope: {
+                    type: 'string',
+                    enum: ['profile', 'global'],
+                    description: 'Exact destination scope. Use profile unless the user explicitly requested global.',
+                },
+                name: {
+                    type: 'string',
+                    description: 'Required for create, update, and remove. Must match the SKILL.md name for create/update.',
+                },
+                source: {
+                    type: 'string',
+                    description: 'Local Markdown file or folder containing SKILL.md. Required for install and update.',
+                },
+                content: {
+                    type: 'string',
+                    description: 'Complete SKILL.md text. Required for create.',
+                },
+                files: {
+                    type: 'array',
+                    description: 'Optional bundled text files for create, using safe paths relative to the new skill folder.',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            path: { type: 'string' },
+                            content: { type: 'string' },
+                        },
+                        required: ['path', 'content'],
+                    },
+                },
+            },
+            required: ['action', 'scope'],
+        },
+    };
+    constructor(options) {
+        this.options = options;
+    }
+    summarizeCall(input) {
+        const action = typeof input.action === 'string' ? input.action : '<missing action>';
+        const scope = typeof input.scope === 'string' ? input.scope : 'profile';
+        const target = typeof input.name === 'string'
+            ? `$${input.name}`
+            : typeof input.source === 'string'
+                ? input.source
+                : '<missing skill>';
+        return `${action} ${scope} skill ${target}`;
+    }
+    assessRisk(input) {
+        const scope = input.scope === 'global' ? 'global' : 'profile';
+        const dir = this.dirForScope(scope);
+        const suppliedName = typeof input.name === 'string' && /^[a-z0-9][a-z0-9_-]*$/.test(input.name)
+            ? input.name
+            : undefined;
+        const target = suppliedName ? path.join(dir, suppliedName) : dir;
+        return {
+            escalate: true,
+            persistable: false,
+            reason: `modifying the ${scope} Marifold skill directory`,
+            targetPath: target,
+        };
+    }
+    async execute(input, ctx) {
+        try {
+            const action = (0, ToolRegistry_1.requireStringInput)(input, 'action', 'manage_skill');
+            const scope = skillScope(input.scope);
+            switch (action) {
+                case 'create':
+                    return this.create(input, scope);
+                case 'install':
+                    return this.install(input, scope, ctx);
+                case 'update':
+                    return this.update(input, scope, ctx);
+                case 'remove':
+                    return this.remove(input, scope);
+                default:
+                    throw MarifoldError_1.MarifoldError.agentToolInvalid(`Tool 'manage_skill' received unsupported action '${action}'.`, 'manage_skill');
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: `Skill management failed: ${message}`,
+                summary: 'skill management failed',
+                isError: true,
+            };
+        }
+    }
+    create(input, scope) {
+        const name = requireMutableName(input, 'name');
+        const content = (0, ToolRegistry_1.requireStringInput)(input, 'content', 'manage_skill');
+        const skill = (0, SkillValidator_1.parseSkill)(content);
+        if (skill.name !== name) {
+            throw MarifoldError_1.MarifoldError.skillInvalid(`Requested name '${name}' does not match SKILL.md name '${skill.name}'.`);
+        }
+        if (this.exactSkill(name, scope)) {
+            throw MarifoldError_1.MarifoldError.skillInvalid(`Skill '${name}' already exists in ${scope} scope. Choose another name or update it separately.`);
+        }
+        const files = bundledTextFiles(input.files);
+        const installed = this.options.store.installFromText(content, scope);
+        const skillDir = path.dirname(installed.source);
+        try {
+            for (const file of files) {
+                const target = path.join(skillDir, file.path);
+                fs.mkdirSync(path.dirname(target), { recursive: true });
+                fs.writeFileSync(target, file.content);
+            }
+            this.verify(name, scope);
+        }
+        catch (error) {
+            this.options.store.remove(name, scope);
+            throw error;
+        }
+        return {
+            content: `Created $${name} in ${this.scopeLabel(scope)} at ${skillDir}. Invoke it with $${name}.`,
+            summary: `created ${scope} skill $${name}`,
+        };
+    }
+    install(input, scope, ctx) {
+        const source = localSource(input, ctx);
+        const preview = (0, SkillStore_1.readSkillSource)(source);
+        if ((0, BuiltInSkills_1.isBuiltInSkillName)(preview.skill.name)) {
+            throw protectedBuiltIn(preview.skill.name);
+        }
+        const existed = Boolean(this.exactSkill(preview.skill.name, scope));
+        const installed = this.options.store.installFromFile(source, scope);
+        this.verify(installed.name, scope);
+        const verb = existed ? 'Updated' : 'Installed';
+        return {
+            content: `${verb} $${installed.name} in ${this.scopeLabel(scope)} at ${path.dirname(installed.source)}.`,
+            summary: `${verb.toLowerCase()} ${scope} skill $${installed.name}`,
+        };
+    }
+    update(input, scope, ctx) {
+        const name = requireMutableName(input, 'name');
+        if (!this.exactSkill(name, scope)) {
+            throw MarifoldError_1.MarifoldError.skillInvalid(`Skill '${name}' does not exist in ${scope} scope.`);
+        }
+        const source = localSource(input, ctx);
+        const preview = (0, SkillStore_1.readSkillSource)(source);
+        if (preview.skill.name !== name) {
+            throw MarifoldError_1.MarifoldError.skillInvalid(`Update source name '${preview.skill.name}' does not match requested skill '${name}'.`);
+        }
+        const installed = this.options.store.installFromFile(source, scope);
+        this.verify(name, scope);
+        return {
+            content: `Updated $${name} in ${this.scopeLabel(scope)} at ${path.dirname(installed.source)}.`,
+            summary: `updated ${scope} skill $${name}`,
+        };
+    }
+    remove(input, scope) {
+        const name = requireMutableName(input, 'name');
+        const existing = this.exactSkill(name, scope);
+        if (!existing) {
+            throw MarifoldError_1.MarifoldError.skillInvalid(`Skill '${name}' does not exist in ${scope} scope.`);
+        }
+        const removedDir = path.dirname(existing.source);
+        this.options.store.remove(name, scope);
+        const effective = this.options.store.get(name);
+        const fallback = effective
+            ? ` The ${effective.scope} copy at ${path.dirname(effective.source)} is now effective.`
+            : ' No user-managed copy remains effective.';
+        return {
+            content: `Removed $${name} from ${this.scopeLabel(scope)} at ${removedDir}.${fallback}`,
+            summary: `removed ${scope} skill $${name}`,
+        };
+    }
+    exactSkill(name, scope) {
+        return this.options.store.list(scope).find(skill => skill.name === name);
+    }
+    verify(name, scope) {
+        if (!this.exactSkill(name, scope)) {
+            throw MarifoldError_1.MarifoldError.skillInvalid(`Could not verify '${name}' after writing ${scope} scope.`);
+        }
+    }
+    dirForScope(scope) {
+        return scope === 'global' ? this.options.globalDir : this.options.profileDir;
+    }
+    scopeLabel(scope) {
+        return scope === 'global' ? 'global scope' : `profile '${this.options.profile}'`;
+    }
+}
+exports.SkillManagementTool = SkillManagementTool;
+function skillScope(value) {
+    if (value === 'profile' || value === 'global')
+        return value;
+    throw MarifoldError_1.MarifoldError.agentToolInvalid("Tool 'manage_skill' requires scope 'profile' or 'global'.", 'manage_skill');
+}
+function requireMutableName(input, key) {
+    const name = (0, ToolRegistry_1.requireStringInput)(input, key, 'manage_skill');
+    if (!/^[a-z0-9][a-z0-9_-]*$/.test(name)) {
+        throw MarifoldError_1.MarifoldError.skillInvalid(`Invalid skill name '${name}'. Use lowercase letters, numbers, underscores, or hyphens (starting alphanumeric).`);
+    }
+    if ((0, BuiltInSkills_1.isBuiltInSkillName)(name))
+        throw protectedBuiltIn(name);
+    return name;
+}
+function protectedBuiltIn(name) {
+    return MarifoldError_1.MarifoldError.skillInvalid(`Skill '${name}' is a protected Marifold built-in and cannot be installed, updated, or removed.`);
+}
+function localSource(input, ctx) {
+    const source = (0, WorkspacePaths_1.expandHome)((0, ToolRegistry_1.requireStringInput)(input, 'source', 'manage_skill'));
+    if (/^[a-z][a-z0-9+.-]*:\/\//i.test(source)) {
+        throw MarifoldError_1.MarifoldError.skillInvalid('Skill sources must be local files or folders; network URLs are not supported.');
+    }
+    return path.resolve(ctx.cwd, source);
+}
+function bundledTextFiles(value) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value)) {
+        throw MarifoldError_1.MarifoldError.agentToolInvalid("Tool 'manage_skill' expects 'files' to be an array.", 'manage_skill');
+    }
+    const seen = new Set();
+    return value.map((entry, index) => {
+        if (typeof entry !== 'object' || entry === null || Array.isArray(entry)) {
+            throw MarifoldError_1.MarifoldError.agentToolInvalid(`Tool 'manage_skill' expects files[${index}] to be an object.`, 'manage_skill');
+        }
+        const file = entry;
+        if (typeof file.content !== 'string') {
+            throw MarifoldError_1.MarifoldError.agentToolInvalid(`Tool 'manage_skill' requires files[${index}].content to be a string.`, 'manage_skill');
+        }
+        const relative = safeBundledPath((0, ToolRegistry_1.requireStringInput)(file, 'path', 'manage_skill'));
+        if (seen.has(relative)) {
+            throw MarifoldError_1.MarifoldError.skillInvalid(`Duplicate bundled file path '${relative}'.`);
+        }
+        seen.add(relative);
+        return {
+            path: relative,
+            content: file.content,
+        };
+    });
+}
+function safeBundledPath(value) {
+    if (value.includes('\0')) {
+        throw MarifoldError_1.MarifoldError.skillInvalid('Bundled file paths cannot contain null bytes.');
+    }
+    const portable = value.replace(/\\/g, '/');
+    const parts = portable.split('/');
+    if (portable.startsWith('/')
+        || /^[a-z]:\//i.test(portable)
+        || parts.some(part => part === '' || part === '.' || part === '..')) {
+        throw MarifoldError_1.MarifoldError.skillInvalid(`Unsafe bundled file path '${value}'.`);
+    }
+    if (portable === 'SKILL.md') {
+        throw MarifoldError_1.MarifoldError.skillInvalid("Bundled files cannot replace the skill's SKILL.md.");
+    }
+    return parts.join(path.sep);
+}
+//# sourceMappingURL=SkillManagementTool.js.map

package/dist/agent/tools/SkillManagementTool.js.map

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

package/dist/config/ConfigManager.d.ts

@@ -12,6 +12,11 @@ export interface ConfigRemoveProviderResult extends ConfigSetResult {
     removed: boolean;
     removedModels: string[];
 }
+export interface ConfigAddProviderOptions {
+    baseUrl?: string;
+    apiKeyEnv?: string;
+    proxy?: string;
+}
 export declare class ConfigManager {
     private readonly loadedConfig;
     constructor(loadedConfig: LoadedMarifoldConfig);
@@ -29,6 +34,10 @@ export declare class ConfigManager {
     private readValue;
     setDefaultModel(model: string, provider?: string): ConfigSetResult;
     addModel(provider: string, model: string, options?: Partial<MarifoldProviderConfig>): ConfigSetResult;
+    /** Add or reconfigure one provider using the same registry defaults as the
+     * CLI picker and Web catalog. Credentials remain untouched and raw secrets
+     * are deliberately outside this input surface. */
+    addProvider(provider: string, options?: ConfigAddProviderOptions): ConfigSetResult;
     /** Merge changes into the [web_search] section (undefined keys are left as-is)
      * and persist. Used by `marifold config search`. */
     updateWebSearch(partial: Partial<MarifoldWebSearchConfig>): ConfigSetResult;

package/dist/config/ConfigManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConfigManager.d.ts","sourceRoot":"","sources":["../../src/config/ConfigManager.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,sBAAsB,EACtB,uBAAuB,EAGxB,MAAM,gBAAgB,CAAC;AAOxB,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,uBAAwB,SAAQ,eAAe;IAC9D,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,0BAA2B,SAAQ,eAAe;IACjE,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,YAAY;IAAzC,YAA6B,YAAY,EAAE,oBAAoB,EAAI;IAEnE,IAAI,MAAM,IAAI,cAAc,CAE3B;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,IAAI,MAAM,CAIb;IAED,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CA0BpD;IAED;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMxC;IAED,OAAO,CAAC,SAAS;IA2FjB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,eAAe,CAWjE;IAED,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,OAAO,CAAC,sBAAsB,CAAM,GAAG,eAAe,CAsBxG;IAED;wDACoD;IACpD,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAAG,eAAe,CAO1E;IAED,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,uBAAuB,CA0BpE;IAED;mFAC+E;IAC/E,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,0BAA0B,CA+B3D;IAED,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAOjF;IAED,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAKlD;IAED,OAAO,CAAC,eAAe;IA+CvB,OAAO,CAAC,YAAY;IAyBpB,OAAO,CAAC,cAAc;IAatB;;0EAEsE;IACtE,OAAO,CAAC,eAAe;IAqBvB,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,qBAAqB;IAM7B,OAAO,CAAC,iBAAiB;IAiCzB,OAAO,CAAC,gBAAgB;IAiCxB,OAAO,CAAC,cAAc;CAQvB;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAsGnE"}
+{"version":3,"file":"ConfigManager.d.ts","sourceRoot":"","sources":["../../src/config/ConfigManager.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,sBAAsB,EACtB,uBAAuB,EAGxB,MAAM,gBAAgB,CAAC;AAOxB,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,uBAAwB,SAAQ,eAAe;IAC9D,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,0BAA2B,SAAQ,eAAe;IACjE,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,YAAY;IAAzC,YAA6B,YAAY,EAAE,oBAAoB,EAAI;IAEnE,IAAI,MAAM,IAAI,cAAc,CAE3B;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,IAAI,MAAM,CAIb;IAED,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CA0BpD;IAED;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMxC;IAED,OAAO,CAAC,SAAS;IA2FjB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,eAAe,CAWjE;IAED,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,OAAO,CAAC,sBAAsB,CAAM,GAAG,eAAe,CAsBxG;IAED;;sDAEkD;IAClD,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,wBAA6B,GAAG,eAAe,CAiCrF;IAED;wDACoD;IACpD,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAAG,eAAe,CAO1E;IAED,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,uBAAuB,CA0BpE;IAED;mFAC+E;IAC/E,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,0BAA0B,CA+B3D;IAED,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAOjF;IAED,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAKlD;IAED,OAAO,CAAC,eAAe;IA+CvB,OAAO,CAAC,YAAY;IAyBpB,OAAO,CAAC,cAAc;IAatB;;0EAEsE;IACtE,OAAO,CAAC,eAAe;IAqBvB,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,qBAAqB;IAM7B,OAAO,CAAC,iBAAiB;IAiCzB,OAAO,CAAC,gBAAgB;IAiCxB,OAAO,CAAC,cAAc;CAQvB;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAsGnE"}

package/dist/config/ConfigManager.js

@@ -246,6 +246,49 @@ class ConfigManager {
         this.save();
         return { configPath: this.configPath, key: 'models.options', value: `${provider}/${model}` };
     }
+    /** Add or reconfigure one provider using the same registry defaults as the
+     * CLI picker and Web catalog. Credentials remain untouched and raw secrets
+     * are deliberately outside this input surface. */
+    addProvider(provider, options = {}) {
+        if (!provider)
+            throw MarifoldError_1.MarifoldError.configInvalid('Provider cannot be empty.');
+        const existing = this.config.providers[provider];
+        const registry = (0, ProviderRegistry_1.getProviderRegistryEntry)(provider);
+        if (!registry && !existing)
+            throw MarifoldError_1.MarifoldError.configInvalid(`Unknown provider: ${provider}`);
+        const type = existing?.type ?? registry?.type ?? 'openai-compatible';
+        const baseUrl = options.baseUrl === undefined
+            ? existing?.baseUrl ?? registry?.defaultBaseUrl
+            : options.baseUrl.trim();
+        const apiKeyEnv = options.apiKeyEnv === undefined
+            ? existing?.apiKeyEnv ?? registry?.apiKeyEnv
+            : options.apiKeyEnv.trim();
+        if ((type === 'ollama' || type === 'openai-compatible') && !baseUrl) {
+            throw MarifoldError_1.MarifoldError.configInvalid(`Provider '${provider}' requires a server URL.`);
+        }
+        if (registry?.kind === 'api' && !apiKeyEnv) {
+            throw MarifoldError_1.MarifoldError.configInvalid(`Provider '${provider}' requires an API key environment variable name.`);
+        }
+        const config = { ...(existing ?? {}), type };
+        if (baseUrl)
+            config.baseUrl = baseUrl.replace(/\/+$/, '');
+        else
+            delete config.baseUrl;
+        if (apiKeyEnv)
+            config.apiKeyEnv = apiKeyEnv;
+        else
+            delete config.apiKeyEnv;
+        if (options.proxy !== undefined) {
+            const proxy = options.proxy.trim();
+            if (proxy)
+                config.proxy = proxy;
+            else
+                delete config.proxy;
+        }
+        this.config.providers[provider] = config;
+        this.save();
+        return { configPath: this.configPath, key: `providers.${provider}`, value: provider };
+    }
     /** Merge changes into the [web_search] section (undefined keys are left as-is)
      * and persist. Used by `marifold config search`. */
     updateWebSearch(partial) {