@plurnk/plurnk-service 0.1.0

package/dist/server/dsl.d.ts

@@ -0,0 +1,47 @@
+import type { LineMarker, PlurnkStatement } from "@plurnk/plurnk-grammar";
+export declare const parseSingleStatement: (text: string) => PlurnkStatement;
+export declare const parseAllStatements: (text: string) => PlurnkStatement[];
+interface OpWithMatcher {
+    path: string;
+    matcher?: string;
+    tags?: string[];
+    lineRange?: LineMarker;
+}
+interface OpEditParams {
+    path: string;
+    content?: string;
+    tags?: string[];
+    lineRange?: LineMarker;
+}
+interface OpCopyMoveParams {
+    source: string;
+    destination?: string;
+    tags?: string[];
+    lineRange?: LineMarker;
+}
+interface OpSendParams {
+    status: number;
+    recipient?: string;
+    body?: string;
+}
+interface OpExecParams {
+    cwd?: string;
+    runtime?: string;
+    command?: string;
+}
+export declare const buildEdit: (p: OpEditParams) => PlurnkStatement;
+export declare const buildRead: (p: OpWithMatcher) => PlurnkStatement;
+export declare const buildFind: (p: {
+    scope: string;
+    matcher?: string;
+    tags?: string[];
+    lineRange?: LineMarker;
+}) => PlurnkStatement;
+export declare const buildShow: (p: OpWithMatcher) => PlurnkStatement;
+export declare const buildHide: (p: OpWithMatcher) => PlurnkStatement;
+export declare const buildCopy: (p: OpCopyMoveParams) => PlurnkStatement;
+export declare const buildMove: (p: OpCopyMoveParams) => PlurnkStatement;
+export declare const buildSend: (p: OpSendParams) => PlurnkStatement;
+export declare const buildExec: (p: OpExecParams) => PlurnkStatement;
+export {};
+//# sourceMappingURL=dsl.d.ts.map

package/dist/server/dsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsl.d.ts","sourceRoot":"","sources":["../../src/server/dsl.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAoC1E,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,KAAG,eAMnD,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,eAAe,EAKhE,CAAC;AAIF,UAAU,aAAa;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,UAAU,CAAC;CAC1B;AAED,UAAU,YAAY;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,UAAU,CAAC;CAC1B;AAED,UAAU,gBAAgB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,UAAU,CAAC;CAC1B;AAED,UAAU,YAAY;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,YAAY;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,SAAS,GAAI,GAAG,YAAY,KAAG,eAMzC,CAAC;AAEJ,eAAO,MAAM,SAAS,GAAI,GAAG,aAAa,KAAG,eAM1C,CAAC;AAEJ,eAAO,MAAM,SAAS,GAAI,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,UAAU,CAAA;CAAE,KAAG,eAMzG,CAAC;AAEJ,eAAO,MAAM,SAAS,GAAI,GAAG,aAAa,KAAG,eAM1C,CAAC;AAEJ,eAAO,MAAM,SAAS,GAAI,GAAG,aAAa,KAAG,eAM1C,CAAC;AAEJ,eAAO,MAAM,SAAS,GAAI,GAAG,gBAAgB,KAAG,eAS/C,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,GAAG,gBAAgB,KAAG,eAM7C,CAAC;AAEJ,eAAO,MAAM,SAAS,GAAI,GAAG,YAAY,KAAG,eAMzC,CAAC;AAEJ,eAAO,MAAM,SAAS,GAAI,GAAG,YAAY,KAAG,eAMzC,CAAC"}

package/dist/server/dsl.js

