@namzu/sdk 54.0.0 → 55.1.0

package/dist/{manager/resident/learning-cycle.d.ts → learning/cycle.d.ts}

@@ -1,10 +1,11 @@
 import { z } from 'zod';
-import { type HarnessProtectionPlan } from '../../eval/harness-protection.js';
-import { type HarnessReview, type HarnessVerificationBatch } from '../../eval/harness-verification.js';
-import type { DiskResidentAgenda } from './agenda.js';
-import { type ResidentLearningEvidence, type ResidentSkillCandidate } from './learning.js';
+import { type HarnessProtectionPlan } from '../eval/harness-protection.js';
+import { type HarnessReview, type HarnessVerificationBatch } from '../eval/harness-verification.js';
+import type { DiskResidentAgenda } from '../manager/resident/agenda.js';
+import { type LearningLeakFinding, type LearningLeakGuard } from './leak-tripwire.js';
+import { type LearningEvidence, type LearningSkillCandidate } from './skill.js';
 /** @experimental One explicitly requested experiment; callbacks own inference and evaluation. */
-export type ResidentLearningStage = 'explore' | 'generate' | 'verification' | 'confirmation';
+export type LearningStage = 'explore' | 'generate' | 'verification' | 'confirmation';
 declare const receiptSchema: z.ZodObject<{
     /** The session and turn of the execution this usage belongs to; one receipt per turn. */
     sessionId: z.ZodString;
@@ -23,9 +24,9 @@ declare const receiptSchema: z.ZodObject<{
     costUsd: number | null;
 }>;
 /** @experimental One non-overlapping execution's usage, including its retries. Null is unknown. */
-export type ResidentLearningReceipt = Readonly<z.infer<typeof receiptSchema>>;
+export type LearningReceipt = Readonly<z.infer<typeof receiptSchema>>;
 /** @experimental Recorded values are lower bounds when a receipt or stage is incomplete. */
-export interface ResidentLearningConsumption {
+export interface LearningConsumption {
     readonly tokens: number;
     readonly costUsd: number;
     readonly receipts: number;
@@ -34,51 +35,51 @@ export interface ResidentLearningConsumption {
     readonly unfinishedStages: number;
 }
 /** @experimental Append in sequence to host-owned durable storage before acknowledging. */
-export interface ResidentLearningCycleEvent {
+export interface LearningCycleEvent {
     readonly cycleId: string;
     readonly sequence: number;
     readonly kind: 'started' | 'stage-started' | 'stage-finished' | 'usage' | 'exploration' | 'candidate' | 'evaluation' | 'activation-requested' | 'finished';
-    readonly stage?: ResidentLearningStage;
+    readonly stage?: LearningStage;
     readonly data: Readonly<Record<string, unknown>>;
 }
 /** @experimental Use this stage's signal for every owned execution; await every usage append. */
-export interface ResidentLearningCycleContext {
+export interface LearningCycleContext {
     readonly cycleId: string;
-    readonly stage: ResidentLearningStage;
+    readonly stage: LearningStage;
     readonly signal: AbortSignal;
     /** Planning allowance, not a reservation or a cap on a callback's in-flight work. */
     readonly remainingUnits: number;
-    recordUsage(receipt: ResidentLearningReceipt): Promise<void>;
+    recordUsage(receipt: LearningReceipt): Promise<void>;
 }
 /** @experimental Original failure and active baseline; never contains confirmation tasks. */
-export interface ResidentLearningExplorationContext extends ResidentLearningCycleContext {
+export interface LearningExplorationContext extends LearningCycleContext {
     readonly skillName: string;
     /** Admitted by the host before generation; cannot be changed by a candidate. */
     readonly purpose?: 'task' | 'exploration';
     readonly failure: Readonly<{
-        evidence: ResidentLearningEvidence;
+        evidence: LearningEvidence;
         trace: string;
     }>;
-    readonly baseline: ResidentSkillCandidate | null;
+    readonly baseline: LearningSkillCandidate | null;
 }
 /** @experimental Host-retained environment observations, not a model's claim of success. */
-export interface ResidentLearningExploration {
-    readonly evidence: ResidentLearningEvidence;
+export interface LearningExploration {
+    readonly evidence: LearningEvidence;
     readonly trace: string;
 }
 /** @experimental Generation sees completed exploration, never held-out evaluation cases. */
-export interface ResidentLearningGenerationContext extends ResidentLearningExplorationContext {
-    readonly exploration?: Readonly<ResidentLearningExploration>;
+export interface LearningGenerationContext extends LearningExplorationContext {
+    readonly exploration?: Readonly<LearningExploration>;
 }
 /** @experimental The host supplies independently scored, retained traces for these exact revisions. */
-export interface ResidentLearningEvaluationContext extends ResidentLearningCycleContext {
-    readonly baseline: ResidentSkillCandidate | null;
-    readonly candidate: ResidentSkillCandidate;
+export interface LearningEvaluationContext extends LearningCycleContext {
+    readonly baseline: LearningSkillCandidate | null;
+    readonly candidate: LearningSkillCandidate;
     readonly baselineRevision: string;
     readonly candidateRevision: string;
 }
-/** @experimental No provider, default background loop or executable-code activation is installed. */
-export interface ResidentLearningCycleOptions {
+/** @experimental The SDK installs no provider, background loop or executable-code activation; the host supplies them. */
+export interface LearningCycleOptions {
     /** Omitted means task guidance. Explicitly select exploration to improve an explorer policy. */
     readonly purpose?: 'task' | 'exploration';
     /** Fixed before generation; both rounds must preserve every named task. */
@@ -86,43 +87,51 @@ export interface ResidentLearningCycleOptions {
     readonly agenda: Pick<DiskResidentAgenda, 'read' | 'promoteSkill'>;
     readonly skillName: string;
     readonly failure: {
-        readonly evidence: ResidentLearningEvidence;
+        readonly evidence: LearningEvidence;
         readonly trace: string;
     };
     readonly parentCycleId?: string;
+    /**
+     * Evaluator-side material to keep out of the evidence and the guidance built
+     * from it. The built-in markers and secret shapes always apply. A hit refuses
+     * the cycle as a leak (see `LearningCycleResult.leak`), before anything is built.
+     */
+    readonly leakGuard?: LearningLeakGuard;
     readonly signal: AbortSignal;
     /** Stops subsequent stages/activation after observed excess; callbacks enforce in-flight limits. */
     readonly resources: {
         readonly unit: 'tokens' | 'usd';
         readonly maxUnits: number;
     };
-    readonly record: (event: ResidentLearningCycleEvent) => Promise<void>;
+    readonly record: (event: LearningCycleEvent) => Promise<void>;
     /** Optional active tool exploration before synthesis; the host retains actual observations. */
-    readonly explore?: (context: ResidentLearningExplorationContext) => Promise<{
-        readonly observations: ResidentLearningExploration;
+    readonly explore?: (context: LearningExplorationContext) => Promise<{
+        readonly observations: LearningExploration;
         readonly usageComplete: boolean;
     }>;
-    readonly generate: (context: ResidentLearningGenerationContext) => Promise<{
-        readonly candidate: ResidentSkillCandidate;
+    readonly generate: (context: LearningGenerationContext) => Promise<{
+        readonly candidate: LearningSkillCandidate;
         /** All executions, including failures and side calls, have supplied receipts. */
         readonly usageComplete: boolean;
     }>;
-    readonly evaluate: (context: ResidentLearningEvaluationContext) => Promise<{
+    readonly evaluate: (context: LearningEvaluationContext) => Promise<{
         readonly batch: HarnessVerificationBatch;
         readonly usageComplete: boolean;
     }>;
 }
 /** @experimental An ambiguous activation must be inspected, never automatically replayed. */
-export interface ResidentLearningCycleResult {
+export interface LearningCycleResult {
     readonly cycleId: string;
     readonly status: 'activated' | 'rejected' | 'inconclusive' | 'conflict' | 'cancelled' | 'failed' | 'activation-unknown';
     readonly reason: string;
-    readonly candidate?: ResidentSkillCandidate;
+    readonly candidate?: LearningSkillCandidate;
     readonly candidateRevision?: string;
     readonly baselineRevision?: string;
     readonly agendaRevision?: number;
     readonly review?: HarnessReview;
-    readonly consumption: ResidentLearningConsumption;
+    /** Present when the cycle was refused as a leak: where it was seen, never the text. */
+    readonly leak?: readonly LearningLeakFinding[];
+    readonly consumption: LearningConsumption;
     readonly auditComplete: boolean;
 }
 /**
@@ -130,6 +139,6 @@ export interface ResidentLearningCycleResult {
  * activate through the existing exact-revision transaction. No internal inference
  * loop, retry or model-generated success claim replaces the host's evaluator.
  */
-export declare function runResidentLearningCycle(options: ResidentLearningCycleOptions): Promise<ResidentLearningCycleResult>;
+export declare function runLearningCycle(options: LearningCycleOptions): Promise<LearningCycleResult>;
 export {};
-//# sourceMappingURL=learning-cycle.d.ts.map
+//# sourceMappingURL=cycle.d.ts.map

package/dist/learning/cycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cycle.d.ts","sourceRoot":"","sources":["../../src/learning/cycle.ts"],"names":[],"mappings":"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"}

package/dist/{manager/resident/learning-cycle.js → learning/cycle.js}

@@ -1,9 +1,10 @@
 import { createHash, randomUUID } from 'node:crypto';
 import { z } from 'zod';
-import { normalizeHarnessProtection, } from '../../eval/harness-protection.js';
-import { reviewHarnessCandidate, } from '../../eval/harness-verification.js';
-import { hashResidentSkill, normalizeResidentSkill, promoteResidentSkill, residentLearningEvidenceSchema, } from './learning.js';
-import { ResidentConflictError } from './store.js';
+import { normalizeHarnessProtection, } from '../eval/harness-protection.js';
+import { reviewHarnessCandidate, } from '../eval/harness-verification.js';
+import { ResidentConflictError } from '../manager/resident/store.js';
+import { LearningLeakError, assertNoLearningLeak, } from './leak-tripwire.js';
+import { hashLearningSkill, learningEvidenceSchema, normalizeLearningSkill, promoteLearningSkill, } from './skill.js';
 const receiptSchema = z.object({
     /** The session and turn of the execution this usage belongs to; one receipt per turn. */
     sessionId: z.string().uuid(),
@@ -16,7 +17,7 @@ const receiptSchema = z.object({
  * activate through the existing exact-revision transaction. No internal inference
  * loop, retry or model-generated success claim replaces the host's evaluator.
  */
-export async function runResidentLearningCycle(options) {
+export async function runLearningCycle(options) {
     const protection = normalizeHarnessProtection(options.protection);
     const purpose = z.enum(['task', 'exploration']).parse(options.purpose ?? 'task');
     const purposeContext = options.purpose === undefined ? {} : { purpose };
@@ -25,7 +26,7 @@ export async function runResidentLearningCycle(options) {
         .regex(/^[a-z0-9][a-z0-9_-]{0,63}$/)
         .parse(options.skillName);
     const failure = Object.freeze({
-        evidence: Object.freeze(residentLearningEvidenceSchema.parse(options.failure.evidence)),
+        evidence: Object.freeze(learningEvidenceSchema.parse(options.failure.evidence)),
         trace: z.string().trim().min(1).max(32_000).parse(options.failure.trace),
     });
     const resources = z
@@ -44,6 +45,7 @@ export async function runResidentLearningCycle(options) {
     let review;
     let activatedRevision;
     let activationRequested = false;
+    let leak;
     const usage = () => ({
         tokens: [...receipts.values()].reduce((n, r) => n + (r.tokens ?? 0), 0),
         costUsd: [...receipts.values()].reduce((n, r) => n + (r.costUsd ?? 0), 0),
@@ -75,6 +77,7 @@ export async function runResidentLearningCycle(options) {
         ...(candidate ? { candidate, candidateRevision } : {}),
         ...(baselineRevision ? { baselineRevision } : {}),
         ...(review ? { review } : {}),
+        ...(leak ? { leak } : {}),
         ...(activatedRevision !== undefined ? { agendaRevision: activatedRevision } : {}),
         consumption: usage(),
         auditComplete,
@@ -93,6 +96,11 @@ export async function runResidentLearningCycle(options) {
     };
     const execute = async () => {
         options.signal.throwIfAborted();
+        const guard = (...subjects) => assertNoLearningLeak(options.leakGuard, subjects);
+        guard({
+            subject: 'failure.evidence',
+            text: `${failure.evidence.key}\n${failure.evidence.source}\n${failure.evidence.reason}`,
+        }, { subject: 'failure.trace', text: failure.trace });
         const snapshot = structuredClone(await options.agenda.read());
         if (!snapshot)
             throw new Error('No resident agenda exists for this learning cycle.');
@@ -101,8 +109,18 @@ export async function runResidentLearningCycle(options) {
         const current = snapshot.learning?.skills.find((s) => s.name === skillName);
         if (current && (current.purpose ?? 'task') !== purpose)
             throw new Error('The active skill has a different learning purpose; use a distinct skill name.');
-        const baseline = current ? normalizeResidentSkill(current) : null;
-        baselineRevision = baseline ? hashResidentSkill(baseline) : 'none';
+        const baseline = current ? normalizeLearningSkill(current) : null;
+        baselineRevision = baseline ? hashLearningSkill(baseline) : 'none';
+        if (baseline)
+            guard({
+                subject: 'baseline',
+                text: [
+                    baseline.name,
+                    baseline.description,
+                    baseline.body,
+                    ...(baseline.sources ? [JSON.stringify(baseline.sources)] : []),
+                ].join('\n'),
+            });
         await append('started', {
             tenantId: snapshot.tenantId,
             agentKey: snapshot.agentKey,
@@ -187,9 +205,13 @@ export async function runResidentLearningCycle(options) {
             const explore = options.explore;
             const observed = await stage('explore', (context) => explore(Object.freeze({ ...context, skillName, ...purposeContext, failure, baseline })));
             exploration = Object.freeze({
-                evidence: Object.freeze(residentLearningEvidenceSchema.parse(observed.observations.evidence)),
+                evidence: Object.freeze(learningEvidenceSchema.parse(observed.observations.evidence)),
                 trace: z.string().trim().min(1).max(32_000).parse(observed.observations.trace),
             });
+            guard({
+                subject: 'exploration.evidence',
+                text: `${exploration.evidence.key}\n${exploration.evidence.source}\n${exploration.evidence.reason}`,
+            }, { subject: 'exploration.trace', text: exploration.trace });
             await append('exploration', {
                 observations: exploration,
                 digest: createHash('sha256').update(JSON.stringify(exploration)).digest('hex'),
@@ -206,8 +228,14 @@ export async function runResidentLearningCycle(options) {
             baseline,
             ...(exploration ? { exploration } : {}),
         })));
-        candidateRevision = hashResidentSkill(generated.candidate);
-        candidate = normalizeResidentSkill(generated.candidate);
+        const built = normalizeLearningSkill(generated.candidate);
+        guard({ subject: 'candidate.name', text: built.name }, { subject: 'candidate.description', text: built.description }, { subject: 'candidate.body', text: built.body }, {
+            subject: 'candidate.sources',
+            text: (built.sources ?? []).map((s) => `${s.key}\n${s.revision}`).join('\n'),
+            paths: (built.sources ?? []).map((s) => s.key),
+        });
+        candidateRevision = hashLearningSkill(generated.candidate);
+        candidate = built;
         if ((candidate.purpose ?? 'task') !== purpose)
             throw new Error('Generated skill purpose does not match the host-admitted learning purpose.');
         if (candidate.name !== skillName)
@@ -270,7 +298,7 @@ export async function runResidentLearningCycle(options) {
         };
         // Validate all existing activation contracts before entering the ambiguous
         // commit interval. The store repeats this against its atomic snapshot.
-        promoteResidentSkill(snapshot.learning, candidate, { verification, confirmation, protection }, evidence);
+        promoteLearningSkill(snapshot.learning, candidate, { verification, confirmation, protection }, evidence);
         await append('activation-requested', {
             baselineRevision,
             candidateRevision,
@@ -287,13 +315,17 @@ export async function runResidentLearningCycle(options) {
         outcome = await execute();
     }
     catch (error) {
-        outcome = result(error instanceof ResidentConflictError
-            ? 'conflict'
-            : activationRequested
-                ? 'activation-unknown'
-                : options.signal.aborted
-                    ? 'cancelled'
-                    : 'failed', error instanceof Error ? error.message : String(error));
+        if (error instanceof LearningLeakError)
+            leak = error.findings;
+        outcome = result(error instanceof LearningLeakError
+            ? 'failed'
+            : error instanceof ResidentConflictError
+                ? 'conflict'
+                : activationRequested
+                    ? 'activation-unknown'
+                    : options.signal.aborted
+                        ? 'cancelled'
+                        : 'failed', error instanceof Error ? error.message : String(error));
     }
     if (auditComplete) {
         try {
@@ -305,4 +337,4 @@ export async function runResidentLearningCycle(options) {
     }
     return { ...outcome, auditComplete };
 }
-//# sourceMappingURL=learning-cycle.js.map
+//# sourceMappingURL=cycle.js.map

package/dist/learning/cycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cycle.js","sourceRoot":"","sources":["../../src/learning/cycle.ts"],"names":[],"mappings":"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"}

package/dist/learning/deprecated.d.ts

@@ -0,0 +1,86 @@
+/**
+ * The learning module used to live under `manager/resident` and carried a
+ * `Resident` prefix. Learning is a feature of all of Namzu, not of residents,
+ * so every name now lives in `learning/` without the prefix. The old names stay
+ * as aliases of the new ones until the next major release.
+ */
+import { runLearningCycle } from './cycle.js';
+import type * as Cycle from './cycle.js';
+import type * as Observation from './observation.js';
+import { hashLearningSkill, projectLearning } from './skill.js';
+import type * as Skill from './skill.js';
+import { SqliteLearningStore, runStoredLearningCycle, runStoredLearningFromObservations } from './store.js';
+import type * as Store from './store.js';
+/** @deprecated Renamed to `LearningEvidence`; the old name is removed in the next major release. */
+export type ResidentLearningEvidence = Skill.LearningEvidence;
+/** @deprecated Renamed to `LearningSkillCandidate`; the old name is removed in the next major release. */
+export type ResidentSkillCandidate = Skill.LearningSkillCandidate;
+/** @deprecated Renamed to `LearnedSkill`; the old name is removed in the next major release. */
+export type ResidentLearnedSkill = Skill.LearnedSkill;
+/** @deprecated Renamed to `LearningState`; the old name is removed in the next major release. */
+export type ResidentLearningState = Skill.LearningState;
+/** @deprecated Renamed to `LearningProfileUpdate`; the old name is removed in the next major release. */
+export type ResidentProfileUpdate = Skill.LearningProfileUpdate;
+/** @deprecated Renamed to `LearningSkillEvaluation`; the old name is removed in the next major release. */
+export type ResidentSkillEvaluation = Skill.LearningSkillEvaluation;
+/** @deprecated Renamed to `LearningProjectionOptions`; the old name is removed in the next major release. */
+export type ResidentLearningProjectionOptions = Skill.LearningProjectionOptions;
+/** @deprecated Renamed to `LearningSource`; the old name is removed in the next major release. */
+export type ResidentLearningSource = Skill.LearningSource;
+/** @deprecated Renamed to `LearningProjection`; the old name is removed in the next major release. */
+export type ResidentLearningProjection = Skill.LearningProjection;
+/** @deprecated Renamed to `LearningStage`; the old name is removed in the next major release. */
+export type ResidentLearningStage = Cycle.LearningStage;
+/** @deprecated Renamed to `LearningReceipt`; the old name is removed in the next major release. */
+export type ResidentLearningReceipt = Cycle.LearningReceipt;
+/** @deprecated Renamed to `LearningConsumption`; the old name is removed in the next major release. */
+export type ResidentLearningConsumption = Cycle.LearningConsumption;
+/** @deprecated Renamed to `LearningCycleEvent`; the old name is removed in the next major release. */
+export type ResidentLearningCycleEvent = Cycle.LearningCycleEvent;
+/** @deprecated Renamed to `LearningCycleContext`; the old name is removed in the next major release. */
+export type ResidentLearningCycleContext = Cycle.LearningCycleContext;
+/** @deprecated Renamed to `LearningGenerationContext`; the old name is removed in the next major release. */
+export type ResidentLearningGenerationContext = Cycle.LearningGenerationContext;
+/** @deprecated Renamed to `LearningExplorationContext`; the old name is removed in the next major release. */
+export type ResidentLearningExplorationContext = Cycle.LearningExplorationContext;
+/** @deprecated Renamed to `LearningExploration`; the old name is removed in the next major release. */
+export type ResidentLearningExploration = Cycle.LearningExploration;
+/** @deprecated Renamed to `LearningEvaluationContext`; the old name is removed in the next major release. */
+export type ResidentLearningEvaluationContext = Cycle.LearningEvaluationContext;
+/** @deprecated Renamed to `LearningCycleOptions`; the old name is removed in the next major release. */
+export type ResidentLearningCycleOptions = Cycle.LearningCycleOptions;
+/** @deprecated Renamed to `LearningCycleResult`; the old name is removed in the next major release. */
+export type ResidentLearningCycleResult = Cycle.LearningCycleResult;
+/** @deprecated Renamed to `SqliteLearningStoreOptions`; the old name is removed in the next major release. */
+export type SqliteResidentLearningStoreOptions = Store.SqliteLearningStoreOptions;
+/** @deprecated Renamed to `LearningArtifact`; the old name is removed in the next major release. */
+export type ResidentLearningArtifact = Store.LearningArtifact;
+/** @deprecated Renamed to `LearningRecordedUsage`; the old name is removed in the next major release. */
+export type ResidentLearningRecordedUsage = Store.LearningRecordedUsage;
+/** @deprecated Renamed to `LearningCycleSummary`; the old name is removed in the next major release. */
+export type ResidentLearningCycleSummary = Store.LearningCycleSummary;
+/** @deprecated Renamed to `LearningDiscoveryOptions`; the old name is removed in the next major release. */
+export type ResidentLearningDiscoveryOptions = Store.LearningDiscoveryOptions;
+/** @deprecated Renamed to `LearningDiscoveryResult`; the old name is removed in the next major release. */
+export type ResidentLearningDiscoveryResult = Store.LearningDiscoveryResult;
+/** @deprecated Renamed to `LearningObservation`; the old name is removed in the next major release. */
+export type ResidentLearningObservation = Observation.LearningObservation;
+/** @deprecated Renamed to `LearningObservationRecord`; the old name is removed in the next major release. */
+export type ResidentLearningObservationRecord = Observation.LearningObservationRecord;
+/** @deprecated Renamed to `LearningTarget`; the old name is removed in the next major release. */
+export type ResidentLearningTarget = Observation.LearningTarget;
+/** @deprecated Renamed to `hashLearningSkill`; the old name is removed in the next major release. */
+export declare const hashResidentSkill: typeof hashLearningSkill;
+/** @deprecated Renamed to `projectLearning`; the old name is removed in the next major release. */
+export declare const projectResidentLearning: typeof projectLearning;
+/** @deprecated Renamed to `runLearningCycle`; the old name is removed in the next major release. */
+export declare const runResidentLearningCycle: typeof runLearningCycle;
+/** @deprecated Renamed to `runStoredLearningCycle`; the old name is removed in the next major release. */
+export declare const runStoredResidentLearningCycle: typeof runStoredLearningCycle;
+/** @deprecated Renamed to `runStoredLearningFromObservations`; the old name is removed in the next major release. */
+export declare const runStoredResidentLearningFromObservations: typeof runStoredLearningFromObservations;
+/** @deprecated Renamed to `SqliteLearningStore`; the old name is removed in the next major release. */
+export declare const SqliteResidentLearningStore: typeof SqliteLearningStore;
+/** @deprecated Renamed to `SqliteLearningStore`; the old name is removed in the next major release. */
+export type SqliteResidentLearningStore = SqliteLearningStore;
+//# sourceMappingURL=deprecated.d.ts.map

package/dist/learning/deprecated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecated.d.ts","sourceRoot":"","sources":["../../src/learning/deprecated.ts"],"names":[],"mappings":"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"}

package/dist/learning/deprecated.js

@@ -0,0 +1,22 @@
+/**
+ * The learning module used to live under `manager/resident` and carried a
+ * `Resident` prefix. Learning is a feature of all of Namzu, not of residents,
+ * so every name now lives in `learning/` without the prefix. The old names stay
+ * as aliases of the new ones until the next major release.
+ */
+import { runLearningCycle } from './cycle.js';
+import { hashLearningSkill, projectLearning } from './skill.js';
+import { SqliteLearningStore, runStoredLearningCycle, runStoredLearningFromObservations, } from './store.js';
+/** @deprecated Renamed to `hashLearningSkill`; the old name is removed in the next major release. */
+export const hashResidentSkill = hashLearningSkill;
+/** @deprecated Renamed to `projectLearning`; the old name is removed in the next major release. */
+export const projectResidentLearning = projectLearning;
+/** @deprecated Renamed to `runLearningCycle`; the old name is removed in the next major release. */
+export const runResidentLearningCycle = runLearningCycle;
+/** @deprecated Renamed to `runStoredLearningCycle`; the old name is removed in the next major release. */
+export const runStoredResidentLearningCycle = runStoredLearningCycle;
+/** @deprecated Renamed to `runStoredLearningFromObservations`; the old name is removed in the next major release. */
+export const runStoredResidentLearningFromObservations = runStoredLearningFromObservations;
+/** @deprecated Renamed to `SqliteLearningStore`; the old name is removed in the next major release. */
+export const SqliteResidentLearningStore = SqliteLearningStore;
+//# sourceMappingURL=deprecated.js.map

package/dist/learning/deprecated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecated.js","sourceRoot":"","sources":["../../src/learning/deprecated.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAG7C,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE/D,OAAO,EACN,mBAAmB,EACnB,sBAAsB,EACtB,iCAAiC,GACjC,MAAM,YAAY,CAAA;AA0FnB,qGAAqG;AACrG,MAAM,CAAC,MAAM,iBAAiB,GAAG,iBAAiB,CAAA;AAElD,mGAAmG;AACnG,MAAM,CAAC,MAAM,uBAAuB,GAAG,eAAe,CAAA;AAEtD,oGAAoG;AACpG,MAAM,CAAC,MAAM,wBAAwB,GAAG,gBAAgB,CAAA;AAExD,0GAA0G;AAC1G,MAAM,CAAC,MAAM,8BAA8B,GAAG,sBAAsB,CAAA;AAEpE,qHAAqH;AACrH,MAAM,CAAC,MAAM,yCAAyC,GAAG,iCAAiC,CAAA;AAE1F,uGAAuG;AACvG,MAAM,CAAC,MAAM,2BAA2B,GAAG,mBAAmB,CAAA"}

package/dist/learning/experience-store.d.ts

@@ -0,0 +1,35 @@
+import type { ProjectId, TenantId } from '../types/ids/index.js';
+import { type LearningExperienceEntry, type LearningExperienceInput, type LearningExperienceQuery } from './experience.js';
+/** The schema version this store reads and writes. */
+export declare const LEARNING_EXPERIENCE_STORE_VERSION = 1;
+/** @experimental Where the library lives; a separate file from the observation journal. */
+export interface SqliteLearningExperienceStoreOptions {
+    readonly databasePath: string;
+    readonly scope: {
+        readonly tenantId: TenantId;
+        readonly projectId: ProjectId;
+        readonly agentKey: string;
+    };
+    readonly readOnly?: boolean;
+}
+/**
+ * @experimental Durable experience library. Entries are immutable: recording
+ * the same cycle again with identical content returns the stored entry, with
+ * different content is refused. The artefact is stored whole.
+ */
+export declare class SqliteLearningExperienceStore {
+    readonly databasePath: string;
+    private readonly scope;
+    private readonly readOnly;
+    constructor(options: SqliteLearningExperienceStoreOptions);
+    private use;
+    private scopeArgs;
+    private decode;
+    /** Record one finished cycle. Throws `LearningLeakError` when the entry carries evaluator-side material. */
+    record(input: LearningExperienceInput): Promise<LearningExperienceEntry>;
+    /** The ordinal the next entry will be recorded after; pass it as `beforeOrdinal` to read everything so far. */
+    nextOrdinal(): Promise<number>;
+    /** Entries of one domain and evaluator revision recorded before `beforeOrdinal`, newest first. */
+    retrieve(query: LearningExperienceQuery): Promise<LearningExperienceEntry[]>;
+}
+//# sourceMappingURL=experience-store.d.ts.map

package/dist/learning/experience-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"experience-store.d.ts","sourceRoot":"","sources":["../../src/learning/experience-store.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAEhE,OAAO,EACN,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAI5B,MAAM,iBAAiB,CAAA;AAexB,sDAAsD;AACtD,eAAO,MAAM,iCAAiC,IAAI,CAAA;AAElD,2FAA2F;AAC3F,MAAM,WAAW,oCAAoC;IACpD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE;QACf,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;QAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;QAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KACzB,CAAA;IACD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAC3B;AAID;;;;GAIG;AACH,qBAAa,6BAA6B;IACzC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+C;IACrE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,OAAO,EAAE,oCAAoC;IAazD,OAAO,CAAC,GAAG;IA6CX,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,MAAM;IAOd,4GAA4G;IACtG,MAAM,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAkC9E,+GAA+G;IACzG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAepC,kGAAkG;IAC5F,QAAQ,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;CAyBlF"}