agent-devkit 0.8.3 → 0.8.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-devkit",
-  "version": "0.8.3",
+  "version": "0.8.5",
   "description": "Agent DevKit CLI and TUI runtime for specialist AI agents, capabilities and provider-aware workflows.",
   "license": "MIT",
   "type": "module",
@@ -60,6 +60,7 @@
     "@modelcontextprotocol/sdk": "^1.29.0",
     "commander": "^15.0.0",
     "ink": "^7.1.0",
+    "marked": "^18.0.5",
     "react": "^19.2.7",
     "zod": "^4.4.3"
   },

package/src/assets/prompts/core/chat.json

@@ -52,7 +52,7 @@
     {
       "id": "agent-devkit.capability-map",
       "source": "core/chat",
-      "content": "Current capability areas include project doctor/init/reset, package update, preferences, themes, aliases, personalization characters, logs, encrypted secrets, dependency inspection/planning, models, projects, sessions, conversation, runtime runs, goals and memory."
+      "content": "Current capability areas include project doctor/init/reset, package update, preferences, themes, aliases, personalization characters, logs, encrypted secrets, dependency setup/inspection/planning, provider login, models, projects, sessions, conversation, runtime runs, goals and memory."
     },
     {
       "id": "agent-devkit.memory-rule",

package/src/assets/runtime/terminal-session-runner.cjs

@@ -93,13 +93,19 @@ function createPtyTerminal() {
       : env.SHELL || process.env.SHELL || "/bin/sh";
   const args =
     process.platform === "win32" ? ["/d", "/s", "/c", session.command] : ["-lc", session.command];
-  const ptyProcess = pty.spawn(shell, args, {
-    cols: session.cols ?? 120,
-    cwd: session.cwd,
-    env,
-    name: "xterm-256color",
-    rows: session.rows ?? 30,
-  });
+  let ptyProcess;
+
+  try {
+    ptyProcess = pty.spawn(shell, args, {
+      cols: session.cols ?? 120,
+      cwd: session.cwd,
+      env,
+      name: "xterm-256color",
+      rows: session.rows ?? 30,
+    });
+  } catch {
+    return undefined;
+  }
 
   ptyProcess.onData((chunk) => appendOutput(chunk));
   ptyProcess.onExit((event) => {

package/src/modules/environment/surface/knowledge.json

@@ -1,10 +1,12 @@
 {
   "moduleId": "environment",
-  "summary": "Environment capabilities inspect the local development machine, scan supported tooling, manage tooling lifecycle plans, process variables, files and approved shell execution.",
+  "summary": "Environment capabilities inspect the local development machine, scan supported tooling, prepare dependencies, manage tooling lifecycle plans, process variables, files and approved shell execution.",
   "facts": [
     "Tools inspection can locate installed binaries and common version strings.",
     "Environment scan runs a structured read-only inventory of languages, SDKs, CLIs, frameworks, services and workspace tooling from the canonical tooling catalog.",
     "Environment tooling uses JSON definitions from assets/tooling plus local data/tooling entries to detect, doctor, install, upgrade, downgrade and uninstall supported tools.",
+    "Environment setup is the preferred orchestrator when the user wants the agent to prepare, repair, install or authenticate operational dependencies.",
+    "When a required CLI is missing, prefer environment.setup before telling the user to install it manually.",
     "Tooling lifecycle actions must plan before mutating the local environment.",
     "Learned tooling starts as a draft and must be promoted before it should be used for trusted lifecycle execution.",
     "Environment variable reads redact sensitive values unless explicitly requested.",

package/src/modules/environment/surface/prompt.json

@@ -16,6 +16,11 @@
       "template": "Summarize shell execution result with exit code, stdout, stderr and timeout status. Never hide failures: {{result}}",
       "variables": ["result"]
     },
+    {
+      "id": "environment.setup",
+      "template": "Explain this setup result as readiness, planned work, executed work and next actions. If approval is required, state exactly what permission is needed. If a CLI login requires an interactive terminal, say which command will run: {{result}}",
+      "variables": ["result"]
+    },
     {
       "id": "environment.tooling",
       "template": "Explain this tooling result. For plans, show exact commands and approval requirements. For executions, show succeeded/failed/skipped steps and the next safe action: {{result}}",

package/src/modules/environment/surface/skill.json

@@ -4,6 +4,7 @@
   "whenToUse": [
     "The user asks for a system scan, environment diagnosis, machine raio X, installed languages, CLIs, frameworks, Docker, Flutter, Dart, cloud tools or development tools.",
     "The user asks whether a required external tool, CLI, SDK, runtime or framework is installed or compatible.",
+    "The user asks the agent to configure, prepare, repair or make a provider/tool ready for use.",
     "The user asks to install, update, upgrade, downgrade, uninstall or doctor a supported CLI, SDK, runtime, service or framework.",
     "The user wants to plan installation, configuration, upgrade, downgrade, or uninstall steps for known tooling.",
     "The agent needs to verify runtime prerequisites before using a module.",

package/src/modules/runtime/surface/knowledge.json

@@ -5,6 +5,7 @@
     "Each agent chat or task run should create a run.json file.",
     "Runtime events are append-only JSON Lines entries in events.jsonl.",
     "Runtime runs audit what the agent did; they are separate from chat session memory.",
+    "Runtime diagnostics is the canonical source for explaining why an Agent DevKit run failed; use runtime.diagnostics before logs.analysis when the user asks why a run errored.",
     "Runtime goals group related runs but do not imply autonomous background execution yet."
   ]
 }

package/src/modules/runtime/surface/prompt.json

@@ -10,6 +10,11 @@
       "id": "runtime.goals",
       "template": "Explain this Agent DevKit runtime goal and its related runs: {{goal}}",
       "variables": ["goal"]
+    },
+    {
+      "id": "runtime.diagnostics",
+      "template": "Diagnose this failed Agent DevKit run using runtime events, plan state and child runs before consulting generic logs: {{diagnosis}}",
+      "variables": ["diagnosis"]
     }
   ]
 }