@kendoo.agentdesk/agentdesk 0.32.0 → 0.33.0

package/cli/prompt.mjs

@@ -42,16 +42,9 @@ export function loadProjectMemory(cwd) {
   return "";
 }
 
-export const MEMORY_INSTRUCTIONS = `
-## Project Memory
+// Notes earlier teams wrote by hand into .agentdesk/memory.md. Still shown,
+// no longer written: lessons are recorded by the engine from the SUMMARY
+// handoff (cli/engine/lessons.mjs), each with its source and a status.
+export const LEGACY_NOTES_HEADER = `## LEGACY PROJECT NOTES (read-only)
 
-The team has a shared memory file at \`.agentdesk/memory.md\` for storing learnings that should persist across sessions. This is LOCAL and gitignored — it never leaves this machine.
-
-**When to save**: After discovering something non-obvious that cost time (test setup steps, required seed data, login credentials for test env, workarounds, environment quirks, deployment steps). If you had to figure it out, save it so you don't have to next time.
-
-**When NOT to save**: Code patterns, architecture, or anything derivable from the codebase. Don't duplicate what's already in README or CLAUDE.md.
-
-**Format**: Use clear markdown sections. Update existing sections rather than appending duplicates. Never store real secrets — reference env vars instead (e.g. \`$TEST_ADMIN_PASSWORD\`).
-
-**How**: Use the Edit or Write tool on \`.agentdesk/memory.md\`. Create the file if it doesn't exist.
-`.trim();
+Notes earlier teams left by hand in \`.agentdesk/memory.md\`. Treat them as hints to verify, not as facts. Do not edit that file — lessons are now recorded by the engine from the SUMMARY handoff (\`lessons\` / \`retireLessons\`).`;

package/cli/session-queue.mjs

