atom-agent 1.2.0 → 1.3.0

package/examples/extensions/01-audit-gate.js

@@ -0,0 +1,24 @@
+// 01-audit-gate — destructive-command audit gate.
+//
+// Blocks risky shell commands BEFORE they run. The returned reason commits
+// as the normal model-visible result (approval is skipped, the turn
+// continues); anything this hook does not block runs untouched.
+//
+// Gallery sample for documentation/extensions.md — that guide references
+// this file by name and never duplicates it. Covered by
+// tests/extension-gallery.test.ts, which loads this exact file through the
+// real loadExtensions path.
+module.exports = function auditGate(api) {
+  api.onBeforeToolCall(({ name, args }) => {
+    if (name !== "bash") return;
+    const command = String(args?.command ?? "");
+    const DESTRUCTIVE = ["rm -rf /", "rm -rf ~", "rm -rf .", "mkfs", ":(){:|:&};:"];
+    if (DESTRUCTIVE.some((sig) => command.includes(sig))) {
+      return {
+        block:
+          "destructive shell commands need explicit confirmation — " +
+          "narrow the command or confirm it with the user first",
+      };
+    }
+  });
+};

package/examples/extensions/02-notes-tool.js

@@ -0,0 +1,32 @@
+// 02-notes-tool — model-callable notes tool.
+//
+// Registers a brand-new tool the model can call exactly like a builtin: it
+// appears in the tool definitions, validates args inline (bad args are an
+// `Error: invalid call: ...` result and the implementation never runs), and
+// dispatches through the shared loop.
+//
+// Gallery sample for documentation/extensions.md — that guide references
+// this file by name and never duplicates it. Covered by
+// tests/extension-gallery.test.ts, which loads this exact file through the
+// real loadExtensions path.
+const notes = [];
+
+module.exports = function notesTool(api) {
+  api.registerTool({
+    name: "gallery_notes",
+    description: "Save a short note and read it back. Use it to remember user preferences across the turn.",
+    parameters: {
+      type: "object",
+      properties: { text: { type: "string" } },
+      required: ["text"],
+      additionalProperties: false,
+    },
+    execute: async (args) => {
+      notes.push(String(args.text));
+      return `saved note #${notes.length}: ${notes[notes.length - 1]}`;
+    },
+    // Pure, side-effect-free helper (in-memory only): safe to run without an
+    // approval prompt. Anything with a real footprint keeps the default.
+    requireApproval: false,
+  });
+};

package/examples/extensions/03-custom-command.js

@@ -0,0 +1,32 @@
+// 03-custom-command — custom slash command with a dialog.
+//
+// Registers a real `/gallery-plan` command: it asks the user to pick a
+// target in a modal dialog, then posts the plan to the transcript. The
+// workflow logic lives in the pure summarizeChoice helper (no modal, no
+// transcript) so the dialog flow is testable headless — tests drive the
+// command with a stub askUser and unit-test the helper directly.
+//
+// Gallery sample for documentation/extensions.md — that guide references
+// this file by name and never duplicates it. Covered by
+// tests/extension-gallery.test.ts, which loads this exact file through the
+// real loadExtensions path.
+function summarizeChoice(choice, extra) {
+  const scope = String(extra ?? "").trim();
+  return scope.length > 0 ? `deploying to ${choice} (${scope})` : `deploying to ${choice}`;
+}
+
+function galleryCommand(api) {
+  api.registerCommand({
+    name: "gallery-plan",
+    description: "Pick a deploy target and post the plan.",
+    handler: async (ctx) => {
+      const choice = await ctx.askUser("Which environment?", ["staging", "prod"]);
+      const plan = summarizeChoice(choice, ctx.args);
+      ctx.say(plan);
+      return `plan posted for ${choice}`;
+    },
+  });
+}
+
+module.exports = galleryCommand;
+module.exports.summarizeChoice = summarizeChoice;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "atom-agent",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Agentic terminal coding assistant: multi-provider LLM loop with local file/shell/web tools in an Ink (React) TUI.",
   "type": "module",
   "license": "MIT",
@@ -23,7 +23,10 @@
     "dist",
     "README.md",
     "LICENSE",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "documentation",
+    "examples",
+    "atom.example.json"
   ],
   "keywords": [
     "ai-agent",
@@ -41,6 +44,7 @@
   },
   "dependencies": {
     "ink": "7.1.1",
+    "jiti": "^2.7.0",
     "react": "19.2.8"
   },
   "devDependencies": {