@plurnk/plurnk-service 1.0.0

package/dist/core/ChannelWrite.d.ts

@@ -0,0 +1,100 @@
+import type { Db } from "./Db.ts";
+import type { LoopFlags } from "./types.ts";
+export type ChannelState = "static" | "active" | "closed" | "errored";
+export interface StreamCoordinate {
+    loop_seq: number;
+    turn_seq: number;
+    sequence: number;
+}
+export interface StreamEventPayload {
+    entryId: number;
+    target: string;
+    channel: string;
+    state: ChannelState;
+    contentLength: number;
+    loop_seq?: number;
+    turn_seq?: number;
+    sequence?: number;
+    mimetype?: string;
+}
+export type StreamEventNotify = (sessionId: number, event: StreamEventPayload) => void;
+export interface WakeRunPayload {
+    sessionId: number;
+    runId: number;
+    entryId: number;
+    target: string;
+    subscriptionId: number;
+    closeStatus: number;
+    scheme: string;
+    summary: string;
+    loop_seq?: number;
+    turn_seq?: number;
+    sequence?: number;
+}
+export type WakeRunNotify = (payload: WakeRunPayload) => void;
+export type InjectRunNotify = (args: {
+    sessionId: number;
+    runId: number;
+    prompt: string;
+    flags?: LoopFlags;
+}) => Promise<{
+    action: "injected_next_turn" | "enqueued_new_loop";
+    loopId: number;
+}>;
+export type CancelRunNotify = (runId: number) => boolean;
+export interface TelemetryEventPayload {
+    loopId: number;
+    event: object;
+}
+export type TelemetryEventNotify = (sessionId: number, payload: TelemetryEventPayload) => void;
+export default class ChannelWrite {
+    #private;
+    static appendToChannel(db: Db, { entryId, channel, chunk, notify, coordinate, mimetype }: {
+        entryId: number;
+        channel: string;
+        chunk: string;
+        notify?: StreamEventNotify;
+        coordinate?: StreamCoordinate;
+        mimetype?: string;
+    }): Promise<void>;
+    static setChannelState(db: Db, { entryId, channel, state, notify, coordinate }: {
+        entryId: number;
+        channel: string;
+        state: ChannelState;
+        notify?: StreamEventNotify;
+        coordinate?: StreamCoordinate;
+    }): Promise<void>;
+    static openSubscription(db: Db, { runId, entryId, scheme, handle, pollSeconds, turnScoped }: {
+        runId: number;
+        entryId: number;
+        scheme: string;
+        handle: string;
+        pollSeconds?: number | null;
+        turnScoped?: boolean;
+    }): Promise<number>;
+    static closeSubscription(db: Db, { subscriptionId, status }: {
+        subscriptionId: number;
+        status: number;
+    }): Promise<void>;
+    static execTerminalStatus(db: Db, { sessionId, pathname }: {
+        sessionId: number;
+        pathname: string;
+    }): Promise<number | null>;
+    static findActiveSubscription(db: Db, { runId, entryId }: {
+        runId: number;
+        entryId: number;
+    }): Promise<{
+        id: number;
+        scheme: string;
+        handle: string;
+    } | null>;
+    static findOpenSubscriptionsForRun(db: Db, runId: number): Promise<Array<{
+        id: number;
+        scheme: string;
+    }>>;
+    static findOpenTurnScopedSubscriptionsForRun(db: Db, runId: number): Promise<Array<{
+        id: number;
+        scheme: string;
+    }>>;
+}
+//# sourceMappingURL=ChannelWrite.d.ts.map

package/dist/core/ChannelWrite.d.ts.map

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

package/dist/core/ChannelWrite.js