@@ -0,0 +1,117 @@
+// DSL helpers — clean-shape params → HEREDOC → PlurnkStatement.
+//
+// Per the "Speak in DSL, not plumbing" Standing Rule: every op.* RPC method
+// constructs a HEREDOC string from clean-shape params and parses it via the
+// canonical grammar. This guarantees the resulting PlurnkStatement is
+// IDENTICAL in shape to what the model would emit, including all
+// scheme-specific path parsing rules (grammar 0.3.0+).
+//
+// The path-parser helper would let us bypass HEREDOC construction; tracked
+// in plurnk-grammar issue #7.
+import { PlurnkParser } from "@plurnk/plurnk-grammar";
+// Random suffix per call. Collision space is 2^32 against the user's body
+// content; vanishingly unlikely for any reasonable input.
+const randomSuffix = () => Math.floor(Math.random() * 0xFFFFFFFF).toString(16).padStart(8, "0");
+const formatTags = (tags) => {
+    if (tags === undefined || tags.length === 0)
+        return "";
+    return `[${tags.join(",")}]`;
+};
+const formatLineMarker = (lm) => {
+    if (lm === undefined || lm === null)
+        return "";
+    if (lm.last === null || lm.last === lm.first)
+        return `<${lm.first}>`;
+    return `<${lm.first}-${lm.last}>`;
+};
+const formatPath = (path) => {
+    if (path === undefined)
+        return "";
+    return `(${path})`;
+};
+// Build a HEREDOC statement string. `signal` is the raw signal payload —
+// CSV tags `[a,b,c]` for most ops, a single number for SEND (`[200]`),
+// a single runtime tag for EXEC (`[node]`).
+const buildHeredoc = ({ op, suffix, signal, path, lineMarker, body, }) => `<<${op}${suffix}${signal}${path}${lineMarker}:${body}:${op}${suffix}`;
+export const parseSingleStatement = (text) => {
+    const result = PlurnkParser.parse(text);
+    for (const item of result.items) {
+        if (item.kind === "statement")
+            return item.statement;
+    }
+    throw new Error(`expected a parsed statement, got none from: ${text}`);
+};
+export const parseAllStatements = (text) => {
+    const result = PlurnkParser.parse(text);
+    return result.items
+        .filter((i) => i.kind === "statement")
+        .map((i) => i.statement);
+};
+export const buildEdit = (p) => parseSingleStatement(buildHeredoc({
+    op: "EDIT", suffix: randomSuffix(),
+    signal: formatTags(p.tags),
+    path: formatPath(p.path),
+    lineMarker: formatLineMarker(p.lineRange),
+    body: p.content ?? "",
+}));
+export const buildRead = (p) => parseSingleStatement(buildHeredoc({
+    op: "READ", suffix: randomSuffix(),
+    signal: formatTags(p.tags),
+    path: formatPath(p.path),
+    lineMarker: formatLineMarker(p.lineRange),
+    body: p.matcher ?? "",
+}));
+export const buildFind = (p) => parseSingleStatement(buildHeredoc({
+    op: "FIND", suffix: randomSuffix(),
+    signal: formatTags(p.tags),
+    path: formatPath(p.scope),
+    lineMarker: formatLineMarker(p.lineRange),
+    body: p.matcher ?? "",
+}));
+export const buildShow = (p) => parseSingleStatement(buildHeredoc({
+    op: "SHOW", suffix: randomSuffix(),
+    signal: formatTags(p.tags),
+    path: formatPath(p.path),
+    lineMarker: formatLineMarker(p.lineRange),
+    body: p.matcher ?? "",
+}));
+export const buildHide = (p) => parseSingleStatement(buildHeredoc({
+    op: "HIDE", suffix: randomSuffix(),
+    signal: formatTags(p.tags),
+    path: formatPath(p.path),
+    lineMarker: formatLineMarker(p.lineRange),
+    body: p.matcher ?? "",
+}));
+export const buildCopy = (p) => {
+    if (p.destination === undefined)
+        throw new Error("op.copy requires destination");
+    return parseSingleStatement(buildHeredoc({
+        op: "COPY", suffix: randomSuffix(),
+        signal: formatTags(p.tags),
+        path: formatPath(p.source),
+        lineMarker: formatLineMarker(p.lineRange),
+        body: p.destination,
+    }));
+};
+export const buildMove = (p) => parseSingleStatement(buildHeredoc({
+    op: "MOVE", suffix: randomSuffix(),
+    signal: formatTags(p.tags),
+    path: formatPath(p.source),
+    lineMarker: formatLineMarker(p.lineRange),
+    body: p.destination ?? "",
+}));
+export const buildSend = (p) => parseSingleStatement(buildHeredoc({
+    op: "SEND", suffix: randomSuffix(),
+    signal: `[${p.status}]`,
+    path: p.recipient !== undefined ? formatPath(p.recipient) : "",
+    lineMarker: "",
+    body: p.body ?? "",
+}));
+export const buildExec = (p) => parseSingleStatement(buildHeredoc({
+    op: "EXEC", suffix: randomSuffix(),
+    signal: p.runtime !== undefined ? `[${p.runtime}]` : "",
+    path: p.cwd !== undefined ? formatPath(p.cwd) : "",
+    lineMarker: "",
+    body: p.command ?? "",
+}));
+//# sourceMappingURL=dsl.js.map

