hebbrix 2.4.0 → 2.5.0-rc.1

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 2.5.0-rc.1 — 2026-09-09 (prerelease, npm `next`)
+
+- Add typed native experience program, job, review, revision, policy activation
+  and one-use execution-permission transports.
+- Preserve separate credentials, opaque evidence, uncertainty and authorization
+  receipts; never convert recommendations into execution permission.
+- Require the matching `b5c6d7e8f959` backend, not yet deployed to public
+  production. Stable 2.4.0 remains the production recommendation.
+
 ## 2.4.0 — 2026-09-07
 
 - Add typed Evidence Loop methods for owner-managed verifiers, durable episodes, actual-execution claims, protected outcome delivery and evidence assessments.

package/README.md

@@ -5,8 +5,14 @@ outcome-learning APIs.
 
 ## Install
 
+This branch is the **2.5.0-rc.1 prerelease**, published under npm `next`.
+Native experience operations require backend schema `b5c6d7e8f959`, which is not
+yet deployed to the public production API. Keep `2.4.0` for the current stable
+deployment. Installing this SDK does not grant execution permission or establish
+that an agent learns better outcomes.
+
 ```bash
-npm install hebbrix@2.4.0
+npm install hebbrix@2.5.0-rc.1
 ```
 
 Node.js 16+ and modern browsers are supported.

package/dist/index.d.mts

@@ -118,6 +118,40 @@ interface VerifierRegistration extends EvidenceScope {
     source_system: string;
     metric_keys: string[];
 }
