deepclause-sdk 0.0.58 → 0.0.60

package/dist/system/assets/index.js

@@ -0,0 +1,47 @@
+import { access, readFile } from 'fs/promises';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const SKILLS_DIR = join(__dirname, 'skills');
+const DOCS_DIR = join(__dirname, 'docs');
+const SYSTEM_OVERRIDE_DIR = '.deepclause/system';
+function getSystemSkillFileName(name) {
+    switch (name) {
+        case 'conductor':
+            return 'conductor.dml';
+        case 'skill-creator':
+            return 'skill-creator.dml';
+    }
+}
+export function getSystemSkillAssetPath(name) {
+    return join(SKILLS_DIR, getSystemSkillFileName(name));
+}
+export function getSystemPromptAssetPath(name) {
+    switch (name) {
+        case 'conductor':
+            return join(DOCS_DIR, 'CONDUCTOR_PROMPT.md');
+        case 'skill-creator':
+            return join(DOCS_DIR, 'DML_COMPILER_PROMPT.md');
+    }
+}
+async function resolveSystemSkillAssetPath(name, workspaceRoot) {
+    if (workspaceRoot) {
+        const overridePath = join(workspaceRoot, SYSTEM_OVERRIDE_DIR, getSystemSkillFileName(name));
+        try {
+            await access(overridePath);
+            return overridePath;
+        }
+        catch {
+            // Fall back to the packaged asset when no workspace override exists.
+        }
+    }
+    return getSystemSkillAssetPath(name);
+}
+export async function readSystemSkillAsset(name, options = {}) {
+    return readFile(await resolveSystemSkillAssetPath(name, options.workspaceRoot), 'utf8');
+}
+export async function readSystemPromptAsset(name) {
+    return readFile(getSystemPromptAssetPath(name), 'utf8');
+}
+//# sourceMappingURL=index.js.map

package/dist/system/assets/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/system/assets/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAKpC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AACtC,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AACzC,MAAM,mBAAmB,GAAG,oBAAoB,CAAC;AAEjD,SAAS,sBAAsB,CAAC,IAA0B;IACxD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,WAAW;YACd,OAAO,eAAe,CAAC;QACzB,KAAK,eAAe;YAClB,OAAO,mBAAmB,CAAC;IAC/B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAA0B;IAChE,OAAO,IAAI,CAAC,UAAU,EAAE,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAA2B;IAClE,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,WAAW;YACd,OAAO,IAAI,CAAC,QAAQ,EAAE,qBAAqB,CAAC,CAAC;QAC/C,KAAK,eAAe;YAClB,OAAO,IAAI,CAAC,QAAQ,EAAE,wBAAwB,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AAED,KAAK,UAAU,2BAA2B,CACxC,IAA0B,EAC1B,aAAsB;IAEtB,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,EAAE,mBAAmB,EAAE,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5F,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;YAC3B,OAAO,YAAY,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,qEAAqE;QACvE,CAAC;IACH,CAAC;IAED,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAA0B,EAC1B,UAAsC,EAAE;IAExC,OAAO,QAAQ,CAAC,MAAM,2BAA2B,CAAC,IAAI,EAAE,OAAO,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAA2B;IACrE,OAAO,QAAQ,CAAC,wBAAwB,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;AAC1D,CAAC"}

package/dist/system/assets/skills/conductor.dml

