@plurnk/plurnk-service 1.0.0

package/dist/core/TokenGauge.js

@@ -0,0 +1,58 @@
+// #312 — the token gauge: derived token counts keyed on (content_hash, tokenizer_id), the
+// deep_hash discipline applied to token arithmetic. The mimetypes Tokenizers seam (mimetypes#44)
+// supplies the identity (tokenizer.json sha — NEVER the model id: deepseek pro↔flash share a
+// vocab, so that swap recounts nothing; gemma↔deepseek recounts all) and the exact counter.
+// When the seam resolves nothing exact for the active model, the provider's chars/2 upper bound
+// is used AND SURFACED (`tokenizer_unavailable`, once per model) — an error-class signal, never
+// a silent number. Resolutions are cached per model ref; derivation rows are shared session-wide.
+import { createHash } from "node:crypto";
+export default class TokenGauge {
+    static #resolutions = new Map();
+    static #warned = new Set();
+    static contentHash(content) {
+        return createHash("sha256").update(content).digest("hex");
+    }
+    // Resolve the active model's gauge: the seam's exact tokenizer, or the provider's surfaced
+    // upper bound labeled with a heuristic identity (so its rows never masquerade as exact ones).
+    // providers#37 (delivered, 0.35.0): Provider.servedModel is the backend's self-reported
+    // identity from the boot probe — an alias-fronted local backend ('turboderp' → the gguf name)
+    // resolves its exact tokenizer from turn 1. Absent (hosted/no-probe), the alias model tries;
+    // inexact runs as a SURFACED upper bound (#312 ask 3) — never a silent number.
+    static async resolve(mimetypes, provider, pushTelemetry) {
+        const key = provider.model;
+        const cached = TokenGauge.#resolutions.get(key);
+        if (cached !== undefined)
+            return cached;
+        let resolution;
+        try {
+            if (mimetypes === undefined)
+                throw new Error("no mimetypes seam");
+            const r = await mimetypes.tokenizer(provider.servedModel ?? provider.model);
+            resolution = { tokenizerId: r.exact ? r.tokenizerId : `heuristic:${r.tokenizerId}`, exact: r.exact, count: (text) => r.countTokens(text) };
+            if (!r.exact && !TokenGauge.#warned.has(key)) {
+                TokenGauge.#warned.add(key);
+                pushTelemetry?.({ source: "engine:tokens", kind: "tokenizer_unavailable", message: `no exact tokenizer for '${provider.model}' — counts are an upper bound (chars/2 class); budget refusals run conservative`, level: "warn" });
+            }
+        }
+        catch {
+            resolution = { tokenizerId: "heuristic:provider", exact: false, count: async (text) => provider.countTokens(text) };
+            if (!TokenGauge.#warned.has(key)) {
+                TokenGauge.#warned.add(key);
+                pushTelemetry?.({ source: "engine:tokens", kind: "tokenizer_unavailable", message: `tokenizer seam resolved nothing for '${provider.model}' — provider upper bound in use`, level: "warn" });
+            }
+        }
+        TokenGauge.#resolutions.set(key, resolution);
+        return resolution;
+    }
+    // The keyed lookup: (content_hash, tokenizer_id) → tokens; miss → count + upsert. The row is
+    // shared by every entry carrying identical content, across models sharing a vocabulary.
+    static async tokensFor(db, gauge, contentHash, content) {
+        const hit = await db.token_count_get.get({ content_hash: contentHash, tokenizer_id: gauge.tokenizerId });
+        if (hit !== undefined)
+            return hit.tokens;
+        const tokens = await gauge.count(content);
+        await db.token_count_upsert.run({ content_hash: contentHash, tokenizer_id: gauge.tokenizerId, tokens });
+        return tokens;
+    }
+}
+//# sourceMappingURL=TokenGauge.js.map

package/dist/core/TokenGauge.js.map

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

package/dist/core/caps/CapsResolve.d.ts

@@ -0,0 +1,5 @@
+import type { PlurnkSchemeContext } from "../scheme-types.ts";
+export default class CapsResolve {
+    static entryId(ctx: PlurnkSchemeContext, scheme: string | null, pathname: string): Promise<number | null>;
+}
+//# sourceMappingURL=CapsResolve.d.ts.map