+interface ExperienceAssessmentParams {
+    collection_id?: string | null;
+    user_id?: string | null;
+    context: Record<string, unknown>;
+    candidate: {
+        schema_version?: "experience-candidate-v1";
+        policy_key: string;
+        action_key: string;
+        lesson: string;
+        applicability: {
+            schema_version?: "experience-applicability-v1";
+            required: Record<string, string | number | boolean>;
+        };
+        sources: Array<{
+            decision_id: string;
+            evidence_revision: number;
+            bundle_digest: string;
+        }>;
+    };
+}
+interface ExperienceContextParams {
+    memory_collection_id: string;
+    evidence_collection_id?: string | null;
+    user_id?: string | null;
+    agent_id?: string | null;
+    run_id?: string | null;
+    policy_key: string;
+    references: Array<{
+        memory_id: string;
+        record_digest: string;
+    }>;
+    context: Record<string, unknown>;
+    max_context_bytes?: number;
+}
 interface EpisodeCreateParams extends EvidenceScope {
     verifier_id: string;
     idempotency_key: string;
@@ -131,6 +165,8 @@ interface ExecutionClaim {
     occurred_at?: string;
 }
 interface VerifiedOutcomeDelivery {
+    /** Optional source claims; their canonical digest must match evidence_digest. */
+    evidence_document?: Record<string, unknown>;
     decision_id: string;
     source_event_id: string;
     evidence_digest: string;
@@ -519,6 +555,10 @@ declare class ProofLoopResource extends BaseResource {
     /** Append an execution claim. This method does not execute a tool. */
     recordExecution(decisionId: string, claim: ExecutionClaim): Promise<Record<string, any>>;
     assessment(decisionId: string, evidenceOffset?: number): Promise<Record<string, any>>;
+    /** Revalidate a hypothesis against current source evidence; never permission to act. */
+    assessExperience(params: ExperienceAssessmentParams): Promise<Record<string, any>>;
+    /** Revalidate selected stored hypotheses; never grants execution permission. */
+    experienceContext(params: ExperienceContextParams): Promise<Record<string, any>>;
     verifierEvidence(verifierId: string, decisionId: string): Promise<Record<string, any>>;
     /** Deliver using the dedicated source credential, after checking execution independently. */
     deliverVerifiedOutcomes(verifierId: string, delivery: VerifiedOutcomeDelivery): Promise<Record<string, any>>;
@@ -716,6 +756,118 @@ declare class MemoryToolsResource extends BaseResource {
     rethink(memoryId: string, collectionId: string): Promise<any>;
 }
 
+/** Native workflow transport. Separate owner, worker and reviewer credentials.
+ * No provider call or autonomous tool execution is started by this resource.
+ */
+
+interface ReflectionConfig {
+    model: string;
+    applicability_keys: string[];
+    maximum_attempts: number;
+    budget_microusd: number;
+    per_attempt_microusd: number;
+    lease_seconds?: number;
+}
+interface ExperienceProgramInput {
+    collection_id?: string;
+    memory_collection_id: string;
+    user_id?: string;
+    agent_id?: string;
+    run_id?: string;
+    policy_key: string;
+    worker_key_id: string;
+    reviewer_key_id?: string;
+    source_since?: string;
+    config: ReflectionConfig;
+}
+interface ReflectionOutput {
+    schema_version?: "experience-reflection-output-v1";
+    hypotheses: Array<{
+        advice: string;
+        rationale: string;
+        limitations: string;
+        future_verification: string;
+    }>;
+    insufficient_evidence_reason?: string | null;
+}
+interface LessonReviewInput {
+    expected_sequence: number;
+    expected_digest: string | null;
+    candidate_digest: string;
+    verdict: "eligible" | "blocked" | "retracted";
+    rationale: string;
+}
+interface LessonRevisionInput extends Omit<LessonReviewInput, "verdict"> {
+    request_key: string;
+    hypothesis: ReflectionOutput["hypotheses"][number];
+}
+type ReflectionUncertainty = "provider_failure" | "invalid_provider_output" | "completion_delivery_uncertain";
+declare class ExperienceWorkflowResource {
+    private client;
+    constructor(client: MemoryClient);
+    definePermission(id: string, policy: {
+        actor_key_id: string;
+        tool_key: string;
+        target_digest: string;
+        action_keys: string[];
+        maximum_argument_bytes: number;
+        maximum_dispatches: number;
+        permit_seconds: number;
+        capability_contract: string;
+    }): Promise<any>;
+    activatePermission(id: string, activation: {
+        policy_id: string | null;
+        expected_sequence: number;
+        expected_digest: string | null;
+        rationale: string;
+    }): Promise<any>;
+    permissionState(id: string): Promise<any>;
+    issuePermit(id: string, input: {
+        lesson_id: string;
+        decision_id: string;
+        request_key: string;
+        invocation: {
+            tool_key: string;
+            target: Record<string, unknown>;
+            arguments: Record<string, unknown>;
+        };
+    }): Promise<any>;
+    dispatchPermit(id: string, invocationDigest: string): Promise<any>;
+    permit(id: string): Promise<any>;
+    register(input: ExperienceProgramInput): Promise<any>;
+    program(id: string): Promise<any>;
+    stop(id: string): Promise<any>;
+    claim(id: string, requestKey: string): Promise<any>;
+    job(id: string): Promise<any>;
+    /** A dispatch grant is single-use. Never retry a provider call after uncertainty. */
+    dispatch(id: string, input: {
+        input_digest: string;
+        request_digest: string;
+    }): Promise<any>;
+    complete(id: string, input: {
+        output: ReflectionOutput;
+        request_digest: string;
+        provider_response_digest: string;
+        reported_microusd: number;
+    }): Promise<any>;
+    uncertain(id: string, requestDigest: string, reason: ReflectionUncertainty): Promise<any>;
+    lessons(id: string, params?: {
+        after_id?: string;
+        limit?: number;
+    }): Promise<any>;
+    reviewQueue(id: string, params?: {
+        after_id?: string;
+        limit?: number;
+    }): Promise<any>;
+    lesson(id: string): Promise<any>;
+    review(id: string, input: LessonReviewInput): Promise<any>;
+    revise(id: string, input: LessonRevisionInput): Promise<any>;
+    reviews(id: string, params?: {
+        after_sequence?: number;
+        limit?: number;
+    }): Promise<any>;
+}
+
 declare class MemoryClient {
     private apiKey?;
     private baseUrl;
@@ -733,6 +885,7 @@ declare class MemoryClient {
     consolidation: ConsolidationResource;
     memoryTools: MemoryToolsResource;
     proofloop: ProofLoopResource;
+    experiences: ExperienceWorkflowResource;
     constructor(config?: ClientConfig);
     private getHeaders;
     private handleError;
@@ -855,4 +1008,4 @@ interface SafetyEnvelope {
  */
 declare function enforceSearchSafety<T extends object>(response: T, rowsKey?: "results" | "sources"): T & SafetyEnvelope;
 
-export { type APIKeyResponse, AuthResource, type AuthResponse, AuthenticationError, type BatchMemoryCreateParams, type BatchMemoryItemParams, type BatchMemoryResponse, type ClientConfig, type Collection, CollectionsResource, ConsolidationResource, type CorrectionCreateParams, type CorrectionSearchParams, CorrectionsResource, type CreateCollectionParams, type CreateMemoryParams, type CursorPage, EntitlementError, type EpisodeCreateParams, type EvidenceClaim, type EvidenceScope, type ExecutionClaim, type GroundingReceipt, HebbrixError, IndexingAbortedError, IndexingTerminalError, IndexingTimeoutError, IndexingWaitError, type IndexingWaitErrorOptions, type ListParams, MemoriesResource, type Memory, type MemoryAddResponse, type MemoryAddResult, MemoryClient, type MemoryJobReceipt, MemoryJobsResource, type MemoryListParams, MemoryToolsResource, type MemoryWithMetadata, NotFoundError, ProceduralResource, type ProofContext, type ProofLoopCandidate, type ProofLoopDecisionParams, type ProofLoopMetricParams, ProofLoopResource, RLResource, RateLimitError, type ReasonParams, type ReasoningResponse, type ReasoningSource, type SafetyEnvelope, type SearchParams, SearchResource, type SearchResponse, type SearchResult, ServerError, TemporalResource, type UpdateCollectionParams, type UpdateMemoryParams, type User, ValidationError, type VerifiedOutcomeDelivery, type VerifierRegistration, WorkingMemoryResource, enforceSearchSafety };
+export { type APIKeyResponse, AuthResource, type AuthResponse, AuthenticationError, type BatchMemoryCreateParams, type BatchMemoryItemParams, type BatchMemoryResponse, type ClientConfig, type Collection, CollectionsResource, ConsolidationResource, type CorrectionCreateParams, type CorrectionSearchParams, CorrectionsResource, type CreateCollectionParams, type CreateMemoryParams, type CursorPage, EntitlementError, type EpisodeCreateParams, type EvidenceClaim, type EvidenceScope, type ExecutionClaim, type ExperienceAssessmentParams, type ExperienceContextParams, type ExperienceProgramInput, ExperienceWorkflowResource, type GroundingReceipt, HebbrixError, IndexingAbortedError, IndexingTerminalError, IndexingTimeoutError, IndexingWaitError, type IndexingWaitErrorOptions, type LessonReviewInput, type LessonRevisionInput, type ListParams, MemoriesResource, type Memory, type MemoryAddResponse, type MemoryAddResult, MemoryClient, type MemoryJobReceipt, MemoryJobsResource, type MemoryListParams, MemoryToolsResource, type MemoryWithMetadata, NotFoundError, ProceduralResource, type ProofContext, type ProofLoopCandidate, type ProofLoopDecisionParams, type ProofLoopMetricParams, ProofLoopResource, RLResource, RateLimitError, type ReasonParams, type ReasoningResponse, type ReasoningSource, type ReflectionConfig, type ReflectionOutput, type ReflectionUncertainty, type SafetyEnvelope, type SearchParams, SearchResource, type SearchResponse, type SearchResult, ServerError, TemporalResource, type UpdateCollectionParams, type UpdateMemoryParams, type User, ValidationError, type VerifiedOutcomeDelivery, type VerifierRegistration, WorkingMemoryResource, enforceSearchSafety };

package/dist/index.d.ts

@@ -118,6 +118,40 @@ interface VerifierRegistration extends EvidenceScope {
     source_system: string;
     metric_keys: string[];
 }
+interface ExperienceAssessmentParams {
+    collection_id?: string | null;
+    user_id?: string | null;
+    context: Record<string, unknown>;
+    candidate: {
+        schema_version?: "experience-candidate-v1";
+        policy_key: string;
+        action_key: string;
+        lesson: string;
+        applicability: {
+            schema_version?: "experience-applicability-v1";
+            required: Record<string, string | number | boolean>;
+        };
+        sources: Array<{
+            decision_id: string;
+            evidence_revision: number;
+            bundle_digest: string;
+        }>;
+    };
+}
+interface ExperienceContextParams {
+    memory_collection_id: string;
+    evidence_collection_id?: string | null;
+    user_id?: string | null;
+    agent_id?: string | null;
+    run_id?: string | null;
+    policy_key: string;
+    references: Array<{
+        memory_id: string;
+        record_digest: string;
+    }>;
+    context: Record<string, unknown>;
+    max_context_bytes?: number;
+}
 interface EpisodeCreateParams extends EvidenceScope {
     verifier_id: string;
     idempotency_key: string;
@@ -131,6 +165,8 @@ interface ExecutionClaim {
     occurred_at?: string;
 }
 interface VerifiedOutcomeDelivery {
+    /** Optional source claims; their canonical digest must match evidence_digest. */
+    evidence_document?: Record<string, unknown>;
     decision_id: string;
     source_event_id: string;
     evidence_digest: string;
@@ -519,6 +555,10 @@ declare class ProofLoopResource extends BaseResource {
     /** Append an execution claim. This method does not execute a tool. */
     recordExecution(decisionId: string, claim: ExecutionClaim): Promise<Record<string, any>>;
     assessment(decisionId: string, evidenceOffset?: number): Promise<Record<string, any>>;
+    /** Revalidate a hypothesis against current source evidence; never permission to act. */
+    assessExperience(params: ExperienceAssessmentParams): Promise<Record<string, any>>;
+    /** Revalidate selected stored hypotheses; never grants execution permission. */
+    experienceContext(params: ExperienceContextParams): Promise<Record<string, any>>;
     verifierEvidence(verifierId: string, decisionId: string): Promise<Record<string, any>>;
     /** Deliver using the dedicated source credential, after checking execution independently. */
     deliverVerifiedOutcomes(verifierId: string, delivery: VerifiedOutcomeDelivery): Promise<Record<string, any>>;
@@ -716,6 +756,118 @@ declare class MemoryToolsResource extends BaseResource {
     rethink(memoryId: string, collectionId: string): Promise<any>;
 }
 
+/** Native workflow transport. Separate owner, worker and reviewer credentials.
+ * No provider call or autonomous tool execution is started by this resource.
+ */
+
+interface ReflectionConfig {
+    model: string;
+    applicability_keys: string[];
+    maximum_attempts: number;
+    budget_microusd: number;
+    per_attempt_microusd: number;
+    lease_seconds?: number;
+}
+interface ExperienceProgramInput {
+    collection_id?: string;
+    memory_collection_id: string;
+    user_id?: string;
+    agent_id?: string;
+    run_id?: string;
+    policy_key: string;
+    worker_key_id: string;
+    reviewer_key_id?: string;
+    source_since?: string;
+    config: ReflectionConfig;
+}
+interface ReflectionOutput {
+    schema_version?: "experience-reflection-output-v1";
+    hypotheses: Array<{
+        advice: string;
+        rationale: string;
+        limitations: string;
+        future_verification: string;
+    }>;
+    insufficient_evidence_reason?: string | null;
+}
+interface LessonReviewInput {
+    expected_sequence: number;
+    expected_digest: string | null;
+    candidate_digest: string;
+    verdict: "eligible" | "blocked" | "retracted";
+    rationale: string;
+}
+interface LessonRevisionInput extends Omit<LessonReviewInput, "verdict"> {
+    request_key: string;
+    hypothesis: ReflectionOutput["hypotheses"][number];
+}
+type ReflectionUncertainty = "provider_failure" | "invalid_provider_output" | "completion_delivery_uncertain";
+declare class ExperienceWorkflowResource {
+    private client;
+    constructor(client: MemoryClient);
+    definePermission(id: string, policy: {
+        actor_key_id: string;
+        tool_key: string;
+        target_digest: string;
+        action_keys: string[];
+        maximum_argument_bytes: number;
+        maximum_dispatches: number;
+        permit_seconds: number;
+        capability_contract: string;
+    }): Promise<any>;
+    activatePermission(id: string, activation: {
+        policy_id: string | null;
+        expected_sequence: number;
+        expected_digest: string | null;
+        rationale: string;
+    }): Promise<any>;
+    permissionState(id: string): Promise<any>;
+    issuePermit(id: string, input: {
+        lesson_id: string;
+        decision_id: string;
+        request_key: string;
+        invocation: {
+            tool_key: string;
+            target: Record<string, unknown>;
+            arguments: Record<string, unknown>;
+        };
+    }): Promise<any>;
+    dispatchPermit(id: string, invocationDigest: string): Promise<any>;
+    permit(id: string): Promise<any>;
+    register(input: ExperienceProgramInput): Promise<any>;
+    program(id: string): Promise<any>;
+    stop(id: string): Promise<any>;
+    claim(id: string, requestKey: string): Promise<any>;
+    job(id: string): Promise<any>;
+    /** A dispatch grant is single-use. Never retry a provider call after uncertainty. */
+    dispatch(id: string, input: {
+        input_digest: string;
+        request_digest: string;
+    }): Promise<any>;
+    complete(id: string, input: {
+        output: ReflectionOutput;
+        request_digest: string;
+        provider_response_digest: string;
+        reported_microusd: number;
+    }): Promise<any>;
+    uncertain(id: string, requestDigest: string, reason: ReflectionUncertainty): Promise<any>;
+    lessons(id: string, params?: {
+        after_id?: string;
+        limit?: number;
+    }): Promise<any>;
+    reviewQueue(id: string, params?: {
+        after_id?: string;
+        limit?: number;
+    }): Promise<any>;
+    lesson(id: string): Promise<any>;
+    review(id: string, input: LessonReviewInput): Promise<any>;
+    revise(id: string, input: LessonRevisionInput): Promise<any>;
+    reviews(id: string, params?: {
+        after_sequence?: number;
+        limit?: number;
+    }): Promise<any>;
+}
+
 declare class MemoryClient {
     private apiKey?;
     private baseUrl;
@@ -733,6 +885,7 @@ declare class MemoryClient {
     consolidation: ConsolidationResource;
     memoryTools: MemoryToolsResource;
     proofloop: ProofLoopResource;
+    experiences: ExperienceWorkflowResource;
     constructor(config?: ClientConfig);
     private getHeaders;
     private handleError;
@@ -855,4 +1008,4 @@ interface SafetyEnvelope {
  */
 declare function enforceSearchSafety<T extends object>(response: T, rowsKey?: "results" | "sources"): T & SafetyEnvelope;
 
-export { type APIKeyResponse, AuthResource, type AuthResponse, AuthenticationError, type BatchMemoryCreateParams, type BatchMemoryItemParams, type BatchMemoryResponse, type ClientConfig, type Collection, CollectionsResource, ConsolidationResource, type CorrectionCreateParams, type CorrectionSearchParams, CorrectionsResource, type CreateCollectionParams, type CreateMemoryParams, type CursorPage, EntitlementError, type EpisodeCreateParams, type EvidenceClaim, type EvidenceScope, type ExecutionClaim, type GroundingReceipt, HebbrixError, IndexingAbortedError, IndexingTerminalError, IndexingTimeoutError, IndexingWaitError, type IndexingWaitErrorOptions, type ListParams, MemoriesResource, type Memory, type MemoryAddResponse, type MemoryAddResult, MemoryClient, type MemoryJobReceipt, MemoryJobsResource, type MemoryListParams, MemoryToolsResource, type MemoryWithMetadata, NotFoundError, ProceduralResource, type ProofContext, type ProofLoopCandidate, type ProofLoopDecisionParams, type ProofLoopMetricParams, ProofLoopResource, RLResource, RateLimitError, type ReasonParams, type ReasoningResponse, type ReasoningSource, type SafetyEnvelope, type SearchParams, SearchResource, type SearchResponse, type SearchResult, ServerError, TemporalResource, type UpdateCollectionParams, type UpdateMemoryParams, type User, ValidationError, type VerifiedOutcomeDelivery, type VerifierRegistration, WorkingMemoryResource, enforceSearchSafety };
+export { type APIKeyResponse, AuthResource, type AuthResponse, AuthenticationError, type BatchMemoryCreateParams, type BatchMemoryItemParams, type BatchMemoryResponse, type ClientConfig, type Collection, CollectionsResource, ConsolidationResource, type CorrectionCreateParams, type CorrectionSearchParams, CorrectionsResource, type CreateCollectionParams, type CreateMemoryParams, type CursorPage, EntitlementError, type EpisodeCreateParams, type EvidenceClaim, type EvidenceScope, type ExecutionClaim, type ExperienceAssessmentParams, type ExperienceContextParams, type ExperienceProgramInput, ExperienceWorkflowResource, type GroundingReceipt, HebbrixError, IndexingAbortedError, IndexingTerminalError, IndexingTimeoutError, IndexingWaitError, type IndexingWaitErrorOptions, type LessonReviewInput, type LessonRevisionInput, type ListParams, MemoriesResource, type Memory, type MemoryAddResponse, type MemoryAddResult, MemoryClient, type MemoryJobReceipt, MemoryJobsResource, type MemoryListParams, MemoryToolsResource, type MemoryWithMetadata, NotFoundError, ProceduralResource, type ProofContext, type ProofLoopCandidate, type ProofLoopDecisionParams, type ProofLoopMetricParams, ProofLoopResource, RLResource, RateLimitError, type ReasonParams, type ReasoningResponse, type ReasoningSource, type ReflectionConfig, type ReflectionOutput, type ReflectionUncertainty, type SafetyEnvelope, type SearchParams, SearchResource, type SearchResponse, type SearchResult, ServerError, TemporalResource, type UpdateCollectionParams, type UpdateMemoryParams, type User, ValidationError, type VerifiedOutcomeDelivery, type VerifierRegistration, WorkingMemoryResource, enforceSearchSafety };

package/dist/index.js

@@ -26,6 +26,7 @@ __export(index_exports, {
   ConsolidationResource: () => ConsolidationResource,
   CorrectionsResource: () => CorrectionsResource,
   EntitlementError: () => EntitlementError,
+  ExperienceWorkflowResource: () => ExperienceWorkflowResource,
   HebbrixError: () => HebbrixError,
   IndexingAbortedError: () => IndexingAbortedError,
   IndexingTerminalError: () => IndexingTerminalError,
@@ -787,6 +788,14 @@ var ProofLoopResource = class extends BaseResource {
       { evidence_offset: evidenceOffset }
     );
   }
+  /** Revalidate a hypothesis against current source evidence; never permission to act. */
+  async assessExperience(params) {
+    return this.client.post("/v1/learning/experiences/assess", params);
+  }
+  /** Revalidate selected stored hypotheses; never grants execution permission. */
+  async experienceContext(params) {
+    return this.client.post("/v1/learning/experiences/context", params);
+  }
   async verifierEvidence(verifierId, decisionId) {
     return this.client.get(
       `/v1/learning/verifiers/${encodeURIComponent(verifierId)}/decisions/${encodeURIComponent(decisionId)}`
@@ -1125,6 +1134,79 @@ var MemoryToolsResource = class extends BaseResource {
   }
 };
 
+// src/experience-workflow.ts
+var root = "/v1/learning/experiences";
+var resource = (kind, id) => `${root}/${kind}/${encodeURIComponent(id)}`;
+var ExperienceWorkflowResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  definePermission(id, policy) {
+    return this.client.post(`${resource("programs", id)}/permission-policies`, policy);
+  }
+  activatePermission(id, activation) {
+    return this.client.post(`${resource("programs", id)}/permission-activation`, activation);
+  }
+  permissionState(id) {
+    return this.client.get(`${resource("programs", id)}/permission-state`);
+  }
+  issuePermit(id, input) {
+    return this.client.post(`${resource("programs", id)}/permits`, input);
+  }
+  dispatchPermit(id, invocationDigest) {
+    return this.client.post(`${resource("permits", id)}/dispatch`, { invocation_digest: invocationDigest });
+  }
+  permit(id) {
+    return this.client.get(resource("permits", id));
+  }
+  register(input) {
+    return this.client.post(`${root}/programs`, input);
+  }
+  program(id) {
+    return this.client.get(resource("programs", id));
+  }
+  stop(id) {
+    return this.client.post(`${resource("programs", id)}/stop`);
+  }
+  claim(id, requestKey) {
+    return this.client.post(`${resource("programs", id)}/claim`, { request_key: requestKey });
+  }
+  job(id) {
+    return this.client.get(resource("jobs", id));
+  }
+  /** A dispatch grant is single-use. Never retry a provider call after uncertainty. */
+  dispatch(id, input) {
+    return this.client.post(`${resource("jobs", id)}/dispatch`, input);
+  }
+  complete(id, input) {
+    return this.client.post(`${resource("jobs", id)}/complete`, input);
+  }
+  uncertain(id, requestDigest, reason) {
+    return this.client.post(`${resource("jobs", id)}/uncertain`, {
+      request_digest: requestDigest,
+      reason
+    });
+  }
+  lessons(id, params = {}) {
+    return this.client.get(`${resource("programs", id)}/lessons`, params);
+  }
+  reviewQueue(id, params = {}) {
+    return this.client.get(`${resource("programs", id)}/review-queue`, params);
+  }
+  lesson(id) {
+    return this.client.get(resource("lessons", id));
+  }
+  review(id, input) {
+    return this.client.post(`${resource("lessons", id)}/reviews`, input);
+  }
+  revise(id, input) {
+    return this.client.post(`${resource("lessons", id)}/revisions`, input);
+  }
+  reviews(id, params = {}) {
+    return this.client.get(`${resource("lessons", id)}/reviews`, params);
+  }
+};
+
 // src/client.ts
 var MemoryClient = class {
   constructor(config = {}) {
@@ -1145,11 +1227,12 @@ var MemoryClient = class {
     this.consolidation = new ConsolidationResource(this);
     this.memoryTools = new MemoryToolsResource(this);
     this.proofloop = new ProofLoopResource(this);
+    this.experiences = new ExperienceWorkflowResource(this);
   }
   getHeaders() {
     const headers = {
       "Content-Type": "application/json",
-      "User-Agent": "hebbrix-typescript/2.4.0"
+      "User-Agent": "hebbrix-typescript/2.5.0-rc.1"
     };
     if (this.apiKey) {
       headers["Authorization"] = `Bearer ${this.apiKey}`;
@@ -1286,6 +1369,7 @@ var MemoryClient = class {
   ConsolidationResource,
   CorrectionsResource,
   EntitlementError,
+  ExperienceWorkflowResource,
   HebbrixError,
   IndexingAbortedError,
   IndexingTerminalError,

package/dist/index.mjs

@@ -736,6 +736,14 @@ var ProofLoopResource = class extends BaseResource {
       { evidence_offset: evidenceOffset }
     );
   }
+  /** Revalidate a hypothesis against current source evidence; never permission to act. */
+  async assessExperience(params) {
+    return this.client.post("/v1/learning/experiences/assess", params);
+  }
+  /** Revalidate selected stored hypotheses; never grants execution permission. */
+  async experienceContext(params) {
+    return this.client.post("/v1/learning/experiences/context", params);
+  }
   async verifierEvidence(verifierId, decisionId) {
     return this.client.get(
       `/v1/learning/verifiers/${encodeURIComponent(verifierId)}/decisions/${encodeURIComponent(decisionId)}`
@@ -1074,6 +1082,79 @@ var MemoryToolsResource = class extends BaseResource {
   }
 };
 
+// src/experience-workflow.ts
+var root = "/v1/learning/experiences";
+var resource = (kind, id) => `${root}/${kind}/${encodeURIComponent(id)}`;
+var ExperienceWorkflowResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  definePermission(id, policy) {
+    return this.client.post(`${resource("programs", id)}/permission-policies`, policy);
+  }
+  activatePermission(id, activation) {
+    return this.client.post(`${resource("programs", id)}/permission-activation`, activation);
+  }
+  permissionState(id) {
+    return this.client.get(`${resource("programs", id)}/permission-state`);
+  }
+  issuePermit(id, input) {
+    return this.client.post(`${resource("programs", id)}/permits`, input);
+  }
+  dispatchPermit(id, invocationDigest) {
+    return this.client.post(`${resource("permits", id)}/dispatch`, { invocation_digest: invocationDigest });
+  }
+  permit(id) {
+    return this.client.get(resource("permits", id));
+  }
+  register(input) {
+    return this.client.post(`${root}/programs`, input);
+  }
+  program(id) {
+    return this.client.get(resource("programs", id));
+  }
+  stop(id) {
+    return this.client.post(`${resource("programs", id)}/stop`);
+  }
+  claim(id, requestKey) {
+    return this.client.post(`${resource("programs", id)}/claim`, { request_key: requestKey });
+  }
+  job(id) {
+    return this.client.get(resource("jobs", id));
+  }
+  /** A dispatch grant is single-use. Never retry a provider call after uncertainty. */
+  dispatch(id, input) {
+    return this.client.post(`${resource("jobs", id)}/dispatch`, input);
+  }
+  complete(id, input) {
+    return this.client.post(`${resource("jobs", id)}/complete`, input);
+  }
+  uncertain(id, requestDigest, reason) {
+    return this.client.post(`${resource("jobs", id)}/uncertain`, {
+      request_digest: requestDigest,
+      reason
+    });
+  }
+  lessons(id, params = {}) {
+    return this.client.get(`${resource("programs", id)}/lessons`, params);
+  }
+  reviewQueue(id, params = {}) {
+    return this.client.get(`${resource("programs", id)}/review-queue`, params);
+  }
+  lesson(id) {
+    return this.client.get(resource("lessons", id));
+  }
+  review(id, input) {
+    return this.client.post(`${resource("lessons", id)}/reviews`, input);
+  }
+  revise(id, input) {
+    return this.client.post(`${resource("lessons", id)}/revisions`, input);
+  }
+  reviews(id, params = {}) {
+    return this.client.get(`${resource("lessons", id)}/reviews`, params);
+  }
+};
+
 // src/client.ts
 var MemoryClient = class {
   constructor(config = {}) {
@@ -1094,11 +1175,12 @@ var MemoryClient = class {
     this.consolidation = new ConsolidationResource(this);
     this.memoryTools = new MemoryToolsResource(this);
     this.proofloop = new ProofLoopResource(this);
+    this.experiences = new ExperienceWorkflowResource(this);
   }
   getHeaders() {
     const headers = {
       "Content-Type": "application/json",
-      "User-Agent": "hebbrix-typescript/2.4.0"
+      "User-Agent": "hebbrix-typescript/2.5.0-rc.1"
     };
     if (this.apiKey) {
       headers["Authorization"] = `Bearer ${this.apiKey}`;
@@ -1234,6 +1316,7 @@ export {
   ConsolidationResource,
   CorrectionsResource,
   EntitlementError,
+  ExperienceWorkflowResource,
   HebbrixError,
   IndexingAbortedError,
   IndexingTerminalError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hebbrix",
-  "version": "2.4.0",
+  "version": "2.5.0-rc.1",
   "description": "Typed TypeScript client for Hebbrix memory, retrieval, and outcome-learning APIs",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -55,7 +55,8 @@
   },
   "homepage": "https://docs.hebbrix.com",
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "tag": "next"
   },
   "devDependencies": {
     "@types/node": "^20.10.0",