@brightbeamai/chap-coordinator 0.2.12 → 0.3.0

package/dist/index.d.cts

@@ -1,12 +1,22 @@
-import { C as CoordinatorOptions, a as Coordinator } from './api-DiiL0sil.cjs';
-export { b as CoordinatorApi, c as CoordinatorError, d as CredentialVerifier, E as EscalationPolicyFn, H as Handler, I as IdFactory, P as PRIVILEGED_METHODS, R as ReviewDepthPolicyFn, e as RoutingPolicyFn, S as ScittReceiptVerifier, f as ScittSubmitter, T as TokenVerifier, g as call, m as makeApi } from './api-DiiL0sil.cjs';
+import { C as CoordinatorOptions, a as Coordinator } from './api-BkvwN42r.cjs';
+export { b as CoordinatorApi, c as CoordinatorError, d as CredentialVerifier, E as EscalationPolicyFn, H as Handler, I as IdFactory, P as PRIVILEGED_METHODS, R as ReviewDepthPolicyFn, e as RoutingPolicyFn, S as ScittReceiptVerifier, f as ScittSubmitter, T as TokenVerifier, g as call, m as makeApi } from './api-BkvwN42r.cjs';
 export { MethodName, MethodParams, MethodResult, MethodTable } from './methods.cjs';
+import { AuditEntry, Envelope } from './types.cjs';
+export { ArtefactId, ArtefactRoutingHints, AuditListener, Deliberation, DeliberationVote, Handoff, HandoffTaskItem, JsonPatchOp, Jwk, KeyRecord, Member, Mode, OverrideArtefact, ParticipantType, ParticipantUri, PauseScope, RefusalOutcome, ReviewDecision, RouteDecisionArtefact, SnapshotArtefact, Task, TaskId, TaskRoutingHints, TaskState, WhisperPrompt, Workspace, WorkspaceId, WorkspaceState, modeLE } from './types.cjs';
 export { MemoryStore, Store, WorkspaceRecord } from './storage/store.cjs';
-export { ArtefactId, ArtefactRoutingHints, AuditEntry, AuditListener, Deliberation, DeliberationVote, Envelope, Handoff, HandoffTaskItem, JsonPatchOp, Jwk, KeyRecord, Member, Mode, OverrideArtefact, ParticipantType, ParticipantUri, PauseScope, ReviewDecision, RouteDecisionArtefact, SnapshotArtefact, Task, TaskId, TaskRoutingHints, TaskState, WhisperPrompt, Workspace, WorkspaceId, WorkspaceState, modeLE } from './types.cjs';
 export { E, isValidEnvelope, rpcError } from './jsonrpc.cjs';
 export { PatchError, applyJsonPatch, diffJsonPatch } from './patch.cjs';
 import { KeyObject } from 'node:crypto';
 
