@mysten-incubation/devstack 0.1.1 → 0.2.0

package/dist/substrate/runtime/observability/span-store.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"span-store.mjs","names":[],"sources":["../../../../src/substrate/runtime/observability/span-store.ts"],"sourcesContent":["// Completed-span ring + recording Tracer.\n//\n// Devstack emits spans with `Effect.withSpan` all over the substrate\n// (`acquire-node`, command names, background tasks, teardown, http handlers,\n// …) carrying the canonical `devstack.*` attributes (see spans.ts). Until\n// now no `Tracer` was provided, so those spans hit Effect's default no-op\n// native tracer and evaporated — the dashboard's \"Traces\" tab had nothing to\n// read.\n//\n// This module provides a minimal RECORDING tracer: it wraps Effect's\n// `NativeSpan` and, when a span ends, projects it into a bounded ring the\n// dashboard can query. The tracer is a drop-in for the default native tracer\n// (it still produces real `Span` objects with parent/trace ids, so span\n// propagation and any future OTel layer keep working) — it just also pushes\n// the completed span into the ring on `end()`.\n//\n// Hot-path discipline: `span()` allocates one `NativeSpan` (same as the\n// default). `end()` does one synchronous array push + bounded trim via a\n// direct mutable array — NO Effect/Ref round-trip on the hot path, since\n// `Tracer.span` / `Span.end` are synchronous and run on the fiber's critical\n// path. The ring is a plain object captured in the closure; reads go through\n// an Effect accessor for the service surface.\n//\n// Process-scoped: the ring object is created in the supervisor alongside the\n// log store, so it survives `stack.restart`.\n\nimport { Context, Effect, Exit, Layer, Option, Tracer } from 'effect';\n\nimport { SpanAttr } from './spans.ts';\n\n// -----------------------------------------------------------------------------\n// Record shape\n// -----------------------------------------------------------------------------\n\n/** One completed span. Plain data; the dashboard schema projects it\n *  directly. `op` is the span name; `service` is derived from the\n *  `devstack.plugin` attribute (falling back to the span name's leading\n *  segment). */\nexport interface SpanRecord {\n\treadonly traceId: string;\n\treadonly spanId: string;\n\treadonly parentId: string | null;\n\t/** Span name / operation (`acquire-node`, `lifecycle.supervisor.runCommand`, …). */\n\treadonly name: string;\n\t/** `devstack.plugin` attribute when present, else `null`. */\n\treadonly service: string | null;\n\treadonly startMillis: number;\n\treadonly durationMillis: number;\n\treadonly status: 'ok' | 'error';\n\t/** Flattened span attributes (string-coerced values). */\n\treadonly attributes: Readonly<Record<string, string>>;\n}\n\n/** Server-side span filter. Every field optional. */\nexport interface SpanFilter {\n\t/** Keep only spans whose derived `service` is in this set. */\n\treadonly services?: ReadonlyArray<string>;\n\t/** Keep only spans with one of these statuses. */\n\treadonly statuses?: ReadonlyArray<'ok' | 'error'>;\n\t/** Case-insensitive substring match against the span name (and service). */\n\treadonly search?: string;\n\t/** Keep only spans that STARTED at/after this epoch-ms. */\n\treadonly sinceMillis?: number;\n\t/** Cap on returned spans (most recent first). */\n\treadonly limit?: number;\n}\n\n// -----------------------------------------------------------------------------\n// Capacity policy\n// -----------------------------------------------------------------------------\n\n/** Completed-span retention. Bounded so a long-lived stack stays flat. */\nexport const DEFAULT_SPAN_CAPACITY = 2000;\n\n// -----------------------------------------------------------------------------\n// Service\n// -----------------------------------------------------------------------------\n\nexport interface SpanStoreShape {\n\t/** Query the ring with a filter (most-recent-first). Never fails. */\n\treadonly query: (filter?: SpanFilter) => Effect.Effect<ReadonlyArray<SpanRecord>>;\n\t/** Distinct derived service keys currently in the ring. */\n\treadonly services: Effect.Effect<ReadonlyArray<string>>;\n\t/** The recording `Tracer` to provide into the supervisor's effect\n\t *  context. Wraps Effect's native tracer; records on span `end()`. */\n\treadonly tracer: Tracer.Tracer;\n}\n\nexport class SpanStore extends Context.Service<SpanStore, SpanStoreShape>()(\n\t'@devstack/substrate/SpanStore',\n) {}\n\n// -----------------------------------------------------------------------------\n// Plain mutable ring (hot-path-cheap; no Ref round-trip in `end()`)\n// -----------------------------------------------------------------------------\n\ninterface Ring {\n\trecords: SpanRecord[];\n\treadonly capacity: number;\n}\n\nconst pushRecord = (ring: Ring, record: SpanRecord): void => {\n\tring.records.push(record);\n\tif (ring.records.length > ring.capacity) {\n\t\t// Drop the oldest. `shift` is O(n) but spans complete far slower than\n\t\t// logs and the capacity is bounded; keep it simple over a head index.\n\t\tring.records.shift();\n\t}\n};\n\nconst NANOS_PER_MILLI = 1_000_000n;\nconst nanosToMillis = (n: bigint): number => Number(n / NANOS_PER_MILLI);\n\n/** Derive the dashboard `service` for a span: prefer the canonical\n *  `devstack.plugin` attribute, else fall back to the span name. Plugin\n *  spans without the attribute use the dotted `devstack.plugin.<name>.…`\n *  convention, so we special-case that prefix to recover `<name>` (e.g.\n *  `devstack.plugin.postgres.acquire` → `postgres`) instead of bucketing\n *  every plugin span under the shared `devstack` head. Other namespaced\n *  spans fall back to the leading dotted/slashed segment\n *  (`lifecycle.supervisor.runCommand` → `lifecycle`). `null` when neither\n *  is informative. */\nconst PLUGIN_SPAN_PREFIX = 'devstack.plugin.';\nconst deriveService = (name: string, attributes: ReadonlyMap<string, unknown>): string | null => {\n\tconst plugin = attributes.get(SpanAttr.plugin);\n\tif (typeof plugin === 'string' && plugin.length > 0) return plugin;\n\tif (name.startsWith(PLUGIN_SPAN_PREFIX)) {\n\t\t// `devstack.plugin.<name>.<op>` → `<name>` (the segment after the prefix).\n\t\tconst rest = name.slice(PLUGIN_SPAN_PREFIX.length);\n\t\tconst pluginName = rest.split(/[./]/, 1)[0];\n\t\tif (pluginName !== undefined && pluginName.length > 0) return pluginName;\n\t}\n\tconst head = name.split(/[./]/, 1)[0];\n\treturn head !== undefined && head.length > 0 && head !== name ? head : null;\n};\n\nconst flattenAttributes = (attributes: ReadonlyMap<string, unknown>): Record<string, string> => {\n\tconst out: Record<string, string> = {};\n\tfor (const [k, v] of attributes) {\n\t\tout[k] = typeof v === 'string' ? v : String(v);\n\t}\n\treturn out;\n};\n\n/** Build the recording span from the native span at end time. */\nconst recordFrom = (\n\tspan: Tracer.NativeSpan,\n\tendTime: bigint,\n\texit: Exit.Exit<unknown, unknown>,\n): SpanRecord => {\n\tconst parent = Option.getOrUndefined(span.parent);\n\tconst startMillis = nanosToMillis(span.startTime);\n\treturn {\n\t\ttraceId: span.traceId,\n\t\tspanId: span.spanId,\n\t\tparentId: parent?.spanId ?? null,\n\t\tname: span.name,\n\t\tservice: deriveService(span.name, span.attributes),\n\t\tstartMillis,\n\t\tdurationMillis: Math.max(0, nanosToMillis(endTime) - startMillis),\n\t\tstatus: Exit.isSuccess(exit) ? 'ok' : 'error',\n\t\tattributes: flattenAttributes(span.attributes),\n\t};\n};\n\n/** A `Tracer` that builds Effect's `NativeSpan` (so parent/trace propagation\n *  and attribute capture behave exactly like the default) and records each\n *  span into `ring` when it ends. */\nconst recordingTracer = (ring: Ring): Tracer.Tracer =>\n\tTracer.make({\n\t\tspan: (options) => {\n\t\t\tconst span = new Tracer.NativeSpan(options);\n\t\t\tconst originalEnd = span.end.bind(span);\n\t\t\tspan.end = (endTime, exit) => {\n\t\t\t\toriginalEnd(endTime, exit);\n\t\t\t\t// Guard: recording must never break tracing.\n\t\t\t\ttry {\n\t\t\t\t\tpushRecord(ring, recordFrom(span, endTime, exit));\n\t\t\t\t} catch {\n\t\t\t\t\t/* swallow — observability is best-effort */\n\t\t\t\t}\n\t\t\t};\n\t\t\treturn span;\n\t\t},\n\t});\n\n/** Build a `SpanStoreShape` over a fresh ring. The supervisor calls this so\n *  the ring is process-scoped. `capacity` is injectable for tests. */\nexport const makeSpanStore = (\n\tcapacity: number = DEFAULT_SPAN_CAPACITY,\n): Effect.Effect<SpanStoreShape> =>\n\tEffect.sync(() => {\n\t\tconst ring: Ring = { records: [], capacity };\n\n\t\tconst query: SpanStoreShape['query'] = (filter) =>\n\t\t\tEffect.sync(() => applySpanFilter(ring.records, filter, capacity));\n\n\t\tconst services: SpanStoreShape['services'] = Effect.sync(() => {\n\t\t\tconst seen = new Set<string>();\n\t\t\tfor (const r of ring.records) if (r.service !== null) seen.add(r.service);\n\t\t\treturn [...seen].sort();\n\t\t});\n\n\t\treturn SpanStore.of({ query, services, tracer: recordingTracer(ring) });\n\t});\n\n/** Pure filter application — exported for tests. Stored oldest-first; we\n *  return newest-first and cap to `limit`. */\nexport const applySpanFilter = (\n\trecords: ReadonlyArray<SpanRecord>,\n\tfilter: SpanFilter | undefined,\n\tcapacity: number,\n): ReadonlyArray<SpanRecord> => {\n\tconst serviceSet =\n\t\tfilter?.services && filter.services.length > 0 ? new Set(filter.services) : null;\n\tconst statusSet =\n\t\tfilter?.statuses && filter.statuses.length > 0 ? new Set(filter.statuses) : null;\n\tconst search = filter?.search?.trim().toLowerCase();\n\tconst since = filter?.sinceMillis;\n\tconst limit = filter?.limit ?? capacity;\n\n\tconst out: SpanRecord[] = [];\n\tfor (let i = records.length - 1; i >= 0 && out.length < limit; i -= 1) {\n\t\tconst r = records[i]!;\n\t\tif (serviceSet !== null && (r.service === null || !serviceSet.has(r.service))) continue;\n\t\tif (statusSet !== null && !statusSet.has(r.status)) continue;\n\t\tif (since !== undefined && r.startMillis < since) continue;\n\t\tif (\n\t\t\tsearch !== undefined &&\n\t\t\tsearch.length > 0 &&\n\t\t\t!r.name.toLowerCase().includes(search) &&\n\t\t\t!(r.service ?? '').toLowerCase().includes(search)\n\t\t) {\n\t\t\tcontinue;\n\t\t}\n\t\tout.push(r);\n\t}\n\treturn out;\n};\n\n/** Layer form (default capacity) for callers that want the store via a Layer. */\nexport const layerSpanStore: Layer.Layer<SpanStore> = Layer.effect(SpanStore, makeSpanStore());\n"],"mappings":"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"}