@@ -0,0 +1,70 @@
+% ============================================================================
+% Conductor (full tool set)
+% ============================================================================
+%
+% Has all tools: skills, bash, web, skill creation, etc.
+% Runs autonomously to complete the task described in its instructions.
+%
+% ============================================================================
+
+% --- Tool predicates (full tool set) ---
+
+tool(run_skill(Slug, Args, Result), "Run an existing skill. Slug is the skill slug (e.g. 'deep-research'). Args is a JSON array of string arguments. Returns the skill result.") :-
+
+    exec(run_skill(slug: Slug, args: Args), Result).
+
+tool(search_web(Query, Results), "Search the web for current information. Returns search results.") :-
+    exec(web_search(query: Query), Results).
+
+tool(search_news(Query, Results), "Search recent news articles. Returns news results.") :-
+    exec(news_search(query: Query), Results).
+
+tool(fetch_url(Url, Content), "Fetch the content of a web page by URL. Returns the page body as text.") :-
+    exec(url_fetch(url: Url), Result),
+    get_dict(body, Result, Content).
+
+tool(download_file(Url, FilePath, Size), "Download a file from a URL and save it to disk. Returns the file path and size.") :-
+    exec(url_fetch(url: Url, save_to: FilePath), Result),
+    get_dict(file_path, Result, FilePath),
+    get_dict(size, Result, Size).
+
+tool(run_bash(Command, Output), "Run a shell command in the workspace.") :-
+    exec(bash(command: Command), Output).
+
+tool(create_new_skill(Spec, Result), "Create and deploy a new reusable skill from a natural language spec.") :-
+    exec(create_skill(spec: Spec), Result).
+
+tool(ask_user(Prompt, Response), "Ask the user a clarifying question and get their response.") :-
+    exec(ask_user(prompt: Prompt), Result),
+    get_dict(user_response, Result, Response).
+
+tool(inform_user(Message, Result), "Send a status update or progress report to the user.") :-
+    output(Message),
+    Result = "ok".
+
+tool(save_memory(Content, Result), "Update task memory with technical learnings from this execution: what tools/approaches worked, what failed, useful commands, patterns discovered. Pass the COMPLETE updated memory in markdown (old + new learnings). This is technical memory - things that help future tasks.") :-
+    exec(update_memory(content: Content), Result).
+
+% --- Main entry point ---
+
+agent_main(UserMessage) :-
+    param(system_prompt, "Conductor system prompt", SysPrompt),
+    system(SysPrompt),
+    system("When using bash or similar tools, avoid dumping large outputs directly into the conversation context. Write large or uncertain outputs to temporary files first, then inspect them with focused commands such as wc, grep, head, tail, sed, or similar narrow follow-up commands so the context stays small and relevant."),
+    format(string(TaskPrompt), "Task instructions: ~w\n\nComplete this task autonomously using your tools.\n\nIf you can complete the task, do so and report the result.\nIf you are blocked by a task-specific, tool-specific, external-service, environment, permission, dependency, or data issue that is not an LLM/provider/API/transport failure, do not go silent. Diagnose the blocker and explain clearly to the user why the task could not be completed. Do not call save_memory from this main task.\nIf the problem appears to be an LLM/provider/API/transport failure, do not invent a speculative diagnosis.\n\nReturn a good final answer in all non-LLM cases, including when the task is blocked.", [UserMessage]),
+    task(TaskPrompt, string(Answer)),
+    update_session_memory(UserMessage, Answer),
+    answer(Answer).
+
+% Fallback for technical failures where the main task itself cannot run to completion
+agent_main(_) :-
+    answer("Task failed. Please try again.").
+
+% Memory update: extract technical learnings and persist to task-memory.md
+update_session_memory(UserMessage, Answer) :-
+    format(string(MemoryPrompt), "You just completed:\nTask: ~w\nResult: ~w\n\nReview the task memory in your context (technical learnings). If this execution produced useful technical insights - what worked, what failed, useful commands, error resolutions, or reusable lessons from a non-LLM task failure - call save_memory with the COMPLETE updated memory. Only use the save_memory tool and no other tools. If nothing technically noteworthy, reply 'ok'.", [UserMessage, Answer]),
+    with_tools([save_memory], (
+        task(MemoryPrompt, string(_))
+    )),
+    !.
+update_session_memory(_, _).

package/dist/system/assets/skills/skill-creator.dml

