syncpoint-ai 0.1.0

package/dist/server/application/agent-registry-service.js

@@ -0,0 +1,279 @@
+import fs from "node:fs";
+import path from "node:path";
+import { createHash } from "node:crypto";
+import { detectUserAgentManifestFormatFromPath, isSupportedUserAgentManifestPath, parseUserAgentManifestContent, RuntimeStatus, toAgentCreateFromUserAgentManifest, toRuntimeAgentManifestInputFromUserAgentManifest, } from "../../adapters/index.js";
+import { InternalError } from "../../kernel/index.js";
+import { getSyncpointDir } from "../db.js";
+import { createAgent, getAgent, getAgentByName, updateAgentProfile, } from "../repositories/agent-repository.js";
+import { deleteAgentManifest, upsertAgentManifest, } from "../repositories/agent-manifest-repository.js";
+import { getAgentRegistryEntry, getAgentRegistryEntryByAgentId, listAgentRegistryEntries, upsertAgentRegistryEntry, } from "../repositories/agent-registry-repository.js";
+import { listRuntimes } from "../repositories/runtime-repository.js";
+export class AgentRegistryPathError extends InternalError {
+    constructor(message) {
+        super(message);
+        this.name = "AgentRegistryPathError";
+    }
+}
+export function getAgentManifestDirectory() {
+    return path.join(getSyncpointDir(), "agents");
+}
+export function ensureAgentManifestDirectory() {
+    const dir = getAgentManifestDirectory();
+    fs.mkdirSync(dir, { recursive: true });
+    return dir;
+}
+export function listDeclaredAgents(options) {
+    return listAgentRegistryEntries()
+        .filter(entry => options?.includeRemoved || entry.status !== "removed")
+        .map(toDeclaredAgentRecord)
+        .sort((a, b) => a.manifestPath.localeCompare(b.manifestPath));
+}
+export function syncDeclaredAgents() {
+    const files = listManifestFilesOnDisk();
+    const seen = new Set();
+    for (const filePath of files) {
+        const normalized = normalizeManifestPath(filePath);
+        seen.add(normalized.manifestPath);
+        syncDeclaredAgentFile(normalized.absolutePath);
+    }
+    for (const entry of listAgentRegistryEntries()) {
+        if (!entry.manifestPath.startsWith(".syncpoint/agents/"))
+            continue;
+        if (seen.has(entry.manifestPath))
+            continue;
+        removeDeclaredAgentFile(entry.manifestPath);
+    }
+    return listDeclaredAgents();
+}
+export function syncDeclaredAgentFile(filePath) {
+    const normalized = normalizeManifestPath(filePath);
+    const sourceFormat = detectUserAgentManifestFormatFromPath(normalized.absolutePath) ?? null;
+    const existing = getAgentRegistryEntry(normalized.manifestPath);
+    if (!sourceFormat) {
+        return persistAgentRegistryError({
+            manifestPath: normalized.manifestPath,
+            sourceFormat,
+            contentHash: existing?.contentHash ?? "",
+            manifest: existing?.manifest ?? null,
+            agentId: existing?.agentId ?? null,
+            error: new AgentRegistryPathError(`Unsupported agent manifest file: ${normalized.manifestPath}`),
+        });
+    }
+    if (!fs.existsSync(normalized.absolutePath)) {
+        return removeDeclaredAgentFile(normalized.absolutePath) ?? persistAgentRegistryError({
+            manifestPath: normalized.manifestPath,
+            sourceFormat,
+            contentHash: "",
+            manifest: existing?.manifest ?? null,
+            agentId: existing?.agentId ?? null,
+            error: new AgentRegistryPathError(`Agent manifest not found: ${normalized.manifestPath}`),
+        });
+    }
+    const content = fs.readFileSync(normalized.absolutePath, "utf8");
+    const contentHash = createContentHash(content);
+    let parsedManifest = null;
+    try {
+        parsedManifest = parseUserAgentManifestContent(content, sourceFormat);
+        const agent = upsertDeclaredAgent(normalized.manifestPath, parsedManifest);
+        upsertAgentManifest({
+            agentId: agent.id,
+            ...toRuntimeAgentManifestInputFromUserAgentManifest(parsedManifest),
+        });
+        const entry = upsertAgentRegistryEntry({
+            manifestPath: normalized.manifestPath,
+            agentId: agent.id,
+            sourceFormat,
+            contentHash,
+            manifest: parsedManifest,
+            status: "active",
+            errorMessage: "",
+        });
+        return toDeclaredAgentRecord(entry);
+    }
+    catch (error) {
+        return persistAgentRegistryError({
+            manifestPath: normalized.manifestPath,
+            sourceFormat,
+            contentHash,
+            manifest: parsedManifest,
+            agentId: existing?.agentId ?? null,
+            error,
+        });
+    }
+}
+export function removeDeclaredAgentFile(filePath) {
+    const normalized = normalizeManifestPath(filePath);
+    const existing = getAgentRegistryEntry(normalized.manifestPath);
+    if (!existing)
+        return null;
+    if (existing.agentId) {
+        deleteAgentManifest(existing.agentId);
+    }
+    const entry = upsertAgentRegistryEntry({
+        manifestPath: normalized.manifestPath,
+        agentId: null,
+        sourceFormat: detectUserAgentManifestFormatFromPath(normalized.absolutePath) ?? existing.sourceFormat,
+        contentHash: "",
+        manifest: null,
+        status: "removed",
+        errorMessage: "",
+    });
+    return toDeclaredAgentRecord(entry);
+}
+function listManifestFilesOnDisk() {
+    const dir = getAgentManifestDirectory();
+    if (!fs.existsSync(dir))
+        return [];
+    return fs.readdirSync(dir, { withFileTypes: true })
+        .filter(entry => entry.isFile() && isSupportedUserAgentManifestPath(entry.name))
+        .map(entry => path.join(dir, entry.name))
+        .sort((a, b) => a.localeCompare(b));
+}
+function upsertDeclaredAgent(manifestPath, manifest) {
+    const desiredProfile = toAgentCreateFromUserAgentManifest(manifest);
+    const existingEntry = getAgentRegistryEntry(manifestPath);
+    if (existingEntry?.agentId) {
+        const existingAgent = tryGetAgent(existingEntry.agentId);
+        if (existingAgent) {
+            return updateAgentProfile(existingAgent.id, desiredProfile);
+        }
+    }
+    const existingByName = getAgentByName(manifest.name);
+    if (existingByName) {
+        const boundEntry = getAgentRegistryEntryByAgentId(existingByName.id);
+        if (!boundEntry || boundEntry.manifestPath === manifestPath || releaseStaleBinding(boundEntry)) {
+            return updateAgentProfile(existingByName.id, desiredProfile);
+        }
+    }
+    return createAgent(desiredProfile);
+}
+function releaseStaleBinding(entry) {
+    if (entry.status === "removed") {
+        clearAgentBinding(entry);
+        return true;
+    }
+    const absolutePath = absolutePathFromStoredManifestPath(entry.manifestPath);
+    if (fs.existsSync(absolutePath))
+        return false;
+    if (entry.agentId) {
+        deleteAgentManifest(entry.agentId);
+    }
+    clearAgentBinding(entry, "removed");
+    return true;
+}
+function clearAgentBinding(entry, status = entry.status) {
+    return upsertAgentRegistryEntry({
+        manifestPath: entry.manifestPath,
+        agentId: null,
+        sourceFormat: entry.sourceFormat,
+        contentHash: status === "removed" ? "" : entry.contentHash,
+        manifest: status === "removed" ? null : entry.manifest,
+        status,
+        errorMessage: status === "removed" ? "" : entry.errorMessage,
+        lastSyncAt: entry.lastSyncAt,
+    });
+}
+function persistAgentRegistryError(input) {
+    const entry = upsertAgentRegistryEntry({
+        manifestPath: input.manifestPath,
+        agentId: input.agentId,
+        sourceFormat: input.sourceFormat,
+        contentHash: input.contentHash,
+        manifest: input.manifest,
+        status: "error",
+        errorMessage: getErrorMessage(input.error),
+    });
+    return toDeclaredAgentRecord(entry);
+}
+function toDeclaredAgentRecord(entry) {
+    const absolutePath = absolutePathFromStoredManifestPath(entry.manifestPath);
+    const boundAgent = entry.agentId ? tryGetAgent(entry.agentId) : null;
+    const availability = computeAvailability(entry, boundAgent);
+    return {
+        manifestPath: entry.manifestPath,
+        absolutePath,
+        exists: fs.existsSync(absolutePath),
+        sourceFormat: entry.sourceFormat,
+        contentHash: entry.contentHash,
+        status: entry.status,
+        availability,
+        errorMessage: entry.errorMessage,
+        lastSyncAt: entry.lastSyncAt,
+        agentId: entry.agentId,
+        name: entry.manifest?.name ?? boundAgent?.name ?? null,
+        profile: entry.manifest?.profile ?? null,
+        provider: entry.manifest?.provider ?? boundAgent?.provider ?? null,
+        role: entry.manifest?.role ?? boundAgent?.role ?? null,
+        manifest: entry.manifest,
+    };
+}
+function computeAvailability(entry, boundAgent) {
+    if (entry.status === "error")
+        return "error";
+    if (entry.status === "removed")
+        return "removed";
+    if (entry.status === "pending")
+        return "available";
+    // status === "active" — check runtime binding
+    if (boundAgent) {
+        const runtimeOnline = isAgentRuntimeOnline(boundAgent.id);
+        return runtimeOnline ? "running" : "offline";
+    }
+    return "available";
+}
+function isAgentRuntimeOnline(agentId) {
+    try {
+        const runtimes = listRuntimes();
+        return runtimes.some((rt) => rt.agentId === agentId && rt.status === RuntimeStatus.ACTIVE);
+    }
+    catch {
+        return false;
+    }
+}
+function normalizeManifestPath(filePath) {
+    const projectRoot = resolveProjectRoot();
+    const absolutePath = path.resolve(projectRoot, filePath);
+    const manifestDir = path.resolve(getAgentManifestDirectory());
+    const relativeToManifestDir = path.relative(manifestDir, absolutePath);
+    if (relativeToManifestDir.startsWith("..") || path.isAbsolute(relativeToManifestDir)) {
+        throw new AgentRegistryPathError(`Agent manifest path must be inside ${manifestDir}: ${filePath}`);
+    }
+    const relativeToRoot = path.relative(projectRoot, absolutePath);
+    if (relativeToRoot.startsWith("..") || path.isAbsolute(relativeToRoot)) {
+        throw new AgentRegistryPathError(`Agent manifest path must resolve inside ${projectRoot}: ${filePath}`);
+    }
+    return {
+        absolutePath,
+        manifestPath: toStoredPath(relativeToRoot),
+    };
+}
+function absolutePathFromStoredManifestPath(manifestPath) {
+    return path.resolve(resolveProjectRoot(), fromStoredPath(manifestPath));
+}
+function resolveProjectRoot() {
+    const envRoot = process.env.SYNCPOINT_PROJECT_ROOT?.trim();
+    if (envRoot)
+        return path.resolve(envRoot);
+    return path.resolve(path.dirname(getSyncpointDir()));
+}
+function toStoredPath(value) {
+    return value.split(path.sep).join("/");
+}
+function fromStoredPath(value) {
+    return value.split("/").join(path.sep);
+}
+function tryGetAgent(agentId) {
+    try {
+        return getAgent(agentId);
+    }
+    catch {
+        return null;
+    }
+}
+function createContentHash(content) {
+    return createHash("sha256").update(content).digest("hex");
+}
+function getErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=agent-registry-service.js.map

