@plurnk/plurnk-service 0.1.0

package/dist/core/scheme-types.d.ts

@@ -0,0 +1,37 @@
+import type { Db } from "./Db.ts";
+export type WriterTier = "model" | "client" | "system" | "plugin";
+export interface PlurnkSchemeContext {
+    readonly db: Db;
+    readonly sessionId: number;
+    readonly runId: number;
+    readonly loopId: number;
+    readonly turnId: number;
+    readonly writer: WriterTier;
+    readonly signal: AbortSignal | undefined;
+}
+export interface SchemeFlagAffinity {
+    readonly excludedInAsk?: boolean;
+    readonly requiresWeb?: boolean;
+    readonly requiresInteraction?: boolean;
+    readonly proposes?: boolean;
+}
+export interface SchemeManifest {
+    readonly name: string;
+    readonly channels: Record<string, string>;
+    readonly defaultChannel: string;
+    readonly category: "data" | "logging";
+    readonly scope: "agent" | "session";
+    readonly writableBy: ReadonlyArray<WriterTier>;
+    readonly volatile: boolean;
+    readonly modelVisible: boolean;
+    readonly flags?: SchemeFlagAffinity;
+}
+export interface LoopFlags {
+    readonly mode: "ask" | "act";
+    readonly yolo: boolean;
+    readonly noWeb: boolean;
+    readonly noInteraction: boolean;
+    readonly noProposals: boolean;
+}
+export declare const DEFAULT_LOOP_FLAGS: LoopFlags;
+//# sourceMappingURL=scheme-types.d.ts.map

package/dist/core/scheme-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheme-types.d.ts","sourceRoot":"","sources":["../../src/core/scheme-types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAElC,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAOlE,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC;IAChB,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;CAC5C;AAED,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC;CACvC;AAED,MAAM,WAAW,SAAS;IACtB,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CACjC;AAED,eAAO,MAAM,kBAAkB,EAAE,SAMhC,CAAC"}

package/dist/core/scheme-types.js

@@ -0,0 +1,9 @@
+// Shared types for the scheme extension surface. See SCHEMES.md.
+export const DEFAULT_LOOP_FLAGS = {
+    mode: "act",
+    yolo: false,
+    noWeb: false,
+    noInteraction: false,
+    noProposals: false,
+};
+//# sourceMappingURL=scheme-types.js.map

