@strands-agents/sdk 0.3.0 → 0.5.0

package/dist/src/agent/printer.js.map

@@ -1 +1 @@
-{"version":3,"file":"printer.js","sourceRoot":"","sources":["../../../src/agent/printer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"printer.js","sourceRoot":"","sources":["../../../src/agent/printer.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,MAAM,UAAU,kBAAkB;IAChC,oDAAoD;IACpD,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;QAC5D,OAAO,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACrD,CAAC;IACD,mDAAmD;IACnD,OAAO,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;AAC5C,CAAC;AAoBD;;;GAGG;AACH,MAAM,OAAO,YAAY;IACN,SAAS,CAAwB;IAC1C,iBAAiB,GAAY,KAAK,CAAA;IAClC,UAAU,GAAW,CAAC,CAAA;IACtB,oBAAoB,GAAY,KAAK,CAAA;IAE7C;;;OAGG;IACH,YAAY,QAAgC;QAC1C,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAA;IAC3B,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,OAAe;QAC1B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;IACzB,CAAC;IAED;;;;OAIG;IACI,YAAY,CAAC,KAAuB;QACzC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,wBAAwB;gBAC3B,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;gBACxC,MAAK;YAEP,KAAK,iBAAiB;gBACpB,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAA;gBAC5B,MAAK;YAEP,2BAA2B;YAC3B;gBACE,MAAK;QACT,CAAC;IACH,CAAC;IAED;;OAEG;IACK,sBAAsB,CAAC,KAAuB;QACpD,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,6BAA6B;gBAChC,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAA;gBACnC,MAAK;YACP,KAAK,6BAA6B;gBAChC,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAA;gBACnC,MAAK;YACP,KAAK,4BAA4B;gBAC/B,IAAI,CAAC,sBAAsB,EAAE,CAAA;gBAC7B,MAAK;YACP;gBACE,MAAK;QACT,CAAC;IACH,CAAC;IAED;;OAEG;IACK,uBAAuB,CAAC,KAAsC;QACpE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAA;QAEvB,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC/B,0BAA0B;YAC1B,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YACxB,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,uBAAuB,EAAE,CAAC;YAClD,8CAA8C;YAC9C,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBAC5B,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAA;gBAC7B,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAA;gBAChC,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAA;YACjC,CAAC;YAED,gDAAgD;YAChD,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxC,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YACrC,CAAC;QACH,CAAC;QACD,iDAAiD;IACnD,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,IAAY;QACrC,IAAI,MAAM,GAAG,EAAE,CAAA;QAEf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;YAEpB,wDAAwD;YACxD,IAAI,IAAI,CAAC,oBAAoB,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAC/C,MAAM,IAAI,KAAK,CAAA;gBACf,IAAI,CAAC,oBAAoB,GAAG,KAAK,CAAA;YACnC,CAAC;YAED,MAAM,IAAI,IAAI,CAAA;YAEd,gDAAgD;YAChD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAClB,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAA;YAClC,CAAC;QACH,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACpB,CAAC;IAED;;;OAGG;IACK,uBAAuB,CAAC,KAAsC;QACpE,IAAI,KAAK,CAAC,KAAK,EAAE,IAAI,KAAK,cAAc,EAAE,CAAC;YACzC,0BAA0B;YAC1B,IAAI,CAAC,UAAU,EAAE,CAAA;YACjB,IAAI,CAAC,KAAK,CAAC,cAAc,IAAI,CAAC,UAAU,KAAK,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAA;QACpE,CAAC;QACD,sFAAsF;IACxF,CAAC;IAED;;;OAGG;IACK,sBAAsB;QAC5B,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3B,iEAAiE;YACjE,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC;gBAC/B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YAClB,CAAC;YACD,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAA;YAC9B,IAAI,CAAC,oBAAoB,GAAG,KAAK,CAAA;QACnC,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,gBAAgB,CAAC,KAAsB;QAC7C,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACtC,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAA;QAClC,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YAC3C,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAA;QAC/B,CAAC;IACH,CAAC;CACF"}

package/dist/src/agent/snapshot.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Snapshot API for capturing and restoring agent state.
+ *
+ * This module provides types and utilities for point-in-time capture and restoration
+ * of agent state, enabling use cases like checkpointing, undo/redo, and branching
+ * conversation flows.
+ *
+ * NOTE: The takeSnapshot and loadSnapshot functions are currently internal implementation
+ * details. We anticipate opening these up as public Agent methods in a future release
+ * after API review, but for now they are top-level functions to unblock snapshot
+ * functionality without committing to a public API surface.
+ */
+import type { JSONValue } from '../types/json.js';
+import type { Agent } from './agent.js';
+/**
+ * Current schema version of the snapshot format.
+ */
+export declare const SNAPSHOT_SCHEMA_VERSION = "1.0";
+/**
+ * All available fields that can be included in a snapshot.
+ */
+export declare const ALL_SNAPSHOT_FIELDS: readonly ["messages", "state", "systemPrompt"];
+/**
+ * Strongly typed preset definitions for snapshot field selection.
+ * This object allows easy evolution of presets and type-safe access.
+ */
+export declare const SNAPSHOT_PRESETS: {
+    readonly session: readonly ["messages", "state", "systemPrompt"];
+};
+/**
+ * Preset name for snapshot field selection.
+ */
+export type SnapshotPreset = keyof typeof SNAPSHOT_PRESETS;
+/**
+ * Valid snapshot field names.
+ */
+export type SnapshotField = (typeof ALL_SNAPSHOT_FIELDS)[number];
+/**
+ * Scope defines the context for snapshot data.
+ */
+export type Scope = 'agent' | 'multiAgent';
+/**
+ * Point-in-time capture of agent state.
+ */
+export interface Snapshot {
+    /**
+     * Scope identifying the snapshot context (agent or multi-agent).
+     */
+    scope: Scope;
+    /**
+     * Schema version string for forward compatibility.
+     */
+    schemaVersion: string;
+    /**
+     * ISO 8601 timestamp of when snapshot was created.
+     */
+    createdAt: string;
+    /**
+     * Agent's evolving state (messages, state, systemPrompt). Strands-owned.
+     */
+    data: Record<string, JSONValue>;
+    /**
+     * Application-owned data. Strands does not read or modify this.
+     */
+    appData: Record<string, JSONValue>;
+}
+/**
+ * Creates an ISO 8601 timestamp string.
+ *
+ * @returns Current timestamp in ISO 8601 format
+ */
+export declare function createTimestamp(): string;
+/**
+ * Options for taking a snapshot of agent state.
+ */
+export type TakeSnapshotOptions = {
+    /**
+     * Preset to use as the starting set of fields.
+     * If not specified, starts with an empty set (unless include is specified).
+     */
+    preset?: SnapshotPreset;
+    /**
+     * Fields to add to the snapshot.
+     * These are added to the preset fields (if any).
+     */
+    include?: SnapshotField[];
+    /**
+     * Fields to exclude from the snapshot.
+     * Applied after preset and include to filter out specific fields.
+     */
+    exclude?: SnapshotField[];
+    /**
+     * Application-owned data to store in the snapshot.
+     * Strands does not read or modify this data.
+     */
+    appData?: Record<string, JSONValue>;
+};
+/**
+ * Takes a snapshot of the agent's current state.
+ *
+ * NOTE: This is currently an internal implementation detail. We anticipate
+ * exposing this as a public Agent method in a future release after API review.
+ *
+ * @param agent - The agent to snapshot
+ * @param options - Snapshot options
+ * @returns A snapshot of the agent's state
+ */
+export declare function takeSnapshot(agent: Agent, options: TakeSnapshotOptions): Snapshot;
+/**
+ * Loads a snapshot into the agent, restoring its state.
+ *
+ * NOTE: This is currently an internal implementation detail. We anticipate
+ * exposing this as a public Agent method in a future release after API review.
+ *
+ * @param agent - The agent to restore state into
+ * @param snapshot - The snapshot to load
+ */
+export declare function loadSnapshot(agent: Agent, snapshot: Snapshot): void;
+/**
+ * Resolves snapshot fields based on preset/include/exclude parameters.
+ *
+ * Order of operations:
+ * 1. Start with preset fields (if specified)
+ * 2. Add include fields
+ * 3. Remove exclude fields
+ *
+ * @param options - Snapshot options containing preset, include, and exclude fields
+ * @returns Set of resolved field names
+ * @throws Error if no fields would be included
+ */
+export declare function resolveSnapshotFields(options?: TakeSnapshotOptions): Set<SnapshotField>;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/src/agent/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../src/agent/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAGjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAEvC;;GAEG;AACH,eAAO,MAAM,uBAAuB,QAAQ,CAAA;AAE5C;;GAEG;AACH,eAAO,MAAM,mBAAmB,gDAAiD,CAAA;AAEjF;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;CAEnB,CAAA;AAEV;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,gBAAgB,CAAA;AAE1D;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEhE;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,YAAY,CAAA;AAE1C;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,KAAK,EAAE,KAAK,CAAA;IAEZ;;OAEG;IACH,aAAa,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IAEjB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAE/B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;CACnC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC;;;OAGG;IACH,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,aAAa,EAAE,CAAA;IACzB;;;OAGG;IACH,OAAO,CAAC,EAAE,aAAa,EAAE,CAAA;IACzB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;CACpC,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,GAAG,QAAQ,CAwBjF;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAwBnE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,mBAAwB,GAAG,GAAG,CAAC,aAAa,CAAC,CAoC3F"}

package/dist/src/agent/snapshot.js

@@ -0,0 +1,151 @@
+/**
+ * Snapshot API for capturing and restoring agent state.
+ *
+ * This module provides types and utilities for point-in-time capture and restoration
+ * of agent state, enabling use cases like checkpointing, undo/redo, and branching
+ * conversation flows.
+ *
+ * NOTE: The takeSnapshot and loadSnapshot functions are currently internal implementation
+ * details. We anticipate opening these up as public Agent methods in a future release
+ * after API review, but for now they are top-level functions to unblock snapshot
+ * functionality without committing to a public API surface.
+ */
+import { Message, systemPromptFromData, systemPromptToData } from '../types/messages.js';
+/**
+ * Current schema version of the snapshot format.
+ */
+export const SNAPSHOT_SCHEMA_VERSION = '1.0';
+/**
+ * All available fields that can be included in a snapshot.
+ */
+export const ALL_SNAPSHOT_FIELDS = ['messages', 'state', 'systemPrompt'];
+/**
+ * Strongly typed preset definitions for snapshot field selection.
+ * This object allows easy evolution of presets and type-safe access.
+ */
+export const SNAPSHOT_PRESETS = {
+    session: ['messages', 'state', 'systemPrompt'],
+};
+/**
+ * Creates an ISO 8601 timestamp string.
+ *
+ * @returns Current timestamp in ISO 8601 format
+ */
+export function createTimestamp() {
+    return new Date().toISOString();
+}
+/**
+ * Takes a snapshot of the agent's current state.
+ *
+ * NOTE: This is currently an internal implementation detail. We anticipate
+ * exposing this as a public Agent method in a future release after API review.
+ *
+ * @param agent - The agent to snapshot
+ * @param options - Snapshot options
+ * @returns A snapshot of the agent's state
+ */
+export function takeSnapshot(agent, options) {
+    const fields = resolveSnapshotFields(options);
+    const data = {};
+    if (fields.has('messages')) {
+        data.messages = agent.messages.map((msg) => msg.toJSON());
+    }
+    if (fields.has('state')) {
+        data.state = agent.state.toJSON();
+    }
+    if (fields.has('systemPrompt')) {
+        data.systemPrompt = agent.systemPrompt !== undefined ? systemPromptToData(agent.systemPrompt) : null;
+    }
+    return {
+        scope: 'agent',
+        schemaVersion: SNAPSHOT_SCHEMA_VERSION,
+        createdAt: createTimestamp(),
+        data,
+        appData: options.appData ?? {},
+    };
+}
+/**
+ * Loads a snapshot into the agent, restoring its state.
+ *
+ * NOTE: This is currently an internal implementation detail. We anticipate
+ * exposing this as a public Agent method in a future release after API review.
+ *
+ * @param agent - The agent to restore state into
+ * @param snapshot - The snapshot to load
+ */
+export function loadSnapshot(agent, snapshot) {
+    if (snapshot.schemaVersion !== SNAPSHOT_SCHEMA_VERSION) {
+        throw new Error(`Unsupported snapshot schema version: ${snapshot.schemaVersion}. Current version: ${SNAPSHOT_SCHEMA_VERSION}`);
+    }
+    const { messages, state, systemPrompt } = snapshot.data;
+    if (messages !== undefined) {
+        agent.messages.length = 0;
+        for (const msgData of messages) {
+            agent.messages.push(Message.fromJSON(msgData));
+        }
+    }
+    if (state !== undefined) {
+        agent.state.loadStateFromJson(state);
+    }
+    // Only restore systemPrompt if explicitly present and non-null in the snapshot
+    if (systemPrompt !== undefined && systemPrompt !== null) {
+        agent.systemPrompt = systemPromptFromData(systemPrompt);
+    }
+}
+/**
+ * Resolves snapshot fields based on preset/include/exclude parameters.
+ *
+ * Order of operations:
+ * 1. Start with preset fields (if specified)
+ * 2. Add include fields
+ * 3. Remove exclude fields
+ *
+ * @param options - Snapshot options containing preset, include, and exclude fields
+ * @returns Set of resolved field names
+ * @throws Error if no fields would be included
+ */
+export function resolveSnapshotFields(options = {}) {
+    const { preset, include, exclude } = options;
+    let fields;
+    // Start with preset fields or empty set
+    if (preset !== undefined) {
+        if (!(preset in SNAPSHOT_PRESETS)) {
+            throw new Error(`Invalid preset: ${preset}. Valid presets are: ${Object.keys(SNAPSHOT_PRESETS).join(', ')}`);
+        }
+        fields = new Set(SNAPSHOT_PRESETS[preset]);
+    }
+    else {
+        fields = new Set();
+    }
+    // Add include fields
+    if (include !== undefined) {
+        validateSnapshotFields(include);
+        for (const field of include) {
+            fields.add(field);
+        }
+    }
+    // Remove exclude fields (no error if field wasn't included)
+    if (exclude !== undefined) {
+        validateSnapshotFields(exclude);
+        for (const field of exclude) {
+            fields.delete(field);
+        }
+    }
+    // Must have at least one field
+    if (fields.size === 0) {
+        throw new Error('No fields to include in snapshot. Specify a preset or include fields.');
+    }
+    return fields;
+}
+/**
+ * Validates that all field names are valid snapshot fields.
+ */
+function validateSnapshotFields(fields) {
+    const validFields = new Set(ALL_SNAPSHOT_FIELDS);
+    for (const field of fields) {
+        if (!validFields.has(field)) {
+            throw new Error(`Invalid snapshot field: ${field}. Valid fields are: ${ALL_SNAPSHOT_FIELDS.join(', ')}`);
+        }
+    }
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/src/agent/snapshot.js.map

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

package/dist/src/{agent/state.d.ts → app-state.d.ts}

@@ -1,6 +1,7 @@
-import { type JSONValue } from '../types/json.js';
+import { type JSONValue } from './types/json.js';
+import type { StateSerializable } from './types/serializable.js';
 /**
- * Agent state provides key-value storage outside conversation context.
+ * App state provides key-value storage outside conversation context.
  * State is not passed to the model during inference but is accessible
  * by tools (via ToolContext) and application logic.
  *
@@ -9,15 +10,15 @@ import { type JSONValue } from '../types/json.js';
  *
  * @example
  * ```typescript
- * const state = new AgentState({ userId: 'user-123' })
+ * const state = new AppState({ userId: 'user-123' })
  * state.set('sessionId', 'session-456')
  * const userId = state.get('userId') // 'user-123'
  * ```
  */
-export declare class AgentState {
+export declare class AppState implements StateSerializable {
     private _state;
     /**
-     * Creates a new AgentState instance.
+     * Creates a new AppState instance.
      *
      * @param initialState - Optional initial state values
      * @throws Error if initialState is not JSON serializable
@@ -98,5 +99,17 @@ export declare class AgentState {
      * @returns Array of state keys
      */
     keys(): string[];
+    /**
+     * Returns the serialized state as JSON value.
+     *
+     * @returns Deep copy of all state
+     */
+    toJSON(): JSONValue;
+    /**
+     * Loads state from a previously serialized JSON value.
+     *
+     * @param json - The serialized state to load
+     */
+    loadStateFromJson(json: JSONValue): void;
 }
-//# sourceMappingURL=state.d.ts.map
+//# sourceMappingURL=app-state.d.ts.map

package/dist/src/app-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-state.d.ts","sourceRoot":"","sources":["../../src/app-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAClF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAEhE;;;;;;;;;;;;;;GAcG;AACH,qBAAa,QAAS,YAAW,iBAAiB;IAChD,OAAO,CAAC,MAAM,CAA2B;IAEzC;;;;;OAKG;gBACS,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC;IAQpD;;;;;;;;;;;;;;;;;OAiBG;IACH,GAAG,CAAC,MAAM,EAAE,CAAC,SAAS,MAAM,MAAM,GAAG,MAAM,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS;IACjF,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAevC;;;;;;;;;;;;;;;;;;OAkBG;IACH,GAAG,CAAC,MAAM,EAAE,CAAC,SAAS,MAAM,MAAM,GAAG,MAAM,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI;IAClF,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAKtC;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,MAAM,EAAE,CAAC,SAAS,MAAM,MAAM,GAAG,MAAM,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,IAAI;IACnE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKzB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;OAIG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC;IAInC;;;;OAIG;IACH,IAAI,IAAI,MAAM,EAAE;IAIhB;;;;OAIG;IACH,MAAM,IAAI,SAAS;IAInB;;;;OAIG;IACH,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;CAOzC"}

package/dist/src/{agent/state.js → app-state.js}

@@ -1,6 +1,6 @@
-import { deepCopy, deepCopyWithValidation } from '../types/json.js';
+import { deepCopy, deepCopyWithValidation } from './types/json.js';
 /**
- * Agent state provides key-value storage outside conversation context.
+ * App state provides key-value storage outside conversation context.
  * State is not passed to the model during inference but is accessible
  * by tools (via ToolContext) and application logic.
  *
@@ -9,15 +9,15 @@ import { deepCopy, deepCopyWithValidation } from '../types/json.js';
  *
  * @example
  * ```typescript
- * const state = new AgentState({ userId: 'user-123' })
+ * const state = new AppState({ userId: 'user-123' })
  * state.set('sessionId', 'session-456')
  * const userId = state.get('userId') // 'user-123'
  * ```
  */
-export class AgentState {
+export class AppState {
     _state;
     /**
-     * Creates a new AgentState instance.
+     * Creates a new AppState instance.
      *
      * @param initialState - Optional initial state values
      * @throws Error if initialState is not JSON serializable
@@ -69,5 +69,26 @@ export class AgentState {
     keys() {
         return Object.keys(this._state);
     }
+    /**
+     * Returns the serialized state as JSON value.
+     *
+     * @returns Deep copy of all state
+     */
+    toJSON() {
+        return deepCopy(this._state);
+    }
+    /**
+     * Loads state from a previously serialized JSON value.
+     *
+     * @param json - The serialized state to load
+     */
+    loadStateFromJson(json) {
+        if (json !== null && typeof json === 'object' && !Array.isArray(json)) {
+            this._state = deepCopy(json);
+        }
+        else {
+            this._state = {};
+        }
+    }
 }
-//# sourceMappingURL=state.js.map
+//# sourceMappingURL=app-state.js.map

package/dist/src/app-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-state.js","sourceRoot":"","sources":["../../src/app-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,sBAAsB,EAAkB,MAAM,iBAAiB,CAAA;AAGlF;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,QAAQ;IACX,MAAM,CAA2B;IAEzC;;;;;OAKG;IACH,YAAY,YAAwC;QAClD,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,IAAI,CAAC,MAAM,GAAG,sBAAsB,CAAC,YAAY,EAAE,cAAc,CAA8B,CAAA;QACjG,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,GAAG,EAAE,CAAA;QAClB,CAAC;IACH,CAAC;IAsBD,GAAG,CAAC,GAAW;QACb,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAA;QACpC,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAC9B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,SAAS,CAAA;QAClB,CAAC;QAED,wCAAwC;QACxC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAA;IACxB,CAAC;IAuBD,GAAG,CAAC,GAAW,EAAE,KAAc;QAC7B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,GAAG,CAAC,CAAA;IAC5E,CAAC;IAoBD,MAAM,CAAC,GAAW;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACzB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,EAAE,CAAA;IAClB,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAA8B,CAAA;IAC3D,CAAC;IAED;;;;OAIG;IACH,IAAI;QACF,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACjC,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAc,CAAA;IAC3C,CAAC;IAED;;;;OAIG;IACH,iBAAiB,CAAC,IAAe;QAC/B,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACtE,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,IAAI,CAA8B,CAAA;QAC3D,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,GAAG,EAAE,CAAA;QAClB,CAAC;IACH,CAAC;CACF"}

package/dist/src/conversation-manager/sliding-window-conversation-manager.d.ts

@@ -55,7 +55,7 @@ export declare class SlidingWindowConversationManager implements HookProvider {
     /**
      * Apply the sliding window to the messages array to maintain a manageable history size.
      *
-     * This method is called after every event loop cycle to apply a sliding window if the message
+     * This method is called after every agent loop cycle to apply a sliding window if the message
      * count exceeds the window size. If the number of messages is within the window size, no action
      * is taken.
      *

package/dist/src/conversation-manager/sliding-window-conversation-manager.js

@@ -56,7 +56,7 @@ export class SlidingWindowConversationManager {
     /**
      * Apply the sliding window to the messages array to maintain a manageable history size.
      *
-     * This method is called after every event loop cycle to apply a sliding window if the message
+     * This method is called after every agent loop cycle to apply a sliding window if the message
      * count exceeds the window size. If the number of messages is within the window size, no action
      * is taken.
      *

package/dist/src/errors.d.ts

@@ -115,4 +115,19 @@ export declare class ModelThrottledError extends ModelError {
  * @returns An Error instance
  */
 export declare function normalizeError(error: unknown): Error;
+/**
+ * Error thrown when session operations fail.
+ *
+ * This error indicates failures in session storage operations such as
+ * reading, writing, or managing session data.
+ */
+export declare class SessionError extends Error {
+    /**
+     * Creates a new SessionError.
+     *
+     * @param message - Error message describing the session error
+     * @param options - Optional error options including cause for error chaining
+     */
+    constructor(message: string, options?: ErrorOptions);
+}
 //# sourceMappingURL=errors.d.ts.map

package/dist/src/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD;;;;;;;GAOG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC;;;;;OAKG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI3D;AAED;;;;;;GAMG;AACH,qBAAa,0BAA2B,SAAQ,UAAU;IACxD;;;;OAIG;gBACS,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;GAOG;AACH,qBAAa,cAAe,SAAQ,UAAU;IAC5C;;;OAGG;IACH,SAAgB,cAAc,EAAE,OAAO,CAAA;IAEvC;;;;;OAKG;gBACS,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO;CAKrD;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C;;;;OAIG;gBACS,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;GAKG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;IAClD;;;;OAIG;gBACS,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;GAMG;AACH,qBAAa,mBAAoB,SAAQ,UAAU;IACjD;;;;;OAKG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAEpD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD;;;;;;;GAOG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC;;;;;OAKG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI3D;AAED;;;;;;GAMG;AACH,qBAAa,0BAA2B,SAAQ,UAAU;IACxD;;;;OAIG;gBACS,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;GAOG;AACH,qBAAa,cAAe,SAAQ,UAAU;IAC5C;;;OAGG;IACH,SAAgB,cAAc,EAAE,OAAO,CAAA;IAEvC;;;;;OAKG;gBACS,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO;CAKrD;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C;;;;OAIG;gBACS,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;GAKG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;IAClD;;;;OAIG;gBACS,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;GAMG;AACH,qBAAa,mBAAoB,SAAQ,UAAU;IACjD;;;;;OAKG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAEpD;AAED;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC;;;;;OAKG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD"}

package/dist/src/errors.js

@@ -133,4 +133,22 @@ export class ModelThrottledError extends ModelError {
 export function normalizeError(error) {
     return error instanceof Error ? error : new Error(String(error));
 }
+/**
+ * Error thrown when session operations fail.
+ *
+ * This error indicates failures in session storage operations such as
+ * reading, writing, or managing session data.
+ */
+export class SessionError extends Error {
+    /**
+     * Creates a new SessionError.
+     *
+     * @param message - Error message describing the session error
+     * @param options - Optional error options including cause for error chaining
+     */
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'SessionError';
+    }
+}
 //# sourceMappingURL=errors.js.map

package/dist/src/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;GAOG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC;;;;;OAKG;IACH,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,YAAY,CAAA;IAC1B,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,0BAA2B,SAAQ,UAAU;IACxD;;;;OAIG;IACH,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAA;IAC1C,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,cAAe,SAAQ,UAAU;IAC5C;;;OAGG;IACa,cAAc,CAAS;IAEvC;;;;;OAKG;IACH,YAAY,OAAe,EAAE,cAAuB;QAClD,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;QAC5B,IAAI,CAAC,cAAc,GAAG,cAAc,CAAA;IACtC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C;;;;OAIG;IACH,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACnC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAClD;;;;OAIG;IACH,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAA;IACzC,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,mBAAoB,SAAQ,UAAU;IACjD;;;;;OAKG;IACH,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACnC,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;AAClE,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;GAOG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC;;;;;OAKG;IACH,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,YAAY,CAAA;IAC1B,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,0BAA2B,SAAQ,UAAU;IACxD;;;;OAIG;IACH,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAA;IAC1C,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,cAAe,SAAQ,UAAU;IAC5C;;;OAGG;IACa,cAAc,CAAS;IAEvC;;;;;OAKG;IACH,YAAY,OAAe,EAAE,cAAuB;QAClD,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;QAC5B,IAAI,CAAC,cAAc,GAAG,cAAc,CAAA;IACtC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C;;;;OAIG;IACH,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACnC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAClD;;;;OAIG;IACH,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAA;IACzC,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,mBAAoB,SAAQ,UAAU;IACjD;;;;;OAKG;IACH,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACnC,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;AAClE,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC;;;;;OAKG;IACH,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAA;IAC5B,CAAC;CACF"}