package/dist/server/application/agent-registry-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-registry-service.js","sourceRoot":"","sources":["../../../_build/src/server/application/agent-registry-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,qCAAqC,EACrC,gCAAgC,EAChC,6BAA6B,EAC7B,aAAa,EACb,kCAAkC,EAClC,gDAAgD,GACjD,MAAM,yBAAyB,CAAC;AAMjC,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EACL,WAAW,EACX,QAAQ,EACR,cAAc,EACd,kBAAkB,GACnB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EACL,qBAAqB,EACrB,8BAA8B,EAC9B,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,8CAA8C,CAAC;AAKtD,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAsBrE,MAAM,OAAO,sBAAuB,SAAQ,aAAa;IACvD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,MAAM,UAAU,yBAAyB;IACvC,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,QAAQ,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC1C,MAAM,GAAG,GAAG,yBAAyB,EAAE,CAAC;IACxC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAElC;IACC,OAAO,wBAAwB,EAAE;SAC9B,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC;SACtE,GAAG,CAAC,qBAAqB,CAAC;SAC1B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,MAAM,KAAK,GAAG,uBAAuB,EAAE,CAAC;IACxC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QACnD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;QAClC,qBAAqB,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,wBAAwB,EAAE,EAAE,CAAC;QAC/C,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC,oBAAoB,CAAC;YAAE,SAAS;QACnE,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC;YAAE,SAAS;QAC3C,uBAAuB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,kBAAkB,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,MAAM,UAAU,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,YAAY,GAAG,qCAAqC,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC;IAC5F,MAAM,QAAQ,GAAG,qBAAqB,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IAEhE,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,yBAAyB,CAAC;YAC/B,YAAY,EAAE,UAAU,CAAC,YAAY;YACrC,YAAY;YACZ,WAAW,EAAE,QAAQ,EAAE,WAAW,IAAI,EAAE;YACxC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,IAAI,IAAI;YACpC,OAAO,EAAE,QAAQ,EAAE,OAAO,IAAI,IAAI;YAClC,KAAK,EAAE,IAAI,sBAAsB,CAAC,oCAAoC,UAAU,CAAC,YAAY,EAAE,CAAC;SACjG,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC5C,OAAO,uBAAuB,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,yBAAyB,CAAC;YACnF,YAAY,EAAE,UAAU,CAAC,YAAY;YACrC,YAAY;YACZ,WAAW,EAAE,EAAE;YACf,QAAQ,EAAE,QAAQ,EAAE,QAAQ,IAAI,IAAI;YACpC,OAAO,EAAE,QAAQ,EAAE,OAAO,IAAI,IAAI;YAClC,KAAK,EAAE,IAAI,sBAAsB,CAAC,6BAA6B,UAAU,CAAC,YAAY,EAAE,CAAC;SAC1F,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACjE,MAAM,WAAW,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,cAAc,GAA6B,IAAI,CAAC;IAEpD,IAAI,CAAC;QACH,cAAc,GAAG,6BAA6B,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACtE,MAAM,KAAK,GAAG,mBAAmB,CAAC,UAAU,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;QAC3E,mBAAmB,CAAC;YAClB,OAAO,EAAE,KAAK,CAAC,EAAE;YACjB,GAAG,gDAAgD,CAAC,cAAc,CAAC;SACpE,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,wBAAwB,CAAC;YACrC,YAAY,EAAE,UAAU,CAAC,YAAY;YACrC,OAAO,EAAE,KAAK,CAAC,EAAE;YACjB,YAAY;YACZ,WAAW;YACX,QAAQ,EAAE,cAAc;YACxB,MAAM,EAAE,QAAQ;YAChB,YAAY,EAAE,EAAE;SACjB,CAAC,CAAC;QAEH,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,yBAAyB,CAAC;YAC/B,YAAY,EAAE,UAAU,CAAC,YAAY;YACrC,YAAY;YACZ,WAAW;YACX,QAAQ,EAAE,cAAc;YACxB,OAAO,EAAE,QAAQ,EAAE,OAAO,IAAI,IAAI;YAClC,KAAK;SACN,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,QAAgB;IACtD,MAAM,UAAU,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IAEhE,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3B,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrB,mBAAmB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,KAAK,GAAG,wBAAwB,CAAC;QACrC,YAAY,EAAE,UAAU,CAAC,YAAY;QACrC,OAAO,EAAE,IAAI;QACb,YAAY,EAAE,qCAAqC,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,QAAQ,CAAC,YAAY;QACrG,WAAW,EAAE,EAAE;QACf,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,SAAS;QACjB,YAAY,EAAE,EAAE;KACjB,CAAC,CAAC;IAEH,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,uBAAuB;IAC9B,MAAM,GAAG,GAAG,yBAAyB,EAAE,CAAC;IACxC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,OAAO,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SAChD,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,gCAAgC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;SAC/E,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;SACxC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,mBAAmB,CAAC,YAAoB,EAAE,QAA2B;IAC5E,MAAM,cAAc,GAAG,kCAAkC,CAAC,QAAQ,CAAC,CAAC;IACpE,MAAM,aAAa,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAC;IAE1D,IAAI,aAAa,EAAE,OAAO,EAAE,CAAC;QAC3B,MAAM,aAAa,GAAG,WAAW,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QACzD,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO,kBAAkB,CAAC,aAAa,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,MAAM,cAAc,GAAG,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACrD,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,UAAU,GAAG,8BAA8B,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;QACrE,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,YAAY,KAAK,YAAY,IAAI,mBAAmB,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/F,OAAO,kBAAkB,CAAC,cAAc,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAC,cAAc,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAyB;IACpD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,YAAY,GAAG,kCAAkC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC5E,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,KAAK,CAAC;IAE9C,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,mBAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACpC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,iBAAiB,CACxB,KAAyB,EACzB,SAAmC,KAAK,CAAC,MAAM;IAE/C,OAAO,wBAAwB,CAAC;QAC9B,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,OAAO,EAAE,IAAI;QACb,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,WAAW,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW;QAC1D,QAAQ,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ;QACtD,MAAM;QACN,YAAY,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY;QAC5D,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC,CAAC;AACL,CAAC;AAED,SAAS,yBAAyB,CAAC,KAOlC;IACC,MAAM,KAAK,GAAG,wBAAwB,CAAC;QACrC,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE,OAAO;QACf,YAAY,EAAE,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC;KAC3C,CAAC,CAAC;IAEH,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAyB;IACtD,MAAM,YAAY,GAAG,kCAAkC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC5E,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACrE,MAAM,YAAY,GAAG,mBAAmB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAE5D,OAAO;QACL,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,YAAY;QACZ,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC;QACnC,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,YAAY;QACZ,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,IAAI,UAAU,EAAE,IAAI,IAAI,IAAI;QACtD,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,IAAI,IAAI;QACxC,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,QAAQ,IAAI,UAAU,EAAE,QAAQ,IAAI,IAAI;QAClE,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,IAAI,UAAU,EAAE,IAAI,IAAI,IAAI;QACtD,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAC1B,KAAyB,EACzB,UAAiC;IAEjC,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IAC7C,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACjD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IAEnD,8CAA8C;IAC9C,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,aAAa,GAAG,oBAAoB,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAC1D,OAAO,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,oBAAoB,CAAC,OAAe;IAC3C,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;QAChC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,EAA8C,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,KAAK,OAAO,IAAI,EAAE,CAAC,MAAM,KAAK,aAAa,CAAC,MAAM,CAAC,CAAC;IACzI,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,QAAgB;IAI7C,MAAM,WAAW,GAAG,kBAAkB,EAAE,CAAC;IACzC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACzD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAAC;IAC9D,MAAM,qBAAqB,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAEvE,IAAI,qBAAqB,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,qBAAqB,CAAC,EAAE,CAAC;QACrF,MAAM,IAAI,sBAAsB,CAC9B,sCAAsC,WAAW,KAAK,QAAQ,EAAE,CACjE,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAChE,IAAI,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,sBAAsB,CAC9B,2CAA2C,WAAW,KAAK,QAAQ,EAAE,CACtE,CAAC;IACJ,CAAC;IAED,OAAO;QACL,YAAY;QACZ,YAAY,EAAE,YAAY,CAAC,cAAc,CAAC;KAC3C,CAAC;AACJ,CAAC;AAED,SAAS,kCAAkC,CAAC,YAAoB;IAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,kBAAkB;IACzB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,IAAI,EAAE,CAAC;IAC3D,IAAI,OAAO;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,WAAW,CAAC,OAAe;IAClC,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAe;IACxC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/server/application/backing-store-reconciliation-service.d.ts