package/dist/substrate/runtime/observability/spans.d.mts

@@ -1 +0,0 @@
-import { Effect } from "effect";

package/dist/substrate/runtime/observability/spans.mjs

@@ -1,87 +0,0 @@
-import "../paths.mjs";
-import { Effect } from "effect";
-//#region src/substrate/runtime/observability/spans.ts
-/** Canonical span-attribute keys. Engine-dimensional + http/process
-*  generic only. Plugin-domain keys belong on per-plugin `spans.ts`. */
-const SpanAttr = {
-	app: "devstack.app",
-	stack: "devstack.stack",
-	network: "devstack.network",
-	plugin: "devstack.plugin",
-	role: "devstack.role",
-	phase: "devstack.phase",
-	containerName: "container.name",
-	containerRole: "container.role",
-	event: "event.name",
-	errorCode: "error.code",
-	errorCause: "error.cause",
-	errorMessage: "error.message",
-	exitCode: "process.exit.code",
-	exitSignal: "process.exit.signal",
-	exitStatus: "process.exit.status",
-	endpointKey: "devstack.endpoint.key",
-	httpMethod: "http.method",
-	httpPath: "http.path",
-	httpUrl: "http.url",
-	host: "server.address",
-	logTag: "log.tag",
-	port: "server.port",
-	cycleId: "devstack.cycle.id",
-	op: "devstack.op",
-	requestId: "devstack.request.id",
-	rosterHeartbeatIntervalMs: "roster.heartbeat.intervalMs",
-	serviceName: "devstack.service.name",
-	stageAndSwapStagingPath: "stageAndSwap.stagingPath",
-	stageAndSwapTargetPath: "stageAndSwap.targetPath",
-	cacheCorruption: "cache.corruption",
-	capabilitySinksKind: "capability-sinks.kind",
-	strategyKey: "strategy.key",
-	strategyAutoMounted: "strategy.autoMounted",
-	artifactPublisherNamespace: "artifactPublisher.namespace",
-	artifactPublisherChain: "artifactPublisher.chain",
-	artifactPublisherContentHash: "artifactPublisher.contentHash",
-	artifactPublisherPath: "artifactPublisher.path",
-	stackLockPath: "devstack.stack-lock.path",
-	stackLockTimeoutMillis: "devstack.stack-lock.timeoutMillis",
-	snapshotReservationPath: "devstack.snapshot-reservation.path"
-};
-/**
-* Wrap an Effect in a stack-scoped span. Sets `devstack.app`,
-* `devstack.stack`, `devstack.network` attributes. Use at the
-* top-level engine entry points (boot, cycle start, supervisor
-* loop) — not inside per-plugin code (use `withPluginSpan` for that).
-*/
-const withStackSpan = (name, ctx) => (effect) => effect.pipe(Effect.withSpan(name, { attributes: {
-	[SpanAttr.app]: ctx.app,
-	[SpanAttr.stack]: ctx.stack,
-	[SpanAttr.network]: ctx.network
-} }));
-/**
-* Wrap an Effect in a plugin-scoped span. Inherits stack identity from
-* the surrounding Context (callers should compose with
-* `withStackSpan` at the top so the stack identity propagates).
-*/
-const withPluginSpan = (name, ctx) => (effect) => effect.pipe(Effect.withSpan(name, { attributes: {
-	[SpanAttr.app]: ctx.app,
-	[SpanAttr.stack]: ctx.stack,
-	[SpanAttr.network]: ctx.network,
-	[SpanAttr.plugin]: ctx.pluginKey,
-	[SpanAttr.role]: ctx.role
-} }));
-/**
-* Annotate the current span with a phase marker. Cheap; safe to call
-* from anywhere. Used by the supervisor when transitioning a plugin
-* through acquire phases so the OTEL trace correlates with the
-* lifecycle stream.
-*/
-const annotatePhase = (phase) => Effect.annotateCurrentSpan({ [SpanAttr.phase]: phase });
-/**
-* Annotate the current span with a subprocess `op` tag. Mirrors the
-* `CaptureError.op` field so a failure that originates in a captured
-* subprocess can be traced back to its span by `devstack.op`.
-*/
-const annotateOp = (op) => Effect.annotateCurrentSpan({ [SpanAttr.op]: op });
-//#endregion
-export { SpanAttr, annotateOp, annotatePhase, withPluginSpan, withStackSpan };
-
-//# sourceMappingURL=spans.mjs.map