@@ -7,7 +7,7 @@ export function sessionLimit(value = process.env.AGENTDESK_MAX_SESSIONS) {
 
 // Capacity belongs to the daemon, not the network connection or UI status.
 // Hold reservations through confirmation, cancellation and engine teardown.
-export function createSessionQueue({ limit = sessionLimit(), run, onQueued = () => {}, onError = () => {} }) {
+export function createSessionQueue({ limit = sessionLimit(), run, onQueued = () => {}, onError = () => {}, onSettled = () => {} }) {
   const active = new Map();
   const waiting = [];
   let closed = false;
@@ -20,6 +20,7 @@ export function createSessionQueue({ limit = sessionLimit(), run, onQueued = ()
       active.set(job.sessionId, job);
       Promise.resolve().then(() => run(job)).catch(error => onError(job, error)).finally(() => {
         active.delete(job.sessionId);
+        onSettled(job);
         drain();
       });
     }
@@ -39,6 +40,7 @@ export function createSessionQueue({ limit = sessionLimit(), run, onQueued = ()
       waiting.splice(index, 1);
       return true;
     },
+    get(sessionId) { return active.get(sessionId) || waiting.find(job => job.sessionId === sessionId); },
     get activeIds() { return [...active.keys()]; },
     get queuedIds() { return waiting.map(job => job.sessionId); },
     close() { closed = true; waiting.length = 0; },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kendoo.agentdesk/agentdesk",
-  "version": "0.32.0",
+  "version": "0.33.0",
   "description": "AI team orchestrator for Claude Code — run collaborative agent sessions from your terminal",
   "type": "module",
   "bin": {
@@ -22,7 +22,9 @@
     "server": "node server/index.mjs",
     "build": "vite build",
     "preview": "vite preview",
-    "test": "node --test tests/server.test.mjs tests/agents.test.mjs tests/homepage.test.mjs tests/sessionUtils.test.mjs tests/tracker-url.test.mjs tests/session-preflight.test.mjs tests/access.test.mjs tests/project-ownership.test.mjs tests/random-hex.test.mjs tests/projects-registry.test.mjs tests/phase-loop.test.mjs tests/proc.test.mjs tests/crypto.test.mjs tests/dotenv.test.mjs tests/update-check.test.mjs tests/setup-helpers.test.mjs tests/project-key.test.mjs tests/tracker-project.test.mjs tests/tracker-check.test.mjs tests/config.test.mjs tests/engine-env.test.mjs tests/engine-events.test.mjs tests/engine-verdict.test.mjs tests/engine-hooks.test.mjs tests/engine-agents.test.mjs tests/session-isolation.test.mjs tests/engine-session.test.mjs tests/engine-prompts.test.mjs tests/engine-schemas.test.mjs tests/engine-claude-auth.test.mjs tests/worktrees.test.mjs tests/workspaces-api.test.mjs tests/engine-outcome.test.mjs tests/session-outcomes.test.mjs tests/outcome-hydration.test.mjs tests/mobile-outcomes.test.mjs tests/session-queue.test.mjs tests/useFollowScroll.test.mjs tests/session-usage.test.mjs tests/task-lookup.test.mjs tests/engine-evidence.test.mjs tests/engine-handoff.test.mjs tests/engine-team-profile.test.mjs tests/project-settings.test.mjs tests/delivery.test.mjs tests/feed-view.test.mjs",
+    "test:sdk-handoff": "node --test --test-concurrency=1 --test-reporter=spec tests/engine-sdk-handoff.smoke.mjs",
+    "test:sdk-leadership": "node --test --test-concurrency=1 --test-reporter=spec tests/engine-sdk-leadership.smoke.mjs",
+    "test": "node --test tests/server.test.mjs tests/agents.test.mjs tests/homepage.test.mjs tests/sessionUtils.test.mjs tests/tracker-url.test.mjs tests/session-preflight.test.mjs tests/access.test.mjs tests/project-ownership.test.mjs tests/random-hex.test.mjs tests/projects-registry.test.mjs tests/phase-loop.test.mjs tests/proc.test.mjs tests/crypto.test.mjs tests/dotenv.test.mjs tests/update-check.test.mjs tests/setup-helpers.test.mjs tests/project-key.test.mjs tests/tracker-project.test.mjs tests/tracker-check.test.mjs tests/config.test.mjs tests/engine-env.test.mjs tests/engine-events.test.mjs tests/engine-verdict.test.mjs tests/engine-hooks.test.mjs tests/engine-commands.test.mjs tests/engine-agents.test.mjs tests/session-isolation.test.mjs tests/engine-session.test.mjs tests/engine-prompts.test.mjs tests/engine-schemas.test.mjs tests/engine-claude-auth.test.mjs tests/worktrees.test.mjs tests/workspaces-api.test.mjs tests/engine-outcome.test.mjs tests/session-outcomes.test.mjs tests/outcome-hydration.test.mjs tests/mobile-outcomes.test.mjs tests/session-queue.test.mjs tests/useFollowScroll.test.mjs tests/session-usage.test.mjs tests/task-lookup.test.mjs tests/engine-evidence.test.mjs tests/engine-handoff.test.mjs tests/engine-team-profile.test.mjs tests/project-settings.test.mjs tests/delivery.test.mjs tests/feed-view.test.mjs tests/recovery.test.mjs tests/session-recovery-api.test.mjs tests/engine-lessons.test.mjs",
     "test:coverage": "node --test --experimental-test-coverage --test-coverage-include='cli/**' --test-coverage-include='server/**' --test-coverage-lines=60 --test-coverage-branches=62 tests/*.test.mjs",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",

package/shared/recovery.mjs

@@ -0,0 +1,28 @@
+// Public recovery state contains no credentials or raw tool responses.
+export const RECOVERY_STATES = new Set(["running", "recovering", "pausing", "paused", "waiting_access", "waiting_input"]);
+
+export function classifyFailure(text = "", code = "") {
+  const detail = `${code} ${text}`;
+  if (/401|oauth.*revoked|failed to authenticate|not.logged.in|authentication|invalid.api.key/i.test(detail)) {
+    return { state: "waiting_access", kind: "authentication", message: "The model connection needs attention. Work has been preserved. Reconnect on the daemon machine, then verify and resume." };
+  }
+  if (/permission|not.allowed|denied|403/i.test(detail)) {
+    return { state: "waiting_access", kind: "permission", message: "A required operation was denied. Check project access or correct the instructions, then retry." };
+  }
+  if (/handoff|structured/i.test(detail)) {
+    return { state: "waiting_input", kind: "handoff", message: "The phase handoff could not be recovered. Review the preserved findings before retrying." };
+  }
+  return { state: "waiting_input", kind: "execution", message: "Work paused after an execution failure. Review the details, correct instructions or the environment, then retry." };
+}
+
+export function normalizeRecovery(value) {
+  if (!value || !RECOVERY_STATES.has(value.state)) return null;
+  return {
+    state: value.state,
+    kind: String(value.kind || "execution").slice(0, 60),
+    message: String(value.message || "").slice(0, 1500),
+    phase: String(value.phase || "").slice(0, 30),
+    ready: value.ready === true,
+    updatedAt: Date.now(),
+  };
+}

package/shared/session-status.mjs

@@ -1,6 +1,6 @@
 // Running consumes execution capacity. Open also includes queued work and a
 // human handoff: neither may disappear through generic inactive cleanup.
 export const RUNNING_SESSION_STATUSES = new Set(["active", "stale"]);
-export const OPEN_SESSION_STATUSES = new Set(["queued", "active", "stale", "handoff"]);
+export const OPEN_SESSION_STATUSES = new Set(["queued", "active", "stale", "handoff", "paused"]);
 export const isRunningSession = status => RUNNING_SESSION_STATUSES.has(status);
 export const isOpenSession = status => OPEN_SESSION_STATUSES.has(status);