@capabilityhostprotocol/types 0.2.1 → 0.5.0

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 /**
- * CHP v0.1 protocol types.
+ * CHP v0.2 protocol types.
  *
  * These interfaces mirror the JSON Schemas in the repository root `schemas/`
  * directory. They are intentionally transport-neutral and do not depend on the
@@ -19,6 +19,7 @@ type InvariantEnforcement = "declarative" | "host" | "runtime";
 type InvariantFailureBehavior = "deny" | "warn" | "degrade";
 declare const CHP_V0_1_OUTCOMES: readonly ["success", "failure", "denied", "skipped"];
 declare const CHP_V0_1_CORE_EVIDENCE_TYPES: readonly ["execution_started", "execution_completed", "execution_failed", "execution_denied", "execution_skipped"];
+declare const CHP_AGENTIC_EVIDENCE_TYPES: readonly ["tool_use", "tool_use_requested", "session_completed", "session_spawn"];
 interface AssuranceMetadata {
     level: AssuranceLevel;
     evidence_policy?: string;
@@ -32,6 +33,45 @@ interface InvariantDescriptor {
     failure_behavior?: InvariantFailureBehavior;
     parameters?: JsonObject;
 }
+interface CostHint {
+    token_estimate?: number | null;
+    latency_ms_p50?: number | null;
+    idempotent?: boolean;
+}
+type BlastRadius = "local" | "session" | "user" | "system";
+interface SafetyHint {
+    reversible?: boolean;
+    destructive?: boolean;
+    requires_human_review?: boolean;
+    blast_radius?: BlastRadius;
+}
+type StateMachineStatus = "queued" | "running" | "blocked" | "done" | "failed" | "cancelled";
+interface StateMachineDefinition {
+    states: string[];
+    transitions: Record<string, string[]>;
+    initial_state: string;
+    terminal_states: string[];
+}
+interface StateMachineRecord {
+    machine_id: string;
+    name: string;
+    definition: StateMachineDefinition;
+    current_state: string;
+    status: StateMachineStatus;
+    context: JsonObject;
+    created_at: string;
+    updated_at: string;
+    history: JsonObject[];
+}
+interface StateMachineTransitionResult {
+    machine_id: string;
+    from_state: string;
+    to_state: string;
+    event: string;
+    allowed: boolean;
+    reason?: string | null;
+    updated_at: string;
+}
 interface CapabilityDescriptor {
     id: string;
     version: string;
@@ -47,6 +87,9 @@ interface CapabilityDescriptor {
     risk?: CapabilityRisk;
     assurance?: AssuranceMetadata;
     metadata?: JsonObject;
+    depends_on?: string[] | null;
+    cost_hint?: CostHint | null;
+    safety_hint?: SafetyHint | null;
 }
 interface HostDescriptor {
     id: string;
@@ -117,6 +160,41 @@ interface ExecutionEvidence {
     denial?: DenialReason | null;
     assurance: AssuranceMetadata;
 }
+interface ToolUseEvidence extends ExecutionEvidence {
+    event_type: "tool_use";
+    payload: {
+        tool_name: string;
+        cwd?: string;
+        tool_input?: JsonObject;
+        tool_output_preview?: string;
+        exit_code?: number | null;
+    };
+}
+interface PreToolEvidence extends ExecutionEvidence {
+    event_type: "tool_use_requested";
+    payload: {
+        tool_name: string;
+        cwd?: string;
+        tool_input?: JsonObject;
+        blocked: boolean;
+        block_reason?: string | null;
+    };
+}
+interface SessionEvidence extends ExecutionEvidence {
+    event_type: "session_completed";
+    payload: {
+        tool_count: number;
+        transcript_path?: string;
+    };
+}
+interface SessionSpawnEvidence extends ExecutionEvidence {
+    event_type: "session_spawn";
+    payload: {
+        parent_session_id: string;
+        child_session_id: string;
+        tool_name: string;
+    };
+}
 interface ReplayQuery {
     correlation_id: string;
     limit?: number | null;
@@ -144,7 +222,7 @@ declare function isChpV01Outcome(value: string): value is ChpV01ExecutionOutcome
  * @packageDocumentation
  */
 
-declare const CHP_VERSION = "0.1";
-declare const VERSION = "0.1.0";
+declare const CHP_VERSION = "0.2";
+declare const VERSION = "0.2.2";
 
