@robota-sdk/agent-sdk 3.0.0-beta.2 → 3.0.0-beta.3

package/dist/node/index.cjs

@@ -30,8 +30,10 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  FileSessionLogger: () => import_agent_sessions5.FileSessionLogger,
   Session: () => import_agent_sessions.Session,
   SessionStore: () => import_agent_sessions2.SessionStore,
+  SilentSessionLogger: () => import_agent_sessions5.SilentSessionLogger,
   TRUST_TO_MODE: () => import_agent_core.TRUST_TO_MODE,
   agentTool: () => agentTool,
   bashTool: () => import_agent_tools.bashTool,
@@ -43,11 +45,13 @@ __export(index_exports, {
   grepTool: () => import_agent_tools6.grepTool,
   loadConfig: () => loadConfig,
   loadContext: () => loadContext,
+  projectPaths: () => projectPaths,
   promptForApproval: () => promptForApproval,
   query: () => query,
   readTool: () => import_agent_tools2.readTool,
   runHooks: () => import_agent_core3.runHooks,
   setAgentToolDeps: () => setAgentToolDeps,
+  userPaths: () => userPaths,
   writeTool: () => import_agent_tools3.writeTool
 });
 module.exports = __toCommonJS(index_exports);
@@ -58,6 +62,9 @@ var import_agent_core = require("@robota-sdk/agent-core");
 // src/session.ts
 var import_agent_sessions = require("@robota-sdk/agent-sessions");
 
+// src/index.ts
+var import_agent_sessions5 = require("@robota-sdk/agent-sessions");
+
 // src/session-store.ts
 var import_agent_sessions2 = require("@robota-sdk/agent-sessions");
 
@@ -462,6 +469,26 @@ var import_agent_core2 = require("@robota-sdk/agent-core");
 // src/hooks/hook-runner.ts
 var import_agent_core3 = require("@robota-sdk/agent-core");
 
+// src/paths.ts
+var import_node_path = require("path");
+var import_node_os = require("os");
+function projectPaths(cwd) {
+  const base = (0, import_node_path.join)(cwd, ".robota");
+  return {
+    settings: (0, import_node_path.join)(base, "settings.json"),
+    settingsLocal: (0, import_node_path.join)(base, "settings.local.json"),
+    logs: (0, import_node_path.join)(base, "logs"),
+    sessions: (0, import_node_path.join)(base, "sessions")
+  };
+}
+function userPaths() {
+  const base = (0, import_node_path.join)((0, import_node_os.homedir)(), ".robota");
+  return {
+    settings: (0, import_node_path.join)(base, "settings.json"),
+    sessions: (0, import_node_path.join)(base, "sessions")
+  };
+}
+
 // src/tools/bash-tool.ts
 var import_agent_tools = require("@robota-sdk/agent-tools");
 
@@ -554,8 +581,10 @@ var agentTool = (0, import_agent_tools7.createZodFunctionTool)(
 );
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  FileSessionLogger,
   Session,
   SessionStore,
+  SilentSessionLogger,
   TRUST_TO_MODE,
   agentTool,
   bashTool,
@@ -567,10 +596,12 @@ var agentTool = (0, import_agent_tools7.createZodFunctionTool)(
   grepTool,
   loadConfig,
   loadContext,
+  projectPaths,
   promptForApproval,
   query,
   readTool,
   runHooks,
   setAgentToolDeps,
+  userPaths,
   writeTool
 });

package/dist/node/index.d.cts

