@agent-assembly/sdk 0.0.1-alpha.9.1 → 0.0.1-beta.2

package/README.md

@@ -2,7 +2,8 @@
 
 [![CI](https://github.com/ai-agent-assembly/node-sdk/actions/workflows/test-matrix.yml/badge.svg?branch=master&logo=githubactions)](https://github.com/ai-agent-assembly/node-sdk/actions/workflows/test-matrix.yml)
 [![Docs](https://github.com/ai-agent-assembly/node-sdk/actions/workflows/publish-docs.yml/badge.svg?branch=master&logo=githubactions)](https://github.com/ai-agent-assembly/node-sdk/actions/workflows/publish-docs.yml)
-[![npm version](https://img.shields.io/npm/v/@agent-assembly/sdk/alpha?logo=npm)](https://www.npmjs.com/package/@agent-assembly/sdk/v/alpha)
+[![npm version](https://img.shields.io/npm/v/%40agent-assembly%2Fsdk/beta?logo=npm)](https://www.npmjs.com/package/@agent-assembly/sdk/v/beta)
+[![GitHub release](https://img.shields.io/github/v/release/ai-agent-assembly/node-sdk?include_prereleases&sort=semver&label=release&logo=github)](https://github.com/ai-agent-assembly/node-sdk/releases)
 [![TypeScript types](https://img.shields.io/npm/types/@agent-assembly/sdk?logo=typescript)](https://www.npmjs.com/package/@agent-assembly/sdk)
 [![Bundle size](https://img.shields.io/bundlephobia/min/@agent-assembly/sdk?logo=webpack&label=min)](https://bundlephobia.com/package/@agent-assembly/sdk)
 [![Downloads](https://img.shields.io/npm/dm/@agent-assembly/sdk?logo=npm&label=downloads%2Fmo)](https://www.npmjs.com/package/@agent-assembly/sdk)
@@ -16,16 +17,17 @@ TypeScript/Node.js SDK for Agent Assembly, licensed under Apache 2.0.
 
 ## Project status
 
-> **Pre-1.0 / alpha.** The current release line is `0.0.1-alpha.x`, published to npm under
-> the `alpha` dist-tag. The public surface (`initAssembly`, `withAssembly`) is stabilizing
-> but **may change between alpha releases**, and per-platform native packaging is still
-> being hardened. Pin an exact version for reproducible installs and review the
+> **Pre-1.0 / beta.** The current release line is `0.0.1-beta.x`, published to npm under
+> the `beta` dist-tag and cut as a [GitHub Release](https://github.com/ai-agent-assembly/node-sdk/releases).
+> The public surface (`initAssembly`, `withAssembly`) is stabilizing but **may change between
+> pre-releases**, and per-platform native packaging is still being hardened. Pin an exact
+> version for reproducible installs and review the
 > [release notes](https://github.com/ai-agent-assembly/node-sdk/releases) before upgrading.
 > Production deployments should track the first `0.1.0` release.
 
 ```bash
-pnpm add @agent-assembly/sdk@alpha             # latest alpha (tracks @alpha dist-tag)
-pnpm add @agent-assembly/sdk@<X.Y.Z-alpha.N>   # pin exact — replace the placeholder with the
+pnpm add @agent-assembly/sdk@beta              # latest beta (tracks @beta dist-tag)
+pnpm add @agent-assembly/sdk@<X.Y.Z-beta.N>    # pin exact — replace the placeholder with the
                                                # desired version from npmjs.com/package/@agent-assembly/sdk
 ```
 

package/dist/cjs/hooks/index.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * Public re-exports for the per-framework governance patch hooks
+ * (AAASM-2922).
+ *
+ * These let consumers apply a single framework's governance hook manually,
+ * instead of relying on `initAssembly()` to patch every detected framework.
+ * Only the user-facing patch/unpatch/has surface and the option/module
+ * interfaces those functions take as parameters are re-exported here;
+ * internal helpers (wrappers, patch-state, capture/record utilities) stay
+ * private to their hook modules.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasOpenAIAgentsSDK = exports.unpatchOpenAIAgents = exports.patchOpenAIAgents = exports.patchLangChain = exports.hasMastra = exports.unpatchMastra = exports.patchMastra = exports.hasLangGraph = exports.unpatchLangGraph = exports.patchLangGraph = exports.hasVercelAiSdk = exports.unpatchVercelAiSdk = exports.patchVercelAiSdk = void 0;
+// Vercel AI SDK
+var ai_sdk_js_1 = require("./ai-sdk.js");
+Object.defineProperty(exports, "patchVercelAiSdk", { enumerable: true, get: function () { return ai_sdk_js_1.patchVercelAiSdk; } });
+Object.defineProperty(exports, "unpatchVercelAiSdk", { enumerable: true, get: function () { return ai_sdk_js_1.unpatchVercelAiSdk; } });
+var ai_sdk_detection_js_1 = require("./ai-sdk-detection.js");
+Object.defineProperty(exports, "hasVercelAiSdk", { enumerable: true, get: function () { return ai_sdk_detection_js_1.hasVercelAiSdk; } });
+// LangGraph
+var langgraph_js_1 = require("./langgraph.js");
+Object.defineProperty(exports, "patchLangGraph", { enumerable: true, get: function () { return langgraph_js_1.patchLangGraph; } });
+Object.defineProperty(exports, "unpatchLangGraph", { enumerable: true, get: function () { return langgraph_js_1.unpatchLangGraph; } });
+var langgraph_detection_js_1 = require("./langgraph-detection.js");
+Object.defineProperty(exports, "hasLangGraph", { enumerable: true, get: function () { return langgraph_detection_js_1.hasLangGraph; } });
+// Mastra
+var mastra_js_1 = require("./mastra.js");
+Object.defineProperty(exports, "patchMastra", { enumerable: true, get: function () { return mastra_js_1.patchMastra; } });
+Object.defineProperty(exports, "unpatchMastra", { enumerable: true, get: function () { return mastra_js_1.unpatchMastra; } });
+var mastra_detection_js_1 = require("./mastra-detection.js");
+Object.defineProperty(exports, "hasMastra", { enumerable: true, get: function () { return mastra_detection_js_1.hasMastra; } });
+// LangChain
+var langchain_js_1 = require("./langchain.js");
+Object.defineProperty(exports, "patchLangChain", { enumerable: true, get: function () { return langchain_js_1.patchLangChain; } });
+// OpenAI Agents
+var openai_agents_js_1 = require("./openai-agents.js");
+Object.defineProperty(exports, "patchOpenAIAgents", { enumerable: true, get: function () { return openai_agents_js_1.patchOpenAIAgents; } });
+Object.defineProperty(exports, "unpatchOpenAIAgents", { enumerable: true, get: function () { return openai_agents_js_1.unpatchOpenAIAgents; } });
+var openai_agents_detection_js_1 = require("./openai-agents-detection.js");
+Object.defineProperty(exports, "hasOpenAIAgentsSDK", { enumerable: true, get: function () { return openai_agents_detection_js_1.hasOpenAIAgentsSDK; } });

package/dist/cjs/index.js

@@ -1,4 +1,18 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PolicyViolationError = exports.createNoopGatewayClient = exports.findAasmBinary = exports.INSTALL_HINT = exports.runWithAgentId = exports.currentAgentId = exports.encodeCallStackNode = exports.encodeAuditEvent = exports.decodeCallStackNode = exports.decodeAuditEvent = exports.ENFORCEMENT_MODES = exports.withAssembly = exports.initAssembly = void 0;
 var init_assembly_js_1 = require("./core/init-assembly.js");
@@ -27,3 +41,8 @@ var index_js_5 = require("./gateway/index.js");
 Object.defineProperty(exports, "createNoopGatewayClient", { enumerable: true, get: function () { return index_js_5.createNoopGatewayClient; } });
 var index_js_6 = require("./errors/index.js");
 Object.defineProperty(exports, "PolicyViolationError", { enumerable: true, get: function () { return index_js_6.PolicyViolationError; } });
+// Per-framework governance patch hooks (AAASM-2922). The curated public
+// surface lives in src/hooks/index.ts; re-export it here and via the
+// `@agent-assembly/sdk/hooks` subpath so consumers can apply a single
+// framework's hook manually.
+__exportStar(require("./hooks/index.js"), exports);

package/dist/esm/hooks/index.js

@@ -0,0 +1,26 @@
+/**
+ * Public re-exports for the per-framework governance patch hooks
+ * (AAASM-2922).
+ *
+ * These let consumers apply a single framework's governance hook manually,
+ * instead of relying on `initAssembly()` to patch every detected framework.
+ * Only the user-facing patch/unpatch/has surface and the option/module
+ * interfaces those functions take as parameters are re-exported here;
+ * internal helpers (wrappers, patch-state, capture/record utilities) stay
+ * private to their hook modules.
+ */
+// Vercel AI SDK
+export { patchVercelAiSdk, unpatchVercelAiSdk } from "./ai-sdk.js";
+export { hasVercelAiSdk } from "./ai-sdk-detection.js";
+// LangGraph
+export { patchLangGraph, unpatchLangGraph } from "./langgraph.js";
+export { hasLangGraph } from "./langgraph-detection.js";
+// Mastra
+export { patchMastra, unpatchMastra } from "./mastra.js";
+export { hasMastra } from "./mastra-detection.js";
+// LangChain
+export { patchLangChain } from "./langchain.js";
+// OpenAI Agents
+export { patchOpenAIAgents, unpatchOpenAIAgents } from "./openai-agents.js";
+export { hasOpenAIAgentsSDK } from "./openai-agents-detection.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,gBAAgB;AAChB,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,SAAS;AACT,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,gBAAgB;AAChB,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/esm/index.js

@@ -11,4 +11,9 @@ export { currentAgentId, runWithAgentId } from "./lineage/index.js";
 export { INSTALL_HINT, findAasmBinary } from "./runtime.js";
 export { createNoopGatewayClient } from "./gateway/index.js";
 export { PolicyViolationError } from "./errors/index.js";
+// Per-framework governance patch hooks (AAASM-2922). The curated public
+// surface lives in src/hooks/index.ts; re-export it here and via the
+// `@agent-assembly/sdk/hooks` subpath so consumers can apply a single
+// framework's hook manually.
+export * from "./hooks/index.js";
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAYnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpE,uEAAuE;AACvE,wEAAwE;AACxE,mEAAmE;AACnE,uEAAuE;AACvE,sDAAsD;AACtD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAU5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAYnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpE,uEAAuE;AACvE,wEAAwE;AACxE,mEAAmE;AACnE,uEAAuE;AACvE,sDAAsD;AACtD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAU5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,wEAAwE;AACxE,qEAAqE;AACrE,sEAAsE;AACtE,6BAA6B;AAC7B,cAAc,kBAAkB,CAAC"}

package/dist/types/hooks/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Public re-exports for the per-framework governance patch hooks
+ * (AAASM-2922).
+ *
+ * These let consumers apply a single framework's governance hook manually,
+ * instead of relying on `initAssembly()` to patch every detected framework.
+ * Only the user-facing patch/unpatch/has surface and the option/module
+ * interfaces those functions take as parameters are re-exported here;
+ * internal helpers (wrappers, patch-state, capture/record utilities) stay
+ * private to their hook modules.
+ */
+export { patchVercelAiSdk, unpatchVercelAiSdk } from "./ai-sdk.js";
+export type { PatchVercelAiSdkOptions, VercelAiSdkModule } from "./ai-sdk.js";
+export { hasVercelAiSdk } from "./ai-sdk-detection.js";
+export { patchLangGraph, unpatchLangGraph } from "./langgraph.js";
+export type { PatchLangGraphOptions, LangGraphModule } from "./langgraph.js";
+export { hasLangGraph } from "./langgraph-detection.js";
+export { patchMastra, unpatchMastra } from "./mastra.js";
+export type { PatchMastraOptions, MastraModule } from "./mastra.js";
+export { hasMastra } from "./mastra-detection.js";
+export { patchLangChain } from "./langchain.js";
+export { patchOpenAIAgents, unpatchOpenAIAgents } from "./openai-agents.js";
+export type { PatchOpenAIAgentsOptions } from "./openai-agents.js";
+export { hasOpenAIAgentsSDK } from "./openai-agents-detection.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACnE,YAAY,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClE,YAAY,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACzD,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGlD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,YAAY,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/types/index.d.ts

@@ -11,4 +11,5 @@ export type { GatewayClient } from "./gateway/index.js";
 export type { GatewayApprovalResult, GatewayCheckRequest, GatewayDecision, GatewayPromptScan, GatewayRecordEvent, GatewayResultRecord } from "./types/index.js";
 export { createNoopGatewayClient } from "./gateway/index.js";
 export { PolicyViolationError } from "./errors/index.js";
+export * from "./hooks/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,YAAY,EACV,cAAc,EACd,eAAe,EACf,YAAY,EACZ,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,OAAO,EACR,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAMpE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EACV,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,YAAY,EACV,cAAc,EACd,eAAe,EACf,YAAY,EACZ,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,OAAO,EACR,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAMpE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EACV,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAKzD,cAAc,kBAAkB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-assembly/sdk",
-  "version": "0.0.1-alpha.9.1",
+  "version": "0.0.1-beta.2",
   "description": "TypeScript SDK for Agent Assembly",
   "license": "Apache-2.0",
   "type": "module",
@@ -21,6 +21,11 @@
       "import": "./dist/esm/index.js",
       "require": "./dist/cjs/index.js",
       "types": "./dist/types/index.d.ts"
+    },
+    "./hooks": {
+      "import": "./dist/esm/hooks/index.js",
+      "require": "./dist/cjs/hooks/index.js",
+      "types": "./dist/types/hooks/index.d.ts"
     }
   },
   "peerDependencies": {
@@ -59,10 +64,10 @@
     "nodejs"
   ],
   "optionalDependencies": {
-    "@agent-assembly/runtime-darwin-arm64": "0.0.1-alpha.9",
-    "@agent-assembly/runtime-darwin-x64": "0.0.1-alpha.9",
-    "@agent-assembly/runtime-linux-arm64": "0.0.1-alpha.9",
-    "@agent-assembly/runtime-linux-x64": "0.0.1-alpha.9"
+    "@agent-assembly/runtime-darwin-arm64": "0.0.1-beta.1",
+    "@agent-assembly/runtime-darwin-x64": "0.0.1-beta.1",
+    "@agent-assembly/runtime-linux-arm64": "0.0.1-beta.1",
+    "@agent-assembly/runtime-linux-x64": "0.0.1-beta.1"
   },
   "files": [
     "dist/",