package/dist/server/dsl.js.map

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

package/dist/server/envelope.d.ts

@@ -0,0 +1,44 @@
+import type { Db } from "../core/Db.ts";
+export interface SessionRow {
+    id: number;
+    name: string;
+    project_root: string | null;
+    persona: string | null;
+    created_at: string;
+    cost_pico: number;
+}
+export interface RunRow {
+    id: number;
+    name: string;
+    created_at: string;
+    cost_pico: number;
+}
+export interface ClientEnvelope {
+    sessionId: number;
+    sessionName: string;
+    projectRoot: string | null;
+    sessionPersona: string | null;
+    runId: number;
+    runName: string;
+    runPersona: string | null;
+    clientLoopId: number;
+}
+export declare const generateSessionName: () => string;
+export declare const generateRunName: () => string;
+export declare const createClientEnvelope: (db: Db, opts?: {
+    name?: string;
+    prefix?: string;
+    projectRoot?: string | null;
+    persona?: string | null;
+}) => Promise<ClientEnvelope>;
+export declare const attachToSession: (db: Db, sessionId: number, opts?: {
+    runId?: number;
+    runName?: string;
+    persona?: string | null;
+}) => Promise<ClientEnvelope>;
+export declare const listRunsForSession: (db: Db, sessionId: number) => Promise<RunRow[]>;
+export declare const closeClientLoop: (db: Db, loopId: number, status: 200 | 499) => Promise<void>;
+export declare const listSessions: (db: Db) => Promise<SessionRow[]>;
+export declare const updateSessionProjectRoot: (db: Db, sessionId: number, projectRoot: string | null) => Promise<string | null>;
+export declare const updateSessionPersona: (db: Db, sessionId: number, persona: string | null) => Promise<string | null>;
+//# sourceMappingURL=envelope.d.ts.map

package/dist/server/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../src/server/envelope.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,EAAE,EAAc,MAAM,eAAe,CAAC;AAEpD,MAAM,WAAW,UAAU;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,MAAM;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACxB;AAWD,eAAO,MAAM,mBAAmB,QAAO,MAA2B,CAAC;AACnE,eAAO,MAAM,eAAe,QAAO,MAAuB,CAAC;AAE3D,eAAO,MAAM,oBAAoB,GAAU,IAAI,EAAE,EAAE,OAAM;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAO,KAAG,OAAO,CAAC,cAAc,CAiB9K,CAAC;AAgCF,eAAO,MAAM,eAAe,GAAU,IAAI,EAAE,EAAE,WAAW,MAAM,EAAE,OAAM;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAO,KAAG,OAAO,CAAC,cAAc,CAYjK,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAU,IAAI,EAAE,EAAE,WAAW,MAAM,KAAG,OAAO,CAAC,MAAM,EAAE,CAEpF,CAAC;AAEF,eAAO,MAAM,eAAe,GAAU,IAAI,EAAE,EAAE,QAAQ,MAAM,EAAE,QAAQ,GAAG,GAAG,GAAG,KAAG,OAAO,CAAC,IAAI,CAE7F,CAAC;AAEF,eAAO,MAAM,YAAY,GAAU,IAAI,EAAE,KAAG,OAAO,CAAC,UAAU,EAAE,CAE/D,CAAC;AAIF,eAAO,MAAM,wBAAwB,GAAU,IAAI,EAAE,EAAE,WAAW,MAAM,EAAE,aAAa,MAAM,GAAG,IAAI,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAI3H,CAAC;AAIF,eAAO,MAAM,oBAAoB,GAAU,IAAI,EAAE,EAAE,WAAW,MAAM,EAAE,SAAS,MAAM,GAAG,IAAI,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAInH,CAAC"}

package/dist/server/envelope.js