@@ -0,0 +1,182 @@
+% ============================================================================
+% _skill-creator v4 - Creates, tests, and deploys DML skills.
+%
+% Four-phase pipeline matching the DML Compiler Prompt role definition:
+%   Phase 1 - Understand & Research
+%             Clarify requirements, research dependencies, understand APIs.
+%   Phase 2 - Environment Setup
+%             Install packages, create/test helper scripts via bash.
+%   Phase 3 - DML Implementation
+%             Write DML, validate syntax, run tests - iterate until passing.
+%   Phase 4 - Deploy
+%             Ask user for permission, then deploy.
+%
+% System tools: validate_dml, test_dml, deploy_skill, write_file, bash
+% Proxied tools: web_search, news_search, url_fetch
+% Auto-augmented: ask_user
+%
+%   agent_main(SpecMarkdown)            - create new skill
+%   agent_main(SpecMarkdown, EditSlug)  - edit existing skill
+% ============================================================================
+
+% -- Tools available to the LLM during task() calls --------------------------
+
+tool(search(Query, Results),
+     "Search the web for information. Returns titles, URLs, and snippets.") :-
+    exec(web_search(query: Query), Results).
+
+tool(search_news(Query, Results),
+     "Search for recent news articles.") :-
+    exec(news_search(query: Query), Results).
+
+tool(fetch(Url, Content),
+     "Fetch a URL and return its body. Use for documentation pages, README files, API references.") :-
+    exec(url_fetch(url: Url), Result),
+    get_dict(body, Result, Content).
+
+tool(shell(Command, Result),
+     "Run a shell command on the VM. Returns dict with: success (boolean), stdout (string), stderr (string), exitCode (integer), summary (string). Use for package installation, environment checks, and helper script creation/testing. Always check the 'success' field.") :-
+    exec(bash(command: Command), Result).
+
+tool(write(Path, Content, Result),
+     "Write (or overwrite) a file in the workspace. Content is passed as a JSON string so there are NO shell escaping issues - ALWAYS use this instead of bash heredocs for writing DML and other code files. Returns dict with: success (boolean), path (string), bytes (number).") :-
+    exec(write_file(path: Path, content: Content), Result).
+
+tool(validate(DmlFile, Result),
+     "Validate DML code from a .dml file using the Prolog parser. You MUST write the DML to a file first with write(), then pass the file path. Returns dict with: valid (boolean), errors (list), warnings (list).") :-
+    exec(validate_dml(dml_file: DmlFile), Result).
+
+tool(test_run(DmlFile, Input, Result),
+     "Run a DML program from a .dml file with test input(s) to verify it works. You MUST write the DML to a file first with write(), then pass the file path. Input can be a single string (for agent_main/1) or a JSON array string like '[\"arg1\", \"arg2\"]' for multi-arg agent_main. Returns dict with: success (boolean), status (string: ok/error/completed_no_answer/failed_silently), answer (string), outputs (list), errors (list), trace (list).") :-
+    exec(test_dml(dml_file: DmlFile, test_args: Input), Result).
+
+tool(deploy(DmlFile, Spec, MetaJSON, Result),
+    "Publish a new skill to the local runtime catalog. IMPORTANT ARG ORDER: deploy(<dml file path>, <original spec markdown>, <metadata json>). The SECOND argument is the original specification text. The THIRD argument is the metadata JSON string with keys: slug, name, description, trigger_phrases (array of 3-5 phrases). Never pass a version number or boolean flag here. Returns dict with: ok (boolean), slug (string), version (number), or error (string).") :-
+    exec(deploy_skill(dml_file: DmlFile, spec_markdown: Spec, metadata_json: MetaJSON), Result).
+
+tool(deploy_update(DmlFile, Spec, MetaJSON, Slug, Result),
+    "Update an existing skill. IMPORTANT ARG ORDER: deploy_update(<dml file path>, <updated spec markdown>, <metadata json>, <existing slug>). The THIRD argument is metadata JSON; the FOURTH argument is the slug override. Never pass a version number or boolean flag. Returns dict with: ok (boolean), slug (string), version (number), or error (string).") :-
+    exec(deploy_skill(dml_file: DmlFile, spec_markdown: Spec, metadata_json: MetaJSON, slug_override: Slug), Result).
+
+tool(ask_user(Prompt, Response), "Ask the user a clarifying question or for confirmation and get their response.") :-
+    exec(ask_user(prompt: Prompt), Result),
+    get_dict(user_response, Result, Response).
+
+
+% -- Create new skill --------------------------------------------------------
+
+agent_main(SpecMarkdown) :-
+    param(system_prompt, "System prompt with DML reference", SysPrompt),
+    system(SysPrompt),
+    output("📋 Starting skill creation..."),
+
+    % -- Phase 1: Understand & Research --------------------------------------
+    output("Phase 1/4: Understanding requirements and researching dependencies..."),
+    format(string(ResearchTask),
+        "You are starting to build a DML skill from the specification below.\n\nYour job in this phase:\n1. Read the specification carefully. If anything is ambiguous or missing, use ask_user to clarify before proceeding.\n2. Identify all external dependencies (Python packages, Node modules, system tools, APIs, CLI tools).\n3. For each dependency, use search or fetch to look up installation instructions, API docs, or usage examples if you are not already familiar with them.\n4. Summarise: what the skill does, its inputs/outputs, all dependencies found, and any tricky parts.\n\nSpecification:\n---\n~w\n---\n\nStore your findings in ResearchSummary.",
+        [SpecMarkdown]),
+    task(ResearchTask, string(ResearchSummary)),
+    output(ResearchSummary),
+
+    % -- Phase 2: Environment Setup -------------------------------------------
+    output("Phase 2/4: Setting up the environment..."),
+    format(string(EnvTask),
+        "Set up the execution environment for the skill you are about to build.\n\nBased on your research:\n~w\n\nYour job in this phase:\n1. Use shell() to check what is already installed (python --version, node --version, which <tool>, pip show <pkg>, etc.).\n2. Install ALL missing packages and tools: pip install, apt-get install (always use sudo and -y), npm install -g.\n3. If the skill needs helper scripts (Python, Shell, etc.), create and smoke-test them now with shell().\n4. When you encounter errors during setup, diagnose the root cause (version mismatch, missing system lib, permissions, ...) and resolve it.\n5. Prefer the simplest approach with the fewest new dependencies when the spec does not specify.\n6. Do NOT install anything inside the DML skill itself - the skill must assume everything is pre-installed.\n\nStore a short environment summary (what was installed, what exists) in EnvSummary.",
+        [ResearchSummary]),
+    task(EnvTask, string(EnvSummary)),
+    output(EnvSummary),
+
+    % -- Phase 3: Implement, Validate, Test ----------------------------------
+    output("Phase 3/4: Writing DML, validating, and testing..."),
+    format(string(ImplTask),
+        "Write, validate, and test the DML skill.\n\nBackground:\n- Research: ~w\n- Environment: ~w\n- Original specification: ~w\n\nYour job in this phase:\n1. Write a complete DML implementation plan (tool definitions, agent_main structure, fallback clause).\n2. Write the full DML code to a .dml file using write(). NEVER use bash heredocs for DML - they mangle backslashes and special Prolog characters. NEVER pass DML as an inline string to validate or test_run.\n3. Call validate('my-skill.dml') - if there are syntax errors, fix the code using write() and re-validate until valid.\n4. Call test_run('my-skill.dml', ...) with a realistic test input - if it fails, analyse the error/trace, fix the code with write(), and re-test until passing.\n5. Keep iterating on validate -> test until the skill works correctly.\n\nStore the final .dml file path in FinalDML.",
+        [ResearchSummary, EnvSummary, SpecMarkdown]),
+    task(ImplTask, string(FinalDML)),
+    output("✅ DML implementation ready."),
+
+    % -- Phase 4: Deploy ------------------------------------------------------
+    (   param(auto_deploy, "Automatic publish mode", true)
+    ->  output("Phase 4/4: Publishing skill..."),
+        param(deployment_metadata_json, "Exact metadata JSON for automatic publishing", DeploymentMetaJSON),
+        format(string(DeployTask),
+            "You are ready to publish the skill automatically. Here is the final DML file path:\n\n~w\n\nOriginal specification:\n~w\n\nUse EXACTLY this metadata JSON string and do not modify it:\n\n~w\n\nYour job:\n1. Do NOT call ask_user. Automatic publish mode already serves as deployment approval.\n2. Call deploy() exactly once with the DML file path, the original specification, and the exact metadata JSON string shown above.\n3. Do not add, remove, or rename metadata keys.\n4. After a successful publish, end your response with a structured summary in EXACTLY this format:\n\nDEPLOY_RESULT:\n- name: <skill name>\n- slug: <skill slug>\n- trigger_phrases: <comma-separated list>\n- test_status: passed\n- deploy_status: success",
+            [FinalDML, SpecMarkdown, DeploymentMetaJSON]),
+        system("Automatic publish mode is enabled. Do not ask the user for permission. Use deployment_metadata_json exactly as provided."),
+        system("When you publish, use EXACTLY this argument order: deploy(FinalDMLPath, OriginalSpecMarkdown, MetadataJSONString). MetadataJSONString must be deployment_metadata_json without edits."),
+        task(DeployTask, string(DeployResult))
+    ;   output("Phase 4/4: Requesting deployment permission..."),
+        format(string(DeployTask),
+            "You are ready to deploy the skill. Here is the final DML file path:\n\n~w\n\nOriginal specification:\n~w\n\nYour job:\n1. Use ask_user to present a short summary of the skill (name, slug, what it does, trigger phrases you intend to use) and ask the user for permission to deploy.\n2. If the user approves (yes / ok / go ahead / etc.), call deploy() with the DML file path, the original specification, and a metadata JSON string containing: slug, name, description, trigger_phrases (3-5 phrases).\n3. If the user declines, answer with a message that the skill is ready but was not deployed, and that they can ask to deploy it later.\n4. After a successful deploy, end your response with a structured summary in EXACTLY this format:\n\nDEPLOY_RESULT:\n- name: <skill name>\n- slug: <skill slug>\n- trigger_phrases: <comma-separated list>\n- test_status: passed\n- deploy_status: success",
+            [FinalDML, SpecMarkdown]),
+        system("When you deploy, use EXACTLY this argument order: deploy(FinalDMLPath, OriginalSpecMarkdown, MetadataJSONString). Do not pass a version number, edit flag, or boolean in place of MetadataJSONString."),
+        task(DeployTask, string(DeployResult))
+    ),
+
+    format(string(Summary), "✅ Skill creation complete!\n\n~w\n\nYou can trigger this skill using one of the trigger phrases shown above.", [DeployResult]),
+    answer(Summary).
+
+% -- Fallback for create -----------------------------------------------------
+
+agent_main(SpecMarkdown) :-
+    format(string(Msg), "❌ Skill creation failed.\n\nThe skill could not be compiled, tested, or deployed from the specification provided. This can happen when:\n- The specification is ambiguous or incomplete\n- Required APIs or tools are not available\n- The DML code could not pass validation or testing after multiple attempts\n\nPlease try:\n1. Simplifying the specification\n2. Being more explicit about inputs, outputs, and logic\n3. Breaking into smaller, focused skills\n\nOriginal spec (first 200 chars): ~w", [SpecMarkdown]),
+    answer(Msg).
+
+% -- Edit existing skill -----------------------------------------------------
+
+agent_main(SpecMarkdown, EditSlug) :-
+    param(system_prompt, "System prompt with DML reference", SysPrompt),
+    system(SysPrompt),
+    format(string(Ctx), "You are editing the existing skill '~w'.", [EditSlug]),
+    system(Ctx),
+    output("📋 Starting skill update..."),
+
+    % -- Phase 1: Understand changes ------------------------------------------
+    output("Phase 1/4: Understanding required changes and dependencies..."),
+    format(string(ResearchTask),
+        "You are updating the existing DML skill '~w' from the specification below.\n\nYour job in this phase:\n1. Read the updated specification. If anything is ambiguous, use ask_user to clarify.\n2. Identify what is changing and any new dependencies introduced by the changes.\n3. Research new dependencies if needed (search, fetch).\n4. Summarise: what is changing, new dependencies if any, and any tricky parts.\n\nUpdated specification:\n---\n~w\n---\n\nStore your findings in ResearchSummary.",
+        [EditSlug, SpecMarkdown]),
+    task(ResearchTask, string(ResearchSummary)),
+    output(ResearchSummary),
+
+    % -- Phase 2: Environment Setup -------------------------------------------
+    output("Phase 2/4: Updating the environment if needed..."),
+    format(string(EnvTask),
+        "Review and update the execution environment for the skill changes.\n\nBased on your analysis:\n~w\n\nYour job:\n1. Check whether any new packages or tools need to be installed for the changes.\n2. Install anything missing via shell().\n3. Create or update any helper scripts if needed.\n4. If no environment changes are needed, confirm that with a brief note.\n\nStore an environment summary in EnvSummary.",
+        [ResearchSummary]),
+    task(EnvTask, string(EnvSummary)),
+    output(EnvSummary),
+
+    % -- Phase 3: Implement, Validate, Test ----------------------------------
+    output("Phase 3/4: Writing updated DML, validating, and testing..."),
+    format(string(ImplTask),
+        "Write, validate, and test the updated DML skill.\n\nBackground:\n- Changes summary: ~w\n- Environment: ~w\n- Updated specification: ~w\n\nYour job:\n1. Write the complete updated DML code to a .dml file using write(). NEVER use bash heredocs for DML - they mangle backslashes and special Prolog characters.\n2. Call validate('my-skill.dml') - fix any syntax errors by rewriting the file with write().\n3. Call test_run('my-skill.dml', ...) - fix any runtime failures by rewriting with write().\n4. Iterate until both validation and testing pass.\n\nStore the final .dml file path in FinalDML.",
+        [ResearchSummary, EnvSummary, SpecMarkdown]),
+    task(ImplTask, string(FinalDML)),
+    output("✅ Updated DML implementation ready."),
+
+    % -- Phase 4: Deploy -------------------------------------------------------
+    (   param(auto_deploy, "Automatic publish mode", true)
+    ->  output("Phase 4/4: Publishing update..."),
+        param(deployment_metadata_json, "Exact metadata JSON for automatic publishing", DeploymentMetaJSON),
+        format(string(DeployTask),
+            "You are ready to publish the updated skill '~w' automatically. Here is the final DML file path:\n\n~w\n\nUpdated specification:\n~w\n\nUse EXACTLY this metadata JSON string and do not modify it:\n\n~w\n\nYour job:\n1. Do NOT call ask_user. Automatic publish mode already serves as deployment approval.\n2. Call deploy_update() exactly once with the DML file path, updated specification, the exact metadata JSON shown above, and slug override '~w'.\n3. Do not add, remove, or rename metadata keys.\n4. After a successful publish, end your response with a structured summary in EXACTLY this format:\n\nDEPLOY_RESULT:\n- name: <skill name>\n- slug: ~w\n- changes: <brief summary of what changed>\n- test_status: passed\n- deploy_status: success",
+            [EditSlug, FinalDML, SpecMarkdown, DeploymentMetaJSON, EditSlug, EditSlug]),
+        system("Automatic publish mode is enabled. Do not ask the user for permission. Use deployment_metadata_json exactly as provided."),
+        system("When you publish an update, use EXACTLY this argument order: deploy_update(FinalDMLPath, UpdatedSpecMarkdown, MetadataJSONString, ExistingSlug). MetadataJSONString must be deployment_metadata_json without edits."),
+        task(DeployTask, string(DeployResult))
+    ;   output("Phase 4/4: Requesting deployment permission..."),
+        format(string(DeployTask),
+            "You are ready to deploy the updated skill '~w'. Here is the final DML file path:\n\n~w\n\nUpdated specification:\n~w\n\nYour job:\n1. Use ask_user to summarise what changed and ask the user for permission to deploy.\n2. If approved, call deploy_update() with the DML file path, spec, a metadata JSON (name, description, trigger_phrases), and slug override '~w'.\n3. If declined, answer that the update is ready but not deployed, and they can ask to deploy later.\n4. After a successful deploy, end your response with a structured summary in EXACTLY this format:\n\nDEPLOY_RESULT:\n- name: <skill name>\n- slug: ~w\n- changes: <brief summary of what changed>\n- test_status: passed\n- deploy_status: success",
+            [EditSlug, FinalDML, SpecMarkdown, EditSlug, EditSlug]),
+        system("When you deploy an update, use EXACTLY this argument order: deploy_update(FinalDMLPath, UpdatedSpecMarkdown, MetadataJSONString, ExistingSlug). Do not pass a version number or boolean flag."),
+        task(DeployTask, string(DeployResult))
+    ),
+
+    format(string(Summary), "✅ Skill '~w' updated and deployed!\n\n~w", [EditSlug, DeployResult]),
+    answer(Summary).
+
+% -- Fallback for edit --------------------------------------------------------
+
+agent_main(SpecMarkdown, EditSlug) :-
+    format(string(Msg), "❌ Skill update failed for '~w'.\n\nThe skill could not be updated from the specification provided. Please try:\n1. Simplifying the changes\n2. Providing the full updated specification\n3. Checking if the skill slug '~w' exists\n\nSpec (first 200 chars): ~w", [EditSlug, EditSlug, SpecMarkdown]),
+    answer(Msg).

