@namzu/sdk 27.0.0 → 28.0.0

package/dist/manager/topic/objective.d.ts

@@ -0,0 +1,77 @@
+import { type TopicObjectiveStore } from '../../store/topic/objective.js';
+import type { TenantId } from '../../types/ids/index.js';
+import type { ObjectiveAdvanceResult, ObjectiveRoundVerdict, TopicObjective } from '../../types/topic/objective.js';
+/**
+ * One round of an objective, from debit to verdict.
+ *
+ * The store holds the rules and the manager holds the sequence, so a host
+ * writes the work and not the bookkeeping. Getting that sequence wrong is
+ * how a cap stops capping: run the round first and a crash costs nothing,
+ * so an objective failing every round runs forever.
+ */
+export interface AdvanceObjectiveParams {
+    readonly id: string;
+    readonly tenantId: TenantId;
+    /**
+     * The work. Its return value is the verdict; a throw is `runner_failed`.
+     *
+     * It receives the record with the round ALREADY debited, so a runner
+     * that wants to know which round it is reads the same number the cap
+     * will be compared against.
+     */
+    readonly round: (objective: TopicObjective) => Promise<ObjectiveRoundVerdict>;
+}
+/** Advance one round, or say why it did not. */
+export declare function advanceObjective(store: TopicObjectiveStore, params: AdvanceObjectiveParams): Promise<ObjectiveAdvanceResult>;
+export interface DriveObjectiveParams extends AdvanceObjectiveParams {
+    /**
+     * Stop after this many rounds in THIS call.
+     *
+     * Separate from the objective's own `maxRounds`, which is durable and
+     * spans every call. This one bounds a single drive so a host can hand
+     * back to its caller — an objective with 200 rounds left should not
+     * decide how long one HTTP request takes.
+     *
+     * Omitted, the bound is the objective's OWN remaining rounds rather than
+     * no bound at all. See `driveObjective`.
+     */
+    readonly maxRoundsThisCall?: number;
+    /**
+     * Checked between rounds, never mid-round.
+     *
+     * The interrupt a human actually gets: the round in flight finishes and
+     * writes its verdict, and the next one does not start. Aborting mid-round
+     * would leave a round debited whose work was thrown away, which is the
+     * one state the debit-first rule exists to prevent.
+     */
+    readonly signal?: AbortSignal;
+}
+/** A drive that ran a round and got no round out of it. */
+export declare class ObjectiveNotProgressingError extends Error {
+    readonly details: {
+        id: string;
+        roundsStarted: number;
+    };
+    constructor(details: {
+        id: string;
+        roundsStarted: number;
+    });
+}
+/**
+ * Round after round until the objective stops asking for one.
+ *
+ * **The default bound is the objective's own remaining rounds, not
+ * infinity.** An unbounded default was written here first and a mutation
+ * test caught what it costs: break the round debit and this becomes a hot
+ * loop that no timeout can interrupt, because with an in-memory store every
+ * `await` in it resolves as a microtask and the event loop never reaches a
+ * timer. It ran twelve minutes at 100% CPU against a five-second test
+ * timeout that could never fire. Deriving the bound from `maxRounds` makes
+ * the loop finite by construction, from a number the record already has to
+ * carry.
+ *
+ * The progress check below is the second half of the same lesson: a bound
+ * stops the spin, but it stops it silently after a hundred wasted rounds.
+ */
+export declare function driveObjective(store: TopicObjectiveStore, params: DriveObjectiveParams): Promise<TopicObjective>;
+//# sourceMappingURL=objective.d.ts.map

package/dist/manager/topic/objective.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objective.d.ts","sourceRoot":"","sources":["../../../src/manager/topic/objective.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,mBAAmB,EAAE,MAAM,gCAAgC,CAAA;AAClG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EACX,sBAAsB,EACtB,qBAAqB,EACrB,cAAc,EACd,MAAM,gCAAgC,CAAA;AAEvC;;;;;;;GAOG;AAEH,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,cAAc,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAA;CAC7E;AAED,gDAAgD;AAChD,wBAAsB,gBAAgB,CACrC,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,sBAAsB,GAC5B,OAAO,CAAC,sBAAsB,CAAC,CAyDjC;AAED,MAAM,WAAW,oBAAqB,SAAQ,sBAAsB;IACnE;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAEnC;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC7B;AAED,2DAA2D;AAC3D,qBAAa,4BAA6B,SAAQ,KAAK;IACtD,QAAQ,CAAC,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAA;gBAE3C,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE;CAO1D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,cAAc,CACnC,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,oBAAoB,GAC1B,OAAO,CAAC,cAAc,CAAC,CAoDzB"}

