@mysten-incubation/devstack 0.0.0

package/dist/substrate/events.d.mts

@@ -0,0 +1,117 @@
+import { EndpointKey, PluginKey } from "./brand.mjs";
+import { LifecycleStatus, PhaseNarration } from "./lifecycle.mjs";
+import { AccountProjection, BuildEntry, Endpoint, PackageProjection, StructuredError } from "./projection.mjs";
+
+//#region src/substrate/events.d.ts
+type ShutdownSignal = 'SIGINT' | 'SIGTERM';
+type SnapshotCaptureProgressPhase = 'quiescing' | 'pausing' | 'paused' | 'capturing-containers' | 'saving-images' | 'capturing-host-tree' | 'saving-state' | 'saving-contributions' | 'writing-metadata' | 'resuming';
+/** Typed lifecycle event stream. Architecture-enumerated categories. */
+type EngineEvent = {
+  readonly tag: 'lifecycle.statusChanged';
+  readonly pluginKey: PluginKey;
+  readonly from: LifecycleStatus;
+  readonly to: LifecycleStatus;
+  readonly at: number;
+} | {
+  readonly tag: 'lifecycle.phaseSet';
+  readonly pluginKey: PluginKey;
+  readonly phase: PhaseNarration | null;
+  readonly at: number;
+} | {
+  readonly tag: 'log.appended';
+  readonly pluginKey: PluginKey;
+  readonly line: string;
+  readonly level: 'info' | 'warn' | 'error';
+  readonly at: number;
+} | {
+  readonly tag: 'endpoint.registered';
+  readonly endpoint: Endpoint;
+} | {
+  readonly tag: 'account.updated';
+  readonly account: AccountProjection;
+  readonly at: number;
+} | {
+  readonly tag: 'package.updated';
+  readonly package: PackageProjection;
+  readonly at: number;
+} | {
+  readonly tag: 'endpoint.released';
+  readonly endpointKey: EndpointKey;
+  readonly at: number;
+} | {
+  readonly tag: 'strategy.registered';
+  readonly capabilityKey: string;
+  readonly autoMounted: boolean;
+  readonly at: number;
+} | {
+  readonly tag: 'strategy.unregistered';
+  readonly capabilityKey: string;
+  readonly at: number;
+} | {
+  readonly tag: 'manifest.flushed';
+  readonly manifestVersion: number;
+  readonly at: number;
+} | {
+  readonly tag: 'codegen.emitted';
+  readonly files: ReadonlyArray<string>;
+  readonly at: number;
+} | {
+  readonly tag: 'error.reported';
+  readonly error: StructuredError;
+} | {
+  readonly tag: 'build.statusChanged';
+  readonly entry: BuildEntry;
+} | {
+  readonly tag: 'restart.requested';
+  readonly target: 'stack' | {
+    readonly pluginKey: PluginKey;
+  };
+  readonly at: number;
+} | {
+  readonly tag: 'restart.completed';
+  readonly target: 'stack' | {
+    readonly pluginKey: PluginKey;
+  };
+  readonly at: number;
+} | {
+  readonly tag: 'shutdown.escalated';
+  readonly signal: ShutdownSignal;
+  readonly exitCode: number;
+  readonly at: number;
+} | {
+  readonly tag: 'snapshot.captureStarted';
+  readonly snapshotId?: string;
+  readonly name?: string;
+  readonly at: number;
+} | {
+  readonly tag: 'snapshot.captureProgress';
+  readonly snapshotId?: string;
+  readonly name?: string;
+  readonly phase: SnapshotCaptureProgressPhase;
+  readonly detail?: string;
+  readonly pausedContainers?: number;
+  readonly totalContainers?: number;
+  readonly at: number;
+} | {
+  readonly tag: 'snapshot.captureSkipped';
+  readonly reason: 'already-running';
+  readonly at: number;
+} | {
+  readonly tag: 'snapshot.captureFailed';
+  readonly snapshotId?: string;
+  readonly name?: string;
+  readonly summary: string;
+  readonly at: number;
+} | {
+  readonly tag: 'snapshot.captured';
+  readonly snapshotId: string;
+  readonly name?: string;
+  readonly at: number;
+} | {
+  readonly tag: 'snapshot.restored';
+  readonly snapshotId: string;
+  readonly at: number;
+};
+//#endregion
+export { EngineEvent };
+//# sourceMappingURL=events.d.mts.map

package/dist/substrate/identity.d.mts

@@ -0,0 +1,13 @@
+import { AppName, ChainId, StackName } from "./brand.mjs";
+
+//#region src/substrate/identity.d.ts
+/** Closed identity triple. Architecture § Stack data model. */
+interface Identity {
+  readonly app: AppName;
+  readonly stack: StackName;
+  /** Resolved chain identifier from NetworkResolver. */
+  readonly chain: ChainId;
+}
+//#endregion
+export { Identity };
+//# sourceMappingURL=identity.d.mts.map

package/dist/substrate/lifecycle.d.mts

@@ -0,0 +1,12 @@
+//#region src/substrate/lifecycle.d.ts
+/** Closed state set the scheduler tracks. */
+type LifecycleStatus = 'pending' | 'acquiring' | 'ready' | 'failed' | 'stopping' | 'stopped' | 'done';
+/** Phases on top of statuses. Free-form (architecture Tension 14):
+ *  the engine treats phase as opaque text; renderers project. */
+type PhaseNarration = string;
+/** Author-facing plugin role. Services own long-lived resources;
+ *  tasks acquire a value and then complete. */
+type PluginRole = 'service' | 'task';
+//#endregion
+export { LifecycleStatus, PhaseNarration, PluginRole };
+//# sourceMappingURL=lifecycle.d.mts.map

package/dist/substrate/manifest.d.mts

@@ -0,0 +1,39 @@
+import { EndpointKey, PluginKey } from "./brand.mjs";
+import { Effect, Schema } from "effect";
+
+//#region src/substrate/manifest.d.ts
+/** Manifest envelope. The `services` slot is open (`unknown`) at
+ *  the envelope level; each plugin's Codegenable contribution
+ *  emits a typed file the consumer imports for the typed shape.
+ */
+interface ManifestEnvelope {
+  readonly identity: {
+    readonly app: string;
+    readonly stack: string;
+    readonly chain: string;
+  };
+  readonly manifestVersion: number;
+  readonly services: Readonly<Record<string, unknown>>;
+  readonly endpoints: Readonly<Record<string, EndpointEntry>>;
+  readonly extras: Readonly<Record<string, unknown>>;
+}
+type ManifestExtras = Readonly<Record<string, unknown>>;
+interface ManifestExtrasContext {
+  readonly value: (resource: {
+    readonly id: string;
+  }) => unknown;
+}
+type ManifestExtrasInput = ManifestExtras | Effect.Effect<ManifestExtras, any, never> | ((ctx: ManifestExtrasContext) => ManifestExtras | Effect.Effect<ManifestExtras, any, never>);
+/** Flat endpoint entry — the manifest's load-bearing surface for
+ *  build integrations. */
+interface EndpointEntry {
+  readonly name: string;
+  readonly url: string;
+  readonly displayUrl: string | null;
+  readonly wireProtocol: 'http' | 'h2c' | string;
+  readonly pluginKey: PluginKey;
+  readonly endpointKey: EndpointKey;
+}
+//#endregion
+export { EndpointEntry, ManifestEnvelope, ManifestExtras, ManifestExtrasContext, ManifestExtrasInput };
+//# sourceMappingURL=manifest.d.mts.map