package/dist/system/config/model-slots.d.ts

@@ -0,0 +1,34 @@
+export type Provider = 'openai' | 'anthropic' | 'google' | 'openrouter';
+export type ModelSlot = 'gateway' | 'run' | 'compile';
+export interface ProviderConfig {
+    apiKey?: string;
+    baseUrl?: string;
+}
+export interface SlotModelConfig {
+    models: Record<ModelSlot, string>;
+    temperatures: Record<ModelSlot, number>;
+    providers?: Partial<Record<Provider, ProviderConfig>>;
+}
+export interface ParsedModelId {
+    id: string;
+    provider: Provider;
+    model: string;
+    customProviderName?: string;
+}
+export interface ResolvedModelConfig extends ParsedModelId {
+    slot: ModelSlot;
+    temperature: number;
+    baseUrl?: string;
+    apiKey?: string;
+}
+export declare const DEFAULT_MODEL_IDS: Record<ModelSlot, string>;
+export declare const DEFAULT_TEMPERATURES: Record<ModelSlot, number>;
+export declare function normalizeModelId(modelId: string): string;
+export declare function formatModelId(modelId: string): string;
+export declare function parseModelId(modelId: string): ParsedModelId;
+export declare function resolveModelSlotConfig(config: SlotModelConfig, slot: ModelSlot, overrides?: {
+    modelId?: string;
+    temperature?: number;
+}): ResolvedModelConfig;
+export declare function buildModelOverride(model?: string, provider?: Provider): string | undefined;
+//# sourceMappingURL=model-slots.d.ts.map

