@xopcai/xopc 0.0.174 → 0.0.175

package/dist/src/gateway/hono/routes/project-skills.js

@@ -0,0 +1,119 @@
+import { ProjectSkillError, ProjectSkillService } from "../../../projects/project-skill-service.js";
+import "../../../projects/index.js";
+//#region src/gateway/hono/routes/project-skills.ts
+function projectSkills(deps) {
+	return new ProjectSkillService({
+		projects: deps.service.projects,
+		getConfig: () => deps.service.currentConfig,
+		refreshSkills: () => deps.service.agentService.refreshSkillsAfterDiskChange()
+	});
+}
+function errorResponse(c, error) {
+	if (error instanceof ProjectSkillError) return c.json({
+		ok: false,
+		code: error.code,
+		error: error.message
+	}, error.status);
+	return c.json({
+		ok: false,
+		code: "project_skill_operation_failed",
+		error: error instanceof Error ? error.message : String(error)
+	}, 400);
+}
+function registerProjectSkillRoutes(authenticated, deps) {
+	authenticated.get("/api/projects/:projectId/skills", (c) => {
+		try {
+			return c.json({
+				ok: true,
+				...projectSkills(deps).list(c.req.param("projectId"))
+			});
+		} catch (error) {
+			return errorResponse(c, error);
+		}
+	});
+	authenticated.get("/api/projects/:projectId/skills/:skillId", (c) => {
+		try {
+			return c.json({
+				ok: true,
+				skill: projectSkills(deps).getContent(c.req.param("projectId"), c.req.param("skillId"))
+			});
+		} catch (error) {
+			return errorResponse(c, error);
+		}
+	});
+	authenticated.post("/api/projects/:projectId/skills/upload", async (c) => {
+		try {
+			const body = await c.req.parseBody();
+			const file = body.file;
+			if (!(file instanceof File)) return c.json({
+				ok: false,
+				error: "Skill zip file is required"
+			}, 400);
+			const skill = await projectSkills(deps).installZip(c.req.param("projectId"), Buffer.from(await file.arrayBuffer()), {
+				skillId: typeof body.skillId === "string" ? body.skillId : void 0,
+				overwrite: body.overwrite === "true"
+			});
+			return c.json({
+				ok: true,
+				skill
+			}, 201);
+		} catch (error) {
+			return errorResponse(c, error);
+		}
+	});
+	authenticated.post("/api/projects/:projectId/skills/marketplace/install", async (c) => {
+		try {
+			const body = await c.req.json();
+			const name = typeof body.name === "string" ? body.name.trim() : "";
+			if (!name) return c.json({
+				ok: false,
+				error: "Marketplace skill name is required"
+			}, 400);
+			const skill = await projectSkills(deps).installMarketplace(c.req.param("projectId"), {
+				name,
+				version: typeof body.version === "string" ? body.version : void 0,
+				provider: typeof body.provider === "string" ? body.provider : void 0,
+				overwrite: body.overwrite === true
+			});
+			return c.json({
+				ok: true,
+				skill
+			}, 201);
+		} catch (error) {
+			return errorResponse(c, error);
+		}
+	});
+	authenticated.post("/api/projects/:projectId/skills/source/install", async (c) => {
+		try {
+			const body = await c.req.json();
+			const source = typeof body.source === "string" ? body.source.trim() : "";
+			if (!source) return c.json({
+				ok: false,
+				error: "Skill source is required"
+			}, 400);
+			const skill = await projectSkills(deps).installSource(c.req.param("projectId"), {
+				source,
+				skillId: typeof body.skillId === "string" ? body.skillId : void 0,
+				ref: typeof body.ref === "string" ? body.ref : void 0,
+				subpath: typeof body.subpath === "string" ? body.subpath : void 0,
+				force: body.force === true
+			});
+			return c.json({
+				ok: true,
+				skill
+			}, 201);
+		} catch (error) {
+			return errorResponse(c, error);
+		}
+	});
+	authenticated.delete("/api/projects/:projectId/skills/:skillId", async (c) => {
+		try {
+			await projectSkills(deps).remove(c.req.param("projectId"), c.req.param("skillId"));
+			return c.json({ ok: true });
+		} catch (error) {
+			return errorResponse(c, error);
+		}
+	});
+}
+//#endregion
+export { registerProjectSkillRoutes };

package/dist/src/infra/update-restart.js

@@ -2,8 +2,8 @@ import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { init_paths, resolveConfigPath } from "../config/paths.js";
 import { init_loader, loadConfig } from "../config/loader.js";
-import { isRestartEnabled } from "../config/commands.flags.js";
 import { resolveGatewayService } from "../daemon/service.js";
