npm - @agentic-patterns/cli - Versions diffs - 0.1.4 → 0.1.5 - Mend

@agentic-patterns/cli 0.1.4 → 0.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/README.md +14 -4
package/assets/dashboard/assets/{index-C2JvJdBt.js → index-x4ivBrgq.js} +20 -20
package/assets/dashboard/index.html +1 -1
package/assets/plugin-template/.claude-plugin/plugin.json +1 -1
package/assets/plugin-template/hooks/emit.mjs +8 -1
package/dist/cli.js +104 -15
package/dist/cli.js.map +1 -1
package/package.json +7 -5

package/assets/dashboard/index.html CHANGED Viewed

@@ -4,7 +4,7 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>Agentic Patterns Dashboard</title>
-    <script type="module" crossorigin src="/assets/index-C2JvJdBt.js"></script>
+    <script type="module" crossorigin src="/assets/index-x4ivBrgq.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-whvaenaU.css">
   </head>
   <body>

package/assets/plugin-template/.claude-plugin/plugin.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "agentic-patterns",
   "version": "0.1.0",
-  "description": "Streams Claude Code lifecycle events into the @agentic-patterns/server dashboard for live observability. Pair with `ap playground` or `ap serve`.",
+  "description": "Streams all 26 Claude Code lifecycle events (tool calls, permissions, subagents, compaction, sessions) into the @agentic-patterns/server dashboard for live observability. Pair with `ap playground`. See https://github.com/pattern-stack/agentic-patterns-ts/blob/main/docs/CLAUDE-CODE-PLUGIN-ACTIVATION.md for activation + troubleshooting.",
   "author": {
     "name": "pattern-stack",
     "url": "https://github.com/pattern-stack"

package/assets/plugin-template/hooks/emit.mjs CHANGED Viewed

@@ -1,8 +1,15 @@
 #!/usr/bin/env node
+// Zero-dependency hook shim. Keep this file tiny and stable — it's copied
+// verbatim into every user project via `ap init --with-plugin` and will not
+// retroactively update. All evolving behavior belongs server-side at
+// /hooks/:eventType. See docs/CLAUDE-CODE-PLUGIN-ACTIVATION.md.
+//
+// Fallback port 3456 mirrors DEFAULT_DASHBOARD_PORT in
+// packages/agent-cli/src/constants.ts. Keep in sync.
 import { stdin } from "node:process";
 const eventName = process.argv[2] ?? "Unknown";
-const base = process.env.AP_DASHBOARD_URL ?? "http://localhost:3000";
+const base = process.env.AP_DASHBOARD_URL ?? "http://localhost:3456";
 try {
   const chunks = [];

package/dist/cli.js CHANGED Viewed

@@ -65,7 +65,8 @@ var TRACKED_ENV = [
   { key: "DEEPSEEK_API_KEY", label: "DeepSeek API key", secret: true },
   { key: "OPENROUTER_API_KEY", label: "OpenRouter API key", secret: true },
   { key: "OLLAMA_HOST", label: "Ollama host URL", secret: false },
-  { key: "AGENT_TIER", label: "Default tier (opus | sonnet | haiku)", secret: false }
+  { key: "AGENT_TIER", label: "Default tier (opus | sonnet | haiku)", secret: false },
+  { key: "AGENT_MODEL", label: "Pinned model id (overrides tier)", secret: false }
 ];
 function runConfigStatusCommand(input) {
   const { config } = input;
@@ -172,6 +173,12 @@ import fs2 from "fs";
 import path3 from "path";
 import { fileURLToPath } from "url";
 import { isCancel as isCancel2, select as select2, text as text2 } from "@clack/prompts";
+// src/constants.ts
+var DEFAULT_DASHBOARD_PORT = 3456;
+var DEFAULT_DASHBOARD_URL = `http://localhost:${DEFAULT_DASHBOARD_PORT}`;
+// src/commands/init.ts
 var DIM3 = "\x1B[2m";
 var BOLD3 = "\x1B[1m";
 var GREEN2 = "\x1B[32m";
@@ -186,8 +193,7 @@ async function runInitCommand(opts) {
     monorepoRoot = resolveMonorepoRoot();
     if (!monorepoRoot) {
       process.stderr.write(
-        `error: --link requires the CLI to be run from the agentic-patterns-ts source tree
-`
+        "error: --link requires the CLI to be run from the agentic-patterns-ts source tree\n"
       );
       process.exit(1);
     }
@@ -279,6 +285,25 @@ async function runInitCommand(opts) {
       copyDir(pluginSrc.pluginDir, path3.join(targetDir, ".claude-plugin"));
       copyDir(pluginSrc.hooksDir, path3.join(targetDir, "hooks"));
       created.push(".claude-plugin/", "hooks/");
+      const settingsDir = path3.join(targetDir, ".claude");
+      const settingsPath = path3.join(settingsDir, "settings.json");
+      const hooksSource = fs2.readFileSync(path3.join(pluginSrc.hooksDir, "hooks.json"), "utf8");
+      const ourHooks = JSON.parse(
+        hooksSource.replaceAll("${CLAUDE_PLUGIN_ROOT}", "${CLAUDE_PROJECT_DIR}")
+      );
+      const mergeOutcome = mergeHookSettings(settingsPath, ourHooks);
+      fs2.mkdirSync(settingsDir, { recursive: true });
+      fs2.writeFileSync(settingsPath, `${JSON.stringify(mergeOutcome.merged, null, 2)}
+`);
+      if (mergeOutcome.kind === "created") {
+        created.push(".claude/settings.json");
+      } else if (mergeOutcome.kind === "merged") {
+        created.push(
+          `.claude/settings.json ${DIM3}(merged ${mergeOutcome.added} hook entries)${RESET3}`
+        );
+      } else {
+        created.push(`.claude/settings.json ${DIM3}(already up to date)${RESET3}`);
+      }
     } else {
       pluginNote = `${YELLOW2}warning${RESET3}: --with-plugin requested but plugin source not found.
    ${DIM3}Run from the agentic-patterns-ts source tree, or wait for plugin packaging (Phase 2).${RESET3}`;
@@ -308,8 +333,10 @@ async function runInitCommand(opts) {
       process.stdout.write(`    cd ${rootRel}
 `);
     }
-    process.stdout.write(`    bun install                ${DIM3}# picks up the new example${RESET3}
-`);
+    process.stdout.write(
+      `    bun install                ${DIM3}# picks up the new example${RESET3}
+`
+    );
     process.stdout.write(`    cd ${projRel}
 `);
     process.stdout.write(
@@ -328,8 +355,7 @@ async function runInitCommand(opts) {
       `    cp .env.example .env       ${DIM3}# fill in your ${envKeyFor(provider)}${RESET3}
 `
     );
-    process.stdout.write(`    bun install
-`);
+    process.stdout.write("    bun install\n");
     process.stdout.write(`    bun run dev                ${DIM3}# launch playground${RESET3}
 `);
@@ -376,10 +402,15 @@ function renderPackageJson(name, provider, link) {
 function renderEnvExample(provider) {
   const lines = [
     "# Dashboard URL \u2014 used by the Claude Code plugin to ship lifecycle events",
-    "AP_DASHBOARD_URL=http://localhost:3000",
+    `AP_DASHBOARD_URL=${DEFAULT_DASHBOARD_URL}`,
     "",
     "# Default model tier \u2014 opus | sonnet | haiku (used by the agent runner)",
     "AGENT_TIER=sonnet",
+    "",
+    "# Optional: pin an exact model id; wins over AGENT_TIER. Useful when",
+    "# your provider has a model the framework's tier map doesn't list",
+    "# (e.g. AGENT_MODEL=qwen3.6:27b for an Ollama box).",
+    "# AGENT_MODEL=",
     ""
   ];
   if (provider === "anthropic") {
@@ -428,7 +459,7 @@ function renderAgent(provider) {
  * file (via \`agents/**\\/agent.ts\`), builds a runner from your environment
  * (using ${provider}), and wires it into the playground dashboard.
  *
- *   pnpm dev          # launch the dashboard at http://localhost:3000
+ *   bun run dev       # launch the dashboard at http://localhost:3456
  *   ap run demo       # chat with this agent in the terminal
  */
@@ -548,6 +579,50 @@ function writeFile(root, rel, contents, log) {
 function copyDir(src, dest) {
   fs2.cpSync(src, dest, { recursive: true });
 }
+function mergeHookSettings(settingsPath, ours) {
+  if (!fs2.existsSync(settingsPath)) {
+    return { kind: "created", merged: ours };
+  }
+  let existing;
+  try {
+    existing = JSON.parse(fs2.readFileSync(settingsPath, "utf8"));
+  } catch {
+    const backup = `${settingsPath}.ap-backup-${Date.now()}`;
+    fs2.renameSync(settingsPath, backup);
+    process.stdout.write(
+      `${YELLOW2}warning${RESET3}: existing .claude/settings.json was malformed; moved to ${path3.basename(backup)}
+`
+    );
+    return { kind: "created", merged: ours };
+  }
+  const merged = { ...existing, hooks: { ...existing.hooks ?? {} } };
+  let added = 0;
+  for (const event of Object.keys(ours.hooks)) {
+    const ourMatchers = ours.hooks[event] ?? [];
+    const theirMatchers = merged.hooks[event] ?? [];
+    const result = [...theirMatchers];
+    for (const ourMatcher of ourMatchers) {
+      const theirMatcher = result.find((m) => m.matcher === ourMatcher.matcher);
+      if (!theirMatcher) {
+        result.push(ourMatcher);
+        added += ourMatcher.hooks.length;
+        continue;
+      }
+      for (const ourHook of ourMatcher.hooks) {
+        const duplicate = theirMatcher.hooks.some(
+          (h) => h.type === ourHook.type && h.command === ourHook.command
+        );
+        if (!duplicate) {
+          theirMatcher.hooks.push(ourHook);
+          added += 1;
+        }
+      }
+    }
+    merged.hooks[event] = result;
+  }
+  if (added === 0) return { kind: "unchanged", merged };
+  return { kind: "merged", merged, added };
+}
 function resolvePluginSource() {
   const here = path3.dirname(fileURLToPath(import.meta.url));
   const bundledCandidates = [
@@ -608,7 +683,7 @@ import {
 import { createServer } from "@agentic-patterns/server";
 import { serve } from "@hono/node-server";
 async function runPlaygroundCommand(opts) {
-  const port = opts.port ?? 3e3;
+  const port = opts.port ?? DEFAULT_DASHBOARD_PORT;
   const shouldOpen = opts.open !== false;
   const serveDashboard = opts.noDashboard !== true;
   const eventBus = new AgentEventBus();
@@ -1007,16 +1082,29 @@ function formatConfigRow(config) {
   return parts.join(" \xB7 ");
 }
 function detectRunnerFromEnv() {
+  const pinned = process.env.AGENT_MODEL;
   if (process.env.ANTHROPIC_API_KEY) {
-    return { provider: "anthropic", detail: "env ANTHROPIC_API_KEY \u2192 claude-sonnet-4-5" };
+    return {
+      provider: "anthropic",
+      detail: `env ANTHROPIC_API_KEY \u2192 ${pinned ?? "claude-sonnet-4-5"}${pinned ? " (AGENT_MODEL)" : ""}`
+    };
   }
   if (process.env.OPENAI_API_KEY) {
-    return { provider: "openai", detail: "env OPENAI_API_KEY \u2192 gpt-4o" };
+    return {
+      provider: "openai",
+      detail: `env OPENAI_API_KEY \u2192 ${pinned ?? "gpt-4o"}${pinned ? " (AGENT_MODEL)" : ""}`
+    };
   }
   if (process.env.GOOGLE_GENERATIVE_AI_API_KEY || process.env.GOOGLE_API_KEY) {
-    return { provider: "google", detail: "env GOOGLE_*_API_KEY \u2192 gemini-2.5-flash" };
+    return {
+      provider: "google",
+      detail: `env GOOGLE_*_API_KEY \u2192 ${pinned ?? "gemini-2.5-flash"}${pinned ? " (AGENT_MODEL)" : ""}`
+    };
   }
   if (process.env.OLLAMA_HOST) {
+    if (pinned) {
+      return { provider: "ollama", detail: `env OLLAMA_HOST \u2192 ${pinned} (AGENT_MODEL)` };
+    }
     const tier = process.env.AGENT_TIER ?? "sonnet";
     const model = tier === "opus" ? "qwen3:30b-a3b" : tier === "haiku" ? "qwen3:4b" : "qwen3:14b";
     return {
@@ -1072,7 +1160,8 @@ function resolveProjectConfig(from = process.cwd()) {
     }
   }
   const agents = normalizeGlobs(manifest.agentic?.agents) ?? DEFAULT_AGENT_GLOBS;
-  const port = manifest.agentic?.port ?? Number.parseInt(process.env.PORT ?? "3000", 10);
+  const envPort = process.env.PORT;
+  const port = manifest.agentic?.port ?? (envPort !== void 0 ? Number.parseInt(envPort, 10) : DEFAULT_DASHBOARD_PORT);
   return { root, agents, port, hasManifest };
 }
 function normalizeGlobs(value) {
@@ -1180,7 +1269,7 @@ Commands:
 Options:
   -h, --help                      show this help
-  --port <port>                   server port for playground (default 3000)
+  --port <port>                   server port for playground (default 3456)
   --no-dashboard                  playground without dashboard (API only)
   --no-open                       don't auto-open the browser
   --agents <glob>                 override agent discovery glob