package/dist/substrate/runtime/observability/spans.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"spans.mjs","names":[],"sources":["../../../../src/substrate/runtime/observability/spans.ts"],"sourcesContent":["// Span propagation wrappers.\n//\n// Architecture § L0 Observability: \"span/annotation conventions\".\n// Centralises the attribute keys so every wrapped span uses the same\n// vocabulary — OTEL consumers can filter by `devstack.app`,\n// `devstack.stack`, `devstack.plugin`, `devstack.role` reliably.\n//\n// Discipline: substrate-owned vocabulary carries ONLY engine-dimensional\n// keys (`devstack.*`, `error.*`, `process.exit.*`, `container.*`) plus\n// HTTP-generic keys (`http.*`, `server.*`). Plugin-domain keys\n// (`wallet.token`, `sui.mode`, `account.name`, etc.) live in\n// `src/plugins/<name>/spans.ts` next to the plugin that owns them; see\n// STYLE_GUIDE §16.\n\nimport { Effect } from 'effect';\n\nimport type { PluginKey } from '../../brand.ts';\nimport type { PluginRole } from '../../lifecycle.ts';\nimport { IdentityContext } from '../paths.ts';\n\n/** Canonical span-attribute keys. Engine-dimensional + http/process\n *  generic only. Plugin-domain keys belong on per-plugin `spans.ts`. */\nexport const SpanAttr = {\n\tapp: 'devstack.app',\n\tstack: 'devstack.stack',\n\tnetwork: 'devstack.network',\n\tplugin: 'devstack.plugin',\n\trole: 'devstack.role',\n\tphase: 'devstack.phase',\n\tcontainerName: 'container.name',\n\tcontainerRole: 'container.role',\n\tevent: 'event.name',\n\terrorCode: 'error.code',\n\terrorCause: 'error.cause',\n\terrorMessage: 'error.message',\n\texitCode: 'process.exit.code',\n\texitSignal: 'process.exit.signal',\n\texitStatus: 'process.exit.status',\n\tendpointKey: 'devstack.endpoint.key',\n\thttpMethod: 'http.method',\n\thttpPath: 'http.path',\n\thttpUrl: 'http.url',\n\thost: 'server.address',\n\tlogTag: 'log.tag',\n\tport: 'server.port',\n\tcycleId: 'devstack.cycle.id',\n\top: 'devstack.op',\n\trequestId: 'devstack.request.id',\n\trosterHeartbeatIntervalMs: 'roster.heartbeat.intervalMs',\n\tserviceName: 'devstack.service.name',\n\tstageAndSwapStagingPath: 'stageAndSwap.stagingPath',\n\tstageAndSwapTargetPath: 'stageAndSwap.targetPath',\n\tcacheCorruption: 'cache.corruption',\n\tcapabilitySinksKind: 'capability-sinks.kind',\n\tstrategyKey: 'strategy.key',\n\tstrategyAutoMounted: 'strategy.autoMounted',\n\tartifactPublisherNamespace: 'artifactPublisher.namespace',\n\tartifactPublisherChain: 'artifactPublisher.chain',\n\tartifactPublisherContentHash: 'artifactPublisher.contentHash',\n\tartifactPublisherPath: 'artifactPublisher.path',\n\tstackLockPath: 'devstack.stack-lock.path',\n\tstackLockTimeoutMillis: 'devstack.stack-lock.timeoutMillis',\n\tsnapshotReservationPath: 'devstack.snapshot-reservation.path',\n} as const;\n\nexport interface StackSpanContext {\n\treadonly app: string;\n\treadonly stack: string;\n\treadonly network: string;\n}\n\nexport interface PluginSpanContext extends StackSpanContext {\n\treadonly pluginKey: PluginKey;\n\treadonly role: PluginRole;\n}\n\n/**\n * Wrap an Effect in a stack-scoped span. Sets `devstack.app`,\n * `devstack.stack`, `devstack.network` attributes. Use at the\n * top-level engine entry points (boot, cycle start, supervisor\n * loop) — not inside per-plugin code (use `withPluginSpan` for that).\n */\nexport const withStackSpan =\n\t(name: string, ctx: StackSpanContext) =>\n\t<A, E, R>(effect: Effect.Effect<A, E, R>): Effect.Effect<A, E, R> =>\n\t\teffect.pipe(\n\t\t\tEffect.withSpan(name, {\n\t\t\t\tattributes: {\n\t\t\t\t\t[SpanAttr.app]: ctx.app,\n\t\t\t\t\t[SpanAttr.stack]: ctx.stack,\n\t\t\t\t\t[SpanAttr.network]: ctx.network,\n\t\t\t\t},\n\t\t\t}),\n\t\t);\n\n/**\n * Wrap an Effect in a plugin-scoped span. Inherits stack identity from\n * the surrounding Context (callers should compose with\n * `withStackSpan` at the top so the stack identity propagates).\n */\nexport const withPluginSpan =\n\t(name: string, ctx: PluginSpanContext) =>\n\t<A, E, R>(effect: Effect.Effect<A, E, R>): Effect.Effect<A, E, R> =>\n\t\teffect.pipe(\n\t\t\tEffect.withSpan(name, {\n\t\t\t\tattributes: {\n\t\t\t\t\t[SpanAttr.app]: ctx.app,\n\t\t\t\t\t[SpanAttr.stack]: ctx.stack,\n\t\t\t\t\t[SpanAttr.network]: ctx.network,\n\t\t\t\t\t[SpanAttr.plugin]: ctx.pluginKey,\n\t\t\t\t\t[SpanAttr.role]: ctx.role,\n\t\t\t\t},\n\t\t\t}),\n\t\t);\n\n/**\n * Annotate the current span with a phase marker. Cheap; safe to call\n * from anywhere. Used by the supervisor when transitioning a plugin\n * through acquire phases so the OTEL trace correlates with the\n * lifecycle stream.\n */\nexport const annotatePhase = (phase: string): Effect.Effect<void> =>\n\tEffect.annotateCurrentSpan({ [SpanAttr.phase]: phase });\n\n/**\n * Annotate the current span with the engine cycle id. Called once per\n * cycle at supervisor entry.\n */\nexport const annotateCycle = (cycleId: number): Effect.Effect<void> =>\n\tEffect.annotateCurrentSpan({ [SpanAttr.cycleId]: cycleId });\n\n/**\n * Annotate the current span with a subprocess `op` tag. Mirrors the\n * `CaptureError.op` field so a failure that originates in a captured\n * subprocess can be traced back to its span by `devstack.op`.\n */\nexport const annotateOp = (op: string): Effect.Effect<void> =>\n\tEffect.annotateCurrentSpan({ [SpanAttr.op]: op });\n\n/**\n * Canonical labels every `spanWithLabels` span carries. `plugin` is\n * caller-supplied (per-acquisition); `endpoint` + `op` are optional\n * canonical narrowers — anything plugin-specific goes through `extras`\n * so the OTEL namespace check (STYLE_GUIDE §16) still applies.\n */\nexport interface SpanLabels {\n\treadonly plugin: PluginKey | string;\n\treadonly endpoint?: string;\n\treadonly op?: string;\n}\n\n/**\n * Wrap an Effect in a span that pre-bakes the canonical identity\n * footprint — `devstack.app` + `devstack.stack` (read from the ambient\n * `IdentityContext`) + `devstack.plugin` from `labels.plugin`. Reach\n * for this on any span that needs to be filterable or groupable by\n * plugin on the dashboard (i.e. basically every span). Coexists with\n * raw `Effect.withSpan` — migration is incremental, not a flag day.\n *\n * Adoption prerequisite: this adds `IdentityContext` to the wrapped\n * effect's `R`. Only reach for it where `IdentityContext` is already in\n * scope (or the boot signature can be widened to carry it). Plugin\n * acquire/boot effects currently do NOT thread `IdentityContext` — they\n * set `devstack.plugin` directly via `Effect.withSpan` — so migrating\n * them needs the identity plumbed first. Note also that a span's\n * app/stack may legitimately differ from the ambient identity (e.g. the\n * `_per-app_` shared-stack sentinel in `managed-container.ts`), where\n * this helper is the wrong tool.\n */\nexport const spanWithLabels =\n\t(name: string, labels: SpanLabels, extras?: Record<string, unknown>) =>\n\t<A, E, R>(effect: Effect.Effect<A, E, R>): Effect.Effect<A, E, R | IdentityContext> =>\n\t\tEffect.gen(function* () {\n\t\t\tconst identity = yield* IdentityContext;\n\t\t\tconst attributes: Record<string, unknown> = {\n\t\t\t\t[SpanAttr.app]: identity.app,\n\t\t\t\t[SpanAttr.stack]: identity.stack,\n\t\t\t\t[SpanAttr.plugin]: labels.plugin,\n\t\t\t\t...(labels.endpoint !== undefined ? { [SpanAttr.endpointKey]: labels.endpoint } : {}),\n\t\t\t\t...(labels.op !== undefined ? { [SpanAttr.op]: labels.op } : {}),\n\t\t\t\t...extras,\n\t\t\t};\n\t\t\treturn yield* effect.pipe(Effect.withSpan(name, { attributes }));\n\t\t});\n"],"mappings":";;;;;AAsBA,MAAa,WAAW;CACvB,KAAK;CACL,OAAO;CACP,SAAS;CACT,QAAQ;CACR,MAAM;CACN,OAAO;CACP,eAAe;CACf,eAAe;CACf,OAAO;CACP,WAAW;CACX,YAAY;CACZ,cAAc;CACd,UAAU;CACV,YAAY;CACZ,YAAY;CACZ,aAAa;CACb,YAAY;CACZ,UAAU;CACV,SAAS;CACT,MAAM;CACN,QAAQ;CACR,MAAM;CACN,SAAS;CACT,IAAI;CACJ,WAAW;CACX,2BAA2B;CAC3B,aAAa;CACb,yBAAyB;CACzB,wBAAwB;CACxB,iBAAiB;CACjB,qBAAqB;CACrB,aAAa;CACb,qBAAqB;CACrB,4BAA4B;CAC5B,wBAAwB;CACxB,8BAA8B;CAC9B,uBAAuB;CACvB,eAAe;CACf,wBAAwB;CACxB,yBAAyB;CACzB;;;;;;;AAmBD,MAAa,iBACX,MAAc,SACL,WACT,OAAO,KACN,OAAO,SAAS,MAAM,EACrB,YAAY;EACV,SAAS,MAAM,IAAI;EACnB,SAAS,QAAQ,IAAI;EACrB,SAAS,UAAU,IAAI;CACxB,EACD,CAAC,CACF;;;;;;AAOH,MAAa,kBACX,MAAc,SACL,WACT,OAAO,KACN,OAAO,SAAS,MAAM,EACrB,YAAY;EACV,SAAS,MAAM,IAAI;EACnB,SAAS,QAAQ,IAAI;EACrB,SAAS,UAAU,IAAI;EACvB,SAAS,SAAS,IAAI;EACtB,SAAS,OAAO,IAAI;CACrB,EACD,CAAC,CACF;;;;;;;AAQH,MAAa,iBAAiB,UAC7B,OAAO,oBAAoB,GAAG,SAAS,QAAQ,OAAO,CAAC;;;;;;AAcxD,MAAa,cAAc,OAC1B,OAAO,oBAAoB,GAAG,SAAS,KAAK,IAAI,CAAC"}

package/dist/substrate/runtime/projection/index.mjs

@@ -1,4 +0,0 @@
-import "./state-ref.mjs";
-import "./persisted.mjs";
-import "./update.mjs";
-export {};

package/dist/substrate/runtime/projection/persisted.mjs

