@namzu/sdk 55.0.0 → 55.1.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 55.1.0
+
+### Minor Changes
+
+- 5aae7c4: New, additive: an experience library for the learning module. `SqliteLearningExperienceStore` records, per adopted or rejected cycle, the full artefact, a typed edit ledger (surface, change, verdict `helped` / `hurt` / `no observed effect` / `confounded`) and lessons (cue, lesson, evidence, confidence with a reason). When a candidate changed several components, rows not tried alone are stored as `confounded`, and a lesson resting on confounded edits is capped at medium or low. `retrieve` returns entries only from the same domain and evaluator revision, and only those recorded before the ordinal you pass. Entries are immutable, run through the leak tripwire, and live in a separate database file. New exports: `SqliteLearningExperienceStore`, `normalizeLearningExperience`, `selectLearningExperience`, `LEARNING_EDIT_VERDICTS`, `LEARNING_CONFIDENCE_LEVELS`, `LEARNING_EXPERIENCE_STORE_VERSION` and the related types. Nothing existing changes; the cycle does not read the library yet. `record` and `retrieve` require a `leakGuard` (pass `{}` for the built-in checks only) and scan every string an entry holds, on write and again on read. More than one edit row is treated as changed together unless marked `isolated`, and a lesson citing no edits is capped as resting on all of them.
+- 5aae7c4: New, additive: the first built-in learning generator. `proposeLearningCandidate` reads a domain's observations and earlier cycles, asks a model you supply (`LearningModel`, one function returning text and token counts) for one revision of an instruction skill, and returns the candidate with its typed edits, or refuses it. Every edit must sit on the editable surface (`resolveLearningSurface`, today the instruction skill only) and the wording must stay clear of the safety floor; a problem goes back to the model once and a second failure is refused, naming the part and never the text. `LEARNING_FLOOR_COMPONENTS` lists what is never editable and `resolveLearningSurface` throws if a configuration names one. `learningExperienceFromCycle` turns a finished cycle into an experience entry (adopted and helped, rejected and hurt or no observed effect). The proposal does not judge itself: it goes through `runLearningCycle` for paired verification, protection, confirmation and exact-revision activation. Nothing existing changes. New exports: `proposeLearningCandidate`, `resolveLearningSurface`, `learningExperienceFromCycle`, `LEARNING_SURFACE_KINDS`, `LEARNING_FLOOR_COMPONENTS` and the related types.
+- 5aae7c4: The learning cycle now refuses to learn from, or produce, anything that carries evaluator-side material. `runLearningCycle` checks the active skill baseline, the failure evidence (before any stage or journal entry), exploration observations and the generated candidate against the built-in grader-verdict and answer-key wording and secret shapes, plus an optional `leakGuard` you supply (path globs, planted canaries from `createLearningCanary()`, extra markers, verbatim protection-task text, literal secrets). A hit ends the cycle with status `failed`, a reason that says it is a leak and not a false positive, and `result.leak` listing the kind, subject and rule; the matched text is never repeated and a refused candidate is not returned. New exports: `createLearningCanary`, `scanForLearningLeak`, `assertNoLearningLeak`, `LearningLeakError` and the types `LearningLeakGuard`, `LearningLeakFinding`, `LearningLeakKind`, `LearningLeakSubject`. What to check: evidence that legitimately mentions a verdict, an answer key or a secret-shaped string is now refused. Remove or redact it at the source; there is no switch to turn the built-in checks off. Canaries are also found inside larger base64 or base64url blobs at any alignment and in uppercase hex; the built-in secret shapes are found through zero-width characters. The CLI passes no `leakGuard`, so it applies only the built-in checks.
+- 5aae7c4: Learning moves out of the resident module into its own, because it is not specific to residents. Nothing breaks: every exported name that began with `Resident` (`runResidentLearningCycle`, `SqliteResidentLearningStore`, `runStoredResidentLearningCycle`, `runStoredResidentLearningFromObservations`, `hashResidentSkill`, `projectResidentLearning`, `ResidentSkillCandidate`, `ResidentLearningState`, and the rest) still works and is the same value or type as its new name (`runLearningCycle`, `SqliteLearningStore`, `runStoredLearningCycle`, `runStoredLearningFromObservations`, `hashLearningSkill`, `projectLearning`, `LearningSkillCandidate`, `LearningState`, ...). The old names are marked `@deprecated` and will be removed in the next major release; switch to the new names when convenient. Also new: `SqliteLearningStore.pruneObservations(shouldDrop)`, which removes unclaimed observations a host no longer wants to keep.
+- 5aae7c4: Learning by itself no longer counts a refused tool call as a failure: the answer to a call you declined, to a call that went with the turn your No ended, and to a call whose question went unanswered records nothing, because those are your choices, not a tool that broke. The background learning cycle also stays still while any question about a tool call waits on you, and goes on once it closes. The guidance a project learned now opens with "Namzu learned" instead of claiming you confirmed it, since the background cycle activates it without a prompt; a stored memory still wins where the two disagree. `@namzu/sdk` adds `isReviewRefusalResult(output)`, which says whether a tool result answers a call the review did not let run, so a host that counts failures can leave those out. Nothing to change on upgrade.
+- 5aae7c4: Residents are deprecated and will be removed in the next major release. Every resident export (`runResident`, `stepResident`, `ResidentHost`, `DiskResidentStore`, `DiskResidentAgenda`, `createResidentSelector`, `inspectResidentConsumption`, the outbox, history, tool-evidence and step-context helpers, and their types) is now marked `@deprecated` and behaves as before. Nothing is removed in this release. If you use them for long-running work, move to scheduled tasks (`LocalTaskScheduler`), session goals or background agents; learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda (`DiskResidentAgenda`) as its activation target and throws `ResidentConflictError` when it is paused, so a consumer of learning still needs the deprecated resident agenda store. Learning gets its own activation target before the residents are removed; that is the precondition for removing them in the next major release.
+
 ## 55.0.0
 
 ### Major Changes

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"}