@agent-assembly/sdk 0.0.1-alpha.3

package/dist/esm/audit/encode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode.js","sourceRoot":"","sources":["../../../src/audit/encode.ts"],"names":[],"mappings":"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"}

package/dist/esm/audit/index.js

@@ -0,0 +1,2 @@
+export { decodeAuditEvent, decodeCallStackNode, encodeAuditEvent, encodeCallStackNode, } from "./encode.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/audit/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,aAAa,CAAC"}

package/dist/esm/core/gateway-resolver.js

@@ -0,0 +1,213 @@
+import { spawn } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, resolve as resolvePath } from "node:path";
+import { ConfigurationError, GatewayError } from "../errors/index.js";
+/**
+ * Resolve the gateway URL and API key for ``initAssembly``.
+ *
+ * Implements the zero-config developer-experience contract from Epic 17 (S-G):
+ * ``initAssembly({})`` with no fields and no environment variables should
+ * discover a local gateway at ``http://localhost:7391`` — probing it, and
+ * auto-starting ``aasm start --mode local --foreground`` when not running.
+ *
+ * Resolution precedence (highest first):
+ *
+ *   1. Explicit field on the AssemblyConfig
+ *   2. Environment variable (AAASM_GATEWAY_URL / AAASM_API_KEY)
+ *   3. Config file (~/.aasm/config.yaml, optional js-yaml soft dep)
+ *   4. Local default: probe http://localhost:7391, auto-start if absent
+ */
+export const DEFAULT_GATEWAY_URL = "http://localhost:7391";
+export const DEFAULT_HEALTHZ_PATH = "/healthz";
+export const DEFAULT_PROBE_TIMEOUT_MS = 500;
+export const DEFAULT_AUTO_START_TIMEOUT_MS = 5000;
+export const DEFAULT_CONFIG_FILE_PATH = "~/.aasm/config.yaml";
+export const ENV_GATEWAY_URL = "AAASM_GATEWAY_URL";
+export const ENV_API_KEY = "AAASM_API_KEY";
+export const AASM_AUTO_START_ARGV = ["start", "--mode", "local", "--foreground"];
+/**
+ * Return true if a gateway responds with a 2xx status at ``{baseUrl}/healthz``.
+ *
+ * Uses the global ``fetch`` (Node 18+) with an AbortController-driven
+ * timeout. Any network / timeout / parse error is swallowed and reported
+ * as ``false`` — the resolver treats unreachable as "absent" rather than
+ * fatal.
+ */
+export async function probeHealthz(baseUrl, timeoutMs = DEFAULT_PROBE_TIMEOUT_MS) {
+    const url = baseUrl.replace(/\/+$/, "") + DEFAULT_HEALTHZ_PATH;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(url, { signal: controller.signal });
+        return response.status >= 200 && response.status < 300;
+    }
+    catch {
+        return false;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * Poll the gateway healthz endpoint until success or timeout.
+ *
+ * Resolves ``true`` as soon as ``probeHealthz`` succeeds, ``false`` if
+ * the gateway has not become ready within ``timeoutMs``. The poll
+ * interval is short (default 100ms) so the auto-start path feels
+ * instant when the local CP comes up quickly.
+ */
+export async function waitForHealthz(baseUrl, timeoutMs = DEFAULT_AUTO_START_TIMEOUT_MS, pollIntervalMs = 100) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (await probeHealthz(baseUrl)) {
+            return true;
+        }
+        await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
+    }
+    return probeHealthz(baseUrl);
+}
+function expandHome(p) {
+    return p.startsWith("~") ? resolvePath(homedir(), p.slice(p.startsWith("~/") ? 2 : 1)) : p;
+}
+/**
+ * Load ``~/.aasm/config.yaml`` if present.
+ *
+ * Returns an empty record when the file is missing, when ``js-yaml`` is
+ * not installed (it is a soft dependency for SDK consumers), or when
+ * the file's contents are not an object. This keeps the resolver chain
+ * purely advisory at step 3 — never throws.
+ */
+export async function loadConfigFile(configPath = DEFAULT_CONFIG_FILE_PATH) {
+    // Indirect specifier defeats static module resolution so missing js-yaml
+    // surfaces at runtime (caught below) rather than as a TS compile error.
+    const yamlSpec = "js-yaml";
+    let yamlMod;
+    try {
+        yamlMod = (await import(yamlSpec));
+    }
+    catch {
+        return {};
+    }
+    const expanded = expandHome(configPath);
+    if (!existsSync(expanded)) {
+        return {};
+    }
+    try {
+        const parsed = yamlMod.load(readFileSync(expanded, "utf8"));
+        return parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)
+            ? parsed
+            : {};
+    }
+    catch {
+        return {};
+    }
+}
+function defaultFindAasmOnPath() {
+    const PATH = process.env.PATH ?? "";
+    const sep = process.platform === "win32" ? ";" : ":";
+    const exts = process.platform === "win32" ? [".exe", ".cmd", ""] : [""];
+    for (const dir of PATH.split(sep)) {
+        if (!dir)
+            continue;
+        for (const ext of exts) {
+            const candidate = join(dir, `aasm${ext}`);
+            if (existsSync(candidate))
+                return candidate;
+        }
+    }
+    return null;
+}
+function defaultSpawnAasm(aasmPath) {
+    const child = spawn(aasmPath, [...AASM_AUTO_START_ARGV], {
+        detached: true,
+        stdio: "ignore",
+    });
+    child.unref();
+}
+/**
+ * Mutable seams used by ``autoStartGateway`` — exposed via ``__testing``
+ * so tests can stub the PATH lookup and subprocess spawn without using
+ * ESM module mocking. Production callers should treat this as private.
+ */
+const _seams = {
+    findAasmOnPath: defaultFindAasmOnPath,
+    spawnAasm: defaultSpawnAasm,
+    probeHealthz: probeHealthz,
+    loadConfigFile: loadConfigFile,
+    autoStartGateway: autoStartGateway,
+};
+export const __testing = { _seams };
+/**
+ * Spawn ``aasm start --mode local --foreground`` and wait until ``/healthz``
+ * responds.
+ *
+ * Throws ``ConfigurationError`` when the ``aasm`` binary is missing from
+ * PATH — the SDK cannot meaningfully auto-start without it. Throws
+ * ``GatewayError`` when the spawned gateway does not become ready within
+ * ``timeoutMs``. The subprocess is launched detached + stdio:"ignore" so
+ * it survives the parent Node process — the docker-style daemon hand-off
+ * described in Epic 17 S-G.
+ */
+export async function autoStartGateway(baseUrl = DEFAULT_GATEWAY_URL, timeoutMs = DEFAULT_AUTO_START_TIMEOUT_MS) {
+    const aasmPath = _seams.findAasmOnPath();
+    if (aasmPath === null) {
+        throw new ConfigurationError(`No gateway found at ${baseUrl} and 'aasm' is not on PATH. ` +
+            "Install it with: npm install -g @agent-assembly/cli (or pnpm add -g)");
+    }
+    _seams.spawnAasm(aasmPath);
+    if (!(await waitForHealthz(baseUrl, timeoutMs))) {
+        throw new GatewayError(`Auto-started gateway at ${baseUrl} did not become ready ` +
+            `within ${(timeoutMs / 1000).toFixed(0)} seconds`);
+    }
+}
+/**
+ * Resolve the gateway URL using the 4-step precedence chain.
+ *
+ * Returns the resolved URL. May spawn a local ``aasm`` subprocess
+ * (step 4 only). Propagates ``ConfigurationError`` / ``GatewayError``
+ * from ``autoStartGateway`` when the local default is needed but
+ * cannot be brought up.
+ */
+export async function resolveGatewayUrl(explicit) {
+    if (explicit)
+        return explicit;
+    const fromEnv = process.env[ENV_GATEWAY_URL];
+    if (fromEnv)
+        return fromEnv;
+    const config = await _seams.loadConfigFile();
+    const agent = config["agent"];
+    if (agent !== null && typeof agent === "object") {
+        const url = agent["gateway_url"];
+        if (typeof url === "string" && url.length > 0)
+            return url;
+    }
+    if (await _seams.probeHealthz(DEFAULT_GATEWAY_URL)) {
+        return DEFAULT_GATEWAY_URL;
+    }
+    await _seams.autoStartGateway(DEFAULT_GATEWAY_URL);
+    return DEFAULT_GATEWAY_URL;
+}
+/**
+ * Resolve the API key using the same 4-step precedence as the URL.
+ *
+ * Returns the resolved key (possibly empty for local mode, which
+ * accepts unauthenticated agents). Never rejects — an empty API key
+ * is the documented "local dev" default per Epic 17.
+ */
+export async function resolveApiKey(explicit) {
+    if (explicit)
+        return explicit;
+    const fromEnv = process.env[ENV_API_KEY];
+    if (fromEnv)
+        return fromEnv;
+    const config = await _seams.loadConfigFile();
+    const agent = config["agent"];
+    if (agent !== null && typeof agent === "object") {
+        const apiKey = agent["api_key"];
+        if (typeof apiKey === "string" && apiKey.length > 0)
+            return apiKey;
+    }
+    return "";
+}
+//# sourceMappingURL=gateway-resolver.js.map