@@ -3,7 +3,7 @@ export { IContextTokenUsage, IContextWindowState, IHookInput, IPermissionLists,
 import * as _robota_sdk_agent_tools from '@robota-sdk/agent-tools';
 export { TToolResult, bashTool, editTool, globTool, grepTool, readTool, writeTool } from '@robota-sdk/agent-tools';
 import { ITerminalOutput, IResolvedConfig as IResolvedConfig$1, ILoadedContext as ILoadedContext$1, IProjectInfo as IProjectInfo$1 } from '@robota-sdk/agent-sessions';
-export { ISessionOptions, ISessionRecord, ISpinner, ITerminalOutput, Session, SessionStore, TPermissionHandler, TPermissionResult } from '@robota-sdk/agent-sessions';
+export { FileSessionLogger, ISessionLogger, ISessionOptions, ISessionRecord, ISpinner, ITerminalOutput, Session, SessionStore, SilentSessionLogger, TPermissionHandler, TPermissionResult, TSessionLogData } from '@robota-sdk/agent-sessions';
 import { z } from 'zod';
 
 /**
@@ -281,6 +281,25 @@ declare function buildSystemPrompt(params: ISystemPromptParams): string;
  */
 declare function promptForApproval(terminal: ITerminalOutput, toolName: string, toolArgs: TToolArgs): Promise<boolean>;
 
+/**
+ * Standard Robota storage paths.
+ *
+ * All CLI runtime data lives under .robota/ (project) or ~/.robota/ (user).
+ * .agents/ is read-only from CLI's perspective (owned by AGENTS.md standard).
+ */
+/** Project-level .robota/ paths (relative to cwd). */
+declare function projectPaths(cwd: string): {
+    settings: string;
+    settingsLocal: string;
+    logs: string;
+    sessions: string;
+};
+/** User-level ~/.robota/ paths. */
+declare function userPaths(): {
+    settings: string;
+    sessions: string;
+};
+
 /** Dependencies injected at registration time */
 interface IAgentToolDeps {
     config: IResolvedConfig$1;
@@ -291,4 +310,4 @@ interface IAgentToolDeps {
 declare function setAgentToolDeps(deps: IAgentToolDeps): void;
 declare const agentTool: _robota_sdk_agent_tools.FunctionTool;
 
-export { type ILoadedContext, type IProjectInfo, type IQueryOptions, type IResolvedConfig, type ISystemPromptParams, agentTool, buildSystemPrompt, detectProject, loadConfig, loadContext, promptForApproval, query, setAgentToolDeps };
+export { type ILoadedContext, type IProjectInfo, type IQueryOptions, type IResolvedConfig, type ISystemPromptParams, agentTool, buildSystemPrompt, detectProject, loadConfig, loadContext, projectPaths, promptForApproval, query, setAgentToolDeps, userPaths };

package/dist/node/index.d.ts

@@ -3,7 +3,7 @@ export { IContextTokenUsage, IContextWindowState, IHookInput, IPermissionLists,
 import * as _robota_sdk_agent_tools from '@robota-sdk/agent-tools';
 export { TToolResult, bashTool, editTool, globTool, grepTool, readTool, writeTool } from '@robota-sdk/agent-tools';
 import { ITerminalOutput, IResolvedConfig as IResolvedConfig$1, ILoadedContext as ILoadedContext$1, IProjectInfo as IProjectInfo$1 } from '@robota-sdk/agent-sessions';
-export { ISessionOptions, ISessionRecord, ISpinner, ITerminalOutput, Session, SessionStore, TPermissionHandler, TPermissionResult } from '@robota-sdk/agent-sessions';
+export { FileSessionLogger, ISessionLogger, ISessionOptions, ISessionRecord, ISpinner, ITerminalOutput, Session, SessionStore, SilentSessionLogger, TPermissionHandler, TPermissionResult, TSessionLogData } from '@robota-sdk/agent-sessions';
 import { z } from 'zod';
 
 /**
@@ -281,6 +281,25 @@ declare function buildSystemPrompt(params: ISystemPromptParams): string;
  */
 declare function promptForApproval(terminal: ITerminalOutput, toolName: string, toolArgs: TToolArgs): Promise<boolean>;
 
+/**
+ * Standard Robota storage paths.
+ *
+ * All CLI runtime data lives under .robota/ (project) or ~/.robota/ (user).
+ * .agents/ is read-only from CLI's perspective (owned by AGENTS.md standard).
+ */
+/** Project-level .robota/ paths (relative to cwd). */
+declare function projectPaths(cwd: string): {
+    settings: string;
+    settingsLocal: string;
+    logs: string;
+    sessions: string;
+};
+/** User-level ~/.robota/ paths. */
+declare function userPaths(): {
+    settings: string;
+    sessions: string;
+};
+
 /** Dependencies injected at registration time */
 interface IAgentToolDeps {
     config: IResolvedConfig$1;
@@ -291,4 +310,4 @@ interface IAgentToolDeps {
 declare function setAgentToolDeps(deps: IAgentToolDeps): void;
 declare const agentTool: _robota_sdk_agent_tools.FunctionTool;
 
-export { type ILoadedContext, type IProjectInfo, type IQueryOptions, type IResolvedConfig, type ISystemPromptParams, agentTool, buildSystemPrompt, detectProject, loadConfig, loadContext, promptForApproval, query, setAgentToolDeps };
+export { type ILoadedContext, type IProjectInfo, type IQueryOptions, type IResolvedConfig, type ISystemPromptParams, agentTool, buildSystemPrompt, detectProject, loadConfig, loadContext, projectPaths, promptForApproval, query, setAgentToolDeps, userPaths };

package/dist/node/index.js

@@ -4,6 +4,9 @@ import { TRUST_TO_MODE } from "@robota-sdk/agent-core";
 // src/session.ts
 import { Session } from "@robota-sdk/agent-sessions";
 
+// src/index.ts
+import { FileSessionLogger, SilentSessionLogger } from "@robota-sdk/agent-sessions";
+
 // src/session-store.ts
 import { SessionStore } from "@robota-sdk/agent-sessions";
 
@@ -408,6 +411,26 @@ import { evaluatePermission } from "@robota-sdk/agent-core";
 // src/hooks/hook-runner.ts
 import { runHooks } from "@robota-sdk/agent-core";
 
+// src/paths.ts
+import { join as join4 } from "path";
+import { homedir } from "os";
+function projectPaths(cwd) {
+  const base = join4(cwd, ".robota");
+  return {
+    settings: join4(base, "settings.json"),
+    settingsLocal: join4(base, "settings.local.json"),
+    logs: join4(base, "logs"),
+    sessions: join4(base, "sessions")
+  };
+}
+function userPaths() {
+  const base = join4(homedir(), ".robota");
+  return {
+    settings: join4(base, "settings.json"),
+    sessions: join4(base, "sessions")
+  };
+}
+
 // src/tools/bash-tool.ts
 import { bashTool } from "@robota-sdk/agent-tools";
 
@@ -499,8 +522,10 @@ var agentTool = createZodFunctionTool(
   }
 );
 export {
+  FileSessionLogger,
   Session,
   SessionStore,
+  SilentSessionLogger,
   TRUST_TO_MODE,
   agentTool,
   bashTool,
@@ -512,10 +537,12 @@ export {
   grepTool,
   loadConfig,
   loadContext,
+  projectPaths,
   promptForApproval,
   query,
   readTool,
   runHooks,
   setAgentToolDeps,
+  userPaths,
   writeTool
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robota-sdk/agent-sdk",
-  "version": "3.0.0-beta.2",
+  "version": "3.0.0-beta.3",
   "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,10 +24,10 @@
   "dependencies": {
     "chalk": "^5.3.0",
     "zod": "^3.24.0",
-    "@robota-sdk/agent-core": "3.0.0-beta.2",
-    "@robota-sdk/agent-provider-anthropic": "3.0.0-beta.2",
-    "@robota-sdk/agent-sessions": "3.0.0-beta.2",
-    "@robota-sdk/agent-tools": "3.0.0-beta.2"
+    "@robota-sdk/agent-core": "3.0.0-beta.3",
+    "@robota-sdk/agent-provider-anthropic": "3.0.0-beta.3",
+    "@robota-sdk/agent-sessions": "3.0.0-beta.3",
+    "@robota-sdk/agent-tools": "3.0.0-beta.3"
   },
   "devDependencies": {
     "rimraf": "^5.0.5",