@@ -0,0 +1,113 @@
+// Envelope lifecycle helpers for client connections. SPEC §13.7.
+//
+// Every connected client gets a (session, run, client-loop) envelope. Either
+// the client picks the session explicitly (session.create / session.attach)
+// or the daemon auto-creates one on first requiresInit RPC. In both cases
+// the daemon opens a NEW run within the session and a NEW client loop within
+// that run; the client loop closes on disconnect.
+// Grammar 0.5.0 (#10): Session and Run carry user-renameable string names.
+// Defaults are `session-{unixtime}` and `run-{unixtime}`; random suffix avoids
+// collisions when two creations land in the same second.
+const tsName = (prefix) => {
+    const ts = Math.floor(Date.now() / 1000);
+    const rand = Math.floor(Math.random() * 0xFFFFFF).toString(36).padStart(4, "0");
+    return `${prefix}-${ts}-${rand}`;
+};
+export const generateSessionName = () => tsName("session");
+export const generateRunName = () => tsName("run");
+export const createClientEnvelope = async (db, opts = {}) => {
+    const name = opts.name ?? tsName(opts.prefix ?? "session");
+    const projectRoot = opts.projectRoot ?? null;
+    const persona = opts.persona ?? null;
+    const session = await db.envelope_insert_session.get({ name, project_root: projectRoot, persona });
+    if (session === undefined)
+        throw new Error("createClientEnvelope: session insert returned no row");
+    const runName = generateRunName();
+    const run = await db.envelope_insert_run.get({ session_id: session.id, name: runName, persona: null });
+    if (run === undefined)
+        throw new Error("createClientEnvelope: run insert returned no row");
+    const loop = await db.envelope_insert_client_loop.get({ run_id: run.id });
+    if (loop === undefined)
+        throw new Error("createClientEnvelope: loop insert returned no row");
+    return {
+        sessionId: session.id, sessionName: session.name,
+        projectRoot: session.project_root, sessionPersona: session.persona,
+        runId: run.id, runName: run.name, runPersona: run.persona,
+        clientLoopId: loop.id,
+    };
+};
+// Resolve the run inside a session. Three modes:
+// - opts.runId given: lookup by id, verify session ownership (else throw).
+// - opts.runName given: lookup by (sessionId, name); reuse if found, create otherwise.
+// - neither: create a new run with an auto-generated name (current behavior).
+// `runId` and `runName` are alternatives — passing both throws (use one).
+// persona handling: only set when creating a NEW run. Reusing an existing
+// run (by runId or by runName matching an existing row) carries forward
+// whatever persona was stored on that row — overrides target NEW runs.
+const resolveRun = async (db, sessionId, opts) => {
+    if (opts.runId !== undefined && opts.runName !== undefined) {
+        throw new Error("attachToSession: pass runId OR runName, not both");
+    }
+    if (opts.runId !== undefined) {
+        const existing = await db.envelope_get_run_by_id.get({ id: opts.runId });
+        if (existing === undefined)
+            throw new Error(`run ${opts.runId} not found`);
+        if (existing.session_id !== sessionId)
+            throw new Error(`run ${opts.runId} belongs to session ${existing.session_id}, not ${sessionId}`);
+        return { id: existing.id, name: existing.name, persona: existing.persona };
+    }
+    if (opts.runName !== undefined) {
+        const existing = await db.envelope_get_run_by_name.get({ session_id: sessionId, name: opts.runName });
+        if (existing !== undefined)
+            return existing;
+        const created = await db.envelope_insert_run.get({ session_id: sessionId, name: opts.runName, persona: opts.persona ?? null });
+        if (created === undefined)
+            throw new Error("resolveRun: run insert returned no row");
+        return created;
+    }
+    const created = await db.envelope_insert_run.get({ session_id: sessionId, name: generateRunName(), persona: opts.persona ?? null });
+    if (created === undefined)
+        throw new Error("resolveRun: run insert returned no row");
+    return created;
+};
+export const attachToSession = async (db, sessionId, opts = {}) => {
+    const session = await db.envelope_get_session.get({ id: sessionId });
+    if (session === undefined)
+        throw new Error(`session ${sessionId} not found`);
+    const run = await resolveRun(db, session.id, opts);
+    const loop = await db.envelope_insert_client_loop.get({ run_id: run.id });
+    if (loop === undefined)
+        throw new Error("attachToSession: loop insert returned no row");
+    return {
+        sessionId: session.id, sessionName: session.name,
+        projectRoot: session.project_root, sessionPersona: session.persona,
+        runId: run.id, runName: run.name, runPersona: run.persona,
+        clientLoopId: loop.id,
+    };
+};
+export const listRunsForSession = async (db, sessionId) => {
+    return await db.envelope_list_runs_for_session.all({ session_id: sessionId });
+};
+export const closeClientLoop = async (db, loopId, status) => {
+    await db.envelope_close_client_loop.run({ status, loop_id: loopId });
+};
+export const listSessions = async (db) => {
+    return await db.envelope_list_sessions.all();
+};
+// Updates sessions.project_root for an existing session and returns the new
+// value. Throws if the session does not exist. Used by session.set_root (F.1).
+export const updateSessionProjectRoot = async (db, sessionId, projectRoot) => {
+    const row = await db.envelope_update_session_project_root.get({ id: sessionId, project_root: projectRoot });
+    if (row === undefined)
+        throw new Error(`session ${sessionId} not found`);
+    return row.project_root;
+};
+// Updates sessions.persona. Mirrors updateSessionProjectRoot. Used by
+// session.set_persona (issue #150).
+export const updateSessionPersona = async (db, sessionId, persona) => {
+    const row = await db.envelope_update_session_persona.get({ id: sessionId, persona });
+    if (row === undefined)
+        throw new Error(`session ${sessionId} not found`);
+    return row.persona;
+};
+//# sourceMappingURL=envelope.js.map