@@ -0,0 +1,112 @@
+// Channel-write helpers for streaming schemes. SPEC §channel-state (channel state),
+// §subscriptions (subscription registry), §notifications (stream/event notification).
+//
+// Schemes import these and call them as their connection lifecycle progresses; the
+// engine has no stream/transaction abstraction (§stream-no-engine-transaction-abstraction).
+// Helpers update entry_channels (content / state) and subscriptions, and emit
+// stream/event notifications scoped to the entry's session via an optional
+// callback the daemon wires in.
+import { renderAddress } from "./plurnk-uri.js";
+export default class ChannelWrite {
+    static #channelMeta(db) { return db.channel_meta; }
+    static #appendStmt(db) { return db.append_to_channel; }
+    static #stateStmt(db) { return db.set_channel_state; }
+    static #mimetypeStmt(db) { return db.set_channel_mimetype; }
+    static #openSubStmt(db) { return db.open_subscription; }
+    static #closeSubStmt(db) { return db.close_subscription; }
+    static #findActiveStmt(db) { return db.find_active_subscription; }
+    static #openSubsForRunStmt(db) { return db.find_open_subscriptions_for_run; }
+    static #execTerminalStmt(db) { return db.find_exec_close_status; }
+    // The entry's target URI for stream notifications (#179). A NULL scheme is
+    // a filesystem entry (the file scheme stores scheme=NULL), so it decodes to
+    // file:///.
+    static #targetUri(scheme, pathname) {
+        return renderAddress(scheme === null ? "file" : scheme, pathname);
+    }
+    // A stream chunk accumulates into the channel's content (§chunk-accumulation-chunks-accumulate)
+    // and fires a stream/event (§live-updates-stream-event-fires-on-chunk); the log carries the
+    // stream's lifecycle, never per-chunk rows (§no-chunk-rows-log-captures-lifecycle-only).
+    static async appendToChannel(db, { entryId, channel, chunk, notify, coordinate, mimetype }) {
+        const result = await ChannelWrite.#appendStmt(db).run({ chunk, entry_id: entryId, channel });
+        if (result.changes === 0)
+            return;
+        // #226 — a streaming scheme labels the channel with the body's per-call
+        // type (http's Content-Type varies per fetch). Conditional UPDATE: only
+        // writes when it changed, so labelling every chunk is a steady-state no-op.
+        if (mimetype !== undefined)
+            await ChannelWrite.#mimetypeStmt(db).run({ mimetype, entry_id: entryId, channel });
+        if (notify === undefined)
+            return;
+        const meta = await ChannelWrite.#channelMeta(db).get({ entry_id: entryId, channel });
+        if (meta === undefined)
+            return;
+        notify(meta.session_id, { entryId, target: ChannelWrite.#targetUri(meta.scheme, meta.pathname), channel, state: meta.state, contentLength: meta.contentLength, mimetype: meta.mimetype, ...coordinate });
+    }
+    // Schemes drive channel state transitions as their connection lifecycle progresses.
+    // §channel-state-schemes-own-state-transitions
+    static async setChannelState(db, { entryId, channel, state, notify, coordinate }) {
+        const result = await ChannelWrite.#stateStmt(db).run({ state, entry_id: entryId, channel });
+        if (result.changes === 0)
+            return;
+        // §semantic-fts-at-write — a stream's accumulated BODY content becomes keyword-searchable
+        // the moment the channel settles (closed/errored), not a pump-pass later. Body only: the
+        // FTS row is per-ENTRY (rowid = entry id) and the fusion's keyword half is the body's.
+        if ((state === "closed" || state === "errored") && channel === "body") {
+            const row = await db.channel_meta.get({ entry_id: entryId, channel });
+            if (row !== undefined) {
+                const body = await db.read_channel_content.get({ entry_id: entryId, channel });
+                if (body !== undefined) {
+                    await db.fts_delete.run({ entry_id: entryId });
+                    // §membership-binary-sniff — the same NUL guard as member ingest: a streamed
+                    // binary (an http READ of an image) must not enter the keyword index.
+                    const head = body.content.slice(0, 8192);
+                    if (body.content.length > 0 && !head.includes("\u0000"))
+                        await db.fts_insert.run({ entry_id: entryId, content: body.content });
+                }
+            }
+        }
+        if (notify === undefined)
+            return;
+        const meta = await ChannelWrite.#channelMeta(db).get({ entry_id: entryId, channel });
+        if (meta === undefined)
+            return;
+        notify(meta.session_id, { entryId, target: ChannelWrite.#targetUri(meta.scheme, meta.pathname), channel, state: meta.state, contentLength: meta.contentLength, mimetype: meta.mimetype, ...coordinate });
+    }
+    // The subscription registry — open/find/close — is how a stream's cancellation
+    // (SEND[499] / KILL) routes to the right live subscription. §subscriptions-subscription-registry-routes-cancellation
+    static async openSubscription(db, { runId, entryId, scheme, handle, pollSeconds, turnScoped }) {
+        const row = await ChannelWrite.#openSubStmt(db).get({ run_id: runId, entry_id: entryId, scheme, handle, poll_seconds: pollSeconds ?? null, turn_scoped: turnScoped ? 1 : 0 });
+        if (row === undefined)
+            throw new Error("openSubscription: INSERT ... RETURNING produced no row");
+        return row.id;
+    }
+    static async closeSubscription(db, { subscriptionId, status }) {
+        await ChannelWrite.#closeSubStmt(db).run({ status, subscription_id: subscriptionId });
+    }
+    // Terminal close_status of a finished exec stream, by coordinate pathname —
+    // the KILL-on-a-non-running-exec lookup (Exec.kill). null = no closed
+    // subscription for that coordinate (unknown exec).
+    static async execTerminalStatus(db, { sessionId, pathname }) {
+        const row = await ChannelWrite.#execTerminalStmt(db).get({ session_id: sessionId, pathname });
+        return row?.close_status ?? null;
+    }
+    static async findActiveSubscription(db, { runId, entryId }) {
+        const row = await ChannelWrite.#findActiveStmt(db).get({ run_id: runId, entry_id: entryId });
+        return row ?? null;
+    }
+    // The run's still-open subscriptions — the registry-routed reap
+    // (§run-lifecycle-total-reap). A cancel iterates these and aborts each via the
+    // owning scheme, so a backgrounded exec is reaped regardless of in-process
+    // AbortSignal-listener timing (R1): the registry is the source of truth, the
+    // signal an optimization.
+    static async findOpenSubscriptionsForRun(db, runId) {
+        return ChannelWrite.#openSubsForRunStmt(db).all({ run_id: runId });
+    }
+    // The run's open turn-scoped (EXEC `<0>`) subscriptions — reaped at the run's next pre-turn so a
+    // `<0>` stream never survives into the subsequent turn (§exec-poll). Any open turn-scoped sub at
+    // pre-turn is necessarily from a prior turn (the reap runs before this turn's own spawns).
+    static async findOpenTurnScopedSubscriptionsForRun(db, runId) {
+        return db.find_open_turn_scoped_subscriptions_for_run.all({ run_id: runId });
+    }
+}
+//# sourceMappingURL=ChannelWrite.js.map

package/dist/core/ChannelWrite.js.map

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

package/dist/core/ChannelWrite.sql

@@ -0,0 +1,84 @@
+-- Channel-write SQL for streaming schemes. SPEC §channel-state + §subscriptions + §notifications.
+
+-- PREP: channel_meta
+SELECT e.session_id, e.scheme, e.pathname, ec.state, ec.mimetype, length(ec.content) AS contentLength
+FROM entry_channels ec
+JOIN entries e ON e.id = ec.entry_id
+WHERE ec.entry_id = $entry_id AND ec.name = $channel;
+
+-- PREP: append_to_channel
+UPDATE entry_channels
+SET content = content || $chunk
+WHERE entry_id = $entry_id AND name = $channel;
+
+-- PREP: set_channel_state
+UPDATE entry_channels
+SET state = $state
+WHERE entry_id = $entry_id AND name = $channel;
+
+-- PREP: set_channel_mimetype
+-- A streaming scheme labels the channel with the body's per-call type (#226 —
+-- http's Content-Type varies per fetch). Conditional: only writes when the type
+-- actually changed, so labelling every chunk is a steady-state no-op.
+UPDATE entry_channels
+SET mimetype = $mimetype
+WHERE entry_id = $entry_id AND name = $channel AND mimetype != $mimetype;
+
+-- PREP: replace_channel_content
+-- Full content swap for one channel (ChannelCaps.replace). Re-tokenizes at
+-- write (unlike append_to_channel, which defers token count to render).
+UPDATE entry_channels
+SET content = $content, tokens = $tokens
+WHERE entry_id = $entry_id AND name = $channel;
+
+-- PREP: open_subscription
+-- turn_scoped COALESCEs to 0 so a caller binding the raw prep without it (an unbounded stream) is
+-- a normal, non-turn-scoped subscription — the column is NOT NULL, so a missing bind would error.
+INSERT INTO subscriptions (run_id, entry_id, scheme, handle, poll_seconds, turn_scoped)
+VALUES ($run_id, $entry_id, $scheme, $handle, $poll_seconds, COALESCE($turn_scoped, 0))
+RETURNING id;
+
+-- PREP: close_subscription
+UPDATE subscriptions
+SET closed_at = strftime('%Y-%m-%dT%H:%M:%fZ', 'now')
+  , close_status = $status
+WHERE id = $subscription_id AND closed_at IS NULL;
+
+-- PREP: find_active_subscription
+SELECT id, scheme, handle
+FROM subscriptions
+WHERE run_id = $run_id AND entry_id = $entry_id AND closed_at IS NULL;
+
+-- PREP: find_open_subscriptions_for_run
+-- The run's still-open subscriptions — the registry-routed reap (§run-lifecycle-total-reap):
+-- loop.cancel / KILL / shutdown iterate these and abort each via the owning scheme, so a
+-- backgrounded exec is reaped independent of any in-process AbortSignal-listener timing.
+SELECT id, scheme
+FROM subscriptions
+WHERE run_id = $run_id AND closed_at IS NULL;
+
+-- PREP: find_open_turn_scoped_subscriptions_for_run
+-- The run's open turn-scoped (EXEC `<0>`) subscriptions — reaped at the run's next pre-turn so a
+-- `<0>` stream never survives into the subsequent turn; its terminal output surfaces born-OPEN
+-- through the same conclusion-delta path as any close (§exec-poll, §exec-stream).
+SELECT id, scheme
+FROM subscriptions
+WHERE run_id = $run_id AND closed_at IS NULL AND turn_scoped = 1;
+
+-- PREP: find_exec_close_status
+-- Terminal outcome of a finished exec stream, addressed by its coordinate
+-- pathname — the KILL-on-a-non-running-exec lookup. 499 (aborted) = killed
+-- earlier; any other terminal status = exited naturally; no row = unknown exec.
+SELECT s.close_status
+FROM entries e
+JOIN subscriptions s ON s.entry_id = e.id
+WHERE e.scope = 'session' AND e.session_id = $session_id
+  AND e.scheme = 'exec' AND e.pathname = $pathname
+  AND s.closed_at IS NOT NULL
+ORDER BY s.closed_at DESC
+LIMIT 1;
+
+-- PREP: read_channel_content
+-- §semantic-fts-at-write — a settled stream's accumulated body, read once for the
+-- write-time FTS index.
+SELECT content FROM entry_channels WHERE entry_id = $entry_id AND name = $channel;

package/dist/core/Db.d.ts

@@ -0,0 +1,14 @@
+export interface PrepMethod {
+    run(params?: object): Promise<{
+        changes: number;
+        lastInsertRowid: number;
+    }>;
+    get<T = Record<string, unknown>>(params?: object): Promise<T | undefined>;
+    all<T = Record<string, unknown>>(params?: object): Promise<T[]>;
+}
+export type ExecMethod = (params?: object) => Promise<unknown>;
+export type Db = {
+    close(): Promise<void>;
+    ready(): Promise<unknown>;
+} & Record<string, PrepMethod | ExecMethod>;
+//# sourceMappingURL=Db.d.ts.map

package/dist/core/Db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Db.d.ts","sourceRoot":"","sources":["../../src/core/Db.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,UAAU;IACvB,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC1E,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;CACnE;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAE/D,MAAM,MAAM,EAAE,GAAG;IACb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7B,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC,CAAC"}

package/dist/core/Db.js

@@ -0,0 +1,7 @@
+// Permissive structural type for SqlRite-managed database handles. SqlRite
+// generates statement-named accessors at runtime (`db.<prep_name>.run/.get/.all`
+// per `-- PREP:` blocks in .sql files). `npm run build:types` from
+// @possumtech/sqlrite produces precise codegen; this alias is the manual
+// fallback typing until that's wired into the build.
+export {};
+//# sourceMappingURL=Db.js.map

package/dist/core/Db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Db.js","sourceRoot":"","sources":["../../src/core/Db.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,iFAAiF;AACjF,mEAAmE;AACnE,yEAAyE;AACzE,qDAAqD"}

package/dist/core/Dispatcher.d.ts

@@ -0,0 +1,67 @@
+import type { PlurnkStatement } from "@plurnk/plurnk-grammar";
+import type { Mimetypes } from "@plurnk/plurnk-mimetypes";
+import type { Db } from "./Db.ts";
+import type SchemeRegistry from "./SchemeRegistry.ts";
+import type ExecutorRegistry from "./ExecutorRegistry.ts";
+import type TelemetryChannel from "./TelemetryChannel.ts";
+import type ProposalLifecycle from "./ProposalLifecycle.ts";
+import type { WriterTier } from "./scheme-types.ts";
+import type { StreamEventNotify, WakeRunNotify, InjectRunNotify, CancelRunNotify } from "./ChannelWrite.ts";
+export type DispatchContext = {
+    statement: PlurnkStatement;
+    sessionId: number;
+    runId: number;
+    loopId: number;
+    turnId: number;
+    sequence: number;
+    origin: WriterTier;
+    onDispatch?: (logEntryId: number) => void;
+    gauge?: {
+        tokenizerId: string;
+        exact: boolean;
+        count: (text: string) => Promise<number>;
+    };
+    turnParseErrors?: number;
+};
+export type DispatchResult = {
+    status: number;
+    attrs?: object;
+    [key: string]: unknown;
+};
+export default class Dispatcher {
+    #private;
+    constructor({ db, schemes, mimetypes, tokenize, telemetry, proposals, executors, loopSignal, streamEventNotify, wakeRunNotify, injectRun, cancelRun, parkDeadlines, joinTargets }: {
+        db: Db;
+        schemes: SchemeRegistry;
+        mimetypes: Mimetypes;
+        tokenize: (text: string) => number;
+        telemetry: TelemetryChannel;
+        proposals: ProposalLifecycle;
+        executors: () => ExecutorRegistry | undefined;
+        loopSignal: (loopId: number) => AbortSignal | undefined;
+        streamEventNotify?: StreamEventNotify;
+        wakeRunNotify?: WakeRunNotify;
+        injectRun?: InjectRunNotify;
+        cancelRun?: CancelRunNotify;
+        parkDeadlines?: Map<number, number>;
+        joinTargets?: Set<number>;
+    });
+    dispatch(context: DispatchContext): Promise<DispatchResult>;
+    look(context: {
+        statement: PlurnkStatement;
+        sessionId: number;
+        runId: number;
+        loopId: number;
+        origin?: WriterTier;
+    }): Promise<DispatchResult>;
+    writeModelEntry({ verbatim, runId, loopId, turnId, sequence, folded, origin }: {
+        verbatim: string;
+        runId: number;
+        loopId: number;
+        turnId: number;
+        sequence: number;
+        folded: boolean;
+        origin?: WriterTier;
+    }): Promise<number>;
+}
+//# sourceMappingURL=Dispatcher.d.ts.map

package/dist/core/Dispatcher.d.ts.map

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