@@ -0,0 +1,20 @@
+export interface ReconcileInput {
+    taskId: string;
+    sessionId?: string;
+}
+export interface ReconcileResult {
+    scannedFiles: number;
+    bypassesDetected: number;
+    gatesCreated: string[];
+    gatesReused: string[];
+}
+export interface ReconcileFileResult {
+    locator: string;
+    bypassed: boolean;
+    gateId?: string;
+    reusedGate: boolean;
+}
+export declare function __clearReconciliationStateForTest(): void;
+export declare function recordAuthorizedWrite(root: string, locator: string): void;
+export declare function reconcileBackingStore(input: ReconcileInput): ReconcileResult;
+//# sourceMappingURL=backing-store-reconciliation-service.d.ts.map

package/dist/server/application/backing-store-reconciliation-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backing-store-reconciliation-service.d.ts","sourceRoot":"","sources":["../../../_build/src/server/application/backing-store-reconciliation-service.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;CACrB;AAID,wBAAgB,iCAAiC,IAAI,IAAI,CAExD;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAQzE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,GAAG,eAAe,CAmC5E"}

package/dist/server/application/backing-store-reconciliation-service.js

@@ -0,0 +1,150 @@
+import { createHash } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { EventType, SyncGateReason } from "../../kernel/index.js";
+import * as protocolRepo from "../repositories/_exports/protocol.js";
+import { logEvent, now } from "../repositories/_shared.js";
+import { getSyncpointDir } from "../db.js";
+import { sgRequest, sgListActive } from "./sync-gate-service.js";
+import { rcList } from "./resource-claim-service.js";
+const lastKnownHashes = new Map();
+export function __clearReconciliationStateForTest() {
+    lastKnownHashes.clear();
+}
+export function recordAuthorizedWrite(root, locator) {
+    const filePath = path.resolve(root, locator);
+    try {
+        const hash = hashFile(filePath);
+        lastKnownHashes.set(normalizeKey(root, locator), hash);
+    }
+    catch {
+        lastKnownHashes.delete(normalizeKey(root, locator));
+    }
+}
+export function reconcileBackingStore(input) {
+    const root = resolveProjectRoot();
+    const claims = rcList({
+        sessionId: input.sessionId,
+        resourceType: "file",
+        status: "ACTIVE",
+    });
+    const locators = new Set();
+    for (const claim of claims) {
+        for (const resource of claim.resources) {
+            if (resource.type === "file")
+                locators.add(resource.locator);
+        }
+    }
+    const result = {
+        scannedFiles: 0,
+        bypassesDetected: 0,
+        gatesCreated: [],
+        gatesReused: [],
+    };
+    for (const locator of locators) {
+        const fileResult = reconcileFile(root, locator, claims, input);
+        result.scannedFiles++;
+        if (fileResult.bypassed) {
+            result.bypassesDetected++;
+            if (fileResult.gateId) {
+                if (fileResult.reusedGate)
+                    result.gatesReused.push(fileResult.gateId);
+                else
+                    result.gatesCreated.push(fileResult.gateId);
+            }
+        }
+    }
+    return result;
+}
+function reconcileFile(root, locator, claims, input) {
+    const key = normalizeKey(root, locator);
+    const filePath = path.resolve(root, locator);
+    let currentHash;
+    try {
+        currentHash = hashFile(filePath);
+    }
+    catch {
+        // File doesn't exist — if we had a known hash, that's a bypass (delete)
+        if (lastKnownHashes.has(key)) {
+            lastKnownHashes.delete(key);
+            return handleBypass(root, locator, claims, input);
+        }
+        return { locator, bypassed: false, reusedGate: false };
+    }
+    const knownHash = lastKnownHashes.get(key);
+    if (knownHash === undefined) {
+        // First time seeing this file — record baseline, no bypass
+        lastKnownHashes.set(key, currentHash);
+        return { locator, bypassed: false, reusedGate: false };
+    }
+    if (knownHash === currentHash) {
+        return { locator, bypassed: false, reusedGate: false };
+    }
+    // Hash changed without going through writeApply — bypass detected
+    lastKnownHashes.set(key, currentHash);
+    return handleBypass(root, locator, claims, input);
+}
+function handleBypass(root, locator, claims, input) {
+    const resource = { type: "file", scope: "file", locator, metadata: "" };
+    const affectedClaims = claims.filter(claim => claim.resources.some(r => r.type === "file" && r.locator === locator));
+    const affectedActorIds = [...new Set(affectedClaims.map(c => c.actorId))];
+    const relatedClaimIds = affectedClaims.map(c => c.id);
+    logEvent(EventType.BACKING_STORE_BYPASS_DETECTED, "backing_store_reconciliation", locator, JSON.stringify({
+        taskId: input.taskId,
+        sessionId: input.sessionId ?? "",
+        locator,
+        affectedActorIds,
+        relatedClaimIds,
+        detectedAt: now(),
+    }));
+    // Check for existing bypass gate for this resource
+    const existingGate = sgListActive({ taskId: input.taskId, sessionId: input.sessionId })
+        .find(g => g.reason === SyncGateReason.BACKING_STORE_BYPASS &&
+        (g.relatedFiles.includes(locator) ||
+            g.relatedResources.some(r => r.locator === locator)));
+    if (existingGate) {
+        // Update description with new detection
+        const gate = protocolRepo.getSyncGate(existingGate.id);
+        const note = `Backing store bypass detected again: ${locator} (${now()})`;
+        if (!gate.description.includes(note)) {
+            protocolRepo.updateSyncGateDescription(existingGate.id, `${gate.description} ${note}`);
+        }
+        return { locator, bypassed: true, gateId: existingGate.id, reusedGate: true };
+    }
+    // Create a new BACKING_STORE_BYPASS gate
+    const requiredAgentIds = affectedActorIds.length > 0 ? affectedActorIds : ["unknown"];
+    const result = sgRequest({
+        sessionId: input.sessionId,
+        taskId: input.taskId,
+        requestedByAgentId: "syncpoint-reconciler",
+        requiredAgentIds,
+        reason: SyncGateReason.BACKING_STORE_BYPASS,
+        description: `Backing store bypass detected: ${locator} was modified outside SyncPoint. Claimed by: ${affectedActorIds.join(", ") || "unknown"}.`,
+        relatedFiles: [locator],
+        relatedResources: [resource],
+        relatedClaimIds,
+    });
+    return { locator, bypassed: true, gateId: result.gate.id, reusedGate: false };
+}
+function resolveProjectRoot() {
+    const envRoot = process.env.SYNCPOINT_PROJECT_ROOT;
+    if (envRoot)
+        return canonicalRoot(envRoot);
+    return canonicalRoot(path.dirname(getSyncpointDir()));
+}
+function canonicalRoot(root) {
+    const resolved = path.resolve(root);
+    try {
+        return fs.realpathSync.native(resolved);
+    }
+    catch {
+        return resolved;
+    }
+}
+function normalizeKey(root, locator) {
+    return `${root}::${locator.replace(/\\/g, "/")}`;
+}
+function hashFile(filePath) {
+    return createHash("sha256").update(fs.readFileSync(filePath)).digest("hex");
+}
+//# sourceMappingURL=backing-store-reconciliation-service.js.map