package/dist/substrate/manifest.mjs

@@ -0,0 +1,33 @@
+import { Effect, Schema } from "effect";
+//#region src/substrate/manifest.ts
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const resolveManifestExtras = (input, ctx) => Effect.gen(function* () {
+	if (input === void 0) return {};
+	const resolved = yield* Effect.isEffect(input) ? input : typeof input === "function" ? Effect.sync(() => input(ctx)).pipe(Effect.flatMap((value) => Effect.isEffect(value) ? value : Effect.succeed(value))) : Effect.succeed(input);
+	if (!isRecord(resolved)) return yield* Effect.fail(/* @__PURE__ */ new Error("manifest extras must resolve to a plain record"));
+	return resolved;
+});
+/** Schema for runtime validation of an on-disk manifest. Build
+*  integrations decode through this on read. */
+const ManifestEnvelopeSchema = Schema.Struct({
+	identity: Schema.Struct({
+		app: Schema.String,
+		stack: Schema.String,
+		chain: Schema.String
+	}),
+	manifestVersion: Schema.Number,
+	services: Schema.Record(Schema.String, Schema.Unknown),
+	endpoints: Schema.Record(Schema.String, Schema.Struct({
+		name: Schema.String,
+		url: Schema.String,
+		displayUrl: Schema.NullOr(Schema.String),
+		wireProtocol: Schema.String,
+		pluginKey: Schema.String,
+		endpointKey: Schema.String
+	})),
+	extras: Schema.Record(Schema.String, Schema.Unknown)
+});
+//#endregion
+export { ManifestEnvelopeSchema, resolveManifestExtras };
+
+//# sourceMappingURL=manifest.mjs.map

package/dist/substrate/manifest.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.mjs","names":[],"sources":["../../src/substrate/manifest.ts"],"sourcesContent":["// Manifest envelope schema.\n//\n// Architecture § Manifest data model: envelope shape is fixed at L0,\n// per-service projection is each plugin's responsibility (lives in\n// the Codegenable contribution). Build integrations read the\n// envelope; codegen output carries the typed per-service slice.\n//\n// L0 owns:\n//   - the envelope (identity tuple, manifestVersion, services slot,\n//     endpoints lookup, opaque extras),\n//   - the endpoint-declaration shape (decl emitted by Routable; the\n//     manifest writer at L3 walks them).\n\nimport { Effect, Schema } from 'effect';\n\nimport type { EndpointKey, PluginKey } from './brand.ts';\n\n/** Manifest envelope. The `services` slot is open (`unknown`) at\n *  the envelope level; each plugin's Codegenable contribution\n *  emits a typed file the consumer imports for the typed shape.\n */\nexport interface ManifestEnvelope {\n\treadonly identity: {\n\t\treadonly app: string;\n\t\treadonly stack: string;\n\t\treadonly chain: string;\n\t};\n\treadonly manifestVersion: number;\n\treadonly services: Readonly<Record<string, unknown>>;\n\treadonly endpoints: Readonly<Record<string, EndpointEntry>>;\n\treadonly extras: Readonly<Record<string, unknown>>;\n}\n\nexport type ManifestExtras = Readonly<Record<string, unknown>>;\n\nexport interface ManifestExtrasContext {\n\treadonly value: (resource: { readonly id: string }) => unknown;\n}\n\nexport type ManifestExtrasInput =\n\t| ManifestExtras\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t| Effect.Effect<ManifestExtras, any, never>\n\t| ((\n\t\t\tctx: ManifestExtrasContext,\n\t\t\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t  ) => ManifestExtras | Effect.Effect<ManifestExtras, any, never>);\n\nconst isRecord = (value: unknown): value is ManifestExtras =>\n\ttypeof value === 'object' && value !== null && !Array.isArray(value);\n\nexport const resolveManifestExtras = (\n\tinput: ManifestExtrasInput | undefined,\n\tctx: ManifestExtrasContext,\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n): Effect.Effect<ManifestExtras, Error, never> =>\n\tEffect.gen(function* () {\n\t\tif (input === undefined) return {};\n\t\tconst resolvedEffect = Effect.isEffect(input)\n\t\t\t? input\n\t\t\t: typeof input === 'function'\n\t\t\t\t? Effect.sync(() => input(ctx)).pipe(\n\t\t\t\t\t\tEffect.flatMap((value) => (Effect.isEffect(value) ? value : Effect.succeed(value))),\n\t\t\t\t\t)\n\t\t\t\t: Effect.succeed(input);\n\t\tconst resolved = yield* resolvedEffect;\n\t\tif (!isRecord(resolved)) {\n\t\t\treturn yield* Effect.fail(new Error('manifest extras must resolve to a plain record'));\n\t\t}\n\t\treturn resolved;\n\t});\n\n/** Flat endpoint entry — the manifest's load-bearing surface for\n *  build integrations. */\nexport interface EndpointEntry {\n\treadonly name: string;\n\treadonly url: string;\n\treadonly displayUrl: string | null;\n\treadonly wireProtocol: 'http' | 'h2c' | string;\n\treadonly pluginKey: PluginKey;\n\treadonly endpointKey: EndpointKey;\n}\n\n/** Schema for runtime validation of an on-disk manifest. Build\n *  integrations decode through this on read. */\nexport const ManifestEnvelopeSchema = Schema.Struct({\n\tidentity: Schema.Struct({\n\t\tapp: Schema.String,\n\t\tstack: Schema.String,\n\t\tchain: Schema.String,\n\t}),\n\tmanifestVersion: Schema.Number,\n\tservices: Schema.Record(Schema.String, Schema.Unknown),\n\tendpoints: Schema.Record(\n\t\tSchema.String,\n\t\tSchema.Struct({\n\t\t\tname: Schema.String,\n\t\t\turl: Schema.String,\n\t\t\tdisplayUrl: Schema.NullOr(Schema.String),\n\t\t\twireProtocol: Schema.String,\n\t\t\tpluginKey: Schema.String,\n\t\t\tendpointKey: Schema.String,\n\t\t}),\n\t),\n\textras: Schema.Record(Schema.String, Schema.Unknown),\n});\n"],"mappings":";;AAgDA,MAAM,YAAY,UACjB,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,MAAM;AAErE,MAAa,yBACZ,OACA,QAGA,OAAO,IAAI,aAAa;AACvB,KAAI,UAAU,KAAA,EAAW,QAAO,EAAE;CAQlC,MAAM,WAAW,OAPM,OAAO,SAAS,MAAM,GAC1C,QACA,OAAO,UAAU,aAChB,OAAO,WAAW,MAAM,IAAI,CAAC,CAAC,KAC9B,OAAO,SAAS,UAAW,OAAO,SAAS,MAAM,GAAG,QAAQ,OAAO,QAAQ,MAAM,CAAE,CACnF,GACA,OAAO,QAAQ,MAAM;AAEzB,KAAI,CAAC,SAAS,SAAS,CACtB,QAAO,OAAO,OAAO,qBAAK,IAAI,MAAM,iDAAiD,CAAC;AAEvF,QAAO;EACN;;;AAeH,MAAa,yBAAyB,OAAO,OAAO;CACnD,UAAU,OAAO,OAAO;EACvB,KAAK,OAAO;EACZ,OAAO,OAAO;EACd,OAAO,OAAO;EACd,CAAC;CACF,iBAAiB,OAAO;CACxB,UAAU,OAAO,OAAO,OAAO,QAAQ,OAAO,QAAQ;CACtD,WAAW,OAAO,OACjB,OAAO,QACP,OAAO,OAAO;EACb,MAAM,OAAO;EACb,KAAK,OAAO;EACZ,YAAY,OAAO,OAAO,OAAO,OAAO;EACxC,cAAc,OAAO;EACrB,WAAW,OAAO;EAClB,aAAa,OAAO;EACpB,CAAC,CACF;CACD,QAAQ,OAAO,OAAO,OAAO,QAAQ,OAAO,QAAQ;CACpD,CAAC"}