package/dist/esm/core/gateway-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-resolver.js","sourceRoot":"","sources":["../../../src/core/gateway-resolver.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/index.js

@@ -0,0 +1,2 @@
+export { createClient, detectFrameworks, initAssembly, registerAdapters, startNetworkLayerIfNeeded } from "./init-assembly.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,yBAAyB,EAC1B,MAAM,oBAAoB,CAAC"}

package/dist/esm/core/init-assembly.js

@@ -0,0 +1,218 @@
+import { createRequire } from "node:module";
+import { AssemblyCallbackHandler, wrapToolWithAssembly } from "../adapters/langchain/index.js";
+import { createNoopGatewayClient } from "../gateway/client.js";
+import { createNativeClient } from "../native/client.js";
+import { ENFORCEMENT_MODES } from "../types/enforcement-mode.js";
+import { hasVercelAiSdk } from "../hooks/ai-sdk-detection.js";
+import { patchVercelAiSdk } from "../hooks/ai-sdk.js";
+import { hasLangGraph } from "../hooks/langgraph-detection.js";
+import { patchLangGraph } from "../hooks/langgraph.js";
+import { hasMastra } from "../hooks/mastra-detection.js";
+import { patchMastra } from "../hooks/mastra.js";
+import { hasOpenAIAgentsSDK } from "../hooks/openai-agents-detection.js";
+import { patchOpenAIAgents } from "../hooks/openai-agents.js";
+import { currentAgentId } from "../lineage/index.js";
+import { resolveApiKey, resolveGatewayUrl } from "./gateway-resolver.js";
+const requireFromCwd = createRequire(`${process.cwd()}/`);
+function buildRegistrationEvent(config) {
+    const event = { event_type: "register" };
+    if (config.parentAgentId !== undefined)
+        event.parent_agent_id = config.parentAgentId;
+    if (config.teamId !== undefined)
+        event.team_id = config.teamId;
+    if (config.delegationReason !== undefined)
+        event.delegation_reason = config.delegationReason;
+    if (config.spawnedByTool !== undefined)
+        event.spawned_by_tool = config.spawnedByTool;
+    // AAASM-1561: per-agent enforcement_mode override. Sent only when the
+    // caller set it explicitly so a pre-feature SDK call produces a pre-feature
+    // wire shape. The gateway's REST → gRPC bridge maps the snake_case token
+    // onto RegisterRequest.enforcement_mode (proto enum) per AAASM-1555.
+    if (config.enforcementMode !== undefined)
+        event.enforcement_mode = config.enforcementMode;
+    return event;
+}
+export function createClient(config) {
+    const mode = config.mode ?? "auto";
+    if (config.gatewayClient) {
+        return config.gatewayClient;
+    }
+    return createNoopGatewayClient(mode);
+}
+function isPackageInstalled(packageName) {
+    try {
+        requireFromCwd.resolve(packageName);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function detectFrameworks() {
+    const detected = [];
+    if (isPackageInstalled("@langchain/core")) {
+        detected.push("langchain-js");
+    }
+    if (hasVercelAiSdk()) {
+        detected.push("vercel-ai-sdk");
+    }
+    if (hasOpenAIAgentsSDK()) {
+        detected.push("openai-agents");
+    }
+    if (hasLangGraph()) {
+        detected.push("langgraph-js");
+    }
+    if (hasMastra()) {
+        detected.push("mastra");
+    }
+    return detected;
+}
+function createAdapter(id) {
+    return {
+        id,
+        apply: async () => undefined
+    };
+}
+export async function registerAdapters(frameworks) {
+    const adapters = frameworks.map((framework) => createAdapter(framework));
+    for (const adapter of adapters) {
+        await adapter.apply();
+    }
+    return adapters;
+}
+export async function startNetworkLayerIfNeeded(client, config) {
+    if (config.mode === "sdk-only") {
+        return;
+    }
+    await client.start();
+}
+function ensureLangChainCallbacks(config) {
+    config.langchain ??= {};
+    config.langchain.callbacks ??= [];
+    return config.langchain.callbacks;
+}
+function ensureLangChainTools(config) {
+    config.langchain ??= {};
+    config.langchain.tools ??= {};
+    return config.langchain.tools;
+}
+function registerLangChainHandler(config, client, frameworks) {
+    if (!frameworks.includes("langchain-js") && !config.langchain) {
+        return undefined;
+    }
+    const callbacks = ensureLangChainCallbacks(config);
+    const handler = new AssemblyCallbackHandler(client);
+    callbacks.push(handler);
+    return handler;
+}
+function wrapLangChainTools(config, client, frameworks) {
+    if (!frameworks.includes("langchain-js") && !config.langchain) {
+        return [];
+    }
+    const tools = ensureLangChainTools(config);
+    const wrapperOptions = {
+        ...(config.langchain?.approvalTimeoutMs
+            ? { approvalTimeoutMs: config.langchain.approvalTimeoutMs }
+            : {})
+    };
+    for (const tool of Object.values(tools)) {
+        wrapToolWithAssembly(tool, client, wrapperOptions);
+    }
+    return Object.keys(tools);
+}
+async function patchDetectedVercelAiSdk(client, frameworks, agentId) {
+    if (!frameworks.includes("vercel-ai-sdk")) {
+        return false;
+    }
+    return patchVercelAiSdk({
+        gatewayClient: client,
+        ...(agentId !== undefined ? { agentId } : {})
+    });
+}
+async function patchDetectedLangGraph(frameworks, agentId) {
+    if (!frameworks.includes("langgraph-js") || !agentId) {
+        return false;
+    }
+    return patchLangGraph({ agentId });
+}
+async function patchDetectedMastra(frameworks, agentId) {
+    if (!frameworks.includes("mastra") || !agentId) {
+        return false;
+    }
+    return patchMastra({ agentId });
+}
+async function patchDetectedOpenAIAgents(client, frameworks) {
+    if (!frameworks.includes("openai-agents")) {
+        return false;
+    }
+    return patchOpenAIAgents({ gatewayClient: client });
+}
+export async function initAssembly(config = {}) {
+    if (config.delegationReason !== undefined && config.delegationReason.length > 256) {
+        throw new RangeError("delegationReason must be <= 256 characters");
+    }
+    // AAASM-1561: catch invalid enforcementMode strings from non-TS callers
+    // (plain JS, JSON config, dynamic input) so the agent doesn't silently
+    // register under live enforcement when the operator meant observe.
+    if (config.enforcementMode !== undefined && !ENFORCEMENT_MODES.includes(config.enforcementMode)) {
+        throw new RangeError(`enforcementMode must be one of: ${ENFORCEMENT_MODES.join(", ")} (got: ${String(config.enforcementMode)})`);
+    }
+    // Auto-populate parentAgentId from the async context store when not explicitly provided.
+    // This allows child agents spawned inside framework hooks to inherit lineage automatically.
+    const resolvedParentAgentId = config.parentAgentId ?? currentAgentId();
+    const resolvedGatewayUrl = await resolveGatewayUrl(config.gatewayUrl);
+    const resolvedApiKey = await resolveApiKey(config.apiKey);
+    const resolvedConfig = {
+        ...config,
+        gatewayUrl: resolvedGatewayUrl,
+        apiKey: resolvedApiKey,
+        ...(resolvedParentAgentId ? { parentAgentId: resolvedParentAgentId } : {})
+    };
+    const client = createClient(resolvedConfig);
+    const frameworks = detectFrameworks();
+    const adapters = await registerAdapters(frameworks);
+    await startNetworkLayerIfNeeded(client, resolvedConfig);
+    // Send topology registration event through the native transport on every boot
+    // except sdk-only mode (which has no sidecar to register with).
+    let nativeClient;
+    if (resolvedConfig.mode !== "sdk-only") {
+        nativeClient = createNativeClient({
+            gateway: resolvedGatewayUrl,
+            apiKey: resolvedApiKey,
+            mode: resolvedConfig.mode === "napi-inprocess" ? "napi-inprocess" : "grpc-sidecar",
+        });
+        nativeClient.sendEvent(buildRegistrationEvent(resolvedConfig));
+    }
+    const langChainHandler = registerLangChainHandler(resolvedConfig, client, frameworks);
+    const wrappedLangChainTools = wrapLangChainTools(resolvedConfig, client, frameworks);
+    const vercelAiSdkPatched = await patchDetectedVercelAiSdk(client, frameworks, resolvedConfig.agentId);
+    const openAIAgentsPatched = await patchDetectedOpenAIAgents(client, frameworks);
+    const langGraphPatched = await patchDetectedLangGraph(frameworks, resolvedConfig.agentId);
+    const mastraPatched = await patchDetectedMastra(frameworks, resolvedConfig.agentId);
+    return {
+        activeAdapters: [
+            ...new Set([
+                ...adapters.map((adapter) => adapter.id),
+                ...(langChainHandler ? ["langchain-js"] : []),
+                ...(wrappedLangChainTools.length > 0 ? ["langchain-js"] : []),
+                ...(vercelAiSdkPatched ? ["vercel-ai-sdk"] : []),
+                ...(openAIAgentsPatched ? ["openai-agents"] : []),
+                ...(langGraphPatched ? ["langgraph-js"] : []),
+                ...(mastraPatched ? ["mastra"] : [])
+            ])
+        ],
+        ...(resolvedConfig.parentAgentId !== undefined && { parentAgentId: resolvedConfig.parentAgentId }),
+        ...(resolvedConfig.teamId !== undefined && { teamId: resolvedConfig.teamId }),
+        ...(resolvedConfig.delegationReason !== undefined && { delegationReason: resolvedConfig.delegationReason }),
+        ...(resolvedConfig.spawnedByTool !== undefined && { spawnedByTool: resolvedConfig.spawnedByTool }),
+        ...(resolvedConfig.enforcementMode !== undefined && { enforcementMode: resolvedConfig.enforcementMode }),
+        shutdown: async () => {
+            for (const adapter of adapters) {
+                await adapter.shutdown?.();
+            }
+            await nativeClient?.close();
+            await client.close();
+        }
+    };
+}
+//# sourceMappingURL=init-assembly.js.map

package/dist/esm/core/init-assembly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-assembly.js","sourceRoot":"","sources":["../../../src/core/init-assembly.ts"],"names":[],"mappings":"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"}

package/dist/esm/errors/configuration-error.js

@@ -0,0 +1,14 @@
+/**
+ * Thrown when the SDK cannot resolve the gateway configuration —
+ * e.g. the local gateway is absent and ``aasm`` is not on ``PATH``.
+ *
+ * Mirrors ``agent_assembly.exceptions.ConfigurationError`` in the
+ * Python SDK so the cross-SDK error contract stays aligned per Epic 17 S-G.
+ */
+export class ConfigurationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ConfigurationError";
+    }
+}
+//# sourceMappingURL=configuration-error.js.map