@@ -1,213 +0,0 @@
-import { endpointKey, pluginKey } from "../../brand.mjs";
-import { versionedDocSchema } from "../../versioned-doc-schema.mjs";
-import { atomicWriteJson } from "../atomic-write.mjs";
-import { logWarningAndIgnore } from "../observability/ignore-with-log.mjs";
-import { decodeJsonTextSync } from "../runtime-decode.mjs";
-import { Effect, Schema, Stream, SubscriptionRef } from "effect";
-import { existsSync, readFileSync } from "node:fs";
-import * as NodeFileSystem from "@effect/platform-node/NodeFileSystem";
-//#region src/substrate/runtime/projection/persisted.ts
-const PROJECTION_SNAPSHOT_FILE_NAME = "projection.v4.json";
-const projectionSnapshotPath = (stackRoot) => `${stackRoot}/${PROJECTION_SNAPSHOT_FILE_NAME}`;
-const SeveritySchema = Schema.Literals([
-	"warn",
-	"error",
-	"fatal"
-]);
-const LogLevelSchema = Schema.Literals([
-	"info",
-	"warn",
-	"error"
-]);
-const LifecycleStatusSchema = Schema.Literals([
-	"pending",
-	"acquiring",
-	"ready",
-	"failed",
-	"stopping",
-	"stopped",
-	"done"
-]);
-const PluginRoleSchema = Schema.Literals(["service", "task"]);
-const CyclePhaseSchema = Schema.Literals([
-	"booting",
-	"running",
-	"restarting",
-	"shutting-down"
-]);
-const RowSectionSchema = Schema.Literals([
-	"service",
-	"package",
-	"account",
-	"action",
-	"app",
-	"other"
-]);
-const StructuredErrorSchema = Schema.Struct({
-	at: Schema.Number,
-	pluginKey: Schema.NullOr(Schema.String),
-	tag: Schema.String,
-	summary: Schema.String,
-	chain: Schema.Array(Schema.String),
-	severity: SeveritySchema
-});
-const EndpointSchema = Schema.Struct({
-	endpointKey: Schema.String,
-	pluginKey: Schema.String,
-	name: Schema.String,
-	url: Schema.String,
-	displayUrl: Schema.NullOr(Schema.String),
-	wireProtocol: Schema.Literals([
-		"http",
-		"h2c",
-		"tcp"
-	]),
-	registeredAt: Schema.Number
-});
-const AccountProjectionSchema = Schema.Struct({
-	key: Schema.String,
-	rowKey: Schema.NullOr(Schema.String),
-	name: Schema.String,
-	address: Schema.NullOr(Schema.String),
-	scheme: Schema.NullOr(Schema.Literals([
-		"ed25519",
-		"secp256k1",
-		"secp256r1"
-	])),
-	source: Schema.NullOr(Schema.Literals(["real", "impersonate"])),
-	funding: Schema.Struct({
-		status: Schema.Literals([
-			"pending",
-			"funded",
-			"skipped",
-			"failed",
-			"unknown"
-		]),
-		balanceMist: Schema.NullOr(Schema.String),
-		requestedMist: Schema.NullOr(Schema.String),
-		entries: Schema.optional(Schema.Array(Schema.Struct({
-			coin: Schema.String,
-			fullCoinType: Schema.String,
-			amount: Schema.String,
-			status: Schema.Literals([
-				"funded",
-				"already-satisfied",
-				"skipped"
-			])
-		})))
-	}),
-	walletVisible: Schema.Boolean,
-	updatedAt: Schema.Number
-});
-const PackageProjectionSchema = Schema.Struct({
-	key: Schema.String,
-	rowKey: Schema.NullOr(Schema.String),
-	name: Schema.String,
-	kind: Schema.Literals(["local", "known"]),
-	packageId: Schema.String,
-	upgradeCapId: Schema.NullOr(Schema.String),
-	mvrPlaceholder: Schema.String,
-	sourcePath: Schema.NullOr(Schema.String),
-	updatedAt: Schema.Number
-});
-const RowSchema = Schema.Struct({
-	key: Schema.String,
-	role: PluginRoleSchema,
-	status: LifecycleStatusSchema,
-	phase: Schema.NullOr(Schema.String),
-	lastError: Schema.NullOr(StructuredErrorSchema),
-	logTail: Schema.Struct({
-		lines: Schema.Array(Schema.String),
-		level: LogLevelSchema,
-		truncated: Schema.Boolean
-	}),
-	endpoints: Schema.Array(Schema.String),
-	selectiveRestartHighlight: Schema.Boolean,
-	section: RowSectionSchema,
-	endpointSection: RowSectionSchema
-});
-const BuildEntrySchema = Schema.Struct({
-	pluginKey: Schema.NullOr(Schema.String),
-	phase: Schema.String,
-	progress: Schema.String,
-	startedAt: Schema.Number
-});
-const ProjectionSnapshotSchema = versionedDocSchema(4, { state: Schema.Struct({
-	identity: Schema.Struct({
-		app: Schema.String,
-		stack: Schema.String,
-		network: Schema.String
-	}),
-	cycle: Schema.Struct({
-		id: Schema.Number,
-		startedAt: Schema.Number,
-		phase: CyclePhaseSchema
-	}),
-	rows: Schema.Array(RowSchema),
-	endpoints: Schema.Array(EndpointSchema),
-	accounts: Schema.Array(AccountProjectionSchema),
-	packages: Schema.Array(PackageProjectionSchema),
-	errors: Schema.Array(StructuredErrorSchema),
-	lastEvent: Schema.Struct({
-		seq: Schema.Number,
-		at: Schema.Number
-	}),
-	stackBuild: Schema.Array(BuildEntrySchema)
-}) });
-const rebrandStructuredError = (error) => ({
-	...error,
-	pluginKey: error.pluginKey === null ? null : pluginKey(error.pluginKey)
-});
-const rebrandPersistedState = (state) => ({
-	...state,
-	rows: state.rows.map((row) => ({
-		...row,
-		key: pluginKey(row.key),
-		lastError: row.lastError === null ? null : rebrandStructuredError(row.lastError),
-		endpoints: row.endpoints.map(endpointKey)
-	})),
-	endpoints: state.endpoints.map((endpoint) => ({
-		...endpoint,
-		endpointKey: endpointKey(endpoint.endpointKey),
-		pluginKey: pluginKey(endpoint.pluginKey)
-	})),
-	accounts: state.accounts.map((account) => ({
-		...account,
-		key: account.key,
-		rowKey: account.rowKey === null ? null : pluginKey(account.rowKey)
-	})),
-	packages: state.packages.map((pkg) => ({
-		...pkg,
-		key: pkg.key,
-		rowKey: pkg.rowKey === null ? null : pluginKey(pkg.rowKey)
-	})),
-	errors: state.errors.map(rebrandStructuredError),
-	stackBuild: state.stackBuild.map((entry) => ({
-		...entry,
-		pluginKey: entry.pluginKey === null ? null : pluginKey(entry.pluginKey)
-	}))
-});
-const writeProjectionSnapshot = (stackRoot, state) => atomicWriteJson(projectionSnapshotPath(stackRoot), ProjectionSnapshotSchema, {
-	version: 4,
-	state
-}).pipe(Effect.provide(NodeFileSystem.layer), logWarningAndIgnore("projection snapshot write failed", { path: projectionSnapshotPath(stackRoot) }));
-const persistProjectionChanges = (stackRoot, ref) => Effect.gen(function* () {
-	yield* writeProjectionSnapshot(stackRoot, yield* SubscriptionRef.get(ref));
-	yield* Stream.runForEach(SubscriptionRef.changes(ref), (state) => writeProjectionSnapshot(stackRoot, state));
-});
-const readProjectionSnapshot = (stackRoot) => {
-	const path = projectionSnapshotPath(stackRoot);
-	if (!existsSync(path)) return null;
-	try {
-		return rebrandPersistedState(decodeJsonTextSync(ProjectionSnapshotSchema, readFileSync(path, "utf8"), {
-			source: path,
-			mkError: (issue) => issue
-		}).state);
-	} catch {
-		return null;
-	}
-};
-//#endregion
-export { AccountProjectionSchema, PROJECTION_SNAPSHOT_FILE_NAME, PackageProjectionSchema, ProjectionSnapshotSchema, persistProjectionChanges, projectionSnapshotPath, readProjectionSnapshot, writeProjectionSnapshot };
-
-//# sourceMappingURL=persisted.mjs.map