package/dist/substrate/network.d.mts

@@ -0,0 +1,34 @@
+import { ChainId } from "./brand.mjs";
+
+//#region src/substrate/network.d.ts
+/** Network mode registry. Architecture: fork is a network mode, not
+ *  an orchestrator. Module augmentation can add modes without widening
+ *  every config field. */
+interface DevstackNetworkModeRegistry {
+  readonly local: {
+    readonly rpc?: string;
+  };
+  readonly live: {
+    readonly rpc?: string;
+  };
+  readonly fork: {
+    readonly rpc?: string;
+    readonly checkpoint?: string;
+  };
+}
+type NetworkMode = keyof DevstackNetworkModeRegistry & string;
+/** Substrate-level network record. Plugins consult the resolver once
+ *  per acquire and get this back. */
+type NetworkConfig<Mode extends NetworkMode = NetworkMode> = Readonly<{
+  readonly mode: Mode;
+  /** Chain identity the plugin uses for cache-key folding, ChainProbe
+   *  dispatch, etc. Branded so downstream lookups (chain-probe /
+   *  faucet capability keys) accept it without a re-wrap. */
+  readonly chain: ChainId; /** Source provenance for renderer display. */
+  readonly source?: 'cli' | 'env' | 'config' | 'default';
+} & DevstackNetworkModeRegistry[Mode]>;
+/** Default network shape used when nothing is pinned. */
+type DefaultNetwork = NetworkConfig<'local'>;
+//#endregion
+export { DefaultNetwork, DevstackNetworkModeRegistry, NetworkConfig, NetworkMode };
+//# sourceMappingURL=network.d.mts.map

package/dist/substrate/options.d.mts

@@ -0,0 +1,23 @@
+import { ManifestExtrasInput } from "./manifest.mjs";
+import { NetworkConfig } from "./network.mjs";
+
+//#region src/substrate/options.d.ts
+/** Options shape — all fields optional. Renderer choice
+ *  defaults to `tui`; missing fields fall through to substrate
+ *  defaults. */
+interface DevstackOptions {
+  readonly stackName?: string;
+  readonly network?: NetworkConfig;
+  readonly watchPaths?: ReadonlyArray<string>;
+  readonly stateDir?: string;
+  readonly codegen?: {
+    readonly outputDir?: string;
+    readonly stackSubdir?: string | null;
+  };
+  readonly hotRestart?: boolean;
+  readonly renderer?: 'tui' | 'plain' | 'silent';
+  readonly extras?: ManifestExtrasInput;
+}
+//#endregion
+export { DevstackOptions };
+//# sourceMappingURL=options.d.mts.map

package/dist/substrate/plugin.d.mts