+/** The value an entry's chain link hashes. */
+declare function entryRecord(entry: AuditEntry): unknown;
+/** The call an entry records, whether it took effect or was refused. */
+declare function entryCall(entry: AuditEntry): Envelope | undefined;
+/** True when an entry records a refused call. */
+declare function isRefusal(entry: AuditEntry): boolean;
+/** chain_head = SHA-256( JCS(record) || prev_hash ). */
+declare function linkHash(record: unknown, prev: string): string;
+
 /**
  * @brightbeamai/chap-coordinator/canonical
  *
@@ -83,8 +93,11 @@ declare function deriveKeypair(uri: string): {
  * CoordinatorOptions.
  *
  * The defaults shipped with the Coordinator (in profiles/routing.ts)
- * implement the same logic; this factory exists so that the legacy
- * call site can keep using:
+ * apply the same review-depth and escalation rules. Routing differs: this
+ * routing policy takes the first candidate as given, so a first candidate
+ * who is not a member is refused with -32510 and one who is paused with
+ * -32063, where the built-in default passes over both. This factory exists
+ * so that the legacy call site can keep using:
  *
  *   new Coordinator({ ...makeDefaultPolicy(SENIOR_URI), ... })
  *
@@ -107,7 +120,7 @@ declare function makeDefaultPolicy(seniorTarget: string): Pick<CoordinatorOption
  * happened outside CHAP, wrap it so the audit log carries a faithful,
  * citable record.
  *
- * Spec target: CHAP 0.2. MCP 2026-07-28. A2A 1.0.
+ * Spec target: CHAP 0.3. MCP 2026-07-28. A2A 1.0.
  */
 
 interface WrapMcpToolCallOptions {
@@ -127,6 +140,8 @@ interface WrapMcpToolCallOptions {
     routingHints?: Record<string, unknown>;
     /** Optional confidence value attached to task.complete. */
     confidence?: number | string;
+    /** Optional id of the decision this call fulfils; recorded as a ``fulfils`` link on the result artefact. Asserted by the caller and not verified by the coordinator. */
+    fulfils?: string;
 }
 interface WrapResult {
     task_id: string;
@@ -158,6 +173,8 @@ interface WrapA2aExchangeOptions {
     routingHints?: Record<string, unknown>;
     /** Optional confidence value attached to task.complete. */
     confidence?: number | string;
+    /** Optional id of the decision this exchange fulfils; recorded as a ``fulfils`` link on the result artefact. Asserted by the caller and not verified by the coordinator. */
+    fulfils?: string;
 }
 interface WrapA2aResult {
     task_id: string;
@@ -172,4 +189,4 @@ interface WrapA2aResult {
  */
 declare function wrapA2aMessageExchange(coord: Coordinator, workspace: string, options: WrapA2aExchangeOptions): WrapA2aResult;
 
-export { Coordinator, CoordinatorOptions, type Jwk as CryptoJwk, type WrapA2aExchangeOptions, type WrapA2aResult, type WrapMcpToolCallOptions, type WrapResult, ZERO_HASH, canonicalize, contentHash, deriveKeypair, deriveSeed, jwkFromPrivateKey, makeDefaultPolicy, publicKeyBytes, publicKeyFromJwk, publicKeyFromRaw, sha256Hex, signEnvelope, verifyEnvelope, wrapA2aMessageExchange, wrapMcpToolCall };
+export { AuditEntry, Coordinator, CoordinatorOptions, type Jwk as CryptoJwk, Envelope, type WrapA2aExchangeOptions, type WrapA2aResult, type WrapMcpToolCallOptions, type WrapResult, ZERO_HASH, canonicalize, contentHash, deriveKeypair, deriveSeed, entryCall, entryRecord, isRefusal, jwkFromPrivateKey, linkHash, makeDefaultPolicy, publicKeyBytes, publicKeyFromJwk, publicKeyFromRaw, sha256Hex, signEnvelope, verifyEnvelope, wrapA2aMessageExchange, wrapMcpToolCall };

package/dist/index.d.ts

@@ -1,12 +1,22 @@
-import { C as CoordinatorOptions, a as Coordinator } from './api-BOGEBNmX.js';
-export { b as CoordinatorApi, c as CoordinatorError, d as CredentialVerifier, E as EscalationPolicyFn, H as Handler, I as IdFactory, P as PRIVILEGED_METHODS, R as ReviewDepthPolicyFn, e as RoutingPolicyFn, S as ScittReceiptVerifier, f as ScittSubmitter, T as TokenVerifier, g as call, m as makeApi } from './api-BOGEBNmX.js';
+import { C as CoordinatorOptions, a as Coordinator } from './api-Ddy9fqkY.js';
+export { b as CoordinatorApi, c as CoordinatorError, d as CredentialVerifier, E as EscalationPolicyFn, H as Handler, I as IdFactory, P as PRIVILEGED_METHODS, R as ReviewDepthPolicyFn, e as RoutingPolicyFn, S as ScittReceiptVerifier, f as ScittSubmitter, T as TokenVerifier, g as call, m as makeApi } from './api-Ddy9fqkY.js';
 export { MethodName, MethodParams, MethodResult, MethodTable } from './methods.js';
+import { AuditEntry, Envelope } from './types.js';
+export { ArtefactId, ArtefactRoutingHints, AuditListener, Deliberation, DeliberationVote, Handoff, HandoffTaskItem, JsonPatchOp, Jwk, KeyRecord, Member, Mode, OverrideArtefact, ParticipantType, ParticipantUri, PauseScope, RefusalOutcome, ReviewDecision, RouteDecisionArtefact, SnapshotArtefact, Task, TaskId, TaskRoutingHints, TaskState, WhisperPrompt, Workspace, WorkspaceId, WorkspaceState, modeLE } from './types.js';
 export { MemoryStore, Store, WorkspaceRecord } from './storage/store.js';
-export { ArtefactId, ArtefactRoutingHints, AuditEntry, AuditListener, Deliberation, DeliberationVote, Envelope, Handoff, HandoffTaskItem, JsonPatchOp, Jwk, KeyRecord, Member, Mode, OverrideArtefact, ParticipantType, ParticipantUri, PauseScope, ReviewDecision, RouteDecisionArtefact, SnapshotArtefact, Task, TaskId, TaskRoutingHints, TaskState, WhisperPrompt, Workspace, WorkspaceId, WorkspaceState, modeLE } from './types.js';
 export { E, isValidEnvelope, rpcError } from './jsonrpc.js';
 export { PatchError, applyJsonPatch, diffJsonPatch } from './patch.js';
 import { KeyObject } from 'node:crypto';
 
+/** The value an entry's chain link hashes. */
+declare function entryRecord(entry: AuditEntry): unknown;
+/** The call an entry records, whether it took effect or was refused. */
+declare function entryCall(entry: AuditEntry): Envelope | undefined;
+/** True when an entry records a refused call. */
+declare function isRefusal(entry: AuditEntry): boolean;
+/** chain_head = SHA-256( JCS(record) || prev_hash ). */
+declare function linkHash(record: unknown, prev: string): string;
+
 /**
  * @brightbeamai/chap-coordinator/canonical
  *
@@ -83,8 +93,11 @@ declare function deriveKeypair(uri: string): {
  * CoordinatorOptions.
  *
  * The defaults shipped with the Coordinator (in profiles/routing.ts)
- * implement the same logic; this factory exists so that the legacy
- * call site can keep using:
+ * apply the same review-depth and escalation rules. Routing differs: this
+ * routing policy takes the first candidate as given, so a first candidate
+ * who is not a member is refused with -32510 and one who is paused with
+ * -32063, where the built-in default passes over both. This factory exists
+ * so that the legacy call site can keep using:
  *
  *   new Coordinator({ ...makeDefaultPolicy(SENIOR_URI), ... })
  *
@@ -107,7 +120,7 @@ declare function makeDefaultPolicy(seniorTarget: string): Pick<CoordinatorOption
  * happened outside CHAP, wrap it so the audit log carries a faithful,
  * citable record.
  *
- * Spec target: CHAP 0.2. MCP 2026-07-28. A2A 1.0.
+ * Spec target: CHAP 0.3. MCP 2026-07-28. A2A 1.0.
  */
 
 interface WrapMcpToolCallOptions {
@@ -127,6 +140,8 @@ interface WrapMcpToolCallOptions {
     routingHints?: Record<string, unknown>;
     /** Optional confidence value attached to task.complete. */
     confidence?: number | string;
+    /** Optional id of the decision this call fulfils; recorded as a ``fulfils`` link on the result artefact. Asserted by the caller and not verified by the coordinator. */
+    fulfils?: string;
 }
 interface WrapResult {
     task_id: string;
@@ -158,6 +173,8 @@ interface WrapA2aExchangeOptions {
     routingHints?: Record<string, unknown>;
     /** Optional confidence value attached to task.complete. */
     confidence?: number | string;
+    /** Optional id of the decision this exchange fulfils; recorded as a ``fulfils`` link on the result artefact. Asserted by the caller and not verified by the coordinator. */
+    fulfils?: string;
 }
 interface WrapA2aResult {
     task_id: string;
@@ -172,4 +189,4 @@ interface WrapA2aResult {
  */
 declare function wrapA2aMessageExchange(coord: Coordinator, workspace: string, options: WrapA2aExchangeOptions): WrapA2aResult;
 
-export { Coordinator, CoordinatorOptions, type Jwk as CryptoJwk, type WrapA2aExchangeOptions, type WrapA2aResult, type WrapMcpToolCallOptions, type WrapResult, ZERO_HASH, canonicalize, contentHash, deriveKeypair, deriveSeed, jwkFromPrivateKey, makeDefaultPolicy, publicKeyBytes, publicKeyFromJwk, publicKeyFromRaw, sha256Hex, signEnvelope, verifyEnvelope, wrapA2aMessageExchange, wrapMcpToolCall };
+export { AuditEntry, Coordinator, CoordinatorOptions, type Jwk as CryptoJwk, Envelope, type WrapA2aExchangeOptions, type WrapA2aResult, type WrapMcpToolCallOptions, type WrapResult, ZERO_HASH, canonicalize, contentHash, deriveKeypair, deriveSeed, entryCall, entryRecord, isRefusal, jwkFromPrivateKey, linkHash, makeDefaultPolicy, publicKeyBytes, publicKeyFromJwk, publicKeyFromRaw, sha256Hex, signEnvelope, verifyEnvelope, wrapA2aMessageExchange, wrapMcpToolCall };