package/dist/core/caps/CapsResolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CapsResolve.d.ts","sourceRoot":"","sources":["../../../src/core/caps/CapsResolve.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,MAAM,CAAC,OAAO,OAAO,WAAW;IAC5B,OAAa,OAAO,CAAC,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAK9G;CACJ"}

package/dist/core/caps/CapsResolve.js

@@ -0,0 +1,13 @@
+// Shared pathname→entryId resolution for the db-backed capability impls.
+// channels/tags/notify operate on entry-id-keyed statements; entries goes
+// through EntryCrud (which resolves internally). Static delegation, not a base
+// class — the caps call it, they don't inherit it.
+export default class CapsResolve {
+    static async entryId(ctx, scheme, pathname) {
+        const row = await ctx.db.crud_find_session_entry.get({
+            session_id: ctx.sessionId, scheme, pathname,
+        });
+        return row?.id ?? null;
+    }
+}
+//# sourceMappingURL=CapsResolve.js.map

package/dist/core/caps/CapsResolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CapsResolve.js","sourceRoot":"","sources":["../../../src/core/caps/CapsResolve.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,0EAA0E;AAC1E,+EAA+E;AAC/E,mDAAmD;AAKnD,MAAM,CAAC,OAAO,OAAO,WAAW;IAC5B,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,GAAwB,EAAE,MAAqB,EAAE,QAAgB;QAClF,MAAM,GAAG,GAAG,MAAO,GAAG,CAAC,EAAE,CAAC,uBAAsC,CAAC,GAAG,CAAiB;YACjF,UAAU,EAAE,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ;SAC9C,CAAC,CAAC;QACH,OAAO,GAAG,EAAE,EAAE,IAAI,IAAI,CAAC;IAC3B,CAAC;CACJ"}

package/dist/core/caps/DbChannelCaps.d.ts

@@ -0,0 +1,16 @@
+import type { ChannelCaps, ChannelState } from "@plurnk/plurnk-schemes";
+import type { PlurnkSchemeContext } from "../scheme-types.ts";
+export default class DbChannelCaps implements ChannelCaps {
+    #private;
+    constructor(ctx: PlurnkSchemeContext, scheme: string | null);
+    append(pathname: string, channel: string, content: string): Promise<{
+        status: number;
+    }>;
+    replace(pathname: string, channel: string, content: string): Promise<{
+        status: number;
+    }>;
+    setState(pathname: string, channel: string, state: ChannelState): Promise<{
+        status: number;
+    }>;
+}
+//# sourceMappingURL=DbChannelCaps.d.ts.map

package/dist/core/caps/DbChannelCaps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DbChannelCaps.d.ts","sourceRoot":"","sources":["../../../src/core/caps/DbChannelCaps.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAI9D,MAAM,CAAC,OAAO,OAAO,aAAc,YAAW,WAAW;;IAIrD,YAAY,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAG1D;IAEK,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAK5F;IAEK,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAS7F;IAEK,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAKlG;CACJ"}

package/dist/core/caps/DbChannelCaps.js