package/dist/core/scheme-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheme-types.js","sourceRoot":"","sources":["../../src/core/scheme-types.ts"],"names":[],"mappings":"AAAA,iEAAiE;AAgDjE,MAAM,CAAC,MAAM,kBAAkB,GAAc;IACzC,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,KAAK,EAAE,KAAK;IACZ,aAAa,EAAE,KAAK;IACpB,WAAW,EAAE,KAAK;CACrB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+export { default as Engine } from "./core/Engine.ts";
+export { default as SchemeRegistry } from "./core/SchemeRegistry.ts";
+export { Mimetypes } from "@plurnk/plurnk-mimetypes";
+export { default as Daemon } from "./server/Daemon.ts";
+export { default as MethodRegistry } from "./server/MethodRegistry.ts";
+export type { MethodHandler, MethodRegistration, NotificationRegistration, Catalog, } from "./server/MethodRegistry.ts";
+export { default as Known } from "./schemes/Known.ts";
+export { default as Unknown } from "./schemes/Unknown.ts";
+export { default as Skill } from "./schemes/Skill.ts";
+export { default as Log } from "./schemes/Log.ts";
+export { default as Plurnk } from "./schemes/Plurnk.ts";
+export { default as Exec } from "./schemes/Exec.ts";
+export { default as File } from "./schemes/File.ts";
+export { default as Mock } from "./providers/Mock.ts";
+export type { MockResponse, MockAssistant, ChatMessage } from "./providers/Mock.ts";
+export type { EditResult, ReadResult, ShowHideResult, } from "./schemes/_entry-ops.ts";
+export declare const PATHS: {
+    migrations: string;
+    instructionsSystem: string;
+    defaultPersona: string;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAGrE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACvE,YAAY,EACR,aAAa,EACb,kBAAkB,EAClB,wBAAwB,EACxB,OAAO,GACV,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEpF,YAAY,EACR,UAAU,EACV,UAAU,EACV,cAAc,GACjB,MAAM,yBAAyB,CAAC;AA0BjC,eAAO,MAAM,KAAK;;;;CAQjB,CAAC"}

package/dist/index.js

@@ -0,0 +1,51 @@
+// Public library API for @plurnk/plurnk-service.
+//
+// Consumers (plurnk CLI/TUI, future web app, etc.) import from here.
+// Internal modules and tests reach into src/ paths directly; this file
+// is the contract for external use.
+export { default as Engine } from "./core/Engine.js";
+export { default as SchemeRegistry } from "./core/SchemeRegistry.js";
+// Mimetype handling is owned by @plurnk/plurnk-mimetypes. Consumers needing
+// the orchestrator import directly from there.
+export { Mimetypes } from "@plurnk/plurnk-mimetypes";
+export { default as Daemon } from "./server/Daemon.js";
+export { default as MethodRegistry } from "./server/MethodRegistry.js";
+export { default as Known } from "./schemes/Known.js";
+export { default as Unknown } from "./schemes/Unknown.js";
+export { default as Skill } from "./schemes/Skill.js";
+export { default as Log } from "./schemes/Log.js";
+export { default as Plurnk } from "./schemes/Plurnk.js";
+export { default as Exec } from "./schemes/Exec.js";
+export { default as File } from "./schemes/File.js";
+export { default as Mock } from "./providers/Mock.js";
+import { fileURLToPath } from "node:url";
+import { dirname, resolve } from "node:path";
+// Package-relative paths to non-code artifacts.
+//
+// `migrations` ships in this package's tarball.
+// `instructionsSystem` resolves to `plurnk.md` IN THE GRAMMAR PACKAGE — single
+// source of truth lives upstream. Plurnk-service doesn't carry its own copy;
+// the grammar agent owns the prose.
+const PACKAGE_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+const GRAMMAR_ROOT = dirname(fileURLToPath(import.meta.resolve("@plurnk/plurnk-grammar/package.json")));
+// Resolve the default persona file path: PLURNK_PERSONA env (absolute or
+// relative-to-package-root) → `persona.md` in package root as the
+// hardcoded fallback. The env var lets operators point at a custom
+// persona without forking the file in PACKAGE_ROOT.
+const resolveDefaultPersona = () => {
+    const env = process.env.PLURNK_PERSONA;
+    if (typeof env === "string" && env.length > 0) {
+        return resolve(PACKAGE_ROOT, env);
+    }
+    return resolve(PACKAGE_ROOT, "persona.md");
+};
+export const PATHS = {
+    migrations: resolve(PACKAGE_ROOT, "migrations"),
+    instructionsSystem: resolve(GRAMMAR_ROOT, "plurnk.md"),
+    // packet.system.persona DEFAULT. Cascade at packet-build time is
+    //   loops.persona > runs.persona > sessions.persona > this file
+    // RPC overrides on loop.run / session.attach / session.create populate
+    // the three persistence layers; this file is the final fallback.
+    defaultPersona: resolveDefaultPersona(),
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,EAAE;AACF,qEAAqE;AACrE,uEAAuE;AACvE,oCAAoC;AAEpC,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,0BAA0B,CAAC;AACrE,4EAA4E;AAC5E,+CAA+C;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAQvE,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAStD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,gDAAgD;AAChD,EAAE;AACF,gDAAgD;AAChD,+EAA+E;AAC/E,6EAA6E;AAC7E,oCAAoC;AACpC,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AAC5E,MAAM,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,qCAAqC,CAAC,CAAC,CAAC,CAAC;AAExG,yEAAyE;AACzE,kEAAkE;AAClE,mEAAmE;AACnE,oDAAoD;AACpD,MAAM,qBAAqB,GAAG,GAAW,EAAE;IACvC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IACvC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,OAAO,OAAO,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;AAC/C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,KAAK,GAAG;IACjB,UAAU,EAAE,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC;IAC/C,kBAAkB,EAAE,OAAO,CAAC,YAAY,EAAE,WAAW,CAAC;IACtD,iEAAiE;IACjE,gEAAgE;IAChE,uEAAuE;IACvE,iEAAiE;IACjE,cAAc,EAAE,qBAAqB,EAAE;CAC1C,CAAC"}

package/dist/providers/Mock.d.ts

@@ -0,0 +1,43 @@
+import type { PlurnkStatement } from "@plurnk/plurnk-grammar";
+import type { Provider, ProviderAssistant, ProviderUsage } from "../core/ProviderRegistry.ts";
+export type ChatMessage = {
+    role: "system" | "user" | "assistant";
+    content: string;
+};
+export type MockAssistant = {
+    content: string;
+    reasoning: string | null;
+    usage?: ProviderUsage;
+    finishReason?: string | null;
+    model?: string;
+    ops?: PlurnkStatement[];
+};
+export type MockResponse = {
+    assistant: MockAssistant;
+    assistantRaw?: unknown;
+};
+export type MockReturnedAssistant = ProviderAssistant & {
+    ops?: PlurnkStatement[];
+};
+declare const DEFAULT_USAGE: ProviderUsage;
+export default class Mock implements Provider {
+    #private;
+    constructor({ contextSize, responses }: {
+        contextSize: number;
+        responses: MockResponse[];
+    });
+    get contextSize(): number;
+    get model(): string;
+    countTokens(text: string): number;
+    costFor(_usage: ProviderUsage): number;
+    generate(_: {
+        messages: ChatMessage[];
+        signal?: AbortSignal;
+    }): Promise<{
+        assistant: MockReturnedAssistant;
+        assistantRaw: unknown;
+    }>;
+    get remaining(): number;
+}
+export { DEFAULT_USAGE as mockDefaultUsage };
+//# sourceMappingURL=Mock.d.ts.map

package/dist/providers/Mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Mock.d.ts","sourceRoot":"","sources":["../../src/providers/Mock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE9F,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAKrF,MAAM,MAAM,aAAa,GAAG;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,eAAe,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACvB,SAAS,EAAE,aAAa,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAIF,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GAAG;IAAE,GAAG,CAAC,EAAE,eAAe,EAAE,CAAA;CAAE,CAAC;AAEpF,QAAA,MAAM,aAAa,EAAE,aAAiE,CAAC;AAEvF,MAAM,CAAC,OAAO,OAAO,IAAK,YAAW,QAAQ;;gBAI7B,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,YAAY,EAAE,CAAA;KAAE;IAK1F,IAAI,WAAW,IAAI,MAAM,CAA8B;IACvD,IAAI,KAAK,IAAI,MAAM,CAAmB;IAItC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAKjC,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM;IAEhC,QAAQ,CAAC,CAAC,EAAE;QAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,qBAAqB,CAAC;QAAC,YAAY,EAAE,OAAO,CAAA;KAAE,CAAC;IAe1I,IAAI,SAAS,IAAI,MAAM,CAA+B;CACzD;AAED,OAAO,EAAE,aAAa,IAAI,gBAAgB,EAAE,CAAC"}

package/dist/providers/Mock.js

@@ -0,0 +1,36 @@
+const DEFAULT_USAGE = { prompt: 0, completion: 0, cached: 0, total: 0 };
+export default class Mock {
+    #contextSize;
+    #queue;
+    constructor({ contextSize, responses }) {
+        this.#contextSize = contextSize;
+        this.#queue = [...responses];
+    }
+    get contextSize() { return this.#contextSize; }
+    get model() { return "mock"; }
+    // Heuristic tokenizer. Mock is test-only; real provider siblings ship
+    // family-specific tokenizers.
+    countTokens(text) {
+        return text.length === 0 ? 0 : Math.ceil(text.length / 4);
+    }
+    // Mock is free.
+    costFor(_usage) { return 0; }
+    async generate(_) {
+        const next = this.#queue.shift();
+        if (next === undefined)
+            throw new Error("Mock provider exhausted: no more queued responses");
+        const a = next.assistant;
+        const assistant = {
+            content: a.content,
+            reasoning: a.reasoning,
+            usage: a.usage ?? DEFAULT_USAGE,
+            finishReason: a.finishReason ?? "stop",
+            model: a.model ?? "mock",
+            ...(a.ops !== undefined ? { ops: a.ops } : {}),
+        };
+        return { assistant, assistantRaw: next.assistantRaw ?? null };
+    }
+    get remaining() { return this.#queue.length; }
+}
+export { DEFAULT_USAGE as mockDefaultUsage };
+//# sourceMappingURL=Mock.js.map

package/dist/providers/Mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Mock.js","sourceRoot":"","sources":["../../src/providers/Mock.ts"],"names":[],"mappings":"AA0BA,MAAM,aAAa,GAAkB,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AAEvF,MAAM,CAAC,OAAO,OAAO,IAAI;IACrB,YAAY,CAAS;IACrB,MAAM,CAAiB;IAEvB,YAAY,EAAE,WAAW,EAAE,SAAS,EAAsD;QACtF,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,WAAW,KAAa,OAAO,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;IACvD,IAAI,KAAK,KAAa,OAAO,MAAM,CAAC,CAAC,CAAC;IAEtC,sEAAsE;IACtE,8BAA8B;IAC9B,WAAW,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,gBAAgB;IAChB,OAAO,CAAC,MAAqB,IAAY,OAAO,CAAC,CAAC,CAAC,CAAC;IAEpD,KAAK,CAAC,QAAQ,CAAC,CAAoD;QAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACjC,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QAC7F,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;QACzB,MAAM,SAAS,GAA0B;YACrC,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,aAAa;YAC/B,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,MAAM;YACtC,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,MAAM;YACxB,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjD,CAAC;QACF,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,IAAI,EAAE,CAAC;IAClE,CAAC;IAED,IAAI,SAAS,KAAa,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;CACzD;AAED,OAAO,EAAE,aAAa,IAAI,gBAAgB,EAAE,CAAC"}

package/dist/schemes/Exec.d.ts

@@ -0,0 +1,5 @@
+import type { SchemeManifest } from "../core/scheme-types.ts";
+export default class Exec {
+    static manifest: SchemeManifest;
+}
+//# sourceMappingURL=Exec.d.ts.map

package/dist/schemes/Exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Exec.d.ts","sourceRoot":"","sources":["../../src/schemes/Exec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAM9D,MAAM,CAAC,OAAO,OAAO,IAAI;IACrB,MAAM,CAAC,QAAQ,EAAE,cAAc,CAa7B;CACL"}

package/dist/schemes/Exec.js

@@ -0,0 +1,20 @@
+// PROVISIONAL: subprocess execution scheme. Streams stdout/stderr as channels
+// on the entry. Dynamic mimetype per call (text/plain in the simple case;
+// future per-command detection).
+export default class Exec {
+    static manifest = {
+        name: "exec",
+        channels: {},
+        defaultChannel: "stdout",
+        category: "data",
+        scope: "session",
+        writableBy: ["model", "client"],
+        volatile: true,
+        modelVisible: true,
+        flags: {
+            excludedInAsk: true, // exec is side-effecting; ask mode is read-only
+            proposes: true, // exec runs via proposal lifecycle unless yolo
+        },
+    };
+}
+//# sourceMappingURL=Exec.js.map

package/dist/schemes/Exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Exec.js","sourceRoot":"","sources":["../../src/schemes/Exec.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,0EAA0E;AAC1E,iCAAiC;AAEjC,MAAM,CAAC,OAAO,OAAO,IAAI;IACrB,MAAM,CAAC,QAAQ,GAAmB;QAC9B,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,EAAE;QACZ,cAAc,EAAE,QAAQ;QACxB,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,SAAS;QAChB,UAAU,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC;QAC/B,QAAQ,EAAE,IAAI;QACd,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE;YACH,aAAa,EAAE,IAAI,EAAI,gDAAgD;YACvE,QAAQ,EAAE,IAAI,EAAU,+CAA+C;SAC1E;KACJ,CAAC"}

package/dist/schemes/File.d.ts

@@ -0,0 +1,35 @@
+import type { EditStatement, ReadStatement } from "@plurnk/plurnk-grammar";
+import type { SchemeManifest, PlurnkSchemeContext } from "../core/scheme-types.ts";
+type ReadResult = {
+    status: number;
+    content: string | null;
+    mimetype: string | null;
+};
+type EditResult = {
+    status: number;
+    body?: string;
+    attrs?: object;
+    error?: string;
+};
+type ApplyArgs = {
+    attrs: {
+        path?: string;
+        patched?: string;
+        [k: string]: unknown;
+    };
+    body?: string;
+};
+type ApplyResult = {
+    status: number;
+    outcome?: string;
+    body?: string;
+};
+export default class File {
+    #private;
+    static manifest: SchemeManifest;
+    read(statement: ReadStatement, _ctx: PlurnkSchemeContext): Promise<ReadResult>;
+    edit(statement: EditStatement, _ctx: PlurnkSchemeContext): Promise<EditResult>;
+    applyResolution(args: ApplyArgs): Promise<ApplyResult>;
+}
+export {};
+//# sourceMappingURL=File.d.ts.map

package/dist/schemes/File.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"File.d.ts","sourceRoot":"","sources":["../../src/schemes/File.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnF,KAAK,UAAU,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AACtF,KAAK,UAAU,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AACpF,KAAK,SAAS,GAAG;IAAE,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AACrG,KAAK,WAAW,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvE,MAAM,CAAC,OAAO,OAAO,IAAI;;IACrB,MAAM,CAAC,QAAQ,EAAE,cAAc,CAY7B;IAkCI,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;IAqB9E,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;IAgD9E,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;CAqB/D"}

package/dist/schemes/File.js

@@ -0,0 +1,149 @@
+import { readFile, realpath, writeFile } from "node:fs/promises";
+import { resolve, relative, isAbsolute } from "node:path";
+import { createPatch } from "diff";
+export default class File {
+    static manifest = {
+        name: "file",
+        channels: {}, // dynamic mimetype per file extension
+        defaultChannel: "body",
+        category: "data",
+        scope: "session",
+        writableBy: ["model", "client", "plugin"],
+        volatile: false,
+        modelVisible: true,
+        flags: {
+            proposes: true, // file writes go through proposal lifecycle (task #42)
+        },
+    };
+    #workspaceRoot = null;
+    #resolveWorkspaceRoot() {
+        if (this.#workspaceRoot !== null)
+            return this.#workspaceRoot;
+        const root = process.env.PLURNK_WORKSPACE_ROOT;
+        if (root === undefined || root === "")
+            return null;
+        this.#workspaceRoot = resolve(root);
+        return this.#workspaceRoot;
+    }
+    // Resolve + workspace-root containment check. Returns null on absence;
+    // throws on traversal escape. Used by both read and edit.
+    async #resolveContained(pathname) {
+        const root = this.#resolveWorkspaceRoot();
+        if (root === null)
+            return { error: "no-root" };
+        const requested = isAbsolute(pathname) ? pathname : resolve(root, pathname);
+        let canonical;
+        try {
+            canonical = await realpath(requested);
+        }
+        catch (err) {
+            if (err.code === "ENOENT") {
+                // For edit, missing target is OK — we'll write it. Caller
+                // distinguishes by checking error === "not-found".
+                return { error: "not-found" };
+            }
+            throw err;
+        }
+        const rel = relative(root, canonical);
+        if (rel.startsWith("..") || isAbsolute(rel))
+            return { error: "traversal" };
+        return { canonical, root };
+    }
+    async read(statement, _ctx) {
+        if (statement.path === null)
+            return { status: 400, content: null, mimetype: null };
+        if (statement.lineMarker !== null)
+            return { status: 501, content: null, mimetype: null };
+        if (statement.body !== null)
+            return { status: 501, content: null, mimetype: null };
+        if (Array.isArray(statement.signal) && statement.signal.length > 0)
+            return { status: 501, content: null, mimetype: null };
+        const pathname = statement.path.kind === "url" ? statement.path.pathname : statement.path.raw;
+        const resolved = await this.#resolveContained(pathname);
+        if ("error" in resolved) {
+            if (resolved.error === "no-root")
+                return { status: 400, content: null, mimetype: null };
+            if (resolved.error === "not-found")
+                return { status: 404, content: null, mimetype: null };
+            return { status: 403, content: null, mimetype: null }; // traversal
+        }
+        const content = await readFile(resolved.canonical, "utf8");
+        return { status: 200, content, mimetype: "text/plain" };
+    }
+    // Edit op (task #42 canonical proposal consumer). Returns status=202
+    // with a udiff body for client review + attrs carrying the full patched
+    // content. Engine writes the proposed log entry, pauses dispatch, and
+    // calls applyResolution() (below) after the proposal accepts.
+    async edit(statement, _ctx) {
+        if (statement.path === null)
+            return { status: 400, error: "EDIT requires a path" };
+        if (statement.lineMarker !== null)
+            return { status: 501, error: "lineMarker-based edits not yet supported" };
+        const pathname = statement.path.kind === "url" ? statement.path.pathname : statement.path.raw;
+        const root = this.#resolveWorkspaceRoot();
+        if (root === null)
+            return { status: 400, error: "PLURNK_WORKSPACE_ROOT must be set" };
+        // Containment check (canonical path inside workspace). For edits,
+        // a not-found target is fine — we're proposing to create or
+        // overwrite. Traversal escape is fatal.
+        let canonical;
+        const requested = isAbsolute(pathname) ? pathname : resolve(root, pathname);
+        let original = "";
+        try {
+            canonical = await realpath(requested);
+            original = await readFile(canonical, "utf8");
+        }
+        catch (err) {
+            if (err.code !== "ENOENT")
+                throw err;
+            // File doesn't exist — propose to create it.
+            canonical = requested;
+        }
+        // Re-check containment against the (now-resolved-or-fabricated)
+        // canonical path. The requested path could resolve to a parent of
+        // workspace via symlink; reject.
+        const rel = relative(root, canonical);
+        if (rel.startsWith("..") || isAbsolute(rel)) {
+            return { status: 403, error: "path escapes workspace root" };
+        }
+        const patched = statement.body ?? "";
+        const patch = createPatch(rel, original, patched, "current", "proposed");
+        return {
+            status: 202,
+            body: patch,
+            attrs: {
+                path: rel,
+                canonical,
+                patch, // full udiff (sent to client for render)
+                patched, // full new content (used by applyResolution)
+            },
+        };
+    }
+    // applyResolution — called by Engine.dispatch after a proposed log
+    // entry resolves with decision=accept. Reads the attrs that the
+    // earlier edit() returned and writes the patched content to disk.
+    // Returns the final outcome that gets stored on the log entry.
+    async applyResolution(args) {
+        const { attrs, body } = args;
+        const canonical = attrs.canonical;
+        const patched = body ?? attrs.patched;
+        if (typeof canonical !== "string" || canonical.length === 0) {
+            return { status: 500, outcome: "applyResolution: missing attrs.canonical" };
+        }
+        if (typeof patched !== "string") {
+            return { status: 500, outcome: "applyResolution: missing patched content" };
+        }
+        try {
+            await writeFile(canonical, patched, "utf8");
+            return { status: 200 };
+        }
+        catch (err) {
+            return {
+                status: 500,
+                outcome: "write_failed",
+                body: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }
+}
+//# sourceMappingURL=File.js.map

package/dist/schemes/File.js.map

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

package/dist/schemes/Known.d.ts

@@ -0,0 +1,19 @@
+import type { SchemeManifest, PlurnkSchemeContext } from "../core/scheme-types.ts";
+import type { EditStatement, FindStatement, HideStatement, ReadStatement, SendStatement, ShowStatement } from "@plurnk/plurnk-grammar";
+import type { EditResult, ReadResult, ShowHideResult } from "./_entry-ops.ts";
+import type { EntryData, ReadEntryResult, WriteEntryResult, DeleteEntryResult } from "./_entry-crud.ts";
+import type { SendResult } from "./_entry-send.ts";
+import type { FindResult } from "./_entry-find.ts";
+export default class Known {
+    static manifest: SchemeManifest;
+    edit(statement: EditStatement, ctx: PlurnkSchemeContext): Promise<EditResult>;
+    read(statement: ReadStatement, ctx: PlurnkSchemeContext): Promise<ReadResult>;
+    show(statement: ShowStatement | HideStatement, ctx: PlurnkSchemeContext): Promise<ShowHideResult>;
+    hide(statement: ShowStatement | HideStatement, ctx: PlurnkSchemeContext): Promise<ShowHideResult>;
+    readEntry(pathname: string, ctx: PlurnkSchemeContext): Promise<ReadEntryResult>;
+    writeEntry(pathname: string, entry: EntryData, ctx: PlurnkSchemeContext): Promise<WriteEntryResult>;
+    deleteEntry(pathname: string, ctx: PlurnkSchemeContext): Promise<DeleteEntryResult>;
+    send(statement: SendStatement, ctx: PlurnkSchemeContext): Promise<SendResult>;
+    find(statement: FindStatement, ctx: PlurnkSchemeContext): Promise<FindResult>;
+}
+//# sourceMappingURL=Known.d.ts.map

package/dist/schemes/Known.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Known.d.ts","sourceRoot":"","sources":["../../src/schemes/Known.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvI,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE9E,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAExG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,CAAC,OAAO,OAAO,KAAK;IACtB,MAAM,CAAC,QAAQ,EAAE,cAAc,CAS7B;IAEI,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;IAI7E,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;IAI7E,IAAI,CAAC,SAAS,EAAE,aAAa,GAAG,aAAa,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;IAIjG,IAAI,CAAC,SAAS,EAAE,aAAa,GAAG,aAAa,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;IAIjG,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAI/E,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAInG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAInF,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;IAI7E,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;CAGtF"}

package/dist/schemes/Known.js

@@ -0,0 +1,44 @@
+import { editSessionEntry, readSessionEntry, showSessionEntry, hideSessionEntry } from "./_entry-ops.js";
+import { readEntry, writeEntry, deleteEntry } from "./_entry-crud.js";
+import { sendToSessionEntry } from "./_entry-send.js";
+import { findSessionEntries } from "./_entry-find.js";
+export default class Known {
+    static manifest = {
+        name: "known",
+        channels: { body: "text/markdown", preview: "text/markdown" },
+        defaultChannel: "body",
+        category: "data",
+        scope: "session",
+        writableBy: ["model", "client"],
+        volatile: false,
+        modelVisible: true,
+    };
+    async edit(statement, ctx) {
+        return editSessionEntry(statement, ctx, Known.manifest);
+    }
+    async read(statement, ctx) {
+        return readSessionEntry(statement, ctx, Known.manifest);
+    }
+    async show(statement, ctx) {
+        return showSessionEntry(statement, ctx, Known.manifest);
+    }
+    async hide(statement, ctx) {
+        return hideSessionEntry(statement, ctx, Known.manifest);
+    }
+    async readEntry(pathname, ctx) {
+        return readEntry(pathname, ctx, Known.manifest.name);
+    }
+    async writeEntry(pathname, entry, ctx) {
+        return writeEntry(pathname, entry, ctx, Known.manifest.name);
+    }
+    async deleteEntry(pathname, ctx) {
+        return deleteEntry(pathname, ctx, Known.manifest.name);
+    }
+    async send(statement, ctx) {
+        return sendToSessionEntry(statement, ctx, Known.manifest.name);
+    }
+    async find(statement, ctx) {
+        return findSessionEntries(statement, ctx, Known.manifest.name);
+    }
+}
+//# sourceMappingURL=Known.js.map

package/dist/schemes/Known.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Known.js","sourceRoot":"","sources":["../../src/schemes/Known.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEzG,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGtD,MAAM,CAAC,OAAO,OAAO,KAAK;IACtB,MAAM,CAAC,QAAQ,GAAmB;QAC9B,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,eAAe,EAAE;QAC7D,cAAc,EAAE,MAAM;QACtB,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,SAAS;QAChB,UAAU,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC;QAC/B,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,IAAI;KACrB,CAAC;IAEF,KAAK,CAAC,IAAI,CAAC,SAAwB,EAAE,GAAwB;QACzD,OAAO,gBAAgB,CAAC,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAwB,EAAE,GAAwB;QACzD,OAAO,gBAAgB,CAAC,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAwC,EAAE,GAAwB;QACzE,OAAO,gBAAgB,CAAC,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAwC,EAAE,GAAwB;QACzE,OAAO,gBAAgB,CAAC,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,QAAgB,EAAE,GAAwB;QACtD,OAAO,SAAS,CAAC,QAAQ,EAAE,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAAgB,EAAE,KAAgB,EAAE,GAAwB;QACzE,OAAO,UAAU,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,QAAgB,EAAE,GAAwB;QACxD,OAAO,WAAW,CAAC,QAAQ,EAAE,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAwB,EAAE,GAAwB;QACzD,OAAO,kBAAkB,CAAC,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAwB,EAAE,GAAwB;QACzD,OAAO,kBAAkB,CAAC,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACnE,CAAC"}

package/dist/schemes/Log.d.ts

@@ -0,0 +1,13 @@
+import type { ReadStatement } from "@plurnk/plurnk-grammar";
+import type { SchemeManifest, PlurnkSchemeContext } from "../core/scheme-types.ts";
+type ReadResult = {
+    status: number;
+    content: string | null;
+    mimetype: string | null;
+};
+export default class Log {
+    static manifest: SchemeManifest;
+    read(statement: ReadStatement, ctx: PlurnkSchemeContext): Promise<ReadResult>;
+}
+export {};
+//# sourceMappingURL=Log.d.ts.map

package/dist/schemes/Log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Log.d.ts","sourceRoot":"","sources":["../../src/schemes/Log.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnF,KAAK,UAAU,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAItF,MAAM,CAAC,OAAO,OAAO,GAAG;IACpB,MAAM,CAAC,QAAQ,EAAE,cAAc,CAS7B;IAEI,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;CA6BtF"}

package/dist/schemes/Log.js

@@ -0,0 +1,38 @@
+const COORDINATE = /^(\d+)\/(\d+)\/(\d+)$/;
+export default class Log {
+    static manifest = {
+        name: "log",
+        channels: {}, // logs render through read(), not channel storage
+        defaultChannel: "",
+        category: "logging",
+        scope: "session",
+        writableBy: ["system"], // engine-only writes; model & client read
+        volatile: false,
+        modelVisible: true,
+    };
+    async read(statement, ctx) {
+        const { db, runId } = ctx;
+        if (statement.path === null)
+            return { status: 400, content: null, mimetype: null };
+        if (statement.lineMarker !== null)
+            return { status: 501, content: null, mimetype: null };
+        if (statement.body !== null)
+            return { status: 501, content: null, mimetype: null };
+        if (Array.isArray(statement.signal) && statement.signal.length > 0)
+            return { status: 501, content: null, mimetype: null };
+        const pathname = statement.path.kind === "url" ? statement.path.pathname : statement.path.raw;
+        const match = COORDINATE.exec(pathname);
+        if (match === null)
+            return { status: 400, content: null, mimetype: null };
+        const loopSeq = Number(match[1]);
+        const turnSeq = Number(match[2]);
+        const actionIndex = Number(match[3]);
+        const row = await db.log_read_by_coordinate.get({ run_id: runId, loop_seq: loopSeq, turn_seq: turnSeq, action_index: actionIndex });
+        if (row === undefined)
+            return { status: 404, content: null, mimetype: null };
+        const target = row.target_scheme !== null ? `${row.target_scheme}://${row.target_pathname ?? ""}` : (row.target_pathname ?? "(no path)");
+        const summary = `${row.op} ${target}\nstatus: ${row.status_rx}\nresponse: ${row.rx}`;
+        return { status: 200, content: summary, mimetype: "text/plain" };
+    }
+}
+//# sourceMappingURL=Log.js.map

package/dist/schemes/Log.js.map

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

package/dist/schemes/Plurnk.d.ts

@@ -0,0 +1,5 @@
+import type { SchemeManifest } from "../core/scheme-types.ts";
+export default class Plurnk {
+    static manifest: SchemeManifest;
+}
+//# sourceMappingURL=Plurnk.d.ts.map

package/dist/schemes/Plurnk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plurnk.d.ts","sourceRoot":"","sources":["../../src/schemes/Plurnk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAK9D,MAAM,CAAC,OAAO,OAAO,MAAM;IACvB,MAAM,CAAC,QAAQ,EAAE,cAAc,CAS7B;CACL"}