@responsibleai/agent-hooks 0.1.0-beta.1 → 0.1.0-beta.3

package/dist/index.js

@@ -1,13 +1,7 @@
 "use strict";
-// Copyright (c) Microsoft Corporation.
-// Licensed under the MIT License.
-/**
- * agent-hooks: framework-neutral agent lifecycle hook contract.
- * Implements AGENT-HOOKS-0.1. Lifted and adapted from
- * `policy-engine/sdk/node/src/index.ts`.
- */
+// Copyright (c) Microsoft. All rights reserved.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.InterceptionBlocked = exports.InterceptionEmitter = exports.AgentContextBuilder = exports.ApprovalOutcome = exports.Composition = exports.CompositionProfile = exports.ALLOW = exports.Verdict = exports.HostError = exports.EnforcementMode = exports.Decision = exports.InterceptionPoint = exports.JCS_SHA256 = exports.SPEC_VERSION = exports.AgentHooksCoreError = void 0;
+exports.InterceptionBlocked = exports.validReference = exports.validKind = exports.fullKnobSupport = exports.declarationVersions = exports.canonicalDeclaration = exports.SUPPORTED_DECLARATION_VERSIONS = exports.MAX_TIMEOUT_MS = exports.MAX_KIND_LEN = exports.MAX_ID_LEN = exports.MAX_DOCUMENT_BYTES = exports.MAX_DETAIL_LEN = exports.MAX_DEPTH = exports.MAX_BINDINGS = exports.HostSurface = exports.HostRegistryError = exports.HostRegistry = exports.HostDeclaration = exports.DeclarationErrorClass = exports.DeclarationError = exports.DeclarationBuilder = exports.DECLARATION_VERSION = exports.CAPABILITIES = exports.EmitterSealed = exports.InterceptionEmitter = exports.AgentContextBuilder = exports.ApprovalOutcome = exports.Composition = exports.CompositionProfile = exports.ALLOW = exports.Verdict = exports.HostError = exports.EnforcementMode = exports.Decision = exports.InterceptionPoint = exports.JCS_SHA256 = exports.SPEC_VERSION = exports.AgentHooksCoreError = void 0;
 exports.transformPermitted = transformPermitted;
 exports.permits = permits;
 exports.hostErrorVerdict = hostErrorVerdict;
@@ -19,11 +13,18 @@ exports.nonFiniteDetail = nonFiniteDetail;
 exports.canonicalJson = canonicalJson;
 exports.contextIdentity = contextIdentity;
 exports.validateVerdict = validateVerdict;
+exports.parseInterceptorResponse = parseInterceptorResponse;
+exports.serializeInterceptorResponse = serializeInterceptorResponse;
 exports.applyTransform = applyTransform;
 exports.applyTransformCtx = applyTransformCtx;
 exports.validateTransformCtx = validateTransformCtx;
 exports.finalize = finalize;
 exports.composeAggregate = composeAggregate;
+/**
+ * agent-hooks: framework-neutral agent lifecycle hook contract.
+ * Implements AGENT-HOOKS-0.1. Lifted and adapted from
+ * `policy-engine/sdk/node/src/index.ts`.
+ */
 const native_1 = require("./native");
 Object.defineProperty(exports, "AgentHooksCoreError", { enumerable: true, get: function () { return native_1.AgentHooksCoreError; } });
 /** Spec version this SDK implements (§4.1 `spec` field). */