package/dist/substrate/runtime/projection/persisted.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"persisted.mjs","names":[],"sources":["../../../../src/substrate/runtime/projection/persisted.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\n\nimport { Effect, Schema, Stream, SubscriptionRef } from 'effect';\nimport * as NodeFileSystem from '@effect/platform-node/NodeFileSystem';\n\nimport type { SubscribableState } from '../../projection.ts';\nimport { endpointKey, pluginKey } from '../../brand.ts';\nimport { versionedDocSchema } from '../../versioned-doc-schema.ts';\nimport { atomicWriteJson } from '../atomic-write.ts';\nimport { logWarningAndIgnore } from '../observability/ignore-with-log.ts';\nimport { decodeJsonTextSync } from '../runtime-decode.ts';\n\nexport const PROJECTION_SNAPSHOT_FILE_NAME = 'projection.v4.json';\n\nexport const projectionSnapshotPath = (stackRoot: string): string =>\n\t`${stackRoot}/${PROJECTION_SNAPSHOT_FILE_NAME}`;\n\nconst SeveritySchema = Schema.Literals(['warn', 'error', 'fatal']);\nconst LogLevelSchema = Schema.Literals(['info', 'warn', 'error']);\nconst LifecycleStatusSchema = Schema.Literals([\n\t'pending',\n\t'acquiring',\n\t'ready',\n\t'failed',\n\t'stopping',\n\t'stopped',\n\t'done',\n]);\nconst PluginRoleSchema = Schema.Literals(['service', 'task']);\nconst CyclePhaseSchema = Schema.Literals(['booting', 'running', 'restarting', 'shutting-down']);\nconst RowSectionSchema = Schema.Literals([\n\t'service',\n\t'package',\n\t'account',\n\t'action',\n\t'app',\n\t'other',\n]);\n\nconst StructuredErrorSchema = Schema.Struct({\n\tat: Schema.Number,\n\tpluginKey: Schema.NullOr(Schema.String),\n\ttag: Schema.String,\n\tsummary: Schema.String,\n\tchain: Schema.Array(Schema.String),\n\tseverity: SeveritySchema,\n});\n\nconst EndpointSchema = Schema.Struct({\n\tendpointKey: Schema.String,\n\tpluginKey: Schema.String,\n\tname: Schema.String,\n\turl: Schema.String,\n\tdisplayUrl: Schema.NullOr(Schema.String),\n\twireProtocol: Schema.Literals(['http', 'h2c', 'tcp']),\n\tregisteredAt: Schema.Number,\n});\n\nexport const AccountProjectionSchema = Schema.Struct({\n\tkey: Schema.String,\n\trowKey: Schema.NullOr(Schema.String),\n\tname: Schema.String,\n\taddress: Schema.NullOr(Schema.String),\n\tscheme: Schema.NullOr(Schema.Literals(['ed25519', 'secp256k1', 'secp256r1'])),\n\tsource: Schema.NullOr(Schema.Literals(['real', 'impersonate'])),\n\tfunding: Schema.Struct({\n\t\tstatus: Schema.Literals(['pending', 'funded', 'skipped', 'failed', 'unknown']),\n\t\tbalanceMist: Schema.NullOr(Schema.String),\n\t\trequestedMist: Schema.NullOr(Schema.String),\n\t\tentries: Schema.optional(\n\t\t\tSchema.Array(\n\t\t\t\tSchema.Struct({\n\t\t\t\t\tcoin: Schema.String,\n\t\t\t\t\tfullCoinType: Schema.String,\n\t\t\t\t\tamount: Schema.String,\n\t\t\t\t\t// Mirrors `AccountProjection.funding.entries[].status` in\n\t\t\t\t\t// `substrate/projection.ts`. `'already-satisfied'` is\n\t\t\t\t\t// the pre-existing-balance short-circuit emitted by the\n\t\t\t\t\t// account funding pass — semantically a success, kept\n\t\t\t\t\t// distinct from `'funded'` so renderers can surface the\n\t\t\t\t\t// cached-vs-fresh distinction.\n\t\t\t\t\tstatus: Schema.Literals(['funded', 'already-satisfied', 'skipped']),\n\t\t\t\t}),\n\t\t\t),\n\t\t),\n\t}),\n\twalletVisible: Schema.Boolean,\n\tupdatedAt: Schema.Number,\n});\n\nexport const PackageProjectionSchema = Schema.Struct({\n\tkey: Schema.String,\n\trowKey: Schema.NullOr(Schema.String),\n\tname: Schema.String,\n\tkind: Schema.Literals(['local', 'known']),\n\tpackageId: Schema.String,\n\tupgradeCapId: Schema.NullOr(Schema.String),\n\tmvrPlaceholder: Schema.String,\n\tsourcePath: Schema.NullOr(Schema.String),\n\tupdatedAt: Schema.Number,\n});\n\nconst RowSchema = Schema.Struct({\n\tkey: Schema.String,\n\trole: PluginRoleSchema,\n\tstatus: LifecycleStatusSchema,\n\tphase: Schema.NullOr(Schema.String),\n\tlastError: Schema.NullOr(StructuredErrorSchema),\n\tlogTail: Schema.Struct({\n\t\tlines: Schema.Array(Schema.String),\n\t\tlevel: LogLevelSchema,\n\t\ttruncated: Schema.Boolean,\n\t}),\n\tendpoints: Schema.Array(Schema.String),\n\tselectiveRestartHighlight: Schema.Boolean,\n\tsection: RowSectionSchema,\n\tendpointSection: RowSectionSchema,\n});\n\nconst BuildEntrySchema = Schema.Struct({\n\tpluginKey: Schema.NullOr(Schema.String),\n\tphase: Schema.String,\n\tprogress: Schema.String,\n\tstartedAt: Schema.Number,\n});\n\nconst SubscribableStateSchema = Schema.Struct({\n\tidentity: Schema.Struct({\n\t\tapp: Schema.String,\n\t\tstack: Schema.String,\n\t\tnetwork: Schema.String,\n\t}),\n\tcycle: Schema.Struct({\n\t\tid: Schema.Number,\n\t\tstartedAt: Schema.Number,\n\t\tphase: CyclePhaseSchema,\n\t}),\n\trows: Schema.Array(RowSchema),\n\tendpoints: Schema.Array(EndpointSchema),\n\taccounts: Schema.Array(AccountProjectionSchema),\n\tpackages: Schema.Array(PackageProjectionSchema),\n\terrors: Schema.Array(StructuredErrorSchema),\n\tlastEvent: Schema.Struct({\n\t\tseq: Schema.Number,\n\t\tat: Schema.Number,\n\t}),\n\tstackBuild: Schema.Array(BuildEntrySchema),\n});\n\nexport const ProjectionSnapshotSchema = versionedDocSchema(4, {\n\tstate: SubscribableStateSchema,\n});\n\ntype PersistedSubscribableState = Schema.Schema.Type<typeof SubscribableStateSchema>;\ntype PersistedStructuredError = PersistedSubscribableState['errors'][number];\n\nconst rebrandStructuredError = (error: PersistedStructuredError) => ({\n\t...error,\n\tpluginKey: error.pluginKey === null ? null : pluginKey(error.pluginKey),\n});\n\nconst rebrandPersistedState = (state: PersistedSubscribableState): SubscribableState => ({\n\t...state,\n\trows: state.rows.map((row) => ({\n\t\t...row,\n\t\tkey: pluginKey(row.key),\n\t\tlastError: row.lastError === null ? null : rebrandStructuredError(row.lastError),\n\t\tendpoints: row.endpoints.map(endpointKey),\n\t})),\n\tendpoints: state.endpoints.map((endpoint) => ({\n\t\t...endpoint,\n\t\tendpointKey: endpointKey(endpoint.endpointKey),\n\t\tpluginKey: pluginKey(endpoint.pluginKey),\n\t})),\n\taccounts: state.accounts.map((account) => ({\n\t\t...account,\n\t\tkey: account.key as `account/${string}`,\n\t\trowKey: account.rowKey === null ? null : pluginKey(account.rowKey),\n\t})),\n\tpackages: state.packages.map((pkg) => ({\n\t\t...pkg,\n\t\tkey: pkg.key as `package/${string}`,\n\t\trowKey: pkg.rowKey === null ? null : pluginKey(pkg.rowKey),\n\t})),\n\terrors: state.errors.map(rebrandStructuredError),\n\tstackBuild: state.stackBuild.map((entry) => ({\n\t\t...entry,\n\t\tpluginKey: entry.pluginKey === null ? null : pluginKey(entry.pluginKey),\n\t})),\n});\n\nexport const writeProjectionSnapshot = (\n\tstackRoot: string,\n\tstate: SubscribableState,\n): Effect.Effect<void> =>\n\tatomicWriteJson(projectionSnapshotPath(stackRoot), ProjectionSnapshotSchema, {\n\t\tversion: 4 as const,\n\t\tstate,\n\t}).pipe(\n\t\tEffect.provide(NodeFileSystem.layer),\n\t\t// Best-effort: a snapshot write failure must not fail the caller\n\t\t// (the projection is a re-derivable read model). But a bare\n\t\t// `Effect.catch(() => Effect.void)` hid disk-full / permission\n\t\t// faults entirely — leave the cause in the log stream (§18) so a\n\t\t// persistently-failing snapshot is diagnosable.\n\t\tlogWarningAndIgnore('projection snapshot write failed', {\n\t\t\tpath: projectionSnapshotPath(stackRoot),\n\t\t}),\n\t);\n\nexport const persistProjectionChanges = (\n\tstackRoot: string,\n\tref: SubscriptionRef.SubscriptionRef<SubscribableState>,\n): Effect.Effect<void> =>\n\tEffect.gen(function* () {\n\t\tyield* writeProjectionSnapshot(stackRoot, yield* SubscriptionRef.get(ref));\n\t\tyield* Stream.runForEach(SubscriptionRef.changes(ref), (state) =>\n\t\t\twriteProjectionSnapshot(stackRoot, state),\n\t\t);\n\t});\n\nexport const readProjectionSnapshot = (stackRoot: string): SubscribableState | null => {\n\tconst path = projectionSnapshotPath(stackRoot);\n\tif (!existsSync(path)) return null;\n\ttry {\n\t\tconst snapshot = decodeJsonTextSync(ProjectionSnapshotSchema, readFileSync(path, 'utf8'), {\n\t\t\tsource: path,\n\t\t\tmkError: (issue) => issue,\n\t\t});\n\t\treturn rebrandPersistedState(snapshot.state);\n\t} catch {\n\t\treturn null;\n\t}\n};\n"],"mappings":"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"}

package/dist/substrate/runtime/scoped-multimap/service.mjs

@@ -1,52 +0,0 @@
-import { Effect, Ref } from "effect";
-//#region src/substrate/runtime/scoped-multimap/service.ts
-/**
-* Construct a fresh scoped multimap. Call this inside a Layer build
-* effect (the registry's `Layer.effect` body); the returned ops close
-* over a private `Ref` that lives for that Layer's scope.
-*
-* `register` is interruption-safe: the append + finalizer-wire pair is
-* `uninterruptible`, so an interrupt arriving between the two can't
-* leak an entry past scope close (mirrors `leaseBroker.tryAcquire`).
-*/
-const makeScopedMultimap = () => Effect.gen(function* () {
-	const state = yield* Ref.make(/* @__PURE__ */ new Map());
-	const seqRef = yield* Ref.make(0);
-	const register = (items) => Effect.gen(function* () {
-		const seq = yield* Ref.updateAndGet(seqRef, (n) => n + 1);
-		yield* Ref.update(state, (current) => {
-			const next = new Map(current);
-			for (const item of items) {
-				const existing = next.get(item.key) ?? [];
-				next.set(item.key, [...existing, {
-					value: item.value,
-					seq
-				}]);
-			}
-			return next;
-		});
-		yield* Effect.addFinalizer((_exit) => Ref.update(state, (current) => {
-			const next = new Map(current);
-			for (const item of items) {
-				const existing = next.get(item.key);
-				if (!existing) continue;
-				const filtered = existing.filter((e) => e.seq !== seq);
-				if (filtered.length === 0) next.delete(item.key);
-				else next.set(item.key, filtered);
-			}
-			return next;
-		}));
-		return seq;
-	}).pipe(Effect.uninterruptible);
-	const entriesFor = (key) => Ref.get(state).pipe(Effect.map((current) => current.get(key) ?? []));
-	return {
-		register,
-		entriesFor,
-		snapshot: Ref.get(state),
-		keys: Ref.get(state).pipe(Effect.map((current) => [...current.keys()]))
-	};
-});
-//#endregion
-export { makeScopedMultimap };
-
-//# sourceMappingURL=service.mjs.map