package/dist/manager/topic/objective.js

@@ -0,0 +1,133 @@
+import { ObjectiveExhaustedError } from '../../store/topic/objective.js';
+/** Advance one round, or say why it did not. */
+export async function advanceObjective(store, params) {
+    const current = await store.getObjective(params.id, params.tenantId);
+    if (!current)
+        throw new Error(`No objective ${params.id}.`);
+    if (current.phase !== 'active') {
+        // A refusal rather than a throw. "Paused" and "already complete" are
+        // ordinary answers to "is there more to do" — a caller polling a set
+        // of objectives should not have to catch an exception per finished
+        // one to find the running ones.
+        return { kind: 'refused', reason: `Objective is ${current.phase}.`, phase: current.phase };
+    }
+    let debited;
+    try {
+        debited = await store.beginRound(params.id, params.tenantId, { revision: current.revision });
+    }
+    catch (error) {
+        if (error instanceof ObjectiveExhaustedError) {
+            // `beginRound` has already written the `blocked` phase, so this
+            // reads the record back rather than describing it — the refusal a
+            // caller sees and the record a later reader finds are then the same
+            // fact rather than two statements that could disagree.
+            const blocked = await store.getObjective(params.id, params.tenantId);
+            return {
+                kind: 'refused',
+                reason: blocked?.blockedReason?.message ?? error.message,
+                phase: blocked?.phase ?? 'blocked',
+            };
+        }
+        throw error;
+    }
+    let verdict;
+    try {
+        verdict = await params.round(debited);
+    }
+    catch (error) {
+        // Blocked, not lost. A runner that threw has left an objective whose
+        // round is spent and whose state would otherwise still say `active`,
+        // and the next poll would spend another round the same way.
+        const settled = await store.settleRound(params.id, params.tenantId, {
+            phase: 'blocked',
+            blockedReason: {
+                code: 'runner_failed',
+                message: error instanceof Error ? error.message : String(error),
+            },
+        }, { revision: debited.revision });
+        return { kind: 'advanced', objective: settled };
+    }
+    const settled = await store.settleRound(params.id, params.tenantId, verdict, {
+        revision: debited.revision,
+    });
+    return { kind: 'advanced', objective: settled };
+}
+/** A drive that ran a round and got no round out of it. */
+export class ObjectiveNotProgressingError extends Error {
+    details;
+    constructor(details) {
+        super(`Objective ${details.id} ran a round and roundsStarted stayed at ${details.roundsStarted}; refusing to loop.`);
+        this.name = 'ObjectiveNotProgressingError';
+        this.details = details;
+    }
+}
+/**
+ * Round after round until the objective stops asking for one.
+ *
+ * **The default bound is the objective's own remaining rounds, not
+ * infinity.** An unbounded default was written here first and a mutation
+ * test caught what it costs: break the round debit and this becomes a hot
+ * loop that no timeout can interrupt, because with an in-memory store every
+ * `await` in it resolves as a microtask and the event loop never reaches a
+ * timer. It ran twelve minutes at 100% CPU against a five-second test
+ * timeout that could never fire. Deriving the bound from `maxRounds` makes
+ * the loop finite by construction, from a number the record already has to
+ * carry.
+ *
+ * The progress check below is the second half of the same lesson: a bound
+ * stops the spin, but it stops it silently after a hundred wasted rounds.
+ */
+export async function driveObjective(store, params) {
+    const start = await store.getObjective(params.id, params.tenantId);
+    if (!start)
+        throw new Error(`No objective ${params.id}.`);
+    const remaining = Math.max(0, start.maxRounds - start.roundsStarted);
+    // `remaining + 1`, and the `+ 1` is the point: it is the iteration that
+    // asks for the round past the cap and is refused, which is what WRITES
+    // the `blocked` record. Stopping at `remaining` would leave an objective
+    // out of rounds still reading `active` — a state whose only remaining
+    // move is to be blocked, described as if it could still run.
+    //
+    // The refused iteration costs nothing; `beginRound` turns it away before
+    // the round callback is reached.
+    //
+    // A caller's own budget is the tighter bound when it gives one, and the
+    // `Infinity` below never survives the `min` — that is what keeps this
+    // finite by construction rather than by the caller remembering.
+    const budget = Math.min(params.maxRoundsThisCall ?? Number.POSITIVE_INFINITY, remaining + 1);
+    let rounds = 0;
+    let lastRoundsStarted = start.roundsStarted;
+    while (rounds < budget) {
+        if (params.signal?.aborted)
+            break;
+        const result = await advanceObjective(store, params);
+        rounds += 1;
+        if (result.kind === 'refused')
+            break;
+        // A round that did not advance the counter means the debit is broken,
+        // and every further iteration would repeat it. Named and thrown rather
+        // than left to the budget, so the failure says what it is instead of
+        // looking like an objective that quietly ran out.
+        if (result.objective.roundsStarted <= lastRoundsStarted) {
+            throw new ObjectiveNotProgressingError({
+                id: params.id,
+                roundsStarted: result.objective.roundsStarted,
+            });
+        }
+        lastRoundsStarted = result.objective.roundsStarted;
+        // An early exit, NOT a correctness guard, and it survives mutation for
+        // that reason: delete it and the next iteration calls
+        // `advanceObjective`, which reads the terminal phase and refuses, and
+        // the drive ends in the same state having done one extra store read.
+        // The refusal above is what makes stopping correct. This line only
+        // makes it cheap — which against the disk store is a real file read
+        // per completed drive, so it stays.
+        if (result.objective.phase !== 'active')
+            break;
+    }
+    const final = await store.getObjective(params.id, params.tenantId);
+    if (!final)
+        throw new Error(`No objective ${params.id}.`);
+    return final;
+}
+//# sourceMappingURL=objective.js.map

