deepclause-sdk 0.0.65 → 0.0.66

package/dist/system/assets/docs/CONDUCTOR_PROMPT.md

@@ -4,32 +4,43 @@ You are **{ASSISTANT_NAME}**, an agent build using the DeepClause framework. Com
 
 ## What You Can Do
 - **Run skills** from the local catalog via `run_skill`
+- **Consult recipes** from the local recipe library via `consult_recipes`
 - **Create new skills** via `create_new_skill`
 - **Execute shell commands** via `run_bash`
 - **Research the web** via `search_web`, `search_news`, and `fetch_url`
 - **Download files** via `download_file`
 - **Evaluate math** via `calculate`
-- **Record technical learnings** via `save_memory`
 
 ## Workspace Environment
 
 You run inside the local DeepClause runtime. The exact workspace path, skill catalog, docs path, and session directory are appended below in the local runtime context.
 
+The local runtime context also includes the current session execution log path. That JSONL file accumulates structured records for conductor turns, session-scoped skill runs, child-skill events, tool calls, streamed model output, errors, and completion summaries.
+
 Shell commands (`run_bash`) execute with the workspace as the current working directory. Prefer relative paths. Verify tool availability before relying on it, and install missing packages only when the task actually needs them.
 
+Large web pages and raw HTML can blow the model context window. Treat text returned by `fetch_url` as a convenience preview, not as a safe place to dump entire docs sites or HTML pages into the next model call.
+
+When a page is likely to be large, noisy, or highly structured, prefer downloading it first and inspecting it locally with focused commands or parsers. Use `download_file` to save the page, then `run_bash` with narrow inspection commands such as `rg`, `grep`, `sed -n`, `head`, or a small Python/Node parser to extract only the relevant snippet before you continue.
+
+If you need to start a background service from `run_bash`, do not rely on a bare `command &` alone. Detach it from the tool's stdio, redirect logs, and print the PID or readiness marker, for example: `nohup python3 -m http.server 8080 >/tmp/http.log 2>&1 < /dev/null & echo $!`.
+
 If the user asks about the fullscreen CLI TUI, consult the local TUI guide in the docs directory appended below. It documents the pane layout, menus, slash commands, direct `!<command>` shell mode, skill execution, and session behavior.
 
 ## Decision Flow
 
 1. **Check your task instructions**.
 2. **If an existing skill fits** -> run it with `run_skill(slug, args)`.
-3. **If it needs code, files, or local tooling** -> use `run_bash`.
-4. **If it needs research** -> use `search_web`, `search_news`, or `fetch_url`.
-5. **If it needs a reusable automation** -> use `create_new_skill` with a detailed spec.
+3. **If the user is asking how to do something, or you need workflow/convention guidance** -> use `consult_recipes(query)`.
+4. **If the user asks to create a new recipe or update an existing recipe** -> treat it as a workspace file-editing task under `.deepclause/system/recipes/<slug>/SKILL.md`. Consult existing recipes first when helpful, then create or update the recipe markdown directly. Do **not** use `create_new_skill` for recipe authoring.
+5. **If it needs code, files, or local tooling** -> use `run_bash`.
+6. **If it needs research** -> use `search_web`, `search_news`, or `fetch_url`.
+7. **If it needs a reusable automation** -> use `create_new_skill` with a detailed spec.
+8. **If you are debugging a failure, retrying a similar task, or trying to reuse a previously working pattern** -> inspect the session execution log first with focused shell commands such as `tail`, `sed`, or `rg`, then adapt your next step based on the concrete failure or success pattern you find.
 
 ## Memory
 
-You manage **task memory**: technical learnings from task execution. After completing a task, use `save_memory` to record what worked, what failed, useful commands, error resolutions, or architectural insights that could help future runs.
+You manage **task memory**: technical learnings from task execution. When the task instructions ask for a `MemoryUpdate` output, put the COMPLETE updated task memory markdown there if the run produced useful technical learnings. If nothing technically noteworthy should be recorded, return `NONE` for that memory output.
 
 You may also receive optional **assistant memory** loaded from the session's `assistant-memory.md` file. It may be empty, and in the current CLI runtime it is not automatically maintained by a built-in conductor tool. Use it when relevant.
 
@@ -37,11 +48,15 @@ You may also receive optional **assistant memory** loaded from the session's `as
 - Work autonomously, but ask the user clarifying questions when required.
 - Report results clearly when done.
 - For `create_new_skill`, write a thorough spec covering purpose, inputs, outputs, tools, and edge cases.
