@brightbeamai/chap-coordinator 0.2.8

package/dist/types.d.cts

@@ -0,0 +1,287 @@
+/**
+ * @brightbeamai/chap-coordinator. type vocabulary
+ *
+ * Wire-shape and in-memory types for the Coordinator. The schemas at
+ * schemas/ are the normative wire types; these mirror them in
+ * TypeScript for in-process use.
+ */
+type ParticipantUri = string;
+type WorkspaceId = string;
+type TaskId = string;
+type ArtefactId = string;
+type ParticipantType = "human" | "agent" | "service" | "group" | "workspace";
+interface Envelope {
+    jsonrpc: "2.0";
+    id?: string | number;
+    method?: string;
+    params?: Record<string, unknown>;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+    /** security-signed/1.0: top-level signature, signed over JCS of the
+     *  envelope with this field removed. Form: ``ed25519:<kid>:<b64>``. */
+    sig?: string;
+}
+type Mode = "shadow" | "trial" | "production";
+type WorkspaceState = "active" | "paused" | "closed";
+type PauseScope = "task" | "participant" | "workspace";
+type TaskState = "created" | "in_progress" | "review_requested" | "completed" | "declined" | "abstained" | "escalated" | "superseded" | "paused" | "cancelled";
+interface Jwk {
+    kty: "OKP";
+    crv: "Ed25519";
+    kid: string;
+    x: string;
+    use?: string;
+    alg?: string;
+}
+/** A participant's JWK plus the validity window. Lookup by
+ *  (participant, kid, ts) so historical envelopes verify across
+ *  rotation per security-signed/1.0 S3-S5. */
+interface KeyRecord {
+    jwk: Jwk;
+    kid: string;
+    valid_from: string;
+    valid_until?: string;
+    revoked_at?: string;
+    revoked_reason?: string;
+}
+interface Member {
+    uri: ParticipantUri;
+    type: ParticipantType;
+    role: string;
+    joined: string;
+    display_name?: string;
+    capabilities?: Record<string, unknown>;
+    scopes?: string[];
+    keys: KeyRecord[];
+    paused: boolean;
+    oidc_sub?: string;
+    oidc_auth_time?: number;
+    vc_holder?: string;
+}
+interface TaskRoutingHints {
+    criticality?: "low" | "medium" | "high" | "critical";
+    deadline?: string;
+    max_cost_usd?: number;
+    risk_tier?: string;
+    [extra: string]: unknown;
+}
+interface ArtefactRoutingHints {
+    confidence?: number | string;
+    model_id?: string;
+    cost_consumed_usd?: number;
+    latency_ms?: number;
+    [extra: string]: unknown;
+}
+interface JsonPatchOp {
+    op: "add" | "replace" | "remove" | "copy" | "move" | "test";
+    path: string;
+    value?: unknown;
+    from?: string;
+}
+interface OverrideArtefact {
+    id: ArtefactId;
+    task_id: TaskId;
+    reviewer: ParticipantUri;
+    based_on_artefact: unknown;
+    diff: JsonPatchOp[];
+    result: unknown;
+    rationale: string;
+    tags: string[];
+    policy_refs: string[];
+    ts: string;
+    logical_id?: string;
+    instance_id?: string;
+    intent_preserved?: boolean;
+}
+interface RouteDecisionArtefact {
+    id: ArtefactId;
+    kind: "route_decision";
+    decision_type: "task.route" | "review.depth" | "escalate.auto";
+    outcome: unknown;
+    produced_by: ParticipantUri;
+    produced_at: string;
+    task?: TaskId;
+    policy_id?: string;
+    hints_observed: Record<string, unknown>;
+    rationale: string;
+    [extra: string]: unknown;
+}
+interface SnapshotArtefact {
+    id: ArtefactId;
+    kind: "snapshot";
+    ts: string;
+    by: ParticipantUri;
+    workspace: WorkspaceId;
+    audit_seq: number;
+    label?: string;
+    include: string[];
+    state: Record<string, unknown>;
+}
+interface WhisperPrompt {
+    id: ArtefactId;
+    task_id: TaskId;
+    asker: ParticipantUri;
+    askee: ParticipantUri[];
+    question: string;
+    options?: Array<{
+        id: string;
+        label?: string;
+    }>;
+    asked_at: string;
+    deadline_ms: number;
+    default_if_lapsed: unknown;
+    urgency: "low" | "medium" | "high";
+    state: "pending" | "answered" | "lapsed";
+    answered_at?: string;
+    answered_by?: ParticipantUri;
+    answer_option?: string;
+    answer_text?: string;
+    comment?: string;
+    default_applied?: unknown;
+}
+interface DeliberationVote {
+    ts: string;
+    voter: ParticipantUri;
+    vote: "yea" | "nay" | "abstain";
+    weight?: number;
+    comment?: string;
+    veto_invoked?: boolean;
+}
+interface Deliberation {
+    id: string;
+    task_id?: TaskId;
+    opener: ParticipantUri;
+    participants: ParticipantUri[];
+    rule: string;
+    question?: string;
+    weights?: Record<ParticipantUri, number>;
+    veto?: Record<ParticipantUri, boolean>;
+    deadline?: string;
+    state: "open" | "closed" | "lapsed";
+    comments: {
+        ts: string;
+        from: ParticipantUri;
+        text: string;
+    }[];
+    votes: DeliberationVote[];
+    outcome?: {
+        outcome: "approved" | "rejected" | "error";
+        rule: string;
+        tally?: {
+            yea: number;
+            nay: number;
+        };
+        vetoes?: ParticipantUri[];
+        reason?: string;
+    };
+    opened_at: string;
+}
+interface HandoffTaskItem {
+    task_id: TaskId;
+    title?: string;
+    status_summary?: string;
+    next_action?: string;
+    blockers?: string[];
+}
+interface Handoff {
+    id: string;
+    proposer: ParticipantUri;
+    recipient: ParticipantUri;
+    proposed_at: string;
+    tasks: HandoffTaskItem[];
+    summary?: string;
+    context_links: string[];
+    state: "proposed" | "accepted" | "declined";
+    resolved_at?: string;
+    accepted_by?: ParticipantUri;
+    accepted_task_ids?: TaskId[];
+    accept_comment?: string;
+    decline_reason?: string;
+    decline_suggested_target?: ParticipantUri;
+}
+interface ReviewDecision {
+    reviewer: ParticipantUri;
+    kind: "approve" | "reject" | "override" | "abstain";
+    ts: string;
+    comment?: string;
+    tags?: string[];
+    override_artefact_id?: ArtefactId;
+    abstain_category?: string;
+}
+interface Task {
+    id: TaskId;
+    kind: string;
+    state: TaskState;
+    assignee: ParticipantUri;
+    delegator: ParticipantUri;
+    input: Record<string, unknown>;
+    output?: unknown;
+    confidence?: number | string;
+    deadline?: string;
+    created_at: string;
+    updated_at: string;
+    mode: Mode;
+    review_required?: boolean;
+    routing_hints?: TaskRoutingHints;
+    artefact_routing_hints?: ArtefactRoutingHints;
+    review?: {
+        requested_at: string;
+        requested_to: ParticipantUri[];
+        rule: string;
+        deadline?: string;
+        decisions: ReviewDecision[];
+    };
+    history: {
+        ts: string;
+        from: ParticipantUri;
+        state: TaskState;
+        note?: string;
+    }[];
+    supersedes?: TaskId;
+    superseded_by?: TaskId;
+    parent?: TaskId;
+    paused: boolean;
+    /** Transient: holds the artefact passed to review.request so
+     *  decide.override can use it as the patch base. */
+    pending_artefact?: unknown;
+}
+interface AuditEntry {
+    seq: number;
+    arrived: string;
+    envelope: Envelope;
+    prev_hash?: string;
+}
+interface Workspace {
+    id: WorkspaceId;
+    created: string;
+    state: WorkspaceState;
+    profiles: string[];
+    mode: Mode;
+    mode_ceiling: Mode;
+    routing_policy_uri?: string;
+    step_up_window_sec: number;
+    members: Map<ParticipantUri, Member>;
+    tasks: Map<TaskId, Task>;
+    overrides: Map<ArtefactId, OverrideArtefact>;
+    whispers: Map<string, WhisperPrompt>;
+    deliberations: Map<string, Deliberation>;
+    handoffs: Map<string, Handoff>;
+    snapshots: Map<ArtefactId, SnapshotArtefact>;
+    route_decisions: Map<ArtefactId, RouteDecisionArtefact>;
+    audit: AuditEntry[];
+    chain_head?: string;
+    chain_enabled: boolean;
+}
+/**
+ * Listener callback invoked synchronously when an envelope is appended
+ * to the workspace audit log.
+ */
+type AuditListener = (workspace: Workspace, entry: AuditEntry) => void;
+/** True iff mode `a` is <= ceiling. */
+declare function modeLE(a: Mode, ceiling: Mode): boolean;
+
+export { type ArtefactId, type ArtefactRoutingHints, type AuditEntry, type AuditListener, type Deliberation, type DeliberationVote, type Envelope, type Handoff, type HandoffTaskItem, type JsonPatchOp, type Jwk, type KeyRecord, type Member, type Mode, type OverrideArtefact, type ParticipantType, type ParticipantUri, type PauseScope, type ReviewDecision, type RouteDecisionArtefact, type SnapshotArtefact, type Task, type TaskId, type TaskRoutingHints, type TaskState, type WhisperPrompt, type Workspace, type WorkspaceId, type WorkspaceState, modeLE };

