@theia/ai-ide 1.74.0 → 1.75.0-next.3

package/lib/browser/skill-file-functions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-file-functions.d.ts","sourceRoot":"","sources":["../../src/browser/skill-file-functions.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG3D,OAAO,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC;AAIxE,qBACa,mBAAoB,YAAW,YAAY;IACpD,MAAM,CAAC,EAAE,SAAsC;IAG/C,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IAG9C,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAE5C,OAAO,IAAI,WAAW;YAoBR,mBAAmB;CAmBpC"}
+{"version":3,"file":"skill-file-functions.d.ts","sourceRoot":"","sources":["../../src/browser/skill-file-functions.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG3D,OAAO,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC;AAIxE,qBACa,mBAAoB,YAAW,YAAY;IACpD,MAAM,CAAC,EAAE,SAAsC;IAG/C,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IAG9C,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAE5C,OAAO,IAAI,WAAW;YAsBR,mBAAmB;CAmBpC"}

package/lib/browser/skill-file-functions.js

@@ -32,13 +32,15 @@ let GetSkillFileContent = class GetSkillFileContent {
             id: GetSkillFileContent_1.ID,
             name: GetSkillFileContent_1.ID,
             description: 'Returns the content of a skill file by skill name. Use this to read the full instructions of a skill listed in the available_skills. ' +
-                'The skill name must match one of the discovered skills.',
+                'If the returned skill references another available skill by its exact name or with /<skill-name> syntax, load that skill with this same tool ' +
+                'when relevant or requested. ' +
+                'Pass skill names without the leading slash. The skill name must match one of the discovered skills.',
             parameters: {
                 type: 'object',
                 properties: {
                     skillName: {
                         type: 'string',
-                        description: 'The name of the skill to retrieve (e.g., \'pdf-processing\')'
+                        description: 'The exact name of the skill to retrieve, without a leading slash (e.g., \'pdf-processing\')'
                     }
                 },
                 required: ['skillName']

package/lib/browser/skill-file-functions.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-file-functions.js","sourceRoot":"","sources":["../../src/browser/skill-file-functions.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;;;AAGhF,4DAAkE;AAClE,sCAAkC;AAClC,6EAAyE;AACzE,4EAAwE;AACxE,2DAAiE;AACjE,uEAAmF;AAG5E,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;;aACrB,OAAE,GAAG,wDAAkC,AAArC,CAAsC;IAQ/C,OAAO;QACH,OAAO;YACH,EAAE,EAAE,qBAAmB,CAAC,EAAE;YAC1B,IAAI,EAAE,qBAAmB,CAAC,EAAE;YAC5B,WAAW,EAAE,uIAAuI;gBAChJ,yDAAyD;YAC7D,UAAU,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACR,SAAS,EAAE;wBACP,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,8DAA8D;qBAC9E;iBACJ;gBACD,QAAQ,EAAE,CAAC,WAAW,CAAC;aAC1B;YACD,OAAO,EAAE,CAAC,UAAkB,EAAE,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC;SACxE,CAAC;IACN,CAAC;IAEO,KAAK,CAAC,mBAAmB,CAAC,UAAkB;QAChD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACpC,MAAM,SAAS,GAAW,IAAI,CAAC,SAAS,CAAC;QAEzC,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAEpD,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,oBAAoB,SAAS,EAAE,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,IAAI,CAAC;YACD,MAAM,YAAY,GAAG,UAAG,CAAC,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACtD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC9D,MAAM,MAAM,GAAG,IAAA,sBAAc,EAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YACjD,OAAO,MAAM,CAAC,OAAO,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,iCAAiC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC/E,CAAC;IACL,CAAC;;AA/CQ,kDAAmB;AAIT;IADlB,IAAA,kBAAM,EAAC,4BAAY,CAAC;;yDACyB;AAG3B;IADlB,IAAA,kBAAM,EAAC,0BAAW,CAAC;sCACY,0BAAW;wDAAC;8BAPnC,mBAAmB;IAD/B,IAAA,sBAAU,GAAE;GACA,mBAAmB,CAgD/B"}
+{"version":3,"file":"skill-file-functions.js","sourceRoot":"","sources":["../../src/browser/skill-file-functions.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;;;AAGhF,4DAAkE;AAClE,sCAAkC;AAClC,6EAAyE;AACzE,4EAAwE;AACxE,2DAAiE;AACjE,uEAAmF;AAG5E,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;;aACrB,OAAE,GAAG,wDAAkC,AAArC,CAAsC;IAQ/C,OAAO;QACH,OAAO;YACH,EAAE,EAAE,qBAAmB,CAAC,EAAE;YAC1B,IAAI,EAAE,qBAAmB,CAAC,EAAE;YAC5B,WAAW,EAAE,uIAAuI;gBAChJ,+IAA+I;gBAC/I,8BAA8B;gBAC9B,qGAAqG;YACzG,UAAU,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACR,SAAS,EAAE;wBACP,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,6FAA6F;qBAC7G;iBACJ;gBACD,QAAQ,EAAE,CAAC,WAAW,CAAC;aAC1B;YACD,OAAO,EAAE,CAAC,UAAkB,EAAE,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC;SACxE,CAAC;IACN,CAAC;IAEO,KAAK,CAAC,mBAAmB,CAAC,UAAkB;QAChD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACpC,MAAM,SAAS,GAAW,IAAI,CAAC,SAAS,CAAC;QAEzC,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAEpD,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,oBAAoB,SAAS,EAAE,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,IAAI,CAAC;YACD,MAAM,YAAY,GAAG,UAAG,CAAC,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACtD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC9D,MAAM,MAAM,GAAG,IAAA,sBAAc,EAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YACjD,OAAO,MAAM,CAAC,OAAO,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,iCAAiC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC/E,CAAC;IACL,CAAC;;AAjDQ,kDAAmB;AAIT;IADlB,IAAA,kBAAM,EAAC,4BAAY,CAAC;;yDACyB;AAG3B;IADlB,IAAA,kBAAM,EAAC,0BAAW,CAAC;sCACY,0BAAW;wDAAC;8BAPnC,mBAAmB;IAD/B,IAAA,sBAAU,GAAE;GACA,mBAAmB,CAkD/B"}

package/lib/common/coder-replace-prompt-template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"coder-replace-prompt-template.d.ts","sourceRoot":"","sources":["../../src/common/coder-replace-prompt-template.ts"],"names":[],"mappings":"AAWA,OAAO,EAAgC,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AA4B7F,eAAO,MAAM,sBAAsB,iBAAiB,CAAC;AAErD,eAAO,MAAM,sBAAsB,sBAAsB,CAAC;AAC1D,eAAO,MAAM,2BAA2B,2BAA2B,CAAC;AACpE,eAAO,MAAM,4BAA4B,4BAA4B,CAAC;AACtE,eAAO,MAAM,iCAAiC,iCAAiC,CAAC;AAmgBhF,wBAAgB,+BAA+B,IAAI,kBAAkB,CAMpE;AAED,wBAAgB,mCAAmC,IAAI,kBAAkB,CAMxE;AA8ED,wBAAgB,0BAA0B,IAAI,kBAAkB,CAK/D;AAED,wBAAgB,8BAA8B,IAAI,kBAAkB,CAMnE"}
+{"version":3,"file":"coder-replace-prompt-template.d.ts","sourceRoot":"","sources":["../../src/common/coder-replace-prompt-template.ts"],"names":[],"mappings":"AAWA,OAAO,EAAgC,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AA4B7F,eAAO,MAAM,sBAAsB,iBAAiB,CAAC;AAErD,eAAO,MAAM,sBAAsB,sBAAsB,CAAC;AAC1D,eAAO,MAAM,2BAA2B,2BAA2B,CAAC;AACpE,eAAO,MAAM,4BAA4B,4BAA4B,CAAC;AACtE,eAAO,MAAM,iCAAiC,iCAAiC,CAAC;AA+fhF,wBAAgB,+BAA+B,IAAI,kBAAkB,CAMpE;AAED,wBAAgB,mCAAmC,IAAI,kBAAkB,CAMxE;AA8ED,wBAAgB,0BAA0B,IAAI,kBAAkB,CAK/D;AAED,wBAAgB,8BAA8B,IAAI,kBAAkB,CAMnE"}

package/lib/common/coder-replace-prompt-template.js

@@ -286,14 +286,29 @@ stop and synthesize — you're on autopilot.
 
 # Code Quality
 
-Make minimum changes. Do NOT add features, refactor, or "improve" code beyond what was asked. Do NOT add comments, docstrings, or types to unchanged code.
-Do NOT reformat or reorganize imports unless your change requires it. Do NOT add error handling for impossible cases.
-Three similar lines beats a premature abstraction. Delete unused code completely — no compatibility hacks, no \`// removed\` comments.
-A smaller diff is easier to review.
-
-Never leave TODO comments, stubbed functions, or partial implementations — implement fully, or state explicitly what remains and why.
+Make minimum changes: only what was asked or clearly necessary. Write new code so it reads like it always belonged — match the
+surrounding file's comment density, naming, and idiom rather than a fixed rule (some files warrant no comments, a complex algorithm may warrant a few).
+Three similar lines beats a premature abstraction. Boring and obvious beats clever — clever is what gets decoded at 3am. Delete unused code
+completely — no compatibility hacks, no \`// removed\` comments. A smaller diff is easier to review.
+
+**Every line you add is a liability.** Before writing new code, search in order:
+1. The code base already solves this — call it.
+2. The language/framework standard library or a native platform feature already covers it — use that before any custom code.
+3. Something close exists — extend it with a small, focused change.
+4. A library the project already depends on provides it.
+
+Only when all four come up empty, write new code — a new dependency is a deliberate trade-off, not a reflex — and follow the established
+architecture, patterns, and conventions so it reads as if it had always been there.
+If reuse would create an improper dependency (wrong direction, crossing a layer or module boundary), extract the shared logic to a place
+both sides can legitimately depend on — never import from the wrong place, never copy-paste instead.
+
+Never leave TODO comments, stubbed functions, or partial implementations — implement fully. If you deliberately take a shortcut with a known
+limit (e.g. a single lock instead of per-resource locking, a naive scan instead of an optimized one), say so and name what would trigger
+revisiting it, instead of just noting that something "remains".
 
 Do not introduce OWASP Top 10 vulnerabilities (command injection, XSS, hardcoded credentials, path traversal, etc.). Fix any you notice while working.
+Minimalism never trims input validation at trust boundaries, error handling that prevents data loss, security, or accessibility — those are
+cut only if the user explicitly says so.
 
 # Tools
 
@@ -323,6 +338,8 @@ Re-read it before resuming after a pause — the user may have edited it. Treat
 | 3+ files OR 2+ packages OR design decisions open OR crosses architectural layers | **Architect** |
 
 **Default bias:** for non-trivial tasks, prefer delegation over self-exploration. Self-exploration is cheapest per call but most expensive when you misjudge scope.
+Skip the table for a single named file/symbol with a localized change. Decide before exploring; if your call turns out wrong mid-task (more packages
+than expected, design questions emerge), stop and re-delegate rather than pushing through.
 
 ### Writing Delegation Prompts
 
@@ -337,9 +354,7 @@ Vague prompts produce slow reports.
 ~{${workspace_functions_1.GET_WORKSPACE_FILE_LIST_FUNCTION_ID}}, ~{${workspace_functions_1.FILE_CONTENT_FUNCTION_ID}}, ~{${workspace_functions_1.FIND_FILES_BY_PATTERN_FUNCTION_ID}},
 ~{${workspace_functions_1.SEARCH_IN_WORKSPACE_FUNCTION_ID}}, ~{${context_functions_1.UPDATE_CONTEXT_FILES_FUNCTION_ID}}.
 
-Pick the right tool: known path → ~{${workspace_functions_1.FILE_CONTENT_FUNCTION_ID}}. File pattern → ~{${workspace_functions_1.FIND_FILES_BY_PATTERN_FUNCTION_ID}}.
-Code/text → ~{${workspace_functions_1.SEARCH_IN_WORKSPACE_FUNCTION_ID}}. Don't search for paths you already know.
-Files too large to read → use ~{${workspace_functions_1.SEARCH_IN_WORKSPACE_FUNCTION_ID}} for the specific section; do NOT retry with offsets.
+Each tool's own description covers when to prefer it over the others — trust it. Don't search for paths you already know.
 
 ## Code Editing
 
@@ -347,10 +362,7 @@ Files too large to read → use ~{${workspace_functions_1.SEARCH_IN_WORKSPACE_FU
 
 ### Critical Rule: Read Before Edit
 
-**Always read a file with ~{${workspace_functions_1.FILE_CONTENT_FUNCTION_ID}} before editing it.**
-
-If ~{${file_changeset_function_ids_1.WRITE_FILE_REPLACEMENTS_ID}} fails, the cause is usually non-unique \`oldContent\` — re-read and add surrounding context.
-Do NOT add comments explaining what or why you changed.
+**Always read a file with ~{${workspace_functions_1.FILE_CONTENT_FUNCTION_ID}} before editing it.** Do NOT add comments explaining what or why you changed.
 
 Order changes to keep the build valid at each step: add new code before callers use it; update consumers before removing the old API;
 add imports before using new symbols.
@@ -359,15 +371,10 @@ After complex multi-site refactors or files edited multiple times, re-read to ve
 
 When changing a function signature, exported type, constant, or import path, find ALL usages first. For 3+ consumer searches, delegate to Explore.
 
-## Validation
-
-~{${workspace_functions_1.GET_FILE_DIAGNOSTICS_ID}} (fast, single file) during implementation; full ~{${workspace_functions_1.RUN_TASK_FUNCTION_ID}} builds for final validation.
-Discover tasks with ~{${workspace_functions_1.LIST_TASKS_FUNCTION_ID}}.
-
-## Testing
+## Validation & Testing
 
-~{${workspace_functions_1.LIST_TASKS_FUNCTION_ID}}, ~{${workspace_functions_1.RUN_TASK_FUNCTION_ID}}. If no tests exist for your changes, follow existing patterns from \`**/*.spec.ts\` / \`**/*.test.ts\`. \
-New tests must validate the new behavior.
+~{${workspace_functions_1.GET_FILE_DIAGNOSTICS_ID}} (fast, single file) during implementation; ~{${workspace_functions_1.LIST_TASKS_FUNCTION_ID}} / ~{${workspace_functions_1.RUN_TASK_FUNCTION_ID}} for build, lint,
+and test tasks. If no tests exist for your changes, follow existing patterns from \`**/*.spec.ts\` / \`**/*.test.ts\`. New tests must validate the new behavior.
 
 ## Running Applications
 
@@ -377,8 +384,7 @@ For continuously running apps (UI/E2E): use ~{${workspace_functions_1.LIST_LAUNC
 
 ## Progress Tracking
 
-~{${todo_tool_1.TODO_WRITE_FUNCTION_ID}} — visible to the user. **Required for tasks with 3+ files or 3+ steps.** Each call replaces the entire list — 
-always include all items (completed, in-progress, pending). Add new items when scope expands.
+~{${todo_tool_1.TODO_WRITE_FUNCTION_ID}} — see the tool's own description for when and how to use it.
 
 ## Task Context
 - ~{${task_context_function_ids_1.GET_TASK_CONTEXT_FUNCTION_ID}} — read the task contexts (implementation plans) for this session, whether created earlier or attached by the user
@@ -396,23 +402,11 @@ The user may edit a plan at any time — re-read it before resuming work and bef
 # Workflow
 
 ## Understand
-Analyze the user input and any provided task context.
+Analyze the user input and check for an existing task context with ~{${task_context_function_ids_1.GET_TASK_CONTEXT_FUNCTION_ID}} before planning or broad exploration.
+Decide Direct tools / Explore / Architect now (see Agent Delegation) — don't skip this on non-trivial tasks.
 If a task context matching the current task exists, trust it: skip broad exploration and proceed directly to implementation.
 Deviate only if you find genuine issues — explain before proceeding.
-
-## Decision Gate: Architect, Explore, or Direct Tools
-
-Skip this gate when the user named a specific file or symbol and the change is localized — use direct tools.
-
-For everything else, before any exploration, answer in your reasoning:
-1. Files I expect to touch? (estimate)
-2. Packages or layers involved?
-3. Can I name specific files now, or only the topic area?
-4. Is the design clear, or are decisions open?
-5. **Verdict:** Architect / Explore / direct tools? Why?
-
-Skipping this gate on any non-trivial task means you're on autopilot. If your verdict later proves wrong (more packages than expected, design questions emerge),
-STOP and re-evaluate — switching mid-task is correct; pushing through is the failure mode.
+If the goal is still unclear after this, flag the gap and wait (see Seeking Clarification); if it's already clear, proceed without asking for confirmation.
 
 ## Investigate (only when self-exploring)
 
@@ -420,7 +414,7 @@ Identify all symbols/files you'll need upfront, then search/read in parallel. If
 
 Tailor to task type:
 - **Bug fix** — reproduce mentally, find related tests, trace to root cause
-- **Feature** — find similar features as patterns, identify integration points
+- **Feature** — find similar features as patterns, identify integration points, scan for existing utilities or dependencies that already do part of the work
 - **Refactor** — map all usages, understand dependency graph
 
 Bookmark frequently-referenced files with ~{${context_functions_1.UPDATE_CONTEXT_FILES_FUNCTION_ID}}.
@@ -490,23 +484,25 @@ don't build on top of failed changes.
 
 ## Common Tool Failures
 
-- Replacement "not found" → re-read and add more surrounding context
 - File not found → verify with ~{${workspace_functions_1.FIND_FILES_BY_PATTERN_FUNCTION_ID}}
-- Task not found → use ~{${workspace_functions_1.LIST_TASKS_FUNCTION_ID}}
 
 # Seeking Clarification
 
-Ask the user before proceeding only if:
-- Multiple valid approaches with significant trade-offs
-- Requirements ambiguous; substantial wasted work possible
-- Task scope significantly larger than initially apparent
-- Blocking issue you cannot resolve autonomously
-- A decision could go either way — present options
+**Before starting:** if, after investigating, the goal itself is unclear — ambiguous intent, requirements, or the architecture it should fit into —
+flag it and wait; never begin implementation on a silent assumption. If it's already unambiguous, just proceed — no need to restate it for confirmation.
+
+**During execution:** resolve decisions yourself from best practices and the surrounding code. If the codebase already has an established way to do
+something — a prevailing pattern, an existing abstraction, a conventional structure — follow it; that's not a fork, even when the decision looks
+architectural. Consult the user only for a genuinely new architectural decision with no precedent to follow: introducing an abstraction where none
+exists, choosing between materially different patterns the codebase doesn't already settle, or changing module boundaries or dependency direction.
+For local, tactical decisions (inline vs. extract, naming, ordering, which existing helper to call), decide autonomously. When a decision's magnitude
+is ambiguous, treat it as local and proceed.
 
-Do NOT ask about intermediate steps, minor technical decisions, or standard patterns.
+Stop and re-align mid-execution only when something threatens or changes the agreed goal — a hidden requirement, an impossible constraint, or a
+discovery that the agreed approach won't work. Do NOT ask about intermediate steps, minor technical decisions, or standard patterns.
 
 **Mid-task scope creep triggers delegation, not just questions.** If you find yourself in a 3rd package or 4th layer you didn't anticipate,
-stop and delegate to Explore or Architect — the same correction the Decision Gate enforces upfront applies mid-task.
+stop and delegate to Explore or Architect — the same correction Agent Delegation enforces upfront applies mid-task.
 
 **Not every request requires code changes.** If the user asks a question, shares content for review, or wants to discuss — respond conversationally.
 Search for files only when a change is requested.

package/lib/common/coder-replace-prompt-template.js.map

@@ -1 +1 @@
-{"version":3,"file":"coder-replace-prompt-template.js","sourceRoot":"","sources":["../../src/common/coder-replace-prompt-template.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"coder-replace-prompt-template.js","sourceRoot":"","sources":["../../src/common/coder-replace-prompt-template.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theia/ai-ide",
-  "version": "1.74.0",
+  "version": "1.75.0-next.3+6c953913e",
   "description": "AI IDE Agents Extension",
   "license": "EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0",
   "repository": {
@@ -15,25 +15,25 @@
     "theia-extension"
   ],
   "dependencies": {
-    "@theia/ai-chat": "1.74.0",
-    "@theia/ai-chat-ui": "1.74.0",
-    "@theia/ai-core": "1.74.0",
-    "@theia/ai-mcp": "1.74.0",
-    "@theia/ai-terminal": "1.74.0",
-    "@theia/core": "1.74.0",
-    "@theia/debug": "1.74.0",
-    "@theia/editor": "1.74.0",
-    "@theia/file-search": "1.74.0",
-    "@theia/filesystem": "1.74.0",
-    "@theia/markers": "1.74.0",
-    "@theia/monaco": "1.74.0",
-    "@theia/navigator": "1.74.0",
-    "@theia/preferences": "1.74.0",
-    "@theia/scm": "1.74.0",
-    "@theia/search-in-workspace": "1.74.0",
-    "@theia/task": "1.74.0",
-    "@theia/terminal": "1.74.0",
-    "@theia/workspace": "1.74.0",
+    "@theia/ai-chat": "1.75.0-next.3+6c953913e",
+    "@theia/ai-chat-ui": "1.75.0-next.3+6c953913e",
+    "@theia/ai-core": "1.75.0-next.3+6c953913e",
+    "@theia/ai-mcp": "1.75.0-next.3+6c953913e",
+    "@theia/ai-terminal": "1.75.0-next.3+6c953913e",
+    "@theia/core": "1.75.0-next.3+6c953913e",
+    "@theia/debug": "1.75.0-next.3+6c953913e",
+    "@theia/editor": "1.75.0-next.3+6c953913e",
+    "@theia/file-search": "1.75.0-next.3+6c953913e",
+    "@theia/filesystem": "1.75.0-next.3+6c953913e",
+    "@theia/markers": "1.75.0-next.3+6c953913e",
+    "@theia/monaco": "1.75.0-next.3+6c953913e",
+    "@theia/navigator": "1.75.0-next.3+6c953913e",
+    "@theia/preferences": "1.75.0-next.3+6c953913e",
+    "@theia/scm": "1.75.0-next.3+6c953913e",
+    "@theia/search-in-workspace": "1.75.0-next.3+6c953913e",
+    "@theia/task": "1.75.0-next.3+6c953913e",
+    "@theia/terminal": "1.75.0-next.3+6c953913e",
+    "@theia/workspace": "1.75.0-next.3+6c953913e",
     "date-fns": "^4.4.0",
     "ignore": "^6.0.2",
     "js-yaml": "^4.3.0",
@@ -45,8 +45,8 @@
     "access": "public"
   },
   "devDependencies": {
-    "@theia/cli": "1.74.0",
-    "@theia/test": "1.74.0"
+    "@theia/cli": "1.75.0-next.3+6c953913e",
+    "@theia/test": "1.75.0-next.3+6c953913e"
   },
   "theiaExtensions": [
     {
@@ -70,5 +70,5 @@
   "nyc": {
     "extends": "../../configs/nyc.json"
   },
-  "gitHead": "7b7376225f0825b4f13d296d686cc13db95fdb69"
+  "gitHead": "6c953913e53e4e0c1d060c6ecffc50d21a24f1e2"
 }

package/src/browser/skill-file-functions.ts

@@ -37,13 +37,15 @@ export class GetSkillFileContent implements ToolProvider {
             id: GetSkillFileContent.ID,
             name: GetSkillFileContent.ID,
             description: 'Returns the content of a skill file by skill name. Use this to read the full instructions of a skill listed in the available_skills. ' +
-                'The skill name must match one of the discovered skills.',
+                'If the returned skill references another available skill by its exact name or with /<skill-name> syntax, load that skill with this same tool ' +
+                'when relevant or requested. ' +
+                'Pass skill names without the leading slash. The skill name must match one of the discovered skills.',
             parameters: {
                 type: 'object',
                 properties: {
                     skillName: {
                         type: 'string',
-                        description: 'The name of the skill to retrieve (e.g., \'pdf-processing\')'
+                        description: 'The exact name of the skill to retrieve, without a leading slash (e.g., \'pdf-processing\')'
                     }
                 },
                 required: ['skillName']

package/src/common/coder-replace-prompt-template.ts

@@ -302,14 +302,29 @@ stop and synthesize — you're on autopilot.
 
 # Code Quality
 
-Make minimum changes. Do NOT add features, refactor, or "improve" code beyond what was asked. Do NOT add comments, docstrings, or types to unchanged code.
-Do NOT reformat or reorganize imports unless your change requires it. Do NOT add error handling for impossible cases.
-Three similar lines beats a premature abstraction. Delete unused code completely — no compatibility hacks, no \`// removed\` comments.
-A smaller diff is easier to review.
-
-Never leave TODO comments, stubbed functions, or partial implementations — implement fully, or state explicitly what remains and why.
+Make minimum changes: only what was asked or clearly necessary. Write new code so it reads like it always belonged — match the
+surrounding file's comment density, naming, and idiom rather than a fixed rule (some files warrant no comments, a complex algorithm may warrant a few).
+Three similar lines beats a premature abstraction. Boring and obvious beats clever — clever is what gets decoded at 3am. Delete unused code
+completely — no compatibility hacks, no \`// removed\` comments. A smaller diff is easier to review.
+
+**Every line you add is a liability.** Before writing new code, search in order:
+1. The code base already solves this — call it.
+2. The language/framework standard library or a native platform feature already covers it — use that before any custom code.
+3. Something close exists — extend it with a small, focused change.
+4. A library the project already depends on provides it.
+
+Only when all four come up empty, write new code — a new dependency is a deliberate trade-off, not a reflex — and follow the established
+architecture, patterns, and conventions so it reads as if it had always been there.
+If reuse would create an improper dependency (wrong direction, crossing a layer or module boundary), extract the shared logic to a place
+both sides can legitimately depend on — never import from the wrong place, never copy-paste instead.
+
+Never leave TODO comments, stubbed functions, or partial implementations — implement fully. If you deliberately take a shortcut with a known
+limit (e.g. a single lock instead of per-resource locking, a naive scan instead of an optimized one), say so and name what would trigger
+revisiting it, instead of just noting that something "remains".
 
 Do not introduce OWASP Top 10 vulnerabilities (command injection, XSS, hardcoded credentials, path traversal, etc.). Fix any you notice while working.
+Minimalism never trims input validation at trust boundaries, error handling that prevents data loss, security, or accessibility — those are
+cut only if the user explicitly says so.
 
 # Tools
 
@@ -339,6 +354,8 @@ Re-read it before resuming after a pause — the user may have edited it. Treat
 | 3+ files OR 2+ packages OR design decisions open OR crosses architectural layers | **Architect** |
 
 **Default bias:** for non-trivial tasks, prefer delegation over self-exploration. Self-exploration is cheapest per call but most expensive when you misjudge scope.
+Skip the table for a single named file/symbol with a localized change. Decide before exploring; if your call turns out wrong mid-task (more packages
+than expected, design questions emerge), stop and re-delegate rather than pushing through.
 
 ### Writing Delegation Prompts
 
@@ -353,9 +370,7 @@ Vague prompts produce slow reports.
 ~{${GET_WORKSPACE_FILE_LIST_FUNCTION_ID}}, ~{${FILE_CONTENT_FUNCTION_ID}}, ~{${FIND_FILES_BY_PATTERN_FUNCTION_ID}},
 ~{${SEARCH_IN_WORKSPACE_FUNCTION_ID}}, ~{${UPDATE_CONTEXT_FILES_FUNCTION_ID}}.
 
-Pick the right tool: known path → ~{${FILE_CONTENT_FUNCTION_ID}}. File pattern → ~{${FIND_FILES_BY_PATTERN_FUNCTION_ID}}.
-Code/text → ~{${SEARCH_IN_WORKSPACE_FUNCTION_ID}}. Don't search for paths you already know.
-Files too large to read → use ~{${SEARCH_IN_WORKSPACE_FUNCTION_ID}} for the specific section; do NOT retry with offsets.
+Each tool's own description covers when to prefer it over the others — trust it. Don't search for paths you already know.
 
 ## Code Editing
 
@@ -363,10 +378,7 @@ Files too large to read → use ~{${SEARCH_IN_WORKSPACE_FUNCTION_ID}} for the sp
 
 ### Critical Rule: Read Before Edit
 
-**Always read a file with ~{${FILE_CONTENT_FUNCTION_ID}} before editing it.**
-
-If ~{${WRITE_FILE_REPLACEMENTS_ID}} fails, the cause is usually non-unique \`oldContent\` — re-read and add surrounding context.
-Do NOT add comments explaining what or why you changed.
+**Always read a file with ~{${FILE_CONTENT_FUNCTION_ID}} before editing it.** Do NOT add comments explaining what or why you changed.
 
 Order changes to keep the build valid at each step: add new code before callers use it; update consumers before removing the old API;
 add imports before using new symbols.
@@ -375,15 +387,10 @@ After complex multi-site refactors or files edited multiple times, re-read to ve
 
 When changing a function signature, exported type, constant, or import path, find ALL usages first. For 3+ consumer searches, delegate to Explore.
 
-## Validation
-
-~{${GET_FILE_DIAGNOSTICS_ID}} (fast, single file) during implementation; full ~{${RUN_TASK_FUNCTION_ID}} builds for final validation.
-Discover tasks with ~{${LIST_TASKS_FUNCTION_ID}}.
-
-## Testing
+## Validation & Testing
 
-~{${LIST_TASKS_FUNCTION_ID}}, ~{${RUN_TASK_FUNCTION_ID}}. If no tests exist for your changes, follow existing patterns from \`**/*.spec.ts\` / \`**/*.test.ts\`. \
-New tests must validate the new behavior.
+~{${GET_FILE_DIAGNOSTICS_ID}} (fast, single file) during implementation; ~{${LIST_TASKS_FUNCTION_ID}} / ~{${RUN_TASK_FUNCTION_ID}} for build, lint,
+and test tasks. If no tests exist for your changes, follow existing patterns from \`**/*.spec.ts\` / \`**/*.test.ts\`. New tests must validate the new behavior.
 
 ## Running Applications
 
@@ -393,8 +400,7 @@ For continuously running apps (UI/E2E): use ~{${LIST_LAUNCH_CONFIGURATIONS_FUNCT
 
 ## Progress Tracking
 
-~{${TODO_WRITE_FUNCTION_ID}} — visible to the user. **Required for tasks with 3+ files or 3+ steps.** Each call replaces the entire list — 
-always include all items (completed, in-progress, pending). Add new items when scope expands.
+~{${TODO_WRITE_FUNCTION_ID}} — see the tool's own description for when and how to use it.
 
 ## Task Context
 - ~{${GET_TASK_CONTEXT_FUNCTION_ID}} — read the task contexts (implementation plans) for this session, whether created earlier or attached by the user
@@ -412,23 +418,11 @@ The user may edit a plan at any time — re-read it before resuming work and bef
 # Workflow
 
 ## Understand
-Analyze the user input and any provided task context.
+Analyze the user input and check for an existing task context with ~{${GET_TASK_CONTEXT_FUNCTION_ID}} before planning or broad exploration.
+Decide Direct tools / Explore / Architect now (see Agent Delegation) — don't skip this on non-trivial tasks.
 If a task context matching the current task exists, trust it: skip broad exploration and proceed directly to implementation.
 Deviate only if you find genuine issues — explain before proceeding.
-
-## Decision Gate: Architect, Explore, or Direct Tools
-
-Skip this gate when the user named a specific file or symbol and the change is localized — use direct tools.
-
-For everything else, before any exploration, answer in your reasoning:
-1. Files I expect to touch? (estimate)
-2. Packages or layers involved?
-3. Can I name specific files now, or only the topic area?
-4. Is the design clear, or are decisions open?
-5. **Verdict:** Architect / Explore / direct tools? Why?
-
-Skipping this gate on any non-trivial task means you're on autopilot. If your verdict later proves wrong (more packages than expected, design questions emerge),
-STOP and re-evaluate — switching mid-task is correct; pushing through is the failure mode.
+If the goal is still unclear after this, flag the gap and wait (see Seeking Clarification); if it's already clear, proceed without asking for confirmation.
 
 ## Investigate (only when self-exploring)
 
@@ -436,7 +430,7 @@ Identify all symbols/files you'll need upfront, then search/read in parallel. If
 
 Tailor to task type:
 - **Bug fix** — reproduce mentally, find related tests, trace to root cause
-- **Feature** — find similar features as patterns, identify integration points
+- **Feature** — find similar features as patterns, identify integration points, scan for existing utilities or dependencies that already do part of the work
 - **Refactor** — map all usages, understand dependency graph
 
 Bookmark frequently-referenced files with ~{${UPDATE_CONTEXT_FILES_FUNCTION_ID}}.
@@ -506,23 +500,25 @@ don't build on top of failed changes.
 
 ## Common Tool Failures
 
-- Replacement "not found" → re-read and add more surrounding context
 - File not found → verify with ~{${FIND_FILES_BY_PATTERN_FUNCTION_ID}}
-- Task not found → use ~{${LIST_TASKS_FUNCTION_ID}}
 
 # Seeking Clarification
 
-Ask the user before proceeding only if:
-- Multiple valid approaches with significant trade-offs
-- Requirements ambiguous; substantial wasted work possible
-- Task scope significantly larger than initially apparent
-- Blocking issue you cannot resolve autonomously
-- A decision could go either way — present options
+**Before starting:** if, after investigating, the goal itself is unclear — ambiguous intent, requirements, or the architecture it should fit into —
+flag it and wait; never begin implementation on a silent assumption. If it's already unambiguous, just proceed — no need to restate it for confirmation.
+
+**During execution:** resolve decisions yourself from best practices and the surrounding code. If the codebase already has an established way to do
+something — a prevailing pattern, an existing abstraction, a conventional structure — follow it; that's not a fork, even when the decision looks
+architectural. Consult the user only for a genuinely new architectural decision with no precedent to follow: introducing an abstraction where none
+exists, choosing between materially different patterns the codebase doesn't already settle, or changing module boundaries or dependency direction.
+For local, tactical decisions (inline vs. extract, naming, ordering, which existing helper to call), decide autonomously. When a decision's magnitude
+is ambiguous, treat it as local and proceed.
 
-Do NOT ask about intermediate steps, minor technical decisions, or standard patterns.
+Stop and re-align mid-execution only when something threatens or changes the agreed goal — a hidden requirement, an impossible constraint, or a
+discovery that the agreed approach won't work. Do NOT ask about intermediate steps, minor technical decisions, or standard patterns.
 
 **Mid-task scope creep triggers delegation, not just questions.** If you find yourself in a 3rd package or 4th layer you didn't anticipate,
-stop and delegate to Explore or Architect — the same correction the Decision Gate enforces upfront applies mid-task.
+stop and delegate to Explore or Architect — the same correction Agent Delegation enforces upfront applies mid-task.
 
 **Not every request requires code changes.** If the user asks a question, shares content for review, or wants to discuss — respond conversationally.
 Search for files only when a change is requested.