@plurnk/plurnk-service 1.8.0 → 1.9.0

package/dist/server/Functionality.js

@@ -0,0 +1,422 @@
+var _a;
+// {§functionality-coordinator} — the one owner of the Worker Functionality
+// lifecycle above the family adapters (Agent Skills, MCP, outbound A2A). It owns
+// durable per-Worker state, lifecycle ordering, serialization, atomic
+// publication, and both projections: worker-scoped client actions and a
+// per-Worker generated executor family whose host verbs propose. An explicit
+// client mutation and an accepted model proposal converge on `invoke`.
+import { Validator } from "@plurnk/plurnk-contracts";
+import FunctionalityManager, { FUNCTIONALITY_VERBS, functionalityRuntimeDecl, } from "./FunctionalityManager.js";
+import Results, { OperationFailureError } from "../core/results.js";
+import { generatedPathname } from "../core/plurnk-uri.js";
+const STATE_VERSION = 1;
+const FAMILY = /^[a-z][a-z0-9]*$/u;
+const ALIAS = /^[a-z][a-z0-9-]*$/u;
+const EMPTY_STATE = Object.freeze({ version: STATE_VERSION, definitions: Object.freeze({}) });
+const SCHEMA = (name) => ({ $ref: `https://schemas.plurnk.xyz/v0/${name}.json` });
+const ALIAS_INPUT = Object.freeze({
+    type: "object",
+    additionalProperties: false,
+    required: ["alias"],
+    properties: { alias: { type: "string", minLength: 1 } },
+});
+const EMPTY_INPUT = Object.freeze({ type: "object", additionalProperties: false, properties: {} });
+const failure = (family, code, status, detail, extensions = {}) => new OperationFailureError(Results.failure("functionality", code, status, detail, {}, { family, retryable: status === 409 || status >= 500, ...extensions }));
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+class Functionality {
+    #host;
+    #adapters = new Map();
+    #owners = new Set();
+    #schemas = new Map();
+    #families = new Map();
+    #queues = new Map();
+    constructor(host) {
+        this.#host = host;
+    }
+    // {§functionality-adapter} — registration publishes the family's client
+    // actions and its Worker capability provider at once.
+    register(adapter) {
+        const { family, namespaceOwner } = adapter;
+        if (!FAMILY.test(family))
+            throw new Error(`Functionality family '${family}' must match ${FAMILY}.`);
+        if (this.#adapters.has(family))
+            throw new Error(`Functionality family '${family}' is already registered.`);
+        if (namespaceOwner.trim().length === 0)
+            throw new Error(`Functionality family '${family}' requires a namespace owner.`);
+        if (this.#owners.has(namespaceOwner))
+            throw new Error(`Functionality namespace owner '${namespaceOwner}' is already registered.`);
+        if (!isRecord(adapter.definitionSchema))
+            throw new Error(`Functionality family '${family}' requires a definition schema.`);
+        const schemas = Object.freeze({
+            list: EMPTY_INPUT,
+            discover: SCHEMA("FunctionalityDiscoverQuery"),
+            add: Object.freeze({
+                type: "object",
+                additionalProperties: false,
+                required: ["definition"],
+                properties: {
+                    alias: { type: "string", minLength: 1 },
+                    definition: adapter.definitionSchema,
+                },
+            }),
+            enable: ALIAS_INPUT,
+            disable: ALIAS_INPUT,
+            remove: ALIAS_INPUT,
+        });
+        this.#adapters.set(family, adapter);
+        this.#owners.add(namespaceOwner);
+        this.#schemas.set(family, schemas);
+        this.#host.registerWorkerCapabilityProvider(namespaceOwner, {
+            activate: (context) => this.#activate(adapter, context),
+            deactivate: (identity) => this.#deactivate(adapter, identity),
+        });
+        for (const verb of FUNCTIONALITY_VERBS) {
+            this.#host.registerModuleAction({
+                name: `worker.${family}.${verb}`,
+                scope: "worker",
+                inputSchema: schemas[verb],
+                outputSchema: SCHEMA(verb === "list"
+                    ? "FunctionalityListResult"
+                    : verb === "discover"
+                        ? "FunctionalityDiscoverResult"
+                        : "FunctionalityMutationResult"),
+                handler: async (params, context) => {
+                    if (context.scope !== "worker")
+                        throw new Error(`worker.${family}.${verb} requires a worker-scoped context.`);
+                    const { workspaceId, workerId } = context;
+                    return (await this.invoke(family, verb, params, { workspaceId, workerId }, "action")).body;
+                },
+            });
+        }
+        return {
+            invoke: (verb, params, identity) => this.invoke(family, verb, params, identity, "action"),
+            refresh: (identity, options) => this.refresh(family, identity, options),
+        };
+    }
+    // Republish a family's unchanged state for one Worker — a live catalog
+    // change, not a lifecycle mutation. Serialized like every publication.
+    // `gate: "none"` publishes inside the caller's own held turn (turn admission
+    // refreshing a family before packet assembly) instead of contending for
+    // workspace exclusivity it could never win.
+    async refresh(family, identity, options = {}) {
+        const adapter = this.#adapter(family);
+        await this.#serialize(identity.workerId, family, async () => {
+            const current = this.#families.get(this.#key(identity.workerId, family));
+            if (current === undefined)
+                return;
+            await this.#publish(adapter, identity, current.state, {
+                failure: "publish-unavailable",
+                retain: () => this.#host.retainWorker(identity.workerId),
+                gate: options.gate ?? "wait",
+            });
+        });
+    }
+    families() {
+        return [...this.#adapters.keys()].toSorted();
+    }
+    // Await every queued publication (boundary publications included). Shutdown
+    // and tests settle before inspecting or closing durable state.
+    async settle(workerId) {
+        const pending = [...this.#queues]
+            .filter(([key]) => workerId === undefined || key.startsWith(`${workerId}:`))
+            .map(([, queue]) => queue.catch(() => undefined));
+        await Promise.all(pending);
+    }
+    // {§functionality-documents} — the family-generated documents of every
+    // published family for one Worker, addressed under its generated subtree.
+    documents(workerId) {
+        const out = [];
+        for (const [key, family] of this.#families) {
+            if (!key.startsWith(`${workerId}:`) || family.prepared === null)
+                continue;
+            for (const document of family.prepared.documents) {
+                out.push({ pathname: generatedPathname(document.pathname), content: document.content });
+            }
+        }
+        return out;
+    }
+    // The one lifecycle entry for both projections ({§functionality-model-mutation}).
+    async invoke(family, verb, params, identity, caller) {
+        const adapter = this.#adapter(family);
+        const schema = this.#schemas.get(family)[verb];
+        const validation = Validator.validateJsonSchemaInstance(schema, params);
+        if (!validation.valid) {
+            throw failure(family, "arguments-invalid", 400, `${family} ${verb} arguments do not match their schema.`, {
+                errors: validation.errors,
+                recovery: `Conform the ${verb} arguments to the ${family} ${verb} input schema.`,
+                retryable: false,
+            });
+        }
+        const input = params;
+        switch (verb) {
+            case "list": return { status: 200, body: await this.#list(adapter, identity) };
+            case "discover": return { status: 200, body: await this.#discover(adapter, input, identity) };
+            default: return this.#serialize(identity.workerId, family, () => this.#mutate(adapter, verb, input, identity, caller));
+        }
+    }
+    #adapter(family) {
+        const adapter = this.#adapters.get(family);
+        if (adapter === undefined)
+            throw failure(family, "family-unknown", 404, `No Functionality family '${family}' is registered.`, { retryable: false });
+        return adapter;
+    }
+    #key(workerId, family) {
+        return `${workerId}:${family}`;
+    }
+    #serialize(workerId, family, work) {
+        const key = this.#key(workerId, family);
+        const previous = this.#queues.get(key) ?? Promise.resolve();
+        const next = previous.catch(() => undefined).then(work);
+        this.#queues.set(key, next);
+        return next;
+    }
+    async #activate(adapter, context) {
+        const identity = { workspaceId: context.workspaceId, workerId: context.workerId };
+        await this.#serialize(identity.workerId, adapter.family, async () => {
+            const state = await this.#loadState(adapter, identity.workerId);
+            await this.#publish(adapter, identity, state, { failure: "publish-unavailable", retain: context.retain, gate: "none" });
+        });
+    }
+    async #deactivate(adapter, identity) {
+        await this.#serialize(identity.workerId, adapter.family, async () => {
+            const key = this.#key(identity.workerId, adapter.family);
+            const family = this.#families.get(key);
+            this.#families.delete(key);
+            if (family?.prepared !== null && family?.prepared !== undefined) {
+                await adapter.teardown(family.prepared.snapshot, identity);
+            }
+        });
+    }
+    async #loadState(adapter, workerId) {
+        const raw = await this.#host.readWorkerModuleState(workerId, adapter.namespaceOwner);
+        if (raw === null)
+            return EMPTY_STATE;
+        if (!isRecord(raw) || raw.version !== STATE_VERSION || !isRecord(raw.definitions)) {
+            throw new Error(`Functionality state for ${adapter.family} on worker ${workerId} is not a version ${STATE_VERSION} record.`);
+        }
+        const definitions = {};
+        for (const [alias, value] of Object.entries(raw.definitions)) {
+            if (!ALIAS.test(alias) || !isRecord(value))
+                throw new Error(`Functionality state for ${adapter.family} has an invalid alias '${alias}'.`);
+            const { origin, enabled, definition } = value;
+            if ((origin !== "service" && origin !== "worker") || typeof enabled !== "boolean") {
+                throw new Error(`Functionality state for ${adapter.family} alias '${alias}' is malformed.`);
+            }
+            if (origin === "worker") {
+                const result = Validator.validateJsonSchemaInstance(adapter.definitionSchema, definition);
+                if (!result.valid)
+                    throw new Error(`Functionality state for ${adapter.family} alias '${alias}' holds an invalid definition.`);
+                definitions[alias] = { origin, enabled, definition: definition };
+            }
+            else {
+                if (definition !== undefined)
+                    throw new Error(`Functionality state for ${adapter.family} alias '${alias}' persists a service definition.`);
+                definitions[alias] = { origin, enabled };
+            }
+        }
+        return { version: STATE_VERSION, definitions };
+    }
+    static #persisted(state) {
+        return Object.keys(state.definitions).length === 0 ? null : state;
+    }
+    async #effective(adapter, identity, state) {
+        const effective = new Map();
+        for (const service of await adapter.available(identity)) {
+            if (!ALIAS.test(service.alias))
+                throw new Error(`${adapter.family} service alias '${service.alias}' must match ${ALIAS}.`);
+            const record = state.definitions[service.alias];
+            const enabled = record?.origin === "service" ? record.enabled : service.enabled;
+            effective.set(service.alias, { alias: service.alias, origin: "service", definition: service.definition, enabled });
+        }
+        for (const [alias, record] of Object.entries(state.definitions)) {
+            if (record.origin !== "worker")
+                continue;
+            effective.set(alias, { alias, origin: "worker", definition: record.definition, enabled: record.enabled });
+        }
+        return new Map([...effective].toSorted(([left], [right]) => left.localeCompare(right)));
+    }
+    #projection(definition, outcome) {
+        if (!definition.enabled) {
+            return { alias: definition.alias, origin: definition.origin, state: "disabled", definition: definition.definition };
+        }
+        if (outcome === undefined)
+            throw new Error(`enabled ${definition.alias} has no preparation outcome`);
+        switch (outcome.state) {
+            case "active": return {
+                alias: definition.alias, origin: definition.origin, state: "active", definition: definition.definition,
+                ...(outcome.detail === undefined ? {} : { detail: outcome.detail }),
+            };
+            case "unavailable": return { alias: definition.alias, origin: definition.origin, state: "unavailable", definition: definition.definition, problem: outcome.problem };
+            case "authorization-required": return { alias: definition.alias, origin: definition.origin, state: "authorization-required", definition: definition.definition, authorization: outcome.authorization };
+        }
+    }
+    async #list(adapter, identity) {
+        const family = this.#families.get(this.#key(identity.workerId, adapter.family));
+        if (family === undefined)
+            throw failure(adapter.family, "worker-not-resident", 409, `Worker ${identity.workerId} has no resident ${adapter.family} Functionality.`, { recovery: "Activate the Worker through an ordinary operation, then retry.", retryable: true });
+        const effective = await this.#effective(adapter, identity, family.state);
+        const outcomes = family.prepared?.outcomes ?? new Map();
+        return Validator.assertFunctionalityListResult({
+            family: adapter.family,
+            definitions: [...effective.values()].map((definition) => this.#projection(definition, outcomes.get(definition.alias))),
+        });
+    }
+    async #discover(adapter, query, identity) {
+        const candidates = await adapter.discover(query, identity);
+        return Validator.assertFunctionalityDiscoverResult({ family: adapter.family, candidates: [...candidates] });
+    }
+    async #mutate(adapter, verb, input, identity, caller) {
+        const key = this.#key(identity.workerId, adapter.family);
+        const family = this.#families.get(key);
+        if (family === undefined)
+            throw failure(adapter.family, "worker-not-resident", 409, `Worker ${identity.workerId} has no resident ${adapter.family} Functionality.`, { recovery: "Activate the Worker through an ordinary operation, then retry.", retryable: true });
+        const effective = await this.#effective(adapter, identity, family.state);
+        const definitions = { ...family.state.definitions };
+        let alias;
+        let status = 200;
+        let removed = false;
+        switch (verb) {
+            case "add": {
+                const admitted = await adapter.admit(input, identity);
+                alias = admitted.alias;
+                if (!ALIAS.test(alias))
+                    throw failure(adapter.family, "alias-invalid", 400, `Alias '${alias}' must match ${ALIAS}.`, { alias, retryable: false });
+                // A worker definition may shadow a service definition of the same
+                // alias; removing it reveals the service baseline again, disabled.
+                if (effective.get(alias)?.origin === "worker")
+                    throw failure(adapter.family, "alias-exists", 409, `'${alias}' is already this Worker's own definition.`, { alias, recovery: "Enable, disable, or remove the existing definition, or add under another alias.", retryable: false });
+                definitions[alias] = { origin: "worker", definition: admitted.definition, enabled: true };
+                status = 201;
+                break;
+            }
+            case "enable":
+            case "disable": {
+                alias = input.alias;
+                const current = effective.get(alias);
+                if (current === undefined)
+                    throw failure(adapter.family, "alias-unknown", 404, `'${alias}' is not available to this Worker.`, { alias, retryable: false });
+                definitions[alias] = current.origin === "worker"
+                    ? { origin: "worker", definition: current.definition, enabled: verb === "enable" }
+                    : { origin: "service", enabled: verb === "enable" };
+                break;
+            }
+            case "remove": {
+                alias = input.alias;
+                const current = effective.get(alias);
+                if (current === undefined)
+                    throw failure(adapter.family, "alias-unknown", 404, `'${alias}' is not available to this Worker.`, { alias, retryable: false });
+                if (current.origin === "service")
+                    throw failure(adapter.family, "alias-service-owned", 409, `'${alias}' is a service definition and cannot be removed here.`, { alias, recovery: `Disable it, or change the service configuration that contributes it.`, retryable: false });
+                await adapter.forget?.({ alias, definition: current.definition }, identity);
+                delete definitions[alias];
+                const revealed = (await adapter.available(identity)).some((service) => service.alias === alias);
+                if (revealed)
+                    definitions[alias] = { origin: "service", enabled: false };
+                removed = true;
+                break;
+            }
+            default: throw new Error(`unreachable verb ${verb}`);
+        }
+        const nextState = { version: STATE_VERSION, definitions };
+        // Re-enabling an alias that is not active retries its preparation; an
+        // already-active alias keeps its live attachment.
+        const retry = verb === "enable" && family.prepared?.outcomes.get(alias)?.state !== "active";
+        const publication = await this.#publish(adapter, identity, nextState, {
+            failure: caller === "action" ? "reject" : "publish-unavailable",
+            retain: () => this.#host.retainWorker(identity.workerId),
+            gate: caller === "operation" ? "wait" : "try",
+            forceAlias: retry ? alias : null,
+        });
+        const effectiveAfter = await this.#effective(adapter, identity, nextState);
+        const definition = effectiveAfter.get(alias);
+        const projection = definition === undefined ? undefined : this.#projection(definition, publication.outcomes.get(alias));
+        const body = Validator.assertFunctionalityMutationResult({
+            status: projection?.state === "authorization-required" ? 202 : status,
+            family: adapter.family,
+            alias,
+            ...(projection === undefined ? {} : { definition: projection }),
+            ...(removed ? { removed: true } : {}),
+        });
+        return { status: body.status, body };
+    }
+    // {§functionality-publication} — prepare, publish runtimes and state in one
+    // host replacement, then commit; on any failure abort and keep the previous
+    // snapshot authoritative. A model caller's publication waits for its own
+    // turn boundary in the same serialized lane, so the next packet sees it.
+    async #publish(adapter, identity, nextState, options) {
+        const key = this.#key(identity.workerId, adapter.family);
+        const previous = this.#families.get(key)?.prepared ?? null;
+        const effective = await this.#effective(adapter, identity, nextState);
+        const enabled = new Map();
+        for (const definition of effective.values()) {
+            if (definition.enabled)
+                enabled.set(definition.alias, definition.definition);
+        }
+        const prepared = await adapter.prepare({
+            workspaceId: identity.workspaceId,
+            workerId: identity.workerId,
+            enabled,
+            previous: previous?.snapshot ?? null,
+            failure: options.failure,
+            retain: options.retain,
+            ...(options.forceAlias ? { force: options.forceAlias } : {}),
+        });
+        for (const alias of enabled.keys()) {
+            if (!prepared.outcomes.has(alias))
+                throw new Error(`${adapter.family} preparation reported no outcome for enabled alias '${alias}'.`);
+        }
+        const manager = {
+            namespaceOwner: adapter.namespaceOwner,
+            decl: functionalityRuntimeDecl(adapter.family, adapter.summary),
+            executor: new FunctionalityManager({ family: adapter.family, workspaceId: identity.workspaceId, workerId: identity.workerId, coordinator: this }),
+            availability: { available: true, detail: "Worker Functionality manager" },
+        };
+        const runtimes = [manager, ...prepared.runtimes];
+        for (const runtime of prepared.runtimes) {
+            if (runtime.namespaceOwner !== adapter.namespaceOwner) {
+                await prepared.abort();
+                throw new Error(`${adapter.family} prepared a runtime owned by '${runtime.namespaceOwner}' instead of '${adapter.namespaceOwner}'.`);
+            }
+        }
+        const commit = async () => {
+            // The host reconciles the Worker's documents inside the replacement,
+            // so the snapshot it reads must already be the next one; a failed
+            // replacement restores the previous snapshot before aborting.
+            const before = this.#families.get(key);
+            this.#families.set(key, { state: nextState, prepared });
+            try {
+                await this.#host.replaceWorkerCapabilities({
+                    workspaceId: identity.workspaceId,
+                    workerId: identity.workerId,
+                    namespaceOwner: adapter.namespaceOwner,
+                    state: _a.#persisted(nextState),
+                    runtimes,
+                }, { gate: options.gate });
+            }
+            catch (cause) {
+                if (before === undefined)
+                    this.#families.delete(key);
+                else
+                    this.#families.set(key, before);
+                await prepared.abort();
+                throw cause;
+            }
+            await prepared.commit();
+        };
+        if (options.gate !== "wait") {
+            await commit();
+            return { outcomes: prepared.outcomes };
+        }
+        // Inside the caller's own turn the workspace is held by that turn:
+        // publication queues behind it in this family's lane and settles
+        // before the next packet. The caller learns the preparation outcome now.
+        const pending = (this.#queues.get(key) ?? Promise.resolve()).catch(() => undefined).then(commit);
+        this.#queues.set(key, pending.catch((cause) => {
+            console.error(`[plurnk] ${adapter.family} publication for worker ${identity.workerId} failed at its turn boundary:`, cause);
+        }));
+        return { outcomes: prepared.outcomes };
+    }
+}
+_a = Functionality;
+export default Functionality;
+//# sourceMappingURL=Functionality.js.map

