@plurnk/plurnk-service 1.17.0 → 1.19.0

package/dist/server/EnvFunctionality.js

@@ -0,0 +1,199 @@
+import { MetadataOptions } from "@plurnk/plurnk-schemes";
+import EnvCatalog from "../core/env-catalog.js";
+import EnvDefaults from "../core/env-defaults.js";
+import Results, { OperationFailureError } from "../core/results.js";
+import ExecEnv from "../schemes/exec-env.js";
+import Paths from "../Paths.js";
+export const ENV_FAMILY = "env";
+// The family's namespace owner — also the key a spawn reads its Worker's state under.
+export const ENV_OWNER = "@plurnk/plurnk-service";
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+// A refusal is the verb's own operation result, the shape both projections convert; anything else
+// thrown here would surface as a fault of the action or the manager rather than as the outcome.
+const actionError = (code, status, detail, extensions = {}) => new OperationFailureError(Results.failure("env:functionality", code, status, detail, {}, { family: ENV_FAMILY, retryable: false, ...extensions }));
+// POSIX-ish, and deliberately narrow: a name the shell can actually export. This is the family's
+// alias grammar ({§functionality-adapter}) — the alias IS the variable name, and case is semantic.
+const NAME = /^[A-Za-z_][A-Za-z0-9_]*$/u;
+// One variable. The alias IS the name, so the definition carries only what the name does not.
+const DEFINITION = {
+    type: "object",
+    additionalProperties: false,
+    required: ["value"],
+    properties: {
+        value: { type: "string", description: "The exact value, used verbatim. No interpolation, no escapes." },
+    },
+};
+export default class EnvFunctionality {
+    family = ENV_FAMILY;
+    namespaceOwner = ENV_OWNER;
+    summary = "Read and shape the environment your commands run in";
+    definitionSchema = DEFINITION;
+    scopes = ["worker", "workspace"];
+    aliasPattern = NAME;
+    docsDir = Paths.packageRoot;
+    example = { alias: "CARGO_TARGET_DIR", definition: { value: "/tmp/shared" } };
+    discovery = {
+        details: "`discover` is this installation's configuration catalog: every name an installed "
+            + "package declares that you may set, with the declaring package as provenance and its own "
+            + "comment as the summary; plurnk's own names never appear. `query` matches a name or the "
+            + "comment that documents it; `source` selects one owning package; an empty body is the "
+            + "whole catalog, which is short — start there. It is how you learn which names have a "
+            + "consumer, and how you learn the name of a value only the operator can supply.",
+    };
+    #defaults;
+    constructor(defaults) {
+        this.#defaults = defaults;
+    }
+    // Service origin: every ambient name the operator's ceiling admits, exactly as a
+    // service-declared MCP server is a service definition. A Worker may disable one for itself
+    // — that is how `CI=1` goes away for one Worker without the operator changing anything.
+    //
+    // Values are projected because the ceiling is the security boundary, not this projection:
+    // anything admitted is already readable by any command the Worker runs. Withholding it here
+    // would be theatre, and would make `list` lie about the environment its commands see.
+    async available(_identity) {
+        return Object.entries(ExecEnv.scoped())
+            .map(([alias, value]) => ({ alias, definition: { value: value ?? "" }, enabled: true }))
+            .toSorted((left, right) => left.alias.localeCompare(right.alias));
+    }
+    async discover(query, _identity) {
+        if (query.configuration !== undefined) {
+            // A client's own environment contributing candidates would be a second door into the
+            // cascade, past the operator's ceiling. The refusal is the same shape Agent Skills uses.
+            throw actionError("configuration-unsupported", 400, "Environment discovery reads this installation's declared configuration; client configuration contributes nothing.", { retryable: false });
+        }
+        // The catalog is filtered to what a Worker may set (#586, the converged shape): plurnk's own
+        // configuration and provider credential names are the operator's, refused by `add`, and would
+        // only bury the few names that matter under the operator's knobs.
+        const reserved = ExecEnv.ownSecretTest();
+        return EnvCatalog.candidates(await this.#defaults(), {
+            ...(query.query === undefined ? {} : { query: query.query }),
+            ...(query.source === undefined ? {} : { source: query.source }),
+        }).filter(({ alias }) => !reserved(alias));
+    }
+    async admit(input, _identity) {
+        const record = input;
+        const alias = typeof record.alias === "string" ? record.alias : "";
+        if (!NAME.test(alias)) {
+            throw actionError("name-invalid", 400, `'${alias}' is not a name a shell can export.`, { retryable: false });
+        }
+        // The invariant, refused at admission rather than silently at the spawn: a name the model
+        // writes here would otherwise be dropped when the environment composes, and it would never
+        // learn why. {§exec-env-scoped} strips these unconditionally at every layer.
+        if (ExecEnv.ownSecretTest()(alias)) {
+            throw actionError("name-reserved", 400, `'${alias}' is plurnk's own: PLURNK_* configuration and provider credential names never reach a subprocess.`, { retryable: false });
+        }
+        const definition = record.definition;
+        if (typeof definition?.value !== "string") {
+            throw actionError("value-invalid", 400, `'${alias}' needs a string value.`, { retryable: false });
+        }
+        return { alias, definition: { value: definition.value } };
+    }
+    // Nothing is launched, so nothing can fail to launch: every enabled definition is active and
+    // there is no snapshot to tear down. The environment is read at the spawn that uses it
+    // ({§exec-env-scoped}), never held resident — which is why this family publishes no runtimes.
+    async prepare(preparation) {
+        const outcomes = new Map([...preparation.enabled.keys()].map((alias) => [alias, { state: "active" }]));
+        return {
+            documents: [], outcomes, snapshot: null,
+            commit: async () => undefined,
+            abort: async () => undefined,
+        };
+    }
+    async teardown(_snapshot, _identity) {
+        return undefined;
+    }
+    static defaultsReader(projectRoot, pluginsNodeModules) {
+        let cached;
+        return async () => cached ??= await EnvDefaults.collect(projectRoot, pluginsNodeModules);
+    }
+    // {§workspace-env} Apply one persisted layer and record the provenance beside its values.
+    static compose(ambient, state, modifier = {}, scope = "worker") {
+        if (!isRecord(state) || state.version !== 1 || !isRecord(state.definitions))
+            throw new Error("env state is not a version 1 record");
+        const env = { ...ambient };
+        const record = {};
+        let reserved;
+        for (const [name, entry] of Object.entries(state.definitions)) {
+            if (!isRecord(entry) || typeof entry.enabled !== "boolean")
+                throw new Error(`env state for '${name}' is malformed`);
+            const from = typeof entry.inherited === "string" ? { from: entry.inherited } : {};
+            if (!entry.enabled) {
+                delete env[name];
+                record[name] = { source: "masked", ...from };
+                continue;
+            }
+            if (entry.origin === "service" || (scope === "worker" && entry.origin === "workspace"))
+                continue;
+            if (entry.origin !== scope)
+                throw new Error(`env state for '${name}' has origin '${String(entry.origin)}'`);
+            if (!isRecord(entry.definition) || typeof entry.definition.value !== "string")
+                throw new Error(`env state for '${name}' holds no string value`);
+            reserved ??= ExecEnv.ownSecretTest();
+            if (reserved(name)) {
+                record[name] = { source: "masked" };
+                continue;
+            }
+            env[name] = entry.definition.value;
+            record[name] = { source: scope, ...from, value: entry.definition.value };
+        }
+        // {§env-option} — the op's own environment, nearest the spawn; admitted by name already.
+        for (const [name, value] of Object.entries(modifier)) {
+            reserved ??= ExecEnv.ownSecretTest();
+            if (reserved(name))
+                throw new Error(`env modifier names plurnk's own '${name}' past admission`);
+            env[name] = value;
+            record[name] = { source: "modifier", value };
+        }
+        for (const [name, value] of Object.entries(env)) {
+            if (record[name] === undefined && value !== undefined)
+                record[name] = { source: "host", value };
+        }
+        return { env, record };
+    }
+    // {§workspace-env} Both execution and capability startup read these same persisted layers.
+    static async workspace(db, workspaceId) {
+        const row = await db.workspace_module_state_get.get({ workspace_id: workspaceId, namespace_owner: ENV_OWNER });
+        const state = row === undefined ? { version: 1, definitions: {} } : JSON.parse(row.state);
+        return (ambient = ExecEnv.scoped()) => this.compose(ambient, state, {}, "workspace");
+    }
+    static async resolve(db, workspaceId, workerId, modifier = {}, ambient = ExecEnv.scoped()) {
+        const empty = { version: 1, definitions: {} };
+        const shared = (await this.workspace(db, workspaceId))(ambient);
+        const worker = workerId === undefined ? undefined : await db.worker_module_state_get.get({ worker_id: workerId, namespace_owner: ENV_OWNER });
+        const result = this.compose(shared.env, worker === undefined ? empty : JSON.parse(worker.state), modifier);
+        return { env: result.env, record: { ...shared.record, ...Object.fromEntries(Object.entries(result.record).filter(([, item]) => item.source !== "host")) } };
+    }
+    // {§env-option} — the heading's `env` option, read through the one metadata reader and admitted
+    // by the family's own rules: an object of string values under names a shell can export, never
+    // plurnk's own. A refusal names the key and the reason, so the model learns why, exactly as `add`
+    // refuses. A block that is not the array shape carries no `env` for the service to read: it is
+    // the invoked executor's to accept or refuse ({§scheme-metadata-modifier}), as `pattern` is
+    // lifted only from a block that parses.
+    static modifier(metadata, source = "env:functionality") {
+        const read = MetadataOptions.parse(metadata, source);
+        if ("failure" in read)
+            return Object.freeze({});
+        return EnvFunctionality.environment(read.env);
+    }
+    static environment(raw) {
+        if (raw === undefined)
+            return Object.freeze({});
+        if (!isRecord(raw))
+            throw actionError("env-invalid", 400, "`env` must be an object of string values.", { retryable: false });
+        const reserved = ExecEnv.ownSecretTest();
+        const out = {};
+        for (const [name, value] of Object.entries(raw)) {
+            if (!NAME.test(name))
+                throw actionError("name-invalid", 400, `'${name}' is not a name a shell can export.`, { alias: name, retryable: false });
+            if (reserved(name)) {
+                throw actionError("name-reserved", 400, `'${name}' is plurnk's own: PLURNK_* configuration and provider credential names never reach a subprocess.`, { alias: name, retryable: false });
+            }
+            if (typeof value !== "string")
+                throw actionError("value-invalid", 400, `'${name}' needs a string value.`, { alias: name, retryable: false });
+            out[name] = value;
+        }
+        return Object.freeze(out);
+    }
+}
+//# sourceMappingURL=EnvFunctionality.js.map

