@plurnk/plurnk-service 0.12.0 → 0.13.0

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): 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;;gBAQnD,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAKrD,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC;IAwBxE,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO1D,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAyBzE"}

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) {
+        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,
+        });
+    }
+    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/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;gBAE9C,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAa9D"}

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 §5). `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,+EAA+E;AAC/E,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/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@plurnk/plurnk-service",
-    "version": "0.12.0",
+    "version": "0.13.0",
     "description": "Plurnk agent runtime — the server / engine / core. Implements the @plurnk/plurnk-grammar contract.",
     "type": "module",
     "license": "MIT",