@brightbeamai/chap-coordinator 0.3.3 → 0.3.5

package/dist/index.d.cts

@@ -1,11 +1,11 @@
-import { C as CoordinatorOptions, a as Coordinator } from './api-59aU01Bs.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-59aU01Bs.cjs';
+import { C as CoordinatorOptions, a as Coordinator } from './api-CjZQnj63.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-CjZQnj63.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 { ArtefactId, ArtefactRoutingHints, AuditListener, Deliberation, DeliberationVote, Handoff, HandoffTaskItem, Invitation, JoinPolicy, JsonPatchOp, Jwk, KeyRecord, Member, Mode, OverrideArtefact, ParticipantType, ParticipantUri, PauseScope, RefusalOutcome, ReviewDecision, RouteDecisionArtefact, SignaturePolicy, SnapshotArtefact, Task, TaskId, TaskRoutingHints, TaskState, WhisperPrompt, Workspace, WorkspaceId, WorkspaceState, modeLE } from './types.cjs';
 export { MemoryStore, Store, StoreChange, StoreConflictError, WorkspaceRecord } from './storage/store.cjs';
 export { E, isValidEnvelope, rpcError } from './jsonrpc.cjs';
-export { PatchError, applyJsonPatch, diffJsonPatch } from './patch.cjs';
+export { DEFAULT_MAX_PATCHED_BYTES, PatchError, PatchLimits, applyJsonPatch, diffJsonPatch } from './patch.cjs';
 import { KeyObject } from 'node:crypto';
 
 /** The value an entry's chain link hashes. */
@@ -45,10 +45,12 @@ declare function contentHash(content: unknown): string;
 /**
  * @brightbeamai/chap-coordinator/crypto
  *
- * Ed25519 signing/verification for the security-signed/1.0 profile.
+ * Ed25519 signing/verification for the security-signed/1.0 profile, and
+ * verification of WebAuthn assertions, the signatures a browser's
+ * authenticator makes with a P-256 key.
  *
  * Uses Node's built-in crypto (no external dependencies). Keys are
- * represented as RFC 7517 JWKs with kty=OKP, crv=Ed25519.
+ * represented as RFC 7517 JWKs.
  */
 
 interface Jwk {
@@ -140,6 +142,15 @@ interface WrapMcpToolCallOptions {
     routingHints?: Record<string, unknown>;
     /** Optional confidence value attached to task.complete. */
     confidence?: number | string;
+    /**
+     * Create the task with ``review_required``, so ``task.complete`` holds the
+     * result as the artefact under review, opens a review addressed to the
+     * workspace's human members other than ``caller``, and leaves the task in
+     * ``review_requested`` until one of them decides. Where the workspace has
+     * no such member, this throws before anything is recorded. Default false:
+     * the task completes at once.
+     */
+    reviewRequired?: boolean;
     /** 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;
 }
@@ -156,6 +167,9 @@ interface WrapResult {
  * The result artefact is the MCP tool's return value, plus a
  * ``citations[]`` entry with the input/output hashes per
  * ``integrations/CHAP-with-MCP.md`` §2.
+ *
+ * Throws when the coordinator refuses a call. A refused ``task.complete``
+ * leaves the task it names in progress, on the log.
  */
 declare function wrapMcpToolCall(coord: Coordinator, workspace: string, options: WrapMcpToolCallOptions): WrapResult;
 interface WrapA2aExchangeOptions {

package/dist/index.d.ts

@@ -1,11 +1,11 @@
-import { C as CoordinatorOptions, a as Coordinator } from './api-CxciGFHA.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-CxciGFHA.js';
+import { C as CoordinatorOptions, a as Coordinator } from './api-DG0VFGVr.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-DG0VFGVr.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 { ArtefactId, ArtefactRoutingHints, AuditListener, Deliberation, DeliberationVote, Handoff, HandoffTaskItem, Invitation, JoinPolicy, JsonPatchOp, Jwk, KeyRecord, Member, Mode, OverrideArtefact, ParticipantType, ParticipantUri, PauseScope, RefusalOutcome, ReviewDecision, RouteDecisionArtefact, SignaturePolicy, SnapshotArtefact, Task, TaskId, TaskRoutingHints, TaskState, WhisperPrompt, Workspace, WorkspaceId, WorkspaceState, modeLE } from './types.js';
 export { MemoryStore, Store, StoreChange, StoreConflictError, WorkspaceRecord } from './storage/store.js';
 export { E, isValidEnvelope, rpcError } from './jsonrpc.js';
-export { PatchError, applyJsonPatch, diffJsonPatch } from './patch.js';
+export { DEFAULT_MAX_PATCHED_BYTES, PatchError, PatchLimits, applyJsonPatch, diffJsonPatch } from './patch.js';
 import { KeyObject } from 'node:crypto';
 
 /** The value an entry's chain link hashes. */
@@ -45,10 +45,12 @@ declare function contentHash(content: unknown): string;
 /**
  * @brightbeamai/chap-coordinator/crypto
  *
- * Ed25519 signing/verification for the security-signed/1.0 profile.
+ * Ed25519 signing/verification for the security-signed/1.0 profile, and
+ * verification of WebAuthn assertions, the signatures a browser's
+ * authenticator makes with a P-256 key.
  *
  * Uses Node's built-in crypto (no external dependencies). Keys are
- * represented as RFC 7517 JWKs with kty=OKP, crv=Ed25519.
+ * represented as RFC 7517 JWKs.
  */
 
 interface Jwk {
@@ -140,6 +142,15 @@ interface WrapMcpToolCallOptions {
     routingHints?: Record<string, unknown>;
     /** Optional confidence value attached to task.complete. */
     confidence?: number | string;
+    /**
+     * Create the task with ``review_required``, so ``task.complete`` holds the
+     * result as the artefact under review, opens a review addressed to the
+     * workspace's human members other than ``caller``, and leaves the task in
+     * ``review_requested`` until one of them decides. Where the workspace has
+     * no such member, this throws before anything is recorded. Default false:
+     * the task completes at once.
+     */
+    reviewRequired?: boolean;
     /** 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;
 }
@@ -156,6 +167,9 @@ interface WrapResult {
  * The result artefact is the MCP tool's return value, plus a
  * ``citations[]`` entry with the input/output hashes per
  * ``integrations/CHAP-with-MCP.md`` §2.
+ *
+ * Throws when the coordinator refuses a call. A refused ``task.complete``
+ * leaves the task it names in progress, on the log.
  */
 declare function wrapMcpToolCall(coord: Coordinator, workspace: string, options: WrapMcpToolCallOptions): WrapResult;
 interface WrapA2aExchangeOptions {