-export { type AssuranceLevel, type AssuranceMetadata, CHP_V0_1_CORE_EVIDENCE_TYPES, CHP_V0_1_OUTCOMES, CHP_V0_1_VERSION, CHP_VERSION, type CapabilityDescriptor, type CapabilityRisk, type ChpV01ExecutionOutcome, type ChpV01InvocationMode, type CorrelationContext, type DenialReason, type ExecutionEvidence, type HostDescriptor, type InvariantDescriptor, type InvariantEnforcement, type InvariantFailureBehavior, type InvocationEnvelope, type InvocationResult, type JsonObject, type JsonPrimitive, type JsonValue, type ReplayQuery, type ReplayResult, VERSION, capabilityUri, isChpV01Outcome };
+export { type AssuranceLevel, type AssuranceMetadata, type BlastRadius, CHP_AGENTIC_EVIDENCE_TYPES, CHP_V0_1_CORE_EVIDENCE_TYPES, CHP_V0_1_OUTCOMES, CHP_V0_1_VERSION, CHP_VERSION, type CapabilityDescriptor, type CapabilityRisk, type ChpV01ExecutionOutcome, type ChpV01InvocationMode, type CorrelationContext, type CostHint, type DenialReason, type ExecutionEvidence, type HostDescriptor, type InvariantDescriptor, type InvariantEnforcement, type InvariantFailureBehavior, type InvocationEnvelope, type InvocationResult, type JsonObject, type JsonPrimitive, type JsonValue, type PreToolEvidence, type ReplayQuery, type ReplayResult, type SafetyHint, type SessionEvidence, type SessionSpawnEvidence, type StateMachineDefinition, type StateMachineRecord, type StateMachineStatus, type StateMachineTransitionResult, type ToolUseEvidence, VERSION, capabilityUri, isChpV01Outcome };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * CHP v0.1 protocol types.
+ * CHP v0.2 protocol types.
  *
  * These interfaces mirror the JSON Schemas in the repository root `schemas/`
  * directory. They are intentionally transport-neutral and do not depend on the
@@ -19,6 +19,7 @@ type InvariantEnforcement = "declarative" | "host" | "runtime";
 type InvariantFailureBehavior = "deny" | "warn" | "degrade";
 declare const CHP_V0_1_OUTCOMES: readonly ["success", "failure", "denied", "skipped"];
 declare const CHP_V0_1_CORE_EVIDENCE_TYPES: readonly ["execution_started", "execution_completed", "execution_failed", "execution_denied", "execution_skipped"];