package/dist/server/EnvFunctionality.js.map

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

package/dist/server/Functionality.d.ts

@@ -1,10 +1,12 @@
-import type { FunctionalityAdapter, FunctionalityCaller, FunctionalityFamilyHandle, ModuleActionRegistration, WorkspaceCapabilityIdentity, WorkspaceCapabilityGate, WorkspaceCapabilityProvider, WorkspaceCapabilityReplacement, WorkspaceCapabilityPublication } from "./DaemonModule.ts";
+import type { FunctionalityAdapter, FunctionalityCaller, FunctionalityFamilyHandle, FunctionalityIdentity, FunctionalityOptions, ModuleActionRegistration, WorkspaceCapabilityIdentity, WorkspaceCapabilityGate, WorkspaceCapabilityProvider, WorkspaceCapabilityReplacement, WorkspaceCapabilityPublication } from "./DaemonModule.ts";
 import { type FunctionalityVerb } from "./FunctionalityManager.ts";
 export interface FunctionalityHost {
     registerModuleAction(registration: ModuleActionRegistration): void;
     registerWorkspaceCapabilityProvider(namespaceOwner: string, provider: WorkspaceCapabilityProvider): void;
     readWorkspaceModuleState(workspaceId: number, namespaceOwner: string): Promise<unknown | null>;
     replaceWorkspaceCapabilities(replacement: WorkspaceCapabilityReplacement, options?: WorkspaceCapabilityPublication): Promise<void>;
+    readWorkerModuleState(workerId: number, namespaceOwner: string): Promise<unknown | null>;
+    replaceWorkerModuleState(workerId: number, namespaceOwner: string, state: unknown | null): Promise<void>;
     mutateWorkspace<T>(workspaceId: number, namespaceOwner: string, caller: FunctionalityCaller, run: () => Promise<T>): Promise<T>;
     retainWorkspace(workspaceId: number): () => void;
 }