@@ -0,0 +1,41 @@
+// db-backed ChannelCaps (@plurnk/plurnk-schemes) — keystone PR-2 seam (#180).
+// append/replace/setState over a single channel, addressed by pathname. Resolves
+// pathname→entryId, then drives the ChannelWrite SQL. append grows existing
+// content (token re-count deferred to render, per §tokenomics); replace swaps content
+// and re-tokenizes at write. Absent entry or channel → 404.
+import CapsResolve from "./CapsResolve.js";
+export default class DbChannelCaps {
+    #ctx;
+    #scheme;
+    constructor(ctx, scheme) {
+        this.#ctx = ctx;
+        this.#scheme = scheme;
+    }
+    async append(pathname, channel, content) {
+        const entryId = await CapsResolve.entryId(this.#ctx, this.#scheme, pathname);
+        if (entryId === null)
+            return { status: 404 };
+        const r = await this.#ctx.db.append_to_channel.run({ chunk: content, entry_id: entryId, channel });
+        return { status: r.changes > 0 ? 200 : 404 };
+    }
+    async replace(pathname, channel, content) {
+        const { tokenize } = this.#ctx;
+        if (tokenize === undefined)
+            throw new Error("DbChannelCaps.replace: ctx.tokenize is required for token accounting");
+        const entryId = await CapsResolve.entryId(this.#ctx, this.#scheme, pathname);
+        if (entryId === null)
+            return { status: 404 };
+        const r = await this.#ctx.db.replace_channel_content.run({
+            content, tokens: tokenize(content), entry_id: entryId, channel,
+        });
+        return { status: r.changes > 0 ? 200 : 404 };
+    }
+    async setState(pathname, channel, state) {
+        const entryId = await CapsResolve.entryId(this.#ctx, this.#scheme, pathname);
+        if (entryId === null)
+            return { status: 404 };
+        const r = await this.#ctx.db.set_channel_state.run({ state, entry_id: entryId, channel });
+        return { status: r.changes > 0 ? 200 : 404 };
+    }
+}
+//# sourceMappingURL=DbChannelCaps.js.map

package/dist/core/caps/DbChannelCaps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DbChannelCaps.js","sourceRoot":"","sources":["../../../src/core/caps/DbChannelCaps.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,iFAAiF;AACjF,4EAA4E;AAC5E,sFAAsF;AACtF,4DAA4D;AAK5D,OAAO,WAAW,MAAM,kBAAkB,CAAC;AAE3C,MAAM,CAAC,OAAO,OAAO,aAAa;IACrB,IAAI,CAAsB;IAC1B,OAAO,CAAgB;IAEhC,YAAY,GAAwB,EAAE,MAAqB;QACvD,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,QAAgB,EAAE,OAAe,EAAE,OAAe;QAC3D,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC7E,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;QAC7C,MAAM,CAAC,GAAG,MAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,iBAAgC,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QACnH,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAgB,EAAE,OAAe,EAAE,OAAe;QAC5D,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;QAC/B,IAAI,QAAQ,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;QACpH,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC7E,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;QAC7C,MAAM,CAAC,GAAG,MAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,uBAAsC,CAAC,GAAG,CAAC;YACrE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO;SACjE,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,OAAe,EAAE,KAAmB;QACjE,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC7E,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;QAC7C,MAAM,CAAC,GAAG,MAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,iBAAgC,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1G,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IACjD,CAAC;CACJ"}

package/dist/core/caps/DbEntryCaps.d.ts

@@ -0,0 +1,19 @@
+import type { EntryCaps, EntryData } from "@plurnk/plurnk-schemes";
+import type { PlurnkSchemeContext } from "../scheme-types.ts";
+export default class DbEntryCaps implements EntryCaps {
+    #private;
+    constructor(ctx: PlurnkSchemeContext, scheme: string | null);
+    read(pathname: string): Promise<{
+        status: number;
+        entry: EntryData | null;
+    }>;
+    write(pathname: string, entry: EntryData): Promise<{
+        status: number;
+        created: boolean;
+        entryId: number | null;
+    }>;
+    delete(pathname: string): Promise<{
+        status: number;
+    }>;
+}
+//# sourceMappingURL=DbEntryCaps.d.ts.map

package/dist/core/caps/DbEntryCaps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DbEntryCaps.d.ts","sourceRoot":"","sources":["../../../src/core/caps/DbEntryCaps.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,MAAM,CAAC,OAAO,OAAO,WAAY,YAAW,SAAS;;IAIjD,YAAY,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAG1D;IAEK,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAA;KAAE,CAAC,CAEjF;IAEK,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAIrH;IAEK,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAE1D;CACJ"}

package/dist/core/caps/DbEntryCaps.js

@@ -0,0 +1,28 @@
+// db-backed EntryCaps (@plurnk/plurnk-schemes) — the keystone PR-2 seam (#180).
+// schemes exports the capability interfaces; plurnk-service injects this
+// db-backed impl so a third-party `@plurnk/plurnk-schemes-*` sibling reaches
+// entries through intent (read/write/delete) instead of the forbidden raw
+// `ctx.db` (schemes SPEC §channels). Binds a PlurnkSchemeContext + the scheme name and
+// delegates 1:1 to EntryCrud — the same path the in-tree schemes use during
+// transition, so the adapter is zero-behavior-change over a proven primitive.
+import EntryCrud from "../../schemes/_entry-crud.js";
+export default class DbEntryCaps {
+    #ctx;
+    #scheme;
+    constructor(ctx, scheme) {
+        this.#ctx = ctx;
+        this.#scheme = scheme;
+    }
+    async read(pathname) {
+        return EntryCrud.readEntry(pathname, this.#ctx, this.#scheme);
+    }
+    async write(pathname, entry) {
+        // schemes' EntryData carries `tags` as ReadonlyArray; EntryCrud writes a
+        // mutable array — copy at the boundary.
+        return EntryCrud.writeEntry(pathname, { channels: entry.channels, tags: [...entry.tags] }, this.#ctx, this.#scheme);
+    }
+    async delete(pathname) {
+        return EntryCrud.deleteEntry(pathname, this.#ctx, this.#scheme);
+    }
+}
+//# sourceMappingURL=DbEntryCaps.js.map

package/dist/core/caps/DbEntryCaps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DbEntryCaps.js","sourceRoot":"","sources":["../../../src/core/caps/DbEntryCaps.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,yEAAyE;AACzE,6EAA6E;AAC7E,0EAA0E;AAC1E,uFAAuF;AACvF,4EAA4E;AAC5E,8EAA8E;AAI9E,OAAO,SAAS,MAAM,8BAA8B,CAAC;AAErD,MAAM,CAAC,OAAO,OAAO,WAAW;IACnB,IAAI,CAAsB;IAC1B,OAAO,CAAgB;IAEhC,YAAY,GAAwB,EAAE,MAAqB;QACvD,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAgB;QACvB,OAAO,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,QAAgB,EAAE,KAAgB;QAC1C,yEAAyE;QACzE,wCAAwC;QACxC,OAAO,SAAS,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACxH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,QAAgB;QACzB,OAAO,SAAS,CAAC,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACpE,CAAC;CACJ"}

package/dist/core/caps/DbNotifyCaps.d.ts

@@ -0,0 +1,8 @@
+import type { NotifyCaps, ChannelState } from "@plurnk/plurnk-schemes";
+import type { PlurnkSchemeContext } from "../scheme-types.ts";
+export default class DbNotifyCaps implements NotifyCaps {
+    #private;
+    constructor(ctx: PlurnkSchemeContext, scheme: string | null);
+    streamEvent(pathname: string, channel: string, state: ChannelState, contentLength: number): void;
+}
+//# sourceMappingURL=DbNotifyCaps.d.ts.map

package/dist/core/caps/DbNotifyCaps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DbNotifyCaps.d.ts","sourceRoot":"","sources":["../../../src/core/caps/DbNotifyCaps.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAI9D,MAAM,CAAC,OAAO,OAAO,YAAa,YAAW,UAAU;;IAInD,YAAY,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAG1D;IAED,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAO/F;CAQJ"}

package/dist/core/caps/DbNotifyCaps.js

@@ -0,0 +1,35 @@
+// db-backed NotifyCaps (@plurnk/plurnk-schemes 0.4.3) — keystone PR-2 seam (#180).
+// streamEvent fires a stream/event notification for a channel transition.
+// (wakeRun was dropped in 0.4.3 — the rich run-wake lives on subscriptions.close,
+// the only place with the close context to populate it.)
+//
+// streamEvent is sync per the cap contract, but the StreamEventPayload's entryId
+// needs an async pathname→entryId lookup. The event is advisory (not a state
+// change), so we emit best-effort: no notifier wired (standalone/test) → no-op;
+// a vanished entry → no event.
+import CapsResolve from "./CapsResolve.js";
+export default class DbNotifyCaps {
+    #ctx;
+    #scheme;
+    constructor(ctx, scheme) {
+        this.#ctx = ctx;
+        this.#scheme = scheme;
+    }
+    streamEvent(pathname, channel, state, contentLength) {
+        const notify = this.#ctx.streamEventNotify;
+        if (notify === undefined)
+            return;
+        // Advisory best-effort emit (sync contract, async entryId lookup): a resolve/notify
+        // failure — e.g. the db closing under a late emit — is silently no-event per the cap
+        // contract, never an unhandled rejection on the fire-and-forget.
+        this.#emit(notify, pathname, channel, state, contentLength).catch(() => { });
+    }
+    async #emit(notify, pathname, channel, state, contentLength) {
+        const entryId = await CapsResolve.entryId(this.#ctx, this.#scheme, pathname);
+        if (entryId === null)
+            return;
+        const target = this.#scheme === null ? `file://${pathname}` : `${this.#scheme}://${pathname}`;
+        notify(this.#ctx.sessionId, { entryId, target, channel, state, contentLength });
+    }
+}
+//# sourceMappingURL=DbNotifyCaps.js.map

package/dist/core/caps/DbNotifyCaps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DbNotifyCaps.js","sourceRoot":"","sources":["../../../src/core/caps/DbNotifyCaps.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,0EAA0E;AAC1E,kFAAkF;AAClF,yDAAyD;AACzD,EAAE;AACF,iFAAiF;AACjF,6EAA6E;AAC7E,gFAAgF;AAChF,+BAA+B;AAK/B,OAAO,WAAW,MAAM,kBAAkB,CAAC;AAE3C,MAAM,CAAC,OAAO,OAAO,YAAY;IACpB,IAAI,CAAsB;IAC1B,OAAO,CAAgB;IAEhC,YAAY,GAAwB,EAAE,MAAqB;QACvD,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IAC1B,CAAC;IAED,WAAW,CAAC,QAAgB,EAAE,OAAe,EAAE,KAAmB,EAAE,aAAqB;QACrF,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC;QAC3C,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO;QACjC,oFAAoF;QACpF,qFAAqF;QACrF,iEAAiE;QACjE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAChF,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAyB,EAAE,QAAgB,EAAE,OAAe,EAAE,KAAmB,EAAE,aAAqB;QAChH,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC7E,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,MAAM,QAAQ,EAAE,CAAC;QAC9F,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;IACpF,CAAC;CACJ"}

package/dist/core/caps/DbSubscriptionCaps.d.ts

@@ -0,0 +1,10 @@
+import type { SubscriptionCaps, SubscriptionHandle } from "@plurnk/plurnk-schemes";
+import type { PlurnkSchemeContext } from "../scheme-types.ts";
+export default class DbSubscriptionCaps implements SubscriptionCaps {
+    #private;
+    constructor(ctx: PlurnkSchemeContext, scheme: string | null);
+    open(pathname: string, handle: SubscriptionHandle): Promise<AbortSignal>;
+    notifyChunk(channel: string, chunk: string, mimetype?: string): Promise<void>;
+    close(reason: "done" | "error", outcome?: string): Promise<void>;
+}
+//# sourceMappingURL=DbSubscriptionCaps.d.ts.map

package/dist/core/caps/DbSubscriptionCaps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DbSubscriptionCaps.d.ts","sourceRoot":"","sources":["../../../src/core/caps/DbSubscriptionCaps.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAgB,MAAM,wBAAwB,CAAC;AACjG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAK9D,MAAM,CAAC,OAAO,OAAO,kBAAmB,YAAW,gBAAgB;;IAQ/D,YAAY,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAG1D;IAEK,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,CAsB7E;IAEK,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKlF;IAEK,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBrE;CACJ"}

package/dist/core/caps/DbSubscriptionCaps.js

@@ -0,0 +1,86 @@
+// db-backed SubscriptionCaps (@plurnk/plurnk-schemes) — keystone PR-2 seam (#180).
+// The streaming lifecycle a sibling drives:
+//   open(pathname, handle) → registers the subscription and hands back a
+//     run+teardown-composed AbortSignal; a run abort also force-cancels the
+//     sibling's handle (mirrors the exec scheme's #activeAborts).
+//   notifyChunk(channel, chunk) → FUSED append-to-channel + stream/event.
+//   close(reason, outcome?) → composites every channel's terminal state, the
+//     registry close, and the rich run-wake (the only place with the close
+//     context to populate it — which is why NotifyCaps dropped wakeRun, #180).
+// Stateful: open() binds the entry + subscription that notifyChunk()/close()
+// operate on. Models src/schemes/Exec.ts over the same ChannelWrite primitives.
+import ChannelWrite from "../ChannelWrite.js";
+import CapsResolve from "./CapsResolve.js";
+export default class DbSubscriptionCaps {
+    #ctx;
+    #scheme;
+    #pathname = null;
+    #entryId = null;
+    #subscriptionId = null;
+    #unlink = () => { };
+    constructor(ctx, scheme) {
+        this.#ctx = ctx;
+        this.#scheme = scheme;
+    }
+    async open(pathname, handle) {
+        const entryId = await CapsResolve.entryId(this.#ctx, this.#scheme, pathname);
+        if (entryId === null)
+            throw new Error(`subscriptions.open: no entry at ${pathname}`);
+        const subscriptionId = await ChannelWrite.openSubscription(this.#ctx.db, {
+            runId: this.#ctx.runId, entryId, scheme: this.#scheme ?? "file", handle: pathname,
+        });
+        // Compose the run signal with a fresh controller; a run abort also
+        // force-cancels the sibling's handle.
+        const controller = new AbortController();
+        const parent = this.#ctx.signal;
+        if (parent !== undefined) {
+            if (parent.aborted) {
+                void handle.cancel();
+                controller.abort(parent.reason);
+            }
+            else {
+                const onAbort = () => { void handle.cancel(); controller.abort(parent.reason); };
+                parent.addEventListener("abort", onAbort, { once: true });
+                this.#unlink = () => parent.removeEventListener("abort", onAbort);
+            }
+        }
+        this.#pathname = pathname;
+        this.#entryId = entryId;
+        this.#subscriptionId = subscriptionId;
+        return controller.signal;
+    }
+    async notifyChunk(channel, chunk, mimetype) {
+        if (this.#entryId === null)
+            throw new Error("subscriptions.notifyChunk: no open subscription");
+        await ChannelWrite.appendToChannel(this.#ctx.db, {
+            entryId: this.#entryId, channel, chunk, notify: this.#ctx.streamEventNotify, mimetype,
+        });
+    }
+    async close(reason, outcome) {
+        const entryId = this.#entryId;
+        const subscriptionId = this.#subscriptionId;
+        if (entryId === null || subscriptionId === null)
+            throw new Error("subscriptions.close: no open subscription");
+        const state = reason === "error" ? "errored" : "closed";
+        const closeStatus = reason === "error" ? 500 : 200;
+        // Every channel of the entry → terminal state, then the registry row
+        // closes, then the run wakes with the scheme's summary.
+        const channels = await this.#ctx.db.crud_read_channels.all({ entry_id: entryId });
+        for (const { name } of channels) {
+            await ChannelWrite.setChannelState(this.#ctx.db, { entryId, channel: name, state, notify: this.#ctx.streamEventNotify });
+        }
+        await ChannelWrite.closeSubscription(this.#ctx.db, { subscriptionId, status: closeStatus });
+        this.#unlink();
+        const target = this.#scheme === null ? `file://${this.#pathname}` : `${this.#scheme}://${this.#pathname}`;
+        this.#ctx.wakeRunNotify?.({
+            sessionId: this.#ctx.sessionId, runId: this.#ctx.runId,
+            entryId, target, subscriptionId, closeStatus,
+            scheme: this.#scheme ?? "file", summary: outcome ?? "",
+        });
+        this.#pathname = null;
+        this.#entryId = null;
+        this.#subscriptionId = null;
+        this.#unlink = () => { };
+    }
+}
+//# sourceMappingURL=DbSubscriptionCaps.js.map

package/dist/core/caps/DbSubscriptionCaps.js.map

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

package/dist/core/caps/DbTagCaps.d.ts

@@ -0,0 +1,17 @@
+import type { TagCaps } from "@plurnk/plurnk-schemes";
+import type { PlurnkSchemeContext } from "../scheme-types.ts";
+export default class DbTagCaps implements TagCaps {
+    #private;
+    constructor(ctx: PlurnkSchemeContext, scheme: string | null);
+    add(pathname: string, tags: ReadonlyArray<string>): Promise<{
+        status: number;
+    }>;
+    remove(pathname: string, tags: ReadonlyArray<string>): Promise<{
+        status: number;
+    }>;
+    list(pathname: string): Promise<{
+        status: number;
+        tags: ReadonlyArray<string>;
+    }>;
+}
+//# sourceMappingURL=DbTagCaps.d.ts.map

package/dist/core/caps/DbTagCaps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DbTagCaps.d.ts","sourceRoot":"","sources":["../../../src/core/caps/DbTagCaps.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAI9D,MAAM,CAAC,OAAO,OAAO,SAAU,YAAW,OAAO;;IAI7C,YAAY,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAG1D;IAEK,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAKpF;IAEK,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAKvF;IAEK,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;KAAE,CAAC,CAKrF;CACJ"}

package/dist/core/caps/DbTagCaps.js

@@ -0,0 +1,37 @@
+// db-backed TagCaps (@plurnk/plurnk-schemes) — keystone PR-2 seam (#180).
+// add/remove/list folksonomic tags on an entry, addressed by pathname. add is
+// INSERT OR IGNORE (idempotent — re-adding a tag is a no-op); list returns them
+// tag-sorted; remove drops the named tags. Absent entry → 404.
+import CapsResolve from "./CapsResolve.js";
+export default class DbTagCaps {
+    #ctx;
+    #scheme;
+    constructor(ctx, scheme) {
+        this.#ctx = ctx;
+        this.#scheme = scheme;
+    }
+    async add(pathname, tags) {
+        const entryId = await CapsResolve.entryId(this.#ctx, this.#scheme, pathname);
+        if (entryId === null)
+            return { status: 404 };
+        for (const tag of tags)
+            await this.#ctx.db.crud_write_tag.run({ entry_id: entryId, tag });
+        return { status: 200 };
+    }
+    async remove(pathname, tags) {
+        const entryId = await CapsResolve.entryId(this.#ctx, this.#scheme, pathname);
+        if (entryId === null)
+            return { status: 404 };
+        for (const tag of tags)
+            await this.#ctx.db.crud_delete_tag.run({ entry_id: entryId, tag });
+        return { status: 200 };
+    }
+    async list(pathname) {
+        const entryId = await CapsResolve.entryId(this.#ctx, this.#scheme, pathname);
+        if (entryId === null)
+            return { status: 404, tags: [] };
+        const rows = await this.#ctx.db.crud_read_tags.all({ entry_id: entryId });
+        return { status: 200, tags: rows.map((r) => r.tag) };
+    }
+}
+//# sourceMappingURL=DbTagCaps.js.map

package/dist/core/caps/DbTagCaps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DbTagCaps.js","sourceRoot":"","sources":["../../../src/core/caps/DbTagCaps.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,8EAA8E;AAC9E,gFAAgF;AAChF,+DAA+D;AAK/D,OAAO,WAAW,MAAM,kBAAkB,CAAC;AAE3C,MAAM,CAAC,OAAO,OAAO,SAAS;IACjB,IAAI,CAAsB;IAC1B,OAAO,CAAgB;IAEhC,YAAY,GAAwB,EAAE,MAAqB;QACvD,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,QAAgB,EAAE,IAA2B;QACnD,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC7E,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;QAC7C,KAAK,MAAM,GAAG,IAAI,IAAI;YAAE,MAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,cAA6B,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;QAC1G,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,QAAgB,EAAE,IAA2B;QACtD,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC7E,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;QAC7C,KAAK,MAAM,GAAG,IAAI,IAAI;YAAE,MAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,eAA8B,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;QAC3G,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAgB;QACvB,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC7E,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,MAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,cAA6B,CAAC,GAAG,CAAkB,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3G,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IACzD,CAAC;CACJ"}

package/dist/core/caps/SchemeCtxImpl.d.ts

@@ -0,0 +1,18 @@
+import type { SchemeCtx, EntryCaps, ChannelCaps, TagCaps, NotifyCaps, SubscriptionCaps, CrossSchemeCaps, WriterTier } from "@plurnk/plurnk-schemes";
+import type { PlurnkSchemeContext } from "../scheme-types.ts";
+export default class SchemeCtxImpl implements SchemeCtx {
+    readonly sessionId: number;
+    readonly runId: number;
+    readonly loopId: number;
+    readonly turnId: number;
+    readonly writer: WriterTier;
+    readonly signal: AbortSignal | undefined;
+    readonly entries: EntryCaps;
+    readonly channels: ChannelCaps;
+    readonly tags: TagCaps;
+    readonly notify: NotifyCaps;
+    readonly subscriptions: SubscriptionCaps;
+    readonly crossScheme: CrossSchemeCaps;
+    constructor(ctx: PlurnkSchemeContext, scheme: string | null);
+}
+//# sourceMappingURL=SchemeCtxImpl.d.ts.map

package/dist/core/caps/SchemeCtxImpl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemeCtxImpl.d.ts","sourceRoot":"","sources":["../../../src/core/caps/SchemeCtxImpl.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACR,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,eAAe,EAAE,UAAU,EACxG,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAW9D,MAAM,CAAC,OAAO,OAAO,aAAc,YAAW,SAAS;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,gBAAgB,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAqB;IAE1D,YAAY,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAY1D;CACJ"}

package/dist/core/caps/SchemeCtxImpl.js

@@ -0,0 +1,42 @@
+// db-backed SchemeCtx (@plurnk/plurnk-schemes) — keystone PR-2 (#180). Assembles
+// the capability surface a third-party @plurnk/plurnk-schemes-* sibling receives:
+// identity fields lifted off the PlurnkSchemeContext, the five db-backed caps,
+// and the deferred crossScheme stub. A sibling reaches the substrate ONLY through
+// this — never the raw ctx.db (schemes SPEC §channels). `visibility` is absent: entry
+// visibility is gone post-teardown, so schemes dropped the cap (0.4.3).
+import DbEntryCaps from "./DbEntryCaps.js";
+import DbChannelCaps from "./DbChannelCaps.js";
+import DbTagCaps from "./DbTagCaps.js";
+import DbNotifyCaps from "./DbNotifyCaps.js";
+import DbSubscriptionCaps from "./DbSubscriptionCaps.js";
+const CROSS_SCHEME_STUB = {
+    _deferred: "see plurnk-service#180 — designed when first cross-scheme COPY/MOVE forces the FROM/TO shape",
+};
+export default class SchemeCtxImpl {
+    sessionId;
+    runId;
+    loopId;
+    turnId;
+    writer;
+    signal;
+    entries;
+    channels;
+    tags;
+    notify;
+    subscriptions;
+    crossScheme = CROSS_SCHEME_STUB;
+    constructor(ctx, scheme) {
+        this.sessionId = ctx.sessionId;
+        this.runId = ctx.runId;
+        this.loopId = ctx.loopId;
+        this.turnId = ctx.turnId;
+        this.writer = ctx.writer;
+        this.signal = ctx.signal;
+        this.entries = new DbEntryCaps(ctx, scheme);
+        this.channels = new DbChannelCaps(ctx, scheme);
+        this.tags = new DbTagCaps(ctx, scheme);
+        this.notify = new DbNotifyCaps(ctx, scheme);
+        this.subscriptions = new DbSubscriptionCaps(ctx, scheme);
+    }
+}
+//# sourceMappingURL=SchemeCtxImpl.js.map

package/dist/core/caps/SchemeCtxImpl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemeCtxImpl.js","sourceRoot":"","sources":["../../../src/core/caps/SchemeCtxImpl.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,kFAAkF;AAClF,+EAA+E;AAC/E,kFAAkF;AAClF,sFAAsF;AACtF,wEAAwE;AAMxE,OAAO,WAAW,MAAM,kBAAkB,CAAC;AAC3C,OAAO,aAAa,MAAM,oBAAoB,CAAC;AAC/C,OAAO,SAAS,MAAM,gBAAgB,CAAC;AACvC,OAAO,YAAY,MAAM,mBAAmB,CAAC;AAC7C,OAAO,kBAAkB,MAAM,yBAAyB,CAAC;AAEzD,MAAM,iBAAiB,GAAoB;IACvC,SAAS,EAAE,8FAA8F;CAC5G,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,aAAa;IACrB,SAAS,CAAS;IAClB,KAAK,CAAS;IACd,MAAM,CAAS;IACf,MAAM,CAAS;IACf,MAAM,CAAa;IACnB,MAAM,CAA0B;IAChC,OAAO,CAAY;IACnB,QAAQ,CAAc;IACtB,IAAI,CAAU;IACd,MAAM,CAAa;IACnB,aAAa,CAAmB;IAChC,WAAW,GAAoB,iBAAiB,CAAC;IAE1D,YAAY,GAAwB,EAAE,MAAqB;QACvD,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,QAAQ,GAAG,IAAI,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,GAAG,IAAI,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,aAAa,GAAG,IAAI,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC7D,CAAC;CACJ"}

package/dist/core/env-defaults.d.ts

@@ -0,0 +1,19 @@
+export type EnvDefaultsFile = {
+    owner: string;
+    text: string;
+    parsed: Record<string, string>;
+};
+export default class EnvDefaults {
+    #private;
+    static collect(serviceRoot: string, nodeModules: string): Promise<EnvDefaultsFile[]>;
+    static merge(files: readonly EnvDefaultsFile[]): Map<string, {
+        value: string;
+        owner: string;
+    }>;
+    static apply(merged: ReadonlyMap<string, {
+        value: string;
+        owner: string;
+    }>): void;
+    static renderCatalog(files: readonly EnvDefaultsFile[]): string;
+}
+//# sourceMappingURL=env-defaults.d.ts.map

package/dist/core/env-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-defaults.d.ts","sourceRoot":"","sources":["../../src/core/env-defaults.ts"],"names":[],"mappings":"AAqBA,MAAM,MAAM,eAAe,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,WAAW;;IAqC5B,OAAa,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAKzF;IAID,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAU7F;IAGD,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI,CAEhF;IAID,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM,CAQ9D;CACJ"}