package/dist/server/application/backing-store-reconciliation-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backing-store-reconciliation-service.js","sourceRoot":"","sources":["../../../_build/src/server/application/backing-store-reconciliation-service.ts"],"names":[],"mappings":"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"}

package/dist/server/application/bootstrap.d.ts

@@ -0,0 +1,12 @@
+export interface ApplicationBootstrapPluginStatus {
+    code: boolean;
+    genericAgent: boolean;
+}
+export interface ApplicationBootstrapStatus {
+    initialized: boolean;
+    plugins: ApplicationBootstrapPluginStatus;
+}
+export declare function getApplicationBootstrapStatus(): ApplicationBootstrapStatus;
+export declare function ensureApplicationBootstrap(): ApplicationBootstrapStatus;
+export declare function resetApplicationBootstrapForTest(): void;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/server/application/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../../_build/src/server/application/bootstrap.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,gCAAgC;IAC/C,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,gCAAgC,CAAC;CAC3C;AAwCD,wBAAgB,6BAA6B,IAAI,0BAA0B,CAQ1E;AAED,wBAAgB,0BAA0B,IAAI,0BAA0B,CAKvE;AAED,wBAAgB,gCAAgC,IAAI,IAAI,CAMvD"}

package/dist/server/application/bootstrap.js