@@ -0,0 +1,101 @@
+import { ChainId, PluginKey } from "./brand.mjs";
+import { PluginRole } from "./lifecycle.mjs";
+import { CapabilityDecl } from "../contracts/capability-decl.mjs";
+import { Identity } from "./identity.mjs";
+import { Effect } from "effect";
+
+//#region src/substrate/plugin.d.ts
+declare const resourceBrand: unique symbol;
+declare const pluginBrand: unique symbol;
+declare const resourceValue: unique symbol;
+declare const dependencyInputBrand: unique symbol;
+interface ResourceRef<Id extends string, Value = unknown> {
+  readonly id: Id;
+  readonly [resourceBrand]: true;
+  readonly [resourceValue]?: () => Value;
+}
+type AnyResourceRef = ResourceRef<string, unknown>;
+type ResourceIdOf<R extends AnyResourceRef> = R['id'];
+type ResourceValueOf<R extends AnyResourceRef> = R extends ResourceRef<string, infer Value> ? Value : never;
+declare const defineId: <const Id extends string>(id: Id) => Id;
+declare const resource: <const Id extends string, Value = unknown>(id: Id) => ResourceRef<Id, Value>;
+type DependencyInput = AnyResourceRef | readonly AnyResourceRef[] | Readonly<Record<string, AnyResourceRef>>;
+type DependencyList<Input> = Input extends readonly AnyResourceRef[] ? Input : Input extends AnyResourceRef ? readonly [Input] : Input extends Readonly<Record<string, AnyResourceRef>> ? ReadonlyArray<Input[keyof Input]> : readonly [];
+type ResolvedDependencyList<Dependencies extends readonly AnyResourceRef[]> = readonly [...{ readonly [K in keyof Dependencies]: Dependencies[K] extends AnyResourceRef ? ResourceValueOf<Dependencies[K]> : never }];
+type ResolvedDependencyObject<Dependencies extends Readonly<Record<string, AnyResourceRef>>> = { readonly [K in keyof Dependencies]: Dependencies[K] extends AnyResourceRef ? ResourceValueOf<Dependencies[K]> : never };
+type ResolvedDependencies<Input> = Input extends undefined ? undefined : Input extends readonly AnyResourceRef[] ? ResolvedDependencyList<Input> : Input extends AnyResourceRef ? ResourceValueOf<Input> : Input extends Readonly<Record<string, AnyResourceRef>> ? ResolvedDependencyObject<Input> : never;
+type AnyPluginStart = (...args: any[]) => Effect.Effect<unknown, unknown, unknown>;
+type PluginStart<Deps> = [Deps] extends [undefined] ? () => Effect.Effect<unknown, unknown, unknown> : (deps: Deps) => Effect.Effect<unknown, unknown, unknown>;
+type StartValue<Start> = Start extends ((...args: any[]) => Effect.Effect<infer Value, unknown, unknown>) ? Value : never;
+interface PluginErrorContribution {
+  readonly _tag: 'PluginErrorContribution';
+  readonly errorTags: ReadonlyArray<string>;
+  readonly formatter?: (value: {
+    readonly _tag: string;
+  } & Readonly<Record<string, unknown>>, recurse: (inner: unknown) => string) => string | null;
+}
+interface WatchDecl {
+  readonly paths: ReadonlyArray<string>;
+  readonly cascade?: boolean;
+}
+interface AcquireContext {
+  readonly identity: Identity;
+  readonly chain: ChainId;
+  readonly runtimeRoot: string;
+}
+type CapabilitiesFactory<Caps extends ReadonlyArray<CapabilityDecl>, Resolved> = (resolved: Resolved, ctx: AcquireContext) => Caps;
+type CapabilitySource<Value, Caps extends ReadonlyArray<CapabilityDecl>> = Caps | ((ctx: {
+  readonly value: Value;
+  readonly runtime: AcquireContext;
+}) => Caps);
+interface PluginSpecBase<Id extends string, Start extends AnyPluginStart, Caps extends ReadonlyArray<CapabilityDecl>> {
+  readonly id: Id;
+  readonly role: PluginRole;
+  readonly pluginKey?: PluginKey | string;
+  readonly watch?: WatchDecl;
+  readonly start: Start;
+  readonly capabilities?: CapabilitySource<StartValue<Start>, Caps>;
+  readonly errorContributions?: ReadonlyArray<PluginErrorContribution>;
+}
+type PluginSpec<Id extends string, DependsOn extends DependencyInput | undefined, Start extends AnyPluginStart, Caps extends ReadonlyArray<CapabilityDecl>> = PluginSpecBase<Id, Start, Caps> & {
+  readonly dependsOn?: DependsOn;
+};
+interface Plugin<Id extends string, Value, Needs extends readonly AnyResourceRef[], Caps extends ReadonlyArray<CapabilityDecl>> extends ResourceRef<Id, Value> {
+  readonly [pluginBrand]: true;
+  readonly [dependencyInputBrand]: DependencyInput | undefined;
+  readonly dependsOn: Needs;
+  readonly role: PluginRole;
+  readonly pluginKey?: PluginKey | string;
+  readonly watch?: WatchDecl;
+  readonly start: (deps: ResolvedDependencies<DependencyInput | undefined>) => Effect.Effect<Value, unknown, unknown>;
+  readonly capabilities?: Caps | CapabilitiesFactory<Caps, Value>;
+  readonly errorContributions?: ReadonlyArray<PluginErrorContribution>;
+}
+type AnyPlugin = Plugin<string, any, readonly AnyResourceRef[], ReadonlyArray<CapabilityDecl>>;
+declare function definePlugin<const Id extends string, const DependsOn extends readonly AnyResourceRef[], const Start extends PluginStart<ResolvedDependencyList<DependsOn>> = PluginStart<ResolvedDependencyList<DependsOn>>, const Caps extends ReadonlyArray<CapabilityDecl> = ReadonlyArray<CapabilityDecl>>(spec: PluginSpecBase<Id, Start, Caps> & {
+  readonly dependsOn: DependsOn;
+}): Plugin<Id, StartValue<Start>, DependsOn, Caps>;
+declare function definePlugin<const Id extends string, const DependsOn extends Readonly<Record<string, AnyResourceRef>>, const Start extends PluginStart<ResolvedDependencyObject<DependsOn>> = PluginStart<ResolvedDependencyObject<DependsOn>>, const Caps extends ReadonlyArray<CapabilityDecl> = ReadonlyArray<CapabilityDecl>>(spec: PluginSpecBase<Id, Start, Caps> & {
+  readonly dependsOn: DependsOn;
+}): Plugin<Id, StartValue<Start>, DependencyList<DependsOn>, Caps>;
+declare function definePlugin<const Id extends string, const DependsOn extends AnyResourceRef, const Start extends PluginStart<ResourceValueOf<DependsOn>> = PluginStart<ResourceValueOf<DependsOn>>, const Caps extends ReadonlyArray<CapabilityDecl> = ReadonlyArray<CapabilityDecl>>(spec: PluginSpecBase<Id, Start, Caps> & {
+  readonly dependsOn: DependsOn;
+}): Plugin<Id, StartValue<Start>, readonly [DependsOn], Caps>;
+declare function definePlugin<const Id extends string, const Start extends PluginStart<undefined> = PluginStart<undefined>, const Caps extends ReadonlyArray<CapabilityDecl> = ReadonlyArray<CapabilityDecl>>(spec: PluginSpecBase<Id, Start, Caps> & {
+  readonly dependsOn?: undefined;
+}): Plugin<Id, StartValue<Start>, readonly [], Caps>;
+type ProvidedIdsOf<Members> = Members extends ReadonlyArray<unknown> ? Members[number] extends {
+  readonly id: infer Id extends string;
+} ? Id : never : never;
+type ConsumedIdsOf<Members> = Members extends ReadonlyArray<unknown> ? Members[number] extends {
+  readonly dependsOn: infer Dependencies;
+} ? Dependencies extends ReadonlyArray<infer Dependency> ? Dependency extends {
+  readonly id: infer Id extends string;
+} ? Id : never : never : never : never;
+type MissingProviders<Members> = Exclude<ConsumedIdsOf<Members>, ProvidedIdsOf<Members>>;
+interface __MissingProvidersError<Missing extends string> {
+  readonly __missing_providers: Missing;
+}
+//#endregion
+export { AnyPlugin, AnyResourceRef, CapabilitiesFactory, CapabilitySource, DependencyInput, DependencyList, MissingProviders, Plugin, PluginErrorContribution, PluginSpec, ResolvedDependencies, ResolvedDependencyList, ResolvedDependencyObject, ResourceIdOf, ResourceRef, ResourceValueOf, WatchDecl, __MissingProvidersError, defineId, definePlugin, resource };
+//# sourceMappingURL=plugin.d.mts.map

