zam-core 0.10.2 → 0.10.3

package/dist/cli/commands/mcp.js

@@ -6810,7 +6810,7 @@ var init_kernel = __esm({
 // src/cli/commands/mcp.ts
 init_kernel();
 import { existsSync as existsSync17, readFileSync as readFileSync15 } from "fs";
-import { dirname as dirname7, join as join20 } from "path";
+import { dirname as dirname8, join as join21 } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 import {
   RESOURCE_MIME_TYPE,
@@ -9438,15 +9438,76 @@ async function updateCheck(params) {
   });
 }
 
+// src/cli/ui-intent.ts
+import { mkdir, readFile, rename, writeFile } from "fs/promises";
+import { homedir as homedir9 } from "os";
+import { dirname as dirname6, join as join14 } from "path";
+import { ulid as ulid9 } from "ulid";
+function getUiIntentPath(home = homedir9()) {
+  return join14(home, ".zam", "ui-intent.json");
+}
+function getUiHostRegistrationPath(home = homedir9()) {
+  return join14(home, ".zam", "vscode-host.json");
+}
+function compactStringInput(input) {
+  return Object.fromEntries(
+    Object.entries(input).filter(
+      (entry) => typeof entry[1] === "string"
+    )
+  );
+}
+async function writeUiIntent(app, input = {}, opts = {}) {
+  const path = opts.path ?? process.env.ZAM_UI_INTENT_PATH ?? getUiIntentPath();
+  const id = opts.id ?? ulid9();
+  const intent = {
+    version: 1,
+    id,
+    app,
+    input: compactStringInput(input),
+    createdAt: (opts.now ?? (() => /* @__PURE__ */ new Date()))().toISOString()
+  };
+  const tempPath = join14(dirname6(path), `.ui-intent-${process.pid}-${id}.tmp`);
+  await mkdir(dirname6(path), { recursive: true });
+  await writeFile(tempPath, `${JSON.stringify(intent, null, 2)}
+`, "utf8");
+  await rename(tempPath, path);
+  return intent;
+}
+async function publishUiIntent(app, input = {}, opts = {}) {
+  try {
+    if (process.env.ZAM_DISABLE_UI_INTENT === "1") return void 0;
+    const explicitPath = opts.path ?? process.env.ZAM_UI_INTENT_PATH;
+    if (explicitPath) {
+      return await writeUiIntent(app, input, { ...opts, path: explicitPath });
+    }
+    const now = (opts.now ?? (() => /* @__PURE__ */ new Date()))();
+    const registrationPath = opts.hostRegistrationPath ?? getUiHostRegistrationPath();
+    const registration = JSON.parse(
+      await readFile(registrationPath, "utf8")
+    );
+    const updatedAt = Date.parse(registration.updatedAt ?? "");
+    if (registration.version !== 1 || typeof registration.intentPath !== "string" || !Number.isFinite(updatedAt) || now.getTime() - updatedAt > 15e3) {
+      return void 0;
+    }
+    return await writeUiIntent(app, input, {
+      ...opts,
+      path: registration.intentPath,
+      now: () => now
+    });
+  } catch {
+    return void 0;
+  }
+}
+
 // src/cli/commands/bridge.ts
 init_kernel();
 import { execFileSync as execFileSync3 } from "child_process";
 import { randomBytes as randomBytes2 } from "crypto";
 import { existsSync as existsSync16, readdirSync as readdirSync2, readFileSync as readFileSync14, rmSync as rmSync3 } from "fs";
-import { homedir as homedir10, tmpdir as tmpdir3 } from "os";
-import { join as join19, resolve as resolve4 } from "path";
+import { homedir as homedir11, tmpdir as tmpdir3 } from "os";
+import { join as join20, resolve as resolve4 } from "path";
 import { Command } from "commander";
-import { ulid as ulid9 } from "ulid";
+import { ulid as ulid10 } from "ulid";
 
 // src/cli/adapters/source-reader.ts
 import dns from "dns";
@@ -9589,8 +9650,8 @@ async function readImageOCR(db, imagePath) {
 // src/cli/agent-harness.ts
 import { spawn as spawn2 } from "child_process";
 import { existsSync as existsSync14, readFileSync as readFileSync11 } from "fs";
-import { homedir as homedir9 } from "os";
-import { join as join15 } from "path";
+import { homedir as homedir10 } from "os";
+import { join as join16 } from "path";
 
 // src/cli/terminal-open.ts
 import { execFileSync as execFileSync2, execSync as execSync4 } from "child_process";
@@ -9602,7 +9663,7 @@ import {
   writeFileSync as writeFileSync7
 } from "fs";
 import { tmpdir } from "os";
-import { basename as basename3, delimiter, extname, isAbsolute, join as join14 } from "path";
+import { basename as basename3, delimiter, extname, isAbsolute, join as join15 } from "path";
 function isPowerShellShell(shell) {
   return shell === "pwsh" || shell === "powershell";
 }
@@ -9675,7 +9736,7 @@ function findExecutable(command) {
   const pathEntries = (process.env.PATH ?? "").split(delimiter).map((entry) => entry.trim()).filter(Boolean);
   for (const entry of pathEntries) {
     for (const name of windowsExecutableNames(normalized)) {
-      const candidate = join14(entry, name);
+      const candidate = join15(entry, name);
       if (executableExists(candidate)) matches.push(candidate);
     }
   }
@@ -9713,7 +9774,7 @@ end tell` : `tell application "Terminal"
   activate
   do script "${escaped}"
 end tell`;
-  const tmpFile = join14(tmpdir(), `zam-terminal-${label}.scpt`);
+  const tmpFile = join15(tmpdir(), `zam-terminal-${label}.scpt`);
   try {
     writeFileSync7(tmpFile, appleScript);
     execSync4(`osascript ${JSON.stringify(tmpFile)}`, { stdio: "ignore" });
@@ -9794,6 +9855,18 @@ function openTerminalWindow(opts) {
 }
 
 // src/cli/agent-harness.ts
+var ANTIGRAVITY_IDE_CANDIDATE_PATHS = {
+  darwin: [
+    join16(
+      homedir10(),
+      ".antigravity-ide",
+      "antigravity-ide",
+      "bin",
+      "antigravity-ide"
+    ),
+    "/Applications/Antigravity IDE.app/Contents/Resources/app/bin/antigravity-ide"
+  ]
+};
 var AGENT_HARNESSES = [
   { id: "claude-code", label: "Claude Code", kind: "cli", command: "claude" },
   { id: "codex", label: "Codex", kind: "cli", command: "codex" },
@@ -9805,7 +9878,7 @@ var AGENT_HARNESSES = [
     command: "cursor",
     candidatePaths: {
       win32: [
-        join15(homedir9(), "AppData", "Local", "Programs", "cursor", "Cursor.exe")
+        join16(homedir10(), "AppData", "Local", "Programs", "cursor", "Cursor.exe")
       ],
       darwin: ["/Applications/Cursor.app/Contents/MacOS/Cursor"]
     }
@@ -9815,19 +9888,41 @@ var AGENT_HARNESSES = [
     id: "antigravity",
     label: "Antigravity",
     kind: "app",
-    command: "antigravity"
+    command: "antigravity",
+    candidatePaths: {
+      darwin: [
+        ...ANTIGRAVITY_IDE_CANDIDATE_PATHS.darwin ?? [],
+        "/Applications/Antigravity.app/Contents/MacOS/Antigravity"
+      ]
+    }
   },
   { id: "goose", label: "goose", kind: "cli", command: "goose" }
 ];
 function getHarness(id) {
   return AGENT_HARNESSES.find((h) => h.id === id);
 }
+function resolveAntigravityIdeExecutable(deps = {}) {
+  const find = deps.find ?? findExecutable;
+  const exists = deps.exists ?? existsSync14;
+  const platform = deps.platform ?? process.platform;
+  const found = find("antigravity-ide");
+  if (found) return found;
+  return ANTIGRAVITY_IDE_CANDIDATE_PATHS[platform]?.find((path) => exists(path)) ?? null;
+}
 function resolveHarnessExecutable(harness, overrideCommand, deps = {}) {
   const find = deps.find ?? findExecutable;
   const exists = deps.exists ?? existsSync14;
   const platform = deps.platform ?? process.platform;
   const found = find(overrideCommand || harness.command);
   if (found) return found;
+  if (!overrideCommand && harness.id === "antigravity") {
+    const foundIde = resolveAntigravityIdeExecutable({
+      find,
+      exists,
+      platform
+    });
+    if (foundIde) return foundIde;
+  }
   if (harness.kind === "app") {
     for (const candidate of harness.candidatePaths?.[platform] ?? []) {
       if (exists(candidate)) return candidate;
@@ -12540,7 +12635,7 @@ init_kernel();
 import { randomBytes } from "crypto";
 import { readFileSync as readFileSync12 } from "fs";
 import { tmpdir as tmpdir2 } from "os";
-import { basename as basename4, join as join16 } from "path";
+import { basename as basename4, join as join17 } from "path";
 var LANGUAGE_NAMES2 = {
   en: "English",
   de: "German",
@@ -12578,7 +12673,7 @@ async function observeUiSnapshotViaLLM(db, input) {
   if (isVideo) {
     const { mkdirSync: mkdirSync12, readdirSync: readdirSync3, rmSync: rmSync4 } = await import("fs");
     const { execSync: execSync5 } = await import("child_process");
-    const tempDir = join16(
+    const tempDir = join17(
       tmpdir2(),
       `zam-frames-${randomBytes(4).toString("hex")}`
     );
@@ -12611,7 +12706,7 @@ async function observeUiSnapshotViaLLM(db, input) {
         }
       }
       for (const file of sampledFiles) {
-        const bytes = readFileSync12(join16(tempDir, file));
+        const bytes = readFileSync12(join17(tempDir, file));
         imageUrls.push(`data:image/png;base64,${bytes.toString("base64")}`);
       }
     } finally {
@@ -13096,27 +13191,27 @@ import {
   symlinkSync,
   writeFileSync as writeFileSync8
 } from "fs";
-import { basename as basename5, dirname as dirname6, join as join17 } from "path";
+import { basename as basename5, dirname as dirname7, join as join18 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 var packageRoot = [
   fileURLToPath3(new URL("../..", import.meta.url)),
   fileURLToPath3(new URL("../../..", import.meta.url))
-].find((candidate) => existsSync15(join17(candidate, "package.json"))) ?? fileURLToPath3(new URL("../..", import.meta.url));
+].find((candidate) => existsSync15(join18(candidate, "package.json"))) ?? fileURLToPath3(new URL("../..", import.meta.url));
 var ALL_SETUP_AGENTS = ["claude", "copilot", "codex", "agent"];
 var SKILL_PAIRS = [
   {
-    from: join17(packageRoot, ".claude", "skills", "zam", "SKILL.md"),
-    to: join17(".claude", "skills", "zam", "SKILL.md"),
+    from: join18(packageRoot, ".claude", "skills", "zam", "SKILL.md"),
+    to: join18(".claude", "skills", "zam", "SKILL.md"),
     agents: ["claude", "copilot"]
   },
   {
-    from: join17(packageRoot, ".agent", "skills", "zam", "SKILL.md"),
-    to: join17(".agent", "skills", "zam", "SKILL.md"),
+    from: join18(packageRoot, ".agent", "skills", "zam", "SKILL.md"),
+    to: join18(".agent", "skills", "zam", "SKILL.md"),
     agents: ["agent"]
   },
   {
-    from: join17(packageRoot, ".agents", "skills", "zam", "SKILL.md"),
-    to: join17(".agents", "skills", "zam", "SKILL.md"),
+    from: join18(packageRoot, ".agents", "skills", "zam", "SKILL.md"),
+    to: join18(".agents", "skills", "zam", "SKILL.md"),
     agents: ["codex"]
   }
 ];
@@ -13176,7 +13271,7 @@ function linkPointsTo(sourceDir, destinationDir) {
 function isZamSkillCopy(destinationDir) {
   try {
     if (!lstatSync(destinationDir).isDirectory()) return false;
-    const skillFile = join17(destinationDir, "SKILL.md");
+    const skillFile = join18(destinationDir, "SKILL.md");
     if (!existsSync15(skillFile)) return false;
     return /^name:\s*zam\s*$/m.test(readFileSync13(skillFile, "utf8"));
   } catch {
@@ -13201,9 +13296,9 @@ function wireSkills(cwd = process.cwd(), agents = parseSetupAgents(), opts = {})
   };
   for (const { from, to, agents: pairAgents } of SKILL_PAIRS) {
     if (!pairAgents.some((agent) => agents.has(agent))) continue;
-    const sourceDir = dirname6(from);
-    const destinationDir = dirname6(join17(cwd, to));
-    const label = dirname6(to);
+    const sourceDir = dirname7(from);
+    const destinationDir = dirname7(join18(cwd, to));
+    const label = dirname7(to);
     const state = classifySkillDestination(sourceDir, destinationDir);
     if (state === "source-missing") {
       if (!opts.quiet) {
@@ -13260,7 +13355,7 @@ function wireSkills(cwd = process.cwd(), agents = parseSetupAgents(), opts = {})
       if (destinationExists) {
         rmSync2(destinationDir, { recursive: true, force: true });
       }
-      mkdirSync10(dirname6(destinationDir), { recursive: true });
+      mkdirSync10(dirname7(destinationDir), { recursive: true });
       symlinkSync(
         sourceDir,
         destinationDir,
@@ -13276,8 +13371,8 @@ function inspectSkillLinks(cwd = process.cwd(), agents = parseSetupAgents()) {
   const results = [];
   for (const { from, to, agents: pairAgents } of SKILL_PAIRS) {
     if (!pairAgents.some((agent) => agents.has(agent))) continue;
-    const sourceDir = dirname6(from);
-    const destinationDir = dirname6(join17(cwd, to));
+    const sourceDir = dirname7(from);
+    const destinationDir = dirname7(join18(cwd, to));
     results.push({
       agents: pairAgents,
       source: sourceDir,
@@ -13322,12 +13417,12 @@ async function resolveUser(opts, db, resolveOpts) {
 
 // src/cli/workspaces/backup.ts
 import { mkdirSync as mkdirSync11 } from "fs";
-import { join as join18 } from "path";
+import { join as join19 } from "path";
 async function backupDatabaseTo(db, targetDir) {
-  const backupDir = join18(targetDir, "zam-backups");
+  const backupDir = join19(targetDir, "zam-backups");
   mkdirSync11(backupDir, { recursive: true });
   const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-  const dest = join18(backupDir, `zam-${stamp}.db`);
+  const dest = join19(backupDir, `zam-${stamp}.db`);
   await db.exec(`VACUUM INTO '${dest.replace(/'/g, "''")}'`);
   return dest;
 }