package/dist/server/envelope.js.map

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

package/dist/server/logEntry.d.ts

@@ -0,0 +1,30 @@
+import type { Db } from "../core/Db.ts";
+export interface LogEntryWire {
+    id: number;
+    run_id: number;
+    loop_id: number;
+    turn_id: number;
+    action_index: number;
+    at: string;
+    origin: string;
+    op: string;
+    suffix: string;
+    signal: unknown;
+    target_scheme: string | null;
+    target_username: string | null;
+    target_password: string | null;
+    target_hostname: string | null;
+    target_port: number | null;
+    target_pathname: string | null;
+    target_params: unknown;
+    target_fragment: string | null;
+    lineMarker: unknown;
+    tx: unknown;
+    mimetype_tx: string;
+    rx: unknown;
+    mimetype_rx: string;
+    status_rx: number;
+    tokens: number;
+}
+export declare const fetchLogEntry: (db: Db, id: number) => Promise<LogEntryWire>;
+//# sourceMappingURL=logEntry.d.ts.map

package/dist/server/logEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logEntry.d.ts","sourceRoot":"","sources":["../../src/server/logEntry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,EAAc,MAAM,eAAe,CAAC;AAEpD,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,UAAU,EAAE,OAAO,CAAC;IACpB,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAClB;AAQD,eAAO,MAAM,aAAa,GAAU,IAAI,EAAE,EAAE,IAAI,MAAM,KAAG,OAAO,CAAC,YAAY,CA8B5E,CAAC"}

package/dist/server/logEntry.js

@@ -0,0 +1,43 @@
+// Hydrate a log_entries row for the wire. Re-parses JSON-encoded columns
+// (signal, target_params, lineMarker, tx, rx) so the client receives
+// structured values, not opaque strings.
+const parseJsonOrNull = (v) => {
+    if (v === null || v === undefined)
+        return null;
+    if (typeof v !== "string")
+        return v;
+    return JSON.parse(v);
+};
+export const fetchLogEntry = async (db, id) => {
+    const row = await db.log_entry_by_id.get({ id });
+    if (row === undefined)
+        throw new Error(`log_entries row ${id} not found`);
+    return {
+        id: row.id,
+        run_id: row.run_id,
+        loop_id: row.loop_id,
+        turn_id: row.turn_id,
+        action_index: row.action_index,
+        at: row.at,
+        origin: row.origin,
+        op: row.op,
+        suffix: row.suffix,
+        signal: parseJsonOrNull(row.signal),
+        target_scheme: row.target_scheme,
+        target_username: row.target_username,
+        target_password: row.target_password,
+        target_hostname: row.target_hostname,
+        target_port: row.target_port,
+        target_pathname: row.target_pathname,
+        target_params: parseJsonOrNull(row.target_params),
+        target_fragment: row.target_fragment,
+        lineMarker: parseJsonOrNull(row.lineMarker),
+        tx: parseJsonOrNull(row.tx),
+        mimetype_tx: row.mimetype_tx,
+        rx: parseJsonOrNull(row.rx),
+        mimetype_rx: row.mimetype_rx,
+        status_rx: row.status_rx,
+        tokens: row.tokens,
+    };
+};
+//# sourceMappingURL=logEntry.js.map