package/dist/manager/topic/objective.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objective.js","sourceRoot":"","sources":["../../../src/manager/topic/objective.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAA4B,MAAM,gCAAgC,CAAA;AA8BlG,gDAAgD;AAChD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACrC,KAA0B,EAC1B,MAA8B;IAE9B,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;IACpE,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,MAAM,CAAC,EAAE,GAAG,CAAC,CAAA;IAE3D,IAAI,OAAO,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChC,qEAAqE;QACrE,qEAAqE;QACrE,mEAAmE;QACnE,gCAAgC;QAChC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,OAAO,CAAC,KAAK,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAA;IAC3F,CAAC;IAED,IAAI,OAAuB,CAAA;IAC3B,IAAI,CAAC;QACJ,OAAO,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAA;IAC7F,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAI,KAAK,YAAY,uBAAuB,EAAE,CAAC;YAC9C,gEAAgE;YAChE,kEAAkE;YAClE,oEAAoE;YACpE,uDAAuD;YACvD,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;YACpE,OAAO;gBACN,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,IAAI,KAAK,CAAC,OAAO;gBACxD,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,SAAS;aAClC,CAAA;QACF,CAAC;QACD,MAAM,KAAK,CAAA;IACZ,CAAC;IAED,IAAI,OAA8B,CAAA;IAClC,IAAI,CAAC;QACJ,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,qEAAqE;QACrE,qEAAqE;QACrE,4DAA4D;QAC5D,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,WAAW,CACtC,MAAM,CAAC,EAAE,EACT,MAAM,CAAC,QAAQ,EACf;YACC,KAAK,EAAE,SAAS;YAChB,aAAa,EAAE;gBACd,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC/D;SACD,EACD,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAC9B,CAAA;QACD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,CAAA;IAChD,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE;QAC5E,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC1B,CAAC,CAAA;IACF,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,CAAA;AAChD,CAAC;AA2BD,2DAA2D;AAC3D,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IAC7C,OAAO,CAAuC;IAEvD,YAAY,OAA8C;QACzD,KAAK,CACJ,aAAa,OAAO,CAAC,EAAE,4CAA4C,OAAO,CAAC,aAAa,qBAAqB,CAC7G,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAA;QAC1C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACvB,CAAC;CACD;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,KAA0B,EAC1B,MAA4B;IAE5B,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;IAClE,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,MAAM,CAAC,EAAE,GAAG,CAAC,CAAA;IAEzD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,aAAa,CAAC,CAAA;IACpE,wEAAwE;IACxE,uEAAuE;IACvE,yEAAyE;IACzE,sEAAsE;IACtE,6DAA6D;IAC7D,EAAE;IACF,yEAAyE;IACzE,iCAAiC;IACjC,EAAE;IACF,wEAAwE;IACxE,sEAAsE;IACtE,gEAAgE;IAChE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,iBAAiB,IAAI,MAAM,CAAC,iBAAiB,EAAE,SAAS,GAAG,CAAC,CAAC,CAAA;IAE5F,IAAI,MAAM,GAAG,CAAC,CAAA;IACd,IAAI,iBAAiB,GAAG,KAAK,CAAC,aAAa,CAAA;IAC3C,OAAO,MAAM,GAAG,MAAM,EAAE,CAAC;QACxB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO;YAAE,MAAK;QACjC,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QACpD,MAAM,IAAI,CAAC,CAAA;QACX,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;YAAE,MAAK;QAEpC,sEAAsE;QACtE,uEAAuE;QACvE,qEAAqE;QACrE,kDAAkD;QAClD,IAAI,MAAM,CAAC,SAAS,CAAC,aAAa,IAAI,iBAAiB,EAAE,CAAC;YACzD,MAAM,IAAI,4BAA4B,CAAC;gBACtC,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,aAAa,EAAE,MAAM,CAAC,SAAS,CAAC,aAAa;aAC7C,CAAC,CAAA;QACH,CAAC;QACD,iBAAiB,GAAG,MAAM,CAAC,SAAS,CAAC,aAAa,CAAA;QAElD,uEAAuE;QACvE,sDAAsD;QACtD,sEAAsE;QACtE,qEAAqE;QACrE,mEAAmE;QACnE,oEAAoE;QACpE,oCAAoC;QACpC,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,KAAK,QAAQ;YAAE,MAAK;IAC/C,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;IAClE,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,MAAM,CAAC,EAAE,GAAG,CAAC,CAAA;IACzD,OAAO,KAAK,CAAA;AACb,CAAC"}

