@botbotgo/agent-harness 0.0.282 → 0.0.283

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/catalogs/stores.yaml

@@ -8,7 +8,7 @@ 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

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:.agent/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/init-project.js

@@ -143,11 +143,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 +179,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 +189,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 +202,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 +223,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 +231,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.282";

package/dist/package-version.js

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

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

@@ -111,7 +111,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;

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/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.js

@@ -42,7 +42,7 @@ export function createLlamaIndexEmbeddingModel(embeddingModel) {
     };
 }
 export async function createLlamaIndexVectorStore(workspaceRoot, vectorStore, embeddings) {
-    const persistPath = resolveFilePath(vectorStore.url ?? ".agent/vector_store.json", workspaceRoot);
+    const persistPath = resolveFilePath(vectorStore.url ?? ".agent/knowledge/vectors.json", workspaceRoot);
     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,6 @@
+export declare function resolveRuntimeArtifactsRoot(runRoot: string): string;
+export declare function resolveRuntimeSqlitePath(runRoot: string): string;
+export declare function resolveRuntimeCheckpointerPath(runRoot: string, fileName?: string): string;
+export declare function resolveKnowledgeRoot(runRoot: string): string;
+export declare function resolveKnowledgeStorePath(runRoot: string, fileName?: string): string;
+export declare function resolveKnowledgeFileStorePath(runRoot: string, fileName?: string): string;

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

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

package/package.json

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