package/dist/server/logEntry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logEntry.js","sourceRoot":"","sources":["../../src/server/logEntry.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,qEAAqE;AACrE,yCAAyC;AAgCzC,MAAM,eAAe,GAAG,CAAC,CAAU,EAAW,EAAE;IAC5C,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC;IACpC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACzB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,EAAM,EAAE,EAAU,EAAyB,EAAE;IAC7E,MAAM,GAAG,GAAG,MAAO,EAAE,CAAC,eAA8B,CAAC,GAAG,CAA0B,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1F,IAAI,GAAG,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,EAAE,YAAY,CAAC,CAAC;IAC1E,OAAO;QACH,EAAE,EAAE,GAAG,CAAC,EAAY;QACpB,MAAM,EAAE,GAAG,CAAC,MAAgB;QAC5B,OAAO,EAAE,GAAG,CAAC,OAAiB;QAC9B,OAAO,EAAE,GAAG,CAAC,OAAiB;QAC9B,YAAY,EAAE,GAAG,CAAC,YAAsB;QACxC,EAAE,EAAE,GAAG,CAAC,EAAY;QACpB,MAAM,EAAE,GAAG,CAAC,MAAgB;QAC5B,EAAE,EAAE,GAAG,CAAC,EAAY;QACpB,MAAM,EAAE,GAAG,CAAC,MAAgB;QAC5B,MAAM,EAAE,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC;QACnC,aAAa,EAAE,GAAG,CAAC,aAA8B;QACjD,eAAe,EAAE,GAAG,CAAC,eAAgC;QACrD,eAAe,EAAE,GAAG,CAAC,eAAgC;QACrD,eAAe,EAAE,GAAG,CAAC,eAAgC;QACrD,WAAW,EAAE,GAAG,CAAC,WAA4B;QAC7C,eAAe,EAAE,GAAG,CAAC,eAAgC;QACrD,aAAa,EAAE,eAAe,CAAC,GAAG,CAAC,aAAa,CAAC;QACjD,eAAe,EAAE,GAAG,CAAC,eAAgC;QACrD,UAAU,EAAE,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC;QAC3C,EAAE,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,WAAW,EAAE,GAAG,CAAC,WAAqB;QACtC,EAAE,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,WAAW,EAAE,GAAG,CAAC,WAAqB;QACtC,SAAS,EAAE,GAAG,CAAC,SAAmB;QAClC,MAAM,EAAE,GAAG,CAAC,MAAgB;KAC/B,CAAC;AACN,CAAC,CAAC"}

package/dist/server/methods/_dispatchAsClient.d.ts

@@ -0,0 +1,8 @@
+import type { PlurnkStatement } from "@plurnk/plurnk-grammar";
+import type { HandlerContext } from "../MethodRegistry.ts";
+export interface DispatchAsClientResult {
+    status: number;
+    [key: string]: unknown;
+}
+export declare const dispatchAsClient: (ctx: HandlerContext, statement: PlurnkStatement) => Promise<DispatchAsClientResult>;
+//# sourceMappingURL=_dispatchAsClient.d.ts.map

package/dist/server/methods/_dispatchAsClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dispatchAsClient.d.ts","sourceRoot":"","sources":["../../../src/server/methods/_dispatchAsClient.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAI3D,MAAM,WAAW,sBAAsB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,eAAO,MAAM,gBAAgB,GAAU,KAAK,cAAc,EAAE,WAAW,eAAe,KAAG,OAAO,CAAC,sBAAsB,CAsBtH,CAAC"}

package/dist/server/methods/_dispatchAsClient.js

