peaks-loop 4.0.53 → 4.1.0

package/dist/services/share/bundle-reader.d.ts

@@ -28,8 +28,8 @@
  * (readBundle, ReadBundleArgs, ReadBundleResult, the four error
  * classes) is preserved verbatim.
  */
-import type Database from "better-sqlite3";
-import { SHARE_BUNDLE_ERROR_CODES, type PeaksBundleKind } from "./bundle-types.js";
+import type Database from 'better-sqlite3';
+import { SHARE_BUNDLE_ERROR_CODES, type PeaksBundleKind } from './bundle-types.js';
 /**
  * Thrown when `format_version_major !== 1`. This is the explicit
  * HARD block per spec §7A.2 (major mismatch).
@@ -88,7 +88,7 @@ export type ReadBundleResult = {
     assetId: string | number;
     kind: PeaksBundleKind;
     /** Always `candidate` — the reader does not honor any other status. */
-    importedAs: "candidate";
+    importedAs: 'candidate';
     /** Non-fatal warnings (e.g. minor-version mismatch). */
     warnings: string[];
     /** Count of crystallization_event rows imported. */

package/dist/services/share/bundle-reader.js

@@ -28,11 +28,11 @@
  * (readBundle, ReadBundleArgs, ReadBundleResult, the four error
  * classes) is preserved verbatim.
  */
-import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync, rmSync, } from "node:fs";
-import { join } from "node:path";
-import { ZodError } from "zod";
-import { runTar } from "../skillhub/tar-runtime.js";
-import { PEAKS_BUNDLE_FORMAT_VERSION_MAJOR, PEAKS_BUNDLE_SCHEMA_VERSIONS, SHARE_BUNDLE_ERROR_CODES, BundleManifestSchema, } from "./bundle-types.js";
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { ZodError } from 'zod';
+import { runTar } from '../skillhub/tar-runtime.js';
+import { PEAKS_BUNDLE_FORMAT_VERSION_MAJOR, PEAKS_BUNDLE_SCHEMA_VERSIONS, SHARE_BUNDLE_ERROR_CODES, BundleManifestSchema } from './bundle-types.js';
 /* ---------------------------------------------------------------------- */
 /* Reader errors                                                            */
 /* ---------------------------------------------------------------------- */