package/dist/substrate/runtime/scoped-multimap/service.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"service.mjs","names":[],"sources":["../../../../src/substrate/runtime/scoped-multimap/service.ts"],"sourcesContent":["// Scoped seq-tagged multimap primitive.\n//\n// Three substrate registries — `StrategyRegistry`, `FormatterRegistry`,\n// `CapabilitySinks` — independently grew the same shape: a `Ref` of a\n// per-key LIST of seq-tagged entries, plus a per-registration scope\n// finalizer that drops the entries it added when the surrounding scope\n// closes. This module is the ONE place that shape lives.\n//\n// Why a per-key LIST tagged by a monotonic seq (rather than a single\n// value-per-key with prior-restore):\n//\n//   - Parallel / sibling-scope safety. The naive \"remember the prior\n//     value, restore it on close\" finalizer is only correct under\n//     strict LIFO nesting. With sibling scopes it clobbers a still-live\n//     registration: scope A installs `X`, sibling B overwrites `X`\n//     (capturing A's value as its `prior`), then A closes first and its\n//     finalizer — holding `prior = nothing` — DELETES `X`, dropping B's\n//     live overlay. capability-sinks had exactly this bug.\n//\n//   - The seq-tagged list makes every finalizer remove ONLY the entry\n//     (or entries) it added — it never touches a newer registration for\n//     the same key. \"Who wins right now\" is a pure function of the\n//     surviving entries (highest seq = last-write-wins), so close order\n//     no longer matters.\n//\n// The primitive deliberately stops at the storage + finalizer layer.\n// The \"winner\" policy differs per registry (priority+seq, non-null\n// formatter+seq, plain last-seq), so each call site folds the surviving\n// entries with its own rule over the snapshot this primitive exposes.\n//\n// Scope-local, like every substrate registry: the `Ref` is private to\n// the build effect, so it dies with the stack scope.\n\nimport { Effect, Ref, type Scope } from 'effect';\n\n/** One stored entry: the caller's `value` plus the monotonic `seq` the\n *  multimap stamped it with. The `seq` is the identity the finalizer\n *  drops on and the tiebreaker call sites fold on. */\nexport interface MultimapEntry<V> {\n\treadonly value: V;\n\treadonly seq: number;\n}\n\n/** A single `(key, value)` pair to register. A registration may carry\n *  several pairs (formatter-registry contributes one tag-entry per\n *  declared error tag); all pairs in one `register` call share one\n *  `seq` and one finalizer. */\nexport interface MultimapItem<K extends string, V> {\n\treadonly key: K;\n\treadonly value: V;\n}\n\n/** Operations on a scoped seq-tagged multimap. Generic over `K`\n *  (string-shaped, used as a Map key) and the opaque per-entry `V`. */\nexport interface ScopedMultimap<K extends string, V> {\n\t/** Append one or more `(key, value)` pairs under a single fresh\n\t *  `seq`, and register a scope finalizer that drops exactly those\n\t *  entries (by `seq`) on scope close. Returns the assigned `seq` so\n\t *  callers that need to span-annotate or correlate can.\n\t *\n\t *  Requires `Scope.Scope`: the finalizer lands on the caller's\n\t *  scope, so the registration is reaped on that scope's close. */\n\treadonly register: (\n\t\titems: ReadonlyArray<MultimapItem<K, V>>,\n\t) => Effect.Effect<number, never, Scope.Scope>;\n\t/** Surviving entries under one key, in registration order\n\t *  (ascending `seq`). Empty array when the key is absent. */\n\treadonly entriesFor: (key: K) => Effect.Effect<ReadonlyArray<MultimapEntry<V>>>;\n\t/** Full snapshot: every key mapped to its surviving entries. */\n\treadonly snapshot: Effect.Effect<ReadonlyMap<K, ReadonlyArray<MultimapEntry<V>>>>;\n\t/** Keys with at least one surviving entry. */\n\treadonly keys: Effect.Effect<ReadonlyArray<K>>;\n}\n\ntype State<K extends string, V> = ReadonlyMap<K, ReadonlyArray<MultimapEntry<V>>>;\n\n/**\n * Construct a fresh scoped multimap. Call this inside a Layer build\n * effect (the registry's `Layer.effect` body); the returned ops close\n * over a private `Ref` that lives for that Layer's scope.\n *\n * `register` is interruption-safe: the append + finalizer-wire pair is\n * `uninterruptible`, so an interrupt arriving between the two can't\n * leak an entry past scope close (mirrors `leaseBroker.tryAcquire`).\n */\nexport const makeScopedMultimap = <K extends string, V>(): Effect.Effect<ScopedMultimap<K, V>> =>\n\tEffect.gen(function* () {\n\t\tconst state = yield* Ref.make<State<K, V>>(new Map());\n\t\tconst seqRef = yield* Ref.make(0);\n\n\t\tconst register: ScopedMultimap<K, V>['register'] = (items) =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\tconst seq = yield* Ref.updateAndGet(seqRef, (n) => n + 1);\n\t\t\t\tyield* Ref.update(state, (current) => {\n\t\t\t\t\tconst next = new Map(current);\n\t\t\t\t\tfor (const item of items) {\n\t\t\t\t\t\tconst existing = next.get(item.key) ?? [];\n\t\t\t\t\t\tnext.set(item.key, [...existing, { value: item.value, seq }]);\n\t\t\t\t\t}\n\t\t\t\t\treturn next;\n\t\t\t\t});\n\t\t\t\t// Drop-by-seq finalizer. Touches only the entries THIS\n\t\t\t\t// registration added — never a newer registration for the\n\t\t\t\t// same key — so sibling-scope close order is irrelevant.\n\t\t\t\tyield* Effect.addFinalizer((_exit) =>\n\t\t\t\t\tRef.update(state, (current) => {\n\t\t\t\t\t\tconst next = new Map(current);\n\t\t\t\t\t\tfor (const item of items) {\n\t\t\t\t\t\t\tconst existing = next.get(item.key);\n\t\t\t\t\t\t\tif (!existing) continue;\n\t\t\t\t\t\t\tconst filtered = existing.filter((e) => e.seq !== seq);\n\t\t\t\t\t\t\tif (filtered.length === 0) next.delete(item.key);\n\t\t\t\t\t\t\telse next.set(item.key, filtered);\n\t\t\t\t\t\t}\n\t\t\t\t\t\treturn next;\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t\treturn seq;\n\t\t\t}).pipe(Effect.uninterruptible);\n\n\t\tconst entriesFor: ScopedMultimap<K, V>['entriesFor'] = (key) =>\n\t\t\tRef.get(state).pipe(Effect.map((current) => current.get(key) ?? []));\n\n\t\tconst snapshot: ScopedMultimap<K, V>['snapshot'] = Ref.get(state);\n\n\t\tconst keys: ScopedMultimap<K, V>['keys'] = Ref.get(state).pipe(\n\t\t\tEffect.map((current) => [...current.keys()]),\n\t\t);\n\n\t\treturn { register, entriesFor, snapshot, keys } as const;\n\t});\n"],"mappings":";;;;;;;;;;;AAqFA,MAAa,2BACZ,OAAO,IAAI,aAAa;CACvB,MAAM,QAAQ,OAAO,IAAI,qBAAkB,IAAI,KAAK,CAAC;CACrD,MAAM,SAAS,OAAO,IAAI,KAAK,EAAE;CAEjC,MAAM,YAA8C,UACnD,OAAO,IAAI,aAAa;EACvB,MAAM,MAAM,OAAO,IAAI,aAAa,SAAS,MAAM,IAAI,EAAE;AACzD,SAAO,IAAI,OAAO,QAAQ,YAAY;GACrC,MAAM,OAAO,IAAI,IAAI,QAAQ;AAC7B,QAAK,MAAM,QAAQ,OAAO;IACzB,MAAM,WAAW,KAAK,IAAI,KAAK,IAAI,IAAI,EAAE;AACzC,SAAK,IAAI,KAAK,KAAK,CAAC,GAAG,UAAU;KAAE,OAAO,KAAK;KAAO;KAAK,CAAC,CAAC;;AAE9D,UAAO;IACN;AAIF,SAAO,OAAO,cAAc,UAC3B,IAAI,OAAO,QAAQ,YAAY;GAC9B,MAAM,OAAO,IAAI,IAAI,QAAQ;AAC7B,QAAK,MAAM,QAAQ,OAAO;IACzB,MAAM,WAAW,KAAK,IAAI,KAAK,IAAI;AACnC,QAAI,CAAC,SAAU;IACf,MAAM,WAAW,SAAS,QAAQ,MAAM,EAAE,QAAQ,IAAI;AACtD,QAAI,SAAS,WAAW,EAAG,MAAK,OAAO,KAAK,IAAI;QAC3C,MAAK,IAAI,KAAK,KAAK,SAAS;;AAElC,UAAO;IACN,CACF;AACD,SAAO;GACN,CAAC,KAAK,OAAO,gBAAgB;CAEhC,MAAM,cAAkD,QACvD,IAAI,IAAI,MAAM,CAAC,KAAK,OAAO,KAAK,YAAY,QAAQ,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;AAQrE,QAAO;EAAE;EAAU;EAAY,UANoB,IAAI,IAAI,MAMpB;EAAE,MAJE,IAAI,IAAI,MAAM,CAAC,KACzD,OAAO,KAAK,YAAY,CAAC,GAAG,QAAQ,MAAM,CAAC,CAAC,CAGA;EAAE;EAC9C"}