package/dist/substrate/plugin.mjs

@@ -0,0 +1,61 @@
+//#region src/substrate/plugin.ts
+const resourceBrand = Symbol.for("devstack.resource");
+const pluginBrand = Symbol.for("devstack.plugin");
+const dependencyInputBrand = Symbol.for("devstack.plugin.dependency-input");
+const defineId = (id) => id;
+const resource = (id) => ({
+	id,
+	[resourceBrand]: true
+});
+const isResourceRef = (value) => typeof value === "object" && value !== null && value[resourceBrand] === true;
+const isPlugin = (value) => typeof value === "object" && value !== null && value[pluginBrand] === true;
+const dependencyList = (dependsOn) => {
+	if (dependsOn === void 0) return [];
+	if (Array.isArray(dependsOn)) return dependsOn;
+	if (isResourceRef(dependsOn)) return [dependsOn];
+	return Object.values(dependsOn);
+};
+const uniqueResourceRefs = (refs) => {
+	const seen = /* @__PURE__ */ new Set();
+	const unique = [];
+	for (const ref of refs) {
+		if (seen.has(ref.id)) continue;
+		seen.add(ref.id);
+		unique.push(ref);
+	}
+	return unique;
+};
+const resolveDependencyValues = (dependsOn, read) => {
+	const readAny = (resourceRef) => read(resourceRef);
+	if (dependsOn === void 0) return;
+	if (Array.isArray(dependsOn)) return dependsOn.map((resourceRef) => readAny(resourceRef));
+	if (isResourceRef(dependsOn)) return readAny(dependsOn);
+	return Object.fromEntries(Object.entries(dependsOn).map(([key, resourceRef]) => [key, readAny(resourceRef)]));
+};
+const resolvePluginDependencies = (plugin, read) => resolveDependencyValues(plugin[dependencyInputBrand], (resourceRef) => read(resourceRef));
+const pluginDependencyRefs = (plugin) => dependencyList(plugin[dependencyInputBrand]);
+function definePlugin(spec) {
+	const dependsOn = uniqueResourceRefs(dependencyList(spec.dependsOn));
+	const capabilitiesField = spec.capabilities;
+	const capabilities = typeof capabilitiesField === "function" ? (value, runtime) => capabilitiesField({
+		value,
+		runtime
+	}) : capabilitiesField;
+	return {
+		[resourceBrand]: true,
+		[pluginBrand]: true,
+		[dependencyInputBrand]: spec.dependsOn,
+		id: spec.id,
+		dependsOn,
+		role: spec.role,
+		start: spec.start,
+		...spec.pluginKey === void 0 ? {} : { pluginKey: spec.pluginKey },
+		...spec.watch === void 0 ? {} : { watch: spec.watch },
+		...capabilities === void 0 ? {} : { capabilities },
+		...spec.errorContributions === void 0 ? {} : { errorContributions: spec.errorContributions }
+	};
+}
+//#endregion
+export { defineId, definePlugin, dependencyList, isPlugin, pluginDependencyRefs, resolveDependencyValues, resolvePluginDependencies, resource, uniqueResourceRefs };
+
+//# sourceMappingURL=plugin.mjs.map

