@robota-sdk/agent-sdk 3.0.0-beta.44 → 3.0.0-beta.46

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(),
@@ -129,6 +131,13 @@ session.abort();
 // Cancel queued prompt without aborting current execution
 session.cancelQueue();
 
+// Execute system commands
+const result = await session.executeCommand('context', '');
+// result.message, result.success, result.data
+
+// List all registered system commands
+session.listCommands(); // Array<{ name, description }>
+
 // State queries
 session.isExecuting(); // boolean
 session.getPendingPrompt(); // string | null
@@ -137,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() {
@@ -2274,6 +2346,13 @@ var InteractiveSession = class {
     await this.ensureInitialized();
     return this.commandExecutor.execute(name, this, args);
   }
+  /** List all registered system commands. */
+  listCommands() {
+    return this.commandExecutor.listCommands().map((cmd) => ({
+      name: cmd.name,
+      description: cmd.description
+    }));
+  }
   /** Abort current execution and clear queue. */
   abort() {
     this.pendingPrompt = null;
@@ -2310,6 +2389,26 @@ 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 {
+      }
+    }
+  }
   /** Access underlying Session. For advanced use / testing only. */
   getSession() {
     return this.getSessionOrThrow();
@@ -2351,6 +2450,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;
@@ -2638,6 +2753,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;
 }
 
 /**
@@ -420,6 +422,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 +435,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 +455,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;
@@ -460,6 +476,11 @@ declare class InteractiveSession {
         success: boolean;
         data?: Record<string, unknown>;
     } | null>;
+    /** List all registered system commands. */
+    listCommands(): Array<{
+        name: string;
+        description: string;
+    }>;
     /** Abort current execution and clear queue. */
     abort(): void;
     /** Cancel queued prompt without aborting current execution. */
@@ -473,6 +494,10 @@ 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;
     /** Access underlying Session. For advanced use / testing only. */
     getSession(): Session;
     private executePrompt;

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;
 }
 
 /**
@@ -420,6 +422,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 +435,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 +455,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;
@@ -460,6 +476,11 @@ declare class InteractiveSession {
         success: boolean;
         data?: Record<string, unknown>;
     } | null>;
+    /** List all registered system commands. */
+    listCommands(): Array<{
+        name: string;
+        description: string;
+    }>;
     /** Abort current execution and clear queue. */
     abort(): void;
     /** Cancel queued prompt without aborting current execution. */
@@ -473,6 +494,10 @@ 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;
     /** Access underlying Session. For advanced use / testing only. */
     getSession(): Session;
     private executePrompt;

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() {
@@ -2224,6 +2296,13 @@ var InteractiveSession = class {
     await this.ensureInitialized();
     return this.commandExecutor.execute(name, this, args);
   }
+  /** List all registered system commands. */
+  listCommands() {
+    return this.commandExecutor.listCommands().map((cmd) => ({
+      name: cmd.name,
+      description: cmd.description
+    }));
+  }
   /** Abort current execution and clear queue. */
   abort() {
     this.pendingPrompt = null;
@@ -2260,6 +2339,26 @@ 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 {
+      }
+    }
+  }
   /** Access underlying Session. For advanced use / testing only. */
   getSession() {
     return this.getSessionOrThrow();
@@ -2301,6 +2400,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;
@@ -2588,6 +2703,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.44",
+  "version": "3.0.0-beta.46",
   "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.44",
-    "@robota-sdk/agent-sessions": "3.0.0-beta.44",
-    "@robota-sdk/agent-tools": "3.0.0-beta.44"
+    "@robota-sdk/agent-core": "3.0.0-beta.46",
+    "@robota-sdk/agent-sessions": "3.0.0-beta.46",
+    "@robota-sdk/agent-tools": "3.0.0-beta.46"
   },
   "devDependencies": {
     "rimraf": "^5.0.5",