+- Recipe creation and recipe updates are file-authoring tasks, not skill-creation tasks. Edit recipe markdown under `.deepclause/system/recipes/<slug>/SKILL.md` directly.
 - Forward the user's original intent faithfully.
 - Keep the final answer concise and focused on whether the task succeeded, what result was produced, or what blocked completion.
 - Only write task results to files when the user asked for files or the result is too large to present clearly inline.
 - Not every intermediate action is visible to the user.
 - Before you call any tool, briefly explain why you are using it.
+- When a task failed earlier in this session, do not guess blindly. Inspect the session execution log first, identify the relevant failing tool call, error text, or successful prior pattern, and then decide whether to retry, adjust the approach, or reuse the working pattern.
+- Prefer focused log inspection over dumping the whole file. Use recent tails and targeted searches so you can diagnose the issue or recover a known-good pattern quickly.
+- Do not paste large raw HTML or whole documentation pages back into the model unless the task truly depends on that exact text. Prefer downloaded files plus narrow local extraction.
 
 
 ## Background on Skills
@@ -57,9 +72,28 @@ When you decide a task should become a reusable capability, do **not** try to in
 Use this model:
 
 - If a matching existing skill already exists, run it with `run_skill`.
+- If you need guidance on workflow, conventions, or how to approach a task, use `consult_recipes`.
 - If the task is one-off and does not need reuse, solve it directly with the available tools.
 - If the task should become a reusable automation, call `create_new_skill` with a strong specification.
 
+## Background on Recipes
+
+Recipes are **read-only markdown instruction packs**. They are not executable DML workers.
+
+- Recipes capture workflow guidance, conventions, checklists, and examples.
+- Recipes are searched through `consult_recipes`.
+- Recipes may live in packaged defaults or in the workspace under `.deepclause/system/recipes/`.
+- Recipes are useful when you need to know *how* to approach a task, not when you need to *execute* a reusable automation.
+- A workspace recipe normally lives at `.deepclause/system/recipes/<slug>/SKILL.md`.
+- If the user asks to create or update a recipe, first inspect nearby recipes for style and structure when helpful, then edit the target recipe markdown directly.
+- Recipe requests should stay in markdown. Do **not** route them through `create_new_skill` unless the user explicitly asked for an executable skill instead of a recipe.
+
+Use this model:
+
+- **Skill**: executable DML worker for reusable automation.
+- **Recipe**: markdown guidance for process, conventions, and decision-making.
+- **Conductor**: the router that decides whether to run a skill, consult a recipe, or solve the task directly.
+
 When writing a spec for `create_new_skill`, make it concrete. Describe:
 
 - the skill's purpose

package/dist/system/assets/docs/DML_COMPILER_PROMPT.md

@@ -26,6 +26,12 @@ Work as a good companion and - if in doubt - always ask for clarification and pe
 
 Note: Skills run inside the active DeepClause shell environment. By default shell commands run in the local workspace shell. With `--sandbox`, they run inside AgentVM. For web content, use runtime tools such as `web_search`, `url_fetch`, and `news_search` instead of `curl` or `wget`.
 
+Note: In the local CLI runtime, `url_fetch` text responses may be truncated to protect the model context window. For large documentation pages, HTML, or other bulky responses, prefer `exec(url_fetch(url: URL, save_to: "tmp/page.html"), R)` and then inspect the saved file with focused local commands such as `rg`, `grep`, `sed -n`, `head`, or a small parser instead of feeding the whole page body into `task()`.
+
+Note: Recipes are not skills. If the request is actually to create or update a markdown recipe or instruction pack under `.deepclause/system/recipes/<slug>/SKILL.md`, that work should be handled by editing the recipe file directly rather than compiling a DML skill.
+
+Note: When you are iterating on a failing skill, retrying a similar execution, or trying to reuse a proven workflow pattern, inspect the relevant session `execution-log.jsonl` first when it is available. Use the concrete tool calls, streamed outputs, and error records there to diagnose what failed or to copy a working pattern instead of starting from scratch.
+
 
 </role>
 
@@ -151,8 +157,9 @@ EXACT CALLING SYNTAX AND RETURN TYPES:
 
 3. url_fetch - Fetch a web page
    Call:    exec(url_fetch(url: "https://example.com"), Result)