@@ -0,0 +1,31 @@
+// Shared dispatch helper used by every op.* RPC method. Wraps a parsed
+// PlurnkStatement in a client-origin turn inside the connection's client
+// loop, dispatches via Engine.dispatch, fires the log/entry notification
+// to all clients attached to the same session, and returns the dispatch
+// result for the RPC response.
+import { insertClientTurn } from "../clientTurn.js";
+import { fetchLogEntry } from "../logEntry.js";
+export const dispatchAsClient = async (ctx, statement) => {
+    if (ctx.session === null) {
+        throw new Error("dispatchAsClient requires an attached session");
+    }
+    const { sessionId, runId, clientLoopId } = ctx.session;
+    const turnId = await insertClientTurn(ctx.db, clientLoopId);
+    const result = await ctx.engine.dispatch({
+        statement,
+        sessionId,
+        runId,
+        loopId: clientLoopId,
+        turnId,
+        actionIndex: 0,
+        origin: "client",
+        onDispatch: (logEntryId) => {
+            void (async () => {
+                const entry = await fetchLogEntry(ctx.db, logEntryId);
+                ctx.notify({ sessionId }, "log/entry", { entry });
+            })();
+        },
+    });
+    return result;
+};
+//# sourceMappingURL=_dispatchAsClient.js.map

package/dist/server/methods/_dispatchAsClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dispatchAsClient.js","sourceRoot":"","sources":["../../../src/server/methods/_dispatchAsClient.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,yEAAyE;AACzE,yEAAyE;AACzE,wEAAwE;AACxE,+BAA+B;AAI/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAO/C,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,GAAmB,EAAE,SAA0B,EAAmC,EAAE;IACvH,IAAI,GAAG,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC;IACvD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;QACrC,SAAS;QACT,SAAS;QACT,KAAK;QACL,MAAM,EAAE,YAAY;QACpB,MAAM;QACN,WAAW,EAAE,CAAC;QACd,MAAM,EAAE,QAAQ;QAChB,UAAU,EAAE,CAAC,UAAU,EAAE,EAAE;YACvB,KAAK,CAAC,KAAK,IAAI,EAAE;gBACb,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;gBACtD,GAAG,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YACtD,CAAC,CAAC,EAAE,CAAC;QACT,CAAC;KACJ,CAAC,CAAC;IACH,OAAO,MAAgC,CAAC;AAC5C,CAAC,CAAC"}

package/dist/server/methods/discover.d.ts

@@ -0,0 +1,3 @@
+import type MethodRegistry from "../MethodRegistry.ts";
+export declare const register: (registry: MethodRegistry) => void;
+//# sourceMappingURL=discover.d.ts.map

package/dist/server/methods/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../../src/server/methods/discover.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,cAAc,MAAM,sBAAsB,CAAC;AAEvD,eAAO,MAAM,QAAQ,GAAI,UAAU,cAAc,KAAG,IAKnD,CAAC"}

package/dist/server/methods/discover.js

@@ -0,0 +1,7 @@
+export const register = (registry) => {
+    registry.registerMethod("discover", {
+        handler: async (_params, ctx) => ctx.registry.catalog(),
+        description: "Returns the protocol version plus the method and notification catalog.",
+    });
+};
+//# sourceMappingURL=discover.js.map

package/dist/server/methods/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../../../src/server/methods/discover.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,QAAwB,EAAQ,EAAE;IACvD,QAAQ,CAAC,cAAc,CAAC,UAAU,EAAE;QAChC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE;QACvD,WAAW,EAAE,wEAAwE;KACxF,CAAC,CAAC;AACP,CAAC,CAAC"}

package/dist/server/methods/entry_read.d.ts

@@ -0,0 +1,3 @@
+import type MethodRegistry from "../MethodRegistry.ts";
+export declare const register: (registry: MethodRegistry) => void;
+//# sourceMappingURL=entry_read.d.ts.map

package/dist/server/methods/entry_read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry_read.d.ts","sourceRoot":"","sources":["../../../src/server/methods/entry_read.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,cAAc,MAAM,sBAAsB,CAAC;AAiDvD,eAAO,MAAM,QAAQ,GAAI,UAAU,cAAc,KAAG,IAsBnD,CAAC"}

package/dist/server/methods/entry_read.js