package/dist/types.d.ts

@@ -0,0 +1,287 @@
+/**
+ * @brightbeamai/chap-coordinator. type vocabulary
+ *
+ * Wire-shape and in-memory types for the Coordinator. The schemas at
+ * schemas/ are the normative wire types; these mirror them in
+ * TypeScript for in-process use.
+ */
+type ParticipantUri = string;
+type WorkspaceId = string;
+type TaskId = string;
+type ArtefactId = string;
+type ParticipantType = "human" | "agent" | "service" | "group" | "workspace";
+interface Envelope {
+    jsonrpc: "2.0";
+    id?: string | number;
+    method?: string;
+    params?: Record<string, unknown>;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+    /** security-signed/1.0: top-level signature, signed over JCS of the
+     *  envelope with this field removed. Form: ``ed25519:<kid>:<b64>``. */
+    sig?: string;
+}
+type Mode = "shadow" | "trial" | "production";
+type WorkspaceState = "active" | "paused" | "closed";
+type PauseScope = "task" | "participant" | "workspace";
+type TaskState = "created" | "in_progress" | "review_requested" | "completed" | "declined" | "abstained" | "escalated" | "superseded" | "paused" | "cancelled";
+interface Jwk {
+    kty: "OKP";
+    crv: "Ed25519";
+    kid: string;
+    x: string;
+    use?: string;
+    alg?: string;
+}
+/** A participant's JWK plus the validity window. Lookup by
+ *  (participant, kid, ts) so historical envelopes verify across
+ *  rotation per security-signed/1.0 S3-S5. */
+interface KeyRecord {
+    jwk: Jwk;
+    kid: string;
+    valid_from: string;
+    valid_until?: string;
+    revoked_at?: string;
+    revoked_reason?: string;
+}
+interface Member {
+    uri: ParticipantUri;
+    type: ParticipantType;
+    role: string;
+    joined: string;
+    display_name?: string;
+    capabilities?: Record<string, unknown>;
+    scopes?: string[];
+    keys: KeyRecord[];
+    paused: boolean;
+    oidc_sub?: string;
+    oidc_auth_time?: number;
+    vc_holder?: string;
+}
+interface TaskRoutingHints {
+    criticality?: "low" | "medium" | "high" | "critical";
+    deadline?: string;
+    max_cost_usd?: number;
+    risk_tier?: string;
+    [extra: string]: unknown;
+}
+interface ArtefactRoutingHints {
+    confidence?: number | string;
+    model_id?: string;
+    cost_consumed_usd?: number;
+    latency_ms?: number;
+    [extra: string]: unknown;
+}
+interface JsonPatchOp {
+    op: "add" | "replace" | "remove" | "copy" | "move" | "test";
+    path: string;
+    value?: unknown;
+    from?: string;
+}
+interface OverrideArtefact {
+    id: ArtefactId;
+    task_id: TaskId;
+    reviewer: ParticipantUri;
+    based_on_artefact: unknown;
+    diff: JsonPatchOp[];
+    result: unknown;
+    rationale: string;
+    tags: string[];
+    policy_refs: string[];
+    ts: string;
+    logical_id?: string;
+    instance_id?: string;
+    intent_preserved?: boolean;
+}
+interface RouteDecisionArtefact {
+    id: ArtefactId;
+    kind: "route_decision";
+    decision_type: "task.route" | "review.depth" | "escalate.auto";
+    outcome: unknown;
+    produced_by: ParticipantUri;
+    produced_at: string;
+    task?: TaskId;
+    policy_id?: string;
+    hints_observed: Record<string, unknown>;
+    rationale: string;
+    [extra: string]: unknown;
+}
+interface SnapshotArtefact {
+    id: ArtefactId;
+    kind: "snapshot";
+    ts: string;
+    by: ParticipantUri;
+    workspace: WorkspaceId;
+    audit_seq: number;
+    label?: string;
+    include: string[];
+    state: Record<string, unknown>;
+}
+interface WhisperPrompt {
+    id: ArtefactId;
+    task_id: TaskId;
+    asker: ParticipantUri;
+    askee: ParticipantUri[];
+    question: string;
+    options?: Array<{
+        id: string;
+        label?: string;
+    }>;
+    asked_at: string;
+    deadline_ms: number;
+    default_if_lapsed: unknown;
+    urgency: "low" | "medium" | "high";
+    state: "pending" | "answered" | "lapsed";
+    answered_at?: string;
+    answered_by?: ParticipantUri;
+    answer_option?: string;
+    answer_text?: string;
+    comment?: string;
+    default_applied?: unknown;
+}
+interface DeliberationVote {
+    ts: string;
+    voter: ParticipantUri;
+    vote: "yea" | "nay" | "abstain";
+    weight?: number;
+    comment?: string;
+    veto_invoked?: boolean;
+}
+interface Deliberation {
+    id: string;
+    task_id?: TaskId;
+    opener: ParticipantUri;
+    participants: ParticipantUri[];
+    rule: string;
+    question?: string;
+    weights?: Record<ParticipantUri, number>;
+    veto?: Record<ParticipantUri, boolean>;
+    deadline?: string;
+    state: "open" | "closed" | "lapsed";
+    comments: {
+        ts: string;
+        from: ParticipantUri;
+        text: string;
+    }[];
+    votes: DeliberationVote[];
+    outcome?: {
+        outcome: "approved" | "rejected" | "error";
+        rule: string;
+        tally?: {
+            yea: number;
+            nay: number;
+        };
+        vetoes?: ParticipantUri[];
+        reason?: string;
+    };
+    opened_at: string;
+}
+interface HandoffTaskItem {
+    task_id: TaskId;
+    title?: string;
+    status_summary?: string;
+    next_action?: string;
+    blockers?: string[];
+}
+interface Handoff {
+    id: string;
+    proposer: ParticipantUri;
+    recipient: ParticipantUri;
+    proposed_at: string;
+    tasks: HandoffTaskItem[];
+    summary?: string;
+    context_links: string[];
+    state: "proposed" | "accepted" | "declined";
+    resolved_at?: string;
+    accepted_by?: ParticipantUri;
+    accepted_task_ids?: TaskId[];
+    accept_comment?: string;
+    decline_reason?: string;
+    decline_suggested_target?: ParticipantUri;
+}
+interface ReviewDecision {
+    reviewer: ParticipantUri;
+    kind: "approve" | "reject" | "override" | "abstain";
+    ts: string;
+    comment?: string;
+    tags?: string[];
+    override_artefact_id?: ArtefactId;
+    abstain_category?: string;
+}
+interface Task {
+    id: TaskId;
+    kind: string;
+    state: TaskState;
+    assignee: ParticipantUri;
+    delegator: ParticipantUri;
+    input: Record<string, unknown>;
+    output?: unknown;
+    confidence?: number | string;
+    deadline?: string;
+    created_at: string;
+    updated_at: string;
+    mode: Mode;
+    review_required?: boolean;
+    routing_hints?: TaskRoutingHints;
+    artefact_routing_hints?: ArtefactRoutingHints;
+    review?: {
+        requested_at: string;
+        requested_to: ParticipantUri[];
+        rule: string;
+        deadline?: string;
+        decisions: ReviewDecision[];
+    };
+    history: {
+        ts: string;
+        from: ParticipantUri;
+        state: TaskState;
+        note?: string;
+    }[];
+    supersedes?: TaskId;
+    superseded_by?: TaskId;
+    parent?: TaskId;
+    paused: boolean;
+    /** Transient: holds the artefact passed to review.request so
+     *  decide.override can use it as the patch base. */
+    pending_artefact?: unknown;
+}
+interface AuditEntry {
+    seq: number;
+    arrived: string;
+    envelope: Envelope;
+    prev_hash?: string;
+}
+interface Workspace {
+    id: WorkspaceId;
+    created: string;
+    state: WorkspaceState;
+    profiles: string[];
+    mode: Mode;
+    mode_ceiling: Mode;
+    routing_policy_uri?: string;
+    step_up_window_sec: number;
+    members: Map<ParticipantUri, Member>;
+    tasks: Map<TaskId, Task>;
+    overrides: Map<ArtefactId, OverrideArtefact>;
+    whispers: Map<string, WhisperPrompt>;
+    deliberations: Map<string, Deliberation>;
+    handoffs: Map<string, Handoff>;
+    snapshots: Map<ArtefactId, SnapshotArtefact>;
+    route_decisions: Map<ArtefactId, RouteDecisionArtefact>;
+    audit: AuditEntry[];
+    chain_head?: string;
+    chain_enabled: boolean;
+}
+/**
+ * Listener callback invoked synchronously when an envelope is appended
+ * to the workspace audit log.
+ */
+type AuditListener = (workspace: Workspace, entry: AuditEntry) => void;
+/** True iff mode `a` is <= ceiling. */
+declare function modeLE(a: Mode, ceiling: Mode): boolean;
+
+export { type ArtefactId, type ArtefactRoutingHints, type AuditEntry, type AuditListener, type Deliberation, type DeliberationVote, type Envelope, type Handoff, type HandoffTaskItem, type JsonPatchOp, type Jwk, type KeyRecord, type Member, type Mode, type OverrideArtefact, type ParticipantType, type ParticipantUri, type PauseScope, type ReviewDecision, type RouteDecisionArtefact, type SnapshotArtefact, type Task, type TaskId, type TaskRoutingHints, type TaskState, type WhisperPrompt, type Workspace, type WorkspaceId, type WorkspaceState, modeLE };