package/dist/server/Functionality.js.map

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

package/dist/server/FunctionalityManager.d.ts

@@ -0,0 +1,22 @@
+import { BaseExecutor } from "@plurnk/plurnk-execs";
+import type { ChannelDecl, Effect, ExecArgs, ExecResult, RuntimeAvailability, RuntimeDecl, RuntimeToolRegistry } from "@plurnk/plurnk-execs";
+import type Functionality from "./Functionality.ts";
+export declare const FUNCTIONALITY_VERBS: readonly ["list", "discover", "add", "enable", "disable", "remove"];
+export type FunctionalityVerb = (typeof FUNCTIONALITY_VERBS)[number];
+export declare const isFunctionalityVerb: (value: string | null) => value is FunctionalityVerb;
+export declare const functionalityRuntimeDecl: (family: string, summary: string) => RuntimeDecl;
+export default class FunctionalityManager extends BaseExecutor {
+    #private;
+    constructor(args: {
+        family: string;
+        workspaceId: number;
+        workerId: number;
+        coordinator: Functionality;
+    });
+    get channels(): Readonly<Record<string, ChannelDecl>>;
+    probe(): Promise<RuntimeAvailability>;
+    effect(target: string | null): Effect;
+    toolRegistry(): RuntimeToolRegistry;
+    run(args: ExecArgs): Promise<ExecResult>;
+}
+//# sourceMappingURL=FunctionalityManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FunctionalityManager.d.ts","sourceRoot":"","sources":["../../src/server/FunctionalityManager.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,mBAAmB,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE7I,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAC;AAGpD,eAAO,MAAM,mBAAmB,qEAAqF,CAAC;AACtH,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAoCrE,eAAO,MAAM,mBAAmB,UAAW,MAAM,GAAG,IAAI,KAAG,KAAK,IAAI,iBACY,CAAC;AAEjF,eAAO,MAAM,wBAAwB,WAAY,MAAM,WAAW,MAAM,KAAG,WASzE,CAAC;AAEH,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,YAAY;;IAK1D,YAAY,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,aAAa,CAAA;KAAE,EAKtG;IAED,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAEpD;IAEc,KAAK,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAEnD;IAEQ,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAI7C;IAED,YAAY,IAAI,mBAAmB,CAelC;IAEK,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CA0B7C;CACJ"}