package/dist/esm/errors/configuration-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration-error.js","sourceRoot":"","sources":["../../../src/errors/configuration-error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF"}

package/dist/esm/errors/gateway-error.js

@@ -0,0 +1,14 @@
+/**
+ * Thrown when the SDK has a gateway URL but cannot talk to it —
+ * e.g. ``aasm`` was spawned but ``/healthz`` did not become ready
+ * within the auto-start timeout window.
+ *
+ * Mirrors ``agent_assembly.exceptions.GatewayError`` in the Python SDK.
+ */
+export class GatewayError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "GatewayError";
+    }
+}
+//# sourceMappingURL=gateway-error.js.map

package/dist/esm/errors/gateway-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-error.js","sourceRoot":"","sources":["../../../src/errors/gateway-error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF"}

package/dist/esm/errors/index.js

@@ -0,0 +1,5 @@
+export { ConfigurationError } from "./configuration-error.js";
+export { GatewayError } from "./gateway-error.js";
+export { OpTerminatedError } from "./op-terminated-error.js";
+export { PolicyViolationError } from "./policy-violation-error.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/esm/errors/op-terminated-error.js

@@ -0,0 +1,17 @@
+/**
+ * Raised when the gateway terminates an in-flight op (AAASM-1422 PR-F).
+ *
+ * Carries the originating `opId` so callers can correlate the failure
+ * against the operation they were awaiting. Surfaced by
+ * `OpControlSubscriber.waitForOp` when an `OP_CONTROL_SIGNAL_TERMINATE`
+ * arrives for the awaited op.
+ */
+export class OpTerminatedError extends Error {
+    opId;
+    constructor(message, opId) {
+        super(message);
+        this.name = "OpTerminatedError";
+        this.opId = opId;
+    }
+}
+//# sourceMappingURL=op-terminated-error.js.map