package/dist/substrate/runtime/scoped-ref-map/index.mjs

@@ -1,2 +0,0 @@
-import "./service.mjs";
-export {};

package/dist/substrate/runtime/scoped-ref-map/service.mjs

@@ -1,83 +0,0 @@
-import { Context, Effect, Layer, Schema, SubscriptionRef } from "effect";
-//#region src/substrate/runtime/scoped-ref-map/service.ts
-/** Lookup failure for a missing key. Schema-tagged so consumers
-*  may `Effect.catchTag('ScopedRefMapKeyMissingError', ...)` and
-*  the cascade-formatter can render it without importing the class. */
-var ScopedRefMapKeyMissingError = class extends Schema.TaggedErrorClass()("ScopedRefMapKeyMissingError", {
-	registryName: Schema.String,
-	key: Schema.String
-}) {};
-/**
-* Factory: declare a typed `K -> V` scoped ref-map service.
-*
-* The `name` becomes both the human-readable registry name (used
-* in `ScopedRefMapKeyMissingError.registryName`) and the
-* Context.Service identifier (prefixed with the substrate
-* namespace). Each call returns a fresh Service class; calling
-* twice with the same name produces two distinct services
-* (Context.Service identity is per-class, not per-id-string —
-* the id string is a debugging aid).
-*
-* Return shape — typed via inference so the inner Service class's
-* identity flows through to callers:
-*   - `Service` — the `Context.Service` tag class. Plugin authors
-*     yield this from their `acquire` body via `yield* MyRegistry.Service`.
-*   - `layer` — scope-bound Layer constructing one ref-map per
-*     stack scope.
-*   - `changes` — stream helper mirroring `routesStream(router)`.
-*
-* Example (in an L2 plugin):
-*
-* ```ts
-* const PackageRegistry = defineScopedRefMap<PackageKey, PackageRecord>('PackageRegistry');
-*
-* // In the plugin's acquire body:
-* const registry = yield* PackageRegistry.Service;
-* yield* registry.set(name, resolved);
-*
-* // In the boot Layer:
-* Layer.mergeAll(PackageRegistry.layer, ...)
-* ```
-*/
-const defineScopedRefMap = (name) => {
-	const serviceId = `@devstack/substrate/ScopedRefMap/${name}`;
-	class Service extends Context.Service()(serviceId) {}
-	const layer = Layer.effect(Service, Effect.gen(function* () {
-		const ref = yield* SubscriptionRef.make([]);
-		const set = (key, value) => SubscriptionRef.update(ref, (current) => {
-			return [...current.filter(([k]) => k !== key), [key, value]];
-		});
-		const find = (key) => SubscriptionRef.get(ref).pipe(Effect.map((current) => {
-			const hit = current.find(([k]) => k === key);
-			return hit ? hit[1] : null;
-		}));
-		const get = (key) => Effect.gen(function* () {
-			const value = yield* find(key);
-			if (value === null) return yield* new ScopedRefMapKeyMissingError({
-				registryName: name,
-				key
-			});
-			return value;
-		});
-		const has = (key) => SubscriptionRef.get(ref).pipe(Effect.map((current) => current.some(([k]) => k === key)));
-		const entries = () => SubscriptionRef.get(ref);
-		return Service.of({
-			set,
-			get,
-			find,
-			has,
-			entries,
-			changes: SubscriptionRef.changes(ref)
-		});
-	}));
-	const changes = (svc) => svc.changes;
-	return {
-		Service,
-		layer,
-		changes
-	};
-};
-//#endregion
-export { ScopedRefMapKeyMissingError, defineScopedRefMap };
-
-//# sourceMappingURL=service.mjs.map

package/dist/substrate/runtime/scoped-ref-map/service.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"service.mjs","names":[],"sources":["../../../../src/substrate/runtime/scoped-ref-map/service.ts"],"sourcesContent":["// Generic scoped Ref-Map registry primitive.\n//\n// Architecture (ARCHITECTURE.md § Substrate primitives roster /\n// § Substrate name-blindness): a name-blind, per-stack-scoped\n// in-memory `K -> V` lookup table. Substrate exposes ONLY the\n// generic primitive; L2 plugins (Sui-coin, Move-package, future\n// chain plugins) instantiate it with their domain-specific\n// `K` and `V` shapes to author their own typed Context.Service.\n//\n// Why the factory `defineScopedRefMap<K, V>(name)` shape rather\n// than a single `ScopedRefMapService` tag:\n//\n//   - One service per plugin domain — `PackageRegistry`,\n//     `CoinRegistry`, etc. — gives each plugin its own typed\n//     tag instead of every consumer reaching into a single map\n//     and narrowing.\n//   - Substrate stays name-blind: it doesn't know `coin` or\n//     `package`; it only knows \"give me a Layer + Service for\n//     `<K, V>`\". The plugin chooses the name.\n//   - The substrate Service-class identity is the namespace —\n//     two `defineScopedRefMap('Foo')` and `defineScopedRefMap('Bar')`\n//     calls return distinct services that can coexist in the\n//     same scope.\n//\n// Lifetime: each instantiated service is materialized by a\n// Layer that lives for the stack scope. When the scope closes,\n// the in-memory `SubscriptionRef` drops with it — the ref is\n// closure-private to the Layer's build effect, so the GC\n// reclaims it once no subscribers hold the stream.\n\nimport { Context, Effect, Layer, Schema, Stream, SubscriptionRef } from 'effect';\n\n/** Lookup failure for a missing key. Schema-tagged so consumers\n *  may `Effect.catchTag('ScopedRefMapKeyMissingError', ...)` and\n *  the cascade-formatter can render it without importing the class. */\nexport class ScopedRefMapKeyMissingError extends Schema.TaggedErrorClass<ScopedRefMapKeyMissingError>()(\n\t'ScopedRefMapKeyMissingError',\n\t{\n\t\tregistryName: Schema.String,\n\t\tkey: Schema.String,\n\t},\n) {}\n\n/** Operations on a scoped `K -> V` ref-map. Generic over `K`\n *  (constrained to `string`-shaped brands so it can be used as\n *  a Map key) and `V` (fully opaque to substrate). */\nexport interface ScopedRefMap<K extends string, V> {\n\t/** Insert / overwrite. Last-write-wins on `K`. */\n\treadonly set: (key: K, value: V) => Effect.Effect<void>;\n\t/** Strict lookup. Fails with `ScopedRefMapKeyMissingError`\n\t *  when the key isn't present. */\n\treadonly get: (key: K) => Effect.Effect<V, ScopedRefMapKeyMissingError>;\n\t/** Non-failing lookup — `null` when absent. */\n\treadonly find: (key: K) => Effect.Effect<V | null>;\n\t/** Presence check without an error projection. */\n\treadonly has: (key: K) => Effect.Effect<boolean>;\n\t/** Snapshot of all `(key, value)` pairs. Iteration order is\n\t *  insertion order. */\n\treadonly entries: () => Effect.Effect<ReadonlyArray<readonly [K, V]>>;\n\t/** Stream of full-snapshot states. Each emission is the\n\t *  current `entries` array; consumers diff if they need\n\t *  incremental updates. */\n\treadonly changes: Stream.Stream<ReadonlyArray<readonly [K, V]>>;\n}\n\n/**\n * Factory: declare a typed `K -> V` scoped ref-map service.\n *\n * The `name` becomes both the human-readable registry name (used\n * in `ScopedRefMapKeyMissingError.registryName`) and the\n * Context.Service identifier (prefixed with the substrate\n * namespace). Each call returns a fresh Service class; calling\n * twice with the same name produces two distinct services\n * (Context.Service identity is per-class, not per-id-string —\n * the id string is a debugging aid).\n *\n * Return shape — typed via inference so the inner Service class's\n * identity flows through to callers:\n *   - `Service` — the `Context.Service` tag class. Plugin authors\n *     yield this from their `acquire` body via `yield* MyRegistry.Service`.\n *   - `layer` — scope-bound Layer constructing one ref-map per\n *     stack scope.\n *   - `changes` — stream helper mirroring `routesStream(router)`.\n *\n * Example (in an L2 plugin):\n *\n * ```ts\n * const PackageRegistry = defineScopedRefMap<PackageKey, PackageRecord>('PackageRegistry');\n *\n * // In the plugin's acquire body:\n * const registry = yield* PackageRegistry.Service;\n * yield* registry.set(name, resolved);\n *\n * // In the boot Layer:\n * Layer.mergeAll(PackageRegistry.layer, ...)\n * ```\n */\nexport const defineScopedRefMap = <K extends string, V>(name: string) => {\n\tconst serviceId = `@devstack/substrate/ScopedRefMap/${name}`;\n\n\tclass Service extends Context.Service<Service, ScopedRefMap<K, V>>()(serviceId) {}\n\n\tconst layer: Layer.Layer<Service> = Layer.effect(\n\t\tService,\n\t\tEffect.gen(function* () {\n\t\t\tconst ref = yield* SubscriptionRef.make<ReadonlyArray<readonly [K, V]>>([]);\n\n\t\t\tconst set: ScopedRefMap<K, V>['set'] = (key, value) =>\n\t\t\t\tSubscriptionRef.update(ref, (current) => {\n\t\t\t\t\tconst filtered = current.filter(([k]) => k !== key);\n\t\t\t\t\treturn [...filtered, [key, value] as const];\n\t\t\t\t});\n\n\t\t\tconst find: ScopedRefMap<K, V>['find'] = (key) =>\n\t\t\t\tSubscriptionRef.get(ref).pipe(\n\t\t\t\t\tEffect.map((current) => {\n\t\t\t\t\t\tconst hit = current.find(([k]) => k === key);\n\t\t\t\t\t\treturn hit ? hit[1] : null;\n\t\t\t\t\t}),\n\t\t\t\t);\n\n\t\t\tconst get: ScopedRefMap<K, V>['get'] = (key) =>\n\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\tconst value = yield* find(key);\n\t\t\t\t\tif (value === null) {\n\t\t\t\t\t\treturn yield* new ScopedRefMapKeyMissingError({\n\t\t\t\t\t\t\tregistryName: name,\n\t\t\t\t\t\t\tkey,\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\t\t\t\t\treturn value;\n\t\t\t\t});\n\n\t\t\tconst has: ScopedRefMap<K, V>['has'] = (key) =>\n\t\t\t\tSubscriptionRef.get(ref).pipe(Effect.map((current) => current.some(([k]) => k === key)));\n\n\t\t\tconst entries: ScopedRefMap<K, V>['entries'] = () => SubscriptionRef.get(ref);\n\n\t\t\treturn Service.of({\n\t\t\t\tset,\n\t\t\t\tget,\n\t\t\t\tfind,\n\t\t\t\thas,\n\t\t\t\tentries,\n\t\t\t\tchanges: SubscriptionRef.changes(ref),\n\t\t\t});\n\t\t}),\n\t);\n\n\tconst changes = (svc: ScopedRefMap<K, V>): Stream.Stream<ReadonlyArray<readonly [K, V]>> =>\n\t\tsvc.changes;\n\n\treturn {\n\t\tService,\n\t\tlayer,\n\t\tchanges,\n\t} as const;\n};\n"],"mappings":";;;;;AAmCA,IAAa,8BAAb,cAAiD,OAAO,kBAA+C,CACtG,+BACA;CACC,cAAc,OAAO;CACrB,KAAK,OAAO;CACZ,CACD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwDF,MAAa,sBAA2C,SAAiB;CACxE,MAAM,YAAY,oCAAoC;CAEtD,MAAM,gBAAgB,QAAQ,SAAsC,CAAC,UAAU,CAAC;CAEhF,MAAM,QAA8B,MAAM,OACzC,SACA,OAAO,IAAI,aAAa;EACvB,MAAM,MAAM,OAAO,gBAAgB,KAAqC,EAAE,CAAC;EAE3E,MAAM,OAAkC,KAAK,UAC5C,gBAAgB,OAAO,MAAM,YAAY;AAExC,UAAO,CAAC,GADS,QAAQ,QAAQ,CAAC,OAAO,MAAM,IAC5B,EAAE,CAAC,KAAK,MAAM,CAAU;IAC1C;EAEH,MAAM,QAAoC,QACzC,gBAAgB,IAAI,IAAI,CAAC,KACxB,OAAO,KAAK,YAAY;GACvB,MAAM,MAAM,QAAQ,MAAM,CAAC,OAAO,MAAM,IAAI;AAC5C,UAAO,MAAM,IAAI,KAAK;IACrB,CACF;EAEF,MAAM,OAAkC,QACvC,OAAO,IAAI,aAAa;GACvB,MAAM,QAAQ,OAAO,KAAK,IAAI;AAC9B,OAAI,UAAU,KACb,QAAO,OAAO,IAAI,4BAA4B;IAC7C,cAAc;IACd;IACA,CAAC;AAEH,UAAO;IACN;EAEH,MAAM,OAAkC,QACvC,gBAAgB,IAAI,IAAI,CAAC,KAAK,OAAO,KAAK,YAAY,QAAQ,MAAM,CAAC,OAAO,MAAM,IAAI,CAAC,CAAC;EAEzF,MAAM,gBAA+C,gBAAgB,IAAI,IAAI;AAE7E,SAAO,QAAQ,GAAG;GACjB;GACA;GACA;GACA;GACA;GACA,SAAS,gBAAgB,QAAQ,IAAI;GACrC,CAAC;GACD,CACF;CAED,MAAM,WAAW,QAChB,IAAI;AAEL,QAAO;EACN;EACA;EACA;EACA"}

