@robota-sdk/agent-sdk 3.0.0-beta.45 → 3.0.0-beta.47

package/README.md

@@ -84,7 +84,9 @@ const session = new InteractiveSession({
   config,
   context,
   projectInfo,
-  sessionStore,
+  sessionStore, // SessionStore instance for persistence
+  resumeSessionId, // Session ID to restore (optional)
+  forkSession, // Session ID to fork from (optional)
   permissionMode: 'default',
   maxTurns: 10,
   cwd: process.cwd(),
@@ -144,6 +146,10 @@ session.getContextState(); // IContextWindowState
 session.getStreamingText(); // string (accumulated so far)
 session.getActiveTools(); // IToolState[]
 
+// Session naming
+session.getName(); // string | undefined
+session.setName('my-task'); // sets the session name
+
 // Access underlying Session for advanced use
 session.getSession(); // Session
 ```

package/dist/node/index.cjs

@@ -713,6 +713,7 @@ function createSession(options) {
     model: options.config.provider.model,
     maxTurns: options.maxTurns,
     sessionStore: options.sessionStore,
+    sessionId: options.sessionId,
     permissionHandler: options.permissionHandler,
     onTextDelta: options.onTextDelta,
     onToolExecution: options.onToolExecution,
@@ -1117,6 +1118,8 @@ function createSystemCommands() {
           "  cost              \u2014 Show session info",
           "  context           \u2014 Context window info",
           "  permissions       \u2014 Permission rules",
+          "  resume            \u2014 Resume a previous session",
+          "  rename <name>     \u2014 Rename the current session",
           "  reset             \u2014 Delete settings and exit"
         ].join("\n"),
         success: true
@@ -1255,6 +1258,30 @@ Messages: ${messageCount}`,
         };
       }
     },
