@namzu/sdk 61.4.0 → 62.1.0

package/src/turn/reporter.ts

@@ -317,6 +317,11 @@ export function createTurnReporter(parentLogger?: Logger): TurnReporter {
 					'namzu.monitor.chars': event.text.length,
 				})
 				break
+			case 'memory_recalled':
+				log.debug('Stored memories recalled into the turn', {
+					'namzu.memory.count': event.memories.length,
+				})
+				break
 			case 'memory_consolidated':
 				log.info('Turn learnings consolidated into the memory store', {
 					'namzu.memory.id': event.memoryId,

package/src/types/acp/index.ts

@@ -118,6 +118,12 @@ export interface AcpRequestPermissionParams {
 		readonly isDestructive: boolean
 		/** For `edit` and `write` calls, when the agent could compute it. */
 		readonly preview?: AcpFileChangePreview
+		/**
+		 * True on a call the agent asks about every time, whatever the person
+		 * said before. An `approve_all` given to a request holding one approves
+		 * that request only. Absent on an ordinary call and from an older agent.
+		 */
+		readonly alwaysAsk?: true
 	}[]
 }
 

package/src/types/agent/base.ts

@@ -226,6 +226,10 @@ export interface BaseAgentConfig {
 	 */
 	thinking?: import('../provider/index.js').ThinkingConfig
 	effort?: import('../provider/index.js').ReasoningEffort
+	/** How the turn bounds its reasoning; see {@link import('../session/config.js').TurnConfig.reasoning}. */
+	reasoning?: import('../session/config.js').TurnConfig['reasoning']
+	/** Ask once for a check of edits before a turn ends; see {@link import('../session/config.js').TurnConfig.completionAudit}. */
+	completionAudit?: boolean
 
 	/**
 	 * Deduplicate a retried invocation instead of running it twice.

package/src/types/hitl/index.ts

@@ -70,6 +70,14 @@ export type HITLResumeDecision =
 			modifications: ToolModification[]
 			/** See the `approve_tools` field of the same name. */
 			confirmedEscalations?: readonly string[]
+			/**
+			 * Why a policy (not a person) denied a call, by call id. A `deny` modification
+			 * whose id is listed here carries this text to the model in place of the
+			 * generic "declined" answer and is not recorded as a person's No. It lets a
+			 * handler with nobody to ask refuse one call of a batch for its own reason
+			 * while the other calls in the batch run.
+			 */
+			policyRefusals?: Readonly<Record<string, string>>
 	  }
 	| {
 			action: 'reject_tools'

package/src/types/ids/index.ts

@@ -11,7 +11,7 @@ import type { Id } from './brand.js'
  * for values received from JSON, flags, URLs, or other untyped boundaries.
  */
 /**
- * One turn of a session: a user prompt (or a goal round, resident step or
+ * One turn of a session: a user prompt (or a goal round or a
  * verification step) and everything the agent did to answer it. Recorded in
  * the session log between `turn_started` and `turn_completed`/`turn_failed`.
  */

package/src/types/message/index.ts

@@ -365,6 +365,7 @@ export const RUNTIME_CONTEXT_MESSAGE_KINDS = [
 	'limit-finalization',
 	'peer-message',
 	'peer-notice',
+	'progress-nudge',
 	'reminder',
 	'repeat-call',
 	'refusal-retry',

package/src/types/provider/interface.ts

@@ -179,6 +179,19 @@ export interface LLMProvider {
 		thinking?: import('./chat.js').ThinkingConfig,
 	): readonly import('./chat.js').ReasoningEffort[] | undefined
 
+	/**
+	 * Whether `model` takes a forced tool choice (`toolChoice: 'required'` or a
+	 * named function) under the thinking configuration the request will carry.
+	 *
+	 * The kernel asks before it requires a tool call on a step it wants to act,
+	 * and when the answer is `false` it keeps the step at low effort and asks the
+	 * model in words instead of sending a choice the driver would refuse. Optional:
+	 * a provider that does not declare it is treated as taking the choice, so
+	 * every existing driver behaves as before. A wrapper that rebuilds a provider
+	 * forwards it.
+	 */
+	acceptsForcedToolChoiceFor?(model: string, thinking?: import('./chat.js').ThinkingConfig): boolean
+
 	/**
 	 * The effort a model uses when a request omits an explicit level.
 	 *

package/src/types/session/config.ts

@@ -68,6 +68,33 @@ export interface TurnConfig {
 	 * high-effort and silently was not is worse than a startup error.
 	 */
 	effort?: import('../provider/index.js').ReasoningEffort
+
+	/**
+	 * How the turn bounds its reasoning. On by default.
+	 *
+	 * Two guards live here. A step that streams more than `maxTokens` of
+	 * reasoning before it has made a call is cut short, and the model is told
+	 * to act; when the cap is absent it is 24,000 tokens at medium effort and
+	 * above and not applied below that, and `0` removes it. The stall monitor
+	 * counts steps that changed nothing (the task list does not count), nudges
+	 * the model after a run of them and then makes the next step an action step;
+	 * `stall: false` turns it off.
+	 */
+	reasoning?: import('../../runtime/query/turn/stall-monitor.js').ReasoningPaceConfig
+
+	/**
+	 * Ask once, before a turn that changed files ends, for a check of the change.
+	 *
+	 * The audit reads the turn's own record: a successful `edit`, `write`,
+	 * `apply_patch` or `notebook_edit` call is a change, and a successful shell
+	 * call after the last change that runs a test, lint, format-check, typecheck
+	 * or build target is a check. When the model tries to end the turn with a
+	 * change and no check after it, one reminder is added and the loop goes on.
+	 * That is the only block a turn gets, so the audit cannot trap a run.
+	 *
+	 * Off when absent, so an embedding host sees no change.
+	 */
+	completionAudit?: boolean
 	/** Provider-hosted search for this turn. Explicit opt-in; no local network permission. */
 	webSearch?: import('../provider/index.js').ChatCompletionParams['webSearch']
 	/** Cumulative parent-and-descendant tokens; 0 is unlimited with usage accounting. */

package/src/types/session/events.ts

@@ -736,6 +736,25 @@ type CoreSessionEvent =
 			kind: 'output' | 'notice'
 			text: string
 	  }
+	/**
+	 * A recall step put stored memories into the conversation for this turn:
+	 * the ones newly added on that step, never ones the history already
+	 * carried. Emitted after the entry was recorded, so a host can show which
+	 * memories went with a message and let the person delete them.
+	 */
+	| {
+			type: 'memory_recalled'
+			sessionId: SessionId
+			turnId?: TurnId
+			memories: Array<{
+				id: string
+				name?: string
+				type?: string
+				title: string
+				origin: 'operator' | 'model' | 'derived'
+				updatedAt: number
+			}>
+	  }
 	/**
 	 * What the turn learned was written to the host's memory store: its
 	 * decisions, discoveries and failures as one entry a later session can

package/src/types/session/prepare-step.ts

@@ -255,6 +255,23 @@ export interface RecordedContextItem {
 	/** Lowercase words joined by hyphens (for example `repository`). */
 	readonly key: string
 	readonly text: string
+	/**
+	 * The stored memories the text carries, when it is recalled memory. Once
+	 * the entry is recorded the loop reports them with a `memory_recalled`
+	 * event; an item that adds nothing reports nothing.
+	 */
+	readonly recalledMemories?: readonly RecalledMemory[]
+}
+
+/** One stored memory a recall step put into the conversation. */
+export interface RecalledMemory {
+	readonly id: string
+	readonly name?: string
+	readonly type?: string
+	readonly title: string
+	/** Who wrote it: the operator, the model (`save_memory`), or a turn on its own. */
+	readonly origin: 'operator' | 'model' | 'derived'
+	readonly updatedAt: number
 }
 
 /**

package/src/types/session/records.ts

@@ -141,6 +141,8 @@ export interface RecordEnvelope {
 
 export const OriginSchema = z
 	.object({
+		// 'resident' and 'resident-step' are no longer written; they stay so logs
+		// recorded while the resident feature existed still parse.
 		protocol: z.enum(['cli', 'sdk', 'ag-ui', 'a2a', 'acp', 'http', 'desktop', 'resident']),
 		externalSessionId: text.optional(),
 		externalTurnId: text.optional(),
@@ -671,6 +673,7 @@ const SESSION_EVENT_TYPE_TABLE: Record<SessionEventType, true> = {
 	background_job_exited: true,
 	monitor_event: true,
 	memory_consolidated: true,
+	memory_recalled: true,
 	turn_completed: true,
 	turn_failed: true,
 	capability_warning: true,

package/src/types/session/turn.ts

@@ -92,9 +92,10 @@ export type OriginProtocol =
 	| 'acp'
 	| 'http'
 	| 'desktop'
+	// Kept so logs written while the resident feature existed still parse.
 	| 'resident'
 
-/** What kind of work a turn is. A prompt, a goal round, a resident step and a verification step are each a new turn. */
+/** What kind of work a turn is. A prompt, a goal round and a verification step are each a new turn. 'resident-step' is no longer written; it stays in the union so older logs still parse. */
 export type TurnOriginKind = 'prompt' | 'goal-round' | 'resident-step' | 'verification'
 
 export interface Origin {

package/dist/learning/deprecated.d.ts

@@ -1,86 +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 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

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

package/dist/learning/deprecated.js

@@ -1,22 +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 { 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

@@ -1 +0,0 @@
-{"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/manager/resident/activity.d.ts

@@ -1,74 +0,0 @@
-import type { ResidentAgendaState } from './agenda.js';
-import { 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 declare function createResidentActivitySource(scopeInput: ResidentActivityScope, load: (revision: number, budget: ResidentHistoryReadBudget) => Promise<ResidentAgendaState>): ResidentActivitySource;
-//# sourceMappingURL=activity.d.ts.map

package/dist/manager/resident/activity.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../../src/manager/resident/activity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,EAA4B,KAAK,yBAAyB,EAAE,MAAM,mBAAmB,CAAA;AAE5F;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAA;CACjD;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAA;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAA;IAChD,QAAQ,CAAC,UAAU,EAAE,SAAS,iBAAiB,EAAE,CAAA;IACjD,QAAQ,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAA;IACnD,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAA;CAC5C;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAA;IACrC,IAAI,CAAC,OAAO,CAAC,EAAE,uBAAuB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAA;CAC5F;AAED,sDAAsD;AACtD,wBAAgB,4BAA4B,CAC3C,UAAU,EAAE,qBAAqB,EACjC,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,yBAAyB,KAAK,OAAO,CAAC,mBAAmB,CAAC,GACzF,sBAAsB,CA+HxB"}

package/dist/manager/resident/activity.js

@@ -1,125 +0,0 @@
-import { z } from 'zod';
-import { ResidentHistoryPageLimit } from './history-disk.js';
-/** Internal adapter for the immutable disk agenda. */
-export function createResidentActivitySource(scopeInput, load) {
-    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 = {}, signal) {
-            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 = {
-                remaining: z
-                    .number()
-                    .int()
-                    .positive()
-                    .max(8 * 1024 * 1024)
-                    .parse(options.maxReadBytes ?? 8 * 1024 * 1024),
-                bytesRead: 0,
-                signal,
-            };
-            const unavailable = new Set();
-            const read = async (revision) => {
-                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 = [];
-            const settlements = [];
-            const archivedPursuits = [];
-            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,
-            };
-        },
-    };
-}
-//# sourceMappingURL=activity.js.map

package/dist/manager/resident/activity.js.map

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