@plurnk/plurnk-service 1.3.12 → 1.4.0

package/dist/core/ProviderInstantiate.js

@@ -5,16 +5,18 @@
 //
 // The pure helpers (parseAliasesFromEnv, resolveActiveAlias) live in
 // @plurnk/plurnk-providers as framework-grade env parsing.
-import { instantiateProvider as instantiateFrameworkProvider, resolveActiveAlias, scopeEnvToAlias } from "@plurnk/plurnk-providers";
+import { instantiateProvider as instantiateFrameworkProvider, PROVIDERS_KNOBS, resolveActiveAlias, scopeEnvToAlias } from "@plurnk/plurnk-providers";
 export default class ProviderInstantiate {
     // One provider per (provider, model, baseUrl) for the process lifetime: a provider is
-    // stateless per the contract, and loop.run instantiating fresh per aliased call re-probed
+    // stateless per the contract, and runLoop instantiating fresh per aliased call re-probed
     // the backend (latency) and re-fired providers' construction warnings on every loop (the
-    // owner's boot log: one heuristic warning per loop.run). Cache keyed on the wire identity;
+    // owner's boot log: one heuristic warning per runLoop request). Cache keyed on the wire identity;
     // env is process-stable for these fields.
     static #instances = new Map();
-    // #352 — provider handle → the alias name that produced it, so the service scopes its OWN
-    // per-alias partition knobs (PLURNK_SERVICE_*_<alias>) by the provider it's building a packet
+    static #registeredInstances = new Map();
+    // {§provider-instantiation-alias-resolution} — provider handle → the alias name that produced it,
+    // so the service scopes its own
+    // per-alias packet-policy knobs by the provider it's building a packet
     // for. Service-owned metadata about handles WE created; never a provider-contract field.
     static #aliasByProvider = new WeakMap();
     // The alias name a provider was built under, or undefined (a test Mock, a hand-built handle).
@@ -22,7 +24,8 @@ export default class ProviderInstantiate {
     static aliasOf(provider) {
         return ProviderInstantiate.#aliasByProvider.get(provider);
     }
-    // #488 — register a hand-built provider (a recording Mock) under an alias, so tests can
+    // {§grammar-enforcement-verified-at-boot} — register a hand-built provider (a recording Mock)
+    // under an alias, so tests can
     // drive the per-alias grammar-rail resolution through the REAL chain instead of the
     // boot-global fallback the silent-severance guard now refuses.
     static registerAlias(provider, alias) {
@@ -34,11 +37,14 @@ export default class ProviderInstantiate {
     // lookup behavior when a persisted loop resumes.
     static registerInstance(provider, spec) {
         ProviderInstantiate.#aliasByProvider.set(provider, spec.alias);
-        ProviderInstantiate.#instances.set(`${spec.provider}|${spec.model}|${spec.baseUrl ?? ""}`, Promise.resolve(provider));
+        ProviderInstantiate.#registeredInstances.set(ProviderInstantiate.#identityKey(spec), provider);
     }
     static async instantiateProvider(alias, env = process.env) {
         if (env === process.env) {
-            const key = `${alias.provider}|${alias.model}|${alias.baseUrl ?? ""}`;
+            const registered = ProviderInstantiate.#registeredInstances.get(ProviderInstantiate.#identityKey(alias));
+            if (registered !== undefined)
+                return registered;
+            const key = ProviderInstantiate.#cacheKey(alias, env);
             let cached = ProviderInstantiate.#instances.get(key);
             if (cached === undefined) {
                 cached = ProviderInstantiate.#instantiate(alias, env);
@@ -49,42 +55,36 @@ export default class ProviderInstantiate {
         }
         return ProviderInstantiate.#instantiate(alias, env); // custom env (tests) — never cached
     }
+    static #identityKey(alias) {
+        return `${alias.alias}|${alias.provider}|${alias.model}|${alias.baseUrl ?? ""}`;
+    }
+    static #cacheKey(alias, env) {
+        const scoped = scopeEnvToAlias(env, alias.alias);
+        const tuning = PROVIDERS_KNOBS.map((name) => [name, scoped[name] ?? ""]);
+        return `${ProviderInstantiate.#identityKey(alias)}|${JSON.stringify(tuning)}`;
+    }
     static async #instantiate(alias, env) {
         const provider = await ProviderInstantiate.#construct(alias, env);
         ProviderInstantiate.#aliasByProvider.set(provider, alias.alias);
         return provider;
     }
     static async #construct(alias, env) {
-        // #525 — promote the alias-scoped provider-knob family (PLURNK_PROVIDERS_*_<alias>) to
+        // {§operator-config-precedence} — promote the alias-scoped provider-knob family
+        // (PLURNK_PROVIDERS_*_<alias>) to
         // bare BEFORE construction, so a per-alias TEMPERATURE/reserve pin binds. Without this
         // the whole per-alias provider surface was silently dropped at construction.
         env = scopeEnvToAlias(env, alias.alias);
-        // #528 — the CONTEXT_WINDOW pin is CORE's log-budget cap, never the provider's window:
-        // strip it so the provider reports its NATURAL window (probe/served) and percent reserves
-        // resolve off nature. PacketBuilder mins the cap into the prompt budget alone.
-        const cap = env.PLURNK_PROVIDERS_CONTEXT_WINDOW;
-        delete env.PLURNK_PROVIDERS_CONTEXT_WINDOW; // env is scopeEnvToAlias's copy — the caller's is untouched
-        const provider = await ProviderInstantiate.#constructWith(alias, env);
-        // #419 — a pinned UNPOLLABLE window: no natural exists, so the pin DECLARES the window
-        // (reserves resolve off the declaration — there is no separate nature to protect).
-        // Reconstruct once, probe skipped: the pin is the window, deterministically.
-        if (provider.contextWindow === null && cap !== undefined) {
-            return ProviderInstantiate.#constructWith(alias, { ...env, PLURNK_PROVIDERS_CONTEXT_WINDOW: cap, PLURNK_PROVIDERS_PROBE_NCTX: "0" });
-        }
-        return provider;
+        return ProviderInstantiate.#constructWith(alias, env);
     }
     static async #constructWith(alias, env) {
         return instantiateFrameworkProvider(alias.provider, env, alias.model, undefined, undefined, alias.baseUrl, 
         // #construct already materialized the alias-scoped environment.
-        // Passing the alias here would scope it a second time and restore
-        // the CONTEXT_WINDOW pin that core deliberately removed as a
-        // prompt-only cap.
         undefined);
     }
     // Convenience: resolve + instantiate in one call. Returns null when no
     // PLURNK_MODEL is set (caller decides what 'no provider' means).
     static async loadActiveProvider(env = process.env) {
-        const alias = resolveActiveAlias(env); // the active provider alias resolves from PLURNK_MODEL — §provider-instantiation-alias-resolution
+        const alias = resolveActiveAlias(env); // the active provider alias resolves from PLURNK_MODEL — {§provider-instantiation-alias-resolution}
         if (alias === null)
             return null;
         const provider = await ProviderInstantiate.instantiateProvider(alias, env);
@@ -95,48 +95,51 @@ export default class ProviderInstantiate {
     // that the provider both claims the capability and enforces a forcing grammar.
     // Endpoint-owned settings are outside this knob and outside this verification.
     static #VERIFY_TOKEN = "PLURNK-RAILS-LIVE";
+    static #VERIFY_REASONING = "verify";
+    static #VERIFY_PREFIX = `<|channel>thought\n${ProviderInstantiate.#VERIFY_REASONING}<channel|>`;
+    static #VERIFY_INPUT = `${ProviderInstantiate.#VERIFY_PREFIX}${ProviderInstantiate.#VERIFY_TOKEN}`;
     static async verifyGrammarEnforcement(provider, env = process.env) {
-        // #353 — resolve GBNF PER ALIAS, exactly as Engine.#grammarConstraint does. The per-alias
-        // move (#352) left this reading the BARE knob (now empty by default), so the boot verify
-        // was SILENTLY SKIPPED for every alias whose grammar rides a suffix (turboderp) — the rails
-        // ran UNVERIFIED, the #34 hole this method exists to close reopened. The alias is the one
-        // that built this provider (the side-table), falling back to the active alias.
+        // {§grammar-enforcement-verified-at-boot}: resolve through the provider's registered alias,
+        // with the active alias
+        // retained only for the boot-global fallback.
         const alias = ProviderInstantiate.aliasOf(provider) ?? resolveActiveAlias(env)?.alias ?? "";
-        const gbnf = scopeEnvToAlias(env, alias, ["PLURNK_PROVIDERS_GBNF"]).PLURNK_PROVIDERS_GBNF;
+        const scoped = scopeEnvToAlias(env, alias, ["PLURNK_PROVIDERS_GBNF", "PLURNK_PROVIDERS_REASONING"]);
+        const gbnf = scoped.PLURNK_PROVIDERS_GBNF;
         if (gbnf === undefined || gbnf === "" || gbnf === "0")
             return; // rails not requested — nothing to verify
+        if (scoped.PLURNK_PROVIDERS_REASONING === "off") {
+            throw new Error(`PLURNK_PROVIDERS_GBNF=${gbnf} is invalid with PLURNK_PROVIDERS_REASONING=off: the PLURNK GBNF requires reasoning to be adaptive or on ({§gbnf-requires-reasoning}).`);
+        }
         if (provider.constrainsOutput !== true) {
             throw new Error(`PLURNK_PROVIDERS_GBNF=${gbnf} configures local constrained sampling, but '${provider.model}' does not advertise GBNF transport. `
                 + `Configure this knob only for a supported local llama-server; endpoint-managed constraints require no service-side GBNF setting. `
                 + `If this is a llama-server, set PLURNK_PROVIDERS_LLAMA_SERVER_<alias>=1 when automatic detection is unavailable.`);
         }
-        const forcing = `root ::= "${ProviderInstantiate.#VERIFY_TOKEN}"`;
-        let content;
+        const forcing = `root ::= ${JSON.stringify(ProviderInstantiate.#VERIFY_INPUT)}`;
+        let response;
         try {
-            const res = await provider.generate({
+            response = await provider.generate({
                 messages: [{ role: "user", content: "ok" }],
-                workerId: "gbnf-enforcement-verify", grammar: forcing, maxTokens: 16,
+                workerId: "gbnf-enforcement-verify", grammar: forcing, maxTokens: 32,
             });
-            // llama-server sometimes renders the end-of-sequence token as literal text after the
-            // forced string ("PLURNK-RAILS-LIVE<eos>") — that IS proof of enforcement (the grammar
-            // matched exactly, then the sampler stopped); strip one trailing eos-ish marker.
-            content = res.assistant.content.trim().replace(/(<eos>|<\/s>|<\|eot_id\|>|<\|endoftext\|>|<end_of_turn>)\s*$/, "").trim();
         }
         catch (cause) {
-            // The probe REQUEST was rejected (not "rails came back unconstrained"). This is loud, not
-            // the silent-off failure the verify guards against — and it will recur on every real turn,
-            // so refuse legibly and name the likely cause. The classic one: the provider sends a
-            // reasoning parameter the model rejects (a non-reasoning model + PLURNK_PROVIDERS_REASONING
-            // defaulting on → OpenAI 400 "does not support parameter reasoningEffort").
+            // A rejected probe request is distinct from a completed unconstrained response.
             const detail = cause instanceof Error ? cause.message : String(cause);
             throw new Error(`grammar enforcement verification could not COMPLETE its probe against '${provider.model}' (PLURNK_PROVIDERS_GBNF=${gbnf}) — the model REJECTED the probe request. `
                 + `This is a request/config incompatibility, NOT proof the rails are dark (and it would fail every real turn too). `
-                + `Most common cause: the model does not accept a parameter the provider sends — e.g. a reasoning param on a non-reasoning model; set PLURNK_PROVIDERS_REASONING=off (or the model-appropriate posture). `
+                + `The configured rail requires a reasoning-capable model and a compatible adaptive/on reasoning posture. `
                 + `Refusing to boot until the request the daemon sends is one the model accepts. Probe error: ${detail}`, { cause });
         }
-        if (content !== ProviderInstantiate.#VERIFY_TOKEN) {
+        const evidence = response.grammarEvidence;
+        if (evidence === undefined) {
+            throw new Error(`GBNF enforcement failed: '${provider.model}' did not return grammar evidence for the forcing probe. `
+                + `The service cannot verify the pre-projection sentence and refuses to boot.`);
+        }
+        const input = evidence.input.replace(/(<eos>|<\/s>|<\|eot_id\|>|<\|endoftext\|>|<end_of_turn>)$/, "");
+        if (!evidence.transported || input !== ProviderInstantiate.#VERIFY_INPUT) {
             throw new Error(`GBNF enforcement failed: PLURNK_PROVIDERS_GBNF=${gbnf} requests constrained sampling, but '${provider.model}' returned unconstrained output to a forcing grammar `
-                + `(expected ${JSON.stringify(ProviderInstantiate.#VERIFY_TOKEN)}, got ${JSON.stringify(content.slice(0, 40))}). `
+                + `(expected ${JSON.stringify(ProviderInstantiate.#VERIFY_INPUT)}, got ${JSON.stringify(input.slice(0, 80))}; transported=${evidence.transported}). `
                 + `Refusing to boot because the configured local constraint was not enforced. `
                 + `Check the llama-server capability or remove the PLURNK_PROVIDERS_GBNF setting.`);
         }

package/dist/core/ProviderInstantiate.js.map

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

package/dist/core/SchemeRegistry.d.ts

@@ -1,34 +1,40 @@
 import { type WebFetch } from "../schemes/Exec.ts";
 import type { LoopFlags } from "./types.ts";
-import type { PacketSection } from "./packet-wire.ts";
+import { type PacketSectionDraft } from "@plurnk/plurnk-schemes";
 import type { SchemeManifest } from "./scheme-types.ts";
 import type ExecutorRegistry from "./ExecutorRegistry.ts";
-import type { Executor } from "./ExecutorRegistry.ts";
+import type { Executor, RuntimeNamespaceOwner } from "./ExecutorRegistry.ts";
 import type { CoreSchemeServices } from "./CoreSchemeServices.ts";
+import type { RuntimeSchemeFacet } from "../server/DaemonModule.ts";
+import { type PluginAttribution, type PluginAttributionContext } from "@plurnk/plurnk-meta";
+import { type ReadTeaching } from "./teaching-corpus.ts";
 export default class SchemeRegistry {
     #private;
     constructor(opts?: {
         fetchWeb?: WebFetch;
+        readTeaching?: ReadTeaching;
     });
     register(name: string, handler: object): void;
     bindCore(services: CoreSchemeServices): void;
     registerRuntimeSchemes(executors: ExecutorRegistry): void;
-    registerRuntimeScheme(tag: string, executor: Executor): void;
+    registerRuntimeScheme(tag: string, executor: Executor, owner: RuntimeNamespaceOwner, facet?: RuntimeSchemeFacet, sameOwnerRescan?: boolean): void;
+    assertRuntimeClaim(tag: string, owner: RuntimeNamespaceOwner): void;
     get(name: string): object | undefined;
     has(name: string): boolean;
     manifestFor(name: string): SchemeManifest | undefined;
     list(): string[];
     ready(): Promise<void>;
     close(): Promise<void>;
-    defaultChannelFor(scheme: string | null): string;
+    defaultChannelFor(scheme: string): string;
     teach(): string;
-    docs(): Array<{
+    docs(): Promise<Array<{
         name: string;
         content: string;
-    }>;
-    transformSections(sections: PacketSection[]): Promise<PacketSection[]>;
+    }>>;
+    questionsDoc(): Promise<string>;
+    transformSections(sections: PacketSectionDraft[]): Promise<PacketSectionDraft[]>;
     discoverExternal(cwd?: string): Promise<void>;
-    attributions(): string[];
+    attributions(context: PluginAttributionContext): PluginAttribution;
     resolveForLoop(flags: LoopFlags): Set<string>;
 }
 //# sourceMappingURL=SchemeRegistry.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SchemeRegistry.d.ts","sourceRoot":"","sources":["../../src/core/SchemeRegistry.ts"],"names":[],"mappings":"AACA,OAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAMzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAA4B,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGlF,OAAO,KAAK,gBAAgB,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAKtD,OAAO,KAAK,EAAqB,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAcrF,MAAM,CAAC,OAAO,OAAO,cAAc;;IAe/B,YAAY,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,QAAQ,CAAA;KAAE,EAezC;IAED,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAK5C;IAED,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAM3C;IAOD,sBAAsB,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAMxD;IAOD,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAQ3D;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAqC;IAE1E,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAqC;IAE/D,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAGpD;IAED,IAAI,IAAI,MAAM,EAAE,CAAkD;IAK5D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAM3B;IAIK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAM3B;IAID,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAI/C;IAWD,KAAK,IAAI,MAAM,CAad;IAID,IAAI,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAW/C;IAOK,iBAAiB,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAO3E;IASK,gBAAgB,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBjE;IAID,YAAY,IAAI,MAAM,EAAE,CAAoC;IAI5D,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,CAE5C;CACJ"}
+{"version":3,"file":"SchemeRegistry.d.ts","sourceRoot":"","sources":["../../src/core/SchemeRegistry.ts"],"names":[],"mappings":"AACA,OAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAMzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAIH,KAAK,kBAAkB,EAG1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,KAAK,gBAAgB,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE7E,OAAO,KAAK,EAAqB,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAa,EAET,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAChC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAQ7E,MAAM,CAAC,OAAO,OAAO,cAAc;;IAsB/B,YAAY,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC;QAAC,YAAY,CAAC,EAAE,YAAY,CAAA;KAAE,EAYtE;IAED,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAG5C;IA6DD,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAM3C;IAOD,sBAAsB,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAMxD;IAKD,qBAAqB,CACjB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,qBAAqB,EAC5B,KAAK,CAAC,EAAE,kBAAkB,EAC1B,eAAe,UAAQ,GACxB,IAAI,CAON;IAED,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAElE;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAqC;IAE1E,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAqC;IAE/D,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAGpD;IAED,IAAI,IAAI,MAAM,EAAE,CAAkD;IAI5D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAa3B;IAIK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAmB3B;IAID,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAExC;IAWD,KAAK,IAAI,MAAM,CAad;IAYK,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAY9D;IAED,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAG9B;IAGK,iBAAiB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAWrF;IASK,gBAAgB,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBjE;IAID,YAAY,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CAQjE;IAID,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,CAE5C;CACJ"}