@responsibleai/agent-hooks 0.1.0-alpha.5 → 0.1.0-beta.2

package/dist/index.js

@@ -7,7 +7,7 @@
  * `policy-engine/sdk/node/src/index.ts`.
  */
 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;
@@ -251,6 +251,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 +268,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

@@ -6,9 +6,12 @@
  * 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: {
@@ -26,4 +29,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

@@ -15,12 +15,16 @@ exports.native = exports.AgentHooksCoreError = void 0;
 // 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";
     }
 }
@@ -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-alpha.5",
+  "version": "0.1.0-beta.2",
   "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-alpha.5",
-    "@responsibleai/agent-hooks-linux-arm64-gnu": "0.1.0-alpha.5",
-    "@responsibleai/agent-hooks-darwin-x64": "0.1.0-alpha.5",
-    "@responsibleai/agent-hooks-darwin-arm64": "0.1.0-alpha.5",
-    "@responsibleai/agent-hooks-win32-x64-msvc": "0.1.0-alpha.5"
+    "@responsibleai/agent-hooks-linux-x64-gnu": "0.1.0-beta.2",
+    "@responsibleai/agent-hooks-linux-arm64-gnu": "0.1.0-beta.2",
+    "@responsibleai/agent-hooks-darwin-x64": "0.1.0-beta.2",
+    "@responsibleai/agent-hooks-darwin-arm64": "0.1.0-beta.2",
+    "@responsibleai/agent-hooks-win32-x64-msvc": "0.1.0-beta.2"
   }
 }