@xopcai/xopc 0.0.121 → 0.0.123

package/dist/src/projects/types.d.ts

@@ -0,0 +1,62 @@
+import type { PaginatedResult } from '../session/types.js';
+export type ProjectStatus = 'active' | 'paused' | 'archived';
+export interface Project {
+    id: string;
+    name: string;
+    slug: string;
+    description?: string;
+    status: ProjectStatus;
+    defaultAgentId?: string;
+    workspaceRoot?: string;
+    brief?: string;
+    instructions?: string;
+    createdAt: number;
+    updatedAt: number;
+    lastActiveAt?: number;
+}
+export interface ProjectWithDetails extends Project {
+    sessionCount: number;
+    goalCount: number;
+    activeGoalCount: number;
+    recentSessions: Array<{
+        key: string;
+        name?: string;
+        updatedAt: string;
+        agentId: string;
+    }>;
+    recentWorkflowRuns: Array<{
+        runId: string;
+        definitionId: string;
+        status: string;
+        createdAt: number;
+    }>;
+}
+export interface ProjectListQuery {
+    status?: ProjectStatus | ProjectStatus[];
+    search?: string;
+    sortBy?: 'updatedAt' | 'createdAt' | 'name';
+    sortOrder?: 'asc' | 'desc';
+    limit?: number;
+    offset?: number;
+}
+export interface CreateProjectInput {
+    name?: string;
+    slug?: string;
+    description?: string;
+    defaultAgentId?: string;
+    workspaceRoot?: string;
+    createWorkspaceRoot?: boolean;
+    brief?: string;
+    instructions?: string;
+}
+export interface UpdateProjectInput {
+    name?: string;
+    description?: string | null;
+    defaultAgentId?: string | null;
+    status?: ProjectStatus;
+    workspaceRoot?: string | null;
+    createWorkspaceRoot?: boolean;
+    brief?: string | null;
+    instructions?: string | null;
+}
+export type ProjectListResult = PaginatedResult<Project>;

package/dist/src/projects/types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/projects/workflow-bind.d.ts

@@ -0,0 +1 @@
+export declare function bindWorkflowRunToProject(runId: string, projectId: string): void;

package/dist/src/projects/workflow-bind.js