@@ -0,0 +1,56 @@
+// entry.read — return the full entry shape (all channels + tags + metadata)
+// for a given path. SPEC §13.5.
+const parsePath = (s) => {
+    const m = s.match(/^([a-z][a-z0-9+.-]*):\/\/(.*)$/);
+    if (m === null)
+        return null;
+    return { scheme: m[1], pathname: m[2].split("#")[0] };
+};
+const fetchEntry = async (db, sessionId, scheme, pathname) => {
+    const row = await db.entry_read_lookup.get({
+        session_id: sessionId, scheme, pathname,
+    });
+    if (row === undefined)
+        return null;
+    const channelRows = await db.entry_read_channels.all({ entry_id: row.id });
+    const channels = {};
+    for (const c of channelRows) {
+        channels[c.name] = { content: c.content, mimetype: c.mimetype, tokens: c.tokens, state: c.state };
+    }
+    const tagRows = await db.crud_read_tags.all({ entry_id: row.id });
+    return {
+        id: row.id,
+        scope: row.scope,
+        sessionId: row.session_id,
+        scheme: row.scheme,
+        pathname: row.pathname,
+        channels,
+        tags: tagRows.map((t) => t.tag),
+    };
+};
+export const register = (registry) => {
+    registry.registerMethod("entry.read", {
+        handler: async (params, ctx) => {
+            const p = (params ?? {});
+            if (typeof p.path !== "string" || p.path.length === 0)
+                throw new Error("entry.read requires params.path: string");
+            const parsed = parsePath(p.path);
+            if (parsed === null)
+                throw new Error(`entry.read: path must be URL-shaped (scheme://pathname); got: ${p.path}`);
+            const sessionId = p.sessionId ?? ctx.session?.sessionId;
+            if (sessionId === undefined)
+                throw new Error("entry.read requires a sessionId (either via params or session attach)");
+            const entry = await fetchEntry(ctx.db, sessionId, parsed.scheme, parsed.pathname);
+            if (entry === null)
+                return { status: 404, entry: null };
+            return { status: 200, entry };
+        },
+        description: "Read the full entry shape (channels + tags + metadata) at the given path.",
+        params: {
+            path: "string — entry path (URL-shaped: scheme://pathname)",
+            sessionId: "number? — defaults to the connection's attached session",
+        },
+        requiresInit: true,
+    });
+};
+//# sourceMappingURL=entry_read.js.map

package/dist/server/methods/entry_read.js.map

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

package/dist/server/methods/log_read.d.ts

@@ -0,0 +1,3 @@
+import type MethodRegistry from "../MethodRegistry.ts";
+export declare const register: (registry: MethodRegistry) => void;
+//# sourceMappingURL=log_read.d.ts.map

package/dist/server/methods/log_read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log_read.d.ts","sourceRoot":"","sources":["../../../src/server/methods/log_read.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,cAAc,MAAM,sBAAsB,CAAC;AA6BvD,eAAO,MAAM,QAAQ,GAAI,UAAU,cAAc,KAAG,IAiBnD,CAAC"}

package/dist/server/methods/log_read.js

@@ -0,0 +1,39 @@
+// log.read — return recent log entries filterable by loop / turn / since-id,
+// scoped to the connection's attached session. SPEC §13.5.
+import { fetchLogEntry } from "../logEntry.js";
+const DEFAULT_LIMIT = 100;
+const MAX_LIMIT = 1000;
+const fetchLogEntries = async (db, runId, filters) => {
+    const limit = Math.min(typeof filters.limit === "number" ? filters.limit : DEFAULT_LIMIT, MAX_LIMIT);
+    const rows = await db.log_read_recent_ids.all({
+        run_id: runId,
+        loop_id: typeof filters.loopId === "number" ? filters.loopId : null,
+        turn_id: typeof filters.turnId === "number" ? filters.turnId : null,
+        since_id: typeof filters.sinceId === "number" ? filters.sinceId : null,
+        limit,
+    });
+    const entries = [];
+    for (const r of rows)
+        entries.push(await fetchLogEntry(db, r.id));
+    return entries;
+};
+export const register = (registry) => {
+    registry.registerMethod("log.read", {
+        handler: async (params, ctx) => {
+            if (ctx.session === null)
+                throw new Error("log.read requires an attached session");
+            const p = (params ?? {});
+            const entries = await fetchLogEntries(ctx.db, ctx.session.runId, p);
+            return { status: 200, entries };
+        },
+        description: "Read recent log entries from the attached session, optionally filtered.",
+        params: {
+            loopId: "number? — filter to one loop",
+            turnId: "number? — filter to one turn (within whatever loop)",
+            sinceId: "number? — return entries with id > sinceId (for incremental fetch)",
+            limit: "number? — max entries to return (default 100, max 1000)",
+        },
+        requiresInit: true,
+    });
+};
+//# sourceMappingURL=log_read.js.map