package/dist/model-router/task-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-router.d.ts","sourceRoot":"","sources":["../../src/model-router/task-router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAE1E;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,gBAAgB,GAAG,SAAS,EACpC,YAAY,EAAE,MAAM,GAClB,MAAM,CAYR"}

package/dist/model-router/task-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-router.js","sourceRoot":"","sources":["../../src/model-router/task-router.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC/B,QAAkB,EAClB,MAAoC,EACpC,YAAoB;IAEpB,IAAI,CAAC,MAAM;QAAE,OAAO,YAAY,CAAA;IAEhC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;IACjC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAA;IAE7B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAA;QAC/B,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAA;IAC9B,CAAC;IAED,OAAO,YAAY,CAAA;AACpB,CAAC"}

package/dist/persona/assembler.d.ts

@@ -1,5 +1,5 @@
 import type { AgentPersona, OutputDiscipline } from '../types/persona/index.js';
-import type { Skill } from '../types/skills/index.js';
+import { type Skill } from '../types/skills/index.js';
 export declare function assembleSystemPrompt(persona: AgentPersona, skills?: Skill[]): string;
 export declare function renderSkillsSection(skills?: Skill[]): string | null;
 export declare function renderOutputDiscipline(discipline: OutputDiscipline): string;

package/dist/persona/assembler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assembler.d.ts","sourceRoot":"","sources":["../../src/persona/assembler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAC/E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AAErD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,MAAM,CAwCpF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,MAAM,GAAG,IAAI,CAsCnE;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,gBAAgB,GAAG,MAAM,CA4B3E;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAiB/F;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,GAAG,YAAY,CAE9F"}
+{"version":3,"file":"assembler.d.ts","sourceRoot":"","sources":["../../src/persona/assembler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAC/E,OAAO,EAAE,KAAK,KAAK,EAAiB,MAAM,0BAA0B,CAAA;AAEpE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,MAAM,CAwCpF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,MAAM,GAAG,IAAI,CAiDnE;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,gBAAgB,GAAG,MAAM,CA4B3E;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAiB/F;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,GAAG,YAAY,CAE9F"}

package/dist/persona/assembler.js

@@ -1,3 +1,4 @@
+import { isInvocableBy } from '../types/skills/index.js';
 export function assembleSystemPrompt(persona, skills) {
     const sections = [];
     sections.push(`## Identity\n**${persona.identity.role}**\n\n${persona.identity.description.trim()}`);
@@ -32,7 +33,14 @@ export function assembleSystemPrompt(persona, skills) {
 export function renderSkillsSection(skills) {
     if (!skills || skills.length === 0)
         return null;
-    const available = skills
+    // Only what the MODEL may invoke. An operator-only skill listed here is
+    // something the model will read as available and attempt — "collect a
+    // support bundle", "rotate the deploy key" — and the attempt is the
+    // failure, not the listing.
+    const forModel = skills.filter((skill) => isInvocableBy(skill, 'model'));
+    if (forModel.length === 0)
+        return null;
+    const available = forModel
         .map((s) => {
         const lines = [
             '<skill>',
@@ -53,7 +61,11 @@ export function renderSkillsSection(skills) {
         return lines.join('\n');
     })
         .join('\n');
-    const loadedSkills = skills.filter((s) => s.body);
+    // `forModel`, not `skills`: a loaded operator-only skill would otherwise
+    // have its whole BODY pasted into the model's prompt while being absent
+    // from the manifest above — the worst of both, since the model gets the
+    // instructions and no listing that would let it reason about them.
+    const loadedSkills = forModel.filter((s) => s.body);
     const sections = [
         `## Available Skills\nThe following block is a manifest, not the full skill content. Skill metadata is always visible; SKILL.md bodies are loaded only when the user's task matches the skill description.\n\n<available_skills>\n${available}\n</available_skills>\n\nSkill usage protocol:\n- Plain questions do not require a skill.\n- When a matching skill is already listed under Loaded Skills, apply its loaded instructions.\n- When a matching skill is not loaded and the runtime exposes filesystem or skill-loading tools, read the SKILL.md at its <location> before writing code, creating files, running shell commands for that workflow, or calling mutation tools guided by the skill.\n- Do not claim to have read a SKILL.md until its content is actually present in the prompt or returned by a tool.\n- Tool schemas and runtime permissions remain authoritative; skills provide guidance, not hidden tools.`,
     ];

package/dist/persona/assembler.js.map

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

package/dist/plugin/lifecycle.d.ts

@@ -1,6 +1,8 @@
+import type { ConfigRegistry } from '../config/registry.js';
 import type { MCPToolDiscoveryOptions } from '../connector/mcp/discovery.js';
 import type { MCPToolPolicy } from '../connector/mcp/policy.js';
 import type { PluginRegistry } from '../registry/plugin/index.js';
+import type { SkillRegistry } from '../skills/registry.js';
 import type { PluginId } from '../types/ids/index.js';
 import type { PluginDefinition, PluginEventListener, PluginHookContext, PluginHookDefinition, PluginHookEvent, PluginHookResult, PluginScope } from '../types/plugin/index.js';
 import type { RunEvent } from '../types/run/index.js';
@@ -9,8 +11,28 @@ import type { Logger } from '../utils/logger.js';
 export interface PluginLifecycleManagerConfig {
     pluginRegistry: PluginRegistry;
     toolRegistry: ToolRegistryContract;
+    /**
+     * Where a plugin's declared skills land.
+     *
+     * Optional, and its absence is enforced rather than tolerated: a
+     * manifest that declares skills is REFUSED when this is missing, the
+     * same way it was refused before the manifest path existed. Accepting it
+     * and dropping the skills would produce a plugin reporting `enabled`
+     * that contributes nothing its author declared.
+     */
+    skillRegistry?: SkillRegistry;
     log: Logger;
     hookTimeoutMs?: number;
+    /**
+     * Where each MCP server's reconnect policy is registered, so an operator
+     * can retune it while a run is live.
+     *
+     * Optional, and its absence is not a degraded mode: without one the
+     * supervisor uses its own defaults, which is what it did before this
+     * existed. What a registry buys is the ability to change them without
+     * restarting the process — see `config/registry.ts`.
+     */
+    configRegistry?: ConfigRegistry;
     /**
      * What each MCP server a plugin brings is allowed to contribute, keyed by
      * server name. `'*'` covers every server not named explicitly.
@@ -43,6 +65,7 @@ export declare class PluginLifecycleManager {
     private hookHandlers;
     private pluginContributions;
     private hookTimeoutMs;
+    private readonly configRegistry;
     private log;
     /**
      * The admission boundary for everything a plugin's MCP servers advertise.
@@ -59,6 +82,7 @@ export declare class PluginLifecycleManager {
      * reads.
      */
     private mcpDiscovery;
+    private readonly skillRegistry;
     constructor(config: PluginLifecycleManagerConfig);
     /**
      * Attach a hook without installing a plugin from disk.

package/dist/plugin/lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/plugin/lifecycle.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAA;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAO/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAEjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,KAAK,EACX,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAGhB,WAAW,EACX,MAAM,0BAA0B,CAAA;AACjC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,KAAK,EAAkB,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAGlF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAQhD,MAAM,WAAW,4BAA4B;IAC5C,cAAc,EAAE,cAAc,CAAA;IAC9B,YAAY,EAAE,oBAAoB,CAAA;IAClC,GAAG,EAAE,MAAM,CAAA;IACX,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAA;IAEzD;;;;;;;;;OASG;IACH,cAAc,CAAC,EAAE,uBAAuB,CAAC,SAAS,CAAC,CAAA;CACnD;AAED,qBAAa,sBAAsB;IAClC,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,YAAY,CAQP;IACb,OAAO,CAAC,mBAAmB,CAAqD;IAChF,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,GAAG,CAAQ;IACnB;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,YAAY,CAAkB;gBAE1B,MAAM,EAAE,4BAA4B;IAYhD;;;;;;;;;;;;OAYG;IACH,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,oBAAoB,GAAG,IAAI;IAgBlE,EAAE,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAIvC,GAAG,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAKlC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAoCzE,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;YAsGjC,eAAe;YAgDf,qBAAqB;IAkC7B,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA4D1C,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB5C,YAAY,CACjB,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,GAAG,OAAO,CAAC,EACtD,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,GAC/C,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAqH9B,OAAO,CAAC,IAAI;CAWZ"}
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/plugin/lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAI3D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAA;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAS/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAEjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAE1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,KAAK,EACX,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAGhB,WAAW,EACX,MAAM,0BAA0B,CAAA;AACjC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,KAAK,EAAkB,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAIlF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAoBhD,MAAM,WAAW,4BAA4B;IAC5C,cAAc,EAAE,cAAc,CAAA;IAC9B,YAAY,EAAE,oBAAoB,CAAA;IAClC;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,cAAc,CAAA;IAE/B;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAA;IAEzD;;;;;;;;;OASG;IACH,cAAc,CAAC,EAAE,uBAAuB,CAAC,SAAS,CAAC,CAAA;CACnD;AAED,qBAAa,sBAAsB;IAClC,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,YAAY,CAQP;IACb,OAAO,CAAC,mBAAmB,CAAqD;IAChF,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4B;IAC3D,OAAO,CAAC,GAAG,CAAQ;IACnB;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,YAAY,CAAkB;IAEtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA2B;gBAE7C,MAAM,EAAE,4BAA4B;IAchD;;;;;;;;;;;;OAYG;IACH,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,oBAAoB,GAAG,IAAI;IAgBlE,EAAE,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAIvC,GAAG,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAKlC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAqCzE,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;YA4IjC,eAAe;YAyEf,qBAAqB;IA4C7B,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA4E1C,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB5C,YAAY,CACjB,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,GAAG,OAAO,CAAC,EACtD,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,GAC/C,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAqH9B,OAAO,CAAC,IAAI;CAWZ"}

package/dist/plugin/lifecycle.js

@@ -3,10 +3,14 @@ import { mcpToolToToolDefinition } from '../connector/mcp/adapter.js';
 import { MCPClient } from '../connector/mcp/client.js';
 import { MCPToolDiscovery } from '../connector/mcp/discovery.js';
 import { mcpPromptToToolDefinition } from '../connector/mcp/prompt-adapter.js';
+import { MCPReconnectOptionsSchema, MCPReconnectSupervisor } from '../connector/mcp/reconnect.js';
 import { DEFAULT_HOOK_PRIORITY, HOOK_TIMEOUT_MS, PLUGIN_NAMESPACE_SEPARATOR, } from '../constants/plugin/index.js';
+import { GENAI } from '../constants/telemetry/index.js';
+import { loadSkill } from '../skills/loader.js';
 import { resolveWithinReal } from '../tools/paths.js';
 import { toErrorMessage } from '../utils/error.js';
 import { generatePluginId } from '../utils/id.js';
+import { SCOPE_ATTRIBUTE } from '../utils/log/types.js';
 import { assertEnableable, loadPluginManifest } from './loader.js';
 export class PluginLifecycleManager {
     pluginRegistry;
@@ -15,6 +19,7 @@ export class PluginLifecycleManager {
     hookHandlers = new Map();
     pluginContributions = new Map();
     hookTimeoutMs;
+    configRegistry;
     log;
     /**
      * The admission boundary for everything a plugin's MCP servers advertise.
@@ -31,11 +36,14 @@ export class PluginLifecycleManager {
      * reads.
      */
     mcpDiscovery;
+    skillRegistry;
     constructor(config) {
         this.pluginRegistry = config.pluginRegistry;
         this.toolRegistry = config.toolRegistry;
+        this.skillRegistry = config.skillRegistry;
         this.hookTimeoutMs = config.hookTimeoutMs ?? HOOK_TIMEOUT_MS;
-        this.log = config.log.child({ component: 'PluginLifecycleManager' });
+        this.configRegistry = config.configRegistry;
+        this.log = config.log.child({ [SCOPE_ATTRIBUTE]: 'plugin/lifecycle' });
         this.mcpDiscovery = new MCPToolDiscovery([], {
             ...(config.mcpToolPolicies ? { policies: config.mcpToolPolicies } : {}),
             ...(config.onMCPToolDrift ? { onDrift: config.onMCPToolDrift } : {}),
@@ -100,10 +108,11 @@ export class PluginLifecycleManager {
             name: manifest.name,
             scope,
         });
-        this.log.info(`Plugin installed: ${manifest.name}`, {
-            pluginId,
-            scope,
-            version: manifest.version,
+        this.log.info('Plugin installed', {
+            'namzu.plugin.name': manifest.name,
+            'namzu.plugin.id': pluginId,
+            'namzu.plugin.scope': scope,
+            'namzu.plugin.version': manifest.version,
         });
         return definition;
     }
@@ -121,13 +130,18 @@ export class PluginLifecycleManager {
         // `installed`: a status that says the plugin is fine while it can
         // never enable is how the next reader gets misled.
         try {
-            assertEnableable(manifest);
+            assertEnableable(manifest, { skillsSupported: Boolean(this.skillRegistry) });
         }
         catch (err) {
             this.pluginRegistry.register({ ...plugin, status: 'error' });
             throw err;
         }
-        const contributions = { toolNames: [], mcpClients: [] };
+        const contributions = {
+            toolNames: [],
+            mcpClients: [],
+            skillNames: [],
+            mcpSupervisors: [],
+        };
         try {
             // Load tools
             if (manifest.tools && manifest.tools.length > 0) {
@@ -146,6 +160,30 @@ export class PluginLifecycleManager {
                     }
                 }
             }
+            // Load skills. Namespaced like tools, and for the same reason: two
+            // plugins shipping `reconcile` would otherwise overwrite each
+            // other in a Map keyed by the frontmatter name, and the loser
+            // would vanish with nothing reporting it.
+            if (manifest.skills && manifest.skills.length > 0) {
+                const skillRegistry = this.skillRegistry;
+                if (!skillRegistry) {
+                    // Unreachable via `enable` — `assertEnableable` above refuses
+                    // first — and kept because this method is also the one a
+                    // future caller reaches directly. A silent skip here would
+                    // be the exact failure that check exists to prevent.
+                    throw new Error(`Plugin "${manifest.name}" declares skills but no SkillRegistry is configured.`);
+                }
+                for (const skillPath of manifest.skills) {
+                    const absolutePath = await resolveWithinReal(plugin.rootDir, skillPath);
+                    const { skill } = await loadSkill(absolutePath, 'metadata', this.log);
+                    const namespacedName = manifest.name + PLUGIN_NAMESPACE_SEPARATOR + skill.metadata.name;
+                    skillRegistry.add(namespacedName, {
+                        ...skill,
+                        metadata: { ...skill.metadata, name: namespacedName },
+                    });
+                    contributions.skillNames.push(namespacedName);
+                }
+            }
             // Load hooks
             if (manifest.hooks && manifest.hooks.length > 0) {
                 for (const hookPath of manifest.hooks) {
@@ -183,10 +221,16 @@ export class PluginLifecycleManager {
             pluginId,
             name: manifest.name,
         });
-        this.log.info(`Plugin enabled: ${manifest.name}`, {
-            pluginId,
-            toolCount: contributions.toolNames.length,
-            mcpServerCount: contributions.mcpClients.length,
+        this.log.info('Plugin enabled', {
+            // Every key namespaced, not just the newest one. Adding a bare
+            // `skillCount` beside bare neighbours would have moved the
+            // log-standard ratchet the wrong way for the sake of matching
+            // prose that is itself the debt.
+            'namzu.plugin.id': pluginId,
+            'namzu.plugin.name': manifest.name,
+            'namzu.plugin.tool_count': contributions.toolNames.length,
+            'namzu.plugin.skill_count': contributions.skillNames.length,
+            'namzu.plugin.mcp_server_count': contributions.mcpClients.length,
         });
     }
     async attachMCPServer(pluginName, config, contributions) {
@@ -198,9 +242,27 @@ export class PluginLifecycleManager {
                 args: config.args ? [...config.args] : undefined,
                 env: config.env ? { ...config.env } : undefined,
             },
+            logger: this.log,
         });
         await client.connect();
         contributions.mcpClients.push(client);
+        // Watched from here on. `connect()` above is the only attempt anything
+        // made: `transport.onClose` marked the client disconnected and rejected
+        // its pending calls, and nothing scheduled another try — so one blip
+        // took this plugin's tools out for the life of the process while the
+        // plugin went on reporting as enabled.
+        // The policy is read from the registry on EVERY attempt, not captured
+        // here. That is what makes the seam live: raising `maxAttempts` during
+        // an outage takes effect on the retry that is already running, which is
+        // the moment an operator actually reaches for it.
+        //
+        // Namespaced per server rather than globally, because two plugins'
+        // servers fail differently — one behind a flaky proxy wants patience,
+        // one behind a crash loop wants to give up and say so.
+        const policyScope = this.configRegistry?.register(`mcp.${config.name}`, MCPReconnectOptionsSchema);
+        const supervisor = new MCPReconnectSupervisor(client, policyScope ? () => policyScope.get() : {});
+        supervisor.start();
+        contributions.mcpSupervisors.push(supervisor);
         // Through the boundary, not around it. This used to call
         // `client.listTools()` and register everything the server answered
         // with, so the remote side decided what entered the agent's registry
@@ -236,19 +298,30 @@ export class PluginLifecycleManager {
             }
             catch (unregErr) {
                 this.log.warn('Rollback: tool unregister failed', {
-                    tool: name,
-                    error: toErrorMessage(unregErr),
+                    [GENAI.TOOL_NAME]: name,
+                    'exception.message': toErrorMessage(unregErr),
                 });
             }
         }
+        for (const name of contributions.skillNames) {
+            // No try/catch: `unregister` is a Map delete and cannot throw.
+            // Wrapping it would suggest a failure mode that does not exist.
+            this.skillRegistry?.unregister(name);
+        }
+        // Stop supervising BEFORE disconnecting. The lifecycle event a
+        // deliberate disconnect emits is the same one a dropped transport
+        // emits, so a still-attached supervisor would reconnect what this
+        // rollback just closed.
+        for (const supervisor of contributions.mcpSupervisors)
+            supervisor.stop();
         for (const client of contributions.mcpClients) {
             try {
                 await client.disconnect();
             }
             catch (discErr) {
                 this.log.warn('Rollback: MCP disconnect failed', {
-                    clientId: client.id,
-                    error: toErrorMessage(discErr),
+                    'namzu.mcp.client_id': client.id,
+                    'exception.message': toErrorMessage(discErr),
                 });
             }
         }
@@ -270,7 +343,13 @@ export class PluginLifecycleManager {
         const contributions = this.pluginContributions.get(pluginId) ?? {
             toolNames: [],
             mcpClients: [],
+            skillNames: [],
+            mcpSupervisors: [],
         };
+        // Stop supervising first, for the same reason as the rollback path: the
+        // disconnect below emits the event the supervisor treats as a fault.
+        for (const supervisor of contributions.mcpSupervisors)
+            supervisor.stop();
         // Disconnect MCP clients first so no new tool calls can reach them mid-teardown.
         for (const client of contributions.mcpClients) {
             try {
@@ -278,8 +357,8 @@ export class PluginLifecycleManager {
             }
             catch (err) {
                 this.log.warn('MCP client disconnect failed during disable', {
-                    clientId: client.id,
-                    error: toErrorMessage(err),
+                    'namzu.mcp.client_id': client.id,
+                    'exception.message': toErrorMessage(err),
                 });
             }
         }
@@ -287,6 +366,13 @@ export class PluginLifecycleManager {
         for (const name of contributions.toolNames) {
             this.toolRegistry.unregister(name);
         }
+        // And its skills. A disabled plugin whose skills stayed registered
+        // would keep offering the model instructions from something the
+        // runtime has switched off, which is worse than a stale tool: a tool
+        // call would at least fail, and a skill is followed silently.
+        for (const name of contributions.skillNames) {
+            this.skillRegistry?.unregister(name);
+        }
         // Remove hook handlers for this plugin
         for (const [event, handlers] of this.hookHandlers) {
             const filtered = handlers.filter((h) => h.pluginId !== pluginId);
@@ -310,7 +396,10 @@ export class PluginLifecycleManager {
             pluginId,
             name: plugin.manifest.name,
         });
-        this.log.info(`Plugin disabled: ${plugin.manifest.name}`, { pluginId });
+        this.log.info('Plugin disabled', {
+            'namzu.plugin.name': plugin.manifest.name,
+            'namzu.plugin.id': pluginId,
+        });
     }
     async uninstall(pluginId) {
         const plugin = this.pluginRegistry.getOrThrow(pluginId);
@@ -323,7 +412,10 @@ export class PluginLifecycleManager {
             pluginId,
             name: plugin.manifest.name,
         });
-        this.log.info(`Plugin uninstalled: ${plugin.manifest.name}`, { pluginId });
+        this.log.info('Plugin uninstalled', {
+            'namzu.plugin.name': plugin.manifest.name,
+            'namzu.plugin.id': pluginId,
+        });
     }
     async executeHooks(event, context, emitRunEvent) {
         const handlers = this.hookHandlers.get(event);
@@ -437,7 +529,7 @@ export class PluginLifecycleManager {
             }
             catch (err) {
                 this.log.error('Plugin event listener error', {
-                    error: toErrorMessage(err),
+                    'exception.message': toErrorMessage(err),
                 });
             }
         }