@@ -13458,7 +13553,7 @@ bridgeCommand.command("workspace-info").description("Report the workspace dir, i
       activeWorkspace,
       workspaceDir: activeWorkspace.path,
       defaultWorkspaceDir: defaultWorkspaceDir(),
-      dataDir: join19(homedir10(), ".zam")
+      dataDir: join20(homedir11(), ".zam")
     });
   });
 });
@@ -13501,7 +13596,7 @@ bridgeCommand.command("workspace-list").description("List configured ZAM workspa
       activeWorkspace,
       workspaceDir: activeWorkspace.path,
       defaultWorkspaceDir: defaultWorkspaceDir(),
-      dataDir: join19(homedir10(), ".zam"),
+      dataDir: join20(homedir11(), ".zam"),
       linkHealth: buildWorkspaceLinkHealth(workspaces)
     });
   });
@@ -13656,7 +13751,7 @@ bridgeCommand.command("agent-open").description("Launch an agent harness in the
       jsonError(`Workspace is not configured: ${opts.workspace}`);
     }
     const activeWorkspace = await ensureActiveWorkspace(db);
-    const workspace = opts.dir ? existsSync16(opts.dir) ? opts.dir : homedir10() : existingWorkspaceDirOrHome(configuredWorkspace ?? activeWorkspace);
+    const workspace = opts.dir ? existsSync16(opts.dir) ? opts.dir : homedir11() : existingWorkspaceDirOrHome(configuredWorkspace ?? activeWorkspace);
     launchHarness(harness, {
       executable,
       workspace,
@@ -14028,7 +14123,7 @@ bridgeCommand.command("discover-skills").description(
   "20"
 ).action(async (opts) => {
   try {
-    const monitorDir = join19(homedir10(), ".zam", "monitor");
+    const monitorDir = join20(homedir11(), ".zam", "monitor");
     let files;
     try {
       files = readdirSync2(monitorDir).filter((f) => f.endsWith(".jsonl"));
@@ -14041,7 +14136,7 @@ bridgeCommand.command("discover-skills").description(
       return;
     }
     const limit = Number(opts.limit);
-    const sorted = files.map((f) => ({ name: f, path: join19(monitorDir, f) })).sort((a, b) => b.name.localeCompare(a.name)).slice(0, limit);
+    const sorted = files.map((f) => ({ name: f, path: join20(monitorDir, f) })).sort((a, b) => b.name.localeCompare(a.name)).slice(0, limit);
     const sessionCommands = /* @__PURE__ */ new Map();
     for (const file of sorted) {
       const sessionId = file.name.replace(".jsonl", "");
@@ -14543,7 +14638,7 @@ bridgeCommand.command("capture-ui").description("Capture a screenshot for agent-
         return;
       }
     }
-    const outputPath = opts.image ?? opts.output ?? join19(tmpdir3(), `zam-capture-${randomBytes2(4).toString("hex")}.png`);
+    const outputPath = opts.image ?? opts.output ?? join20(tmpdir3(), `zam-capture-${randomBytes2(4).toString("hex")}.png`);
     const captureResult = isProvided ? { method: "provided", target: null } : captureScreenshot(outputPath, opts.hwnd, opts.processName);
     if (!isProvided) {
       const post = decidePostCapture(policy, {
@@ -14598,9 +14693,9 @@ bridgeCommand.command("start-recording").description("Start screen recording in
     return;
   }
   const sessionId = opts.session;
-  const statePath = join19(tmpdir3(), `zam-recording-${sessionId}.json`);
+  const statePath = join20(tmpdir3(), `zam-recording-${sessionId}.json`);
   const defaultExt = platform === "win32" ? ".mkv" : ".mov";
-  const outputPath = opts.output ?? join19(tmpdir3(), `zam-recording-${sessionId}${defaultExt}`);
+  const outputPath = opts.output ?? join20(tmpdir3(), `zam-recording-${sessionId}${defaultExt}`);
   const { existsSync: existsSync18, writeFileSync: writeFileSync9, openSync, closeSync } = await import("fs");
   if (existsSync18(statePath)) {
     jsonOut({
@@ -14610,7 +14705,7 @@ bridgeCommand.command("start-recording").description("Start screen recording in
     });
     return;
   }
-  const logPath = join19(tmpdir3(), `zam-recording-${sessionId}.log`);
+  const logPath = join20(tmpdir3(), `zam-recording-${sessionId}.log`);
   let logFd;
   try {
     logFd = openSync(logPath, "w");
@@ -14692,7 +14787,7 @@ bridgeCommand.command("stop-recording").description(
     return;
   }
   const sessionId = opts.session;
-  const statePath = join19(tmpdir3(), `zam-recording-${sessionId}.json`);
+  const statePath = join20(tmpdir3(), `zam-recording-${sessionId}.json`);
   const { existsSync: existsSync18, readFileSync: readFileSync16, rmSync: rmSync4 } = await import("fs");
   if (!existsSync18(statePath)) {
     jsonOut({
@@ -15757,7 +15852,7 @@ bridgeCommand.command("personal-source-import").description(
     } else {
       throw new Error(`Invalid source type: ${opts.type}`);
     }
-    const sourceId = ulid9();
+    const sourceId = ulid10();
     await db.prepare(
       `INSERT INTO sources (id, type, uri, content)
            VALUES (?, ?, ?, ?)
@@ -15976,7 +16071,7 @@ bridgeCommand.command("curriculum-extract-topics").description(
         }
       }
       const pageCleanedText = cleanHtml(rawHtml);
-      const sourceId = ulid9();
+      const sourceId = ulid10();
       await db.prepare(
         `INSERT INTO sources (id, type, uri, content)
              VALUES (?, 'web', ?, ?)
@@ -16241,10 +16336,10 @@ bridgeCommand.command("serve").description("Start the persistent JSON-RPC stdin/
 });
 
 // src/cli/commands/mcp.ts
-var __dirname = dirname7(fileURLToPath4(import.meta.url));
-var pkgPath = join20(__dirname, "..", "..", "package.json");
+var __dirname = dirname8(fileURLToPath4(import.meta.url));
+var pkgPath = join21(__dirname, "..", "..", "package.json");
 if (!existsSync17(pkgPath)) {
-  pkgPath = join20(__dirname, "..", "..", "..", "package.json");
+  pkgPath = join21(__dirname, "..", "..", "..", "package.json");
 }
 var pkg = JSON.parse(readFileSync15(pkgPath, "utf-8"));
 var STUDIO_RESOURCE_URI = "ui://zam/studio";
@@ -16271,9 +16366,9 @@ var STUDIO_BRIDGE_ALLOWED_COMMANDS = /* @__PURE__ */ new Set([
 function loadPanelHtml(fileName, placeholderTitle) {
   const candidates = [
     // dist/cli/commands/mcp.js → dist/ui/
-    join20(__dirname, "..", "..", "ui", fileName),
+    join21(__dirname, "..", "..", "ui", fileName),
     // src/cli/commands/mcp.ts via tsx → <repo>/dist/ui/
-    join20(__dirname, "..", "..", "..", "dist", "ui", fileName)
+    join21(__dirname, "..", "..", "..", "dist", "ui", fileName)
   ];
   for (const candidate of candidates) {
     if (existsSync17(candidate)) {
@@ -16672,7 +16767,7 @@ function createMcpServer(db) {
     "zam_open_studio",
     {
       title: "ZAM Studio",
-      description: "Open the ZAM Studio panel (content editor, knowledge graph, settings) inline",
+      description: "Open the legacy all-in-one ZAM Studio panel for standalone onboarding and content curation. Agent harness workflows should use the focused Recall, Graph, and Settings apps instead.",
       inputSchema: {},
       annotations: {
         ...commonAnnotations,
@@ -16727,6 +16822,7 @@ function createMcpServer(db) {
     wrapHandler(
       async ({ user, domain }) => {
         const userId = await getUserId(user).catch(() => null);
+        await publishUiIntent("recall", { user, domain });
         return {
           recall: "zam",
           version: pkg.version,
@@ -16771,6 +16867,7 @@ function createMcpServer(db) {
     },
     wrapHandler(async ({ focus, user }) => {
       const userId = await getUserId(user).catch(() => null);
+      await publishUiIntent("graph", { user, focus });
       return {
         graph: "zam",
         focus: focus ?? null,
@@ -16812,6 +16909,7 @@ function createMcpServer(db) {
     },
     wrapHandler(async ({ user }) => {
       const userId = await getUserId(user).catch(() => null);
+      await publishUiIntent("settings", { user });
       return {
         settings: "zam",
         version: pkg.version,