+    {
+      name: "resume",
+      description: "Resume a previous session",
+      execute: (_session, _args) => ({
+        message: "Opening session picker...",
+        success: true,
+        data: { triggerResumePicker: true }
+      })
+    },
+    {
+      name: "rename",
+      description: "Rename the current session",
+      execute: (_session, args) => {
+        const name = args.trim();
+        if (!name) {
+          return { message: "Usage: rename <name>", success: false };
+        }
+        return {
+          message: `Session renamed to "${name}".`,
+          success: true,
+          data: { name }
+        };
+      }
+    },
     {
       name: "reset",
       description: "Delete settings",
@@ -2180,6 +2207,14 @@ var InteractiveSession = class {
   pendingRawInput;
   // Full history timeline (chat messages + events)
   history = [];
+  // Session persistence
+  sessionStore;
+  sessionName;
+  cwd;
+  // Session restore state
+  pendingRestoreMessages = null;
+  resumeSessionId;
+  forkSession;
   constructor(options) {
     this.commandExecutor = new SystemCommandExecutor(createSystemCommands());
     if ("session" in options && options.session) {
@@ -2189,6 +2224,30 @@ var InteractiveSession = class {
       const stdOpts = options;
       this.initPromise = this.initializeAsync(stdOpts);
     }
+    this.sessionStore = options.sessionStore;
+    this.sessionName = options.sessionName;
+    this.cwd = ("cwd" in options ? options.cwd : void 0) ?? "";
+    this.resumeSessionId = options.resumeSessionId;
+    this.forkSession = options.forkSession ?? false;
+    if (options.resumeSessionId && this.sessionStore) {
+      const record = this.sessionStore.load(options.resumeSessionId);
+      if (record) {
+        this.history = record.history ?? [];
+        this.sessionName = record.name;
+        if (record.messages) {
+          if (this.session) {
+            for (const msg of record.messages) {
+              const m = msg;
+              if (m.role && m.content) {
+                this.session.injectMessage(m.role, m.content);
+              }
+            }
+          } else {
+            this.pendingRestoreMessages = record.messages;
+          }
+        }
+      }
+    }
   }
   async initializeAsync(options) {
     const cwd = options.cwd;
@@ -2215,6 +2274,7 @@ var InteractiveSession = class {
     } catch {
     }
     const paths = projectPaths(cwd);
+    const sessionId = this.resumeSessionId && !this.forkSession ? this.resumeSessionId : void 0;
     this.session = createSession({
       config: mergedConfig,
       context,
@@ -2226,8 +2286,20 @@ var InteractiveSession = class {
       permissionHandler: options.permissionHandler,
       provider: options.provider,
       onTextDelta: (delta) => this.handleTextDelta(delta),
-      onToolExecution: (event) => this.handleToolExecution(event)
+      onToolExecution: (event) => this.handleToolExecution(event),
+      sessionId
     });
+    if (this.pendingRestoreMessages) {
+      for (const msg of this.pendingRestoreMessages) {
+        if (msg && typeof msg === "object" && "role" in msg && "content" in msg) {
+          this.session.injectMessage(
+            msg.role,
+            msg.content
+          );
+        }
+      }
+      this.pendingRestoreMessages = null;
+    }
     this.initialized = true;
   }
   async ensureInitialized() {
@@ -2317,6 +2389,30 @@ var InteractiveSession = class {
   getContextState() {
     return this.getSessionOrThrow().getContextState();
   }
+  /** Get session name. */
+  getName() {
+    return this.sessionName;
+  }
+  /** Set session name and persist if store is available. */
+  setName(name) {
+    this.sessionName = name;
+    if (this.sessionStore && this.session) {
+      try {
+        const id = this.getSessionOrThrow().getSessionId();
+        const existing = this.sessionStore.load(id);
+        if (existing) {
+          existing.name = name;
+          existing.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+          this.sessionStore.save(existing);
+        }
+      } catch {
+      }
+    }
+  }
+  /** Attach a transport adapter to this session. Calls transport.attach(this). */
+  attachTransport(transport) {
+    transport.attach(this);
+  }
   /** Access underlying Session. For advanced use / testing only. */
   getSession() {
     return this.getSessionOrThrow();
@@ -2358,6 +2454,22 @@ var InteractiveSession = class {
     } finally {
       this.executing = false;
       this.emit("thinking", false);
+      if (this.sessionStore && this.session) {
+        try {
+          const sessionId = this.getSessionOrThrow().getSessionId();
+          const existing = this.sessionStore.load(sessionId);
+          this.sessionStore.save({
+            id: sessionId,
+            name: this.sessionName ?? existing?.name,
+            cwd: this.cwd ?? "",
+            createdAt: existing?.createdAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+            updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+            messages: this.getSessionOrThrow().getHistory(),
+            history: this.history
+          });
+        } catch {
+        }
+      }
       if (this.pendingPrompt) {
         const queued = this.pendingPrompt;
         const queuedDisplay = this.pendingDisplayInput;
@@ -2645,6 +2757,8 @@ function createBuiltinCommands() {
     { name: "cost", description: "Show session info", source: "builtin" },
     { name: "context", description: "Context window info", source: "builtin" },
     { name: "permissions", description: "Permission rules", source: "builtin" },
+    { name: "resume", description: "Resume a previous session", source: "builtin" },
+    { name: "rename", description: "Rename the current session", source: "builtin" },
     { name: "plugin", description: "Manage plugins", source: "builtin" },
     { name: "reload-plugins", description: "Reload all plugin resources", source: "builtin" },
     { name: "reset", description: "Delete settings and exit", source: "builtin" },

package/dist/node/index.d.cts

@@ -210,6 +210,8 @@ interface ICreateSessionOptions {
     sessionFactory?: TSessionFactory;
     /** Additional hook type executors beyond the defaults (prompt, agent). */
     additionalHookExecutors?: IHookTypeExecutor[];
+    /** Override session ID (used when resuming a session to reuse the original ID) */
+    sessionId?: string;
 }
 
 /**
@@ -402,6 +404,20 @@ interface IInteractiveSessionEvents {
     interrupted: (result: IExecutionResult) => void;
 }
 type TInteractiveEventName = keyof IInteractiveSessionEvents;
+/**
+ * Common interface for all transport adapters.
+ * Each transport exposes InteractiveSession over a specific protocol.
+ */
+interface ITransportAdapter {
+    /** Human-readable transport name (e.g., 'http', 'ws', 'mcp', 'headless') */
+    readonly name: string;
+    /** Attach an InteractiveSession to this transport. */
+    attach(session: InteractiveSession): void;
+    /** Start serving. What this means depends on the transport. */
+    start(): Promise<void>;
+    /** Stop serving and clean up resources. */
+    stop(): Promise<void>;
+}
 
 /**
  * InteractiveSession — the single entry point for all SDK consumers.
@@ -420,6 +436,10 @@ interface IInteractiveSessionStandardOptions {
     permissionMode?: ICreateSessionOptions['permissionMode'];
     maxTurns?: number;
     permissionHandler?: TInteractivePermissionHandler;
+    sessionStore?: SessionStore;
+    sessionName?: string;
+    resumeSessionId?: string;
+    forkSession?: boolean;
 }
 /** Test/advanced construction: inject pre-built session directly. */
 interface IInteractiveSessionInjectedOptions {
@@ -429,6 +449,10 @@ interface IInteractiveSessionInjectedOptions {
     permissionMode?: ICreateSessionOptions['permissionMode'];
     maxTurns?: number;
     permissionHandler?: TInteractivePermissionHandler;
+    sessionStore?: SessionStore;
+    sessionName?: string;
+    resumeSessionId?: string;
+    forkSession?: boolean;
 }
 type IInteractiveSessionOptions = IInteractiveSessionStandardOptions | IInteractiveSessionInjectedOptions;
 declare class InteractiveSession {
@@ -445,6 +469,12 @@ declare class InteractiveSession {
     private pendingDisplayInput;
     private pendingRawInput;
     private history;
+    private sessionStore?;
+    private sessionName?;
+    private cwd?;
+    private pendingRestoreMessages;
+    private resumeSessionId?;
+    private forkSession;
     constructor(options: IInteractiveSessionOptions);
     private initializeAsync;
     private ensureInitialized;
@@ -478,6 +508,12 @@ declare class InteractiveSession {
     getStreamingText(): string;
     getActiveTools(): IToolState[];
     getContextState(): IContextWindowState;
+    /** Get session name. */
+    getName(): string | undefined;
+    /** Set session name and persist if store is available. */
+    setName(name: string): void;
+    /** Attach a transport adapter to this session. Calls transport.attach(this). */
+    attachTransport(transport: ITransportAdapter): void;
     /** Access underlying Session. For advanced use / testing only. */
     getSession(): Session;
     private executePrompt;
@@ -1135,4 +1171,4 @@ declare function userPaths(): {
  */
 declare function promptForApproval(terminal: ITerminalOutput, toolName: string, toolArgs: TToolArgs): Promise<boolean>;
 
-export { AgentExecutor, BUILT_IN_AGENTS, BuiltinCommandSource, BundlePluginInstaller, BundlePluginLoader, CommandRegistry, type IAgentDefinition, type IAgentExecutorOptions, type IAgentSession, type IAgentToolDeps, type IBundlePluginFeatures, type IBundlePluginInstallerOptions, type IBundlePluginManifest, type IBundleSkill, type ICommand, type ICommandResult, type ICommandSource, type ICreateQueryOptions, type IDiffLine, type IExecutionResult, type IInstalledPluginRecord, type IInstalledPluginsRegistry, type IInteractiveSessionEvents, type IInteractiveSessionOptions, type IKnownMarketplaceEntry, type IKnownMarketplacesRegistry, type ILoadedBundlePlugin, type IMarketplaceClientOptions, type IMarketplaceManifest, type IMarketplacePluginEntry, type IMarketplaceSource, type IPluginSettings, type IPromptExecutorOptions, type IPromptProvider, type ISubagentOptions, type ISubagentPromptOptions, type ISystemCommand, type IToolState, type IToolSummary, InteractiveSession, MarketplaceClient, PluginCommandSource, PluginSettingsStore, PromptExecutor, SkillCommandSource, type SkillPromptContext, type TEnabledPlugins, type TInteractiveEventName, type TInteractivePermissionHandler, type TPermissionResultValue, type TProviderFactory, type TSessionFactory, assembleSubagentPrompt, buildSkillPrompt, createAgentTool, createQuery, createSubagentLogger, createSubagentSession, getBuiltInAgent, getForkWorkerSuffix, getSubagentSuffix, parseFrontmatter, preprocessShellCommands, projectPaths, promptForApproval, resolveSubagentLogDir, retrieveAgentToolDeps, storeAgentToolDeps, substituteVariables, userPaths };
+export { AgentExecutor, BUILT_IN_AGENTS, BuiltinCommandSource, BundlePluginInstaller, BundlePluginLoader, CommandRegistry, type IAgentDefinition, type IAgentExecutorOptions, type IAgentSession, type IAgentToolDeps, type IBundlePluginFeatures, type IBundlePluginInstallerOptions, type IBundlePluginManifest, type IBundleSkill, type ICommand, type ICommandResult, type ICommandSource, type ICreateQueryOptions, type IDiffLine, type IExecutionResult, type IInstalledPluginRecord, type IInstalledPluginsRegistry, type IInteractiveSessionEvents, type IInteractiveSessionOptions, type IKnownMarketplaceEntry, type IKnownMarketplacesRegistry, type ILoadedBundlePlugin, type IMarketplaceClientOptions, type IMarketplaceManifest, type IMarketplacePluginEntry, type IMarketplaceSource, type IPluginSettings, type IPromptExecutorOptions, type IPromptProvider, type ISubagentOptions, type ISubagentPromptOptions, type ISystemCommand, type IToolState, type IToolSummary, type ITransportAdapter, InteractiveSession, MarketplaceClient, PluginCommandSource, PluginSettingsStore, PromptExecutor, SkillCommandSource, type SkillPromptContext, type TEnabledPlugins, type TInteractiveEventName, type TInteractivePermissionHandler, type TPermissionResultValue, type TProviderFactory, type TSessionFactory, assembleSubagentPrompt, buildSkillPrompt, createAgentTool, createQuery, createSubagentLogger, createSubagentSession, getBuiltInAgent, getForkWorkerSuffix, getSubagentSuffix, parseFrontmatter, preprocessShellCommands, projectPaths, promptForApproval, resolveSubagentLogDir, retrieveAgentToolDeps, storeAgentToolDeps, substituteVariables, userPaths };

package/dist/node/index.d.ts

@@ -210,6 +210,8 @@ interface ICreateSessionOptions {
     sessionFactory?: TSessionFactory;
     /** Additional hook type executors beyond the defaults (prompt, agent). */
     additionalHookExecutors?: IHookTypeExecutor[];
+    /** Override session ID (used when resuming a session to reuse the original ID) */
+    sessionId?: string;
 }
 
 /**
@@ -402,6 +404,20 @@ interface IInteractiveSessionEvents {
     interrupted: (result: IExecutionResult) => void;
 }
 type TInteractiveEventName = keyof IInteractiveSessionEvents;
+/**
+ * Common interface for all transport adapters.
+ * Each transport exposes InteractiveSession over a specific protocol.
+ */
+interface ITransportAdapter {
+    /** Human-readable transport name (e.g., 'http', 'ws', 'mcp', 'headless') */
+    readonly name: string;
+    /** Attach an InteractiveSession to this transport. */
+    attach(session: InteractiveSession): void;
+    /** Start serving. What this means depends on the transport. */
+    start(): Promise<void>;
+    /** Stop serving and clean up resources. */
+    stop(): Promise<void>;
+}
 
 /**
  * InteractiveSession — the single entry point for all SDK consumers.
@@ -420,6 +436,10 @@ interface IInteractiveSessionStandardOptions {
     permissionMode?: ICreateSessionOptions['permissionMode'];
     maxTurns?: number;
     permissionHandler?: TInteractivePermissionHandler;
+    sessionStore?: SessionStore;
+    sessionName?: string;
+    resumeSessionId?: string;
+    forkSession?: boolean;
 }
 /** Test/advanced construction: inject pre-built session directly. */
 interface IInteractiveSessionInjectedOptions {
@@ -429,6 +449,10 @@ interface IInteractiveSessionInjectedOptions {
     permissionMode?: ICreateSessionOptions['permissionMode'];
     maxTurns?: number;
     permissionHandler?: TInteractivePermissionHandler;
+    sessionStore?: SessionStore;
+    sessionName?: string;
+    resumeSessionId?: string;
+    forkSession?: boolean;
 }
 type IInteractiveSessionOptions = IInteractiveSessionStandardOptions | IInteractiveSessionInjectedOptions;
 declare class InteractiveSession {
@@ -445,6 +469,12 @@ declare class InteractiveSession {
     private pendingDisplayInput;
     private pendingRawInput;
     private history;
+    private sessionStore?;
+    private sessionName?;
+    private cwd?;
+    private pendingRestoreMessages;
+    private resumeSessionId?;
+    private forkSession;
     constructor(options: IInteractiveSessionOptions);
     private initializeAsync;
     private ensureInitialized;
@@ -478,6 +508,12 @@ declare class InteractiveSession {
     getStreamingText(): string;
     getActiveTools(): IToolState[];
     getContextState(): IContextWindowState;
+    /** Get session name. */
+    getName(): string | undefined;
+    /** Set session name and persist if store is available. */
+    setName(name: string): void;
+    /** Attach a transport adapter to this session. Calls transport.attach(this). */
+    attachTransport(transport: ITransportAdapter): void;
     /** Access underlying Session. For advanced use / testing only. */
     getSession(): Session;
     private executePrompt;
@@ -1135,4 +1171,4 @@ declare function userPaths(): {
  */
 declare function promptForApproval(terminal: ITerminalOutput, toolName: string, toolArgs: TToolArgs): Promise<boolean>;
 
-export { AgentExecutor, BUILT_IN_AGENTS, BuiltinCommandSource, BundlePluginInstaller, BundlePluginLoader, CommandRegistry, type IAgentDefinition, type IAgentExecutorOptions, type IAgentSession, type IAgentToolDeps, type IBundlePluginFeatures, type IBundlePluginInstallerOptions, type IBundlePluginManifest, type IBundleSkill, type ICommand, type ICommandResult, type ICommandSource, type ICreateQueryOptions, type IDiffLine, type IExecutionResult, type IInstalledPluginRecord, type IInstalledPluginsRegistry, type IInteractiveSessionEvents, type IInteractiveSessionOptions, type IKnownMarketplaceEntry, type IKnownMarketplacesRegistry, type ILoadedBundlePlugin, type IMarketplaceClientOptions, type IMarketplaceManifest, type IMarketplacePluginEntry, type IMarketplaceSource, type IPluginSettings, type IPromptExecutorOptions, type IPromptProvider, type ISubagentOptions, type ISubagentPromptOptions, type ISystemCommand, type IToolState, type IToolSummary, InteractiveSession, MarketplaceClient, PluginCommandSource, PluginSettingsStore, PromptExecutor, SkillCommandSource, type SkillPromptContext, type TEnabledPlugins, type TInteractiveEventName, type TInteractivePermissionHandler, type TPermissionResultValue, type TProviderFactory, type TSessionFactory, assembleSubagentPrompt, buildSkillPrompt, createAgentTool, createQuery, createSubagentLogger, createSubagentSession, getBuiltInAgent, getForkWorkerSuffix, getSubagentSuffix, parseFrontmatter, preprocessShellCommands, projectPaths, promptForApproval, resolveSubagentLogDir, retrieveAgentToolDeps, storeAgentToolDeps, substituteVariables, userPaths };
+export { AgentExecutor, BUILT_IN_AGENTS, BuiltinCommandSource, BundlePluginInstaller, BundlePluginLoader, CommandRegistry, type IAgentDefinition, type IAgentExecutorOptions, type IAgentSession, type IAgentToolDeps, type IBundlePluginFeatures, type IBundlePluginInstallerOptions, type IBundlePluginManifest, type IBundleSkill, type ICommand, type ICommandResult, type ICommandSource, type ICreateQueryOptions, type IDiffLine, type IExecutionResult, type IInstalledPluginRecord, type IInstalledPluginsRegistry, type IInteractiveSessionEvents, type IInteractiveSessionOptions, type IKnownMarketplaceEntry, type IKnownMarketplacesRegistry, type ILoadedBundlePlugin, type IMarketplaceClientOptions, type IMarketplaceManifest, type IMarketplacePluginEntry, type IMarketplaceSource, type IPluginSettings, type IPromptExecutorOptions, type IPromptProvider, type ISubagentOptions, type ISubagentPromptOptions, type ISystemCommand, type IToolState, type IToolSummary, type ITransportAdapter, InteractiveSession, MarketplaceClient, PluginCommandSource, PluginSettingsStore, PromptExecutor, SkillCommandSource, type SkillPromptContext, type TEnabledPlugins, type TInteractiveEventName, type TInteractivePermissionHandler, type TPermissionResultValue, type TProviderFactory, type TSessionFactory, assembleSubagentPrompt, buildSkillPrompt, createAgentTool, createQuery, createSubagentLogger, createSubagentSession, getBuiltInAgent, getForkWorkerSuffix, getSubagentSuffix, parseFrontmatter, preprocessShellCommands, projectPaths, promptForApproval, resolveSubagentLogDir, retrieveAgentToolDeps, storeAgentToolDeps, substituteVariables, userPaths };

package/dist/node/index.js

@@ -650,6 +650,7 @@ function createSession(options) {
     model: options.config.provider.model,
     maxTurns: options.maxTurns,
     sessionStore: options.sessionStore,
+    sessionId: options.sessionId,
     permissionHandler: options.permissionHandler,
     onTextDelta: options.onTextDelta,
     onToolExecution: options.onToolExecution,
@@ -1059,6 +1060,8 @@ function createSystemCommands() {
           "  cost              \u2014 Show session info",
           "  context           \u2014 Context window info",
           "  permissions       \u2014 Permission rules",
+          "  resume            \u2014 Resume a previous session",
+          "  rename <name>     \u2014 Rename the current session",
           "  reset             \u2014 Delete settings and exit"
         ].join("\n"),
         success: true
@@ -1197,6 +1200,30 @@ Messages: ${messageCount}`,
         };
       }
     },
+    {
+      name: "resume",
+      description: "Resume a previous session",
+      execute: (_session, _args) => ({
+        message: "Opening session picker...",
+        success: true,
+        data: { triggerResumePicker: true }
+      })
+    },
+    {
+      name: "rename",
+      description: "Rename the current session",
+      execute: (_session, args) => {
+        const name = args.trim();
+        if (!name) {
+          return { message: "Usage: rename <name>", success: false };
+        }
+        return {
+          message: `Session renamed to "${name}".`,
+          success: true,
+          data: { name }
+        };
+      }
+    },
     {
       name: "reset",
       description: "Delete settings",
@@ -2130,6 +2157,14 @@ var InteractiveSession = class {
   pendingRawInput;
   // Full history timeline (chat messages + events)
   history = [];
+  // Session persistence
+  sessionStore;
+  sessionName;
+  cwd;
+  // Session restore state
+  pendingRestoreMessages = null;
+  resumeSessionId;
+  forkSession;
   constructor(options) {
     this.commandExecutor = new SystemCommandExecutor(createSystemCommands());
     if ("session" in options && options.session) {
@@ -2139,6 +2174,30 @@ var InteractiveSession = class {
       const stdOpts = options;
       this.initPromise = this.initializeAsync(stdOpts);
     }
+    this.sessionStore = options.sessionStore;
+    this.sessionName = options.sessionName;
+    this.cwd = ("cwd" in options ? options.cwd : void 0) ?? "";
+    this.resumeSessionId = options.resumeSessionId;
+    this.forkSession = options.forkSession ?? false;
+    if (options.resumeSessionId && this.sessionStore) {
+      const record = this.sessionStore.load(options.resumeSessionId);
+      if (record) {
+        this.history = record.history ?? [];
+        this.sessionName = record.name;
+        if (record.messages) {
+          if (this.session) {
+            for (const msg of record.messages) {
+              const m = msg;
+              if (m.role && m.content) {
+                this.session.injectMessage(m.role, m.content);
+              }
+            }
+          } else {
+            this.pendingRestoreMessages = record.messages;
+          }
+        }
+      }
+    }
   }
   async initializeAsync(options) {
     const cwd = options.cwd;
@@ -2165,6 +2224,7 @@ var InteractiveSession = class {
     } catch {
     }
     const paths = projectPaths(cwd);
+    const sessionId = this.resumeSessionId && !this.forkSession ? this.resumeSessionId : void 0;
     this.session = createSession({
       config: mergedConfig,
       context,
@@ -2176,8 +2236,20 @@ var InteractiveSession = class {
       permissionHandler: options.permissionHandler,
       provider: options.provider,
       onTextDelta: (delta) => this.handleTextDelta(delta),
-      onToolExecution: (event) => this.handleToolExecution(event)
+      onToolExecution: (event) => this.handleToolExecution(event),
+      sessionId
     });
+    if (this.pendingRestoreMessages) {
+      for (const msg of this.pendingRestoreMessages) {
+        if (msg && typeof msg === "object" && "role" in msg && "content" in msg) {
+          this.session.injectMessage(
+            msg.role,
+            msg.content
+          );
+        }
+      }
+      this.pendingRestoreMessages = null;
+    }
     this.initialized = true;
   }
   async ensureInitialized() {
@@ -2267,6 +2339,30 @@ var InteractiveSession = class {
   getContextState() {
     return this.getSessionOrThrow().getContextState();
   }
+  /** Get session name. */
+  getName() {
+    return this.sessionName;
+  }
+  /** Set session name and persist if store is available. */
+  setName(name) {
+    this.sessionName = name;
+    if (this.sessionStore && this.session) {
+      try {
+        const id = this.getSessionOrThrow().getSessionId();
+        const existing = this.sessionStore.load(id);
+        if (existing) {
+          existing.name = name;
+          existing.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+          this.sessionStore.save(existing);
+        }
+      } catch {
+      }
+    }
+  }
+  /** Attach a transport adapter to this session. Calls transport.attach(this). */
+  attachTransport(transport) {
+    transport.attach(this);
+  }
   /** Access underlying Session. For advanced use / testing only. */
   getSession() {
     return this.getSessionOrThrow();
@@ -2308,6 +2404,22 @@ var InteractiveSession = class {
     } finally {
       this.executing = false;
       this.emit("thinking", false);
+      if (this.sessionStore && this.session) {
+        try {
+          const sessionId = this.getSessionOrThrow().getSessionId();
+          const existing = this.sessionStore.load(sessionId);
+          this.sessionStore.save({
+            id: sessionId,
+            name: this.sessionName ?? existing?.name,
+            cwd: this.cwd ?? "",
+            createdAt: existing?.createdAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+            updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+            messages: this.getSessionOrThrow().getHistory(),
+            history: this.history
+          });
+        } catch {
+        }
+      }
       if (this.pendingPrompt) {
         const queued = this.pendingPrompt;
         const queuedDisplay = this.pendingDisplayInput;
@@ -2595,6 +2707,8 @@ function createBuiltinCommands() {
     { name: "cost", description: "Show session info", source: "builtin" },
     { name: "context", description: "Context window info", source: "builtin" },
     { name: "permissions", description: "Permission rules", source: "builtin" },
+    { name: "resume", description: "Resume a previous session", source: "builtin" },
+    { name: "rename", description: "Rename the current session", source: "builtin" },
     { name: "plugin", description: "Manage plugins", source: "builtin" },
     { name: "reload-plugins", description: "Reload all plugin resources", source: "builtin" },
     { name: "reset", description: "Delete settings and exit", source: "builtin" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robota-sdk/agent-sdk",
-  "version": "3.0.0-beta.45",
+  "version": "3.0.0-beta.47",
   "description": "Programmatic SDK for building AI agents with Robota — provides Session, query(), built-in tools, permissions, hooks, and context loading",
   "type": "module",
   "main": "dist/node/index.js",
@@ -24,9 +24,9 @@
   "dependencies": {
     "chalk": "^5.3.0",
     "zod": "^3.24.0",
-    "@robota-sdk/agent-core": "3.0.0-beta.45",
-    "@robota-sdk/agent-sessions": "3.0.0-beta.45",
-    "@robota-sdk/agent-tools": "3.0.0-beta.45"
+    "@robota-sdk/agent-core": "3.0.0-beta.47",
+    "@robota-sdk/agent-tools": "3.0.0-beta.47",
+    "@robota-sdk/agent-sessions": "3.0.0-beta.47"
   },
   "devDependencies": {
     "rimraf": "^5.0.5",