@sema-agent/server 1.311.0 → 1.312.0

package/dist/plugins/store-contracts.js

@@ -0,0 +1,61 @@
+import { parseJsonOr, toIso as iso, normalizeIsoOrNull as isoOrNull } from "./sql-row-helpers.js";
+export function mapBakeRow(r) {
+    return {
+        bakeId: r.bake_id,
+        profile: r.profile,
+        bands: r.bands == null ? null : parseJsonOr(r.bands, []),
+        baseRef: r.base_ref,
+        push: !!r.push,
+        dryRun: !!r.dry_run,
+        logs: !!r.logs,
+        argv: parseJsonOr(r.argv, []),
+        status: r.status,
+        state: r.state ?? null,
+        digest: r.digest,
+        repo: r.repo,
+        ref: r.ref,
+        indexId: r.index_id,
+        exitCode: r.exit_code === null ? null : Number(r.exit_code),
+        error: r.error,
+        errorCode: r.error_code ?? null,
+        manifestSha: r.manifest_sha,
+        tag: r.tag,
+        idemKey: r.idem_key,
+        ingestSecret: r.ingest_secret,
+        runnerId: r.runner_id,
+        leaseUntil: isoOrNull(r.lease_until),
+        cancelRequested: !!r.cancel_requested,
+        requestedBy: r.requested_by,
+        createdAt: iso(r.created_at),
+        updatedAt: iso(r.updated_at),
+    };
+}
+export const BAKE_SELECT_COLS = "bake_id, profile, bands, base_ref, push, dry_run, logs, argv, status, state, digest, repo, ref, index_id, " +
+    "exit_code, error, error_code, manifest_sha, tag, idem_key, ingest_secret, runner_id, lease_until, " +
+    "cancel_requested, requested_by, created_at, updated_at";
+export function mapImageRow(r) {
+    return {
+        id: r.id,
+        profile: r.profile,
+        bands: parseJsonOr(r.bands, []),
+        repo: r.repo,
+        tag: r.tag,
+        digest: r.digest,
+        toolchainVersions: parseJsonOr(r.toolchain_versions, {}),
+        capabilities: parseJsonOr(r.capabilities, {}),
+        podContract: parseJsonOr(r.pod_contract, {}),
+        sizeBytes: r.size_bytes === null ? null : Number(r.size_bytes),
+        status: r.status,
+        visibility: r.visibility,
+        tenantId: r.tenant_id,
+        manifestSha: r.manifest_sha,
+        recipeGitSha: r.recipe_git_sha,
+        generatorVersion: r.generator_version,
+        buildDate: isoOrNull(r.build_date),
+        supersedes: r.supersedes,
+        signed: !!r.signed,
+        createdAt: isoOrNull(r.created_at) ?? new Date(0).toISOString(),
+        updatedAt: isoOrNull(r.updated_at) ?? new Date(0).toISOString(),
+    };
+}
+//# sourceMappingURL=store-contracts.js.map

package/dist/plugins/tidb-image-bake.d.ts

@@ -1,99 +1,7 @@
 import type { Pool } from "mysql2/promise";