package/dist/substrate/plugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.mjs","names":[],"sources":["../../src/substrate/plugin.ts"],"sourcesContent":["// Resource-native plugin contract.\n//\n// Public plugin authors use `definePlugin({ id, dependsOn, start })`.\n// The substrate now consumes that same shape directly: resource ids\n// drive scheduling, resolved dependency values are constructed by the\n// supervisor, and plugin bodies run through `start(...)`.\n\nimport type { Effect } from 'effect';\n\nimport type { CapabilityDecl } from '../contracts/capability-decl.ts';\nimport type { ChainId, PluginKey } from './brand.ts';\nimport type { Identity } from './identity.ts';\nimport type { PluginRole } from './lifecycle.ts';\n\nconst resourceBrand: unique symbol = Symbol.for('devstack.resource') as never;\nconst pluginBrand: unique symbol = Symbol.for('devstack.plugin') as never;\nconst resourceValue: unique symbol = Symbol.for('devstack.resource.value') as never;\nconst dependencyInputBrand: unique symbol = Symbol.for('devstack.plugin.dependency-input') as never;\n\nexport interface ResourceRef<Id extends string, Value = unknown> {\n\treadonly id: Id;\n\treadonly [resourceBrand]: true;\n\treadonly [resourceValue]?: () => Value;\n}\n\nexport type AnyResourceRef = ResourceRef<string, unknown>;\n\nexport type ResourceIdOf<R extends AnyResourceRef> = R['id'];\n\nexport type ResourceValueOf<R extends AnyResourceRef> =\n\tR extends ResourceRef<string, infer Value> ? Value : never;\n\nexport const defineId = <const Id extends string>(id: Id): Id => id;\n\nexport const resource = <const Id extends string, Value = unknown>(\n\tid: Id,\n): ResourceRef<Id, Value> =>\n\t({\n\t\tid,\n\t\t[resourceBrand]: true,\n\t}) as ResourceRef<Id, Value>;\n\nexport const isResourceRef = (value: unknown): value is AnyResourceRef =>\n\ttypeof value === 'object' &&\n\tvalue !== null &&\n\t(value as { readonly [resourceBrand]?: true })[resourceBrand] === true;\n\nexport type DependencyInput =\n\t| AnyResourceRef\n\t| readonly AnyResourceRef[]\n\t| Readonly<Record<string, AnyResourceRef>>;\n\nexport type DependencyList<Input> = Input extends readonly AnyResourceRef[]\n\t? Input\n\t: Input extends AnyResourceRef\n\t\t? readonly [Input]\n\t\t: Input extends Readonly<Record<string, AnyResourceRef>>\n\t\t\t? ReadonlyArray<Input[keyof Input]>\n\t\t\t: readonly [];\n\nexport type ResolvedDependencyList<Dependencies extends readonly AnyResourceRef[]> = readonly [\n\t...{\n\t\treadonly [K in keyof Dependencies]: Dependencies[K] extends AnyResourceRef\n\t\t\t? ResourceValueOf<Dependencies[K]>\n\t\t\t: never;\n\t},\n];\n\nexport type ResolvedDependencyObject<\n\tDependencies extends Readonly<Record<string, AnyResourceRef>>,\n> = {\n\treadonly [K in keyof Dependencies]: Dependencies[K] extends AnyResourceRef\n\t\t? ResourceValueOf<Dependencies[K]>\n\t\t: never;\n};\n\nexport type ResolvedDependencies<Input> = Input extends undefined\n\t? undefined\n\t: Input extends readonly AnyResourceRef[]\n\t\t? ResolvedDependencyList<Input>\n\t\t: Input extends AnyResourceRef\n\t\t\t? ResourceValueOf<Input>\n\t\t\t: Input extends Readonly<Record<string, AnyResourceRef>>\n\t\t\t\t? ResolvedDependencyObject<Input>\n\t\t\t\t: never;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnyPluginStart = (...args: any[]) => Effect.Effect<unknown, unknown, unknown>;\n\ntype PluginStart<Deps> = [Deps] extends [undefined]\n\t? () => Effect.Effect<unknown, unknown, unknown>\n\t: (deps: Deps) => Effect.Effect<unknown, unknown, unknown>;\n\ntype StartValue<Start> = Start extends (\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t...args: any[]\n) => Effect.Effect<infer Value, unknown, unknown>\n\t? Value\n\t: never;\n\nexport interface PluginErrorContribution {\n\treadonly _tag: 'PluginErrorContribution';\n\treadonly errorTags: ReadonlyArray<string>;\n\treadonly formatter?: (\n\t\tvalue: { readonly _tag: string } & Readonly<Record<string, unknown>>,\n\t\trecurse: (inner: unknown) => string,\n\t) => string | null;\n}\n\nexport interface WatchDecl {\n\treadonly paths: ReadonlyArray<string>;\n\treadonly cascade?: boolean;\n}\n\nexport interface AcquireContext {\n\treadonly identity: Identity;\n\treadonly chain: ChainId;\n\treadonly runtimeRoot: string;\n}\n\nexport type CapabilitiesFactory<Caps extends ReadonlyArray<CapabilityDecl>, Resolved> = (\n\tresolved: Resolved,\n\tctx: AcquireContext,\n) => Caps;\n\nexport type CapabilitySource<Value, Caps extends ReadonlyArray<CapabilityDecl>> =\n\t| Caps\n\t| ((ctx: { readonly value: Value; readonly runtime: AcquireContext }) => Caps);\n\ninterface PluginSpecBase<\n\tId extends string,\n\tStart extends AnyPluginStart,\n\tCaps extends ReadonlyArray<CapabilityDecl>,\n> {\n\treadonly id: Id;\n\treadonly role: PluginRole;\n\treadonly pluginKey?: PluginKey | string;\n\treadonly watch?: WatchDecl;\n\treadonly start: Start;\n\treadonly capabilities?: CapabilitySource<StartValue<Start>, Caps>;\n\treadonly errorContributions?: ReadonlyArray<PluginErrorContribution>;\n}\n\nexport type PluginSpec<\n\tId extends string,\n\tDependsOn extends DependencyInput | undefined,\n\tStart extends AnyPluginStart,\n\tCaps extends ReadonlyArray<CapabilityDecl>,\n> = PluginSpecBase<Id, Start, Caps> & {\n\treadonly dependsOn?: DependsOn;\n};\n\nexport interface Plugin<\n\tId extends string,\n\tValue,\n\tNeeds extends readonly AnyResourceRef[],\n\tCaps extends ReadonlyArray<CapabilityDecl>,\n> extends ResourceRef<Id, Value> {\n\treadonly [pluginBrand]: true;\n\treadonly [dependencyInputBrand]: DependencyInput | undefined;\n\treadonly dependsOn: Needs;\n\treadonly role: PluginRole;\n\treadonly pluginKey?: PluginKey | string;\n\treadonly watch?: WatchDecl;\n\treadonly start: (\n\t\tdeps: ResolvedDependencies<DependencyInput | undefined>,\n\t) => Effect.Effect<Value, unknown, unknown>;\n\treadonly capabilities?: Caps | CapabilitiesFactory<Caps, Value>;\n\treadonly errorContributions?: ReadonlyArray<PluginErrorContribution>;\n}\n\nexport type AnyPlugin = Plugin<\n\tstring,\n\t// Erased runtime plugin values must be `any` rather than `unknown`\n\t// so concrete dynamic capability factories remain assignable under\n\t// strict function parameter variance. Precise value types stay on\n\t// concrete `Plugin<Id, Value, ...>` instances.\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\tany,\n\treadonly AnyResourceRef[],\n\tReadonlyArray<CapabilityDecl>\n>;\n\nexport const isPlugin = (value: unknown): value is AnyPlugin =>\n\ttypeof value === 'object' &&\n\tvalue !== null &&\n\t(value as { readonly [pluginBrand]?: true })[pluginBrand] === true;\n\nexport const dependencyList = <Input extends DependencyInput | undefined>(\n\tdependsOn: Input,\n): DependencyList<Input> => {\n\tif (dependsOn === undefined) {\n\t\treturn [] as unknown as DependencyList<Input>;\n\t}\n\tif (Array.isArray(dependsOn)) {\n\t\treturn dependsOn as unknown as DependencyList<Input>;\n\t}\n\tif (isResourceRef(dependsOn)) {\n\t\treturn [dependsOn] as unknown as DependencyList<Input>;\n\t}\n\treturn Object.values(dependsOn) as unknown as DependencyList<Input>;\n};\n\nexport const uniqueResourceRefs = (refs: readonly AnyResourceRef[]): readonly AnyResourceRef[] => {\n\tconst seen = new Set<string>();\n\tconst unique: AnyResourceRef[] = [];\n\tfor (const ref of refs) {\n\t\tif (seen.has(ref.id)) continue;\n\t\tseen.add(ref.id);\n\t\tunique.push(ref);\n\t}\n\treturn unique;\n};\n\nexport const resolveDependencyValues = <Input extends DependencyInput | undefined>(\n\tdependsOn: Input,\n\tread: (resource: DependencyList<Input>[number]) => unknown,\n): ResolvedDependencies<Input> => {\n\tconst readAny = (resourceRef: AnyResourceRef) =>\n\t\tread(resourceRef as DependencyList<Input>[number]);\n\n\tif (dependsOn === undefined) {\n\t\treturn undefined as ResolvedDependencies<Input>;\n\t}\n\tif (Array.isArray(dependsOn)) {\n\t\treturn dependsOn.map((resourceRef) => readAny(resourceRef)) as ResolvedDependencies<Input>;\n\t}\n\tif (isResourceRef(dependsOn)) {\n\t\treturn readAny(dependsOn) as ResolvedDependencies<Input>;\n\t}\n\treturn Object.fromEntries(\n\t\tObject.entries(dependsOn).map(([key, resourceRef]) => [key, readAny(resourceRef)]),\n\t) as ResolvedDependencies<Input>;\n};\n\nexport const resolvePluginDependencies = (\n\tplugin: AnyPlugin,\n\tread: (resource: AnyResourceRef) => unknown,\n): ResolvedDependencies<DependencyInput | undefined> =>\n\tresolveDependencyValues(plugin[dependencyInputBrand], (resourceRef) =>\n\t\tread(resourceRef as AnyResourceRef),\n\t);\n\nexport const pluginDependencyRefs = (plugin: AnyPlugin): readonly AnyResourceRef[] =>\n\tdependencyList(plugin[dependencyInputBrand]) as readonly AnyResourceRef[];\n\nexport function definePlugin<\n\tconst Id extends string,\n\tconst DependsOn extends readonly AnyResourceRef[],\n\tconst Start extends PluginStart<ResolvedDependencyList<DependsOn>> = PluginStart<\n\t\tResolvedDependencyList<DependsOn>\n\t>,\n\tconst Caps extends ReadonlyArray<CapabilityDecl> = ReadonlyArray<CapabilityDecl>,\n>(\n\tspec: PluginSpecBase<Id, Start, Caps> & {\n\t\treadonly dependsOn: DependsOn;\n\t},\n): Plugin<Id, StartValue<Start>, DependsOn, Caps>;\nexport function definePlugin<\n\tconst Id extends string,\n\tconst DependsOn extends Readonly<Record<string, AnyResourceRef>>,\n\tconst Start extends PluginStart<ResolvedDependencyObject<DependsOn>> = PluginStart<\n\t\tResolvedDependencyObject<DependsOn>\n\t>,\n\tconst Caps extends ReadonlyArray<CapabilityDecl> = ReadonlyArray<CapabilityDecl>,\n>(\n\tspec: PluginSpecBase<Id, Start, Caps> & {\n\t\treadonly dependsOn: DependsOn;\n\t},\n): Plugin<Id, StartValue<Start>, DependencyList<DependsOn>, Caps>;\nexport function definePlugin<\n\tconst Id extends string,\n\tconst DependsOn extends AnyResourceRef,\n\tconst Start extends PluginStart<ResourceValueOf<DependsOn>> = PluginStart<\n\t\tResourceValueOf<DependsOn>\n\t>,\n\tconst Caps extends ReadonlyArray<CapabilityDecl> = ReadonlyArray<CapabilityDecl>,\n>(\n\tspec: PluginSpecBase<Id, Start, Caps> & {\n\t\treadonly dependsOn: DependsOn;\n\t},\n): Plugin<Id, StartValue<Start>, readonly [DependsOn], Caps>;\nexport function definePlugin<\n\tconst Id extends string,\n\tconst Start extends PluginStart<undefined> = PluginStart<undefined>,\n\tconst Caps extends ReadonlyArray<CapabilityDecl> = ReadonlyArray<CapabilityDecl>,\n>(\n\tspec: PluginSpecBase<Id, Start, Caps> & {\n\t\treadonly dependsOn?: undefined;\n\t},\n): Plugin<Id, StartValue<Start>, readonly [], Caps>;\nexport function definePlugin(\n\tspec: PluginSpecBase<string, AnyPluginStart, ReadonlyArray<CapabilityDecl>> & {\n\t\treadonly dependsOn?: DependencyInput;\n\t},\n): AnyPlugin {\n\tconst dependsOn = uniqueResourceRefs(dependencyList(spec.dependsOn));\n\tconst capabilitiesField = spec.capabilities;\n\tconst capabilities =\n\t\ttypeof capabilitiesField === 'function'\n\t\t\t? (value: unknown, runtime: AcquireContext) => capabilitiesField({ value, runtime })\n\t\t\t: capabilitiesField;\n\n\treturn {\n\t\t[resourceBrand]: true,\n\t\t[pluginBrand]: true,\n\t\t[dependencyInputBrand]: spec.dependsOn,\n\t\tid: spec.id,\n\t\tdependsOn,\n\t\trole: spec.role,\n\t\tstart: spec.start as AnyPlugin['start'],\n\t\t...(spec.pluginKey === undefined ? {} : { pluginKey: spec.pluginKey }),\n\t\t...(spec.watch === undefined ? {} : { watch: spec.watch }),\n\t\t...(capabilities === undefined ? {} : { capabilities }),\n\t\t...(spec.errorContributions === undefined\n\t\t\t? {}\n\t\t\t: { errorContributions: spec.errorContributions }),\n\t} as AnyPlugin;\n}\n\nexport type ProvidedIdsOf<Members> =\n\tMembers extends ReadonlyArray<unknown>\n\t\t? Members[number] extends { readonly id: infer Id extends string }\n\t\t\t? Id\n\t\t\t: never\n\t\t: never;\n\nexport type ConsumedIdsOf<Members> =\n\tMembers extends ReadonlyArray<unknown>\n\t\t? Members[number] extends { readonly dependsOn: infer Dependencies }\n\t\t\t? Dependencies extends ReadonlyArray<infer Dependency>\n\t\t\t\t? Dependency extends { readonly id: infer Id extends string }\n\t\t\t\t\t? Id\n\t\t\t\t\t: never\n\t\t\t\t: never\n\t\t\t: never\n\t\t: never;\n\nexport type MissingProviders<Members> = Exclude<ConsumedIdsOf<Members>, ProvidedIdsOf<Members>>;\n\nexport interface __MissingProvidersError<Missing extends string> {\n\treadonly __missing_providers: Missing;\n}\n"],"mappings":";AAcA,MAAM,gBAA+B,OAAO,IAAI,oBAAoB;AACpE,MAAM,cAA6B,OAAO,IAAI,kBAAkB;AAEhE,MAAM,uBAAsC,OAAO,IAAI,mCAAmC;AAe1F,MAAa,YAAqC,OAAe;AAEjE,MAAa,YACZ,QAEC;CACA;EACC,gBAAgB;CACjB;AAEF,MAAa,iBAAiB,UAC7B,OAAO,UAAU,YACjB,UAAU,QACT,MAA8C,mBAAmB;AA0InE,MAAa,YAAY,UACxB,OAAO,UAAU,YACjB,UAAU,QACT,MAA4C,iBAAiB;AAE/D,MAAa,kBACZ,cAC2B;AAC3B,KAAI,cAAc,KAAA,EACjB,QAAO,EAAE;AAEV,KAAI,MAAM,QAAQ,UAAU,CAC3B,QAAO;AAER,KAAI,cAAc,UAAU,CAC3B,QAAO,CAAC,UAAU;AAEnB,QAAO,OAAO,OAAO,UAAU;;AAGhC,MAAa,sBAAsB,SAA+D;CACjG,MAAM,uBAAO,IAAI,KAAa;CAC9B,MAAM,SAA2B,EAAE;AACnC,MAAK,MAAM,OAAO,MAAM;AACvB,MAAI,KAAK,IAAI,IAAI,GAAG,CAAE;AACtB,OAAK,IAAI,IAAI,GAAG;AAChB,SAAO,KAAK,IAAI;;AAEjB,QAAO;;AAGR,MAAa,2BACZ,WACA,SACiC;CACjC,MAAM,WAAW,gBAChB,KAAK,YAA6C;AAEnD,KAAI,cAAc,KAAA,EACjB;AAED,KAAI,MAAM,QAAQ,UAAU,CAC3B,QAAO,UAAU,KAAK,gBAAgB,QAAQ,YAAY,CAAC;AAE5D,KAAI,cAAc,UAAU,CAC3B,QAAO,QAAQ,UAAU;AAE1B,QAAO,OAAO,YACb,OAAO,QAAQ,UAAU,CAAC,KAAK,CAAC,KAAK,iBAAiB,CAAC,KAAK,QAAQ,YAAY,CAAC,CAAC,CAClF;;AAGF,MAAa,6BACZ,QACA,SAEA,wBAAwB,OAAO,wBAAwB,gBACtD,KAAK,YAA8B,CACnC;AAEF,MAAa,wBAAwB,WACpC,eAAe,OAAO,sBAAsB;AA+C7C,SAAgB,aACf,MAGY;CACZ,MAAM,YAAY,mBAAmB,eAAe,KAAK,UAAU,CAAC;CACpE,MAAM,oBAAoB,KAAK;CAC/B,MAAM,eACL,OAAO,sBAAsB,cACzB,OAAgB,YAA4B,kBAAkB;EAAE;EAAO;EAAS,CAAC,GAClF;AAEJ,QAAO;GACL,gBAAgB;GAChB,cAAc;GACd,uBAAuB,KAAK;EAC7B,IAAI,KAAK;EACT;EACA,MAAM,KAAK;EACX,OAAO,KAAK;EACZ,GAAI,KAAK,cAAc,KAAA,IAAY,EAAE,GAAG,EAAE,WAAW,KAAK,WAAW;EACrE,GAAI,KAAK,UAAU,KAAA,IAAY,EAAE,GAAG,EAAE,OAAO,KAAK,OAAO;EACzD,GAAI,iBAAiB,KAAA,IAAY,EAAE,GAAG,EAAE,cAAc;EACtD,GAAI,KAAK,uBAAuB,KAAA,IAC7B,EAAE,GACF,EAAE,oBAAoB,KAAK,oBAAoB;EAClD"}