@@ -0,0 +1,16 @@
+import { getSqliteDatabase, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
+//#region src/projects/workflow-bind.ts
+function bindWorkflowRunToProject(runId, projectId) {
+	const db = getSqliteDatabase();
+	if (!db.prepare(`SELECT 1 FROM projects WHERE project_id = ?`).get(projectId)) throw new Error(`Project not found: ${projectId}`);
+	if (!db.prepare(`SELECT 1 FROM workflow_runs WHERE run_id = ?`).get(runId)) throw new Error(`Workflow run not found: ${runId}`);
+	runSqliteWriteTransaction((tx) => {
+		const now = Date.now();
+		tx.prepare(`UPDATE workflow_runs SET project_id = ? WHERE run_id = ?`).run(projectId, runId);
+		tx.prepare(`UPDATE projects SET last_active_at = ?, updated_at = ? WHERE project_id = ?`).run(now, now, projectId);
+	});
+}
+//#endregion
+export { bindWorkflowRunToProject };
+
+//# sourceMappingURL=workflow-bind.js.map

package/dist/src/projects/workflow-bind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-bind.js","names":[],"sources":["../../../src/projects/workflow-bind.ts"],"sourcesContent":["import { getSqliteDatabase, runSqliteWriteTransaction } from '../storage/sqlite/transaction.js';\n\nexport function bindWorkflowRunToProject(runId: string, projectId: string): void {\n  const db = getSqliteDatabase();\n  if (!db.prepare(`SELECT 1 FROM projects WHERE project_id = ?`).get(projectId)) throw new Error(`Project not found: ${projectId}`);\n  if (!db.prepare(`SELECT 1 FROM workflow_runs WHERE run_id = ?`).get(runId)) throw new Error(`Workflow run not found: ${runId}`);\n  runSqliteWriteTransaction((tx) => {\n    const now = Date.now();\n    tx.prepare(`UPDATE workflow_runs SET project_id = ? WHERE run_id = ?`).run(projectId, runId);\n    tx.prepare(`UPDATE projects SET last_active_at = ?, updated_at = ? WHERE project_id = ?`).run(now, now, projectId);\n  });\n}\n"],"mappings":";;AAEA,SAAgB,yBAAyB,OAAe,WAAyB;CAC/E,MAAM,KAAK,mBAAmB;AAC9B,KAAI,CAAC,GAAG,QAAQ,8CAA8C,CAAC,IAAI,UAAU,CAAE,OAAM,IAAI,MAAM,sBAAsB,YAAY;AACjI,KAAI,CAAC,GAAG,QAAQ,+CAA+C,CAAC,IAAI,MAAM,CAAE,OAAM,IAAI,MAAM,2BAA2B,QAAQ;AAC/H,4BAA2B,OAAO;EAChC,MAAM,MAAM,KAAK,KAAK;AACtB,KAAG,QAAQ,2DAA2D,CAAC,IAAI,WAAW,MAAM;AAC5F,KAAG,QAAQ,8EAA8E,CAAC,IAAI,KAAK,KAAK,UAAU;GAClH"}

package/dist/src/projects/workspace-project.d.ts

@@ -0,0 +1,22 @@
+import type { Project } from './types.js';
+export type WorkspaceProjectMatchReason = 'exact' | 'contained' | 'auto_created';
+export type WorkspaceProjectMatch = {
+    project: Project;
+    reason: WorkspaceProjectMatchReason;
+    created: boolean;
+};
+export declare class ProjectWorkspaceConflictError extends Error {
+    readonly project: Project;
+    constructor(project: Project, message?: string);
+}
+export declare class ProjectWorkspaceMissingError extends Error {
+    readonly workspaceRoot: string;
+    constructor(workspaceRoot: string, message?: string);
+}
+export declare function canonicalWorkspacePath(raw: string | null | undefined): string | null;
+export declare function workspaceDirectoryExists(workspaceRoot: string | null | undefined): boolean;
+export declare function ensureWorkspaceDirectory(workspaceRoot: string): void;
+export declare function resolveWorkspaceProjectRoot(raw: string | null | undefined): string | null;
+export declare function isPathSameOrInsideWorkspace(workspaceRoot: string, candidatePath: string): boolean;
+export declare function inferProjectNameFromWorkspaceRoot(workspaceRoot: string | null | undefined): string | null;
+export declare function isSafeAutoCreateWorkspaceRoot(workspaceRoot: string | null | undefined): boolean;

package/dist/src/projects/workspace-project.js

@@ -0,0 +1,143 @@
+import { init_paths_state, resolveStateDir } from "../config/paths-state.js";
+import { init_workspace_path, normalizeWorkspaceDir } from "../config/workspace-path.js";
+import { init_agent_scope, resolveUserPath } from "../agent/agent-scope.js";
+import { homedir, tmpdir } from "node:os";
+import { basename, dirname, isAbsolute, join, parse, relative, resolve } from "node:path";
+import { existsSync, mkdirSync, realpathSync, statSync } from "node:fs";
+import { execFileSync } from "node:child_process";
+//#region src/projects/workspace-project.ts
+init_agent_scope();
+init_workspace_path();
+init_paths_state();
+var ProjectWorkspaceConflictError = class extends Error {
+	constructor(project, message = `Workspace is already bound to project: ${project.name}`) {
+		super(message);
+		this.project = project;
+		this.name = "ProjectWorkspaceConflictError";
+	}
+};
+var ProjectWorkspaceMissingError = class extends Error {
+	constructor(workspaceRoot, message = `Workspace root does not exist: ${workspaceRoot}`) {
+		super(message);
+		this.workspaceRoot = workspaceRoot;
+		this.name = "ProjectWorkspaceMissingError";
+	}
+};
+const PROJECT_ROOT_MARKERS = [
+	".git",
+	"pnpm-workspace.yaml",
+	"package.json",
+	"go.mod",
+	"pyproject.toml",
+	"Cargo.toml",
+	"deno.json",
+	"deno.jsonc",
+	"bun.lockb",
+	"pnpm-lock.yaml",
+	"yarn.lock",
+	"package-lock.json",
+	"composer.json",
+	"Gemfile"
+];
+function canonicalWorkspacePath(raw) {
+	const trimmed = raw?.trim();
+	if (!trimmed) return null;
+	const normalized = normalizeWorkspaceDir(resolveUserPath(trimmed));
+	if (!normalized) return null;
+	try {
+		if (!statSync(normalized).isDirectory()) return normalized;
+		return realpathSync.native(normalized);
+	} catch {
+		return normalized;
+	}
+}
+function workspaceDirectoryExists(workspaceRoot) {
+	const canonical = canonicalWorkspacePath(workspaceRoot);
+	if (!canonical) return false;
+	try {
+		return statSync(canonical).isDirectory();
+	} catch {
+		return false;
+	}
+}
+function ensureWorkspaceDirectory(workspaceRoot) {
+	mkdirSync(workspaceRoot, { recursive: true });
+}
+function directoryForWorkspaceProbe(pathValue) {
+	try {
+		return statSync(pathValue).isDirectory() ? pathValue : dirname(pathValue);
+	} catch {
+		return pathValue;
+	}
+}
+function findGitRoot(startDir) {
+	try {
+		return canonicalWorkspacePath(execFileSync("git", [
+			"-C",
+			startDir,
+			"rev-parse",
+			"--show-toplevel"
+		], {
+			encoding: "utf8",
+			stdio: [
+				"ignore",
+				"pipe",
+				"ignore"
+			],
+			timeout: 1e3
+		}).trim());
+	} catch {
+		return null;
+	}
+}
+function findMarkerRoot(startDir) {
+	let current = startDir;
+	while (true) {
+		if (PROJECT_ROOT_MARKERS.some((marker) => existsSync(join(current, marker)))) return current;
+		const parent = dirname(current);
+		if (parent === current) return null;
+		current = parent;
+	}
+}
+function resolveWorkspaceProjectRoot(raw) {
+	const canonical = canonicalWorkspacePath(raw);
+	if (!canonical) return null;
+	const startDir = directoryForWorkspaceProbe(canonical);
+	const gitRoot = findGitRoot(startDir);
+	if (gitRoot) return gitRoot;
+	return canonicalWorkspacePath(findMarkerRoot(startDir)) ?? canonical;
+}
+function normalizeComparablePath(pathValue) {
+	const resolved = resolve(pathValue);
+	return process.platform === "win32" ? resolved.toLowerCase() : resolved;
+}
+function isPathSameOrInsideWorkspace(workspaceRoot, candidatePath) {
+	const rel = relative(normalizeComparablePath(workspaceRoot), normalizeComparablePath(candidatePath));
+	return rel === "" || !!rel && !rel.startsWith("..") && !isAbsolute(rel);
+}
+function inferProjectNameFromWorkspaceRoot(workspaceRoot) {
+	const canonical = canonicalWorkspacePath(workspaceRoot);
+	if (!canonical) return null;
+	return basename(canonical).trim() || null;
+}
+function isSafeAutoCreateWorkspaceRoot(workspaceRoot) {
+	const canonical = canonicalWorkspacePath(workspaceRoot);
+	if (!canonical) return false;
+	const normalized = normalizeComparablePath(canonical);
+	if ([
+		homedir(),
+		tmpdir(),
+		resolveStateDir()
+	].map((p) => canonicalWorkspacePath(p)).filter((p) => Boolean(p)).map(normalizeComparablePath).includes(normalized)) return false;
+	if (normalizeComparablePath(canonical) === normalizeComparablePath(parse(canonical).root)) return false;
+	if (!basename(canonical).trim()) return false;
+	try {
+		return statSync(canonical).isDirectory();
+	} catch {
+		return false;
+	}
+}
+//#endregion
+export { ProjectWorkspaceConflictError, ProjectWorkspaceMissingError, canonicalWorkspacePath, ensureWorkspaceDirectory, inferProjectNameFromWorkspaceRoot, isPathSameOrInsideWorkspace, isSafeAutoCreateWorkspaceRoot, resolveWorkspaceProjectRoot, workspaceDirectoryExists };
+
+//# sourceMappingURL=workspace-project.js.map

package/dist/src/projects/workspace-project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-project.js","names":[],"sources":["../../../src/projects/workspace-project.ts"],"sourcesContent":["import { existsSync, mkdirSync, realpathSync, statSync } from 'node:fs';\nimport { execFileSync } from 'node:child_process';\nimport { homedir, tmpdir } from 'node:os';\nimport { basename, dirname, isAbsolute, join, parse, relative, resolve } from 'node:path';\n\nimport { resolveUserPath } from '../agent/agent-scope.js';\nimport { normalizeWorkspaceDir } from '../config/workspace-path.js';\nimport { resolveStateDir } from '../config/paths-state.js';\nimport type { Project } from './types.js';\n\nexport type WorkspaceProjectMatchReason = 'exact' | 'contained' | 'auto_created';\n\nexport type WorkspaceProjectMatch = {\n  project: Project;\n  reason: WorkspaceProjectMatchReason;\n  created: boolean;\n};\n\nexport class ProjectWorkspaceConflictError extends Error {\n  constructor(readonly project: Project, message = `Workspace is already bound to project: ${project.name}`) {\n    super(message);\n    this.name = 'ProjectWorkspaceConflictError';\n  }\n}\n\nexport class ProjectWorkspaceMissingError extends Error {\n  constructor(readonly workspaceRoot: string, message = `Workspace root does not exist: ${workspaceRoot}`) {\n    super(message);\n    this.name = 'ProjectWorkspaceMissingError';\n  }\n}\n\nconst PROJECT_ROOT_MARKERS = [\n  '.git',\n  'pnpm-workspace.yaml',\n  'package.json',\n  'go.mod',\n  'pyproject.toml',\n  'Cargo.toml',\n  'deno.json',\n  'deno.jsonc',\n  'bun.lockb',\n  'pnpm-lock.yaml',\n  'yarn.lock',\n  'package-lock.json',\n  'composer.json',\n  'Gemfile',\n] as const;\n\nexport function canonicalWorkspacePath(raw: string | null | undefined): string | null {\n  const trimmed = raw?.trim();\n  if (!trimmed) return null;\n  const resolved = resolveUserPath(trimmed);\n  const normalized = normalizeWorkspaceDir(resolved);\n  if (!normalized) return null;\n  try {\n    const stat = statSync(normalized);\n    if (!stat.isDirectory()) return normalized;\n    return realpathSync.native(normalized);\n  } catch {\n    return normalized;\n  }\n}\n\nexport function workspaceDirectoryExists(workspaceRoot: string | null | undefined): boolean {\n  const canonical = canonicalWorkspacePath(workspaceRoot);\n  if (!canonical) return false;\n  try {\n    return statSync(canonical).isDirectory();\n  } catch {\n    return false;\n  }\n}\n\nexport function ensureWorkspaceDirectory(workspaceRoot: string): void {\n  mkdirSync(workspaceRoot, { recursive: true });\n}\n\nfunction directoryForWorkspaceProbe(pathValue: string): string {\n  try {\n    return statSync(pathValue).isDirectory() ? pathValue : dirname(pathValue);\n  } catch {\n    return pathValue;\n  }\n}\n\nfunction findGitRoot(startDir: string): string | null {\n  try {\n    const output = execFileSync('git', ['-C', startDir, 'rev-parse', '--show-toplevel'], {\n      encoding: 'utf8',\n      stdio: ['ignore', 'pipe', 'ignore'],\n      timeout: 1000,\n    }).trim();\n    return canonicalWorkspacePath(output);\n  } catch {\n    return null;\n  }\n}\n\nfunction findMarkerRoot(startDir: string): string | null {\n  let current = startDir;\n  while (true) {\n    if (PROJECT_ROOT_MARKERS.some((marker) => existsSync(join(current, marker)))) {\n      return current;\n    }\n    const parent = dirname(current);\n    if (parent === current) {\n      return null;\n    }\n    current = parent;\n  }\n}\n\nexport function resolveWorkspaceProjectRoot(raw: string | null | undefined): string | null {\n  const canonical = canonicalWorkspacePath(raw);\n  if (!canonical) return null;\n  const startDir = directoryForWorkspaceProbe(canonical);\n  const gitRoot = findGitRoot(startDir);\n  if (gitRoot) return gitRoot;\n  const markerRoot = findMarkerRoot(startDir);\n  return canonicalWorkspacePath(markerRoot) ?? canonical;\n}\n\nfunction normalizeComparablePath(pathValue: string): string {\n  const resolved = resolve(pathValue);\n  return process.platform === 'win32' ? resolved.toLowerCase() : resolved;\n}\n\nexport function isPathSameOrInsideWorkspace(workspaceRoot: string, candidatePath: string): boolean {\n  const root = normalizeComparablePath(workspaceRoot);\n  const candidate = normalizeComparablePath(candidatePath);\n  const rel = relative(root, candidate);\n  return rel === '' || (!!rel && !rel.startsWith('..') && !isAbsolute(rel));\n}\n\nexport function inferProjectNameFromWorkspaceRoot(workspaceRoot: string | null | undefined): string | null {\n  const canonical = canonicalWorkspacePath(workspaceRoot);\n  if (!canonical) return null;\n  const name = basename(canonical).trim();\n  return name || null;\n}\n\nexport function isSafeAutoCreateWorkspaceRoot(workspaceRoot: string | null | undefined): boolean {\n  const canonical = canonicalWorkspacePath(workspaceRoot);\n  if (!canonical) return false;\n  const normalized = normalizeComparablePath(canonical);\n  const forbidden = [homedir(), tmpdir(), resolveStateDir()]\n    .map((p) => canonicalWorkspacePath(p))\n    .filter((p): p is string => Boolean(p))\n    .map(normalizeComparablePath);\n  if (forbidden.includes(normalized)) return false;\n  // `normalizeWorkspaceDir` already rejects filesystem roots; keep this function\n  // conservative for callers that pass unusual platform-specific roots.\n  if (normalizeComparablePath(canonical) === normalizeComparablePath(parse(canonical).root)) return false;\n  if (!basename(canonical).trim()) return false;\n  try {\n    return statSync(canonical).isDirectory();\n  } catch {\n    return false;\n  }\n}\n"],"mappings":"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"}

package/dist/src/projects/workspace.d.ts

@@ -0,0 +1,5 @@
+import type { Config } from '../config/schema.js';
+import type { Project } from './types.js';
+export declare function resolveProjectWorkspacePath(config: Config, sessionKey: string, project: Project | null): string;
+export declare function getProjectForSession(sessionKey: string): Project | null;
+export declare function getProjectWorkspacePathForSession(sessionKey: string): string | null;

package/dist/src/projects/workspace.js

@@ -0,0 +1,25 @@
+import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
+import { isXopcDatabaseOpen } from "../storage/sqlite/connection.js";
+import { getSessionMetadata } from "../storage/sqlite/session-repository.js";
+import "../storage/sqlite/index.js";
+import { projectWorkspacePath } from "../session/session-workspace.js";
+import { ProjectStore } from "./project-store.js";
+//#region src/projects/workspace.ts
+function resolveProjectWorkspacePath(config, sessionKey, project) {
+	const projectWorkspace = projectWorkspacePath(project);
+	if (projectWorkspace) return projectWorkspace;
+	return resolveEffectiveAgentProfileForSession(config, sessionKey).resolvedWorkspacePath;
+}
+function getProjectForSession(sessionKey) {
+	if (!isXopcDatabaseOpen()) return null;
+	const projectId = getSessionMetadata(sessionKey)?.projectId;
+	if (!projectId) return null;
+	return new ProjectStore().get(projectId);
+}
+function getProjectWorkspacePathForSession(sessionKey) {
+	return projectWorkspacePath(getProjectForSession(sessionKey));
+}
+//#endregion
+export { getProjectForSession, getProjectWorkspacePathForSession, resolveProjectWorkspacePath };
+
+//# sourceMappingURL=workspace.js.map

package/dist/src/projects/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","names":[],"sources":["../../../src/projects/workspace.ts"],"sourcesContent":["import { resolveEffectiveAgentProfileForSession } from '../config/agent-profile.js';\nimport type { Config } from '../config/schema.js';\nimport {\n  getSessionMetadata,\n  isXopcDatabaseOpen,\n} from '../storage/sqlite/index.js';\nimport { projectWorkspacePath } from '../session/session-workspace.js';\nimport { ProjectStore } from './project-store.js';\nimport type { Project } from './types.js';\n\nexport function resolveProjectWorkspacePath(\n  config: Config,\n  sessionKey: string,\n  project: Project | null,\n): string {\n  const projectWorkspace = projectWorkspacePath(project);\n  if (projectWorkspace) {\n    return projectWorkspace;\n  }\n  return resolveEffectiveAgentProfileForSession(config, sessionKey).resolvedWorkspacePath;\n}\n\nexport function getProjectForSession(sessionKey: string): Project | null {\n  if (!isXopcDatabaseOpen()) {\n    return null;\n  }\n  const projectId = getSessionMetadata(sessionKey)?.projectId;\n  if (!projectId) {\n    return null;\n  }\n  return new ProjectStore().get(projectId);\n}\n\nexport function getProjectWorkspacePathForSession(sessionKey: string): string | null {\n  return projectWorkspacePath(getProjectForSession(sessionKey));\n}\n"],"mappings":";;;;;;;AAUA,SAAgB,4BACd,QACA,YACA,SACQ;CACR,MAAM,mBAAmB,qBAAqB,QAAQ;AACtD,KAAI,iBACF,QAAO;AAET,QAAO,uCAAuC,QAAQ,WAAW,CAAC;;AAGpE,SAAgB,qBAAqB,YAAoC;AACvE,KAAI,CAAC,oBAAoB,CACvB,QAAO;CAET,MAAM,YAAY,mBAAmB,WAAW,EAAE;AAClD,KAAI,CAAC,UACH,QAAO;AAET,QAAO,IAAI,cAAc,CAAC,IAAI,UAAU;;AAG1C,SAAgB,kCAAkC,YAAmC;AACnF,QAAO,qBAAqB,qBAAqB,WAAW,CAAC"}

package/dist/src/session/index.d.ts

@@ -5,7 +5,7 @@ export type { SessionStoreOptions } from './store.js';
 export { SessionConfigStore, resolveThinkingLevel, resolveReasoningLevel, resolveVerboseLevel } from './config-store.js';
 export { resolveEffectiveThinkingLevel, resolveEffectiveReasoningLevel } from './thinking-resolve.js';
 export type { SessionAgentConfig } from './config-types.js';
-export { normalizeWorkingDirectoryInput, effectiveWorkspacePathForSession, } from './session-workspace.js';
+export { normalizeWorkingDirectoryInput, effectiveWorkspacePathForSession, projectWorkspacePath, } from './session-workspace.js';
 export { SessionStatus, type SessionMetadata, type SessionDetail, type SessionListQuery, type PaginatedResult, type SessionStats, type ExportFormat, type SessionExport, type SessionTranscriptSummary, type CompactionCheckpointSummary, type CompactionCheckpointDetail, } from './types.js';
 export { normalizeCompactionCheckpointId } from './compaction-checkpoints.js';
 export { shouldSkipWebchatInboundByAbortCutoff } from './abort-cutoff.js';

package/dist/src/session/index.js

@@ -1,6 +1,7 @@
-import { emitSessionTranscriptUpdate, onSessionTranscriptUpdate } from "./transcript-events.js";
 import { SessionStatus } from "./types.js";
 import { buildSessionContextForLlm, isTranscriptContextEntry, mergeLlmMessagesPreservingContextRows, transcriptRowsFromJsonArray } from "./session-context-for-llm.js";
+import { effectiveWorkspacePathForSession, normalizeWorkingDirectoryInput, projectWorkspacePath } from "./session-workspace.js";
+import { emitSessionTranscriptUpdate, onSessionTranscriptUpdate } from "./transcript-events.js";
 import { fallbackTitleFromMessages, generateSessionTitleFromMessages, getSessionTitleSource, isWebchatSessionKey, maybeRefineSessionTitleWithLlm, maybeSetProvisionalSessionTitle, provisionalTitleFromUserText, sanitizeSessionTitle, shouldAutoTitleSessionKey, shouldRefineSessionTitleWithLlm } from "./session-title.js";
 import { normalizeCompactionCheckpointId } from "./compaction-checkpoints.js";
 import { SessionStore } from "./store.js";
@@ -8,7 +9,6 @@ import { applySessionPatchToMetadata } from "./patch-metadata.js";
 import { SessionIndex } from "./manager.js";
 import { SessionConfigStore, resolveReasoningLevel, resolveThinkingLevel, resolveVerboseLevel } from "./config-store.js";
 import { resolveEffectiveReasoningLevel, resolveEffectiveThinkingLevel } from "./thinking-resolve.js";
-import { effectiveWorkspacePathForSession, normalizeWorkingDirectoryInput } from "./session-workspace.js";
 import { shouldSkipWebchatInboundByAbortCutoff } from "./abort-cutoff.js";
 import { DEFAULT_IDLE_MINUTES, DEFAULT_RESET_AT_HOUR, DEFAULT_RESET_MODE, evaluateSessionFreshness, resolveDailyResetAtMs, resolveSessionResetPolicy } from "./reset-policy.js";
 import { resolveChannelResetConfig, resolveSessionResetType } from "./reset-type.js";
@@ -18,4 +18,4 @@ import { DEFAULT_RESET_TRIGGERS, RESET_OVERLAP_COMMANDS, bareResetAckMessage, ma
 import { initSessionTurn } from "./init-session-turn.js";
 import { flattenMessageContent, messagesToClientHistory } from "./client-history.js";
 import { CURRENT_SESSION_TRANSCRIPT_VERSION, XOPC_SESSION_TRANSCRIPT_TYPE } from "./transcript-format.js";
-export { CURRENT_SESSION_TRANSCRIPT_VERSION, DEFAULT_IDLE_MINUTES, DEFAULT_RESET_AT_HOUR, DEFAULT_RESET_MODE, DEFAULT_RESET_TRIGGERS, RESET_OVERLAP_COMMANDS, SessionConfigStore, SessionIndex, SessionStatus, SessionStore, XOPC_SESSION_TRANSCRIPT_TYPE, applySessionPatchToMetadata, bareResetAckMessage, buildSessionContextForLlm, effectiveWorkspacePathForSession, emitSessionTranscriptUpdate, evaluateSessionFreshness, fallbackTitleFromMessages, flattenMessageContent, generateSessionTitleFromMessages, getSessionTitleSource, initSessionTurn, isTranscriptContextEntry, isWebchatSessionKey, matchResetTriggers, maybeRefineSessionTitleWithLlm, maybeSetProvisionalSessionTitle, mergeLlmMessagesPreservingContextRows, messagesToClientHistory, normalizeCompactionCheckpointId, normalizeWorkingDirectoryInput, onSessionTranscriptUpdate, provisionalTitleFromUserText, resolveChannelResetConfig, resolveDailyResetAtMs, resolveEffectiveReasoningLevel, resolveEffectiveThinkingLevel, resolveReasoningLevel, resolveResetTriggers, resolveSession, resolveSessionKeyForRequest, resolveSessionLifecycleTimestamps, resolveSessionResetPolicy, resolveSessionResetType, resolveThinkingLevel, resolveVerboseLevel, sanitizeSessionTitle, shouldAutoTitleSessionKey, shouldRefineSessionTitleWithLlm, shouldSkipResetOverlapCommand, shouldSkipWebchatInboundByAbortCutoff, stripLeadingEnvelopeTimestamp, transcriptRowsFromJsonArray };
+export { CURRENT_SESSION_TRANSCRIPT_VERSION, DEFAULT_IDLE_MINUTES, DEFAULT_RESET_AT_HOUR, DEFAULT_RESET_MODE, DEFAULT_RESET_TRIGGERS, RESET_OVERLAP_COMMANDS, SessionConfigStore, SessionIndex, SessionStatus, SessionStore, XOPC_SESSION_TRANSCRIPT_TYPE, applySessionPatchToMetadata, bareResetAckMessage, buildSessionContextForLlm, effectiveWorkspacePathForSession, emitSessionTranscriptUpdate, evaluateSessionFreshness, fallbackTitleFromMessages, flattenMessageContent, generateSessionTitleFromMessages, getSessionTitleSource, initSessionTurn, isTranscriptContextEntry, isWebchatSessionKey, matchResetTriggers, maybeRefineSessionTitleWithLlm, maybeSetProvisionalSessionTitle, mergeLlmMessagesPreservingContextRows, messagesToClientHistory, normalizeCompactionCheckpointId, normalizeWorkingDirectoryInput, onSessionTranscriptUpdate, projectWorkspacePath, provisionalTitleFromUserText, resolveChannelResetConfig, resolveDailyResetAtMs, resolveEffectiveReasoningLevel, resolveEffectiveThinkingLevel, resolveReasoningLevel, resolveResetTriggers, resolveSession, resolveSessionKeyForRequest, resolveSessionLifecycleTimestamps, resolveSessionResetPolicy, resolveSessionResetType, resolveThinkingLevel, resolveVerboseLevel, sanitizeSessionTitle, shouldAutoTitleSessionKey, shouldRefineSessionTitleWithLlm, shouldSkipResetOverlapCommand, shouldSkipWebchatInboundByAbortCutoff, stripLeadingEnvelopeTimestamp, transcriptRowsFromJsonArray };

package/dist/src/session/session-workspace.d.ts

@@ -2,6 +2,7 @@
  * Per-session markdown workspace override (stored in SessionAgentConfig).
  */
 import type { Config } from '../config/schema.js';
+import type { Project } from '../projects/types.js';
 import type { SessionAgentConfig } from './config-types.js';
 /**
  * Normalize user input for `workingDirectoryOverride`. Rejects empty and filesystem roots.
@@ -13,7 +14,8 @@ export declare function normalizeWorkingDirectoryInput(raw: string): {
     ok: false;
     error: string;
 };
+export declare function projectWorkspacePath(project: Pick<Project, 'workspaceRoot'> | null | undefined): string | null;
 /**
- * Resolved markdown workspace for tools/shell: session override or merged agent profile default.
+ * Resolved markdown workspace for tools/shell: project workspace, session override, or merged agent profile default.
  */
-export declare function effectiveWorkspacePathForSession(cfg: Config, sessionKey: string, sessionAgentConfig: SessionAgentConfig | null | undefined): string;
+export declare function effectiveWorkspacePathForSession(cfg: Config, sessionKey: string, sessionAgentConfig: SessionAgentConfig | null | undefined, project?: Pick<Project, 'workspaceRoot'> | null): string;

package/dist/src/session/session-workspace.js

@@ -23,16 +23,23 @@ function normalizeWorkingDirectoryInput(raw) {
 		path: normalized
 	};
 }
+function projectWorkspacePath(project) {
+	const raw = project?.workspaceRoot?.trim();
+	if (!raw) return null;
+	return normalizeWorkspaceDir(resolveUserPath(raw));
+}
 /**
-* Resolved markdown workspace for tools/shell: session override or merged agent profile default.
+* Resolved markdown workspace for tools/shell: project workspace, session override, or merged agent profile default.
 */
-function effectiveWorkspacePathForSession(cfg, sessionKey, sessionAgentConfig) {
+function effectiveWorkspacePathForSession(cfg, sessionKey, sessionAgentConfig, project) {
 	const base = resolveEffectiveAgentProfileForSession(cfg, sessionKey).resolvedWorkspacePath;
+	const projectWorkspace = projectWorkspacePath(project);
+	if (projectWorkspace) return projectWorkspace;
 	const o = sessionAgentConfig?.workingDirectoryOverride?.trim();
 	if (!o) return base;
 	return normalizeWorkspaceDir(resolveUserPath(o)) ?? base;
 }
 //#endregion
-export { effectiveWorkspacePathForSession, normalizeWorkingDirectoryInput };
+export { effectiveWorkspacePathForSession, normalizeWorkingDirectoryInput, projectWorkspacePath };
 
 //# sourceMappingURL=session-workspace.js.map

package/dist/src/session/session-workspace.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-workspace.js","names":[],"sources":["../../../src/session/session-workspace.ts"],"sourcesContent":["/**\n * Per-session markdown workspace override (stored in SessionAgentConfig).\n */\n\nimport type { Config } from '../config/schema.js';\nimport { resolveEffectiveAgentProfileForSession } from '../config/agent-profile.js';\nimport { resolveUserPath } from '../agent/agent-scope.js';\nimport { normalizeWorkspaceDir } from '../config/workspace-path.js';\nimport type { SessionAgentConfig } from './config-types.js';\n\n/**\n * Normalize user input for `workingDirectoryOverride`. Rejects empty and filesystem roots.\n */\nexport function normalizeWorkingDirectoryInput(raw: string): { ok: true; path: string } | { ok: false; error: string } {\n  const trimmed = raw.trim();\n  if (!trimmed) {\n    return { ok: false, error: 'working directory is empty' };\n  }\n  const resolved = resolveUserPath(trimmed);\n  const normalized = normalizeWorkspaceDir(resolved);\n  if (!normalized) {\n    return { ok: false, error: 'invalid working directory path' };\n  }\n  return { ok: true, path: normalized };\n}\n\n/**\n * Resolved markdown workspace for tools/shell: session override or merged agent profile default.\n */\nexport function effectiveWorkspacePathForSession(\n  cfg: Config,\n  sessionKey: string,\n  sessionAgentConfig: SessionAgentConfig | null | undefined,\n): string {\n  const base = resolveEffectiveAgentProfileForSession(cfg, sessionKey).resolvedWorkspacePath;\n  const o = sessionAgentConfig?.workingDirectoryOverride?.trim();\n  if (!o) {\n    return base;\n  }\n  const resolved = resolveUserPath(o);\n  const normalized = normalizeWorkspaceDir(resolved);\n  return normalized ?? base;\n}\n"],"mappings":";;;;kBAM0D;qBACU;;;;AAMpE,SAAgB,+BAA+B,KAAwE;CACrH,MAAM,UAAU,IAAI,MAAM;AAC1B,KAAI,CAAC,QACH,QAAO;EAAE,IAAI;EAAO,OAAO;EAA8B;CAG3D,MAAM,aAAa,sBADF,gBAAgB,QACgB,CAAC;AAClD,KAAI,CAAC,WACH,QAAO;EAAE,IAAI;EAAO,OAAO;EAAkC;AAE/D,QAAO;EAAE,IAAI;EAAM,MAAM;EAAY;;;;;AAMvC,SAAgB,iCACd,KACA,YACA,oBACQ;CACR,MAAM,OAAO,uCAAuC,KAAK,WAAW,CAAC;CACrE,MAAM,IAAI,oBAAoB,0BAA0B,MAAM;AAC9D,KAAI,CAAC,EACH,QAAO;AAIT,QADmB,sBADF,gBAAgB,EACgB,CAChC,IAAI"}
+{"version":3,"file":"session-workspace.js","names":[],"sources":["../../../src/session/session-workspace.ts"],"sourcesContent":["/**\n * Per-session markdown workspace override (stored in SessionAgentConfig).\n */\n\nimport type { Config } from '../config/schema.js';\nimport { resolveEffectiveAgentProfileForSession } from '../config/agent-profile.js';\nimport { resolveUserPath } from '../agent/agent-scope.js';\nimport { normalizeWorkspaceDir } from '../config/workspace-path.js';\nimport type { Project } from '../projects/types.js';\nimport type { SessionAgentConfig } from './config-types.js';\n\n/**\n * Normalize user input for `workingDirectoryOverride`. Rejects empty and filesystem roots.\n */\nexport function normalizeWorkingDirectoryInput(raw: string): { ok: true; path: string } | { ok: false; error: string } {\n  const trimmed = raw.trim();\n  if (!trimmed) {\n    return { ok: false, error: 'working directory is empty' };\n  }\n  const resolved = resolveUserPath(trimmed);\n  const normalized = normalizeWorkspaceDir(resolved);\n  if (!normalized) {\n    return { ok: false, error: 'invalid working directory path' };\n  }\n  return { ok: true, path: normalized };\n}\n\nexport function projectWorkspacePath(\n  project: Pick<Project, 'workspaceRoot'> | null | undefined,\n): string | null {\n  const raw = project?.workspaceRoot?.trim();\n  if (!raw) return null;\n  const resolved = resolveUserPath(raw);\n  return normalizeWorkspaceDir(resolved);\n}\n\n/**\n * Resolved markdown workspace for tools/shell: project workspace, session override, or merged agent profile default.\n */\nexport function effectiveWorkspacePathForSession(\n  cfg: Config,\n  sessionKey: string,\n  sessionAgentConfig: SessionAgentConfig | null | undefined,\n  project?: Pick<Project, 'workspaceRoot'> | null,\n): string {\n  const base = resolveEffectiveAgentProfileForSession(cfg, sessionKey).resolvedWorkspacePath;\n  const projectWorkspace = projectWorkspacePath(project);\n  if (projectWorkspace) {\n    return projectWorkspace;\n  }\n  const o = sessionAgentConfig?.workingDirectoryOverride?.trim();\n  if (!o) {\n    return base;\n  }\n  const resolved = resolveUserPath(o);\n  const normalized = normalizeWorkspaceDir(resolved);\n  return normalized ?? base;\n}\n"],"mappings":";;;;kBAM0D;qBACU;;;;AAOpE,SAAgB,+BAA+B,KAAwE;CACrH,MAAM,UAAU,IAAI,MAAM;AAC1B,KAAI,CAAC,QACH,QAAO;EAAE,IAAI;EAAO,OAAO;EAA8B;CAG3D,MAAM,aAAa,sBADF,gBAAgB,QACgB,CAAC;AAClD,KAAI,CAAC,WACH,QAAO;EAAE,IAAI;EAAO,OAAO;EAAkC;AAE/D,QAAO;EAAE,IAAI;EAAM,MAAM;EAAY;;AAGvC,SAAgB,qBACd,SACe;CACf,MAAM,MAAM,SAAS,eAAe,MAAM;AAC1C,KAAI,CAAC,IAAK,QAAO;AAEjB,QAAO,sBADU,gBAAgB,IACI,CAAC;;;;;AAMxC,SAAgB,iCACd,KACA,YACA,oBACA,SACQ;CACR,MAAM,OAAO,uCAAuC,KAAK,WAAW,CAAC;CACrE,MAAM,mBAAmB,qBAAqB,QAAQ;AACtD,KAAI,iBACF,QAAO;CAET,MAAM,IAAI,oBAAoB,0BAA0B,MAAM;AAC9D,KAAI,CAAC,EACH,QAAO;AAIT,QADmB,sBADF,gBAAgB,EACgB,CAChC,IAAI"}

package/dist/src/session/types.d.ts

@@ -93,6 +93,8 @@ export interface SessionMetadata {
     sourceChannel: string;
     sourceChatId: string;
     customData?: Record<string, unknown>;
+    /** Optional project grouping for sessions, goals, workflows, and related context. */
+    projectId?: string;
     /** Routing metadata */
     routing?: SessionRoutingMeta;
     /** Session statistics */
@@ -147,6 +149,7 @@ export interface SessionListQuery {
     search?: string;
     sessionTypes?: SessionType[];
     includeHidden?: boolean;
+    projectId?: string;
     sortBy?: 'updatedAt' | 'createdAt' | 'messageCount' | 'lastAccessedAt';
     sortOrder?: 'asc' | 'desc';
     limit?: number;

package/dist/src/session/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../../../src/session/types.ts"],"sourcesContent":["// Session management types\n\nimport type { TranscriptStoredRow } from './session-context-for-llm.js';\n\nexport interface Message {\n  role: 'system' | 'user' | 'assistant' | 'tool' | 'toolResult';\n  /** Plain string or structured content blocks (tool calls, multimodal). */\n  content: string | unknown[];\n  timestamp?: string;\n  tool_call_id?: string;\n  tool_calls?: Array<{\n    id: string;\n    type: 'function';\n    function: {\n      name: string;\n      arguments: string;\n    };\n  }>;\n  tool_call_id$?: string;\n  toolName?: string;\n  isError?: boolean;\n  name?: string;\n  /** Token usage from the LLM response (assistant messages only). */\n  usage?: {\n    inputTokens?: number;\n    outputTokens?: number;\n    cacheReadTokens?: number;\n    cacheWriteTokens?: number;\n    totalTokens?: number;\n  };\n  /** Inbound attachment metadata (no base64). */\n  media?: Array<{\n    id: string;\n    bucket: string;\n    type: string;\n    mimeType: string;\n    name: string;\n    size: number;\n    uri: string;\n    path: string;\n  }>;\n}\n\n/** Session status enum */\nexport enum SessionStatus {\n  ACTIVE = 'active',\n  IDLE = 'idle',\n  ARCHIVED = 'archived',\n  PINNED = 'pinned',\n}\n\n/** Session routing metadata */\nexport interface SessionRoutingMeta {\n  agentId: string;\n  source: string;\n  accountId: string;\n  peerKind: string;\n  peerId: string;\n  threadId?: string;\n  scopeId?: string;\n  mainSessionKey?: string;\n  lastRoutePolicy?: 'main' | 'session';\n}\n\n/** Session-level statistics (per session) */\nexport interface SessionStats {\n  messageCount: number;\n  tokenCount: number;\n  turnCount?: number;\n  lastTurnAt?: number;\n}\n\n/** Global session statistics (aggregate) */\nexport interface GlobalSessionStats {\n  totalSessions: number;\n  activeSessions: number;\n  archivedSessions: number;\n  pinnedSessions: number;\n  totalMessages: number;\n  totalTokens: number;\n  oldestSession?: string;\n  newestSession?: string;\n  byChannel: Record<string, number>;\n}\n\nexport type SessionType = 'chat' | 'workflow-run' | 'workflow-subagent' | 'cron' | 'heartbeat';\n\n/** Session metadata (stored in index) */\nexport interface SessionMetadata {\n  key: string;\n  name?: string;\n  status: SessionStatus;\n  tags: string[];\n  createdAt: string;\n  updatedAt: string;\n  lastAccessedAt: string;\n  messageCount: number;\n  estimatedTokens: number;\n  compactedCount: number;\n  lastFlushedAt?: string;\n  flushCount?: number;\n  sourceChannel: string;\n  sourceChatId: string;\n  customData?: Record<string, unknown>;\n  /** Routing metadata */\n  routing?: SessionRoutingMeta;\n  /** Session statistics */\n  stats?: SessionStats;\n  /**\n   * High-level origin for filtering/UI (e.g. `cron`, `heartbeat`, `webchat`).\n   * Distinct from `sourceChannel` (routing namespace).\n   */\n  sessionType: SessionType;\n  hiddenFromSessionList?: boolean;\n  parentSessionKey?: string;\n  workflowRunId?: string;\n  workflowDefinitionId?: string;\n  workflowAgentId?: string;\n  workflowAgentLabel?: string;\n  /** Active OpenClaw-style session instance id. Rotates on reset while `key` stays stable. */\n  sessionId?: string;\n  /** Workspace/cwd recorded for the active transcript. */\n  cwd?: string;\n  /** First activity time for this session row (ISO), from transcript header when available. */\n  sessionStartedAt?: string;\n  /** Last transcript write / interaction (ISO), updated on each persist. */\n  lastInteractionAt?: string;\n  /**\n   * Epoch ms when the last webchat run was aborted (`POST /api/agent/abort`).\n   * Used with `clientCreatedAtMs` on the next POST /api/agent to drop stale queued sends.\n   */\n  abortCutoffTimestamp?: number;\n}\n\n/** Summary of wrapped transcript (no duplicate message bodies). */\nexport interface SessionTranscriptSummary {\n  id: string;\n  version: number;\n  createdAt: string;\n  updatedAt: string;\n  compactionCount: number;\n}\n\n/** Session detail (metadata + messages) */\nexport interface SessionDetail extends SessionMetadata {\n  messages: Message[];\n  /** Present when loaded with `includeTranscriptSummary` (gateway `?include=transcript`). */\n  transcriptSummary?: SessionTranscriptSummary;\n  /** Present when loaded with `include=transcriptRows` (full on-disk rows, LLM + `kind: 'context'`). */\n  transcriptRows?: TranscriptStoredRow[];\n}\n\n/** Session list query parameters */\nexport interface SessionListQuery {\n  status?: SessionStatus | SessionStatus[];\n  /** Single `sourceChannel`, or comma-separated list (e.g. `telegram,weixin`). */\n  channel?: string;\n  tags?: string[];\n  search?: string;\n  sessionTypes?: SessionType[];\n  includeHidden?: boolean;\n  sortBy?: 'updatedAt' | 'createdAt' | 'messageCount' | 'lastAccessedAt';\n  sortOrder?: 'asc' | 'desc';\n  limit?: number;\n  offset?: number;\n}\n\n/** Paginated result */\nexport interface PaginatedResult<T> {\n  items: T[];\n  total: number;\n  limit: number;\n  offset: number;\n  hasMore: boolean;\n}\n\n/** Export format */\nexport type ExportFormat = 'json' | 'markdown';\n\n/** Session export data */\nexport interface SessionExport {\n  version: string;\n  exportedAt: string;\n  metadata: SessionMetadata;\n  messages: Message[];\n  /** Full on-disk rows (LLM + `kind: 'context'`) for audit / round-trip. */\n  transcriptRows: TranscriptStoredRow[];\n}\n\n/** On-disk pre-compaction snapshot (OpenClaw-style checkpoint list). */\nexport interface CompactionCheckpointSummary {\n  id: string;\n  sizeBytes: number;\n  modifiedAt: string;\n}\n\nexport interface CompactionCheckpointDetail extends CompactionCheckpointSummary {\n  messageCount: number;\n}\n"],"mappings":";;AA4CA,IAAY,gBAAL,yBAAA,eAAA;AACL,eAAA,YAAA;AACA,eAAA,UAAA;AACA,eAAA,cAAA;AACA,eAAA,YAAA;;KACD"}
+{"version":3,"file":"types.js","names":[],"sources":["../../../src/session/types.ts"],"sourcesContent":["// Session management types\n\nimport type { TranscriptStoredRow } from './session-context-for-llm.js';\n\nexport interface Message {\n  role: 'system' | 'user' | 'assistant' | 'tool' | 'toolResult';\n  /** Plain string or structured content blocks (tool calls, multimodal). */\n  content: string | unknown[];\n  timestamp?: string;\n  tool_call_id?: string;\n  tool_calls?: Array<{\n    id: string;\n    type: 'function';\n    function: {\n      name: string;\n      arguments: string;\n    };\n  }>;\n  tool_call_id$?: string;\n  toolName?: string;\n  isError?: boolean;\n  name?: string;\n  /** Token usage from the LLM response (assistant messages only). */\n  usage?: {\n    inputTokens?: number;\n    outputTokens?: number;\n    cacheReadTokens?: number;\n    cacheWriteTokens?: number;\n    totalTokens?: number;\n  };\n  /** Inbound attachment metadata (no base64). */\n  media?: Array<{\n    id: string;\n    bucket: string;\n    type: string;\n    mimeType: string;\n    name: string;\n    size: number;\n    uri: string;\n    path: string;\n  }>;\n}\n\n/** Session status enum */\nexport enum SessionStatus {\n  ACTIVE = 'active',\n  IDLE = 'idle',\n  ARCHIVED = 'archived',\n  PINNED = 'pinned',\n}\n\n/** Session routing metadata */\nexport interface SessionRoutingMeta {\n  agentId: string;\n  source: string;\n  accountId: string;\n  peerKind: string;\n  peerId: string;\n  threadId?: string;\n  scopeId?: string;\n  mainSessionKey?: string;\n  lastRoutePolicy?: 'main' | 'session';\n}\n\n/** Session-level statistics (per session) */\nexport interface SessionStats {\n  messageCount: number;\n  tokenCount: number;\n  turnCount?: number;\n  lastTurnAt?: number;\n}\n\n/** Global session statistics (aggregate) */\nexport interface GlobalSessionStats {\n  totalSessions: number;\n  activeSessions: number;\n  archivedSessions: number;\n  pinnedSessions: number;\n  totalMessages: number;\n  totalTokens: number;\n  oldestSession?: string;\n  newestSession?: string;\n  byChannel: Record<string, number>;\n}\n\nexport type SessionType = 'chat' | 'workflow-run' | 'workflow-subagent' | 'cron' | 'heartbeat';\n\n/** Session metadata (stored in index) */\nexport interface SessionMetadata {\n  key: string;\n  name?: string;\n  status: SessionStatus;\n  tags: string[];\n  createdAt: string;\n  updatedAt: string;\n  lastAccessedAt: string;\n  messageCount: number;\n  estimatedTokens: number;\n  compactedCount: number;\n  lastFlushedAt?: string;\n  flushCount?: number;\n  sourceChannel: string;\n  sourceChatId: string;\n  customData?: Record<string, unknown>;\n  /** Optional project grouping for sessions, goals, workflows, and related context. */\n  projectId?: string;\n  /** Routing metadata */\n  routing?: SessionRoutingMeta;\n  /** Session statistics */\n  stats?: SessionStats;\n  /**\n   * High-level origin for filtering/UI (e.g. `cron`, `heartbeat`, `webchat`).\n   * Distinct from `sourceChannel` (routing namespace).\n   */\n  sessionType: SessionType;\n  hiddenFromSessionList?: boolean;\n  parentSessionKey?: string;\n  workflowRunId?: string;\n  workflowDefinitionId?: string;\n  workflowAgentId?: string;\n  workflowAgentLabel?: string;\n  /** Active OpenClaw-style session instance id. Rotates on reset while `key` stays stable. */\n  sessionId?: string;\n  /** Workspace/cwd recorded for the active transcript. */\n  cwd?: string;\n  /** First activity time for this session row (ISO), from transcript header when available. */\n  sessionStartedAt?: string;\n  /** Last transcript write / interaction (ISO), updated on each persist. */\n  lastInteractionAt?: string;\n  /**\n   * Epoch ms when the last webchat run was aborted (`POST /api/agent/abort`).\n   * Used with `clientCreatedAtMs` on the next POST /api/agent to drop stale queued sends.\n   */\n  abortCutoffTimestamp?: number;\n}\n\n/** Summary of wrapped transcript (no duplicate message bodies). */\nexport interface SessionTranscriptSummary {\n  id: string;\n  version: number;\n  createdAt: string;\n  updatedAt: string;\n  compactionCount: number;\n}\n\n/** Session detail (metadata + messages) */\nexport interface SessionDetail extends SessionMetadata {\n  messages: Message[];\n  /** Present when loaded with `includeTranscriptSummary` (gateway `?include=transcript`). */\n  transcriptSummary?: SessionTranscriptSummary;\n  /** Present when loaded with `include=transcriptRows` (full on-disk rows, LLM + `kind: 'context'`). */\n  transcriptRows?: TranscriptStoredRow[];\n}\n\n/** Session list query parameters */\nexport interface SessionListQuery {\n  status?: SessionStatus | SessionStatus[];\n  /** Single `sourceChannel`, or comma-separated list (e.g. `telegram,weixin`). */\n  channel?: string;\n  tags?: string[];\n  search?: string;\n  sessionTypes?: SessionType[];\n  includeHidden?: boolean;\n  projectId?: string;\n  sortBy?: 'updatedAt' | 'createdAt' | 'messageCount' | 'lastAccessedAt';\n  sortOrder?: 'asc' | 'desc';\n  limit?: number;\n  offset?: number;\n}\n\n/** Paginated result */\nexport interface PaginatedResult<T> {\n  items: T[];\n  total: number;\n  limit: number;\n  offset: number;\n  hasMore: boolean;\n}\n\n/** Export format */\nexport type ExportFormat = 'json' | 'markdown';\n\n/** Session export data */\nexport interface SessionExport {\n  version: string;\n  exportedAt: string;\n  metadata: SessionMetadata;\n  messages: Message[];\n  /** Full on-disk rows (LLM + `kind: 'context'`) for audit / round-trip. */\n  transcriptRows: TranscriptStoredRow[];\n}\n\n/** On-disk pre-compaction snapshot (OpenClaw-style checkpoint list). */\nexport interface CompactionCheckpointSummary {\n  id: string;\n  sizeBytes: number;\n  modifiedAt: string;\n}\n\nexport interface CompactionCheckpointDetail extends CompactionCheckpointSummary {\n  messageCount: number;\n}\n"],"mappings":";;AA4CA,IAAY,gBAAL,yBAAA,eAAA;AACL,eAAA,YAAA;AACA,eAAA,UAAA;AACA,eAAA,cAAA;AACA,eAAA,YAAA;;KACD"}

package/dist/src/storage/sqlite/memory-records-repository.d.ts

@@ -6,6 +6,7 @@ export interface UpsertMemoryRecordInput {
     agentId: string;
     workspaceId?: string;
     sessionKey?: string;
+    projectId?: string;
     content: string;
     source?: MemoryRecord['source'];
     confidence?: number;
@@ -21,6 +22,7 @@ export interface ListMemoryRecordsOptions {
     providerId?: string;
     agentId?: string;
     workspaceId?: string;
+    projectId?: string;
     kind?: MemoryKind;
     status?: MemoryStatus;
     limit?: number;
@@ -30,6 +32,7 @@ export interface SearchMemoryRecordsOptions {
     query: string;
     agentId?: string;
     workspaceId?: string;
+    projectId?: string;
     providerId?: string;
     kinds?: MemoryKind[];
     statuses?: MemoryStatus[];

package/dist/src/storage/sqlite/memory-records-repository.js

@@ -93,7 +93,8 @@ function rowToRecord(row) {
 		scope: {
 			agentId: row.agent_id,
 			...row.workspace_id ? { workspaceId: row.workspace_id } : {},
-			...row.session_key ? { sessionKey: row.session_key } : {}
+			...row.session_key ? { sessionKey: row.session_key } : {},
+			...row.project_id ? { projectId: row.project_id } : {}
 		},
 		content: row.content,
 		source: parseSource(row.source_json),
@@ -130,16 +131,17 @@ function upsertMemoryRecord(input) {
 	};
 	runSqliteWriteTransaction((db) => {
 		db.prepare(`INSERT INTO memory_records (
-        record_id, provider_id, kind, agent_id, workspace_id, session_key,
+        record_id, provider_id, kind, agent_id, workspace_id, session_key, project_id,
         content, source_json, confidence, tags_json, status, sensitivity,
         evidence_json, review_after, expires_at, created_at, updated_at
-      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
       ON CONFLICT(record_id) DO UPDATE SET
         provider_id = excluded.provider_id,
         kind = excluded.kind,
         agent_id = excluded.agent_id,
         workspace_id = excluded.workspace_id,
         session_key = excluded.session_key,
+        project_id = excluded.project_id,
         content = excluded.content,
         source_json = excluded.source_json,
         confidence = excluded.confidence,
@@ -149,7 +151,7 @@ function upsertMemoryRecord(input) {
         evidence_json = excluded.evidence_json,
         review_after = excluded.review_after,
         expires_at = excluded.expires_at,
-        updated_at = excluded.updated_at`).run(id, input.providerId, input.kind, input.agentId, input.workspaceId ?? null, input.sessionKey ?? null, input.content, JSON.stringify(source), input.confidence ?? null, JSON.stringify(input.tags ?? []), status, sensitivity, JSON.stringify(input.evidence ?? []), reviewAfter, expiresAt, now, now);
+        updated_at = excluded.updated_at`).run(id, input.providerId, input.kind, input.agentId, input.workspaceId ?? null, input.sessionKey ?? null, input.projectId ?? null, input.content, JSON.stringify(source), input.confidence ?? null, JSON.stringify(input.tags ?? []), status, sensitivity, JSON.stringify(input.evidence ?? []), reviewAfter, expiresAt, now, now);
 		upsertMemoryRecordFts(db, {
 			...input,
 			id
@@ -162,7 +164,8 @@ function upsertMemoryRecord(input) {
 		scope: {
 			agentId: input.agentId,
 			...input.workspaceId ? { workspaceId: input.workspaceId } : {},
-			...input.sessionKey ? { sessionKey: input.sessionKey } : {}
+			...input.sessionKey ? { sessionKey: input.sessionKey } : {},
+			...input.projectId ? { projectId: input.projectId } : {}
 		},
 		content: input.content,
 		source,
@@ -195,6 +198,10 @@ function listMemoryRecords(options = {}) {
 		where.push("workspace_id = ?");
 		params.push(options.workspaceId);
 	}
+	if (options.projectId) {
+		where.push("project_id = ?");
+		params.push(options.projectId);
+	}
 	if (options.kind) {
 		where.push("kind = ?");
 		params.push(options.kind);
@@ -223,6 +230,10 @@ function searchMemoryRecords(options) {
 		filters.push("f.workspace_id = ?");
 		params.push(options.workspaceId);
 	}
+	if (options.projectId) {
+		filters.push("r.project_id = ?");
+		params.push(options.projectId);
+	}
 	if (options.providerId) {
 		filters.push("f.provider_id = ?");
 		params.push(options.providerId);