@@ -225,6 +226,21 @@ function contextIdentity(ctx) {
 function validateVerdict(v) {
     native_1.native.validateVerdict(marshal(v));
 }
+/** Parse a bare Verdict or §5.5 response envelope. */
+function parseInterceptorResponse(value) {
+    const wire = typeof value === "string" ? value : marshal(value);
+    return JSON.parse(native_1.native.normalizeInterceptorResponse(wire));
+}
+/** Emit a bare Verdict when the response carries no transport metadata. */
+function serializeInterceptorResponse(response) {
+    if (response.extensions == null || Object.keys(response.extensions).length === 0) {
+        return response.verdict;
+    }
+    return {
+        verdict: response.verdict,
+        extensions: response.extensions,
+    };
+}
 /** §5.2: apply a `$target`-rooted transform. Returns a new object. Rust core. */
 function applyTransform(target, path, value) {
     return JSON.parse(native_1.native.applyTransform(marshal(target), path, marshal(value)));
@@ -251,6 +267,7 @@ function finalize(ctx, verdict, mode, meta) {
         enforced_identity: meta.enforced_identity ?? null,
         decided_by: meta.decided_by ?? null,
         composition: meta.composition,
+        declaration: meta.declaration ?? null,
         verdicts: meta.verdicts ?? null,
         fold_truncated: meta.fold_truncated ?? null,
         resolved_by: meta.resolved_by ?? null,
@@ -267,6 +284,30 @@ var builder_1 = require("./builder");
 Object.defineProperty(exports, "AgentContextBuilder", { enumerable: true, get: function () { return builder_1.AgentContextBuilder; } });
 var emitter_1 = require("./emitter");
 Object.defineProperty(exports, "InterceptionEmitter", { enumerable: true, get: function () { return emitter_1.InterceptionEmitter; } });
+Object.defineProperty(exports, "EmitterSealed", { enumerable: true, get: function () { return emitter_1.EmitterSealed; } });
+var declaration_1 = require("./declaration");
+Object.defineProperty(exports, "CAPABILITIES", { enumerable: true, get: function () { return declaration_1.CAPABILITIES; } });
+Object.defineProperty(exports, "DECLARATION_VERSION", { enumerable: true, get: function () { return declaration_1.DECLARATION_VERSION; } });
+Object.defineProperty(exports, "DeclarationBuilder", { enumerable: true, get: function () { return declaration_1.DeclarationBuilder; } });
+Object.defineProperty(exports, "DeclarationError", { enumerable: true, get: function () { return declaration_1.DeclarationError; } });
+Object.defineProperty(exports, "DeclarationErrorClass", { enumerable: true, get: function () { return declaration_1.DeclarationErrorClass; } });
+Object.defineProperty(exports, "HostDeclaration", { enumerable: true, get: function () { return declaration_1.HostDeclaration; } });
+Object.defineProperty(exports, "HostRegistry", { enumerable: true, get: function () { return declaration_1.HostRegistry; } });
+Object.defineProperty(exports, "HostRegistryError", { enumerable: true, get: function () { return declaration_1.HostRegistryError; } });
+Object.defineProperty(exports, "HostSurface", { enumerable: true, get: function () { return declaration_1.HostSurface; } });
+Object.defineProperty(exports, "MAX_BINDINGS", { enumerable: true, get: function () { return declaration_1.MAX_BINDINGS; } });
+Object.defineProperty(exports, "MAX_DEPTH", { enumerable: true, get: function () { return declaration_1.MAX_DEPTH; } });
+Object.defineProperty(exports, "MAX_DETAIL_LEN", { enumerable: true, get: function () { return declaration_1.MAX_DETAIL_LEN; } });
+Object.defineProperty(exports, "MAX_DOCUMENT_BYTES", { enumerable: true, get: function () { return declaration_1.MAX_DOCUMENT_BYTES; } });
+Object.defineProperty(exports, "MAX_ID_LEN", { enumerable: true, get: function () { return declaration_1.MAX_ID_LEN; } });
+Object.defineProperty(exports, "MAX_KIND_LEN", { enumerable: true, get: function () { return declaration_1.MAX_KIND_LEN; } });
+Object.defineProperty(exports, "MAX_TIMEOUT_MS", { enumerable: true, get: function () { return declaration_1.MAX_TIMEOUT_MS; } });
+Object.defineProperty(exports, "SUPPORTED_DECLARATION_VERSIONS", { enumerable: true, get: function () { return declaration_1.SUPPORTED_DECLARATION_VERSIONS; } });
+Object.defineProperty(exports, "canonicalDeclaration", { enumerable: true, get: function () { return declaration_1.canonicalDeclaration; } });
+Object.defineProperty(exports, "declarationVersions", { enumerable: true, get: function () { return declaration_1.declarationVersions; } });
+Object.defineProperty(exports, "fullKnobSupport", { enumerable: true, get: function () { return declaration_1.fullKnobSupport; } });
+Object.defineProperty(exports, "validKind", { enumerable: true, get: function () { return declaration_1.validKind; } });
+Object.defineProperty(exports, "validReference", { enumerable: true, get: function () { return declaration_1.validReference; } });
 class InterceptionBlocked extends Error {
     result;
     constructor(result) {

package/dist/native.d.ts

@@ -1,14 +1,10 @@
-/**
- * Loader for the napi-rs native module + typed re-export.
- *
- * `@napi-rs/cli build` emits `agent-hooks.<platform>.node` alongside a
- * generated `index.js` loader; this module re-exports it with types and
- * the `AgentHooksCoreError` unwrapping so callers get `.code`.
- */
 /** Thrown by every native function on failure. `.code` is the §11
- *  `host_error:*` wire string. */
+ *  `host_error:*` wire string, or a §7.7.6 `declaration_error:*`
+ *  string from the declaration functions (the detail is then JSON
+ *  findings, which `declaration.ts` retypes as `DeclarationError`). */
 export declare class AgentHooksCoreError extends Error {
     readonly code: string;
+    readonly detail: string;
     constructor(code: string, detail: string);
 }
 export declare const native: {
@@ -16,6 +12,7 @@ export declare const native: {
     canonicalJson: (valueJson: string) => string;
     contextIdentity: (ctxJson: string) => string;
     validateVerdict: (verdictJson: string) => string;
+    normalizeInterceptorResponse: (responseJson: string) => string;
     validateEnvelope: (ctxJson: string) => string;
     applyTransform: (targetJson: string, path: string, valueJson: string) => string;
     applyTransformCtx: (ctxJson: string, path: string, valueJson: string) => string;
@@ -26,4 +23,8 @@ export declare const native: {
     ctkScriptedResolve: (rulesJson: string, ctxJson: string, identity: string) => string;
     ctkShouldSkip: (vectorJson: string, capsJson: string) => string;
     ctkAssert: (vectorJson: string, recordedJson: string, runRecordJson: string) => string;
+    declarationVersions: () => string;
+    declarationValidate: (documentJson: string) => string;
+    declarationResolve: (documentJson: string, hostJson: string) => string;
+    declarationResolveSurface: (documentJson: string, surfaceJson: string) => string;
 };

package/dist/native.js

@@ -1,6 +1,7 @@
 "use strict";
-// Copyright (c) Microsoft Corporation.
-// Licensed under the MIT License.
+// Copyright (c) Microsoft. All rights reserved.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.native = exports.AgentHooksCoreError = void 0;
 /**
  * Loader for the napi-rs native module + typed re-export.
  *
@@ -8,19 +9,21 @@
  * generated `index.js` loader; this module re-exports it with types and
  * the `AgentHooksCoreError` unwrapping so callers get `.code`.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.native = exports.AgentHooksCoreError = void 0;
 // napi-rs emits a platform-detecting loader at ../binding.js (see
 // package.json scripts.build:native --js binding.js).
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const binding = require("../binding.js");
 /** Thrown by every native function on failure. `.code` is the §11
- *  `host_error:*` wire string. */
+ *  `host_error:*` wire string, or a §7.7.6 `declaration_error:*`
+ *  string from the declaration functions (the detail is then JSON
+ *  findings, which `declaration.ts` retypes as `DeclarationError`). */
 class AgentHooksCoreError extends Error {
     code;
+    detail;
     constructor(code, detail) {
         super(`${code}: ${detail}`);
         this.code = code;
+        this.detail = detail;
         this.name = "AgentHooksCoreError";
     }
 }
@@ -44,6 +47,7 @@ exports.native = {
     canonicalJson: wrap(binding.canonicalJson),
     contextIdentity: wrap(binding.contextIdentity),
     validateVerdict: wrap(binding.validateVerdict),
+    normalizeInterceptorResponse: wrap(binding.normalizeInterceptorResponse),
     validateEnvelope: wrap(binding.validateEnvelope),
     applyTransform: wrap(binding.applyTransform),
     applyTransformCtx: wrap(binding.applyTransformCtx),
@@ -54,4 +58,8 @@ exports.native = {
     ctkScriptedResolve: wrap(binding.ctkScriptedResolve),
     ctkShouldSkip: wrap(binding.ctkShouldSkip),
     ctkAssert: wrap(binding.ctkAssert),
+    declarationVersions: binding.declarationVersions,
+    declarationValidate: wrap(binding.declarationValidate),
+    declarationResolve: wrap(binding.declarationResolve),
+    declarationResolveSurface: wrap(binding.declarationResolveSurface),
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@responsibleai/agent-hooks",
-  "version": "0.1.0-beta.1",
+  "version": "0.1.0-beta.3",
   "description": "Framework-neutral agent control contract (AGENT-HOOKS-0.1). TypeScript wrapper over the canonical Rust core. Cooperative contract, not a security boundary: the host is fully trusted (see SECURITY.md).",
   "license": "MIT",
   "main": "./dist/index.js",
@@ -44,10 +44,10 @@
     "node": ">=20"
   },
   "optionalDependencies": {
-    "@responsibleai/agent-hooks-linux-x64-gnu": "0.1.0-beta.1",
-    "@responsibleai/agent-hooks-linux-arm64-gnu": "0.1.0-beta.1",
-    "@responsibleai/agent-hooks-darwin-x64": "0.1.0-beta.1",
-    "@responsibleai/agent-hooks-darwin-arm64": "0.1.0-beta.1",
-    "@responsibleai/agent-hooks-win32-x64-msvc": "0.1.0-beta.1"
+    "@responsibleai/agent-hooks-linux-x64-gnu": "0.1.0-beta.3",
+    "@responsibleai/agent-hooks-linux-arm64-gnu": "0.1.0-beta.3",
+    "@responsibleai/agent-hooks-darwin-x64": "0.1.0-beta.3",
+    "@responsibleai/agent-hooks-darwin-arm64": "0.1.0-beta.3",
+    "@responsibleai/agent-hooks-win32-x64-msvc": "0.1.0-beta.3"
   }
 }