@plurnk/plurnk-service 1.7.0 → 1.9.0

package/dist/core/plurnk-uri.js

@@ -12,45 +12,80 @@ export function schemeNameOf(path) {
     // {§scheme-address-network}: handler aliases route https through http and ws through wss
     // without collapsing the addressed scheme's resource identity.
     if (path.kind === "url") {
-        if (path.scheme === "https")
-            return "http";
-        if (path.scheme === "ws")
-            return "wss";
-        return path.scheme;
+        return routedSchemeName(path.scheme);
     }
     return "file"; // local (bare) → file
 }
+export function routedSchemeName(addressedScheme) {
+    if (addressedScheme === "http")
+        return "https";
+    if (addressedScheme === "ws")
+        return "wss";
+    return addressedScheme;
+}
 export function foldAuthorityIntoPath(hostname, pathname) {
     return hostname ? `/${hostname}${pathname}` : pathname;
 }
-export function entryPathnameOf(path) {
-    if (path.kind === "url" && NetworkAddress.supports(path.scheme)) {
-        return NetworkAddress.from(path).pathname;
+export function entryCoordinateOf(path, authority) {
+    if (path.kind === "local") {
+        return { authority: "", pathname: PathSyntax.decodeParens(path.raw) };
+    }
+    if (authority === "resource") {
+        const canonicalAuthority = path.hostname === null
+            ? ""
+            : `${path.hostname}${path.port === null ? "" : `:${path.port}`}`;
+        const query = path.query === null ? "" : `?${path.query}`;
+        return {
+            authority: canonicalAuthority,
+            pathname: PathSyntax.decodeParens(path.pathname) + query,
+        };
     }
-    const pathname = path.kind === "url"
-        ? foldAuthorityIntoPath(path.hostname, path.pathname)
-        : path.raw;
-    return PathSyntax.decodeParens(pathname);
+    if (authority === "owner") {
+        return { authority: "", pathname: PathSyntax.decodeParens(path.pathname) };
+    }
+    return {
+        authority: "",
+        pathname: PathSyntax.decodeParens(foldAuthorityIntoPath(path.hostname, path.pathname)),
+    };
+}
+export function authorityParts(authority) {
+    if (authority.length === 0)
+        return { hostname: null, port: null };
+    const parsed = new URL(`plurnk-authority://${authority}/`);
+    if (parsed.username.length > 0 || parsed.password.length > 0 || parsed.hostname.length === 0) {
+        throw new TypeError(`Invalid resource authority ${JSON.stringify(authority)}.`);
+    }
+    return {
+        hostname: parsed.hostname,
+        port: parsed.port.length === 0 ? null : Number(parsed.port),
+    };
+}
+// {§worker-generated-subtree} — every Plurnk-generated per-Worker document lives under
+// worker://~/_plurnk/. The root is the one writer-tier boundary and the fork
+// rederive predicate; families (agents.md, skills/, tools/) hang beneath it.
+export const GENERATED_ROOT = "/_plurnk";
+export function generatedPathname(relative) {
+    return `${GENERATED_ROOT}${relative.startsWith("/") ? relative : `/${relative}`}`;
+}
+export function isGeneratedPathname(pathname) {
+    return pathname === GENERATED_ROOT || pathname.startsWith(`${GENERATED_ROOT}/`);
 }
-// {§prompt-self-only} — the prompt address is prompt:///<loopSeq>/<turnSeq>: the OWNER rides the
+// {§prompt-self-only} — the prompt address is prompt:///<loopSeq>/<promptOrdinal>: the OWNER rides the
 // owner_id column ({§entry-owner}), so the coordinate is bare and loop-relative — the last
 // owner scoping is the query's owner_id param, never a path segment. Every
 // prompt writer and query builds through these two helpers.
-export function promptPathname(loopSeq, turnSeq) {
-    return `/${loopSeq}/${turnSeq}`;
+export function promptPathname(loopSeq, promptOrdinal) {
+    return `/${loopSeq}/${promptOrdinal}`;
 }
 export function promptLoopPrefix(loopSeq) {
     return `/${loopSeq}/`;
 }
-export function renderAddress(scheme, pathname) {
-    if (NetworkAddress.supports(scheme))
-        return NetworkAddress.render(scheme, pathname);
+export function renderAddress(address) {
+    if (NetworkAddress.supports(address.scheme))
+        return NetworkAddress.render(address);
+    const { scheme, authority, pathname } = address;
     const encoded = PathSyntax.encodeParens(pathname);
-    // {§scheme-address} — network storage folds the host into the pathname and
-    // model-facing rendering restores it to the authority slot.
-    // worker:// renders :/// — the owner rides owner_id ({§entry-owner}), so empty authority IS
-    // the canonical stored form; a querying face re-applies its authority (~/name) for display.
-    return PathSyntax.escapeTarget(`${scheme}://${encoded}`);
+    return PathSyntax.escapeTarget(`${scheme}://${authority}${encoded}`);
 }
 /** Render one stored target without exposing credentials or request metadata. {§scheme-address} */
 export function renderTarget(target) {
@@ -67,7 +102,10 @@ export function renderTarget(target) {
         address = PathSyntax.escapeTarget(`${scheme}://${hostname}${port}${PathSyntax.encodeParens(target.pathname)}`);
     }
     else {
-        address = renderAddress(scheme, target.pathname);
+        const authority = hostname === null || hostname.length === 0
+            ? ""
+            : `${hostname}${target.port === null || target.port === undefined ? "" : `:${target.port}`}`;
+        address = renderAddress({ scheme, authority, pathname: target.pathname });
     }
     if (target.query !== null && target.query !== undefined) {
         address += `?${PathSyntax.escapeTarget(target.query)}`;

package/dist/core/plurnk-uri.js.map

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

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

@@ -10,6 +10,7 @@ export interface PlurnkSchemeContext {
     readonly db: Db;
     readonly workspaceId: number;
     readonly workerId: number;
+    readonly functionalityWorkerId: number;
     readonly loopId: number;
     readonly turnId: number;
     readonly writer: WriterTier;

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

@@ -1 +1 @@
-{"version":3,"file":"scheme-types.d.ts","sourceRoot":"","sources":["../../src/core/scheme-types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,gBAAgB,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACjG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACR,wBAAwB,EACxB,2BAA2B,EAC3B,MAAM,EACT,MAAM,0BAA0B,CAAC;AAIlC,YAAY,EACR,SAAS,EACT,kBAAkB,EAClB,cAAc,EACd,UAAU,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAMhD,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC;IAChB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,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,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IAC/C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAK7C,QAAQ,CAAC,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAI/B,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAOtC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAI1C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IAGxD,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAG/C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAC1B,OAAO,EAAE,wBAAwB,KAChC,OAAO,CAAC,2BAA2B,CAAC,CAAC;CAC7C"}
+{"version":3,"file":"scheme-types.d.ts","sourceRoot":"","sources":["../../src/core/scheme-types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,gBAAgB,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACjG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACR,wBAAwB,EACxB,2BAA2B,EAC3B,MAAM,EACT,MAAM,0BAA0B,CAAC;AAIlC,YAAY,EACR,SAAS,EACT,kBAAkB,EAClB,cAAc,EACd,UAAU,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAMhD,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC;IAChB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAK1B,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,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,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IAC/C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAK7C,QAAQ,CAAC,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAI/B,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAOtC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAI1C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IAGxD,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAG/C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAC1B,OAAO,EAAE,wBAAwB,KAChC,OAAO,CAAC,2BAA2B,CAAC,CAAC;CAC7C"}

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

@@ -1 +1 @@
-{"version":3,"file":"teaching.d.ts","sourceRoot":"","sources":["../../src/core/teaching.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,cAAc,QAAO,WAAW,CAAC,MAAM,CACwD,CAAC"}
+{"version":3,"file":"teaching.d.ts","sourceRoot":"","sources":["../../src/core/teaching.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,cAAc,QAAO,WAAW,CAAC,MAAM,CACwD,CAAC"}

package/dist/core/teaching.js

@@ -1,7 +1,6 @@
-// {§tools-capability-sheet} {§schemes-directory} — PLURNK_SERVICE_DOCS_EXCLUDE
-// is a comma list of scheme/exec names dropped from both the teaching
-// oneliner AND the materialized pull-doc, on load — the self-evident/retired names the operator
-// wants no doc for (default `plurnk,file,exec`, set in .env.defaults). Read per-call so a process
-// can change it; unknown names are inert (a filter, never a contract).
+// {§schemes-directory} — PLURNK_SERVICE_DOCS_EXCLUDE is a comma list of scheme
+// names dropped from both the teaching oneliner and materialized pull-doc. Tool
+// discovery follows the executor enablement policy instead of this second filter.
+// Read per-call so a process can change it; unknown names are inert.
 export const docsExcludeSet = () => new Set((process.env.PLURNK_SERVICE_DOCS_EXCLUDE ?? "").split(",").map((s) => s.trim()).filter(Boolean));
 //# sourceMappingURL=teaching.js.map

package/dist/core/teaching.js.map

@@ -1 +1 @@
-{"version":3,"file":"teaching.js","sourceRoot":"","sources":["../../src/core/teaching.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,sEAAsE;AACtE,gGAAgG;AAChG,kGAAkG;AAClG,uEAAuE;AACvE,MAAM,CAAC,MAAM,cAAc,GAAG,GAAwB,EAAE,CACpD,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC"}
+{"version":3,"file":"teaching.js","sourceRoot":"","sources":["../../src/core/teaching.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,gFAAgF;AAChF,kFAAkF;AAClF,qEAAqE;AACrE,MAAM,CAAC,MAAM,cAAc,GAAG,GAAwB,EAAE,CACpD,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC"}

package/dist/core/worker-ops.sql

@@ -14,7 +14,7 @@ ORDER BY id DESC LIMIT 1;
 SELECT name FROM workers WHERE id = $worker_id;
 
 -- PREP: worker_deliverable_by_name
--- The newest worker holding this name, with its latest loop's status + exact terminal result — the
+-- The newest worker holding this name, with its live loop or latest-settled terminal result — the
 -- deliverable a sister COLLECTS by READing worker://<name> ({§worker-scheme-collect}, the pull side of
 -- the same deliverable the push delta carries). Non-terminal means the worker has not delivered yet
 -- (READ steers to 202).
@@ -23,21 +23,25 @@ SELECT r.id AS worker_id, l.status, l.terminal_result, l.terminated_by
 FROM workers r
 JOIN loops l ON l.worker_id = r.id
 WHERE r.workspace_id = $workspace_id AND r.name = $name
-ORDER BY r.id DESC, l.sequence DESC
+ORDER BY r.id DESC,
+         CASE WHEN l.status IN (100, 102, 202) THEN 0 ELSE 1 END,
+         CASE WHEN l.status IN (100, 102, 202) THEN l.sequence END DESC,
+         CASE WHEN l.status NOT IN (100, 102, 202) THEN l.terminated_at END DESC,
+         l.id DESC
 LIMIT 1;
 
 -- PREP: worker_live_by_name
--- The newest worker holding this name that is still LIVE (a non-terminal loop, 100/102) —
+-- The newest worker holding this name that is still LIVE (an unresolved loop, 100/102/202) —
 -- the spawn gate's collision check. A hit means the name is in use by a running sister
 -- (refuse: 409); no hit means the name is free or held only by a terminated worker (reclaim).
 SELECT r.id FROM workers r
 JOIN loops l ON l.worker_id = r.id
-WHERE r.workspace_id = $workspace_id AND r.name = $name AND l.status IN (100, 102)
+WHERE r.workspace_id = $workspace_id AND r.name = $name AND l.status IN (100, 102, 202)
 ORDER BY r.id DESC LIMIT 1;
 
 -- PREP: worker_count_active
--- Workers in a workspace with a non-terminal loop (status 100 pending / 102 in-progress)
+-- Workers in a workspace with an unresolved loop (100 pending / 102 in-progress / 202 parked)
 -- — "active" for the PLURNK_SERVICE_WORKSPACE_WORKERS_MAX_ACTIVE ceiling (worker-cap.ts).
 SELECT COUNT(DISTINCT r.id) AS n FROM workers r
 JOIN loops l ON l.worker_id = r.id
-WHERE r.workspace_id = $workspace_id AND l.status IN (100, 102);
+WHERE r.workspace_id = $workspace_id AND l.status IN (100, 102, 202);

package/dist/core/worker-settings.d.ts

@@ -0,0 +1,10 @@
+import type { Db } from "./Db.ts";
+export interface WorkerSettings {
+    readonly requestUserInput: boolean;
+}
+export default class WorkerSettingsReader {
+    static read(db: Db, workerId: number): Promise<WorkerSettings>;
+    static requestUserInputEnabled(db: Db, workerId: number): Promise<boolean>;
+    static toolAvailable(db: Db, workerId: number, runtime: string): Promise<boolean>;
+}
+//# sourceMappingURL=worker-settings.d.ts.map

package/dist/core/worker-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-settings.d.ts","sourceRoot":"","sources":["../../src/core/worker-settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AASlC,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;CACtC;AAID,MAAM,CAAC,OAAO,OAAO,oBAAoB;IACrC,OAAa,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAcnE;IAED,OAAa,uBAAuB,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE/E;IAKD,OAAa,aAAa,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGtF;CACJ"}

package/dist/core/worker-settings.js

@@ -0,0 +1,32 @@
+const DEFAULT_SETTINGS = Object.freeze({ requestUserInput: false });
+export default class WorkerSettingsReader {
+    static async read(db, workerId) {
+        const row = await db.worker_settings_read.get({ id: workerId });
+        if (row === undefined)
+            return DEFAULT_SETTINGS;
+        let parsed;
+        try {
+            parsed = JSON.parse(row.settings);
+        }
+        catch {
+            return DEFAULT_SETTINGS;
+        }
+        if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
+            return DEFAULT_SETTINGS;
+        const r = parsed;
+        return {
+            requestUserInput: r.requestUserInput === true,
+        };
+    }
+    static async requestUserInputEnabled(db, workerId) {
+        return (await WorkerSettingsReader.read(db, workerId)).requestUserInput;
+    }
+    // {§worker-tool-admission} is one predicate shared by discovery and
+    // execution. A tool hidden from a Worker cannot remain guessable through
+    // generated documentation while dispatch rejects it.
+    static async toolAvailable(db, workerId, runtime) {
+        return runtime !== "question"
+            || await WorkerSettingsReader.requestUserInputEnabled(db, workerId);
+    }
+}
+//# sourceMappingURL=worker-settings.js.map

package/dist/core/worker-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-settings.js","sourceRoot":"","sources":["../../src/core/worker-settings.ts"],"names":[],"mappings":"AAaA,MAAM,gBAAgB,GAAmB,MAAM,CAAC,MAAM,CAAC,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC,CAAC;AAEpF,MAAM,CAAC,OAAO,OAAO,oBAAoB;IACrC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAM,EAAE,QAAgB;QACtC,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,oBAAoB,CAAC,GAAG,CAAuB,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACtF,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,gBAAgB,CAAC;QAC/C,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACD,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAY,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,gBAAgB,CAAC;QAC5B,CAAC;QACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,gBAAgB,CAAC;QACpG,MAAM,CAAC,GAAG,MAAwC,CAAC;QACnD,OAAO;YACH,gBAAgB,EAAE,CAAC,CAAC,gBAAgB,KAAK,IAAI;SAChD,CAAC;IACN,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,EAAM,EAAE,QAAgB;QACzD,OAAO,CAAC,MAAM,oBAAoB,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC;IAC5E,CAAC;IAED,oEAAoE;IACpE,yEAAyE;IACzE,qDAAqD;IACrD,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,EAAM,EAAE,QAAgB,EAAE,OAAe;QAChE,OAAO,OAAO,KAAK,UAAU;eACtB,MAAM,oBAAoB,CAAC,uBAAuB,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC5E,CAAC;CACJ"}

package/dist/core/workspace-settings.d.ts

@@ -1,23 +1,14 @@
 import type { Db } from "./Db.ts";
-export type ClientMdDoc = {
-    alias: string;
-    content: string;
-};
+import { type FileCreateScope } from "./file-creation-policy.ts";
 export type WorkspaceOpenContext = {
     filesItems: number | null;
-    mdDocs: ClientMdDoc[];
     maxCommands: number | null;
     git: boolean | null;
+    fileCreateScope: FileCreateScope | null;
     client: string | null;
     execs: Record<string, string> | null;
-    questions: boolean | null;
 };
 export default class WorkspaceSettings {
     static read(db: Db, workspaceId: number): Promise<WorkspaceOpenContext>;
-    static questionsEnabled(db: Db, workspaceId: number): Promise<boolean>;
-    static resolveDocs(clientDocs: ReadonlyArray<ClientMdDoc>): Promise<Array<{
-        entryName: string;
-        content: string;
-    }>>;
 }
 //# sourceMappingURL=workspace-settings.d.ts.map

package/dist/core/workspace-settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-settings.d.ts","sourceRoot":"","sources":["../../src/core/workspace-settings.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAElC,MAAM,MAAM,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAC7D,MAAM,MAAM,oBAAoB,GAAG;IAC/B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACrC,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;CAC7B,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,iBAAiB;IAGlC,OAAa,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAa5E;IAKD,OAAa,gBAAgB,CAAC,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG3E;IAOD,OAAa,WAAW,CAAC,UAAU,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAiBvH;CACJ"}
+{"version":3,"file":"workspace-settings.d.ts","sourceRoot":"","sources":["../../src/core/workspace-settings.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAClC,OAA2B,EAAE,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAErF,MAAM,MAAM,oBAAoB,GAAG;IAC/B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IACpB,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CACxC,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,iBAAiB;IAGlC,OAAa,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAY5E;CAEJ"}

package/dist/core/workspace-settings.js

@@ -1,14 +1,8 @@
 // {§operator-config} — a workspace's client-chosen open context: the per-workspace overrides a client
 // user legitimately sets at workspace.create, read at turn-0 with precedence over env.
-// Two knobs with deliberately different compose semantics:
-//   - filesItems: REPLACE — a single scalar; the client value wins outright over
-//     PLURNK_SERVICE_FILES_ITEMS (0=off / -1=markerless first page / N=file-map first-N).
-//   - mdDocs: UNION — the server env docs (PLURNK_SERVICE_MD_*) and the client's docs ride
-//     together; the systemwide policy doc survives unless the client shadows its alias.
-// Storage is a JSON bag on workspaces.settings (the env mdDocs live in process.env, never
-// the DB, so the union is a TS set-merge regardless — normalizing the column buys nothing).
-import { readFile } from "node:fs/promises";
-import Paths from "../Paths.js";
+// filesItems REPLACES the env value; the other knobs compose per their own tags.
+// Storage is a JSON bag on workspaces.settings.
+import FileCreationPolicy from "./file-creation-policy.js";
 export default class WorkspaceSettings {
     // The workspace's open-context bag. Absent/unset fields read as null / []. A malformed
     // bag never reaches here — workspace.create validates before persisting.
@@ -18,46 +12,12 @@ export default class WorkspaceSettings {
         const filesItems = typeof bag.filesItems === "number" ? bag.filesItems : null;
         const maxCommands = typeof bag.maxCommands === "number" ? bag.maxCommands : null;
         const git = typeof bag.git === "boolean" ? bag.git : null;
+        const fileCreateScope = bag.fileCreateScope === undefined
+            ? null
+            : FileCreationPolicy.parse(bag.fileCreateScope, "settings.fileCreateScope");
         const client = typeof bag.client === "string" ? bag.client : null;
         const execs = (typeof bag.execs === "object" && bag.execs !== null && !Array.isArray(bag.execs)) ? bag.execs : null;
-        const questions = typeof bag.questions === "boolean" ? bag.questions : null;
-        const mdDocs = Array.isArray(bag.mdDocs)
-            ? bag.mdDocs.filter((d) => typeof d?.alias === "string" && typeof d?.content === "string")
-            : [];
-        return { filesItems, mdDocs, maxCommands, git, client, execs, questions };
-    }
-    // {§send-300-choices} — the three-state cascade resolved: ALLOWED servicewide (PLURNK_QUESTIONS
-    // != "0") AND affirmatively REQUESTED by the client for this workspace. One predicate, shared by
-    // the dispatch gate and the teaching injection so capability and teaching can never desync.
-    static async questionsEnabled(db, workspaceId) {
-        if (process.env.PLURNK_QUESTIONS === "0")
-            return false;
-        return (await WorkspaceSettings.read(db, workspaceId)).questions === true;
-    }
-    // The turn-0 reference-doc set: server env docs (PLURNK_SERVICE_MD_*, read from disk) UNION the
-    // workspace's client docs (content), keyed by `<alias>.md`. On alias collision the client
-    // wins before I/O — a shadowed operator path is not selected. An unshadowed configured
-    // path is required and fails causally if unreadable ({§operator-config-workspace-md-docs}).
-    // The set is the single source for BOTH materialization and the Engine turn-0 READ foist.
-    static async resolveDocs(clientDocs) {
-        const clientByEntry = new Map(clientDocs.map(({ alias, content }) => [`${alias}.md`, content]));
-        const byEntry = new Map();
-        for (const { entryName, path } of Paths.docs()) {
-            const clientContent = clientByEntry.get(entryName);
-            if (clientContent !== undefined) {
-                byEntry.set(entryName, clientContent);
-                continue;
-            }
-            try {
-                byEntry.set(entryName, await readFile(path, "utf8"));
-            }
-            catch (cause) {
-                throw new Error(`configured operator reference doc '${entryName}' could not be read`, { cause });
-            }
-        }
-        for (const [entryName, content] of clientByEntry)
-            byEntry.set(entryName, content);
-        return [...byEntry].map(([entryName, content]) => ({ entryName, content }));
+        return { filesItems, maxCommands, git, fileCreateScope, client, execs };
     }
 }
 //# sourceMappingURL=workspace-settings.js.map

package/dist/core/workspace-settings.js.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-settings.js","sourceRoot":"","sources":["../../src/core/workspace-settings.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"workspace-settings.js","sourceRoot":"","sources":["../../src/core/workspace-settings.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,uFAAuF;AACvF,iFAAiF;AACjF,gDAAgD;AAGhD,OAAO,kBAA4C,MAAM,2BAA2B,CAAC;AAWrF,MAAM,CAAC,OAAO,OAAO,iBAAiB;IAClC,uFAAuF;IACvF,yEAAyE;IACzE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAM,EAAE,WAAmB;QACzC,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,sBAAsB,CAAC,GAAG,CAAuB,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC;QACrG,MAAM,GAAG,GAAG,GAAG,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAkI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1M,MAAM,UAAU,GAAG,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9E,MAAM,WAAW,GAAG,OAAO,GAAG,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;QACjF,MAAM,GAAG,GAAG,OAAO,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1D,MAAM,eAAe,GAAG,GAAG,CAAC,eAAe,KAAK,SAAS;YACrD,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,EAAE,0BAA0B,CAAC,CAAC;QAChF,MAAM,MAAM,GAAG,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;QAClE,MAAM,KAAK,GAAG,CAAC,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,IAAI,GAAG,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,KAAgC,CAAC,CAAC,CAAC,IAAI,CAAC;QAChJ,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC5E,CAAC;CAEJ"}

package/dist/digest/Digest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Digest.d.ts","sourceRoot":"","sources":["../../src/digest/Digest.ts"],"names":[],"mappings":";AAoDA,OAAO,EAKH,KAAK,QAAQ,EAKhB,MAAM,0BAA0B,CAAC;AA4MlC,UAAU,aAAa;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AA2BD,MAAM,CAAC,OAAO,OAAO,MAAM;;IAifvB,MAAM,CAAC,aAAa,IAAI,MAAM,CAO7B;IAID,OAAa,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAqPxJ;IAED,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAIpC;CAoKJ"}
+{"version":3,"file":"Digest.d.ts","sourceRoot":"","sources":["../../src/digest/Digest.ts"],"names":[],"mappings":";AAmDA,OAAO,EAKH,KAAK,QAAQ,EAKhB,MAAM,0BAA0B,CAAC;AA6OlC,UAAU,aAAa;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AA2BD,MAAM,CAAC,OAAO,OAAO,MAAM;;IA0hBvB,MAAM,CAAC,aAAa,IAAI,MAAM,CAM7B;IAID,OAAa,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAsPxJ;IAED,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAIpC;CA2MJ"}