+import { isRestartEnabled } from "../config/commands.flags.js";
 import { authorizeGatewaySigusr1Restart, writeGatewayRestartIntentSync } from "./restart.js";
 import { findVerifiedGatewayListenerPidsOnPortSync, signalVerifiedGatewayPidSync } from "./gateway-processes.js";
 import { refreshGatewayServiceAfterUpdate } from "./update-service-refresh.js";

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

@@ -1,6 +1,7 @@
 export * from './types.js';
 export * from './project-store.js';
 export * from './project-service.js';
+export * from './project-skill-service.js';
 export * from './project-agent.js';
 export * from './project-agent-suggestion.js';
 export * from './project-kind.js';

package/dist/src/projects/index.js

@@ -4,6 +4,7 @@ import { bindGoalToProject, bindGoalsToProject, listProjectGoalIds, unbindGoalFr
 import { bindSessionToProject, bindSessionsToProject, listProjectSessionKeys, moveSessionToProject, unbindSessionFromProject } from "./session-bind.js";
 import { ProjectWorkspaceConflictError, ProjectWorkspaceMissingError, canonicalWorkspacePath, ensureWorkspaceDirectory, inferProjectNameFromWorkspaceRoot, isPathSameOrInsideWorkspace, isSafeAutoCreateWorkspaceRoot, resolveWorkspaceProjectRoot, workspaceDirectoryExists } from "./workspace-project.js";
 import { ProjectService } from "./project-service.js";
+import { ProjectSkillError, ProjectSkillService } from "./project-skill-service.js";
 import { isValidProjectAgentId, normalizeProjectAgentId, resolveProjectAgentId } from "./project-agent.js";
 import { inferProjectKind } from "./project-kind.js";
 import { CODING_PROJECT_AGENT_ID, inferSuggestedProjectDefaultAgentId, suggestProjectDefaultAgentId } from "./project-agent-suggestion.js";
@@ -11,4 +12,4 @@ import { buildProjectLoopOverview } from "./project-loop.js";
 import { bindWorkflowRunToProject } from "./workflow-bind.js";
 import { bindAutomationToProject } from "./automation-bind.js";
 import { bindMemoryRecordToProject } from "./memory-bind.js";
-export { CODING_PROJECT_AGENT_ID, ProjectService, ProjectStore, ProjectWorkspaceConflictError, ProjectWorkspaceMissingError, bindAutomationToProject, bindGoalToProject, bindGoalsToProject, bindMemoryRecordToProject, bindSessionToProject, bindSessionsToProject, bindWorkflowRunToProject, buildProjectLoopOverview, canonicalWorkspacePath, ensureWorkspaceDirectory, getProjectForSession, getProjectWorkspacePathForSession, inferProjectKind, inferProjectNameFromWorkspaceRoot, inferSuggestedProjectDefaultAgentId, isPathSameOrInsideWorkspace, isSafeAutoCreateWorkspaceRoot, isValidProjectAgentId, listProjectGoalIds, listProjectSessionKeys, moveSessionToProject, normalizeProjectAgentId, resolveProjectAgentId, resolveProjectWorkspacePath, resolveWorkspaceProjectRoot, slugifyProjectName, suggestProjectDefaultAgentId, unbindGoalFromProject, unbindSessionFromProject, workspaceDirectoryExists };
+export { CODING_PROJECT_AGENT_ID, ProjectService, ProjectSkillError, ProjectSkillService, ProjectStore, ProjectWorkspaceConflictError, ProjectWorkspaceMissingError, bindAutomationToProject, bindGoalToProject, bindGoalsToProject, bindMemoryRecordToProject, bindSessionToProject, bindSessionsToProject, bindWorkflowRunToProject, buildProjectLoopOverview, canonicalWorkspacePath, ensureWorkspaceDirectory, getProjectForSession, getProjectWorkspacePathForSession, inferProjectKind, inferProjectNameFromWorkspaceRoot, inferSuggestedProjectDefaultAgentId, isPathSameOrInsideWorkspace, isSafeAutoCreateWorkspaceRoot, isValidProjectAgentId, listProjectGoalIds, listProjectSessionKeys, moveSessionToProject, normalizeProjectAgentId, resolveProjectAgentId, resolveProjectWorkspacePath, resolveWorkspaceProjectRoot, slugifyProjectName, suggestProjectDefaultAgentId, unbindGoalFromProject, unbindSessionFromProject, workspaceDirectoryExists };

package/dist/src/projects/project-skill-service.d.ts

@@ -0,0 +1,67 @@
+import type { Config } from '../config/schema.js';
+import type { SkillDiagnostic, SkillMetadata, SkillToolConditions } from '../agent/skills/types.js';
+import type { ProjectService } from './project-service.js';
+export type ProjectSkillErrorCode = 'project_not_found' | 'project_workspace_required' | 'project_workspace_missing' | 'project_workspace_not_writable' | 'skill_not_found' | 'invalid_skill_id';
+export declare class ProjectSkillError extends Error {
+    readonly code: ProjectSkillErrorCode;
+    readonly status: 400 | 403 | 404 | 409;
+    constructor(code: ProjectSkillErrorCode, status: 400 | 403 | 404 | 409, message: string);
+}
+export interface ProjectSkillSummary {
+    id: string;
+    name: string;
+    description: string;
+    category?: string;
+    disableModelInvocation: boolean;
+    metadata: SkillMetadata;
+    toolConditions?: SkillToolConditions;
+    requiredEnvVarNames?: string[];
+}
+export interface ProjectSkillListResult {
+    workspaceRoot: string;
+    skillsRoot: string;
+    items: ProjectSkillSummary[];
+    diagnostics: SkillDiagnostic[];
+}
+interface ProjectSkillServiceOptions {
+    projects: ProjectService;
+    getConfig: () => Config;
+    refreshSkills: () => void | Promise<void>;
+}
+export declare class ProjectSkillService {
+    private readonly options;
+    constructor(options: ProjectSkillServiceOptions);
+    list(projectId: string): ProjectSkillListResult;
+    getContent(projectId: string, skillId: string): ProjectSkillSummary & {
+        bodyMarkdown: string;
+    };
+    installZip(projectId: string, buffer: Buffer, input?: {
+        skillId?: string;
+        overwrite?: boolean;
+    }): Promise<ProjectSkillSummary & {
+        bodyMarkdown: string;
+    }>;
+    installMarketplace(projectId: string, input: {
+        name: string;
+        version?: string;
+        provider?: string;
+        overwrite?: boolean;
+    }): Promise<ProjectSkillSummary & {
+        bodyMarkdown: string;
+    }>;
+    installSource(projectId: string, input: {
+        source: string;
+        skillId?: string;
+        ref?: string;
+        subpath?: string;
+        force?: boolean;
+    }): Promise<ProjectSkillSummary & {
+        bodyMarkdown: string;
+    }>;
+    remove(projectId: string, skillId: string): Promise<void>;
+    private findSkill;
+    private resolveLocation;
+    private isDirectSkill;
+    private toSummary;
+}
+export {};

package/dist/src/projects/project-skill-service.js

@@ -0,0 +1,131 @@
+import { resolveWorkspaceSkillsDir, resolveWorkspaceSkillsLockPath } from "../agent/skills/workspace-skills-dir.js";
+import { loadWorkspaceSkills } from "../agent/skills/index.js";
+import { removeSkillsLockEntry } from "../agent/skills/hub-lock.js";
+import { deleteManagedSkill, installSkillFromZip, isValidSkillId } from "../agent/skills/managed-store.js";
+import { pullSkillFromSource } from "../agent/skills/hub-pull.js";
+import { downloadFromMarketplace } from "../agent/skills/skills-marketplace.js";
+import { basename, dirname, join, relative, resolve, sep } from "node:path";
+import { accessSync, constants, existsSync, statSync } from "node:fs";
+//#region src/projects/project-skill-service.ts
+var ProjectSkillError = class extends Error {
+	constructor(code, status, message) {
+		super(message);
+		this.code = code;
+		this.status = status;
+		this.name = "ProjectSkillError";
+	}
+};
+var ProjectSkillService = class {
+	constructor(options) {
+		this.options = options;
+	}
+	list(projectId) {
+		const location = this.resolveLocation(projectId, false);
+		const loaded = loadWorkspaceSkills(location.workspaceRoot);
+		return {
+			...location,
+			items: loaded.skills.filter((skill) => this.isDirectSkill(skill, location.skillsRoot)).map((skill) => this.toSummary(skill)),
+			diagnostics: loaded.diagnostics
+		};
+	}
+	getContent(projectId, skillId) {
+		const { skill } = this.findSkill(projectId, skillId);
+		return {
+			...this.toSummary(skill),
+			bodyMarkdown: skill.content
+		};
+	}
+	async installZip(projectId, buffer, input = {}) {
+		const location = this.resolveLocation(projectId, true);
+		const installed = installSkillFromZip(buffer, {
+			skillId: input.skillId,
+			overwrite: input.overwrite,
+			rootDir: location.skillsRoot
+		});
+		removeSkillsLockEntry(installed.skillId, resolveWorkspaceSkillsLockPath(location.workspaceRoot));
+		await this.options.refreshSkills();
+		return this.getContent(projectId, installed.skillId);
+	}
+	async installMarketplace(projectId, input) {
+		const downloaded = await downloadFromMarketplace(this.options.getConfig(), input.name, input.version, input.provider);
+		return this.installZip(projectId, downloaded.buffer, {
+			skillId: downloaded.skillId,
+			overwrite: input.overwrite
+		});
+	}
+	async installSource(projectId, input) {
+		const location = this.resolveLocation(projectId, true);
+		const installed = await pullSkillFromSource(input.source, {
+			skillId: input.skillId,
+			ref: input.ref,
+			subpath: input.subpath,
+			force: input.force,
+			installRoot: location.skillsRoot,
+			lockPath: resolveWorkspaceSkillsLockPath(location.workspaceRoot)
+		});
+		await this.options.refreshSkills();
+		return this.getContent(projectId, installed.skillId);
+	}
+	async remove(projectId, skillId) {
+		const location = this.resolveLocation(projectId, true);
+		if (!isValidSkillId(skillId)) throw new ProjectSkillError("invalid_skill_id", 400, "Invalid skill id");
+		if (!existsSync(join(location.skillsRoot, skillId, "SKILL.md"))) throw new ProjectSkillError("skill_not_found", 404, "Project skill not found");
+		deleteManagedSkill(skillId, location.skillsRoot);
+		removeSkillsLockEntry(skillId, resolveWorkspaceSkillsLockPath(location.workspaceRoot));
+		await this.options.refreshSkills();
+	}
+	findSkill(projectId, skillId) {
+		if (!isValidSkillId(skillId)) throw new ProjectSkillError("invalid_skill_id", 400, "Invalid skill id");
+		const location = this.resolveLocation(projectId, false);
+		const skill = loadWorkspaceSkills(location.workspaceRoot).skills.find((item) => {
+			return !relative(location.skillsRoot, item.baseDir).includes(sep) && basename(item.baseDir) === skillId;
+		});
+		if (!skill) throw new ProjectSkillError("skill_not_found", 404, "Project skill not found");
+		return {
+			skill,
+			skillsRoot: location.skillsRoot
+		};
+	}
+	resolveLocation(projectId, requireWritable) {
+		const project = this.options.projects.get(projectId);
+		if (!project) throw new ProjectSkillError("project_not_found", 404, "Project not found");
+		const configuredRoot = project.workspaceRoot?.trim();
+		if (!configuredRoot) throw new ProjectSkillError("project_workspace_required", 409, "Project workspace is required");
+		const workspaceRoot = resolve(configuredRoot);
+		try {
+			if (!existsSync(workspaceRoot) || !statSync(workspaceRoot).isDirectory()) throw new ProjectSkillError("project_workspace_missing", 409, "Project workspace does not exist");
+		} catch (error) {
+			if (error instanceof ProjectSkillError) throw error;
+			throw new ProjectSkillError("project_workspace_missing", 409, "Project workspace does not exist");
+		}
+		const skillsRoot = resolveWorkspaceSkillsDir(workspaceRoot);
+		if (requireWritable) try {
+			const xopcRoot = dirname(skillsRoot);
+			accessSync(existsSync(skillsRoot) ? skillsRoot : existsSync(xopcRoot) ? xopcRoot : workspaceRoot, constants.W_OK);
+		} catch {
+			throw new ProjectSkillError("project_workspace_not_writable", 403, "Project workspace is not writable");
+		}
+		return {
+			workspaceRoot,
+			skillsRoot
+		};
+	}
+	isDirectSkill(skill, skillsRoot) {
+		const rel = relative(skillsRoot, skill.baseDir);
+		return Boolean(rel) && !rel.includes(sep) && isValidSkillId(basename(skill.baseDir));
+	}
+	toSummary(skill) {
+		return {
+			id: basename(skill.baseDir),
+			name: skill.name,
+			description: skill.description,
+			category: skill.category,
+			disableModelInvocation: skill.disableModelInvocation,
+			metadata: skill.metadata,
+			toolConditions: skill.toolConditions,
+			requiredEnvVarNames: skill.requiredEnvVarNames
+		};
+	}
+};
+//#endregion
+export { ProjectSkillError, ProjectSkillService };

package/dist/src/storage/sqlite/home-attention-repository.d.ts

@@ -0,0 +1,3 @@
+export type HomeAttentionSubjectKind = 'automation_run' | 'workflow_run';
+export declare function acknowledgeHomeAttention(subjectKind: HomeAttentionSubjectKind, subjectId: string, acknowledgedAt?: number): void;
+export declare function isHomeAttentionAcknowledged(subjectKind: HomeAttentionSubjectKind, subjectId: string): boolean;

package/dist/src/storage/sqlite/home-attention-repository.js

@@ -0,0 +1,21 @@
+import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+//#region src/storage/sqlite/home-attention-repository.ts
+function acknowledgeHomeAttention(subjectKind, subjectId, acknowledgedAt = Date.now()) {
+	runSqliteWriteTransaction((db) => {
+		db.prepare(`
+      INSERT INTO home_attention_acknowledgements (subject_kind, subject_id, acknowledged_at)
+      VALUES (?, ?, ?)
+      ON CONFLICT(subject_kind, subject_id) DO UPDATE SET
+        acknowledged_at = excluded.acknowledged_at
+    `).run(subjectKind, subjectId, acknowledgedAt);
+	});
+}
+function isHomeAttentionAcknowledged(subjectKind, subjectId) {
+	return getSqliteDatabase().prepare(`
+      SELECT 1
+      FROM home_attention_acknowledgements
+      WHERE subject_kind = ? AND subject_id = ?
+    `).get(subjectKind, subjectId) !== void 0;
+}
+//#endregion
+export { acknowledgeHomeAttention, isHomeAttentionAcknowledged };

package/dist/src/storage/sqlite/index.d.ts

@@ -5,6 +5,7 @@ export { DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, } from './m
 export { discoverSqlMigrations, listRegisteredMigrationTargets } from './migrations/discover.js';
 export { closeXopcDatabase, getXopcDatabase, isXopcDatabaseOpen, openXopcDatabase, requireXopcDatabase, resetXopcDatabaseSingletonForTest, type OpenXopcDatabaseOptions, type XopcDatabase, } from './connection.js';
 export { getSqliteDatabase, runSqliteWriteTransaction } from './transaction.js';
+export { acknowledgeHomeAttention, isHomeAttentionAcknowledged, type HomeAttentionSubjectKind, } from './home-attention-repository.js';
 export { getUserClaim, linkUserClaimMemoryRecord, listUserClaimEvidence, listUserClaimStatsBySource, listUserClaims, listUserPeopleGraphRows, removeUserClaimEvidenceForSource, reinforceUserClaim, resolveUserEntity, setUserClaimDecision, type UserClaim, type UserClaimClass, type UserClaimState, type UserEntity, } from './user-claims-repository.js';
 export { claimNextConnectorLearningJob, enqueueConnectorLearningJob, listConnectorLearningJobs, recoverStaleConnectorLearningJobs, setConnectorLearningPaused, updateConnectorLearningJob, type ConnectorLearningJob, type ConnectorLearningMode, type ConnectorLearningPhase, type ConnectorLearningStatus, } from './connector-learning-repository.js';
 export { appendComposerInputHistory, clearComposerInputHistory, listComposerInputHistory, COMPOSER_INPUT_HISTORY_LIMIT, type ComposerInputHistoryItem, } from './composer-input-history-repository.js';

package/dist/src/storage/sqlite/index.js

@@ -6,6 +6,7 @@ import { XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_SCHEMA_VERSION, applyPendingMi
 import { ensureXopcDatabaseSchema } from "./schema.js";
 import { closeXopcDatabase, getXopcDatabase, isXopcDatabaseOpen, openXopcDatabase, requireXopcDatabase, resetXopcDatabaseSingletonForTest } from "./connection.js";
 import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { acknowledgeHomeAttention, isHomeAttentionAcknowledged } from "./home-attention-repository.js";
 import { getUserClaim, linkUserClaimMemoryRecord, listUserClaimEvidence, listUserClaimStatsBySource, listUserClaims, listUserPeopleGraphRows, reinforceUserClaim, removeUserClaimEvidenceForSource, resolveUserEntity, setUserClaimDecision } from "./user-claims-repository.js";
 import { claimNextConnectorLearningJob, enqueueConnectorLearningJob, listConnectorLearningJobs, recoverStaleConnectorLearningJobs, setConnectorLearningPaused, updateConnectorLearningJob } from "./connector-learning-repository.js";
 import { COMPOSER_INPUT_HISTORY_LIMIT, appendComposerInputHistory, clearComposerInputHistory, listComposerInputHistory } from "./composer-input-history-repository.js";
@@ -27,4 +28,4 @@ import { appendConnectorExecutionAudit, claimConnectorWebhookDelivery, completeC
 import { getUserTrustPolicy, setUserTrustPolicy } from "./user-trust-repository.js";
 import { consumeMemoryReferenceConsent, decideMemoryReferenceConsent, ensureMemoryReferenceConsentRequest, hasMemoryReferenceConsent, listMemoryReferenceConsents, revokeMemoryReferenceConsent } from "./memory-reference-consent-repository.js";
 import { getUserProfilePromptState, setUserProfilePromptState } from "./user-profile-setup-repository.js";
-export { COMPOSER_INPUT_HISTORY_LIMIT, DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, SCHEMA_META_SCHEMA_VERSION_KEY, USER_UNDERSTANDING_REMEDIATION_POLICY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, appendCompactionBoundary, appendComposerInputHistory, appendConnectorExecutionAudit, appendMemorySignal, appendMemoryTraceEvent, appendTranscriptEntry, applyPendingMigrations, attachMemoryEvidence, buildDefaultSessionMetadata, buildGlobalSessionStats, buildRelationshipPrompt, claimConnectorWebhookDelivery, claimKnowledgeSourceItems, claimNextConnectorLearningJob, classifyStoredRow, clearComposerInputHistory, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, completeTaskOutcome, consumeConnectorApproval, consumeMemoryReferenceConsent, createConnectorApproval, createObjectLinkRecord, decideConnectorApproval, decideMemoryReferenceConsent, deleteConnectorConnection, deleteConnectorInstallation, deleteMemoryEvidenceForRecord, deleteMemoryRecord, deleteNoteAgentContextRecord, deleteNoteRecord, deleteSessionConfig, deleteSessionRecord, discoverSqlMigrations, enqueueConnectorLearningJob, ensureMemoryReferenceConsentRequest, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findLatestMemoryInjectTrace, findSessionKeyBySessionId, findTaskOutcomeForAssistant, finishKnowledgeSyncRun, getActivityEventRecord, getCachedConnectorCatalogEntry, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getCurrentSessionId, getGlobalSessionStats, getInteractionState, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getMemoryProviderState, getMemoryRecord, getNoteAgentContextRecord, getNoteRecord, getRelationshipSettings, getSessionConfig, getSessionMetadata, getSessionPersistedLevels, getSqliteDatabase, getTaskOutcome, getUserClaim, getUserProfilePromptState, getUserTrustPolicy, getXopcDatabase, hasMemoryReferenceConsent, hasSessionConfig, hasUnresolvedMemoryConflict, incrementSessionStatsOnAppend, inspectSchemaMigrationStatus, isProactiveSupportAllowed, isXopcDatabaseOpen, linkUserClaimMemoryRecord, listActivityRecords, listCachedConnectorCatalogEntries, listCompactionBoundaries, listComposerInputHistory, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listConnectorLearningJobs, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryRecords, listMemoryReferenceConsents, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, listTaskOutcomes, listUserClaimEvidence, listUserClaimStatsBySource, listUserClaims, listUserPeopleGraphRows, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, markMemoryRecordsConflicted, metadataToSessionInsert, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, pruneBoundedKnowledgeSourceItems, readSchemaVersion, readSchemaVersionForTest, recordActivityEvent, recoverStaleConnectorLearningJobs, reinforceUserClaim, releaseConnectorWebhookDelivery, removeUserClaimEvidenceForSource, replaceConnectorCatalogEntries, replaceTranscriptRows, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveMigrationsDir, resolveSessionAgentId, resolveUserEntity, resolveXopcDatabasePath, restoreBeforeCompactionBoundary, revokeMemoryReferenceConsent, runSqliteWriteTransaction, searchMemoryIndex, searchMemoryRecords, sessionConfigRowToConfig, sessionRowToMetadata, setConnectorLearningPaused, setInteractionState, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setLatestMemoryInjectFeedback, setMemoryProviderState, setMemoryTraceFeedback, setSessionConfig, setTaskOutcomeFeedback, setUserClaimDecision, setUserProfilePromptState, setUserTrustPolicy, startKnowledgeSyncRun, startTaskOutcome, summarizeMemoryRecallFeedback, summarizeTaskOutcomes, summarizeUserUnderstandingQuality, syncMemoryIndex, transcriptEntryRowToStoredRow, updateConnectorLearningJob, updateInteractionStateFromMessage, updateRelationshipSettings, updateSessionConfig, updateSessionStats, updateTaskOutcome, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertKnowledgeSourceItems, upsertMemoryRecord, upsertNoteAgentContextRecord, upsertNoteRecord };
+export { COMPOSER_INPUT_HISTORY_LIMIT, DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, SCHEMA_META_SCHEMA_VERSION_KEY, USER_UNDERSTANDING_REMEDIATION_POLICY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, acknowledgeHomeAttention, appendCompactionBoundary, appendComposerInputHistory, appendConnectorExecutionAudit, appendMemorySignal, appendMemoryTraceEvent, appendTranscriptEntry, applyPendingMigrations, attachMemoryEvidence, buildDefaultSessionMetadata, buildGlobalSessionStats, buildRelationshipPrompt, claimConnectorWebhookDelivery, claimKnowledgeSourceItems, claimNextConnectorLearningJob, classifyStoredRow, clearComposerInputHistory, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, completeTaskOutcome, consumeConnectorApproval, consumeMemoryReferenceConsent, createConnectorApproval, createObjectLinkRecord, decideConnectorApproval, decideMemoryReferenceConsent, deleteConnectorConnection, deleteConnectorInstallation, deleteMemoryEvidenceForRecord, deleteMemoryRecord, deleteNoteAgentContextRecord, deleteNoteRecord, deleteSessionConfig, deleteSessionRecord, discoverSqlMigrations, enqueueConnectorLearningJob, ensureMemoryReferenceConsentRequest, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findLatestMemoryInjectTrace, findSessionKeyBySessionId, findTaskOutcomeForAssistant, finishKnowledgeSyncRun, getActivityEventRecord, getCachedConnectorCatalogEntry, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getCurrentSessionId, getGlobalSessionStats, getInteractionState, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getMemoryProviderState, getMemoryRecord, getNoteAgentContextRecord, getNoteRecord, getRelationshipSettings, getSessionConfig, getSessionMetadata, getSessionPersistedLevels, getSqliteDatabase, getTaskOutcome, getUserClaim, getUserProfilePromptState, getUserTrustPolicy, getXopcDatabase, hasMemoryReferenceConsent, hasSessionConfig, hasUnresolvedMemoryConflict, incrementSessionStatsOnAppend, inspectSchemaMigrationStatus, isHomeAttentionAcknowledged, isProactiveSupportAllowed, isXopcDatabaseOpen, linkUserClaimMemoryRecord, listActivityRecords, listCachedConnectorCatalogEntries, listCompactionBoundaries, listComposerInputHistory, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listConnectorLearningJobs, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryRecords, listMemoryReferenceConsents, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, listTaskOutcomes, listUserClaimEvidence, listUserClaimStatsBySource, listUserClaims, listUserPeopleGraphRows, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, markMemoryRecordsConflicted, metadataToSessionInsert, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, pruneBoundedKnowledgeSourceItems, readSchemaVersion, readSchemaVersionForTest, recordActivityEvent, recoverStaleConnectorLearningJobs, reinforceUserClaim, releaseConnectorWebhookDelivery, removeUserClaimEvidenceForSource, replaceConnectorCatalogEntries, replaceTranscriptRows, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveMigrationsDir, resolveSessionAgentId, resolveUserEntity, resolveXopcDatabasePath, restoreBeforeCompactionBoundary, revokeMemoryReferenceConsent, runSqliteWriteTransaction, searchMemoryIndex, searchMemoryRecords, sessionConfigRowToConfig, sessionRowToMetadata, setConnectorLearningPaused, setInteractionState, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setLatestMemoryInjectFeedback, setMemoryProviderState, setMemoryTraceFeedback, setSessionConfig, setTaskOutcomeFeedback, setUserClaimDecision, setUserProfilePromptState, setUserTrustPolicy, startKnowledgeSyncRun, startTaskOutcome, summarizeMemoryRecallFeedback, summarizeTaskOutcomes, summarizeUserUnderstandingQuality, syncMemoryIndex, transcriptEntryRowToStoredRow, updateConnectorLearningJob, updateInteractionStateFromMessage, updateRelationshipSettings, updateSessionConfig, updateSessionStats, updateTaskOutcome, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertKnowledgeSourceItems, upsertMemoryRecord, upsertNoteAgentContextRecord, upsertNoteRecord };

package/dist/src/storage/sqlite/migrations/067_home_attention_acknowledgements.sql

@@ -0,0 +1,9 @@
+CREATE TABLE IF NOT EXISTS home_attention_acknowledgements (
+  subject_kind TEXT NOT NULL CHECK (subject_kind IN ('automation_run', 'workflow_run')),
+  subject_id TEXT NOT NULL,
+  acknowledged_at INTEGER NOT NULL,
+  PRIMARY KEY (subject_kind, subject_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_home_attention_acknowledged_at
+  ON home_attention_acknowledgements(acknowledged_at DESC);

package/dist/src/storage/sqlite/migrations/runner.d.ts

@@ -3,7 +3,7 @@ import type { ApplyMigrationsOptions } from './types.js';
 /** Baseline schema version applied from schema.sql on first open. */
 export declare const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 /** Latest schema version this release supports (increment when adding migrations). */
-export declare const XOPC_DB_SCHEMA_VERSION = 66;
+export declare const XOPC_DB_SCHEMA_VERSION = 67;
 export declare function resolveMigrationsDir(override?: string): string;
 /**
  * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.

package/dist/src/storage/sqlite/migrations/runner.js

@@ -12,7 +12,7 @@ const log = createLogger("Sqlite:Migrations");
 /** Baseline schema version applied from schema.sql on first open. */
 const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 /** Latest schema version this release supports (increment when adding migrations). */
-const XOPC_DB_SCHEMA_VERSION = 66;
+const XOPC_DB_SCHEMA_VERSION = 67;
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 function resolveMigrationsDir(override) {
 	if (override) return override;
@@ -46,7 +46,7 @@ function applySingleMigration(db, migration) {
 * Each step runs in its own transaction and updates schema_meta on success.
 */
 function applyPendingMigrations(db, options = {}) {
-	const targetVersion = options.targetVersion ?? 66;
+	const targetVersion = options.targetVersion ?? 67;
 	let currentVersion = readSchemaVersion(db);
 	if (currentVersion > targetVersion) throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);
 	if (currentVersion >= targetVersion) return currentVersion;
@@ -62,7 +62,7 @@ function applyPendingMigrations(db, options = {}) {
 }
 /** Inspect schema version without mutating the database. */
 function inspectSchemaMigrationStatus(db, options = {}) {
-	const appVersion = options.targetVersion ?? 66;
+	const appVersion = options.targetVersion ?? 67;
 	const dbVersion = readSchemaVersion(db);
 	if (dbVersion > appVersion) return {
 		dbVersion,

package/dist/src/storage/sqlite/migrations/runner.ts

@@ -19,7 +19,7 @@ const log = createLogger('Sqlite:Migrations');
 export const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 
 /** Latest schema version this release supports (increment when adding migrations). */
-export const XOPC_DB_SCHEMA_VERSION = 66;
+export const XOPC_DB_SCHEMA_VERSION = 67;
 
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 

package/dist/src/storage/sqlite/schema.js

@@ -31,7 +31,7 @@ function ensureXopcDatabaseSchema(db) {
 		bootstrapFreshDatabase(db);
 		currentVersion = 11;
 	}
-	applyPendingMigrations(db, { targetVersion: 66 });
+	applyPendingMigrations(db, { targetVersion: 67 });
 }
 //#endregion
 export { SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_SCHEMA_VERSION, ensureSchemaMetaTable, ensureXopcDatabaseSchema, readSchemaVersion, readSchemaVersionForTest, setSchemaVersion };

package/dist/src/storage/sqlite/schema.sql

@@ -189,6 +189,16 @@ CREATE INDEX IF NOT EXISTS idx_workflow_runs_definition_created
 CREATE INDEX IF NOT EXISTS idx_workflow_runs_created
   ON workflow_runs(agent_id, created_at_ms DESC);
 
+CREATE TABLE IF NOT EXISTS home_attention_acknowledgements (
+  subject_kind TEXT NOT NULL CHECK (subject_kind IN ('automation_run', 'workflow_run')),
+  subject_id TEXT NOT NULL,
+  acknowledged_at INTEGER NOT NULL,
+  PRIMARY KEY (subject_kind, subject_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_home_attention_acknowledged_at
+  ON home_attention_acknowledgements(acknowledged_at DESC);
+
 CREATE TABLE IF NOT EXISTS notes (
   note_id               TEXT PRIMARY KEY,
   title                 TEXT,

package/dist/src/tui/tui-startup-resources.js

@@ -3,8 +3,8 @@ import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.
 import { init_paths, resolveAgentProfileDir, resolveBundledSkillsDir, resolveUserProfilePath } from "../config/paths.js";
 import { resolveBootstrapFilesSync } from "../agent/bootstrap/bootstrap-files.js";
 import { createSkillConfigManager, isSkillEnabled } from "../agent/skills/config.js";
-import { createWorkflowCatalog } from "../agent/workflow/catalog.js";
 import { loadSkills } from "../agent/skills/index.js";
+import { createWorkflowCatalog } from "../agent/workflow/catalog.js";
 import { listConnectorInstances } from "../connectors/instances.js";
 import { getWorkspacePath } from "../config/workspace-path-helpers.js";
 import "../config/index.js";

package/dist/src/workflows/service/workflow-run-service.js

@@ -4,8 +4,8 @@ import { publishAutomationProductEvent } from "../../automations/product-events.
 import { GoalService } from "../../goals/goal-service.js";
 import "../../goals/index.js";
 import { DelegateSubagentRunner } from "../../agent/workflow/subagent-runner.js";
-import { resolveModelRef } from "../../config/agent-typed-models.js";
 import { preflightWorkflowConnectors } from "../../connectors/workflow-preflight.js";
+import { resolveModelRef } from "../../config/agent-typed-models.js";
 import { CatalogWorkflowDefinitionRegistry } from "../registry/catalog-workflow-definition-registry.js";
 import { validateWorkflowJsonSchema } from "../domain/schema-validation.js";
 import { isTerminalWorkflowRunStatus } from "../domain/run.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.174",
+  "version": "0.0.175",
   "description": "Local-first AI system that remembers context, coordinates AI, and sustains long-term progress.",
   "type": "module",
   "main": "dist/src/index.js",