@@ -45,7 +45,7 @@ export class BundleMajorVersionMismatchError extends Error {
     receivedMajor;
     constructor(receivedMajor) {
         super(`bundle declares format_version_major=${receivedMajor}; the only supported major is ${PEAKS_BUNDLE_FORMAT_VERSION_MAJOR} (spec §7A.2)`);
-        this.name = "BundleMajorVersionMismatchError";
+        this.name = 'BundleMajorVersionMismatchError';
         this.code = SHARE_BUNDLE_ERROR_CODES.MAJOR_VERSION_MISMATCH;
         this.receivedMajor = receivedMajor;
     }
@@ -59,7 +59,7 @@ export class BundleSchemaVersionsMismatchError extends Error {
     received;
     constructor(received) {
         super(`bundle schema_versions mapping is missing or carries non-canonical literals (spec §7A.2). expected=${JSON.stringify(PEAKS_BUNDLE_SCHEMA_VERSIONS)} received=${JSON.stringify(received)}`);
-        this.name = "BundleSchemaVersionsMismatchError";
+        this.name = 'BundleSchemaVersionsMismatchError';
         this.code = SHARE_BUNDLE_ERROR_CODES.SCHEMA_VERSIONS_MISMATCH;
         this.received = received;
     }
@@ -72,7 +72,7 @@ export class BundleImportToStableForbiddenError extends Error {
     code;
     constructor(receivedStatus) {
         super(`bundles cannot land as '${receivedStatus}'; the only allowed target is 'candidate' (spec §7A.2). promotion to stable requires an evolution_evaluation row with an independent_scorer_verdict`);
-        this.name = "BundleImportToStableForbiddenError";
+        this.name = 'BundleImportToStableForbiddenError';
         this.code = SHARE_BUNDLE_ERROR_CODES.IMPORT_TO_STABLE_FORBIDDEN;
     }
 }
@@ -85,7 +85,7 @@ export class BundleMalformedError extends Error {
     code;
     constructor(message) {
         super(`bundle is malformed: ${message}`);
-        this.name = "BundleMalformedError";
+        this.name = 'BundleMalformedError';
         this.code = SHARE_BUNDLE_ERROR_CODES.BUNDLE_MALFORMED;
     }
 }
@@ -96,9 +96,7 @@ export class BundleMalformedError extends Error {
 const SHA256_RE = /^[0-9a-f]{64}$/;
 /** Coerce a possibly-unknown value to a string lifecycle status, defaulting to "candidate". */
 function readSourceLifecycle(release) {
-    return typeof release.lifecycle_status === "string"
-        ? release.lifecycle_status
-        : "candidate";
+    return typeof release.lifecycle_status === 'string' ? release.lifecycle_status : 'candidate';
 }
 /**
  * Enforce the AC-25 hard rule: bundles always land as `candidate`;
@@ -106,7 +104,7 @@ function readSourceLifecycle(release) {
  * for defense in depth.
  */
 function enforceImportAsCandidate(status) {
-    if (status !== "candidate") {
+    if (status !== 'candidate') {
         throw new BundleImportToStableForbiddenError(status);
     }
 }
@@ -117,12 +115,12 @@ function bool01(value, defaultValue) {
     return value ? 1 : 0;
 }
 /** Coerce an unknown value to a string column value (empty string default). */
-function str(value, defaultValue = "") {
-    return typeof value === "string" ? value : defaultValue;
+function str(value, defaultValue = '') {
+    return typeof value === 'string' ? value : defaultValue;
 }
 /** Coerce an unknown value to a string-or-null column value. */
 function strOrNull(value) {
-    return typeof value === "string" ? value : null;
+    return typeof value === 'string' ? value : null;
 }
 /** Coerce an unknown value to a JSON-stringified column value. */
 function jsonArr(value) {
@@ -130,7 +128,7 @@ function jsonArr(value) {
 }
 /** Coerce an unknown value to an ISO-8601 string (now() default). */
 function isoOrNow(value) {
-    return typeof value === "string" ? value : new Date().toISOString();
+    return typeof value === 'string' ? value : new Date().toISOString();
 }
 /** Now as an ISO string. */
 function nowIso() {
@@ -148,7 +146,7 @@ function readDirEntries(dir) {
 /** Read and JSON.parse a file, throwing BundleMalformedError on parse failure. */
 function readJsonOrThrow(path) {
     try {
-        return JSON.parse(readFileSync(path, "utf-8"));
+        return JSON.parse(readFileSync(path, 'utf-8'));
     }
     catch (err) {
         throw new BundleMalformedError(`manifest.json could not be parsed: ${err instanceof Error ? err.message : String(err)}`);
@@ -162,10 +160,10 @@ export function readBundle(args) {
     if (!existsSync(inPath)) {
         throw new BundleMalformedError(`bundle file not found at '${inPath}'`);
     }
-    const stageDir = inPath + ".extract";
+    const stageDir = inPath + '.extract';
     resetStageDir(stageDir);
     try {
-        runTar(["-xzf", inPath, "-C", stageDir]);
+        runTar(['-xzf', inPath, '-C', stageDir]);
         const manifest = loadStageManifest(stageDir);
         materialiseBlobs(stageDir, blobsDir);
         const assetId = KIND_IMPORTERS[manifest.kind](db, manifest, blobsDir, args.asName);
@@ -190,9 +188,9 @@ function resetStageDir(stageDir) {
  * BundleMalformedError if the file is missing.
  */
 function loadStageManifest(stageDir) {
-    const manifestPath = join(stageDir, "manifest.json");
+    const manifestPath = join(stageDir, 'manifest.json');
     if (!existsSync(manifestPath)) {
-        throw new BundleMalformedError("bundle is missing manifest.json (writer is required to emit it)");
+        throw new BundleMalformedError('bundle is missing manifest.json (writer is required to emit it)');
     }
     return parseManifest(readJsonOrThrow(manifestPath));
 }
@@ -201,7 +199,7 @@ function loadStageManifest(stageDir) {
  * the layout (`blobs/<sha256>`) is identical for both.
  */
 function materialiseBlobs(stageDir, blobsDir) {
-    const blobsStageDir = join(stageDir, "blobs");
+    const blobsStageDir = join(stageDir, 'blobs');
     if (!existsSync(blobsStageDir))
         return;
     mkdirSync(blobsDir, { recursive: true });
@@ -223,43 +221,39 @@ function materialiseBlobs(stageDir, blobsDir) {
 function buildReadResult(manifest, assetId) {
     const warnings = manifest.format_version_minor === 0
         ? []
-        : [
-            `minor-version=${manifest.format_version_minor}; supported but flagging for awareness`,
-        ];
+        : [`minor-version=${manifest.format_version_minor}; supported but flagging for awareness`];
     return {
         assetId,
         kind: manifest.kind,
-        importedAs: "candidate",
+        importedAs: 'candidate',
         warnings,
-        evidenceBriefCount: manifest.evidence_briefs.length,
+        evidenceBriefCount: manifest.evidence_briefs.length
     };
 }
 /* ---------------------------------------------------------------------- */
 /* Manifest parsing — enforces the major-version hard block                  */
 /* ---------------------------------------------------------------------- */
 function parseManifest(raw) {
-    if (!raw ||
-        typeof raw !== "object" ||
-        Array.isArray(raw)) {
-        throw new BundleMalformedError("manifest must be a JSON object");
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        throw new BundleMalformedError('manifest must be a JSON object');
     }
     // Defense in depth: even if Zod would accept, we layer an early
     // major-mismatch guard so the CLI can surface a specific error
     // code (SHARE_BUNDLE_MAJOR_VERSION_MISMATCH) before the Zod
     // schema-version mapping fatal-error path fires.
     const candidate = raw;
-    if (typeof candidate.format_version_major === "number" &&
+    if (typeof candidate.format_version_major === 'number' &&
         candidate.format_version_major !== PEAKS_BUNDLE_FORMAT_VERSION_MAJOR) {
         throw new BundleMajorVersionMismatchError(candidate.format_version_major);
     }
-    if (typeof candidate.format_constant !== "string") {
-        throw new BundleMalformedError("manifest is missing format_constant");
+    if (typeof candidate.format_constant !== 'string') {
+        throw new BundleMalformedError('manifest is missing format_constant');
     }
-    if (candidate.format_constant !== "peaks.bundle/1") {
+    if (candidate.format_constant !== 'peaks.bundle/1') {
         throw new BundleMalformedError(`format_constant must be "peaks.bundle/1"; received '${candidate.format_constant}'`);
     }
-    if (!("schema_versions" in candidate) ||
-        typeof candidate.schema_versions !== "object" ||
+    if (!('schema_versions' in candidate) ||
+        typeof candidate.schema_versions !== 'object' ||
         candidate.schema_versions === null ||
         Array.isArray(candidate.schema_versions)) {
         throw new BundleSchemaVersionsMismatchError(undefined);
@@ -269,29 +263,29 @@ function parseManifest(raw) {
     }
     catch (err) {
         if (err instanceof ZodError) {
-            const schemaIssue = err.issues.find((i) => i.path[0] === "schema_versions");
+            const schemaIssue = err.issues.find((i) => i.path[0] === 'schema_versions');
             if (schemaIssue) {
                 throw new BundleSchemaVersionsMismatchError(candidate.schema_versions);
             }
             throw new BundleMalformedError(`manifest failed schema validation: ${err.issues
-                .map((i) => `${i.path.join(".")}:${i.message}`)
-                .join("; ")}`);
+                .map((i) => `${i.path.join('.')}:${i.message}`)
+                .join('; ')}`);
         }
         throw err;
     }
 }
 const KIND_IMPORTERS = {
     loop: (db, manifest, _blobsDir, asName) => importLoopBundle(db, manifest, asName),
-    bee: (db, manifest, blobsDir, asName) => importBeeBundle(db, manifest, blobsDir, asName),
+    bee: (db, manifest, blobsDir, asName) => importBeeBundle(db, manifest, blobsDir, asName)
 };
 /* ---------------------------------------------------------------------- */
 /* Loop import                                                              */
 /* ---------------------------------------------------------------------- */
 function importLoopBundle(db, manifest, asName) {
     const srcLoop = manifest.loop_release;
-    const srcId = String(srcLoop.id ?? "");
+    const srcId = String(srcLoop.id ?? '');
     if (!srcId)
-        throw new BundleMalformedError("loop_release is missing id");
+        throw new BundleMalformedError('loop_release is missing id');
     const srcStatus = readSourceLifecycle(srcLoop);
     enforceImportAsCandidate(srcStatus);
     const targetId = asName ?? srcId;
@@ -330,31 +324,46 @@ function buildLoopRow(srcLoop, targetId) {
         crystallization_evidence_json: jsonArr(srcLoop.crystallization_evidence),
         // The reader always lands as candidate — the source's lifecycle
         // status is silently overridden (spec §7A.2 hard rule).
-        lifecycle_status: "candidate",
+        lifecycle_status: 'candidate',
         version: srcLoop.version,
-        schema_version: typeof srcLoop.schema_version === "string" && srcLoop.schema_version.length > 0
+        schema_version: typeof srcLoop.schema_version === 'string' && srcLoop.schema_version.length > 0
             ? srcLoop.schema_version
             : PEAKS_BUNDLE_SCHEMA_VERSIONS.loop,
         archived_at: isoOrNow(srcLoop.archived_at),
         shareable: bool01(srcLoop.shareable, 1),
         share_excluded_paths: jsonArr(srcLoop.share_excluded_paths),
         desktop_visible: bool01(srcLoop.desktop_visible, 1),
-        export_bundle_format: typeof srcLoop.export_bundle_format === "string"
+        export_bundle_format: typeof srcLoop.export_bundle_format === 'string'
             ? srcLoop.export_bundle_format
-            : "peaks.bundle/1",
+            : 'peaks.bundle/1'
     };
 }
 const LOOP_RELEASE_COLUMNS = [
-    "id", "name", "scenario", "trigger_policy",
-    "success_criteria_json", "interaction_policy", "feedback_policy", "evolution_policy",
-    "evaluator_policy_json", "linked_bees_json", "run_history_json", "crystallization_evidence_json",
-    "lifecycle_status", "version", "schema_version", "archived_at",
-    "shareable", "share_excluded_paths", "desktop_visible", "export_bundle_format",
+    'id',
+    'name',
+    'scenario',
+    'trigger_policy',
+    'success_criteria_json',
+    'interaction_policy',
+    'feedback_policy',
+    'evolution_policy',
+    'evaluator_policy_json',
+    'linked_bees_json',
+    'run_history_json',
+    'crystallization_evidence_json',
+    'lifecycle_status',
+    'version',
+    'schema_version',
+    'archived_at',
+    'shareable',
+    'share_excluded_paths',
+    'desktop_visible',
+    'export_bundle_format'
 ];
 /** Insert one loop_release row (or replace on conflict). */
 function insertLoopReleaseRow(db, row) {
-    const placeholders = LOOP_RELEASE_COLUMNS.map(() => "?").join(", ");
-    db.prepare(`INSERT OR REPLACE INTO loop_release (${LOOP_RELEASE_COLUMNS.join(", ")}) VALUES (${placeholders})`).run(...LOOP_RELEASE_COLUMNS.map((c) => row[c]));
+    const placeholders = LOOP_RELEASE_COLUMNS.map(() => '?').join(', ');
+    db.prepare(`INSERT OR REPLACE INTO loop_release (${LOOP_RELEASE_COLUMNS.join(', ')}) VALUES (${placeholders})`).run(...LOOP_RELEASE_COLUMNS.map((c) => row[c]));
 }
 /**
  * Re-stamp relations (preserving source row content, but the
@@ -404,15 +413,13 @@ function materialiseSingleRelatedBee(db, entry) {
     const srcId = Number(release.id);
     if (!Number.isInteger(srcId) || srcId <= 0)
         return null;
-    const beeName = String(release.bee_name ?? "");
+    const beeName = String(release.bee_name ?? '');
     if (!beeName)
         return null;
     // Honour the same non-candidate hard rule at the bee row.
     enforceImportAsCandidate(readSourceLifecycle(release));
     // Pre-existing receiver-side bee with the same name → keep its id.
-    const existing = db
-        .prepare("SELECT id FROM bee_release WHERE bee_name = ?")
-        .get(beeName);
+    const existing = db.prepare('SELECT id FROM bee_release WHERE bee_name = ?').get(beeName);
     if (existing)
         return { srcId, newId: existing.id };
     return { srcId, newId: insertNewRelatedBee(db, release, entry.manifest) };
@@ -423,7 +430,7 @@ function insertNewRelatedBee(db, release, manifest) {
          bee_name, version, source, archived_at, archived_by, user_intent_raw,
          description, parent_version, changelog, shareable, desktop_visible
        ) VALUES (?, ?, 'user', ?, 'user', ?, ?, ?, ?, ?, ?)`)
-        .run(String(release.bee_name ?? ""), String(release.version ?? "0.0.0"), nowIso(), release.user_intent_raw ?? null, release.description ?? null, release.parent_version ?? null, release.changelog ?? null, release.shareable === false ? 0 : 1, release.desktop_visible === false ? 0 : 1);
+        .run(String(release.bee_name ?? ''), String(release.version ?? '0.0.0'), nowIso(), release.user_intent_raw ?? null, release.description ?? null, release.parent_version ?? null, release.changelog ?? null, release.shareable === false ? 0 : 1, release.desktop_visible === false ? 0 : 1);
     const newId = Number(info.lastInsertRowid);
     if (manifest)
         insertBeeManifestRow(db, newId, manifest);
@@ -435,12 +442,12 @@ function insertNewRelatedBee(db, release, manifest) {
 function importBeeBundle(db, manifest, _blobsDir, asName) {
     const beeObj = manifest.bee_release;
     if (!beeObj) {
-        throw new BundleMalformedError("bee_release payload missing from bee bundle");
+        throw new BundleMalformedError('bee_release payload missing from bee bundle');
     }
     const release = beeObj.bee_release;
-    const newBeeName = asName ?? String(release.bee_name ?? "");
+    const newBeeName = asName ?? String(release.bee_name ?? '');
     if (!newBeeName)
-        throw new BundleMalformedError("bee_release.bee_name missing");
+        throw new BundleMalformedError('bee_release.bee_name missing');
     // Same hard rule: any non-candidate import is refused. The reader
     // does not honor --as-stable switches.
     enforceImportAsCandidate(readSourceLifecycle(release));
@@ -462,7 +469,7 @@ function insertAnchorBeeRelease(db, release, beeName) {
          bee_name, version, source, archived_at, archived_by, user_intent_raw,
          description, parent_version, changelog, shareable, desktop_visible
        ) VALUES (?, ?, 'user', ?, 'user', ?, ?, ?, ?, ?, ?)`)
-        .run(beeName, String(release.version ?? "0.0.0"), nowIso(), release.user_intent_raw ?? null, release.description ?? null, release.parent_version ?? null, release.changelog ?? null, release.shareable === false ? 0 : 1, release.desktop_visible === false ? 0 : 1);
+        .run(beeName, String(release.version ?? '0.0.0'), nowIso(), release.user_intent_raw ?? null, release.description ?? null, release.parent_version ?? null, release.changelog ?? null, release.shareable === false ? 0 : 1, release.desktop_visible === false ? 0 : 1);
     return Number(info.lastInsertRowid);
 }
 /** Insert one bee_manifest row. */
@@ -471,7 +478,7 @@ function insertBeeManifestRow(db, releaseId, manifest) {
        release_id, schema_version, description, segments_json,
        entrypoint_preamble, promotion, min_cycles,
        requires_human, requires_smoke, retire_on_misses
-     ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(releaseId, String(manifest.schema_version ?? "peaks.bee/1"), String(manifest.description ?? ""), JSON.stringify(manifest.segments_json ?? []), strOrNull(manifest.entrypoint_preamble), String(manifest.promotion ?? "manual"), manifest.min_cycles ?? null, manifest.requires_human === undefined ? 1 : Number(manifest.requires_human), manifest.requires_smoke === undefined ? 1 : Number(manifest.requires_smoke), manifest.retire_on_misses ?? null);
+     ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(releaseId, String(manifest.schema_version ?? 'peaks.bee/1'), String(manifest.description ?? ''), JSON.stringify(manifest.segments_json ?? []), strOrNull(manifest.entrypoint_preamble), String(manifest.promotion ?? 'manual'), manifest.min_cycles ?? null, manifest.requires_human === undefined ? 1 : Number(manifest.requires_human), manifest.requires_smoke === undefined ? 1 : Number(manifest.requires_smoke), manifest.retire_on_misses ?? null);
 }
 /** Insert bee_segment_ref rows. */
 function insertBeeSegmentRows(db, releaseId, segments) {
@@ -481,7 +488,7 @@ function insertBeeSegmentRows(db, releaseId, segments) {
        release_id, segment_name, inputs_json, outputs_json, side_effects
      ) VALUES (?, ?, ?, ?, ?)`);
     for (const s of segments) {
-        stmt.run(releaseId, String(s.segment_name ?? ""), strOrNull(s.inputs_json), strOrNull(s.outputs_json), strOrNull(s.side_effects));
+        stmt.run(releaseId, String(s.segment_name ?? ''), strOrNull(s.inputs_json), strOrNull(s.outputs_json), strOrNull(s.side_effects));
     }
 }
 /** Insert bee_file rows. */
@@ -492,7 +499,7 @@ function insertBeeFileRows(db, releaseId, beeName, files) {
        release_id, owner_kind, owner_name, path, kind, size_bytes, sha256, blob_path
      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)`);
     for (const f of files) {
-        stmt.run(releaseId, String(f.owner_kind ?? "bee"), beeName, String(f.path ?? ""), String(f.kind ?? "other"), Number(f.size_bytes ?? 0), String(f.sha256 ?? ""), String(f.blob_path ?? ""));
+        stmt.run(releaseId, String(f.owner_kind ?? 'bee'), beeName, String(f.path ?? ''), String(f.kind ?? 'other'), Number(f.size_bytes ?? 0), String(f.sha256 ?? ''), String(f.blob_path ?? ''));
     }
 }
 /** Insert bee_change rows. */
@@ -503,6 +510,6 @@ function insertBeeChangeRows(db, releaseId, changes) {
        release_id, change_kind, target_kind, target_name, detail
      ) VALUES (?, ?, ?, ?, ?)`);
     for (const c of changes) {
-        stmt.run(releaseId, String(c.change_kind ?? ""), String(c.target_kind ?? ""), String(c.target_name ?? ""), strOrNull(c.detail));
+        stmt.run(releaseId, String(c.change_kind ?? ''), String(c.target_kind ?? ''), String(c.target_name ?? ''), strOrNull(c.detail));
     }
 }

package/dist/services/share/bundle-types.d.ts

@@ -61,75 +61,7 @@
  * Excludes (spec §7A.2 hard rules): private run_state, anything
  * under `.peaks/memory/personal/`, raw `state.db` rows.
  */
-import { z } from "zod";
-/**
- * The on-the-wire format constant, pinned to the literal
- * `"peaks.bundle/1"`. The CLI is the only writer — see `bundle-writer.ts`.
- * A future format change requires a major-version bump + a new writer.
- */
-export declare const PEAKS_BUNDLE_FORMAT_CONSTANT: "peaks.bundle/1";
-/**
- * The required `format_version_major` for any current receiver.
- * Bumped only on a breaking schema change. The reader throws when
- * the manifest declares any value other than `1`.
- */
-export declare const PEAKS_BUNDLE_FORMAT_VERSION_MAJOR: 1;
-/**
- * Default `format_version_minor`. Major-compatible minor bumps emit
- * a soft warning at read time; they never block.
- */
-export declare const PEAKS_BUNDLE_DEFAULT_MINOR_VERSION: 0;
-/**
- * The cross-cutting schema literals a bundle is allowed to declare.
- * Each value must match the canonical Zod `literal(...)` literal in
- * the corresponding type module. Used for the
- * `SchemaVersionsMapping` enumeration below.
- */
-export declare const PEAKS_BUNDLE_SCHEMA_VERSIONS: {
-    readonly loop: "peaks.loop/1";
-    readonly bee: "peaks.bee/1";
-    readonly loop_bee_relation: "peaks.loop-bee-relation/1";
-    readonly crystallization: "peaks.crystallization/1";
-};
-export type PeaksBundleSchemaVersionKey = keyof typeof PEAKS_BUNDLE_SCHEMA_VERSIONS;
-/**
- * Schema-versions mapping. The writer writes the canonical literal
- * for each asset kind it includes; the reader checks every key for
- * presence (and that the value matches the canonical literal).
- *
- * `.strict()` refuses unknown keys; `.refine(...)` enforces that
- * each value matches its canonical literal.
- */
-export declare const SchemaVersionsMappingSchema: z.ZodObject<{
-    loop: z.ZodLiteral<"peaks.loop/1">;
-    bee: z.ZodLiteral<"peaks.bee/1">;
-    loop_bee_relation: z.ZodLiteral<"peaks.loop-bee-relation/1">;
-    crystallization: z.ZodLiteral<"peaks.crystallization/1">;
-}, z.core.$strict>;
-export type SchemaVersionsMapping = z.infer<typeof SchemaVersionsMappingSchema>;
-/**
- * The bundle explicitly excludes private run-state, the user's
- * personal memory directory, and raw `state.db` rows. The
- * `ExclusionManifestSchema` is what the writer stamps into the
- * manifest; the reader uses it as a self-declaration (the writer is
- * the only place that can leak those payloads, but the read-time
- * stamp lets the receiver confirm the source understood the
- * exclusion rules).
- */
-export declare const ExclusionManifestSchema: z.ZodObject<{
-    private_run_state: z.ZodLiteral<"excluded">;
-    personal_memory: z.ZodLiteral<"excluded">;
-    state_db_rows: z.ZodLiteral<"excluded">;
-}, z.core.$strict>;
-export type ExclusionManifest = z.infer<typeof ExclusionManifestSchema>;
-/**
- * Bundle kind. A bundle is anchored on exactly one asset: either a
- * `loop_release` (and its main bee + supporting bees) or a single
- * `bee_release` (loop-scoped relations may follow but are not
- * required).
- */
-export declare const PEAKS_BUNDLE_KINDS: readonly ["loop", "bee"];
-export type PeaksBundleKind = (typeof PEAKS_BUNDLE_KINDS)[number];
+import { z } from 'zod';
 /**
  * The full manifest schema. The asset sub-objects are typed as
  * `unknown` here; each service layer validates them with the
@@ -197,7 +129,7 @@ export declare function safeParseBundleManifest(input: unknown): {
     manifest: BundleManifest;
 } | {
     ok: false;
-    code: "BUNDLE_FORMAT_CONSTANT_MISMATCH" | "BUNDLE_MAJOR_VERSION_MISMATCH" | "BUNDLE_SCHEMA_VERSIONS_MISMATCH" | "BUNDLE_EXCLUSION_MANIFEST_MISSING" | "BUNDLE_KIND_ANCHOR_MISMATCH";
+    code: 'BUNDLE_FORMAT_CONSTANT_MISMATCH' | 'BUNDLE_MAJOR_VERSION_MISMATCH' | 'BUNDLE_SCHEMA_VERSIONS_MISMATCH' | 'BUNDLE_EXCLUSION_MANIFEST_MISSING' | 'BUNDLE_KIND_ANCHOR_MISMATCH';
     findings: Array<{
         path: string;
         message: string;
@@ -222,3 +154,4 @@ export declare const SHARE_BUNDLE_ERROR_CODES: {
     /** Bundle tarball is malformed (missing manifest, bad payload). */
     readonly BUNDLE_MALFORMED: "SHARE_BUNDLE_MALFORMED";
 };
+export * from './bundle-format-constants.js';