package/dist/types.js

@@ -0,0 +1,9 @@
+// src/types.ts
+function modeLE(a, ceiling) {
+  const order = { shadow: 0, trial: 1, production: 2 };
+  return order[a] <= order[ceiling];
+}
+export {
+  modeLE
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["/**\n * @brightbeamai/chap-coordinator. type vocabulary\n *\n * Wire-shape and in-memory types for the Coordinator. The schemas at\n * schemas/ are the normative wire types; these mirror them in\n * TypeScript for in-process use.\n */\n\nexport type ParticipantUri = string;\nexport type WorkspaceId    = string;\nexport type TaskId         = string;\nexport type ArtefactId     = string;\n\nexport type ParticipantType = \"human\" | \"agent\" | \"service\" | \"group\" | \"workspace\";\n\nexport interface Envelope {\n  jsonrpc: \"2.0\";\n  id?:     string | number;\n  method?: string;\n  params?: Record<string, unknown>;\n  result?: unknown;\n  error?:  { code: number; message: string; data?: unknown };\n  /** security-signed/1.0: top-level signature, signed over JCS of the\n   *  envelope with this field removed. Form: ``ed25519:<kid>:<b64>``. */\n  sig?: string;\n}\n\nexport type Mode = \"shadow\" | \"trial\" | \"production\";\nexport type WorkspaceState = \"active\" | \"paused\" | \"closed\";\nexport type PauseScope = \"task\" | \"participant\" | \"workspace\";\n\nexport type TaskState =\n  | \"created\"\n  | \"in_progress\"\n  | \"review_requested\"\n  | \"completed\"\n  | \"declined\"\n  | \"abstained\"\n  | \"escalated\"\n  | \"superseded\"\n  | \"paused\"\n  | \"cancelled\";\n\n// ============================================================\n//   Key records (security-signed/1.0)\n// ============================================================\n\nexport interface Jwk {\n  kty: \"OKP\";\n  crv: \"Ed25519\";\n  kid: string;\n  x:   string;\n  use?: string;\n  alg?: string;\n}\n\n/** A participant's JWK plus the validity window. Lookup by\n *  (participant, kid, ts) so historical envelopes verify across\n *  rotation per security-signed/1.0 S3-S5. */\nexport interface KeyRecord {\n  jwk:         Jwk;\n  kid:         string;\n  valid_from:  string;            // ISO timestamp; inclusive\n  valid_until?: string;           // ISO timestamp; exclusive; absent = unbounded\n  revoked_at?: string;\n  revoked_reason?: string;\n}\n\n// ============================================================\n//   Participants\n// ============================================================\n\nexport interface Member {\n  uri:    ParticipantUri;\n  type:   ParticipantType;\n  role:   string;\n  joined: string;\n  display_name?: string;\n  capabilities?: Record<string, unknown>;\n  scopes?:       string[];\n  keys:          KeyRecord[];\n  paused:        boolean;         // control.pause scope=participant\n  oidc_sub?:     string;\n  oidc_auth_time?: number;        // unix seconds\n  vc_holder?:    string;\n}\n\n// ============================================================\n//   Routing hints\n// ============================================================\n\nexport interface TaskRoutingHints {\n  criticality?: \"low\" | \"medium\" | \"high\" | \"critical\";\n  deadline?:    string;\n  max_cost_usd?: number;\n  risk_tier?:   string;\n  [extra: string]: unknown;\n}\n\nexport interface ArtefactRoutingHints {\n  confidence?:        number | string;\n  model_id?:          string;\n  cost_consumed_usd?: number;\n  latency_ms?:        number;\n  [extra: string]:    unknown;\n}\n\n// ============================================================\n//   JSON Patch (RFC 6902)\n// ============================================================\n\nexport interface JsonPatchOp {\n  op:    \"add\" | \"replace\" | \"remove\" | \"copy\" | \"move\" | \"test\";\n  path:  string;\n  value?: unknown;\n  from?: string;\n}\n\n// ============================================================\n//   Override artefact (review/1.0)\n// ============================================================\n\nexport interface OverrideArtefact {\n  id:                ArtefactId;\n  task_id:           TaskId;\n  reviewer:          ParticipantUri;\n  based_on_artefact: unknown;\n  diff:              JsonPatchOp[];\n  result:            unknown;\n  rationale:         string;\n  tags:              string[];\n  policy_refs:       string[];\n  ts:                string;\n  logical_id?:       string;\n  instance_id?:      string;\n  intent_preserved?: boolean;\n}\n\n// ============================================================\n//   Route decision artefact (routing/1.0)\n// ============================================================\n\nexport interface RouteDecisionArtefact {\n  id:             ArtefactId;\n  kind:           \"route_decision\";\n  decision_type:  \"task.route\" | \"review.depth\" | \"escalate.auto\";\n  outcome:        unknown;\n  produced_by:    ParticipantUri;\n  produced_at:    string;\n  task?:          TaskId;\n  policy_id?:     string;\n  hints_observed: Record<string, unknown>;\n  rationale:      string;\n  // Auxiliary fields per decision_type:\n  // task.route:     alternatives_considered\n  // review.depth:   sampling_probability\n  // escalate.auto:  escalation_target\n  [extra: string]: unknown;\n}\n\n// ============================================================\n//   Snapshot artefact (control/1.0)\n// ============================================================\n\nexport interface SnapshotArtefact {\n  id:           ArtefactId;\n  kind:         \"snapshot\";\n  ts:           string;\n  by:           ParticipantUri;\n  workspace:    WorkspaceId;\n  audit_seq:    number;\n  label?:       string;\n  include:      string[];\n  state:        Record<string, unknown>;\n}\n\n// ============================================================\n//   Whisper (whisper/1.0)\n// ============================================================\n\nexport interface WhisperPrompt {\n  id:                ArtefactId;\n  task_id:           TaskId;\n  asker:             ParticipantUri;\n  askee:             ParticipantUri[];\n  question:          string;\n  options?:          Array<{ id: string; label?: string }>;\n  asked_at:          string;\n  deadline_ms:       number;\n  default_if_lapsed: unknown;\n  urgency:           \"low\" | \"medium\" | \"high\";\n  state:             \"pending\" | \"answered\" | \"lapsed\";\n  answered_at?:      string;\n  answered_by?:      ParticipantUri;\n  answer_option?:    string;\n  answer_text?:      string;\n  comment?:          string;\n  default_applied?:  unknown;\n}\n\n// ============================================================\n//   Deliberation (deliberation/1.0)\n// ============================================================\n\nexport interface DeliberationVote {\n  ts:            string;\n  voter:         ParticipantUri;\n  vote:          \"yea\" | \"nay\" | \"abstain\";\n  weight?:       number;\n  comment?:      string;\n  veto_invoked?: boolean;\n}\n\nexport interface Deliberation {\n  id:           string;\n  task_id?:     TaskId;\n  opener:       ParticipantUri;\n  participants: ParticipantUri[];\n  rule:         string;        // raw rule string\n  question?:    string;\n  weights?:     Record<ParticipantUri, number>;\n  veto?:        Record<ParticipantUri, boolean>;\n  deadline?:    string;\n  state:        \"open\" | \"closed\" | \"lapsed\";\n  comments:     { ts: string; from: ParticipantUri; text: string }[];\n  votes:        DeliberationVote[];\n  outcome?:     {\n    outcome:  \"approved\" | \"rejected\" | \"error\";\n    rule:     string;\n    tally?:   { yea: number; nay: number };\n    vetoes?:  ParticipantUri[];\n    reason?:  string;\n  };\n  opened_at:    string;\n}\n\n// ============================================================\n//   Handoff (handoff/1.0)\n// ============================================================\n\nexport interface HandoffTaskItem {\n  task_id:         TaskId;\n  title?:          string;\n  status_summary?: string;\n  next_action?:    string;\n  blockers?:       string[];\n}\n\nexport interface Handoff {\n  id:           string;\n  proposer:     ParticipantUri;\n  recipient:    ParticipantUri;     // single URI or \"group:...\"\n  proposed_at:  string;\n  tasks:        HandoffTaskItem[];\n  summary?:     string;\n  context_links: string[];\n  state:        \"proposed\" | \"accepted\" | \"declined\";\n  resolved_at?: string;\n  accepted_by?: ParticipantUri;\n  accepted_task_ids?: TaskId[];\n  accept_comment?:    string;\n  decline_reason?:    string;\n  decline_suggested_target?: ParticipantUri;\n}\n\n// ============================================================\n//   Review decision (review/1.0)\n// ============================================================\n\nexport interface ReviewDecision {\n  reviewer: ParticipantUri;\n  kind:     \"approve\" | \"reject\" | \"override\" | \"abstain\";\n  ts:       string;\n  comment?: string;\n  tags?:    string[];\n  override_artefact_id?: ArtefactId;\n  abstain_category?:     string;\n}\n\n// ============================================================\n//   Task\n// ============================================================\n\nexport interface Task {\n  id:           TaskId;\n  kind:         string;\n  state:        TaskState;\n  assignee:     ParticipantUri;\n  delegator:    ParticipantUri;\n  input:        Record<string, unknown>;\n  output?:      unknown;\n  confidence?:  number | string;\n  deadline?:    string;\n  created_at:   string;\n  updated_at:   string;\n  mode:         Mode;\n  review_required?: boolean;\n  routing_hints?:           TaskRoutingHints;\n  artefact_routing_hints?:  ArtefactRoutingHints;\n  review?: {\n    requested_at: string;\n    requested_to: ParticipantUri[];\n    rule:         string;\n    deadline?:    string;\n    decisions:    ReviewDecision[];\n  };\n  history:      { ts: string; from: ParticipantUri; state: TaskState; note?: string }[];\n  supersedes?:  TaskId;\n  superseded_by?: TaskId;\n  parent?:      TaskId;\n  paused:       boolean;\n  /** Transient: holds the artefact passed to review.request so\n   *  decide.override can use it as the patch base. */\n  pending_artefact?: unknown;\n}\n\n// ============================================================\n//   Audit\n// ============================================================\n\nexport interface AuditEntry {\n  seq:      number;\n  arrived:  string;\n  envelope: Envelope;\n  prev_hash?: string;\n}\n\n// ============================================================\n//   Workspace\n// ============================================================\n\nexport interface Workspace {\n  id:           WorkspaceId;\n  created:      string;\n  state:        WorkspaceState;\n  profiles:     string[];\n  mode:         Mode;\n  mode_ceiling: Mode;\n  routing_policy_uri?: string;\n  step_up_window_sec: number;\n  members:         Map<ParticipantUri, Member>;\n  tasks:           Map<TaskId, Task>;\n  overrides:       Map<ArtefactId, OverrideArtefact>;\n  whispers:        Map<string, WhisperPrompt>;\n  deliberations:   Map<string, Deliberation>;\n  handoffs:        Map<string, Handoff>;\n  snapshots:       Map<ArtefactId, SnapshotArtefact>;\n  route_decisions: Map<ArtefactId, RouteDecisionArtefact>;\n  audit:           AuditEntry[];\n  chain_head?:     string;\n  chain_enabled:   boolean;\n}\n\n/**\n * Listener callback invoked synchronously when an envelope is appended\n * to the workspace audit log.\n */\nexport type AuditListener = (workspace: Workspace, entry: AuditEntry) => void;\n\n/** True iff mode `a` is <= ceiling. */\nexport function modeLE(a: Mode, ceiling: Mode): boolean {\n  const order: Record<Mode, number> = { shadow: 0, trial: 1, production: 2 };\n  return order[a] <= order[ceiling];\n}\n"],"mappings":";AAwWO,SAAS,OAAO,GAAS,SAAwB;AACtD,QAAM,QAA8B,EAAE,QAAQ,GAAG,OAAO,GAAG,YAAY,EAAE;AACzE,SAAO,MAAM,CAAC,KAAK,MAAM,OAAO;AAClC;","names":[]}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@brightbeamai/chap-coordinator",
+  "version": "0.2.8",
+  "description": "Collaborative Human-Agent Protocol (CHAP): reference TypeScript implementation. Coordinator with Core + every shipped profile, plus pluggable storage and typed method facade.",
+  "license": "Apache-2.0",
+  "author": "Brightbeam AI <oss@brightbeam.com>",
+  "homepage": "https://github.com/BrightbeamAI/chap",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/BrightbeamAI/chap.git",
+    "directory": "packages/coordinator"
+  },
+  "bugs": {
+    "url": "https://github.com/BrightbeamAI/chap/issues"
+  },
+  "keywords": [
+    "chap", "agent", "protocol", "audit", "json-rpc",
+    "human-ai", "human-agent", "review", "override", "scitt", "mcp", "a2a"
+  ],
+  "type": "module",
+  "engines": { "node": ">=18" },
+  "files": ["dist", "README.md", "LICENSE"],
+  "main":   "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types":  "./dist/index.d.ts",
+  "exports": {
+    ".":                 { "types": "./dist/index.d.ts",            "import": "./dist/index.js",            "require": "./dist/index.cjs" },
+    "./jsonrpc":         { "types": "./dist/jsonrpc.d.ts",          "import": "./dist/jsonrpc.js",          "require": "./dist/jsonrpc.cjs" },
+    "./patch":           { "types": "./dist/patch.d.ts",            "import": "./dist/patch.js",            "require": "./dist/patch.cjs" },
+    "./types":           { "types": "./dist/types.d.ts",            "import": "./dist/types.js",            "require": "./dist/types.cjs" },
+    "./methods":         { "types": "./dist/methods.d.ts",          "import": "./dist/methods.js",          "require": "./dist/methods.cjs" },
+    "./api":             { "types": "./dist/api.d.ts",              "import": "./dist/api.js",              "require": "./dist/api.cjs" },
+    "./storage/store":   { "types": "./dist/storage/store.d.ts",    "import": "./dist/storage/store.js",    "require": "./dist/storage/store.cjs" },
+    "./storage/sqlite":  { "types": "./dist/storage/sqlite.d.ts",   "import": "./dist/storage/sqlite.js",   "require": "./dist/storage/sqlite.cjs" }
+  },
+  "scripts": {
+    "build":          "tsup",
+    "test":           "tsx --test tests/*.test.ts",
+    "typecheck":      "tsc",
+    "check:schemas":  "tsx scripts/check-method-coverage.ts",
+    "prepublishOnly": "npm run check:schemas && npm run typecheck && npm run test && npm run build"
+  },
+  "optionalDependencies": { "better-sqlite3": "^12.11.1" },
+  "devDependencies": {
+    "@types/node":     "^20.11.0",
+    "better-sqlite3":  "^12.11.1",
+    "tsup":            "^8.0.0",
+    "tsx":             "^4.7.0",
+    "typescript":      "^5.3.0"
+  },
+  "publishConfig": { "access": "public" }
+}