@@ -26,6 +28,6 @@ export default class Functionality {
         pathname: string;
         content: string;
     }>;
-    invoke(family: string, verb: FunctionalityVerb, params: unknown, identity: WorkspaceCapabilityIdentity, caller: FunctionalityCaller): Promise<FunctionalityInvocation>;
+    invoke(family: string, verb: FunctionalityVerb, params: unknown, identity: FunctionalityIdentity, caller: FunctionalityCaller, options?: FunctionalityOptions): Promise<FunctionalityInvocation>;
 }
 //# sourceMappingURL=Functionality.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Functionality.d.ts","sourceRoot":"","sources":["../../src/server/Functionality.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACR,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EAGzB,wBAAwB,EAExB,2BAA2B,EAC3B,uBAAuB,EACvB,2BAA2B,EAC3B,8BAA8B,EAC9B,8BAA8B,EACjC,MAAM,mBAAmB,CAAC;AAC3B,OAA6B,EAGzB,KAAK,iBAAiB,EACzB,MAAM,2BAA2B,CAAC;AAInC,MAAM,WAAW,iBAAiB;IAC9B,oBAAoB,CAAC,YAAY,EAAE,wBAAwB,GAAG,IAAI,CAAC;IACnE,mCAAmC,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,2BAA2B,GAAG,IAAI,CAAC;IACzG,wBAAwB,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC/F,4BAA4B,CACxB,WAAW,EAAE,8BAA8B,EAC3C,OAAO,CAAC,EAAE,8BAA8B,GACzC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,eAAe,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAChI,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;CACpD;AAMD,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC,MAAM,WAAW,uBAAuB;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CAC1B;AAyDD,MAAM,CAAC,OAAO,OAAO,aAAa;;IAQ9B,YAAY,IAAI,EAAE,iBAAiB,EAElC;IAID,QAAQ,CAAC,OAAO,EAAE,oBAAoB,GAAG,yBAAyB,CA0DjE;IAOK,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,2BAA2B,EAAE,OAAO,GAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,uBAAuB,CAAA;KAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAW7I;IAED,QAAQ,IAAI,MAAM,EAAE,CAEnB;IAIK,MAAM,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhD;IAmBD,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAS3E;IAGK,MAAM,CACR,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,2BAA2B,EACrC,MAAM,EAAE,mBAAmB,GAC5B,OAAO,CAAC,uBAAuB,CAAC,CAoBlC;CAoRJ"}