-   Returns: Dict with keys: body (string), status (integer), headers
+  Returns: Dict with keys: body (string), status (integer), headers, truncated (boolean), original_length (integer), returned_length (integer)
    Access:  get_dict(body, Result, Content), get_dict(status, Result, Status)
+  NOTE:    Text responses may be truncated for context safety. If you need the full page or precise snippets from a large page, save it to a file and inspect it locally.
 
    Download to file:
    Call:    exec(url_fetch(url: "https://example.com/file.csv", save_to: "data.csv"), Result)
@@ -176,7 +183,7 @@ QUICK REFERENCE TABLE:
 |-------------|---------------------------------------------|------------------------------------------------|
 | web_search  | exec(web_search(query: Q), R)               | List of {title, url, snippet}                  |
 | news_search | exec(news_search(query: Q), R)              | List of {title, url, snippet}                  |
-| url_fetch   | exec(url_fetch(url: U), R)                  | {body, status, headers}                        |
+| url_fetch   | exec(url_fetch(url: U), R)                  | {body, status, headers, truncated?, lengths?}  |
 | url_fetch   | exec(url_fetch(url: U, save_to: F), R)      | {file_path, size, status}                      |
 | bash        | exec(bash(command: C), R)                   | {success, stdout, stderr, exitCode, summary}   |
 | ask_user    | exec(ask_user(prompt: P), R)                | {user_response}                                |
@@ -237,6 +244,8 @@ atom_json_dict('[1, 2, 3]', List, []),  % List = [1, 2, 3]
 
 Use atom_json_dict/3 for structured data extraction instead of wasting an LLM call on task().
 Reserve task() for free-form text understanding, summarization, and reasoning.
+
+If `url_fetch` returns bulky HTML or documentation text, do not stuff the full `body` into `task()`. Save the page to disk and extract the smallest relevant snippet first.
 </json_parsing>
 
 <prolog_idioms>
@@ -400,7 +409,8 @@ CHOOSING THE RIGHT APPROACH
 
 | I need to...                          | Use this                                    |
 |---------------------------------------|---------------------------------------------|
-| Reason, summarize, extract, classify  | task() - let the LLM handle it              |
+| Reason, summarize, extract, classify  | task() - use the LLM when open-ended judgment is needed |
+| Follow a simple deterministic workflow| Pure Prolog + exec() - no task() needed     |
 | Read/write files                      | Prolog: open/3, write/2, close/1            |
 | Build strings                         | {Variable} interpolation or format/3        |
 | Run shell commands (grep, find, ls)   | exec(bash(command: "..."), R)               |
@@ -412,6 +422,8 @@ CHOOSING THE RIGHT APPROACH
 
 DO NOT use Python for: simple file writing - use Prolog open/3, write/2, close/1.
 DO NOT use Prolog for: complex data analysis - use Python via bash.
+It is fine for simple or deterministic skills to avoid task()/prompt() entirely.
+Use task()/prompt() only when the skill needs open-ended reasoning, summarization, extraction, classification, or free-form text generation.
 </when_to_use_what>
 
 <skill_reuse>
@@ -448,6 +460,7 @@ GENERAL GUIDELINES:
   - Use the configured workspace for persistent task files.
   - Put helper scripts, templates, prompt fixtures, and other skill-specific runtime artifacts in a dedicated `.deepclause` subfolder, typically `.deepclause/tools/<skill-slug>/`, instead of scattering them in the workspace root.
   - Reference those helper files from DML with workspace-relative paths.
+  - If a skill needs to launch a background process and continue, do not use a bare `command &` alone. Detach stdio, redirect logs, and emit the PID or readiness marker, for example: `nohup python3 -m http.server 8080 >/tmp/http.log 2>&1 < /dev/null & echo $!`.
 
 PACKAGE INSTALLATION (done by YOU, the skill creator, via bash - NOT inside DML skills):
   Python:  bash("pip install --no-cache-dir pandas numpy matplotlib")
@@ -667,7 +680,7 @@ BEFORE SUBMITTING YOUR DML CODE, VERIFY ALL OF THESE:
 [ ] 2-4 tool definitions using tool/3 with clear descriptions
 [ ] ask_user tool included if the task may need user input
 [ ] agent_main with correct number of arguments (all strings)
-[ ] system() call with clear LLM instructions
+[ ] system() call with clear LLM instructions when task()/prompt() is used
 [ ] output() before every long-running operation
 [ ] answer() at the end with descriptive message
 [ ] Fallback agent_main clause with NO LLM calls - just answer() with static error

