@writ-agent/sdk 0.1.0 → 0.1.1

package/dist/cjs/index.d.ts

@@ -3,7 +3,7 @@ export type { ApprovalAnswer, ApprovalRequest, Approver, AskMode, AuthorizeOptio
 export { guard, guardTools } from "./guard.js";
 export type { ExecutableTool, GuardOptions, GuardToolsOptions } from "./guard.js";
 export { WritBlockedError, WritError, WritProtocolError, WritTimeoutError, WritUnavailableError, describeBlock, } from "./errors.js";
-export { findOnPath, locateWrit } from "./locate.js";
+export { bundledWrit, findOnPath, locateWrit } from "./locate.js";
 export type { Launch } from "./locate.js";
 export { PROTOCOL_VERSION } from "./protocol.js";
 export type { CallerIdentity, CompleteInput, CompleteResult, Decision, DecisionKind, ServerIdentity, ToolCallInput, TrustVerdict, } from "./protocol.js";

package/dist/cjs/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PROTOCOL_VERSION = exports.locateWrit = exports.findOnPath = exports.describeBlock = exports.WritUnavailableError = exports.WritTimeoutError = exports.WritProtocolError = exports.WritError = exports.WritBlockedError = exports.guardTools = exports.guard = exports.shouldDispatch = exports.WritClient = void 0;
+exports.PROTOCOL_VERSION = exports.locateWrit = exports.findOnPath = exports.bundledWrit = exports.describeBlock = exports.WritUnavailableError = exports.WritTimeoutError = exports.WritProtocolError = exports.WritError = exports.WritBlockedError = exports.guardTools = exports.guard = exports.shouldDispatch = exports.WritClient = void 0;
 var client_js_1 = require("./client.js");
 Object.defineProperty(exports, "WritClient", { enumerable: true, get: function () { return client_js_1.WritClient; } });
 Object.defineProperty(exports, "shouldDispatch", { enumerable: true, get: function () { return client_js_1.shouldDispatch; } });
@@ -15,6 +15,7 @@ Object.defineProperty(exports, "WritTimeoutError", { enumerable: true, get: func
 Object.defineProperty(exports, "WritUnavailableError", { enumerable: true, get: function () { return errors_js_1.WritUnavailableError; } });
 Object.defineProperty(exports, "describeBlock", { enumerable: true, get: function () { return errors_js_1.describeBlock; } });
 var locate_js_1 = require("./locate.js");
+Object.defineProperty(exports, "bundledWrit", { enumerable: true, get: function () { return locate_js_1.bundledWrit; } });
 Object.defineProperty(exports, "findOnPath", { enumerable: true, get: function () { return locate_js_1.findOnPath; } });
 Object.defineProperty(exports, "locateWrit", { enumerable: true, get: function () { return locate_js_1.locateWrit; } });
 var protocol_js_1 = require("./protocol.js");

package/dist/cjs/locate.d.ts

@@ -12,7 +12,13 @@ export declare function launchFor(bin: string): Launch;
 /** Search PATH for `writ` (`writ.exe` / `writ.com` on Windows). */
 export declare function findOnPath(name?: string, env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): string | undefined;
 /**
- * Locate writ: explicit `bin`, then `WRIT_BIN`, then PATH. Throws
- * `WritUnavailableError` when nothing is found.
+ * The prebuilt binary from the optional `@writ-agent/cli` dependency, if it
+ * is installed next to this SDK and ships a binary for this platform.
+ */
+export declare function bundledWrit(from?: string | undefined): string | undefined;
+/**
+ * Locate writ: explicit `bin`, then `WRIT_BIN`, then the binary bundled by
+ * `@writ-agent/cli`, then PATH. Throws `WritUnavailableError` when nothing is
+ * found.
  */
 export declare function locateWrit(bin?: string, env?: NodeJS.ProcessEnv): Launch;

package/dist/cjs/locate.js

@@ -2,10 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.launchFor = launchFor;
 exports.findOnPath = findOnPath;
+exports.bundledWrit = bundledWrit;
 exports.locateWrit = locateWrit;
 const node_fs_1 = require("node:fs");
+const node_module_1 = require("node:module");
 const node_path_1 = require("node:path");
 const errors_js_1 = require("./errors.js");
+const self_js_1 = require("./self.js");
 const SCRIPT_EXTENSIONS = new Set([".js", ".mjs", ".cjs"]);
 function isFile(p) {
     try {
@@ -47,8 +50,26 @@ function findOnPath(name = "writ", env = process.env, platform = process.platfor
     return undefined;
 }
 /**
- * Locate writ: explicit `bin`, then `WRIT_BIN`, then PATH. Throws
- * `WritUnavailableError` when nothing is found.
+ * The prebuilt binary from the optional `@writ-agent/cli` dependency, if it
+ * is installed next to this SDK and ships a binary for this platform.
+ */
+function bundledWrit(from = self_js_1.selfUrl) {
+    if (from === undefined)
+        return undefined;
+    try {
+        const req = (0, node_module_1.createRequire)(from);
+        const cli = req("@writ-agent/cli");
+        const path = typeof cli.binaryPath === "function" ? cli.binaryPath() : undefined;
+        return path !== undefined && isFile(path) ? path : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Locate writ: explicit `bin`, then `WRIT_BIN`, then the binary bundled by
+ * `@writ-agent/cli`, then PATH. Throws `WritUnavailableError` when nothing is
+ * found.
  */
 function locateWrit(bin, env = process.env) {
     if (bin !== undefined && bin !== "")
@@ -56,9 +77,10 @@ function locateWrit(bin, env = process.env) {
     const fromEnv = env.WRIT_BIN;
     if (fromEnv !== undefined && fromEnv !== "")
         return launchFor(fromEnv);
-    const found = findOnPath("writ", env);
+    const found = bundledWrit() ?? findOnPath("writ", env);
     if (found === undefined) {
-        throw new errors_js_1.WritUnavailableError("writ binary not found: set WRIT_BIN or put writ on PATH (fail closed: no tool call will run)");
+        throw new errors_js_1.WritUnavailableError("writ binary not found: install @writ-agent/cli, set WRIT_BIN, or put writ on PATH " +
+            "(fail closed: no tool call will run)");
     }
     return { command: found, args: [] };
 }

package/dist/cjs/self.d.ts

@@ -0,0 +1 @@
+export declare const selfUrl: string | undefined;

package/dist/cjs/self.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selfUrl = require("node:url").pathToFileURL(__filename).href;

package/dist/esm/index.d.ts

@@ -3,7 +3,7 @@ export type { ApprovalAnswer, ApprovalRequest, Approver, AskMode, AuthorizeOptio
 export { guard, guardTools } from "./guard.js";
 export type { ExecutableTool, GuardOptions, GuardToolsOptions } from "./guard.js";
 export { WritBlockedError, WritError, WritProtocolError, WritTimeoutError, WritUnavailableError, describeBlock, } from "./errors.js";
-export { findOnPath, locateWrit } from "./locate.js";
+export { bundledWrit, findOnPath, locateWrit } from "./locate.js";
 export type { Launch } from "./locate.js";
 export { PROTOCOL_VERSION } from "./protocol.js";
 export type { CallerIdentity, CompleteInput, CompleteResult, Decision, DecisionKind, ServerIdentity, ToolCallInput, TrustVerdict, } from "./protocol.js";

package/dist/esm/index.js

@@ -1,5 +1,5 @@
 export { WritClient, shouldDispatch } from "./client.js";
 export { guard, guardTools } from "./guard.js";
 export { WritBlockedError, WritError, WritProtocolError, WritTimeoutError, WritUnavailableError, describeBlock, } from "./errors.js";
-export { findOnPath, locateWrit } from "./locate.js";
+export { bundledWrit, findOnPath, locateWrit } from "./locate.js";
 export { PROTOCOL_VERSION } from "./protocol.js";

package/dist/esm/locate.d.ts

@@ -12,7 +12,13 @@ export declare function launchFor(bin: string): Launch;
 /** Search PATH for `writ` (`writ.exe` / `writ.com` on Windows). */
 export declare function findOnPath(name?: string, env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): string | undefined;
 /**
- * Locate writ: explicit `bin`, then `WRIT_BIN`, then PATH. Throws
- * `WritUnavailableError` when nothing is found.
+ * The prebuilt binary from the optional `@writ-agent/cli` dependency, if it
+ * is installed next to this SDK and ships a binary for this platform.
+ */
+export declare function bundledWrit(from?: string | undefined): string | undefined;
+/**
+ * Locate writ: explicit `bin`, then `WRIT_BIN`, then the binary bundled by
+ * `@writ-agent/cli`, then PATH. Throws `WritUnavailableError` when nothing is
+ * found.
  */
 export declare function locateWrit(bin?: string, env?: NodeJS.ProcessEnv): Launch;

package/dist/esm/locate.js

@@ -1,6 +1,8 @@
 import { statSync } from "node:fs";
+import { createRequire } from "node:module";
 import { delimiter, extname, isAbsolute, join, resolve } from "node:path";
 import { WritUnavailableError } from "./errors.js";
+import { selfUrl } from "./self.js";
 const SCRIPT_EXTENSIONS = new Set([".js", ".mjs", ".cjs"]);
 function isFile(p) {
     try {
@@ -42,8 +44,26 @@ export function findOnPath(name = "writ", env = process.env, platform = process.
     return undefined;
 }
 /**
- * Locate writ: explicit `bin`, then `WRIT_BIN`, then PATH. Throws
- * `WritUnavailableError` when nothing is found.
+ * The prebuilt binary from the optional `@writ-agent/cli` dependency, if it
+ * is installed next to this SDK and ships a binary for this platform.
+ */
+export function bundledWrit(from = selfUrl) {
+    if (from === undefined)
+        return undefined;
+    try {
+        const req = createRequire(from);
+        const cli = req("@writ-agent/cli");
+        const path = typeof cli.binaryPath === "function" ? cli.binaryPath() : undefined;
+        return path !== undefined && isFile(path) ? path : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Locate writ: explicit `bin`, then `WRIT_BIN`, then the binary bundled by
+ * `@writ-agent/cli`, then PATH. Throws `WritUnavailableError` when nothing is
+ * found.
  */
 export function locateWrit(bin, env = process.env) {
     if (bin !== undefined && bin !== "")
@@ -51,9 +71,10 @@ export function locateWrit(bin, env = process.env) {
     const fromEnv = env.WRIT_BIN;
     if (fromEnv !== undefined && fromEnv !== "")
         return launchFor(fromEnv);
-    const found = findOnPath("writ", env);
+    const found = bundledWrit() ?? findOnPath("writ", env);
     if (found === undefined) {
-        throw new WritUnavailableError("writ binary not found: set WRIT_BIN or put writ on PATH (fail closed: no tool call will run)");
+        throw new WritUnavailableError("writ binary not found: install @writ-agent/cli, set WRIT_BIN, or put writ on PATH " +
+            "(fail closed: no tool call will run)");
     }
     return { command: found, args: [] };
 }

package/dist/esm/self.d.ts

@@ -0,0 +1 @@
+export declare const selfUrl: string | undefined;

package/dist/esm/self.js

@@ -0,0 +1 @@
+export const selfUrl = import.meta.url;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@writ-agent/sdk",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "TypeScript/Node client for the writ hook gateway: policy-checked, ledger-recorded tool calls for AI agents (Claude Agent SDK hooks, generic tool wrappers).",
   "license": "Apache-2.0",
   "type": "module",
@@ -91,5 +91,8 @@
   "homepage": "https://github.com/writ-agent/writ/tree/main/adapters/typescript#readme",
   "bugs": {
     "url": "https://github.com/writ-agent/writ/issues"
+  },
+  "optionalDependencies": {
+    "@writ-agent/cli": "0.1.1"
   }
 }