+declare const CHP_AGENTIC_EVIDENCE_TYPES: readonly ["tool_use", "tool_use_requested", "session_completed", "session_spawn"];
 interface AssuranceMetadata {
     level: AssuranceLevel;
     evidence_policy?: string;
@@ -32,6 +33,45 @@ interface InvariantDescriptor {
     failure_behavior?: InvariantFailureBehavior;
     parameters?: JsonObject;
 }
+interface CostHint {
+    token_estimate?: number | null;
+    latency_ms_p50?: number | null;
+    idempotent?: boolean;
+}
+type BlastRadius = "local" | "session" | "user" | "system";
+interface SafetyHint {
+    reversible?: boolean;
+    destructive?: boolean;
+    requires_human_review?: boolean;
+    blast_radius?: BlastRadius;
+}
+type StateMachineStatus = "queued" | "running" | "blocked" | "done" | "failed" | "cancelled";
+interface StateMachineDefinition {
+    states: string[];
+    transitions: Record<string, string[]>;
+    initial_state: string;
+    terminal_states: string[];
+}
+interface StateMachineRecord {
+    machine_id: string;
+    name: string;
+    definition: StateMachineDefinition;
+    current_state: string;
+    status: StateMachineStatus;
+    context: JsonObject;
+    created_at: string;
+    updated_at: string;
+    history: JsonObject[];
+}
+interface StateMachineTransitionResult {
+    machine_id: string;
+    from_state: string;
+    to_state: string;
+    event: string;
+    allowed: boolean;
+    reason?: string | null;
+    updated_at: string;
+}
 interface CapabilityDescriptor {
     id: string;
     version: string;
@@ -47,6 +87,9 @@ interface CapabilityDescriptor {
     risk?: CapabilityRisk;
     assurance?: AssuranceMetadata;
     metadata?: JsonObject;
+    depends_on?: string[] | null;
+    cost_hint?: CostHint | null;
+    safety_hint?: SafetyHint | null;
 }
 interface HostDescriptor {
     id: string;
@@ -117,6 +160,41 @@ interface ExecutionEvidence {
     denial?: DenialReason | null;
     assurance: AssuranceMetadata;
 }
+interface ToolUseEvidence extends ExecutionEvidence {
+    event_type: "tool_use";
+    payload: {
+        tool_name: string;
+        cwd?: string;
+        tool_input?: JsonObject;
+        tool_output_preview?: string;
+        exit_code?: number | null;
+    };
+}
+interface PreToolEvidence extends ExecutionEvidence {
+    event_type: "tool_use_requested";
+    payload: {
+        tool_name: string;
+        cwd?: string;
+        tool_input?: JsonObject;
+        blocked: boolean;
+        block_reason?: string | null;
+    };
+}
+interface SessionEvidence extends ExecutionEvidence {
+    event_type: "session_completed";
+    payload: {
+        tool_count: number;
+        transcript_path?: string;
+    };
+}
+interface SessionSpawnEvidence extends ExecutionEvidence {
+    event_type: "session_spawn";
+    payload: {
+        parent_session_id: string;
+        child_session_id: string;
+        tool_name: string;
+    };
+}
 interface ReplayQuery {
     correlation_id: string;
     limit?: number | null;
@@ -144,7 +222,7 @@ declare function isChpV01Outcome(value: string): value is ChpV01ExecutionOutcome
  * @packageDocumentation
  */
 
-declare const CHP_VERSION = "0.1";
-declare const VERSION = "0.1.0";
+declare const CHP_VERSION = "0.2";
+declare const VERSION = "0.2.2";
 
-export { type AssuranceLevel, type AssuranceMetadata, CHP_V0_1_CORE_EVIDENCE_TYPES, CHP_V0_1_OUTCOMES, CHP_V0_1_VERSION, CHP_VERSION, type CapabilityDescriptor, type CapabilityRisk, type ChpV01ExecutionOutcome, type ChpV01InvocationMode, type CorrelationContext, type DenialReason, type ExecutionEvidence, type HostDescriptor, type InvariantDescriptor, type InvariantEnforcement, type InvariantFailureBehavior, type InvocationEnvelope, type InvocationResult, type JsonObject, type JsonPrimitive, type JsonValue, type ReplayQuery, type ReplayResult, VERSION, capabilityUri, isChpV01Outcome };
+export { type AssuranceLevel, type AssuranceMetadata, type BlastRadius, CHP_AGENTIC_EVIDENCE_TYPES, CHP_V0_1_CORE_EVIDENCE_TYPES, CHP_V0_1_OUTCOMES, CHP_V0_1_VERSION, CHP_VERSION, type CapabilityDescriptor, type CapabilityRisk, type ChpV01ExecutionOutcome, type ChpV01InvocationMode, type CorrelationContext, type CostHint, type DenialReason, type ExecutionEvidence, type HostDescriptor, type InvariantDescriptor, type InvariantEnforcement, type InvariantFailureBehavior, type InvocationEnvelope, type InvocationResult, type JsonObject, type JsonPrimitive, type JsonValue, type PreToolEvidence, type ReplayQuery, type ReplayResult, type SafetyHint, type SessionEvidence, type SessionSpawnEvidence, type StateMachineDefinition, type StateMachineRecord, type StateMachineStatus, type StateMachineTransitionResult, type ToolUseEvidence, VERSION, capabilityUri, isChpV01Outcome };

package/dist/index.js

@@ -19,6 +19,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  CHP_AGENTIC_EVIDENCE_TYPES: () => CHP_AGENTIC_EVIDENCE_TYPES,
   CHP_V0_1_CORE_EVIDENCE_TYPES: () => CHP_V0_1_CORE_EVIDENCE_TYPES,
   CHP_V0_1_OUTCOMES: () => CHP_V0_1_OUTCOMES,
   CHP_V0_1_VERSION: () => CHP_V0_1_VERSION,
@@ -44,6 +45,12 @@ var CHP_V0_1_CORE_EVIDENCE_TYPES = [
   "execution_denied",
   "execution_skipped"
 ];
+var CHP_AGENTIC_EVIDENCE_TYPES = [
+  "tool_use",
+  "tool_use_requested",
+  "session_completed",
+  "session_spawn"
+];
 function capabilityUri(descriptor) {
   return `${descriptor.id}:${descriptor.version}`;
 }
@@ -52,10 +59,11 @@ function isChpV01Outcome(value) {
 }
 
 // src/index.ts
-var CHP_VERSION = "0.1";
-var VERSION = "0.1.0";
+var CHP_VERSION = "0.2";
+var VERSION = "0.2.2";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  CHP_AGENTIC_EVIDENCE_TYPES,
   CHP_V0_1_CORE_EVIDENCE_TYPES,
   CHP_V0_1_OUTCOMES,
   CHP_V0_1_VERSION,

package/dist/index.mjs

@@ -13,6 +13,12 @@ var CHP_V0_1_CORE_EVIDENCE_TYPES = [
   "execution_denied",
   "execution_skipped"
 ];
+var CHP_AGENTIC_EVIDENCE_TYPES = [
+  "tool_use",
+  "tool_use_requested",
+  "session_completed",
+  "session_spawn"
+];
 function capabilityUri(descriptor) {
   return `${descriptor.id}:${descriptor.version}`;
 }
@@ -21,9 +27,10 @@ function isChpV01Outcome(value) {
 }
 
 // src/index.ts
-var CHP_VERSION = "0.1";
-var VERSION = "0.1.0";
+var CHP_VERSION = "0.2";
+var VERSION = "0.2.2";
 export {
+  CHP_AGENTIC_EVIDENCE_TYPES,
   CHP_V0_1_CORE_EVIDENCE_TYPES,
   CHP_V0_1_OUTCOMES,
   CHP_V0_1_VERSION,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capabilityhostprotocol/types",
-  "version": "0.2.1",
+  "version": "0.5.0",
   "description": "TypeScript types for the Capability Host Protocol (CHP).",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

package/src/index.ts

@@ -12,5 +12,5 @@
 
 export * from "./v0_1.js";
 
-export const CHP_VERSION = "0.1";
-export const VERSION = "0.1.0";
+export const CHP_VERSION = "0.2";
+export const VERSION = "0.2.2";

package/src/v0_1.ts

@@ -1,5 +1,5 @@
 /**
- * CHP v0.1 protocol types.
+ * CHP v0.2 protocol types.
  *
  * These interfaces mirror the JSON Schemas in the repository root `schemas/`
  * directory. They are intentionally transport-neutral and do not depend on the
@@ -36,6 +36,13 @@ export const CHP_V0_1_CORE_EVIDENCE_TYPES = [
   "execution_skipped",
 ] as const;
 
+export const CHP_AGENTIC_EVIDENCE_TYPES = [
+  "tool_use",
+  "tool_use_requested",
+  "session_completed",
+  "session_spawn",
+] as const;
+
 export interface AssuranceMetadata {
   level: AssuranceLevel;
   evidence_policy?: string;
@@ -51,6 +58,52 @@ export interface InvariantDescriptor {
   parameters?: JsonObject;
 }
 
+export interface CostHint {
+  token_estimate?: number | null;
+  latency_ms_p50?: number | null;
+  idempotent?: boolean;
+}
+
+export type BlastRadius = "local" | "session" | "user" | "system";
+
+export interface SafetyHint {
+  reversible?: boolean;
+  destructive?: boolean;
+  requires_human_review?: boolean;
+  blast_radius?: BlastRadius;
+}
+
+export type StateMachineStatus = "queued" | "running" | "blocked" | "done" | "failed" | "cancelled";
+
+export interface StateMachineDefinition {
+  states: string[];
+  transitions: Record<string, string[]>;
+  initial_state: string;
+  terminal_states: string[];
+}
+
+export interface StateMachineRecord {
+  machine_id: string;
+  name: string;
+  definition: StateMachineDefinition;
+  current_state: string;
+  status: StateMachineStatus;
+  context: JsonObject;
+  created_at: string;
+  updated_at: string;
+  history: JsonObject[];
+}
+
+export interface StateMachineTransitionResult {
+  machine_id: string;
+  from_state: string;
+  to_state: string;
+  event: string;
+  allowed: boolean;
+  reason?: string | null;
+  updated_at: string;
+}
+
 export interface CapabilityDescriptor {
   id: string;
   version: string;
@@ -66,6 +119,9 @@ export interface CapabilityDescriptor {
   risk?: CapabilityRisk;
   assurance?: AssuranceMetadata;
   metadata?: JsonObject;
+  depends_on?: string[] | null;
+  cost_hint?: CostHint | null;
+  safety_hint?: SafetyHint | null;
 }
 
 export interface HostDescriptor {
@@ -143,6 +199,45 @@ export interface ExecutionEvidence {
   assurance: AssuranceMetadata;
 }
 
+export interface ToolUseEvidence extends ExecutionEvidence {
+  event_type: "tool_use";
+  payload: {
+    tool_name: string;
+    cwd?: string;
+    tool_input?: JsonObject;
+    tool_output_preview?: string;
+    exit_code?: number | null;
+  };
+}
+
+export interface PreToolEvidence extends ExecutionEvidence {
+  event_type: "tool_use_requested";
+  payload: {
+    tool_name: string;
+    cwd?: string;
+    tool_input?: JsonObject;
+    blocked: boolean;
+    block_reason?: string | null;
+  };
+}
+
+export interface SessionEvidence extends ExecutionEvidence {
+  event_type: "session_completed";
+  payload: {
+    tool_count: number;
+    transcript_path?: string;
+  };
+}
+
+export interface SessionSpawnEvidence extends ExecutionEvidence {
+  event_type: "session_spawn";
+  payload: {
+    parent_session_id: string;
+    child_session_id: string;
+    tool_name: string;
+  };
+}
+
 export interface ReplayQuery {
   correlation_id: string;
   limit?: number | null;