+{"version":3,"file":"Functionality.d.ts","sourceRoot":"","sources":["../../src/server/Functionality.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACR,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EAGpB,wBAAwB,EAExB,2BAA2B,EAC3B,uBAAuB,EACvB,2BAA2B,EAC3B,8BAA8B,EAC9B,8BAA8B,EACjC,MAAM,mBAAmB,CAAC;AAC3B,OAA6B,EAGzB,KAAK,iBAAiB,EACzB,MAAM,2BAA2B,CAAC;AAInC,MAAM,WAAW,iBAAiB;IAC9B,oBAAoB,CAAC,YAAY,EAAE,wBAAwB,GAAG,IAAI,CAAC;IACnE,mCAAmC,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,2BAA2B,GAAG,IAAI,CAAC;IACzG,wBAAwB,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC/F,4BAA4B,CACxB,WAAW,EAAE,8BAA8B,EAC3C,OAAO,CAAC,EAAE,8BAA8B,GACzC,OAAO,CAAC,IAAI,CAAC,CAAC;IAGjB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACzF,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzG,eAAe,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAChI,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;CACpD;AAMD,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC,MAAM,WAAW,uBAAuB;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CAC1B;AAqED,MAAM,CAAC,OAAO,OAAO,aAAa;;IAQ9B,YAAY,IAAI,EAAE,iBAAiB,EAElC;IAID,QAAQ,CAAC,OAAO,EAAE,oBAAoB,GAAG,yBAAyB,CA6EjE;IAOK,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,2BAA2B,EAAE,OAAO,GAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,uBAAuB,CAAA;KAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAW7I;IAED,QAAQ,IAAI,MAAM,EAAE,CAEnB;IAIK,MAAM,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhD;IAmBD,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAS3E;IAGK,MAAM,CACR,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,qBAAqB,EAC/B,MAAM,EAAE,mBAAmB,EAC3B,OAAO,GAAE,oBAAyB,GACnC,OAAO,CAAC,uBAAuB,CAAC,CAkClC;CA2ZJ"}