package/dist/esm/errors/op-terminated-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"op-terminated-error.js","sourceRoot":"","sources":["../../../src/errors/op-terminated-error.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1B,IAAI,CAAS;IAE7B,YAAY,OAAe,EAAE,IAAY;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/esm/errors/policy-violation-error.js

@@ -0,0 +1,7 @@
+export class PolicyViolationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "PolicyViolationError";
+    }
+}
+//# sourceMappingURL=policy-violation-error.js.map

package/dist/esm/errors/policy-violation-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-violation-error.js","sourceRoot":"","sources":["../../../src/errors/policy-violation-error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF"}

package/dist/esm/gateway/client.js

@@ -0,0 +1,13 @@
+export function createNoopGatewayClient(mode) {
+    return {
+        mode,
+        start: async () => undefined,
+        close: async () => undefined,
+        check: async () => ({ denied: false, pending: false }),
+        waitForApproval: async () => ({ denied: false }),
+        record: async () => undefined,
+        recordResult: async () => undefined,
+        scanPrompts: async () => undefined
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/gateway/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/gateway/client.ts"],"names":[],"mappings":"AAyBA,MAAM,UAAU,uBAAuB,CAAC,IAAkB;IACxD,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;QAC5B,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;QAC5B,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACtD,eAAe,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAChD,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;QAC7B,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;QACnC,WAAW,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;KACnC,CAAC;AACJ,CAAC"}

package/dist/esm/gateway/index.js

@@ -0,0 +1,2 @@
+export { createNoopGatewayClient } from "./client.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/gateway/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC"}

package/dist/esm/hooks/adapter-registry.js

@@ -0,0 +1,5 @@
+import { patchLangChain } from "./langchain.js";
+export async function registerFrameworkHooks(client) {
+    await patchLangChain(client);
+}
+//# sourceMappingURL=adapter-registry.js.map

package/dist/esm/hooks/adapter-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-registry.js","sourceRoot":"","sources":["../../../src/hooks/adapter-registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,MAAoB;IAC/D,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC"}

package/dist/esm/hooks/ai-sdk-detection.js

@@ -0,0 +1,12 @@
+import { createRequire } from "node:module";
+const requireFromCwd = createRequire(`${process.cwd()}/`);
+export function hasVercelAiSdk() {
+    try {
+        requireFromCwd.resolve("ai");
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=ai-sdk-detection.js.map

package/dist/esm/hooks/ai-sdk-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-sdk-detection.js","sourceRoot":"","sources":["../../../src/hooks/ai-sdk-detection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,cAAc,GAAG,aAAa,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAE1D,MAAM,UAAU,cAAc;IAC5B,IAAI,CAAC;QACH,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}