package/dist/system/config/model-slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-slots.d.ts","sourceRoot":"","sources":["../../../src/system/config/model-slots.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,YAAY,CAAC;AACxE,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACxC,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAIvD,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAI1D,CAAC;AAwBF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAqCxD;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CA0B3D;AAUD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,SAAS,EACf,SAAS,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACzD,mBAAmB,CAcrB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAQ1F"}

package/dist/system/config/model-slots.js

@@ -0,0 +1,121 @@
+export const DEFAULT_MODEL_IDS = {
+    gateway: 'openai:gpt-4o',
+    run: 'openai:gpt-4o',
+    compile: 'openai:gpt-4o',
+};
+export const DEFAULT_TEMPERATURES = {
+    gateway: 0.7,
+    run: 0.7,
+    compile: 0.4,
+};
+const RUNTIME_PROVIDERS = new Set(['openai', 'anthropic', 'google', 'openrouter']);
+function inferProvider(model) {
+    if (model.startsWith('gpt-') || model.startsWith('o1') || model.startsWith('o3')) {
+        return 'openai';
+    }
+    if (model.startsWith('claude-')) {
+        return 'anthropic';
+    }
+    if (model.startsWith('gemini-')) {
+        return 'google';
+    }
+    return 'openrouter';
+}
+function normalizeOpenRouterModel(remainder) {
+    if (remainder.includes('/')) {
+        return remainder;
+    }
+    return remainder.replace(':', '/');
+}
+export function normalizeModelId(modelId) {
+    const trimmed = modelId.trim();
+    if (!trimmed) {
+        throw new Error('Invalid model id: value cannot be empty');
+    }
+    if (trimmed.startsWith('custom:')) {
+        return trimmed;
+    }
+    const colonIndex = trimmed.indexOf(':');
+    if (colonIndex > 0) {
+        const prefix = trimmed.slice(0, colonIndex).toLowerCase();
+        const remainder = trimmed.slice(colonIndex + 1);
+        if (prefix === 'custom') {
+            return `custom:${remainder}`;
+        }
+        if (RUNTIME_PROVIDERS.has(prefix)) {
+            if (prefix === 'openrouter') {
+                return `openrouter:${normalizeOpenRouterModel(remainder)}`;
+            }
+            return `${prefix}:${remainder}`;
+        }
+    }
+    const slashIndex = trimmed.indexOf('/');
+    if (slashIndex > 0) {
+        const prefix = trimmed.slice(0, slashIndex).toLowerCase();
+        const remainder = trimmed.slice(slashIndex + 1);
+        if (RUNTIME_PROVIDERS.has(prefix)) {
+            return prefix === 'openrouter'
+                ? `openrouter:${remainder}`
+                : `${prefix}:${remainder}`;
+        }
+    }
+    return `${inferProvider(trimmed)}:${trimmed}`;
+}
+export function formatModelId(modelId) {
+    return normalizeModelId(modelId);
+}
+export function parseModelId(modelId) {
+    const id = normalizeModelId(modelId);
+    const [prefix, ...rest] = id.split(':');
+    if (prefix === 'custom') {
+        const [customProviderName, ...modelParts] = rest;
+        if (!customProviderName || modelParts.length === 0) {
+            throw new Error(`Invalid custom model id: ${modelId}`);
+        }
+        return {
+            id,
+            provider: 'openai',
+            model: modelParts.join(':'),
+            customProviderName,
+        };
+    }
+    if (!RUNTIME_PROVIDERS.has(prefix) || rest.length === 0) {
+        throw new Error(`Invalid model id: ${modelId}`);
+    }
+    return {
+        id,
+        provider: prefix,
+        model: rest.join(':'),
+    };
+}
+function readCustomProviderEnv(customProviderName) {
+    const envPrefix = `LLM_PROVIDER_${customProviderName.toUpperCase().replace(/[^A-Z0-9]+/g, '_')}`;
+    return {
+        apiKey: process.env[`${envPrefix}_API_KEY`],
+        baseUrl: process.env[`${envPrefix}_BASE_URL`],
+    };
+}
+export function resolveModelSlotConfig(config, slot, overrides = {}) {
+    const parsed = parseModelId(overrides.modelId ?? config.models[slot] ?? DEFAULT_MODEL_IDS[slot]);
+    const standardProviderConfig = config.providers?.[parsed.provider] ?? {};
+    const customProviderConfig = parsed.customProviderName
+        ? readCustomProviderEnv(parsed.customProviderName)
+        : {};
+    return {
+        ...parsed,
+        slot,
+        temperature: overrides.temperature ?? config.temperatures[slot] ?? DEFAULT_TEMPERATURES[slot],
+        apiKey: customProviderConfig.apiKey ?? standardProviderConfig.apiKey,
+        baseUrl: customProviderConfig.baseUrl ?? standardProviderConfig.baseUrl,
+    };
+}
+export function buildModelOverride(model, provider) {
+    if (!model) {
+        return undefined;
+    }
+    if (provider && !model.includes(':') && !model.includes('/')) {
+        return normalizeModelId(`${provider}:${model}`);
+    }
+    return normalizeModelId(model);
+}
+//# sourceMappingURL=model-slots.js.map