@@ -0,0 +1,58 @@
+import { clearScopeMatcherRegistry, getScopeMatcher } from "../../context/index.js";
+import { clearConstraintEvaluatorRegistry, getConstraintEvaluator } from "../../governance/index.js";
+import { clearResourceMatcherRegistry, clearValidatorRegistry, getResourceMatcher, getValidatorsForOperation } from "../../kernel/index.js";
+import { CODE_PLUGIN_VALIDATORS, registerCodePlugin, } from "../../plugins/code/index.js";
+import { GENERIC_RESOURCE_TYPES, GENERIC_VALIDATORS, registerGenericAgentPlugin, } from "../../plugins/generic-agent/index.js";
+let _initialized = false;
+const CODE_VALIDATOR_NAMES = new Set(CODE_PLUGIN_VALIDATORS.map(validator => validator.name));
+const GENERIC_VALIDATOR_NAMES = new Set(GENERIC_VALIDATORS.map(validator => validator.name));
+function hasValidators(operationType, resourceTypes, expectedNames) {
+    const registeredNames = new Set(getValidatorsForOperation(operationType, resourceTypes).map(validator => validator.name));
+    for (const expectedName of expectedNames) {
+        if (!registeredNames.has(expectedName)) {
+            return false;
+        }
+    }
+    return true;
+}
+function hasResourceMatchers(resourceTypes) {
+    return resourceTypes.every(resourceType => !!getResourceMatcher(resourceType));
+}
+function isCodePluginReady() {
+    return !!getResourceMatcher("file") &&
+        hasValidators("code_patch", ["file"], CODE_VALIDATOR_NAMES) &&
+        !!getConstraintEvaluator("file_forbidden") &&
+        !!getConstraintEvaluator("module_forbidden") &&
+        !!getScopeMatcher("files") &&
+        !!getScopeMatcher("modules");
+}
+function isGenericAgentPluginReady() {
+    return hasResourceMatchers([...GENERIC_RESOURCE_TYPES]) &&
+        hasValidators("artifact_update", ["artifact"], GENERIC_VALIDATOR_NAMES) &&
+        !!getConstraintEvaluator("resource_forbidden") &&
+        !!getScopeMatcher("resources") &&
+        !!getScopeMatcher("assetTypes");
+}
+export function getApplicationBootstrapStatus() {
+    return {
+        initialized: _initialized,
+        plugins: {
+            code: isCodePluginReady(),
+            genericAgent: isGenericAgentPluginReady(),
+        },
+    };
+}
+export function ensureApplicationBootstrap() {
+    registerCodePlugin();
+    registerGenericAgentPlugin();
+    _initialized = true;
+    return getApplicationBootstrapStatus();
+}
+export function resetApplicationBootstrapForTest() {
+    clearValidatorRegistry();
+    clearResourceMatcherRegistry();
+    clearConstraintEvaluatorRegistry();
+    clearScopeMatcherRegistry();
+    _initialized = false;
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/server/application/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../../_build/src/server/application/bootstrap.ts"],"names":[],"mappings":"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"}

package/dist/server/application/checkpoint-review-service.d.ts

@@ -0,0 +1,72 @@
+/**
+ * CheckpointReview Service — checkpoint-driven approval reviews.
+ *
+ * Use cases:
+ *   stxCreate   — create a checkpoint review + bound SyncGate
+ *   stxSubmit   — move OPEN → WAITING_APPROVAL
+ *   stxApprove  — approver approves
+ *   stxReject   — approver rejects
+ *   stxResolve  — resolve review + release gate
+ *   stxCancel   — cancel review + cancel gate
+ *   stxStatus   — get review status with pending info
+ *   stxList     — list reviews with optional filters
+ *
+ * Public function names keep the `stx*` prefix for transport-layer stability.
+ */
+import type { CheckpointReview } from "../../governance/index.js";
+export interface SyncTxCreateInput {
+    sessionId: string;
+    taskId: string;
+    checkpointId: string;
+    requestingAgentId: string;
+    requiredApproverIds: string[];
+}
+export interface SyncTxStatusResult {
+    tx: CheckpointReview;
+    pending: string[];
+    allApproved: boolean;
+    hasRejection: boolean;
+    isBlocking: boolean;
+}
+/**
+ * Create a sync transaction. Automatically creates a bound SyncGate
+ * with reason=checkpoint_required and moves the transaction to WAITING_APPROVAL.
+ */
+export declare function stxCreate(input: SyncTxCreateInput): SyncTxStatusResult;
+/**
+ * Approver approves a sync transaction.
+ */
+export declare function stxApprove(txId: string, agentId: string, summary?: string): SyncTxStatusResult;
+/**
+ * Approver rejects a sync transaction.
+ */
+export declare function stxReject(txId: string, agentId: string, reason?: string): SyncTxStatusResult;
+/**
+ * Resolve a sync transaction → RESOLVED and release the bound SyncGate.
+ * Can be called after APPROVED (normal flow) or REJECTED (after follow-up).
+ */
+export declare function stxResolve(txId: string, decisionSummary?: string): SyncTxStatusResult;
+/**
+ * Cancel a sync transaction and its bound SyncGate.
+ */
+export declare function stxCancel(txId: string, reason?: string): CheckpointReview;
+/**
+ * Get detailed transaction status.
+ */
+export declare function stxStatus(txId: string): SyncTxStatusResult;
+/**
+ * List sync transactions with optional filters.
+ */
+export declare function stxList(opts?: {
+    sessionId?: string;
+    taskId?: string;
+    status?: string;
+}): CheckpointReview[];
+/**
+ * List active (blocking) sync transactions.
+ */
+export declare function stxListActive(opts?: {
+    sessionId?: string;
+    taskId?: string;
+}): CheckpointReview[];
+//# sourceMappingURL=checkpoint-review-service.d.ts.map

package/dist/server/application/checkpoint-review-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-review-service.d.ts","sourceRoot":"","sources":["../../../_build/src/server/application/checkpoint-review-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAOlE,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,gBAAgB,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;CACrB;AAID;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,iBAAiB,GAAG,kBAAkB,CA8CtE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAsC9F;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAoC5F;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,kBAAkB,CA0BrF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,gBAAgB,CA0BzE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAG1D;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,CAAC,EAAE;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,gBAAgB,EAAE,CAErB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,gBAAgB,EAAE,CAErB"}