-export type BakeStatus = "queued" | "running" | "done" | "failed";
-export type BakeState = "PENDING" | "BUILDING" | "PUSHING" | "VERIFYING" | "REGISTERING" | "COMPLETE" | "FAILED" | "CANCELLED";
-export type BakeErrorCode = "band-conflict" | "duplicate" | "disk" | "timeout" | "cancelled" | null;
-export interface BakeRecord {
-    bakeId: string;
-    profile: string;
-    bands: string[] | null;
-    baseRef: string | null;
-    push: boolean;
-    dryRun: boolean;
-    logs: boolean;
-    argv: string[];
-    status: BakeStatus;
-    state: BakeState | null;
-    digest: string | null;
-    repo: string | null;
-    ref: string | null;
-    indexId: string | null;
-    exitCode: number | null;
-    error: string | null;
-    errorCode: BakeErrorCode;
-    manifestSha: string | null;
-    tag: string | null;
-    idemKey: string | null;
-    ingestSecret: string | null;
-    runnerId: string | null;
-    leaseUntil: string | null;
-    cancelRequested: boolean;
-    requestedBy: string | null;
-    createdAt: string;
-    updatedAt: string;
-}
-export interface BakeEvent {
-    seq: number;
-    lineOrd: number | null;
-    kind: string;
-    level: string | null;
-    data: unknown;
-    ts: string;
-}
-export interface CreateBakeInput {
-    profile: string;
-    bands: string[] | null;
-    baseRef: string | null;
-    push: boolean;
-    dryRun: boolean;
-    logs: boolean;
-    argv: string[];
-    idemKey: string | null;
-    requestedBy: string | null;
-}
-export interface BakeTerminal {
-    status: "done" | "failed";
-    state: BakeState;
-    digest?: string | null;
-    repo?: string | null;
-    ref?: string | null;
-    indexId?: string | null;
-    exitCode?: number | null;
-    error?: string | null;
-    errorCode?: BakeErrorCode;
-    manifestSha?: string | null;
-    tag?: string | null;
-}
-export interface BakeRow {
-    bake_id: string;
-    profile: string;
-    bands: unknown;
-    base_ref: string | null;
-    push: number;
-    dry_run: number;
-    logs: number;
-    argv: unknown;
-    status: string;
-    state: string | null;
-    digest: string | null;
-    repo: string | null;
-    ref: string | null;
-    index_id: string | null;
-    exit_code: number | string | null;
-    error: string | null;
-    error_code: string | null;
-    manifest_sha: string | null;
-    tag: string | null;
-    idem_key: string | null;
-    ingest_secret: string | null;
-    runner_id: string | null;
-    lease_until: Date | string | null;
-    cancel_requested: number;
-    requested_by: string | null;
-    created_at: Date | string;
-    updated_at: Date | string;
-}
-export declare function mapRow(r: BakeRow): BakeRecord;
-export declare const SELECT_COLS: string;
+import { type BakeStatus, type BakeState, type BakeRecord, type BakeEvent, type CreateBakeInput, type BakeTerminal } from "./store-contracts.js";
+export type { BakeStatus, BakeState, BakeErrorCode, BakeRecord, BakeEvent, CreateBakeInput, BakeTerminal, BakeRow, } from "./store-contracts.js";
+export { mapBakeRow as mapRow, BAKE_SELECT_COLS as SELECT_COLS } from "./store-contracts.js";
 export declare class TiDBImageBake {
     private readonly pool;
     private readonly poolName;

package/dist/plugins/tidb-image-bake.js

@@ -1,6 +1,8 @@
 import { uuidv7 } from "@sema-agent/core";
 import { randomBytes } from "node:crypto";
-import { parseJsonOr as parseJson, toIso as iso, normalizeIsoOrNull as isoOrNull } from "./sql-row-helpers.js";
+import { parseJsonOr as parseJson, toIso as iso } from "./sql-row-helpers.js";
+import { mapBakeRow as mapRow, BAKE_SELECT_COLS as SELECT_COLS, } from "./store-contracts.js";
+export { mapBakeRow as mapRow, BAKE_SELECT_COLS as SELECT_COLS } from "./store-contracts.js";
 function isDupKey(err) {
     return Boolean(err) && err.code === "ER_DUP_ENTRY";
 }
@@ -12,40 +14,6 @@ function dupKeyName(err) {
         return "primary";
     return "other";
 }
-export function mapRow(r) {
-    return {
-        bakeId: r.bake_id,
-        profile: r.profile,
-        bands: r.bands == null ? null : parseJson(r.bands, []),
-        baseRef: r.base_ref,
-        push: !!r.push,
-        dryRun: !!r.dry_run,
-        logs: !!r.logs,
-        argv: parseJson(r.argv, []),
-        status: r.status,
-        state: r.state ?? null,
-        digest: r.digest,
-        repo: r.repo,
-        ref: r.ref,
-        indexId: r.index_id,
-        exitCode: r.exit_code === null ? null : Number(r.exit_code),
-        error: r.error,
-        errorCode: r.error_code ?? null,
-        manifestSha: r.manifest_sha,
-        tag: r.tag,
-        idemKey: r.idem_key,
-        ingestSecret: r.ingest_secret,
-        runnerId: r.runner_id,
-        leaseUntil: isoOrNull(r.lease_until),
-        cancelRequested: !!r.cancel_requested,
-        requestedBy: r.requested_by,
-        createdAt: iso(r.created_at),
-        updatedAt: iso(r.updated_at),
-    };
-}
-export const SELECT_COLS = "bake_id, profile, bands, base_ref, push, dry_run, logs, argv, status, state, digest, repo, ref, index_id, " +
-    "exit_code, error, error_code, manifest_sha, tag, idem_key, ingest_secret, runner_id, lease_until, " +
-    "cancel_requested, requested_by, created_at, updated_at";
 export class TiDBImageBake {
     pool;
     poolName;

package/dist/plugins/tidb-image-index.d.ts

@@ -1,80 +1,7 @@
 import type { Pool } from "mysql2/promise";
-export type ImageNestedBuildMode = "none" | "docker-cli-only" | "rootless-buildkit" | "privileged-dind";
-export interface ImageCapabilities {
-    browser?: boolean;
-    db?: boolean;
-    nestedBuild?: boolean;
-    nestedBuildMode?: ImageNestedBuildMode;
-}
-export interface ImagePodContract {
-    devShmMB?: number;
-    minMemMB?: number;
-    minCpu?: string;
-    readyTimeoutSec?: number;
-    securityContext?: Record<string, unknown>;
-}
-export type ImageStatus = "building" | "published" | "deprecated" | "failed";
-export type ImageVisibility = "public" | "tenant";
-export interface ImageIndexEntry {
-    id: string;
-    profile: string;
-    bands: string[];
-    repo: string;
-    tag: string;
-    digest: string;
-    toolchainVersions: Record<string, string>;
-    capabilities: ImageCapabilities;
-    podContract: ImagePodContract;
-    sizeBytes: number | null;
-    status: ImageStatus;
-    visibility: ImageVisibility;
-    tenantId: string | null;
-    manifestSha: string | null;
-    recipeGitSha: string | null;
-    generatorVersion: string | null;
-    buildDate: string | null;
-    supersedes: string | null;
-    signed: boolean;
-    createdAt: string;
-    updatedAt: string;
-}
-export type ImageIndexUpsert = Omit<ImageIndexEntry, "id" | "createdAt" | "updatedAt">;
-export interface ImageViewer {
-    operator?: boolean;
-    tenantId?: string | null;
-}
-export interface ImageListFilter extends ImageViewer {
-    profile?: string;
-    status?: ImageStatus;
-    capability?: keyof ImageCapabilities;
-    latestOnly?: boolean;
-    limit?: number;
-    cursor?: string;
-}
-export interface ImageRow {
-    id: string;
-    profile: string;
-    bands: unknown;
-    repo: string;
-    tag: string;
-    digest: string;
-    toolchain_versions: unknown;
-    capabilities: unknown;
-    pod_contract: unknown;
-    size_bytes: number | string | null;
-    status: string;
-    visibility: string;
-    tenant_id: string | null;
-    manifest_sha: string | null;
-    recipe_git_sha: string | null;
-    generator_version: string | null;
-    build_date: Date | string | null;
-    supersedes: string | null;
-    signed: number;
-    created_at: Date | string;
-    updated_at: Date | string;
-}
-export declare function mapRow(r: ImageRow): ImageIndexEntry;
+import { type ImageStatus, type ImageIndexEntry, type ImageIndexUpsert, type ImageViewer, type ImageListFilter } from "./store-contracts.js";
+export type { ImageNestedBuildMode, ImageCapabilities, ImagePodContract, ImageStatus, ImageVisibility, ImageIndexEntry, ImageIndexUpsert, ImageViewer, ImageListFilter, ImageRow, } from "./store-contracts.js";
+export { mapImageRow as mapRow } from "./store-contracts.js";
 export declare class TiDBImageIndex {
     private readonly pool;
     constructor(pool: Pool);

package/dist/plugins/tidb-image-index.js

@@ -1,32 +1,8 @@
 import { createHash } from "node:crypto";
-import { parseJsonOr as asJson, normalizeIsoOrNull as iso } from "./sql-row-helpers.js";
+import { mapImageRow as mapRow, } from "./store-contracts.js";
+export { mapImageRow as mapRow } from "./store-contracts.js";
 const MAX_LIMIT = 200;
 const DEFAULT_LIMIT = 50;
-export function mapRow(r) {
-    return {
-        id: r.id,
-        profile: r.profile,
-        bands: asJson(r.bands, []),
-        repo: r.repo,
-        tag: r.tag,
-        digest: r.digest,
-        toolchainVersions: asJson(r.toolchain_versions, {}),
-        capabilities: asJson(r.capabilities, {}),
-        podContract: asJson(r.pod_contract, {}),
-        sizeBytes: r.size_bytes === null ? null : Number(r.size_bytes),
-        status: r.status,
-        visibility: r.visibility,
-        tenantId: r.tenant_id,
-        manifestSha: r.manifest_sha,
-        recipeGitSha: r.recipe_git_sha,
-        generatorVersion: r.generator_version,
-        buildDate: iso(r.build_date),
-        supersedes: r.supersedes,
-        signed: !!r.signed,
-        createdAt: iso(r.created_at) ?? new Date(0).toISOString(),
-        updatedAt: iso(r.updated_at) ?? new Date(0).toISOString(),
-    };
-}
 function visibilityClause(viewer) {
     if (viewer.operator)
         return { sql: "1=1", params: [] };

package/dist/plugins/tidb-pool.d.ts

@@ -1,6 +1,6 @@
 import mysql from "mysql2/promise";
 import type { Pool, PoolConnection } from "mysql2/promise";
-import type { ServiceConfig } from "../config.js";
+import type { ServiceConfig } from "../config-types.js";
 export declare function tidbPoolOptions(tidb: NonNullable<ServiceConfig["tidb"]>): mysql.PoolOptions;
 export declare function createTidbPool(config: ServiceConfig): Pool;
 export declare const SCHEMA_STATEMENTS: readonly string[];

package/dist/plugins/tidb-run-store.d.ts

@@ -1,38 +1,8 @@
 import type { TaskResult, TaskStatus } from "@sema-agent/core";
 import { type UsageRow } from "../usage-analytics.js";
 import type { Pool } from "mysql2/promise";
-export interface RunRecord {
-    taskId: string;
-    sessionId: string;
-    owner: string | null;
-    status: "running" | TaskStatus;
-    result: TaskResult | null;
-    error: string | null;
-    errorCode: string | null;
-    jobId: string | null;
-    source: string | null;
-    instanceId: string | null;
-    objectivePreview: string | null;
-    createdAt: string;
-    updatedAt: string;
-}
-export interface SessionSummary {
-    sessionId: string;
-    owner: string | null;
-    lastActivityAt: string;
-    firstActivityAt: string;
-    runCount: number;
-    objectivePreview: string | null;
-    lastStatus: string;
-    lastRunId: string | null;
-    title: string | null;
-}
-export interface RunEvent {
-    seq: number;
-    type: string;
-    data: unknown;
-    ts: string;
-}
+import type { RunRecord, SessionSummary, RunEvent } from "./store-contracts.js";
+export type { RunRecord, SessionSummary, RunEvent } from "./store-contracts.js";
 export declare class TiDBRunStore {
     private readonly pool;
     constructor(pool: Pool);

package/dist/plugins/tidb-run-store.js

@@ -1,5 +1,5 @@
 import { projectUsageStats, USAGE_SCAN_LIMIT } from "../usage-analytics.js";
-import { escapeLike } from "./tidb-tool-result-store.js";
+import { escapeLike } from "./sql-escape.js";
 import { parseJsonLenient as parseJson, toIso as iso } from "./sql-row-helpers.js";
 function isDupKey(err) {
     return Boolean(err) && err.code === "ER_DUP_ENTRY";

package/dist/plugins/tidb-session-store.d.ts

@@ -1,7 +1,7 @@
 import { type AcquiredSession, type SessionStore, type SessionTreeEntry } from "@sema-agent/core";
 import type { Pool } from "mysql2/promise";
-import type { SessionSummary } from "./tidb-run-store.js";
-import { type StagingHandle } from "../session-sync.js";
+import type { SessionSummary } from "./store-contracts.js";
+import { type StagingHandle } from "../session-sync-kernel.js";
 export declare class TiDBSessionStore implements SessionStore {
     private readonly pool;
     private readonly pending;

package/dist/plugins/tidb-session-store.js

@@ -1,7 +1,7 @@
 import { StoredSession, SessionError, uuidv7, validateEntriesForImport, leafIdAfterEntry } from "@sema-agent/core";
 import { TiDBSessionStorage } from "./tidb-session-storage.js";
-import { escapeLike } from "./tidb-tool-result-store.js";
-import { classifySyncRelationshipByIds, SyncConflictError, stagingIdFor, STAGING_ID_MARKER, } from "../session-sync.js";
+import { escapeLike } from "./sql-escape.js";
+import { classifySyncRelationshipByIds, SyncConflictError, stagingIdFor, STAGING_ID_MARKER, } from "../session-sync-kernel.js";
 const STAGING_GC_GRACE_MS = 3_600_000;
 export class TiDBSessionStore {
     pool;

package/dist/plugins/tidb-tool-result-store.d.ts

@@ -1,5 +1,6 @@
 import type { ToolResultStore, ToolResultSlice } from "@sema-agent/core";
 import type { Pool } from "mysql2/promise";
+export { escapeLike } from "./sql-escape.js";
 export declare class TiDBToolResultStore implements ToolResultStore {
     private readonly pool;
     constructor(pool: Pool);
@@ -11,5 +12,4 @@ export declare class TiDBToolResultStore implements ToolResultStore {
     reapOlderThan(cutoffMs: number): Promise<number>;
     deleteBySession(sessionId: string): Promise<number>;
 }
-export declare function escapeLike(s: string): string;
 //# sourceMappingURL=tidb-tool-result-store.d.ts.map

package/dist/plugins/tidb-tool-result-store.js

@@ -1,3 +1,5 @@
+import { escapeLike } from "./sql-escape.js";
+export { escapeLike } from "./sql-escape.js";
 export class TiDBToolResultStore {
     pool;
     constructor(pool) {
@@ -35,7 +37,4 @@ export class TiDBToolResultStore {
         return res.affectedRows;
     }
 }
-export function escapeLike(s) {
-    return s.replace(/[\\%_]/g, (ch) => `\\${ch}`);
-}
 //# sourceMappingURL=tidb-tool-result-store.js.map

package/dist/security.d.ts

@@ -1,8 +1,11 @@
 import type { IncomingMessage } from "node:http";
 import { FileMemoryEngineBackend, type SessionStore, type SessionTreeEntry } from "@sema-agent/core";
-import type { ServiceConfig } from "./config.js";
-import type { TaskRequestBody } from "./http/server.js";
-import type { StagingHandle } from "./session-sync.js";
+import type { ServiceConfig } from "./config-types.js";
+import type { TaskRequestBody } from "./http/wire-types.js";
+import type { StagingHandle } from "./session-sync-kernel.js";
+import type { ApprovalHmacKey, PrincipalJwtKey } from "./auth-keys.js";
+export { parseApprovalHmacKeys, parsePrincipalJwks } from "./auth-keys.js";
+export type { ApprovalHmacKey, PrincipalJwtKey } from "./auth-keys.js";
 export interface SessionListItem {
     sessionId: string;
     owner: string | null;
@@ -92,12 +95,6 @@ export declare function memorySpecForRequest(scope: string | undefined, memoryWr
     writeScope?: string | null;
     scopeContract?: "v2";
 } | undefined;
-export interface ApprovalHmacKey {
-    kid: string;
-    key: string;
-    status?: "active" | "retiring";
-}
-export declare function parseApprovalHmacKeys(raw: string | undefined): ApprovalHmacKey[];
 export declare function approvalHmacMessage(env: {
     sessionId: string;
     boundCallId?: string | null;
@@ -113,13 +110,6 @@ export declare function verifyApprovalHmac(env: {
     decision: string;
     reason?: string | null;
 }, mac: string, kid: string | undefined, keys: ApprovalHmacKey[]): boolean;
-export interface PrincipalJwtKey {
-    kid: string;
-    alg: "EdDSA" | "RS256" | "ES256";
-    key: string;
-    status?: "active" | "retiring";
-}
-export declare function parsePrincipalJwks(raw: string | undefined): PrincipalJwtKey[];
 export declare function verifyPrincipalJwt(token: string, keys: PrincipalJwtKey[], expect: {
     iss: string;
     aud: string;

package/dist/security.js

@@ -2,6 +2,7 @@ import { createHash, createHmac, createPublicKey, timingSafeEqual, verify as cry
 import { join } from "node:path";
 import { uuidv7, FileMemoryEngineBackend, resolveMemoryEngineRoot, deriveControlPlaneDir, formatUserScope, formatProjScope } from "@sema-agent/core";
 import { PROJECT_ID_REGEX } from "@sema-agent/registry-core";
+export { parseApprovalHmacKeys, parsePrincipalJwks } from "./auth-keys.js";
 const UUIDV7_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
 export function isUuidV7(s) {
     return UUIDV7_RE.test(s);
@@ -162,19 +163,6 @@ export function memorySpecForRequest(scope, memoryWrite, defaultScopes) {
     const v2 = isV2(scope) || extras.some(isV2) ? { scopeContract: "v2" } : {};
     return memoryWrite === false ? { scope, ...layered, writeScope: null, ...v2 } : { scope, ...layered, ...v2 };
 }
-export function parseApprovalHmacKeys(raw) {
-    if (!raw)
-        return [];
-    try {
-        const v = JSON.parse(raw);
-        if (!Array.isArray(v))
-            return [];
-        return v.filter((k) => !!k && typeof k.kid === "string" && typeof k.key === "string");
-    }
-    catch {
-        return [];
-    }
-}
 export function approvalHmacMessage(env) {
     return JSON.stringify([env.sessionId, env.boundCallId ?? null, env.boundInputHash ?? null, env.decision, env.reason ?? null]);
 }
@@ -200,23 +188,6 @@ export function verifyApprovalHmac(env, mac, kid, keys) {
     }
     return false;
 }
-export function parsePrincipalJwks(raw) {
-    if (!raw)
-        return [];
-    const ALGS = new Set(["EdDSA", "RS256", "ES256"]);
-    try {
-        const v = JSON.parse(raw);
-        if (!Array.isArray(v))
-            return [];
-        return v.filter((k) => {
-            const e = k;
-            return !!e && typeof e.kid === "string" && typeof e.key === "string" && typeof e.alg === "string" && ALGS.has(e.alg);
-        });
-    }
-    catch {
-        return [];
-    }
-}
 function b64urlToBuf(s) {
     return Buffer.from(s, "base64url");
 }

package/dist/sema-registry.d.ts

@@ -1,6 +1,6 @@
 import type { McpServerSpec } from "@sema-agent/core";
 import { type EntitlementRuntimeCaps } from "@sema-agent/registry-core";
-import type { ScopedMcpServer, ServiceConfig } from "./config.js";
+import type { ScopedMcpServer, ServiceConfig } from "./config-types.js";
 import { type SealedKeyOpener } from "./sealed-key.js";
 import type { Autonomy, CommandRule } from "./runtime-governance.js";
 import type { Logger } from "./observability/logger.js";

package/dist/session-sync-kernel.d.ts

@@ -0,0 +1,47 @@
+import type { SessionTreeEntry } from "@sema-agent/core";
+export interface StagingHandle {
+    readonly stagingId: string;
+    readonly realSessionId: string;
+    appendBatch(entries: SessionTreeEntry[]): Promise<void>;
+    commit(owner: string | null, opts?: {
+        resolution?: "overwrite-dst";
+    }): Promise<{
+        relation: SyncRelation["relation"];
+    }>;
+    abort(): Promise<void>;
+}
+export type ImportStagingStore = {
+    beginImportStaging(realSessionId: string, token: string): StagingHandle;
+    sweepStagingSessions?(): Promise<number>;
+};
+export declare function stagingIdFor(realSessionId: string, token: string): string;
+export declare const STAGING_ID_MARKER = "#stg-";
+export declare function realIdOfStaging(stagingId: string): string | null;
+export type SyncRelation = {
+    relation: "fresh";
+} | {
+    relation: "identical";
+} | {
+    relation: "fast_forward";
+    newEntryIds: string[];
+} | {
+    relation: "stale";
+    dstAheadBy: string[];
+} | {
+    relation: "fork";
+    commonAncestor: string | null;
+    srcExclusive: string[];
+    dstExclusive: string[];
+};
+export declare function classifySyncRelationship(srcEntries: SessionTreeEntry[], dstEntries: SessionTreeEntry[] | null): SyncRelation;
+export declare function classifySyncRelationshipByIds(srcIds: string[], dstIds: string[] | null): SyncRelation;
+export declare class SyncConflictError extends Error {
+    readonly sessionId: string;
+    readonly relation: Extract<SyncRelation, {
+        relation: "fork" | "stale";
+    }>;
+    constructor(sessionId: string, relation: Extract<SyncRelation, {
+        relation: "fork" | "stale";
+    }>);
+}
+//# sourceMappingURL=session-sync-kernel.d.ts.map

package/dist/session-sync-kernel.js

@@ -0,0 +1,47 @@
+export function stagingIdFor(realSessionId, token) {
+    return `${realSessionId}#stg-${token}`;
+}
+export const STAGING_ID_MARKER = "#stg-";
+export function realIdOfStaging(stagingId) {
+    const i = stagingId.indexOf(STAGING_ID_MARKER);
+    return i < 0 ? null : stagingId.slice(0, i);
+}
+export function classifySyncRelationship(srcEntries, dstEntries) {
+    return classifySyncRelationshipByIds(srcEntries.map((e) => e.id), dstEntries === null ? null : dstEntries.map((e) => e.id));
+}
+export function classifySyncRelationshipByIds(srcIds, dstIds) {
+    if (dstIds === null || dstIds.length === 0)
+        return { relation: "fresh" };
+    const srcSet = new Set(srcIds);
+    const dstSet = new Set(dstIds);
+    if (srcSet.size === dstSet.size && [...srcSet].every((id) => dstSet.has(id)))
+        return { relation: "identical" };
+    const allDstInSrc = [...dstSet].every((id) => srcSet.has(id));
+    const allSrcInDst = [...srcSet].every((id) => dstSet.has(id));
+    if (allDstInSrc && !allSrcInDst) {
+        const newEntryIds = srcIds.filter((id) => !dstSet.has(id));
+        return { relation: "fast_forward", newEntryIds };
+    }
+    if (allSrcInDst && !allDstInSrc) {
+        const dstAheadBy = dstIds.filter((id) => !srcSet.has(id));
+        return { relation: "stale", dstAheadBy };
+    }
+    const srcExclusive = srcIds.filter((id) => !dstSet.has(id));
+    const dstExclusive = dstIds.filter((id) => !srcSet.has(id));
+    let commonAncestor = null;
+    for (const id of srcIds)
+        if (dstSet.has(id))
+            commonAncestor = id;
+    return { relation: "fork", commonAncestor, srcExclusive, dstExclusive };
+}
+export class SyncConflictError extends Error {
+    sessionId;
+    relation;
+    constructor(sessionId, relation) {
+        super(`session-sync: refusing to import session ${sessionId} — ${relation.relation} (would lose destination history; resolve explicitly)`);
+        this.sessionId = sessionId;
+        this.relation = relation;
+        this.name = "SyncConflictError";
+    }
+}
+//# sourceMappingURL=session-sync-kernel.js.map