@bastani/atomic 0.8.28-alpha.4 → 0.8.29-alpha.2

package/examples/extensions/structured-output.ts

@@ -1,65 +1,34 @@
 /**
- * Structured Output Tool
+ * Schema-specific structured_output tool
  *
- * Demonstrates `terminate: true` so the agent can end on a tool call
- * without paying for an extra follow-up LLM turn.
+ * Atomic does not register `structured_output` in normal agent sessions by
+ * default. This extension demonstrates the canonical factory for adding a
+ * schema-backed terminating final-answer tool only when this extension is
+ * enabled.
+ *
+ * Custom factory names are opt-in tools too: `createStructuredOutputTool({ name:
+ * "final_decision", ... })` registers `final_decision`; include that name in any
+ * explicit `tools` allowlist. The default factory name registers
+ * `structured_output` for this extension/runtime only.
  */
 
-import { defineTool, type ExtensionAPI } from "@bastani/atomic";
-import { Text } from "@earendil-works/pi-tui";
+import {
+	createStructuredOutputTool,
+	type ExtensionAPI,
+} from "@bastani/atomic";
 import { Type } from "typebox";
 
-interface StructuredOutputDetails {
-	headline: string;
-	summary: string;
-	actionItems: string[];
-}
-
-const structuredOutputTool = defineTool({
-	name: "structured_output",
-	label: "Structured Output",
-	description:
-		"Return a final structured answer. Use this as your last action when the user asks for structured output or a machine-readable summary.",
-	promptSnippet: "Emit a final structured answer as a terminating tool result",
-	promptGuidelines: [
-		"Use structured_output as your final action when the user asks for structured output, JSON-like output, or a machine-readable summary.",
-		"After calling structured_output, do not emit another assistant response in the same turn.",
-	],
-	parameters: Type.Object({
-		headline: Type.String({ description: "Short title for the result" }),
-		summary: Type.String({ description: "One-paragraph summary" }),
-		actionItems: Type.Array(Type.String(), { description: "Concrete next steps or key bullets" }),
-	}),
-
-	async execute(_toolCallId, params) {
-		return {
-			content: [{ type: "text", text: `Saved structured output: ${params.headline}` }],
-			details: {
-				headline: params.headline,
-				summary: params.summary,
-				actionItems: params.actionItems,
-			} satisfies StructuredOutputDetails,
-			terminate: true,
-		};
-	},
-
-	renderResult(result, _options, theme) {
-		const details = result.details as StructuredOutputDetails | undefined;
-		if (!details) {
-			const text = result.content[0];
-			return new Text(text?.type === "text" ? text.text : "", 0, 0);
-		}
+const SummarySchema = Type.Object({
+	headline: Type.String({ description: "Short title for the result" }),
+	summary: Type.String({ description: "One-paragraph summary" }),
+	actionItems: Type.Array(Type.String(), { description: "Concrete next steps or key bullets" }),
+}, { additionalProperties: false });
 
-		const lines = [
-			theme.fg("toolTitle", theme.bold(details.headline)),
-			theme.fg("text", details.summary),
-			"",
-			...details.actionItems.map((item, index) => theme.fg("muted", `${index + 1}. ${item}`)),
-		];
-		return new Text(lines.join("\n"), 0, 0);
-	},
+const structuredOutputTool = createStructuredOutputTool({
+	schema: SummarySchema,
 });
 
 export default function (pi: ExtensionAPI) {
+	// Register structured_output for sessions that load this extension.
 	pi.registerTool(structuredOutputTool);
 }

package/examples/extensions/with-deps/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "atomic-extension-with-deps",
-  "version": "0.79.1",
+  "version": "0.79.3",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "atomic-extension-with-deps",
-      "version": "0.79.1",
+      "version": "0.79.3",
       "dependencies": {
         "ms": "^2.1.3"
       },

package/examples/extensions/with-deps/package.json

@@ -1,7 +1,7 @@
 {
   "name": "atomic-extension-with-deps",
   "private": true,
-  "version": "0.79.1",
+  "version": "0.79.3",
   "type": "module",
   "scripts": {
     "clean": "echo 'nothing to clean'",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/atomic",
-  "version": "0.8.28-alpha.4",
+  "version": "0.8.29-alpha.2",
   "description": "Atomic coding agent CLI with read, bash, edit, write tools and session management",
   "type": "module",
   "atomicConfig": {
@@ -21,7 +21,8 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
     },
     "./hooks": {
       "types": "./dist/core/hooks/index.d.ts",
@@ -67,9 +68,11 @@
     "prepublishOnly": "bun run clean && bun run build"
   },
   "dependencies": {
-    "@earendil-works/pi-agent-core": "^0.79.1",
-    "@earendil-works/pi-ai": "^0.79.1",
-    "@earendil-works/pi-tui": "^0.79.1",
+    "@bastani/atomic-natives": "0.8.29-alpha.2",
+    "@bufbuild/protobuf": "^2.0.0",
+    "@earendil-works/pi-agent-core": "^0.79.3",
+    "@earendil-works/pi-ai": "^0.79.3",
+    "@earendil-works/pi-tui": "^0.79.3",
     "@modelcontextprotocol/ext-apps": "^1.7.2",
     "@modelcontextprotocol/sdk": "^1.25.1",
     "@mozilla/readability": "^0.6.0",
@@ -85,7 +88,7 @@
     "linkedom": "^0.18.12",
     "minimatch": "^10.2.3",
     "open": "^11.0.0",
-    "p-limit": "^6.1.0",
+    "p-limit": "^7.3.0",
     "proper-lockfile": "^4.1.2",
     "turndown": "^7.2.0",
     "typebox": "^1.1.24",
@@ -101,14 +104,14 @@
     }
   },
   "optionalDependencies": {
-    "@mariozechner/clipboard": "^0.3.6"
+    "@mariozechner/clipboard": "^0.3.9"
   },
   "devDependencies": {
     "@types/cross-spawn": "6.0.6",
-    "@types/diff": "^7.0.2",
+    "@types/diff": "^8.0.0",
     "@types/hosted-git-info": "^3.0.5",
     "@types/ms": "^2.1.0",
-    "@types/node": "^25.9.1",
+    "@types/node": "^25.9.3",
     "@types/proper-lockfile": "^4.1.4",
     "@typescript/native-preview": "7.0.0-dev.20260511.1",
     "shx": "^0.4.0",