package/dist/system/config/model-slots.js.map

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

package/dist/system/runtime/agentvm-manager.d.ts

@@ -0,0 +1,18 @@
+export interface ShellExecResult {
+    success: boolean;
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    summary: string;
+}
+export declare class AgentVMManager {
+    private readonly workspacePath;
+    private readonly network;
+    private vm;
+    readonly kind: "sandbox";
+    constructor(workspacePath: string, network: boolean);
+    exec(command: string, signal?: AbortSignal): Promise<ShellExecResult>;
+    dispose(): Promise<void>;
+    private getVM;
+}
+//# sourceMappingURL=agentvm-manager.d.ts.map

package/dist/system/runtime/agentvm-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentvm-manager.d.ts","sourceRoot":"","sources":["../../../src/system/runtime/agentvm-manager.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,cAAc;IAKvB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,OAAO,CAAC,EAAE,CAAwB;IAClC,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAU;gBAGhB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,OAAO;IAG7B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;IAgErE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAOhB,KAAK;CAepB"}

package/dist/system/runtime/agentvm-manager.js

@@ -0,0 +1,98 @@
+let AgentVMClass = null;
+export class AgentVMManager {
+    workspacePath;
+    network;
+    vm = null;
+    kind = 'sandbox';
+    constructor(workspacePath, network) {
+        this.workspacePath = workspacePath;
+        this.network = network;
+    }
+    async exec(command, signal) {
+        if (signal?.aborted) {
+            throw abortError(signal.reason);
+        }
+        const vm = await this.getVM();
+        const result = signal
+            ? await new Promise((resolve, reject) => {
+                let settled = false;
+                const finishResolve = (value) => {
+                    if (settled) {
+                        return;
+                    }
+                    settled = true;
+                    cleanup();
+                    resolve(value);
+                };
+                const finishReject = (error) => {
+                    if (settled) {
+                        return;
+                    }
+                    settled = true;
+                    cleanup();
+                    reject(error);
+                };
+                const cleanup = () => {
+                    signal.removeEventListener('abort', onAbort);
+                };
+                const onAbort = () => {
+                    void this.dispose().catch(() => { });
+                    finishReject(abortError(signal.reason));
+                };
+                signal.addEventListener('abort', onAbort, { once: true });
+                void vm.exec(command)
+                    .then((value) => {
+                    if (signal.aborted) {
+                        finishReject(abortError(signal.reason));
+                        return;
+                    }
+                    finishResolve(value);
+                })
+                    .catch((error) => {
+                    if (signal.aborted) {
+                        finishReject(abortError(signal.reason));
+                        return;
+                    }
+                    finishReject(error);
+                });
+            })
+            : await vm.exec(command);
+        const stdout = result.stdout ?? '';
+        const stderr = result.stderr ?? '';
+        const exitCode = result.exitCode ?? 0;
+        return {
+            success: exitCode === 0,
+            stdout,
+            stderr,
+            exitCode,
+            summary: exitCode === 0 ? 'Command completed successfully' : (stderr || `Command failed with exit code ${exitCode}`),
+        };
+    }
+    async dispose() {
+        if (this.vm) {
+            await this.vm.stop();
+            this.vm = null;
+        }
+    }
+    async getVM() {
+        if (!AgentVMClass) {
+            const mod = await import('deepclause-agentvm');
+            AgentVMClass = mod.AgentVM;
+        }
+        if (!this.vm) {
+            this.vm = new AgentVMClass({
+                network: this.network,
+                mounts: { '/workspace': this.workspacePath },
+            });
+            await this.vm.start();
+            await this.vm.exec('cd /workspace');
+        }
+        return this.vm;
+    }
+}
+function abortError(reason) {
+    return reason instanceof Error
+        ? reason
+        : Object.assign(new Error('This operation was aborted'), { name: 'AbortError' });
+}
+//# sourceMappingURL=agentvm-manager.js.map

package/dist/system/runtime/agentvm-manager.js.map

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