@botbotgo/agent-harness 0.0.282 → 0.0.284

package/README.md

@@ -524,7 +524,7 @@ Use `normalizeUserChatInput(...)` when a product already has chat-style user mes
 import { memorize, recall } from "@botbotgo/agent-harness";
 
 await memorize(runtime, {
-  threadId: "thread-123",
+  sessionId: "session-123",
   records: [
     {
       content: "The release checklist requires a smoke test before publish.",
@@ -972,7 +972,7 @@ spec:
       maxFileSizeMb: 10
       sessionStorage:
         enabled: true
-        rootDir: "{runRoot}/threads/{threadId}/filesystem"
+        rootDir: "{runRoot}/sessions/{sessionId}/filesystem"
     middleware: []
     systemPrompt: Answer simple requests directly.
 ```

package/README.zh.md

@@ -495,7 +495,7 @@ const result = await request(runtime, {
 import { memorize, recall } from "@botbotgo/agent-harness";
 
 await memorize(runtime, {
-  threadId: "thread-123",
+  sessionId: "session-123",
   records: [
     {
       content: "The release checklist requires a smoke test before publish.",
@@ -929,7 +929,7 @@ spec:
       maxFileSizeMb: 10
       sessionStorage:
         enabled: true
-        rootDir: "{runRoot}/threads/{threadId}/filesystem"
+        rootDir: "{runRoot}/sessions/{sessionId}/filesystem"
     middleware: []
     systemPrompt: Answer simple requests directly.
 ```

package/dist/config/agents/direct.yaml

@@ -10,9 +10,6 @@ metadata:
   description: Manual low-latency host for direct answers and lightweight inventory lookup. Do not use it as the default executor for tool-heavy or delegation-heavy tasks.
 spec:
   runtime:
-    # agent-harness feature: host-level run data placement override.
-    # This matches the workspace default and keeps the default config shape explicit.
-    runRoot: ./.agent
     # agent-harness feature: workspace-level durable long-term memory defaults for this host profile.
     runtimeMemory: default
   # =====================

package/dist/config/agents/orchestra.yaml

@@ -10,9 +10,6 @@ metadata:
   description: Default execution host. Answer directly when possible, use local tools and skills first, and delegate only when a subagent is a better fit. Not a reflex delegation-only orchestrator.
 spec:
   runtime:
-    # agent-harness feature: host-level run data placement override.
-    # This matches the workspace default and keeps the default config shape explicit.
-    runRoot: ./.agent
     # agent-harness feature: workspace-level durable long-term memory defaults for this host profile.
     runtimeMemory: default
   # =====================

package/dist/config/catalogs/stores.yaml

@@ -8,11 +8,11 @@ spec:
     name: default
     description: Default sqlite-backed store preset for runtime-managed agent state and durable memory.
     storeKind: SqliteStore
-    path: store.sqlite
+    path: knowledge/records.sqlite
 
   # agent-harness feature: reusable checkpointer preset for resumable execution state.
   - kind: Checkpointer
     name: default
     description: Default file-backed checkpointer preset for durable local graph state without native sqlite bindings.
     checkpointerKind: FileCheckpointer
-    path: checkpoints.json
+    path: runtime/checkpoints.json

package/dist/config/catalogs/vector-stores.yaml

@@ -13,7 +13,7 @@ spec:
     storeKind: LibSQLVectorStore
     # LangChain aligned feature: libSQL connection URL.
     # Local SQLite files use the `file:` prefix.
-    url: file:.agent/vector-store.db
+    url: file:knowledge/vectors.sqlite
     # LangChain aligned feature: target table and embedding column.
     table: rag_chunks
     column: embedding

package/dist/config/knowledge/knowledge-runtime.yaml

@@ -22,7 +22,7 @@ spec:
     ## agent-harness feature: stable namespace roots shared with runtime memory policy.
     users: memories/users/{userId}
     projects: memories/projects/{projectId}
-    threads: memories/threads/{threadId}
+    sessions: memories/sessions/{sessionId}
     agents: memories/agents/{agentId}
     workspaces: memories/workspaces/{workspaceId}
   retrieval:
@@ -47,7 +47,7 @@ spec:
       enabled: true
       scopes:
         - thread
-      stateStorePath: runtime-memory-formation-state.json
+      stateStorePath: knowledge/formation-state.json
       maxMessagesPerRun: 40
       writeOnApprovalResolution: true
       writeOnRunCompletion: true
@@ -56,5 +56,5 @@ spec:
     enabled: false
     apiKeyEnv: MEM0_API_KEY
     appId: agent-harness
-    stateStorePath: mem0-sync-state.json
+    stateStorePath: knowledge/mem0-sync-state.json
     maxMessagesPerRun: 200

package/dist/config/runtime/runtime-memory.yaml

@@ -30,7 +30,7 @@ spec:
   namespaces:
     users: memories/users/{userId}
     projects: memories/projects/{projectId}
-    threads: memories/threads/{threadId}
+    sessions: memories/sessions/{sessionId}
     agents: memories/agents/{agentId}
     workspaces: memories/workspaces/{workspaceId}
 
@@ -78,7 +78,7 @@ spec:
       enabled: true
       scopes:
         - thread
-      stateStorePath: runtime-memory-formation-state.json
+      stateStorePath: knowledge/formation-state.json
       maxMessagesPerRun: 40
       writeOnApprovalResolution: true
       writeOnRunCompletion: true
@@ -92,5 +92,5 @@ spec:
     enabled: false
     apiKeyEnv: MEM0_API_KEY
     appId: agent-harness
-    stateStorePath: mem0-sync-state.json
+    stateStorePath: knowledge/mem0-sync-state.json
     maxMessagesPerRun: 200

package/dist/config/runtime/workspace.yaml

@@ -12,15 +12,22 @@ spec:
   # ======================
   # agent-harness Features
   # ======================
-  # agent-harness feature: filesystem root where the harness stores local run artifacts by default.
-  # This affects file-backed persistence such as:
-  # - session / thread / run indexes
-  # - approval and delegation records
-  # - default file-backed store paths
-  # - default file-backed checkpointer paths
-  # Agents inherit this value unless they override `spec.runRoot` locally.
-  # Value options: relative workspace path like `./.agent`, or an absolute filesystem path.
-  runRoot: ./.agent
+  # agent-harness feature: read-only application folder that contains the shared workspace assembly.
+  # This is where the runtime loads config catalogs and packaged resources such as:
+  # - config/
+  # - resources/
+  # Downstream applications can point multiple runtime profiles at the same application folder.
+  applicationRoot: .
+
+  # agent-harness feature: writable data folder for one runtime profile.
+  # Runtime-owned persistence stays under this root, split by function:
+  # - runtime/ for requests, approvals, checkpoints, and artifacts
+  # - knowledge/ for durable knowledge and vector indexes
+  # Different runtime profiles can use different data folders while sharing the same application folder.
+  dataRoot: ./.agent
+
+  # agent-harness feature: stable runtime profile identifier for this data folder.
+  profile: default
 
   # agent-harness feature: runtime-level task queue and maximum number of concurrent runs.
   # Additional runs wait in the harness queue until a slot becomes available.

package/dist/contracts/workspace.d.ts

@@ -7,6 +7,9 @@ export type ParsedAgentObject = {
     description: string;
     modelRef: string;
     runRoot?: string;
+    applicationRoot?: string;
+    dataRoot?: string;
+    runtimeProfile?: string;
     toolRefs: string[];
     toolBindings?: ParsedAgentToolBinding[];
     inlineTools?: ParsedToolObject[];
@@ -260,6 +263,9 @@ export type CompiledAgentBinding = {
      */
     deepAgentParams?: LegacyDeepAgentParams;
     harnessRuntime: {
+        applicationRoot?: string;
+        dataRoot?: string;
+        runtimeProfile?: string;
         runRoot: string;
         workspaceRoot?: string;
         capabilities?: RuntimeCapabilities;

package/dist/init-project.js

@@ -93,7 +93,9 @@ kind: Runtime
 metadata:
   name: default
 spec:
-  runRoot: ./.agent
+  applicationRoot: .
+  dataRoot: ./.agent
+  profile: default
 `;
 }
 function renderAgentContext(options) {
@@ -143,11 +145,11 @@ spec:
   enabled: true
   store:
     kind: SqliteStore
-    path: runtime-memory.sqlite
+    path: knowledge/records.sqlite
   namespaces:
     users: memories/users/{userId}
     projects: memories/projects/{projectId}
-    threads: memories/threads/{threadId}
+    sessions: memories/sessions/{sessionId}
     agents: memories/agents/{agentId}
     workspaces: memories/workspaces/{workspaceId}
   retrieval:
@@ -179,7 +181,7 @@ spec:
       enabled: true
       scopes:
         - thread
-      stateStorePath: runtime-memory-formation-state.json
+      stateStorePath: knowledge/formation-state.json
       maxMessagesPerRun: 40
       writeOnApprovalResolution: true
       writeOnRunCompletion: true
@@ -189,7 +191,7 @@ spec:
     enabled: false
     apiKeyEnv: MEM0_API_KEY
     appId: ${projectSlug}
-    stateStorePath: mem0-sync-state.json
+    stateStorePath: knowledge/mem0-sync-state.json
     maxMessagesPerRun: 200
 `;
 }
@@ -202,11 +204,11 @@ spec:
   enabled: true
   store:
     kind: SqliteStore
-    path: runtime-memory.sqlite
+    path: knowledge/records.sqlite
   namespaces:
     users: memories/users/{userId}
     projects: memories/projects/{projectId}
-    threads: memories/threads/{threadId}
+    sessions: memories/sessions/{sessionId}
     agents: memories/agents/{agentId}
     workspaces: memories/workspaces/{workspaceId}
   retrieval:
@@ -223,7 +225,7 @@ spec:
       enabled: true
       scopes:
         - thread
-      stateStorePath: runtime-memory-formation-state.json
+      stateStorePath: knowledge/formation-state.json
       maxMessagesPerRun: 40
       writeOnApprovalResolution: true
       writeOnRunCompletion: true
@@ -231,7 +233,7 @@ spec:
     enabled: false
     apiKeyEnv: MEM0_API_KEY
     appId: ${projectSlug}
-    stateStorePath: mem0-sync-state.json
+    stateStorePath: knowledge/mem0-sync-state.json
     maxMessagesPerRun: 200
 `;
 }

package/dist/package-version.d.ts

@@ -1 +1 @@
-export declare const AGENT_HARNESS_VERSION = "0.0.281";
+export declare const AGENT_HARNESS_VERSION = "0.0.283";

package/dist/package-version.js

@@ -1 +1 @@
-export const AGENT_HARNESS_VERSION = "0.0.281";
+export const AGENT_HARNESS_VERSION = "0.0.283";

package/dist/persistence/file-store.d.ts

@@ -10,6 +10,7 @@ type RunIndexRecord = {
 export declare class FilePersistence implements RuntimePersistence {
     private readonly runRoot;
     constructor(runRoot: string);
+    private artifactsRoot;
     private threadIndexPath;
     private runIndexPath;
     private approvalIndexPath;

package/dist/persistence/file-store.js

@@ -1,6 +1,7 @@
 import path from "node:path";
 import { appendFile, readFile, readdir, rm, writeFile } from "node:fs/promises";
 import { ensureDir, fileExists, readJson, writeJson } from "../utils/fs.js";
+import { resolveRuntimeArtifactsRoot } from "../runtime/support/runtime-layout.js";
 function nowIso() {
     return new Date(Date.now()).toISOString();
 }
@@ -9,39 +10,42 @@ export class FilePersistence {
     constructor(runRoot) {
         this.runRoot = runRoot;
     }
+    artifactsRoot() {
+        return resolveRuntimeArtifactsRoot(this.runRoot);
+    }
     threadIndexPath(threadId) {
-        return path.join(this.runRoot, "indexes", "threads", `${threadId}.json`);
+        return path.join(this.artifactsRoot(), "indexes", "sessions", `${threadId}.json`);
     }
     runIndexPath(runId) {
-        return path.join(this.runRoot, "indexes", "runs", `${runId}.json`);
+        return path.join(this.artifactsRoot(), "indexes", "requests", `${runId}.json`);
     }
     approvalIndexPath(approvalId) {
-        return path.join(this.runRoot, "indexes", "approvals", `${approvalId}.json`);
+        return path.join(this.artifactsRoot(), "indexes", "approvals", `${approvalId}.json`);
     }
     runQueuePath(runId) {
-        return path.join(this.runRoot, "indexes", "queue", `${runId}.json`);
+        return path.join(this.artifactsRoot(), "indexes", "requests-queue", `${runId}.json`);
     }
     runControlPath(runId) {
-        return path.join(this.runRoot, "indexes", "run-control", `${runId}.json`);
+        return path.join(this.artifactsRoot(), "indexes", "requests-control", `${runId}.json`);
     }
     traceItemsPath(threadId, runId) {
         return path.join(this.runDir(threadId, runId), "trace-items.ndjson");
     }
     async initialize() {
         await Promise.all([
-            "indexes/threads",
-            "indexes/runs",
+            "indexes/sessions",
+            "indexes/requests",
             "indexes/approvals",
-            "indexes/queue",
-            "indexes/run-control",
-            "threads",
-        ].map((segment) => ensureDir(path.join(this.runRoot, segment))));
+            "indexes/requests-queue",
+            "indexes/requests-control",
+            "sessions",
+        ].map((segment) => ensureDir(path.join(this.artifactsRoot(), segment))));
     }
     threadDir(threadId) {
-        return path.join(this.runRoot, "threads", threadId);
+        return path.join(this.artifactsRoot(), "sessions", threadId);
     }
     runDir(threadId, runId) {
-        return path.join(this.threadDir(threadId), "runs", runId);
+        return path.join(this.threadDir(threadId), "requests", runId);
     }
     async createThread(input) {
         const meta = {
@@ -58,7 +62,7 @@ export class FilePersistence {
             threadId: input.threadId,
             items: [],
         });
-        await writeJson(path.join(this.runRoot, "indexes", "threads", `${input.threadId}.json`), {
+        await writeJson(this.threadIndexPath(input.threadId), {
             threadId: input.threadId,
             status: input.status,
             latestRunId: input.runId,
@@ -118,7 +122,7 @@ export class FilePersistence {
                 hasError: false,
                 lastError: null,
             }),
-            writeJson(path.join(this.runRoot, "indexes", "runs", `${input.runId}.json`), {
+            writeJson(this.runIndexPath(input.runId), {
                 runId: input.runId,
                 threadId: input.threadId,
                 state: "running",
@@ -175,7 +179,7 @@ export class FilePersistence {
                 kind: "langgraph-checkpoint",
             });
         }
-        await writeJson(path.join(this.runRoot, "indexes", "runs", `${runId}.json`), {
+        await writeJson(this.runIndexPath(runId), {
             runId,
             threadId,
             state,
@@ -188,7 +192,7 @@ export class FilePersistence {
         threadMeta.updatedAt = now;
         threadMeta.latestRunId = runId;
         await writeJson(threadMetaPath, threadMeta);
-        await writeJson(path.join(this.runRoot, "indexes", "threads", `${threadId}.json`), {
+        await writeJson(this.threadIndexPath(threadId), {
             threadId,
             status: state,
             latestRunId: runId,
@@ -208,7 +212,7 @@ export class FilePersistence {
         ]);
     }
     async listSessions(filter = {}) {
-        const threadIndexDir = path.join(this.runRoot, "indexes", "threads");
+        const threadIndexDir = path.join(this.artifactsRoot(), "indexes", "sessions");
         if (!(await fileExists(threadIndexDir))) {
             return [];
         }
@@ -253,7 +257,7 @@ export class FilePersistence {
         return summaries.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
     }
     async listRunIndexes() {
-        const runIndexDir = path.join(this.runRoot, "indexes", "runs");
+        const runIndexDir = path.join(this.artifactsRoot(), "indexes", "requests");
         if (!(await fileExists(runIndexDir))) {
             return [];
         }
@@ -314,7 +318,7 @@ export class FilePersistence {
         return this.readRunSummary(index.threadId, index.runId);
     }
     async getSession(threadId) {
-        const filePath = path.join(this.runRoot, "indexes", "threads", `${threadId}.json`);
+        const filePath = this.threadIndexPath(threadId);
         if (!(await fileExists(filePath))) {
             return null;
         }
@@ -360,7 +364,7 @@ export class FilePersistence {
         return Promise.all(entries.map((entry) => readJson(path.join(eventsDir, entry))));
     }
     async listApprovals(filter = {}) {
-        const approvalsDir = path.join(this.runRoot, "indexes", "approvals");
+        const approvalsDir = path.join(this.artifactsRoot(), "indexes", "approvals");
         if (!(await fileExists(approvalsDir))) {
             return [];
         }
@@ -380,7 +384,7 @@ export class FilePersistence {
         });
     }
     async getApproval(approvalId) {
-        const approvalPath = path.join(this.runRoot, "indexes", "approvals", `${approvalId}.json`);
+        const approvalPath = this.approvalIndexPath(approvalId);
         if (!(await fileExists(approvalPath))) {
             return null;
         }
@@ -496,7 +500,7 @@ export class FilePersistence {
         };
         await Promise.all([
             writeJson(path.join(this.runDir(sessionId, requestId), "approvals", `${record.approvalId}.json`), normalized),
-            writeJson(path.join(this.runRoot, "indexes", "approvals", `${record.approvalId}.json`), normalized),
+            writeJson(this.approvalIndexPath(record.approvalId), normalized),
         ]);
     }
     async resolveApproval(threadId, runId, approvalId, status) {
@@ -509,7 +513,7 @@ export class FilePersistence {
         };
         await Promise.all([
             writeJson(approvalPath, updated),
-            writeJson(path.join(this.runRoot, "indexes", "approvals", `${approvalId}.json`), updated),
+            writeJson(this.approvalIndexPath(approvalId), updated),
         ]);
         return updated;
     }
@@ -668,7 +672,7 @@ export class FilePersistence {
         });
     }
     async listExpiredClaimedRuns(cutoffIso) {
-        const queueDir = path.join(this.runRoot, "indexes", "queue");
+        const queueDir = path.join(this.artifactsRoot(), "indexes", "requests-queue");
         if (!(await fileExists(queueDir))) {
             return [];
         }

package/dist/persistence/sqlite-store.js

@@ -2,6 +2,7 @@ import path from "node:path";
 import { mkdir, rm } from "node:fs/promises";
 import { createClient } from "@libsql/client";
 import { fileExists, readJson, writeJson } from "../utils/fs.js";
+import { resolveRuntimeRoot, resolveRuntimeSqlitePath } from "../runtime/support/runtime-layout.js";
 import { SqliteRunContextStore } from "./sqlite-run-context-store.js";
 import { SqliteRunQueueStore } from "./sqlite-run-queue-store.js";
 const RUNTIME_SQLITE_SCHEMA_VERSION = 6;
@@ -97,7 +98,9 @@ export class SqlitePersistence {
     initialization = null;
     constructor(runRoot, dbFile = "runtime.sqlite") {
         this.runRoot = runRoot;
-        this.dbPath = path.join(runRoot, dbFile);
+        this.dbPath = dbFile === "runtime.sqlite"
+            ? resolveRuntimeSqlitePath(runRoot)
+            : path.join(resolveRuntimeRoot(runRoot), dbFile);
         this.runContextStore = new SqliteRunContextStore({
             execute: (sql, args) => this.execute(sql, args),
             selectOne: (sql, args) => this.selectOne(sql, args),
@@ -111,7 +114,7 @@ export class SqlitePersistence {
     }
     async getClient() {
         if (!this.client) {
-            await mkdir(this.runRoot, { recursive: true });
+            await mkdir(path.dirname(this.dbPath), { recursive: true });
             this.client = createClient({ url: toSqliteUrl(this.dbPath) });
         }
         return this.client;
@@ -148,7 +151,7 @@ export class SqlitePersistence {
             return;
         }
         this.initialization = (async () => {
-            await mkdir(this.runRoot, { recursive: true });
+            await mkdir(resolveRuntimeRoot(this.runRoot), { recursive: true });
             await this.getClient();
             await this.rawExecute("PRAGMA journal_mode=WAL");
             await this.rawExecute("PRAGMA foreign_keys=ON");

package/dist/runtime/harness/run/resources.js

@@ -1,6 +1,7 @@
 import { createCheckpointerForConfig, createStoreForConfig } from "../../support/runtime-factories.js";
 import { resolveCompiledEmbeddingModel, resolveCompiledEmbeddingModelRef } from "../../support/embedding-models.js";
 import { resolveCompiledVectorStore, resolveCompiledVectorStoreRef } from "../../support/vector-stores.js";
+import { resolveRuntimeCheckpointerPath } from "../../support/runtime-layout.js";
 export function resolveStoreFromConfig(stores, storeConfig, runRoot) {
     const cacheKey = storeConfig ? `${runRoot}:${JSON.stringify(storeConfig)}` : undefined;
     if (!storeConfig || !cacheKey) {
@@ -42,12 +43,13 @@ export async function resolveVectorStore(workspace, vectorStores, vectorStoreRef
     return resolved;
 }
 export function resolveCheckpointer(checkpointers, binding) {
-    const key = `${binding.harnessRuntime.runRoot}:${JSON.stringify(binding.harnessRuntime.checkpointer ?? { kind: "FileCheckpointer", path: "checkpoints.json" })}`;
+    const key = `${binding.harnessRuntime.runRoot}:${JSON.stringify(binding.harnessRuntime.checkpointer ?? { kind: "FileCheckpointer", path: resolveRuntimeCheckpointerPath(binding.harnessRuntime.runRoot, "checkpoints.json") })}`;
     const existing = checkpointers.get(key);
     if (existing) {
         return existing;
     }
-    const resolvedConfig = binding.harnessRuntime.checkpointer ?? { kind: "FileCheckpointer", path: "checkpoints.json" };
+    const resolvedConfig = binding.harnessRuntime.checkpointer ??
+        { kind: "FileCheckpointer", path: resolveRuntimeCheckpointerPath(binding.harnessRuntime.runRoot, "checkpoints.json") };
     if (typeof resolvedConfig === "boolean") {
         checkpointers.set(key, resolvedConfig);
         return resolvedConfig;

package/dist/runtime/harness/system/mem0-ingestion-sync.js

@@ -62,7 +62,7 @@ export function readMem0RuntimeConfig(runtimeMemory, workspaceRoot) {
         projectId: asNonEmptyString(mem0.projectId),
         appId: asNonEmptyString(mem0.appId) ?? workspaceBaseName,
         userIdPrefix: asNonEmptyString(mem0.userIdPrefix),
-        stateStorePath: asNonEmptyString(mem0.stateStorePath) ?? "mem0-sync-state.json",
+        stateStorePath: asNonEmptyString(mem0.stateStorePath) ?? "knowledge/mem0-sync-state.json",
         maxMessagesPerRun: asPositiveInteger(mem0.maxMessagesPerRun) ?? 200,
         writeOnApprovalResolution: asBoolean(mem0.writeOnApprovalResolution) ?? asBoolean(ingestion?.writeOnApprovalResolution) ?? true,
         writeOnRunCompletion: asBoolean(mem0.writeOnRunCompletion) ?? asBoolean(ingestion?.writeOnRunCompletion) ?? true,

package/dist/runtime/harness/system/runtime-memory-manager.js

@@ -57,7 +57,7 @@ export function readRuntimeMemoryFormationConfig(runtimeMemory, workspaceRoot) {
             enabled: asBoolean(background?.enabled) ?? true,
             maxMessagesPerRun: asPositiveInteger(background?.maxMessagesPerRun) ?? asPositiveInteger(ingestion?.maxMessagesPerRun) ?? 40,
             scopes: normalizeScopeList(asMemoryScopes(background?.scopes) ?? ["thread"]),
-            stateStorePath: asNonEmptyString(background?.stateStorePath) ?? `${workspaceBaseName}-memory-formation-state.json`,
+            stateStorePath: asNonEmptyString(background?.stateStorePath) ?? `knowledge/${workspaceBaseName}-memory-formation-state.json`,
             writeOnApprovalResolution: asBoolean(background?.writeOnApprovalResolution) ?? asBoolean(ingestion?.writeOnApprovalResolution) ?? true,
             writeOnRunCompletion: asBoolean(background?.writeOnRunCompletion) ?? asBoolean(ingestion?.writeOnRunCompletion) ?? true,
         },

package/dist/runtime/harness/system/runtime-memory-policy.js

@@ -35,7 +35,7 @@ export function readRuntimeMemoryPolicyConfig(runtimeMemory, workspaceRoot) {
             maxPromptMemories: asPositiveInteger(retrieval?.maxPromptMemories) ?? 8,
         },
         namespaces: {
-            thread: asString(namespaces?.threads) ?? "memories/threads/{threadId}",
+            thread: asString(namespaces?.sessions) ?? "memories/sessions/{sessionId}",
             workspace: asString(namespaces?.workspaces) ?? `memories/workspaces/${workspaceId}`,
             agent: asString(namespaces?.agents) ?? "memories/agents/{agentId}",
             user: asString(namespaces?.users) ?? "memories/users/{userId}",

package/dist/runtime/harness/system/runtime-memory-sync.js

@@ -192,10 +192,10 @@ export class RuntimeMemorySync {
         await this.store.put(this.resolveThreadNamespace(threadId), "durable-summary.md", { content: `${digestMarkdown}\n` });
     }
     resolveThreadNamespace(threadId) {
-        return this.options.resolveThreadNamespace ? this.options.resolveThreadNamespace(threadId) : ["memories", "threads", threadId];
+        return this.options.resolveThreadNamespace ? this.options.resolveThreadNamespace(threadId) : ["memories", "sessions", threadId];
     }
     resolveRunNamespace(threadId) {
-        return this.options.resolveRunNamespace ? this.options.resolveRunNamespace(threadId) : ["memories", "runs", threadId];
+        return this.options.resolveRunNamespace ? this.options.resolveRunNamespace(threadId) : ["memories", "requests", threadId];
     }
     async close() {
         await Promise.allSettled(Array.from(this.pending));

package/dist/runtime/harness/system/thread-memory-sync.js

@@ -47,7 +47,7 @@ function formatOpenApprovalsSection(approvals) {
     return lines;
 }
 function resolveThreadNamespace(threadId, resolver) {
-    return resolver ? resolver(threadId) : ["memories", "threads", threadId];
+    return resolver ? resolver(threadId) : ["memories", "sessions", threadId];
 }
 const THREAD_MEMORY_EVENT_TYPES = new Set([
     "run.state.changed",

package/dist/runtime/harness.js

@@ -10,7 +10,7 @@ import { getConcurrencyConfig, getRecoveryConfig, getRoutingDefaultAgentId, getR
 import { createHarnessEvent, inferRoutingBindings, renderRuntimeFailure, } from "./support/harness-support.js";
 import { ThreadMemorySync } from "./harness/system/thread-memory-sync.js";
 import { RuntimeMemorySync, readRuntimeMemorySyncConfig } from "./harness/system/runtime-memory-sync.js";
-import { FileBackedStore } from "./harness/system/store.js";
+import { SqliteBackedStore } from "./harness/system/store.js";
 import { HealthMonitor, readHealthMonitorConfig, } from "./harness/system/health-monitor.js";
 import { normalizeInvocationEnvelope, normalizeRunPriority, resolveRunListeners, } from "./harness/run/helpers.js";
 import { emitHarnessEvent, } from "./harness/events/events.js";
@@ -34,6 +34,7 @@ import { Mem0IngestionSync, Mem0SemanticRecall, readMem0RuntimeConfig, } from ".
 import { createRuntimeMemoryManager, RuntimeMemoryFormationSync, readRuntimeMemoryFormationConfig, } from "./harness/system/runtime-memory-manager.js";
 import { readRuntimeMemoryMaintenanceConfig, readRuntimeMemoryPolicyConfig, resolveMemoryNamespace, } from "./harness/system/runtime-memory-policy.js";
 import { resolveRuntimeAdapterOptions } from "./support/runtime-adapter-options.js";
+import { resolveKnowledgeStorePath } from "./support/runtime-layout.js";
 import { initializeHarnessRuntime, reclaimExpiredClaimedRuns as reclaimHarnessExpiredClaimedRuns, recoverStartupRuns as recoverHarnessStartupRuns, isStaleRunningRun as isHarnessStaleRunningRun, } from "./harness/run/startup-runtime.js";
 import { traceStartupStage } from "./startup-tracing.js";
 import { normalizeProcessExecutablePath } from "./support/runtime-env.js";
@@ -256,11 +257,11 @@ export class AgentHarnessRuntime {
         normalizeProcessExecutablePath();
         this.runtimeEntryBindings = inferRoutingBindings(this.workspace).runtimeEntryBindings;
         this.defaultRuntimeEntryBinding = this.runtimeEntryBindings[0];
-        this.defaultRunRootValue = this.defaultRuntimeEntryBinding?.harnessRuntime.runRoot ?? `${this.workspace.workspaceRoot}/run-data`;
+        this.defaultRunRootValue = this.defaultRuntimeEntryBinding?.harnessRuntime.runRoot ?? `${this.workspace.workspaceRoot}/.agent`;
         const runRoot = this.defaultRunRoot();
         this.persistence = new SqlitePersistence(runRoot);
         const defaultStoreConfig = this.defaultRuntimeEntryBinding?.harnessRuntime.store;
-        this.defaultStore = resolveStoreFromConfig(this.stores, defaultStoreConfig, runRoot) ?? new FileBackedStore(`${runRoot}/store.json`);
+        this.defaultStore = resolveStoreFromConfig(this.stores, defaultStoreConfig, runRoot) ?? new SqliteBackedStore(resolveKnowledgeStorePath(runRoot));
         const runtimeMemoryStoreConfig = typeof this.defaultRuntimeEntryBinding?.harnessRuntime.runtimeMemory?.store === "object" &&
             this.defaultRuntimeEntryBinding?.harnessRuntime.runtimeMemory?.store
             ? this.defaultRuntimeEntryBinding.harnessRuntime.runtimeMemory.store
@@ -291,12 +292,12 @@ export class AgentHarnessRuntime {
         this.routingDefaultAgentId = getRoutingDefaultAgentId(workspace.refs);
         if (isThreadMemorySyncEnabled(workspace)) {
             this.threadMemorySync = new ThreadMemorySync(this.persistence, this.runtimeMemoryStore, {
-                resolveThreadNamespace: (threadId) => {
+                resolveThreadNamespace: (sessionId) => {
                     const binding = this.defaultRuntimeEntryBinding;
                     if (!binding) {
-                        return ["memories", "threads", threadId];
+                        return ["memories", "sessions", sessionId];
                     }
-                    return this.resolveMemoryNamespace("thread", binding, { threadId });
+                    return this.resolveMemoryNamespace("thread", binding, { sessionId });
                 },
             });
             this.unregisterThreadMemorySync = this.eventBus.registerProjection(this.threadMemorySync);
@@ -308,12 +309,12 @@ export class AgentHarnessRuntime {
         const runtimeMemorySyncConfig = readRuntimeMemorySyncConfig(this.defaultRuntimeEntryBinding?.harnessRuntime.runtimeMemory);
         if (runtimeMemorySyncConfig) {
             this.runtimeMemorySync = new RuntimeMemorySync(this.persistence, this.runtimeMemoryStore, runtimeMemorySyncConfig, {
-                resolveThreadNamespace: (threadId) => {
+                resolveThreadNamespace: (sessionId) => {
                     const binding = this.defaultRuntimeEntryBinding;
                     if (!binding) {
-                        return ["memories", "threads", threadId];
+                        return ["memories", "sessions", sessionId];
                     }
-                    return this.resolveMemoryNamespace("thread", binding, { threadId });
+                    return this.resolveMemoryNamespace("thread", binding, { sessionId });
                 },
             });
             this.unregisterRuntimeMemorySync = this.eventBus.registerProjection(this.runtimeMemorySync);
@@ -363,7 +364,7 @@ export class AgentHarnessRuntime {
                     return ["memories", `${scope}s`, identifier ?? "default"];
                 }
                 return this.resolveMemoryNamespace(scope, binding, {
-                    threadId: context.sessionId,
+                    sessionId: context.sessionId,
                     agentId: context.agentId,
                     userId: context.userId,
                     projectId: context.projectId,
@@ -937,7 +938,7 @@ export class AgentHarnessRuntime {
         const workspaceId = this.getWorkspaceId(binding);
         const template = this.runtimeMemoryPolicy?.namespaces[scope] ?? `memories/${scope}s/{${scope}Id}`;
         return resolveMemoryNamespace(template, {
-            threadId: options.threadId,
+            sessionId: options.sessionId,
             agentId: options.agentId ?? binding.agent.id,
             workspaceId,
             userId: options.userId ?? "default",

package/dist/runtime/maintenance/checkpoint-maintenance.js

@@ -1,5 +1,6 @@
 import path from "node:path";
 import { fileExists } from "../../utils/fs.js";
+import { resolveRuntimeCheckpointerPath } from "../support/runtime-layout.js";
 import { getRuntimeDefaults } from "../../workspace/support/workspace-ref-utils.js";
 function asObject(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value) ? value : undefined;
@@ -52,7 +53,7 @@ function resolveSqliteCheckpointPath(binding) {
     if (kind !== "SqliteSaver") {
         return null;
     }
-    const configuredPath = typeof config.path === "string" ? String(config.path) : "checkpoints.sqlite";
+    const configuredPath = typeof config.path === "string" ? String(config.path) : resolveRuntimeCheckpointerPath(binding.harnessRuntime.runRoot, "checkpoints.sqlite");
     return path.isAbsolute(configuredPath) ? configuredPath : path.join(binding.harnessRuntime.runRoot, configuredPath);
 }
 export function discoverCheckpointMaintenanceTargets(workspace) {

package/dist/runtime/maintenance/runtime-record-maintenance.js

@@ -2,6 +2,7 @@ import path from "node:path";
 import { rm } from "node:fs/promises";
 import { createClient } from "@libsql/client";
 import { fileExists } from "../../utils/fs.js";
+import { resolveRuntimeSqlitePath } from "../support/runtime-layout.js";
 import { getRuntimeDefaults } from "../../workspace/support/workspace-ref-utils.js";
 function asObject(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value) ? value : undefined;
@@ -50,7 +51,7 @@ export function discoverRuntimeRecordMaintenanceTargets(workspace) {
         runRoots.add(binding.harnessRuntime.runRoot);
     }
     return Array.from(runRoots.values()).map((runRoot) => ({
-        dbPath: path.join(runRoot, "runtime.sqlite"),
+        dbPath: resolveRuntimeSqlitePath(runRoot),
     }));
 }
 export async function maintainSqliteRuntimeRecords(dbPath, config, nowMs = Date.now()) {

package/dist/runtime/support/llamaindex.d.ts

@@ -21,4 +21,4 @@ export type VectorStoreRuntimeLike = {
     }) => Promise<void>;
 };
 export declare function createLlamaIndexEmbeddingModel(embeddingModel: CompiledEmbeddingModel): EmbeddingRuntimeLike;
-export declare function createLlamaIndexVectorStore(workspaceRoot: string, vectorStore: CompiledVectorStore, embeddings: EmbeddingRuntimeLike): Promise<VectorStoreRuntimeLike>;
+export declare function createLlamaIndexVectorStore(dataRoot: string, vectorStore: CompiledVectorStore, embeddings: EmbeddingRuntimeLike): Promise<VectorStoreRuntimeLike>;

package/dist/runtime/support/llamaindex.js

@@ -41,8 +41,8 @@ export function createLlamaIndexEmbeddingModel(embeddingModel) {
         },
     };
 }
-export async function createLlamaIndexVectorStore(workspaceRoot, vectorStore, embeddings) {
-    const persistPath = resolveFilePath(vectorStore.url ?? ".agent/vector_store.json", workspaceRoot);
+export async function createLlamaIndexVectorStore(dataRoot, vectorStore, embeddings) {
+    const persistPath = resolveFilePath(vectorStore.url ?? "knowledge/vectors.json", dataRoot);
     await mkdir(path.dirname(persistPath), { recursive: true });
     const emptyStore = () => SimpleVectorStore.fromDict({
         embeddingDict: {},

package/dist/runtime/support/runtime-factories.js

@@ -2,15 +2,16 @@ import path from "node:path";
 import { MemorySaver } from "@langchain/langgraph";
 import { FileCheckpointSaver } from "../maintenance/file-checkpoint-saver.js";
 import { createInMemoryStore, FileBackedStore, SqliteBackedStore } from "../harness/system/store.js";
+import { resolveKnowledgeFileStorePath, resolveKnowledgeStorePath, resolveRuntimeCheckpointerPath, } from "./runtime-layout.js";
 export function createStoreForConfig(storeConfig, runRoot) {
     const kind = typeof storeConfig.kind === "string" ? storeConfig.kind : "FileStore";
     switch (kind) {
         case "FileStore": {
-            const configuredPath = typeof storeConfig.path === "string" ? storeConfig.path : "store.json";
+            const configuredPath = typeof storeConfig.path === "string" ? storeConfig.path : resolveKnowledgeFileStorePath(runRoot, "records.json");
             return new FileBackedStore(path.isAbsolute(configuredPath) ? configuredPath : path.join(runRoot, configuredPath));
         }
         case "SqliteStore": {
-            const configuredPath = typeof storeConfig.path === "string" ? storeConfig.path : "store.sqlite";
+            const configuredPath = typeof storeConfig.path === "string" ? storeConfig.path : resolveKnowledgeStorePath(runRoot, "records.sqlite");
             return new SqliteBackedStore(path.isAbsolute(configuredPath) ? configuredPath : path.join(runRoot, configuredPath));
         }
         case "InMemoryStore":
@@ -34,7 +35,9 @@ export function createCheckpointerForConfig(checkpointerConfig, runRoot) {
         case "SqliteSaver":
             throw new Error("Checkpointer kind SqliteSaver is not supported in this runtime right now");
         case "FileCheckpointer": {
-            const configuredPath = typeof checkpointerConfig.path === "string" ? String(checkpointerConfig.path) : "checkpoints.json";
+            const configuredPath = typeof checkpointerConfig.path === "string"
+                ? String(checkpointerConfig.path)
+                : resolveRuntimeCheckpointerPath(runRoot, "checkpoints.json");
             return new FileCheckpointSaver(path.isAbsolute(configuredPath) ? configuredPath : path.join(runRoot, configuredPath));
         }
         default:

package/dist/runtime/support/runtime-layout.d.ts

@@ -0,0 +1,7 @@
+export declare function resolveRuntimeRoot(dataRoot: string): string;
+export declare function resolveRuntimeArtifactsRoot(dataRoot: string): string;
+export declare function resolveRuntimeSqlitePath(dataRoot: string): string;
+export declare function resolveRuntimeCheckpointerPath(dataRoot: string, fileName?: string): string;
+export declare function resolveKnowledgeRoot(dataRoot: string): string;
+export declare function resolveKnowledgeStorePath(dataRoot: string, fileName?: string): string;
+export declare function resolveKnowledgeFileStorePath(dataRoot: string, fileName?: string): string;

package/dist/runtime/support/runtime-layout.js

@@ -0,0 +1,22 @@
+import path from "node:path";
+export function resolveRuntimeRoot(dataRoot) {
+    return path.join(dataRoot, "runtime");
+}
+export function resolveRuntimeArtifactsRoot(dataRoot) {
+    return path.join(resolveRuntimeRoot(dataRoot), "artifacts");
+}
+export function resolveRuntimeSqlitePath(dataRoot) {
+    return path.join(resolveRuntimeRoot(dataRoot), "runtime.sqlite");
+}
+export function resolveRuntimeCheckpointerPath(dataRoot, fileName = "checkpoints.json") {
+    return path.join(resolveRuntimeRoot(dataRoot), fileName);
+}
+export function resolveKnowledgeRoot(dataRoot) {
+    return path.join(dataRoot, "knowledge");
+}
+export function resolveKnowledgeStorePath(dataRoot, fileName = "records.sqlite") {
+    return path.join(resolveKnowledgeRoot(dataRoot), fileName);
+}
+export function resolveKnowledgeFileStorePath(dataRoot, fileName = "records.json") {
+    return path.join(resolveKnowledgeRoot(dataRoot), fileName);
+}

package/dist/runtime/support/vector-stores.js

@@ -5,7 +5,7 @@ import { createClient } from "@libsql/client";
 import { LibSQLVectorStore } from "@langchain/community/vectorstores/libsql";
 import { QdrantClient } from "@qdrant/js-client-rest";
 import { compileVectorStore } from "../../workspace/resource-compilers.js";
-import { resolveRefId } from "../../workspace/support/workspace-ref-utils.js";
+import { getRuntimeStorageRoots, resolveRefId } from "../../workspace/support/workspace-ref-utils.js";
 import { resolveCompiledEmbeddingModel, resolveCompiledEmbeddingModelRef } from "./embedding-models.js";
 import { createLlamaIndexVectorStore } from "./llamaindex.js";
 function resolveFileUrl(rawUrl, workspaceRoot) {
@@ -92,10 +92,11 @@ export async function resolveCompiledVectorStore(workspace, vectorStore, options
     if (options.vectorStoreResolver) {
         return options.vectorStoreResolver(vectorStore.id);
     }
+    const { dataRoot } = getRuntimeStorageRoots(workspace.refs, workspace.workspaceRoot);
     if (vectorStore.kind === "LlamaIndexSimpleVectorStore") {
         const embeddingModel = resolveCompiledEmbeddingModelRef(workspace, vectorStore.embeddingModelRef);
         const embeddings = await resolveCompiledEmbeddingModel(embeddingModel, options.embeddingModelResolver);
-        return createLlamaIndexVectorStore(workspace.workspaceRoot, vectorStore, embeddings);
+        return createLlamaIndexVectorStore(dataRoot, vectorStore, embeddings);
     }
     if (vectorStore.kind === "QdrantVectorStore") {
         const embeddingModel = resolveCompiledEmbeddingModelRef(workspace, vectorStore.embeddingModelRef);
@@ -178,7 +179,7 @@ export async function resolveCompiledVectorStore(workspace, vectorStore, options
     const embeddingModel = resolveCompiledEmbeddingModelRef(workspace, vectorStore.embeddingModelRef);
     const embeddings = await resolveCompiledEmbeddingModel(embeddingModel, options.embeddingModelResolver);
     const db = createClient({
-        url: await ensureFileUrlDirectory(vectorStore.url ?? "", workspace.workspaceRoot),
+        url: await ensureFileUrlDirectory(vectorStore.url ?? "", dataRoot),
         ...(vectorStore.authToken ? { authToken: vectorStore.authToken } : {}),
     });
     const table = vectorStore.table ?? "vectors";

package/dist/workspace/agent-binding-compiler.js

@@ -5,7 +5,7 @@ import { compileModel, compileTool } from "./resource-compilers.js";
 import { inferAgentCapabilities } from "./support/agent-capabilities.js";
 import { getAgentExecutionConfigValue, getAgentExecutionObject, getAgentExecutionString } from "./support/agent-execution-config.js";
 import { discoverSkillPaths } from "./support/discovery.js";
-import { compileAgentMemories, getResilienceConfig, getRuntimeDefaults, getRuntimeMemoryDefaults, getWorkspaceObject, resolvePromptValue, resolveRefId } from "./support/workspace-ref-utils.js";
+import { compileAgentMemories, getResilienceConfig, getRuntimeDefaults, getRuntimeMemoryDefaults, getRuntimeStorageRoots, getWorkspaceObject, resolvePromptValue, resolveRefId, } from "./support/workspace-ref-utils.js";
 const WORKSPACE_BOUNDARY_GUIDANCE = "Keep repository and file exploration bounded to the current workspace root unless the user explicitly asks for broader host or filesystem access. " +
     "Do not inspect absolute paths outside the workspace, system directories, or unrelated repos by default. " +
     "Prefer workspace-local tools, relative paths, and the current repository checkout when analyzing code.";
@@ -339,6 +339,7 @@ function resolveRuntimeMemoryConfig(agent, refs) {
 export function compileBinding(workspaceRoot, agent, agents, referencedSubagentIds, refs, models, tools) {
     const internalSubagent = referencedSubagentIds.has(agent.id);
     const runtimeDefaults = getRuntimeDefaults(refs);
+    const runtimeStorage = getRuntimeStorageRoots(refs, workspaceRoot);
     const resilience = getResilienceConfig(refs);
     const compiledAgentSkills = compileAgentSkills(workspaceRoot, agent);
     const compiledAgentMemory = compileAgentMemories(workspaceRoot, agent.memorySources);
@@ -361,15 +362,16 @@ export function compileBinding(workspaceRoot, agent, agents, referencedSubagentI
         ? mergeConfigObjects(runtimeFilesystemDefaults, getAgentExecutionObject(agent, "filesystem", { executionMode: "langchain-v1" }))
         : undefined;
     const runRoot = typeof agent.runRoot === "string" && agent.runRoot.trim().length > 0
-        ? path.resolve(workspaceRoot, agent.runRoot)
-        : typeof runtimeDefaults?.runRoot === "string" && runtimeDefaults.runRoot.trim().length > 0
-            ? path.resolve(workspaceRoot, runtimeDefaults.runRoot)
-            : path.join(workspaceRoot, "run-data");
+        ? (path.isAbsolute(agent.runRoot) ? agent.runRoot : path.resolve(runtimeStorage.dataRoot, agent.runRoot))
+        : runtimeStorage.dataRoot;
     const base = {
         agent,
         harnessRuntime: {
+            applicationRoot: runtimeStorage.applicationRoot,
+            dataRoot: runtimeStorage.dataRoot,
+            runtimeProfile: runtimeStorage.runtimeProfile,
             runRoot,
-            workspaceRoot,
+            workspaceRoot: runtimeStorage.applicationRoot,
             capabilities: inferAgentCapabilities(agent),
             resilience,
             ...(runtimeGovernanceDefaults ? { governance: runtimeGovernanceDefaults } : {}),

package/dist/workspace/compile.js

@@ -10,7 +10,7 @@ import { validateAgent, validateTopology } from "./validate.js";
 import { compileBinding } from "./agent-binding-compiler.js";
 import { discoverSubagents, ensureDiscoverySources } from "./support/discovery.js";
 import { collectAgentDiscoverySourceRefs, collectToolSourceRefs } from "./support/source-collectors.js";
-import { getRoutingDefaultAgentId, getRuntimeResources, getToolModuleDiscoveryConfig, getRoutingRules, resolveRefId, } from "./support/workspace-ref-utils.js";
+import { getRoutingDefaultAgentId, getRuntimeResources, getRuntimeStorageRoots, getToolModuleDiscoveryConfig, getRoutingRules, resolveRefId, } from "./support/workspace-ref-utils.js";
 import { hydrateAgentMcpTools, hydrateResourceAndExternalTools } from "./tool-hydration.js";
 import { traceStartupStage } from "../runtime/startup-tracing.js";
 import { shouldSkipScanDirectory } from "../utils/fs.js";
@@ -209,6 +209,11 @@ export async function loadWorkspace(workspaceRoot, options = {}) {
     const loaded = await traceStartupStage("workspace.load.objects", () => loadWorkspaceObjects(workspaceRoot, options), {
         workspaceRoot,
     });
+    const runtimeStorage = getRuntimeStorageRoots(loaded.refs, workspaceRoot);
+    if (path.resolve(runtimeStorage.applicationRoot) !== path.resolve(workspaceRoot)) {
+        throw new Error(`Runtime applicationRoot ${runtimeStorage.applicationRoot} must resolve to the loaded workspace root ${workspaceRoot}. ` +
+            "Load the shared application folder as the workspace root and use Runtime.dataRoot for writable profile data.");
+    }
     loaded.agents = await traceStartupStage("workspace.discover.subagents", () => discoverSubagents(loaded.agents, workspaceRoot), {
         workspaceRoot,
     });

package/dist/workspace/object-loader.js

@@ -516,6 +516,9 @@ export function parseAgentItem(item, sourcePath) {
         description: String(normalizedItem.description ?? ""),
         modelRef: readExecutionValue(normalizedItem, "modelRef", readSingleRef) ?? "",
         runRoot: typeof runtime?.runRoot === "string" ? runtime.runRoot : undefined,
+        applicationRoot: typeof runtime?.applicationRoot === "string" ? runtime.applicationRoot : undefined,
+        dataRoot: typeof runtime?.dataRoot === "string" ? runtime.dataRoot : undefined,
+        runtimeProfile: typeof runtime?.profile === "string" ? runtime.profile : undefined,
         toolRefs: toolBindings.map((binding) => binding.ref),
         toolBindings,
         inlineTools: undefined,

package/dist/workspace/support/workspace-ref-utils.d.ts

@@ -37,6 +37,12 @@ export type ToolModuleDiscoveryConfig = {
 };
 export declare function getWorkspaceObject(refs: Map<string, WorkspaceObject | ParsedAgentObject>, ref: string | undefined): WorkspaceObject | undefined;
 export declare function getRuntimeDefaults(refs: Map<string, WorkspaceObject | ParsedAgentObject>): Record<string, unknown> | undefined;
+export type RuntimeStorageRoots = {
+    applicationRoot: string;
+    dataRoot: string;
+    runtimeProfile: string;
+};
+export declare function getRuntimeStorageRoots(refs: Map<string, WorkspaceObject | ParsedAgentObject>, workspaceRoot: string): RuntimeStorageRoots;
 export declare function getRuntimeResources(refs: Map<string, WorkspaceObject | ParsedAgentObject>): string[];
 export declare function getToolModuleDiscoveryConfig(refs: Map<string, WorkspaceObject | ParsedAgentObject>): ToolModuleDiscoveryConfig;
 export declare function getRuntimeMemoryDefaults(refs: Map<string, WorkspaceObject | ParsedAgentObject>): Record<string, unknown> | undefined;

package/dist/workspace/support/workspace-ref-utils.js

@@ -26,6 +26,31 @@ export function getRuntimeDefaults(refs) {
     }
     return runtimes[0].value;
 }
+function asNonEmptyString(value) {
+    return typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
+}
+export function getRuntimeStorageRoots(refs, workspaceRoot) {
+    const runtimeDefaults = getRuntimeDefaults(refs);
+    const configuredApplicationRoot = asNonEmptyString(runtimeDefaults?.applicationRoot);
+    const configuredDataRoot = asNonEmptyString(runtimeDefaults?.dataRoot);
+    const configuredProfile = asNonEmptyString(runtimeDefaults?.profile);
+    const applicationRoot = configuredApplicationRoot
+        ? (path.isAbsolute(configuredApplicationRoot)
+            ? configuredApplicationRoot
+            : path.resolve(workspaceRoot, configuredApplicationRoot))
+        : workspaceRoot;
+    const dataRoot = configuredDataRoot
+        ? (path.isAbsolute(configuredDataRoot)
+            ? configuredDataRoot
+            : path.resolve(applicationRoot, configuredDataRoot))
+        : path.join(applicationRoot, ".agent");
+    const runtimeProfile = configuredProfile ?? "default";
+    return {
+        applicationRoot,
+        dataRoot,
+        runtimeProfile,
+    };
+}
 export function getRuntimeResources(refs) {
     const runtimeDefaults = getRuntimeDefaults(refs);
     if (!Array.isArray(runtimeDefaults?.resources)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botbotgo/agent-harness",
-  "version": "0.0.282",
+  "version": "0.0.284",
   "description": "Workspace runtime for multi-agent applications",
   "license": "MIT",
   "type": "module",