package/dist/substrate/runtime/state-store/index.mjs

@@ -1,3 +0,0 @@
-import "./schema.mjs";
-import "./service.mjs";
-export {};

package/dist/substrate/runtime/state-store/schema.d.mts

@@ -1 +0,0 @@
-import { Schema } from "effect";

package/dist/substrate/runtime/state-store/schema.mjs

@@ -1,41 +0,0 @@
-import { versionedDocSchema } from "../../versioned-doc-schema.mjs";
-import { Schema } from "effect";
-//#region src/substrate/runtime/state-store/schema.ts
-/** Stored value envelope. The phantom-typed `StateKey<V>` reads /
-*  writes against the `value` slot opaquely (the substrate doesn't
-*  introspect plugin values — it stores the JSON value as `unknown`
-*  and re-encodes the document on every set). */
-const StateEntry = Schema.Struct({
-	/** Discriminator. `present` carries a value; `tombstone` records
-	*  that the key was deleted (so reads can distinguish "user
-	*  removed this" from "user never wrote it"). */
-	state: Schema.Literals(["present", "tombstone"]),
-	/** Encoded value. For `tombstone` entries this is `null`; the
-	*  substrate refuses to deliver it on `get`. */
-	value: Schema.Unknown,
-	/** Timestamp of the last mutation. Renderers may surface it;
-	*  the substrate uses it only for diagnostics. */
-	updatedAt: Schema.Number
-});
-/** Document — one file per stack. Keys are the `StateKey<V>` string
-*  form (`<pluginKey>/<suffix>`), values are entries.
-*
-*  Schema version: bump on incompatible changes. v1 is the initial
-*  release; bumps are the only way to introduce backward-incompatible
-*  shape changes. Schema-decode failure on read with an unknown
-*  version surfaces as `corruption`. */
-const StateDocument = versionedDocSchema(1, { 
-/** Per-plugin namespaces. Key is the plugin-key prefix; nested
-*  record is the plugin's own keys (suffix → entry). Two-level
-*  structure (vs. flat `pluginKey/suffix → entry`) so `listUnder`
-*  is an O(1) lookup and per-plugin wipes are O(1) field deletes. */
-plugins: Schema.Record(Schema.String, Schema.Record(Schema.String, StateEntry)) });
-/** Initial empty document. */
-const emptyDocument = {
-	version: 1,
-	plugins: {}
-};
-//#endregion
-export { StateDocument, StateEntry, emptyDocument };
-
-//# sourceMappingURL=schema.mjs.map

package/dist/substrate/runtime/state-store/schema.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema.mjs","names":[],"sources":["../../../../src/substrate/runtime/state-store/schema.ts"],"sourcesContent":["// On-disk schema for the per-stack state.json.\n//\n// One file per stack. Plugin-keyed top-level subtrees so two\n// plugins never see each other's keys. Tombstones distinguish\n// \"deleted\" from \"missing\" — see header of `state-store.ts`.\n\nimport { Schema } from 'effect';\n\nimport { versionedDocSchema } from '../../versioned-doc-schema.ts';\n\n/** Stored value envelope. The phantom-typed `StateKey<V>` reads /\n *  writes against the `value` slot opaquely (the substrate doesn't\n *  introspect plugin values — it stores the JSON value as `unknown`\n *  and re-encodes the document on every set). */\nexport const StateEntry = Schema.Struct({\n\t/** Discriminator. `present` carries a value; `tombstone` records\n\t *  that the key was deleted (so reads can distinguish \"user\n\t *  removed this\" from \"user never wrote it\"). */\n\tstate: Schema.Literals(['present', 'tombstone']),\n\t/** Encoded value. For `tombstone` entries this is `null`; the\n\t *  substrate refuses to deliver it on `get`. */\n\tvalue: Schema.Unknown,\n\t/** Timestamp of the last mutation. Renderers may surface it;\n\t *  the substrate uses it only for diagnostics. */\n\tupdatedAt: Schema.Number,\n});\nexport type StateEntry = typeof StateEntry.Type;\n\n/** Document — one file per stack. Keys are the `StateKey<V>` string\n *  form (`<pluginKey>/<suffix>`), values are entries.\n *\n *  Schema version: bump on incompatible changes. v1 is the initial\n *  release; bumps are the only way to introduce backward-incompatible\n *  shape changes. Schema-decode failure on read with an unknown\n *  version surfaces as `corruption`. */\nexport const StateDocument = versionedDocSchema(1, {\n\t/** Per-plugin namespaces. Key is the plugin-key prefix; nested\n\t *  record is the plugin's own keys (suffix → entry). Two-level\n\t *  structure (vs. flat `pluginKey/suffix → entry`) so `listUnder`\n\t *  is an O(1) lookup and per-plugin wipes are O(1) field deletes. */\n\tplugins: Schema.Record(Schema.String, Schema.Record(Schema.String, StateEntry)),\n});\nexport type StateDocument = typeof StateDocument.Type;\n\n/** Initial empty document. */\nexport const emptyDocument: StateDocument = { version: 1, plugins: {} };\n"],"mappings":";;;;;;;AAcA,MAAa,aAAa,OAAO,OAAO;;;;CAIvC,OAAO,OAAO,SAAS,CAAC,WAAW,YAAY,CAAC;;;CAGhD,OAAO,OAAO;;;CAGd,WAAW,OAAO;CAClB,CAAC;;;;;;;;AAUF,MAAa,gBAAgB,mBAAmB,GAAG;;;;;AAKlD,SAAS,OAAO,OAAO,OAAO,QAAQ,OAAO,OAAO,OAAO,QAAQ,WAAW,CAAC,EAC/E,CAAC;;AAIF,MAAa,gBAA+B;CAAE,SAAS;CAAG,SAAS,EAAE;CAAE"}

package/dist/substrate/runtime/state-store/service.d.mts

@@ -1 +0,0 @@
-import { Context, FileSystem, Layer } from "effect";