package/dist/substrate/projection.d.mts

@@ -0,0 +1,100 @@
+import { EndpointKey, PluginKey } from "./brand.mjs";
+import { LifecycleStatus, PhaseNarration, PluginRole } from "./lifecycle.mjs";
+
+//#region src/substrate/projection.d.ts
+/** Top-level subscribable state. Renderers project this. */
+interface SubscribableState {
+  readonly identity: {
+    readonly app: string;
+    readonly stack: string;
+    readonly network: string;
+  };
+  readonly cycle: {
+    readonly id: number;
+    readonly startedAt: number;
+    readonly phase: 'booting' | 'running' | 'restarting' | 'shutting-down';
+  };
+  readonly rows: ReadonlyArray<Row>;
+  readonly endpoints: ReadonlyArray<Endpoint>;
+  readonly accounts: ReadonlyArray<AccountProjection>;
+  readonly packages: ReadonlyArray<PackageProjection>;
+  readonly errors: ReadonlyArray<StructuredError>;
+  readonly lastEvent: {
+    readonly seq: number;
+    readonly at: number;
+  };
+  readonly stackBuild: ReadonlyArray<BuildEntry>;
+}
+/** One row per visible plugin instance. */
+interface Row {
+  readonly key: PluginKey;
+  readonly role: PluginRole;
+  readonly status: LifecycleStatus;
+  readonly phase: PhaseNarration | null;
+  readonly lastError: StructuredError | null;
+  readonly logTail: LogTail;
+  readonly endpoints: ReadonlyArray<EndpointKey>;
+  readonly selectiveRestartHighlight: boolean;
+}
+interface LogTail {
+  readonly lines: ReadonlyArray<string>;
+  readonly level: 'info' | 'warn' | 'error';
+  readonly truncated: boolean;
+}
+interface Endpoint {
+  readonly endpointKey: EndpointKey;
+  readonly name: string;
+  readonly url: string;
+  readonly displayUrl: string | null;
+  readonly wireProtocol: 'http' | 'h2c' | string;
+  readonly registeredAt: number;
+}
+interface AccountProjection {
+  readonly key: `account/${string}`;
+  readonly rowKey: PluginKey | null;
+  readonly name: string;
+  readonly address: string | null;
+  readonly scheme: 'ed25519' | 'secp256k1' | 'secp256r1' | null;
+  readonly source: 'real' | 'impersonate' | null;
+  readonly funding: {
+    readonly status: 'pending' | 'funded' | 'skipped' | 'failed' | 'unknown';
+    readonly balanceMist: string | null;
+    readonly requestedMist: string | null;
+    readonly entries?: ReadonlyArray<{
+      readonly coin: string;
+      readonly fullCoinType: string;
+      readonly amount: string;
+      readonly status: 'funded' | 'skipped';
+    }>;
+  };
+  readonly walletVisible: boolean;
+  readonly updatedAt: number;
+}
+interface PackageProjection {
+  readonly key: `package/${string}`;
+  readonly rowKey: PluginKey | null;
+  readonly name: string;
+  readonly kind: 'local' | 'known';
+  readonly packageId: string;
+  readonly upgradeCapId: string | null;
+  readonly mvrPlaceholder: string;
+  readonly sourcePath: string | null;
+  readonly updatedAt: number;
+}
+interface StructuredError {
+  readonly at: number;
+  readonly pluginKey: PluginKey | null;
+  readonly tag: string;
+  readonly summary: string;
+  readonly chain: ReadonlyArray<string>;
+  readonly severity: 'warn' | 'error' | 'fatal';
+}
+interface BuildEntry {
+  readonly pluginKey: PluginKey | null;
+  readonly phase: string;
+  readonly progress: string;
+  readonly startedAt: number;
+}
+//#endregion
+export { AccountProjection, BuildEntry, Endpoint, PackageProjection, StructuredError, SubscribableState };
+//# sourceMappingURL=projection.d.mts.map