package/dist/server/FunctionalityManager.js

@@ -0,0 +1,121 @@
+// {§functionality-model-projection} — the model-facing face of one managed
+// Functionality family for one Worker. Published inside that Worker's own
+// snapshot like every other family: its verbs are ordinary EXEC targets, its
+// documents render through the common tool-document machinery, and a host verb
+// proposes through the ordinary Exec proposal lifecycle. Acceptance calls the
+// exact coordinator method a client action calls.
+import { BaseExecutor } from "@plurnk/plurnk-execs";
+import Results from "../core/results.js";
+const CHANNEL = "results";
+export const FUNCTIONALITY_VERBS = Object.freeze(["list", "discover", "add", "enable", "disable", "remove"]);
+const READ_VERBS = new Set(["list", "discover"]);
+const VERB_TEACHING = Object.freeze({
+    list: {
+        summary: "Project every definition with its origin, enabledness, and current state.",
+        signature: "",
+        details: "Read-only. Unavailable definitions carry their exact Problem.",
+    },
+    discover: {
+        summary: "Inspect a query or source and return inert candidates.",
+        signature: '{"query"?: string, "source"?: string}',
+        details: "Read-only. Discovery never installs, persists, enables, or executes a candidate; add one explicitly.",
+    },
+    add: {
+        summary: "Validate one exact definition, persist it for this Worker, prepare it, and enable it atomically.",
+        signature: '{"alias": string, "definition": object}',
+        details: "A host effect: it proposes and runs only on acceptance. The definition must conform to the family definition schema.",
+    },
+    enable: {
+        summary: "Prepare and publish one already-available definition.",
+        signature: '{"alias": string}',
+        details: "A host effect. Re-enabling an unavailable definition retries its preparation.",
+    },
+    disable: {
+        summary: "Withdraw the effective capability while keeping the definition available.",
+        signature: '{"alias": string}',
+        details: "A host effect. A disabled definition stays client-visible and model-invisible.",
+    },
+    remove: {
+        summary: "Disable and remove this Worker's own definition.",
+        signature: '{"alias": string}',
+        details: "A host effect. A lower-precedence service definition may become visible again, disabled. Service definitions cannot be removed; disable them.",
+    },
+});
+export const isFunctionalityVerb = (value) => value !== null && FUNCTIONALITY_VERBS.includes(value);
+export const functionalityRuntimeDecl = (family, summary) => ({
+    name: family,
+    glyph: "🧩",
+    summary,
+    invocation: {
+        body: { role: "JSON arguments for the verb", required: false },
+        target: { role: "lifecycle verb", required: true, kind: "literal" },
+        example: { target: "list" },
+    },
+});
+export default class FunctionalityManager extends BaseExecutor {
+    #coordinator;
+    #workspaceId;
+    #workerId;
+    constructor(args) {
+        super({ runtime: args.family, glyph: "🧩" });
+        this.#coordinator = args.coordinator;
+        this.#workspaceId = args.workspaceId;
+        this.#workerId = args.workerId;
+    }
+    get channels() {
+        return { [CHANNEL]: { mimetype: "application/json" } };
+    }
+    async probe() {
+        return { available: true, detail: "Worker Functionality manager" };
+    }
+    effect(target) {
+        // An unknown verb is refused at run; gating it as host keeps an invalid
+        // invocation from ever running ungated.
+        return isFunctionalityVerb(target) && READ_VERBS.has(target) ? "read" : "host";
+    }
+    toolRegistry() {
+        return {
+            tools: FUNCTIONALITY_VERBS.map((verb) => ({
+                target: verb,
+                summary: VERB_TEACHING[verb].summary,
+                invocation: {
+                    body: { role: "JSON arguments", required: VERB_TEACHING[verb].signature.length > 0 },
+                    target: { role: "lifecycle verb", required: true, kind: "literal" },
+                    ...(VERB_TEACHING[verb].signature.length > 0
+                        ? { signature: VERB_TEACHING[verb].signature }
+                        : { example: { target: verb } }),
+                },
+                details: VERB_TEACHING[verb].details,
+            })),
+        };
+    }
+    async run(args) {
+        const verb = args.target;
+        if (!isFunctionalityVerb(verb)) {
+            return Results.failure("functionality", "verb-unknown", 400, `'${verb ?? ""}' is not a ${this.runtime} lifecycle verb.`, {}, {
+                recovery: `Select one of ${FUNCTIONALITY_VERBS.join(", ")}.`,
+                retryable: false,
+            });
+        }
+        let params = {};
+        if (args.body.trim().length > 0) {
+            try {
+                params = JSON.parse(args.body);
+            }
+            catch (cause) {
+                return Results.failure("functionality", "arguments-not-json", 400, `The ${verb} body must be a JSON object.`, {}, {
+                    recovery: `Supply ${VERB_TEACHING[verb].signature || "no body"}.`,
+                    retryable: false,
+                    cause: cause instanceof Error ? cause.message : String(cause),
+                });
+            }
+        }
+        const identity = { workspaceId: this.#workspaceId, workerId: this.#workerId };
+        const result = await this.#coordinator.invoke(this.runtime, verb, params, identity, "operation");
+        args.setState(CHANNEL, "active");
+        args.write(CHANNEL, JSON.stringify(result.body, null, 2), "application/json");
+        args.setState(CHANNEL, "closed");
+        return { status: result.status };
+    }
+}
+//# sourceMappingURL=FunctionalityManager.js.map

package/dist/server/FunctionalityManager.js.map

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