package/dist/system/assets/index.d.ts

@@ -4,6 +4,8 @@ export type WorkspaceDocAssetName = 'tui';
 export declare function getSystemSkillAssetPath(name: SystemSkillAssetName): string;
 export declare function getSystemPromptAssetPath(name: SystemPromptAssetName): string;
 export declare function getWorkspaceDocAssetPath(name: WorkspaceDocAssetName): string;
+export declare function getPackagedRecipeAssetsDir(): string;
+export declare function getWorkspaceRecipeAssetsDir(workspaceRoot: string): string;
 export declare function getSystemAssetSourcePaths(workspaceRoot?: string): {
     conductorDml: string;
     conductorPrompt: string;

package/dist/system/assets/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/system/assets/index.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,eAAe,CAAC;AACjE,MAAM,MAAM,qBAAqB,GAAG,WAAW,GAAG,eAAe,CAAC;AAClE,MAAM,MAAM,qBAAqB,GAAG,KAAK,CAAC;AA0B1C,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAE1E;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAE5E;AASD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAE5E;AAoED,wBAAgB,yBAAyB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG;IACjE,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAOA;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,oBAAoB,EAC1B,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GACvC,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,qBAAqB,EAC3B,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GACvC,OAAO,CAAC,MAAM,CAAC,CAEjB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/system/assets/index.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,eAAe,CAAC;AACjE,MAAM,MAAM,qBAAqB,GAAG,WAAW,GAAG,eAAe,CAAC;AAClE,MAAM,MAAM,qBAAqB,GAAG,KAAK,CAAC;AA2B1C,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAE1E;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAE5E;AASD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAE5E;AAED,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD;AAED,wBAAgB,2BAA2B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEzE;AAoED,wBAAgB,yBAAyB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG;IACjE,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAOA;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,oBAAoB,EAC1B,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GACvC,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,qBAAqB,EAC3B,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GACvC,OAAO,CAAC,MAAM,CAAC,CAEjB"}

package/dist/system/assets/index.js

@@ -6,6 +6,7 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const SKILLS_DIR = join(__dirname, 'skills');
 const DOCS_DIR = join(__dirname, 'docs');
+const RECIPES_DIR = join(__dirname, 'recipes');
 const SYSTEM_OVERRIDE_DIR = '.deepclause/system';
 function getSystemSkillFileName(name) {
     switch (name) {
@@ -38,6 +39,12 @@ function getWorkspaceDocFileName(name) {
 export function getWorkspaceDocAssetPath(name) {
     return join(DOCS_DIR, getWorkspaceDocFileName(name));
 }
+export function getPackagedRecipeAssetsDir() {
+    return RECIPES_DIR;
+}
+export function getWorkspaceRecipeAssetsDir(workspaceRoot) {
+    return join(workspaceRoot, SYSTEM_OVERRIDE_DIR, 'recipes');
+}
 function getWorkspaceOverridePath(workspaceRoot, fileName) {
     return join(workspaceRoot, SYSTEM_OVERRIDE_DIR, fileName);
 }

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

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

package/dist/system/assets/recipes/deepclause-coding-workflow/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: DeepClause Coding Workflow
+description: Guidance for implementing and validating local repository changes in a DeepClause workspace.
+tags: [coding, repository, tests, docs, deepclause]
+when_to_use:
+  - implementing a feature or bug fix in the current repository
+  - updating tests and documentation alongside code changes
+  - debugging a local behavior before editing files
+when_not_to_use:
+  - purely informational web research
+  - work that should become a reusable executable skill instead of a one-off repo change
+globs: [src/**, tests/**, README.md, docs/**]
+priority: high
+---
+
+# Goal
+
+Make small, grounded repository changes with focused validation and clear outcomes.
+
+# Workflow
+
+1. Start from a concrete anchor such as a failing test, a named file, a command, or the nearest implementation surface.
+2. Read only enough nearby code to form one falsifiable local hypothesis about what should change.
+3. Prefer the smallest edit that tests that hypothesis.
+4. Run the narrowest validation that can falsify the change before widening scope.
+5. If the validation fails, repair the same slice first instead of opening new work.
+6. Update documentation when behavior, workflow, or user-visible commands changed.
+
+# When To Use
+
+Use this recipe when the task is primarily about changing repository files, adding tests, or updating documentation in a controlled way.
+
+# When Not To Use
+
+Do not use this recipe for pure research or when the right outcome is to create a reusable DML worker skill.
+
+# Examples
+
+- Implement a narrow bug fix in `src/` and validate it with one focused Vitest file.
+- Update a CLI workflow and document the changed behavior in `README.md`.
+- Add a new config seed and verify it with the corresponding init tests.
+
+# Escalation
+
+If the task repeats often or clearly represents a reusable automation, stop treating it as a one-off workflow and create a proper skill instead.

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

@@ -13,6 +13,10 @@ tool(run_skill(Slug, Args, Result), "Run an existing skill. Slug is the skill sl
 
     exec(run_skill(slug: Slug, args: Args), Result).
 
+tool(consult_recipes(Query, Result), "Search the recipe library for workflow guidance and conventions. Query is a natural-language description. Returns matching recipe metadata and content.") :-
+
+    exec(consult_recipes(query: Query, max_results: 3), Result).
+
 tool(search_web(Query, Results), "Search the web for current information. Returns search results.") :-
     exec(web_search(query: Query), Results).
 
@@ -42,29 +46,31 @@ tool(inform_user(Message, Result), "Send a status update or progress report to t
     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).
+    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.\nIf the problem appears to be an LLM/provider/API/transport failure, do not invent a speculative diagnosis.\n\nStore the user-facing response in FinalAnswer.\nStore the COMPLETE updated task memory markdown in MemoryUpdate only if this execution produced useful technical insights such as what worked, what failed, useful commands, error resolutions, or reusable lessons from a non-LLM task failure.\nIf nothing technically noteworthy should be recorded, store exactly NONE in MemoryUpdate.\nDo not call update_memory or any separate memory tool from this main task.\n\nReturn a good final answer in all non-LLM cases, including when the task is blocked.", [UserMessage]),
+    task(TaskPrompt, string(FinalAnswer), string(MemoryUpdate)),
+    maybe_update_session_memory(MemoryUpdate),
+    answer(FinalAnswer).
 
 % 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(_))
-    )),
+% Memory update is best-effort and uses the already-produced MemoryUpdate output.
+maybe_update_session_memory("NONE") :-
+    !.
+maybe_update_session_memory("none") :-
+    !.
+maybe_update_session_memory("ok") :-
+    !.
+maybe_update_session_memory("") :-
+    !.
+maybe_update_session_memory(Content) :-
+    catch(exec(update_memory(content: Content), _), _, true),
     !.
-update_session_memory(_, _).
+maybe_update_session_memory(_).

package/dist/system/runtime/catalog-recipes.d.ts

@@ -0,0 +1,24 @@
+type RecipePriority = 'low' | 'normal' | 'high';
+export interface RecipeCatalogEntry {
+    slug: string;
+    name: string;
+    description: string;
+    tags: string[];
+    whenToUse: string[];
+    whenNotToUse: string[];
+    globs: string[];
+    priority: RecipePriority;
+    content: string;
+    sourcePath: string;
+    source: 'packaged' | 'workspace';
+}
+export interface RecipeCatalogMatch extends RecipeCatalogEntry {
+    score: number;
+    matchedOn: string[];
+}
+export declare function listRecipeCatalog(workspaceRoot: string): Promise<RecipeCatalogEntry[]>;
+export declare function searchRecipeCatalog(workspaceRoot: string, query: string, options?: {
+    maxResults?: number;
+}): Promise<RecipeCatalogMatch[]>;
+export {};
+//# sourceMappingURL=catalog-recipes.d.ts.map

package/dist/system/runtime/catalog-recipes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-recipes.d.ts","sourceRoot":"","sources":["../../../src/system/runtime/catalog-recipes.ts"],"names":[],"mappings":"AAQA,KAAK,cAAc,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAYhD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,UAAU,GAAG,WAAW,CAAC;CAClC;AAED,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wBAAsB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAa5F;AAED,wBAAsB,mBAAmB,CACvC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACpC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAmB/B"}

package/dist/system/runtime/catalog-recipes.js

@@ -0,0 +1,273 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { getPackagedRecipeAssetsDir, getWorkspaceRecipeAssetsDir, } from '../assets/index.js';
+export async function listRecipeCatalog(workspaceRoot) {
+    const packaged = await readRecipeEntries(getPackagedRecipeAssetsDir(), 'packaged');
+    const workspace = await readRecipeEntries(getWorkspaceRecipeAssetsDir(workspaceRoot), 'workspace');
+    const bySlug = new Map();
+    for (const entry of packaged) {
+        bySlug.set(entry.slug, entry);
+    }
+    for (const entry of workspace) {
+        bySlug.set(entry.slug, entry);
+    }
+    return [...bySlug.values()].sort((left, right) => left.slug.localeCompare(right.slug));
+}
+export async function searchRecipeCatalog(workspaceRoot, query, options = {}) {
+    const trimmedQuery = query.trim();
+    const recipes = await listRecipeCatalog(workspaceRoot);
+    if (!trimmedQuery) {
+        return [];
+    }
+    const tokens = tokenize(trimmedQuery);
+    const matches = recipes
+        .map((recipe) => scoreRecipe(recipe, trimmedQuery, tokens))
+        .filter((recipe) => recipe !== null)
+        .sort((left, right) => {
+        if (right.score !== left.score) {
+            return right.score - left.score;
+        }
+        return left.slug.localeCompare(right.slug);
+    });
+    return matches.slice(0, Math.max(1, options.maxResults ?? 3));
+}
+async function readRecipeEntries(recipesDir, source) {
+    let entries;
+    try {
+        entries = await fs.readdir(recipesDir, { withFileTypes: true });
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return [];
+        }
+        throw error;
+    }
+    const recipes = await Promise.all(entries
+        .filter((entry) => entry.isDirectory())
+        .map(async (entry) => loadRecipeEntry(path.join(recipesDir, entry.name), entry.name, source)));
+    return recipes.filter((entry) => entry !== null);
+}
+async function loadRecipeEntry(recipeDir, slug, source) {
+    const skillPath = await findRecipeSkillPath(recipeDir);
+    if (!skillPath) {
+        return null;
+    }
+    const rawMarkdown = await fs.readFile(skillPath, 'utf8');
+    const { frontmatter, body } = parseRecipeMarkdown(rawMarkdown);
+    return {
+        slug,
+        name: frontmatter.name?.trim() || humanizeSlug(slug),
+        description: frontmatter.description?.trim() || inferDescription(body),
+        tags: normalizeStringList(frontmatter.tags),
+        whenToUse: normalizeStringList(frontmatter.when_to_use),
+        whenNotToUse: normalizeStringList(frontmatter.when_not_to_use),
+        globs: normalizeStringList(frontmatter.globs),
+        priority: normalizePriority(frontmatter.priority),
+        content: body.trim(),
+        sourcePath: skillPath,
+        source,
+    };
+}
+async function findRecipeSkillPath(recipeDir) {
+    let entries;
+    try {
+        entries = await fs.readdir(recipeDir);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return null;
+        }
+        throw error;
+    }
+    const skillFile = entries.find((entry) => /^skill\.md$/i.test(entry));
+    return skillFile ? path.join(recipeDir, skillFile) : null;
+}
+function parseRecipeMarkdown(markdown) {
+    const lines = markdown.split(/\r?\n/);
+    if (lines[0]?.trim() !== '---') {
+        return { frontmatter: {}, body: markdown };
+    }
+    const frontmatterLines = [];
+    let closingIndex = -1;
+    for (let index = 1; index < lines.length; index += 1) {
+        if (lines[index].trim() === '---') {
+            closingIndex = index;
+            break;
+        }
+        frontmatterLines.push(lines[index]);
+    }
+    if (closingIndex === -1) {
+        return { frontmatter: {}, body: markdown };
+    }
+    return {
+        frontmatter: parseFrontmatter(frontmatterLines),
+        body: lines.slice(closingIndex + 1).join('\n'),
+    };
+}
+function parseFrontmatter(lines) {
+    const frontmatter = {};
+    let currentListKey = null;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#')) {
+            continue;
+        }
+        const listStartMatch = line.match(/^\s*([a-zA-Z0-9_]+):\s*$/);
+        if (listStartMatch) {
+            currentListKey = listStartMatch[1];
+            frontmatter[currentListKey] = [];
+            continue;
+        }
+        const inlineArrayMatch = line.match(/^\s*([a-zA-Z0-9_]+):\s*\[(.*)\]\s*$/);
+        if (inlineArrayMatch) {
+            currentListKey = null;
+            frontmatter[inlineArrayMatch[1]] = inlineArrayMatch[2]
+                .split(',')
+                .map((item) => stripQuotes(item.trim()))
+                .filter((item) => item.length > 0);
+            continue;
+        }
+        const scalarMatch = line.match(/^\s*([a-zA-Z0-9_]+):\s*(.+?)\s*$/);
+        if (scalarMatch) {
+            currentListKey = null;
+            frontmatter[scalarMatch[1]] = stripQuotes(scalarMatch[2]);
+            continue;
+        }
+        const listItemMatch = line.match(/^\s*-\s*(.+?)\s*$/);
+        if (listItemMatch && currentListKey) {
+            const current = frontmatter[currentListKey];
+            if (Array.isArray(current)) {
+                current.push(stripQuotes(listItemMatch[1]));
+            }
+        }
+    }
+    return frontmatter;
+}
+function stripQuotes(value) {
+    if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+        return value.slice(1, -1);
+    }
+    return value;
+}
+function normalizeStringList(value) {
+    if (!value || value.length === 0) {
+        return [];
+    }
+    return Array.from(new Set(value
+        .map((item) => item.trim())
+        .filter((item) => item.length > 0)));
+}
+function normalizePriority(value) {
+    switch ((value ?? '').trim().toLowerCase()) {
+        case 'high':
+            return 'high';
+        case 'low':
+            return 'low';
+        default:
+            return 'normal';
+    }
+}
+function inferDescription(markdown) {
+    const lines = markdown.split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0 && !line.startsWith('#'));
+    return lines[0] ?? 'No description provided.';
+}
+function humanizeSlug(slug) {
+    return slug
+        .split(/[-_]+/)
+        .filter((part) => part.length > 0)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join(' ');
+}
+function tokenize(value) {
+    return Array.from(new Set(value
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .map((token) => token.trim())
+        .filter((token) => token.length >= 3)));
+}
+function scoreRecipe(recipe, query, tokens) {
+    const fields = {
+        slug: recipe.slug.toLowerCase(),
+        name: recipe.name.toLowerCase(),
+        description: recipe.description.toLowerCase(),
+        tags: recipe.tags.join(' ').toLowerCase(),
+        whenToUse: recipe.whenToUse.join(' ').toLowerCase(),
+        whenNotToUse: recipe.whenNotToUse.join(' ').toLowerCase(),
+        content: recipe.content.toLowerCase(),
+    };
+    const normalizedQuery = query.toLowerCase();
+    let score = priorityBonus(recipe.priority);
+    const matchedOn = new Set();
+    const strongMatchFields = new Set();
+    if (fields.slug.includes(normalizedQuery)) {
+        score += 40;
+        matchedOn.add('slug');
+        strongMatchFields.add('slug');
+    }
+    if (fields.name.includes(normalizedQuery)) {
+        score += 36;
+        matchedOn.add('name');
+        strongMatchFields.add('name');
+    }
+    if (fields.description.includes(normalizedQuery)) {
+        score += 28;
+        matchedOn.add('description');
+        strongMatchFields.add('description');
+    }
+    for (const token of tokens) {
+        if (fields.slug.includes(token)) {
+            score += 12;
+            matchedOn.add('slug');
+            strongMatchFields.add('slug');
+        }
+        if (fields.name.includes(token)) {
+            score += 10;
+            matchedOn.add('name');
+            strongMatchFields.add('name');
+        }
+        if (fields.description.includes(token)) {
+            score += 8;
+            matchedOn.add('description');
+            strongMatchFields.add('description');
+        }
+        if (fields.tags.includes(token)) {
+            score += 7;
+            matchedOn.add('tags');
+            strongMatchFields.add('tags');
+        }
+        if (fields.whenToUse.includes(token)) {
+            score += 6;
+            matchedOn.add('when_to_use');
+            strongMatchFields.add('when_to_use');
+        }
+        if (fields.whenNotToUse.includes(token)) {
+            score += 3;
+            matchedOn.add('when_not_to_use');
+        }
+        if (fields.content.includes(token)) {
+            score += 2;
+            matchedOn.add('content');
+        }
+    }
+    if (strongMatchFields.size === 0 || score <= 0) {
+        return null;
+    }
+    return {
+        ...recipe,
+        score,
+        matchedOn: [...matchedOn],
+    };
+}
+function priorityBonus(priority) {
+    switch (priority) {
+        case 'high':
+            return 3;
+        case 'normal':
+            return 1;
+        case 'low':
+            return 0;
+    }
+}
+//# sourceMappingURL=catalog-recipes.js.map