@namzu/sdk 61.4.0 → 62.0.0

package/src/learning/deprecated.ts

@@ -1,124 +0,0 @@
-/**
- * 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 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
-/** @deprecated Renamed to `SqliteLearningStore`; the old name is removed in the next major release. */
-export type SqliteResidentLearningStore = SqliteLearningStore

package/src/manager/resident/activity.ts

@@ -1,211 +0,0 @@
-import { z } from 'zod'
-import type { ResidentAgendaState } from './agenda.js'
-import { ResidentHistoryPageLimit, type ResidentHistoryReadBudget } from './history-disk.js'
-
-/**
- * @experimental An immutable upper boundary; new work requires a new source.
- *
- * @deprecated Residents are deprecated and removed in the next major release. Learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda until learning gets its own activation target in the next major release; for long-running work use scheduled tasks (`LocalTaskScheduler`), session goals and background agents.
- */
-export interface ResidentActivityScope {
-	readonly tenantId: string
-	readonly agentKey: string
-	readonly throughRevision: number
-}
-
-/**
- * @experimental Admission is authority to inspect an attempt, not proof that it executed.
- *
- * @deprecated Residents are deprecated and removed in the next major release. Learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda until learning gets its own activation target in the next major release; for long-running work use scheduled tasks (`LocalTaskScheduler`), session goals and background agents.
- */
-export interface ResidentAdmission {
-	readonly revision: number
-	readonly pursuitRevision: number
-	readonly pursuitId: string
-	readonly claimId: string
-	readonly step: number
-	readonly objective: string
-}
-
-/**
- * @experimental Settlement is an agenda decision, not proof of verification or delivery.
- *
- * @deprecated Residents are deprecated and removed in the next major release. Learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda until learning gets its own activation target in the next major release; for long-running work use scheduled tasks (`LocalTaskScheduler`), session goals and background agents.
- */
-export interface ResidentSettlement {
-	readonly revision: number
-	readonly pursuitId: string
-	readonly claimId: string
-	readonly outcome: 'wait' | 'complete' | 'blocked'
-}
-
-/**
- * @experimental Forward pages; cursor is the next revision to inspect, initially 1.
- *
- * @deprecated Residents are deprecated and removed in the next major release. Learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda until learning gets its own activation target in the next major release; for long-running work use scheduled tasks (`LocalTaskScheduler`), session goals and background agents.
- */
-export interface ResidentActivityOptions {
-	readonly cursor?: number
-	readonly maxRevisions?: number
-	readonly maxReadBytes?: number
-}
-
-/**
- * @experimental Gaps stay explicit; counts cover only the scanned revision range.
- *
- * @deprecated Residents are deprecated and removed in the next major release. Learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda until learning gets its own activation target in the next major release; for long-running work use scheduled tasks (`LocalTaskScheduler`), session goals and background agents.
- */
-export interface ResidentActivityPage {
-	readonly scope: ResidentActivityScope
-	readonly fromRevision: number
-	readonly throughRevision: number
-	readonly nextCursor: number | null
-	readonly scannedBytes: number
-	readonly unavailableRevisions: readonly number[]
-	readonly admissions: readonly ResidentAdmission[]
-	readonly settlements: readonly ResidentSettlement[]
-	readonly archivedPursuits: readonly string[]
-}
-
-/**
- * @experimental A backend must enforce scope, cancellation and read bounds.
- *
- * @deprecated Residents are deprecated and removed in the next major release. Learning (`runLearningCycle` and the other `Learning*` names) keeps working, but `runLearningCycle` still takes a resident agenda until learning gets its own activation target in the next major release; for long-running work use scheduled tasks (`LocalTaskScheduler`), session goals and background agents.
- */
-export interface ResidentActivitySource {
-	readonly scope: ResidentActivityScope
-	read(options?: ResidentActivityOptions, signal?: AbortSignal): Promise<ResidentActivityPage>
-}
-
-/** Internal adapter for the immutable disk agenda. */
-export function createResidentActivitySource(
-	scopeInput: ResidentActivityScope,
-	load: (revision: number, budget: ResidentHistoryReadBudget) => Promise<ResidentAgendaState>,
-): ResidentActivitySource {
-	const scope = Object.freeze(
-		z
-			.object({
-				tenantId: z.string().uuid(),
-				agentKey: z.string().min(1).max(200),
-				throughRevision: z.number().int().positive().safe(),
-			})
-			.parse(scopeInput),
-	)
-	return {
-		scope,
-		async read(options: ResidentActivityOptions = {}, signal?: AbortSignal) {
-			const from = z
-				.number()
-				.int()
-				.positive()
-				.max(scope.throughRevision)
-				.parse(options.cursor ?? 1)
-			const count = z
-				.number()
-				.int()
-				.positive()
-				.max(32)
-				.parse(options.maxRevisions ?? 32)
-			const budget: ResidentHistoryReadBudget = {
-				remaining: z
-					.number()
-					.int()
-					.positive()
-					.max(8 * 1024 * 1024)
-					.parse(options.maxReadBytes ?? 8 * 1024 * 1024),
-				bytesRead: 0,
-				signal,
-			}
-			const unavailable = new Set<number>()
-			const read = async (revision: number) => {
-				signal?.throwIfAborted()
-				try {
-					const state = await load(revision, budget)
-					if (
-						state.tenantId !== scope.tenantId ||
-						state.agentKey !== scope.agentKey ||
-						state.revision !== revision
-					)
-						throw new Error('Resident activity scope mismatch.')
-					return state
-				} catch (error) {
-					signal?.throwIfAborted()
-					if (error instanceof ResidentHistoryPageLimit) throw error
-					unavailable.add(revision)
-					return null
-				}
-			}
-			const admissions: ResidentAdmission[] = []
-			const settlements: ResidentSettlement[] = []
-			const archivedPursuits: string[] = []
-			let through = from - 1
-			try {
-				let before = from > 1 ? await read(from - 1) : null
-				for (
-					let revision = from;
-					revision <= Math.min(scope.throughRevision, from + count - 1);
-					revision++
-				) {
-					const after = await read(revision)
-					if (before && after) {
-						for (const pursuit of after.pursuits) {
-							const previous = before.pursuits.find((p) => p.id === pursuit.id)?.state
-							const current = pursuit.state
-							if (!previous) continue
-							if (
-								current.revision === previous.revision + 1 &&
-								previous.phase !== 'running' &&
-								current.phase === 'running' &&
-								current.claimId &&
-								current.stepsAdmitted === previous.stepsAdmitted + 1
-							) {
-								admissions.push({
-									revision,
-									pursuitRevision: current.revision,
-									pursuitId: pursuit.id,
-									claimId: current.claimId,
-									step: current.stepsAdmitted,
-									objective: current.objective,
-								})
-							}
-							if (
-								current.revision === previous.revision + 1 &&
-								previous.phase === 'running' &&
-								previous.claimId &&
-								current.phase !== 'running' &&
-								current.claimId === null &&
-								current.stepsAdmitted === previous.stepsAdmitted
-							) {
-								settlements.push({
-									revision,
-									pursuitId: pursuit.id,
-									claimId: previous.claimId,
-									outcome: current.phase === 'waiting' ? 'wait' : current.phase,
-								})
-							}
-						}
-						if (after.archiveHead === revision)
-							for (const pursuit of before.pursuits)
-								if (!after.pursuits.some((p) => p.id === pursuit.id))
-									archivedPursuits.push(pursuit.id)
-					}
-					through = revision
-					before = after
-				}
-			} catch (error) {
-				if (!(error instanceof ResidentHistoryPageLimit)) throw error
-			}
-			return {
-				scope,
-				fromRevision: from,
-				throughRevision: through,
-				nextCursor: through < scope.throughRevision ? through + 1 : null,
-				scannedBytes: budget.bytesRead,
-				unavailableRevisions: [...unavailable],
-				admissions,
-				settlements,
-				archivedPursuits,
-			}
-		},
-	}
-}