bazis 0.98.33 → 0.99.0

package/core/agent/internal/AgentExecutionState.ts

@@ -39,10 +39,8 @@ const issuedCheckpoints = new WeakSet<object>();
 export type AgentExecutionPhase = "ready-model" | "pending-tools" | "terminal";
 
 export interface AgentExecutionInvocationState {
-  readonly kind: "agent" | "task";
   readonly invocationId: string;
   readonly agentName: string;
-  readonly taskName?: string;
   readonly input: JsonValue;
   readonly metadata: JsonObject;
   /** Resolved Session data only; never classes, callbacks, DI or policies. */
@@ -239,14 +237,10 @@ function checkpointFromBoundary(value: BoundaryJsonValue): AgentExecutionCheckpo
 }
 
 function parseInvocation(value: BoundaryJsonValue): AgentExecutionInvocationState {
-  const record = closed(value, ["kind", "invocationId", "agentName", "taskName", "input", "metadata", "options"]);
-  if (record.kind !== "agent" && record.kind !== "task") throw invalid();
-  if ((record.kind === "agent" && record.taskName !== null) || (record.kind === "task" && typeof record.taskName !== "string")) throw invalid();
+  const record = closed(value, ["invocationId", "agentName", "input", "metadata", "options"]);
   return Object.freeze({
-    kind: record.kind,
     invocationId: requiredString(record.invocationId),
     agentName: requiredString(record.agentName),
-    taskName: record.taskName === null ? undefined : requiredString(record.taskName),
     input: asJsonValue(record.input),
     metadata: asJsonObject(record.metadata),
     options: parseResolvedOptions(record.options),
@@ -610,10 +604,8 @@ function checkpointRecord(checkpoint: AgentExecutionCheckpointV1): Record<string
   return {
     version: checkpoint.version,
     invocation: {
-      kind: checkpoint.invocation.kind,
       invocationId: checkpoint.invocation.invocationId,
       agentName: checkpoint.invocation.agentName,
-      taskName: checkpoint.invocation.taskName ?? null,
       input: checkpoint.invocation.input,
       metadata: checkpoint.invocation.metadata,
       options: checkpoint.invocation.options,

package/core/agent/metadata.ts

@@ -5,77 +5,10 @@ import { AgentSetupError } from "./errors";
 // the runtime. Keep the same tiny polyfill used by HTTP/background metadata.
 (Symbol as { metadata?: symbol }).metadata ??= Symbol.for("Symbol.metadata");
 
-const AGENT_META = Symbol.for("bazis:agent:agent");
 const TOOL_META = Symbol.for("bazis:agent:tool");
-const PROMPT_META = Symbol.for("bazis:agent:prompt");
-const TASK_META = Symbol.for("bazis:agent:task");
 
 export type ToolSideEffect = "none" | "read" | "write" | "external";
 export type ToolApproval = "never" | "policy" | "required";
-export type PromptSectionKind =
-  | "system"
-  | "developer"
-  | "role"
-  | "task"
-  | "instructions"
-  | "constraints"
-  | "examples"
-  | "output"
-  | "tool-policy"
-  | "memory"
-  | "knowledge";
-
-export interface AgentOptions {
-  readonly name?: string;
-  readonly description?: string;
-  readonly role?: string;
-  readonly goal?: string;
-  readonly instructions?: readonly string[];
-  readonly constraints?: readonly string[];
-  readonly sections?: readonly PromptSectionOptions[];
-  readonly prompt?: Class<object>;
-  readonly tools?: readonly Class<object>[];
-  readonly input?: Class<object>;
-  readonly output?: Class<object>;
-  readonly modelProfile?: string;
-  readonly maxSteps?: number;
-}
-
-export interface AgentMetadata {
-  readonly name: string;
-  readonly description?: string;
-  readonly role?: string;
-  readonly goal?: string;
-  readonly instructions: readonly string[];
-  readonly constraints: readonly string[];
-  readonly sections: readonly PromptSectionMetadata[];
-  readonly prompt?: Class<object>;
-  readonly tools: readonly Class<object>[];
-  readonly input?: Class<object>;
-  readonly output?: Class<object>;
-  readonly modelProfile?: string;
-  readonly maxSteps?: number;
-  readonly tasks: readonly AgentTaskMetadata[];
-}
-
-export interface AgentTaskOptions {
-  readonly name?: string;
-  readonly description?: string;
-  readonly input?: Class<object>;
-  readonly output?: Class<object>;
-  readonly modelProfile?: string;
-  readonly maxSteps?: number;
-}
-
-export interface AgentTaskMetadata {
-  readonly name: string;
-  readonly methodName: string;
-  readonly description?: string;
-  readonly input?: Class<object>;
-  readonly output?: Class<object>;
-  readonly modelProfile?: string;
-  readonly maxSteps?: number;
-}
 
 export interface ToolOptions {
   readonly name: string;
@@ -99,155 +32,23 @@ export interface ToolMetadata {
   readonly tags: readonly string[];
 }
 
-export interface PromptOptions {
-  readonly name?: string;
-  readonly description?: string;
-  readonly version?: string;
-  readonly role?: string;
-  readonly goal?: string;
-  readonly instructions?: readonly string[];
-  readonly constraints?: readonly string[];
-  readonly sections?: readonly PromptSectionOptions[];
-}
-
-export interface PromptMetadata {
-  readonly name: string;
-  readonly description?: string;
-  readonly version?: string;
-  readonly role?: string;
-  readonly goal?: string;
-  readonly instructions: readonly string[];
-  readonly constraints: readonly string[];
-  readonly sections: readonly PromptSectionMetadata[];
-}
-
-export interface PromptSectionOptions {
-  readonly kind: PromptSectionKind;
-  readonly title?: string;
-  readonly content: string | readonly string[];
-  readonly priority?: number;
-}
-
-export interface PromptSectionMetadata {
-  readonly kind: PromptSectionKind;
-  readonly title?: string;
-  readonly content: readonly string[];
-  readonly priority?: number;
-}
-
 interface MetadataCarrier {
-  [AGENT_META]?: AgentMetadata;
   [TOOL_META]?: ToolMetadata;
-  [PROMPT_META]?: PromptMetadata;
-  [TASK_META]?: readonly AgentTaskMetadata[];
-}
-
-interface NamedConstructor {
-  readonly name?: string;
 }
 
-function classNameOf(target: object): string {
-  return (target as NamedConstructor).name ?? "<anonymous class>";
-}
-
-function text(value: string | undefined, fallback: string, field: string): string {
-  const resolved = value ?? fallback;
-  const trimmed = resolved.trim();
+function text(value: string | undefined, field: string): string {
+  const trimmed = (value ?? "").trim();
   if (trimmed.length === 0) {
     throw new AgentSetupError(`${field} must be a non-empty string.`);
   }
   return trimmed;
 }
 
-function optionalText(value: string | undefined, field: string): string | undefined {
-  if (value === undefined) {
-    return undefined;
-  }
-  const trimmed = value.trim();
-  if (trimmed.length === 0) {
-    throw new AgentSetupError(`${field} must be a non-empty string when provided.`);
-  }
-  return trimmed;
-}
-
 function readonlyTextList(values: readonly string[] | undefined, field: string): readonly string[] {
   if (values === undefined) {
     return Object.freeze([]);
   }
-  const normalized: string[] = [];
-  for (let index = 0; index < values.length; index += 1) {
-    normalized.push(text(values[index] as string, "", field));
-  }
-  return Object.freeze(normalized);
-}
-
-function promptSectionKind(value: string, field: string): PromptSectionKind {
-  if (
-    value !== "system" &&
-    value !== "developer" &&
-    value !== "role" &&
-    value !== "task" &&
-    value !== "instructions" &&
-    value !== "constraints" &&
-    value !== "examples" &&
-    value !== "output" &&
-    value !== "tool-policy" &&
-    value !== "memory" &&
-    value !== "knowledge"
-  ) {
-    throw new AgentSetupError(
-      `${field} must be system, developer, role, task, instructions, constraints, examples, output, tool-policy, memory or knowledge.`,
-    );
-  }
-  return value;
-}
-
-function readonlyPromptSectionContent(value: string | readonly string[], field: string): readonly string[] {
-  if (typeof value === "string") {
-    return Object.freeze([text(value, "", field)]);
-  }
-  if (!Array.isArray(value)) {
-    throw new AgentSetupError(`${field} must be a string or an array of strings.`);
-  }
-  return readonlyTextList(value, field);
-}
-
-function readonlyPromptSections(
-  values: readonly PromptSectionOptions[] | undefined,
-  field: string,
-): readonly PromptSectionMetadata[] {
-  if (values === undefined) {
-    return Object.freeze([]);
-  }
-
-  const normalized: PromptSectionMetadata[] = [];
-  for (let index = 0; index < values.length; index += 1) {
-    const value = values[index] as PromptSectionOptions;
-    if (!value || typeof value !== "object") {
-      throw new AgentSetupError(`${field}[${index}] must be a prompt section object.`);
-    }
-    normalized.push(freezeWithoutUndefined({
-      kind: promptSectionKind(value.kind, `${field}[${index}].kind`),
-      title: optionalText(value.title, `${field}[${index}].title`),
-      content: readonlyPromptSectionContent(value.content, `${field}[${index}].content`),
-      priority: positiveInteger(value.priority, `${field}[${index}].priority`),
-    }));
-  }
-  return Object.freeze(normalized);
-}
-
-function readonlyClassList(values: readonly Class<object>[] | undefined): readonly Class<object>[] {
-  if (values === undefined) {
-    return Object.freeze([]);
-  }
-  return Object.freeze([...values]);
-}
-
-function readonlyTaskList(values: readonly AgentTaskMetadata[] | undefined): readonly AgentTaskMetadata[] {
-  if (values === undefined) {
-    return Object.freeze([]);
-  }
-  return Object.freeze([...values]);
+  return Object.freeze(values.map((value) => text(value, field)));
 }
 
 function positiveInteger(value: number | undefined, field: string): number | undefined {
@@ -260,16 +61,6 @@ function positiveInteger(value: number | undefined, field: string): number | und
   return value;
 }
 
-function freezeWithoutUndefined<T extends Record<string, unknown>>(value: T): T {
-  const copy: Record<string, unknown> = {};
-  for (const [key, item] of Object.entries(value)) {
-    if (item !== undefined) {
-      copy[key] = item;
-    }
-  }
-  return Object.freeze(copy) as T;
-}
-
 function approvalFor(sideEffect: ToolSideEffect, requested: ToolApproval | undefined): ToolApproval {
   if (requested === undefined) {
     return sideEffect === "write" || sideEffect === "external" ? "required" : "policy";
@@ -282,57 +73,6 @@ function approvalFor(sideEffect: ToolSideEffect, requested: ToolApproval | undef
   return requested;
 }
 
-function ownCarrier(metadata: object): MetadataCarrier {
-  return metadata as MetadataCarrier;
-}
-
-function readCarrier(ctor: object): MetadataCarrier | undefined {
-  return (ctor as { [key: symbol]: unknown })[Symbol.metadata as unknown as symbol] as MetadataCarrier | undefined;
-}
-
-function hasOwnMeta(carrier: MetadataCarrier, key: symbol): boolean {
-  return Object.prototype.hasOwnProperty.call(carrier, key);
-}
-
-export function defineAgentMetadata(target: object, metadata: object, options: AgentOptions): void {
-  const carrier = ownCarrier(metadata);
-  const normalized: AgentMetadata = Object.freeze({
-    name: text(options.name, classNameOf(target), "@Agent.name"),
-    description: optionalText(options.description, "@Agent.description"),
-    role: optionalText(options.role, "@Agent.role"),
-    goal: optionalText(options.goal, "@Agent.goal"),
-    instructions: readonlyTextList(options.instructions, "@Agent.instructions"),
-    constraints: readonlyTextList(options.constraints, "@Agent.constraints"),
-    sections: readonlyPromptSections(options.sections, "@Agent.sections"),
-    prompt: options.prompt,
-    tools: readonlyClassList(options.tools),
-    input: options.input,
-    output: options.output,
-    modelProfile: optionalText(options.modelProfile, "@Agent.modelProfile"),
-    maxSteps: positiveInteger(options.maxSteps, "@Agent.maxSteps"),
-    tasks: readonlyTaskList(carrier[TASK_META]),
-  });
-  carrier[AGENT_META] = normalized;
-}
-
-export function defineAgentTaskMetadata(methodName: string | symbol, metadata: object, options: AgentTaskOptions): void {
-  if (typeof methodName !== "string") {
-    throw new AgentSetupError("@Task supports string method names only.");
-  }
-  const normalized: AgentTaskMetadata = freezeWithoutUndefined({
-    name: text(options.name, methodName, "@Task.name"),
-    methodName,
-    description: optionalText(options.description, "@Task.description"),
-    input: options.input,
-    output: options.output,
-    modelProfile: optionalText(options.modelProfile, "@Task.modelProfile"),
-    maxSteps: positiveInteger(options.maxSteps, "@Task.maxSteps"),
-  });
-  const carrier = ownCarrier(metadata);
-  const existing = carrier[TASK_META] ?? Object.freeze([]);
-  carrier[TASK_META] = Object.freeze([...existing, normalized]);
-}
-
 export function defineToolMetadata(_target: object, metadata: object, options: ToolOptions): void {
   const sideEffect = options.sideEffect ?? "none";
   if (sideEffect !== "none" && sideEffect !== "read" && sideEffect !== "write" && sideEffect !== "external") {
@@ -342,8 +82,8 @@ export function defineToolMetadata(_target: object, metadata: object, options: T
     throw new AgentSetupError("@Tool.approval must be never, policy or required.");
   }
   const normalized: ToolMetadata = Object.freeze({
-    name: text(options.name, "", "@Tool.name"),
-    description: text(options.description, "", "@Tool.description"),
+    name: text(options.name, "@Tool.name"),
+    description: text(options.description, "@Tool.description"),
     input: options.input,
     output: options.output,
     sideEffect,
@@ -351,48 +91,13 @@ export function defineToolMetadata(_target: object, metadata: object, options: T
     timeoutMs: positiveInteger(options.timeoutMs, "@Tool.timeoutMs"),
     tags: readonlyTextList(options.tags, "@Tool.tags"),
   });
-  ownCarrier(metadata)[TOOL_META] = normalized;
-}
-
-export function definePromptMetadata(target: object, metadata: object, options: PromptOptions): void {
-  const normalized: PromptMetadata = Object.freeze({
-    name: text(options.name, classNameOf(target), "@Prompt.name"),
-    description: optionalText(options.description, "@Prompt.description"),
-    version: optionalText(options.version, "@Prompt.version"),
-    role: optionalText(options.role, "@Prompt.role"),
-    goal: optionalText(options.goal, "@Prompt.goal"),
-    instructions: readonlyTextList(options.instructions, "@Prompt.instructions"),
-    constraints: readonlyTextList(options.constraints, "@Prompt.constraints"),
-    sections: readonlyPromptSections(options.sections, "@Prompt.sections"),
-  });
-  ownCarrier(metadata)[PROMPT_META] = normalized;
-}
-
-export function agentMetadataOf(ctor: object): AgentMetadata | undefined {
-  const metadata = readCarrier(ctor);
-  if (!metadata || !hasOwnMeta(metadata, AGENT_META)) {
-    return undefined;
-  }
-  return metadata[AGENT_META];
-}
-
-export function agentTaskMetadataOf(ctor: object): readonly AgentTaskMetadata[] {
-  const metadata = readCarrier(ctor);
-  return metadata?.[TASK_META] ?? Object.freeze([]);
+  (metadata as MetadataCarrier)[TOOL_META] = normalized;
 }
 
 export function toolMetadataOf(ctor: object): ToolMetadata | undefined {
-  const metadata = readCarrier(ctor);
-  if (!metadata || !hasOwnMeta(metadata, TOOL_META)) {
+  const metadata = (ctor as { [key: symbol]: unknown })[Symbol.metadata as unknown as symbol] as MetadataCarrier | undefined;
+  if (!metadata || !Object.prototype.hasOwnProperty.call(metadata, TOOL_META)) {
     return undefined;
   }
   return metadata[TOOL_META];
 }
-
-export function promptMetadataOf(ctor: object): PromptMetadata | undefined {
-  const metadata = readCarrier(ctor);
-  if (!metadata || !hasOwnMeta(metadata, PROMPT_META)) {
-    return undefined;
-  }
-  return metadata[PROMPT_META];
-}

package/core/agent/semantic.ts

@@ -368,10 +368,6 @@ export function normalizeJsonValue(value: unknown, field = "value"): JsonValue {
   throw new AgentSemanticError(`${field} must be JSON-serializable.`);
 }
 
-export function agentOutput<T = never>(): T {
-  throw new AgentSemanticError("agentOutput() is an agent task marker and must not be called directly.");
-}
-
 export function agentText(text: string): AgentTextPart {
   const value = requiredContentText(text, "text");
   return Object.freeze({ kind: "text", text: value });

package/core/agent/session/contracts.ts

@@ -1,6 +1,6 @@
 import type { Secret } from "../../kernel";
 import type { BazisModuleRef } from "../../di";
-import type { AgentToolExecutorOptions, AgentToolSchemaValidator } from "../AgentToolExecutor";
+import type { AgentToolExecutorOptions } from "../AgentToolExecutor";
 import { normalizeJsonValue, type JsonObject, type JsonValue } from "../semantic";
 import { Validator } from "../../../library/validation";
 
@@ -16,8 +16,6 @@ export class CreateAgentSessionRequestV1 {
   requestId!: string;
   @Validator({ required: true, minLength: 1, maxLength: 128 })
   agentName!: string;
-  @Validator({ minLength: 1, maxLength: 128 })
-  taskName?: string;
   @Validator({
     required: true,
     // JsonValue deliberately includes null. Keep absence invalid while
@@ -55,7 +53,7 @@ export type AgentSessionStateV1 = "created" | "running" | "stop-requested" | "st
 export type AgentSessionCursorV1 = string;
 export interface AgentSessionOutcomeV1 { readonly status: "completed" | "failed" | "outcome-unknown"; readonly finalText?: string; readonly output?: JsonValue; readonly error?: { readonly code: string; readonly message: string }; }
 export interface AgentSessionViewV1 {
-  readonly version: 1; readonly sessionId: string; readonly invocationId: string; readonly agentName: string; readonly taskName?: string;
+  readonly version: 1; readonly sessionId: string; readonly invocationId: string; readonly agentName: string;
   readonly tenant?: string; readonly state: AgentSessionStateV1; readonly revision: number; readonly steps: number; readonly stopRequested: boolean;
   readonly resumeAllowed: boolean; readonly createdAt: string; readonly updatedAt: string; readonly outcome?: AgentSessionOutcomeV1;
 }
@@ -74,7 +72,7 @@ export abstract class AgentSessions {
   abstract readEvents(request: ReadAgentSessionEventsRequestV1, context: AgentSessionCallContextV1): Promise<AgentSessionEventPageV1>;
 }
 
-export interface AgentSessionAuthorizationTargetV1 { readonly sessionId: string; readonly ownerSubject: string; readonly tenant?: string; readonly agentName: string; readonly taskName?: string; }
+export interface AgentSessionAuthorizationTargetV1 { readonly sessionId: string; readonly ownerSubject: string; readonly tenant?: string; readonly agentName: string; }
 export type AgentSessionAuthorizationRequestV1 =
   | { readonly action: "create"; readonly principal: AgentSessionPrincipalV1; readonly candidate: AgentSessionAuthorizationTargetV1 }
   | { readonly action: "run" | "read" | "read-events" | "stop" | "resume"; readonly principal: AgentSessionPrincipalV1; readonly session: AgentSessionAuthorizationTargetV1 & { readonly state: AgentSessionStateV1 } };
@@ -87,9 +85,9 @@ export interface AgentSessionOpenRequestV1 { readonly expectedSessionId: string;
 export abstract class AgentSessionCheckpointProtectorV1 { abstract seal(request: AgentSessionSealRequestV1): Promise<AgentSessionSealedCheckpointV1>; abstract open(request: AgentSessionOpenRequestV1): Promise<string>; }
 
 export interface AgentSessionModuleOptionsV1 {
-  readonly imports?: readonly BazisModuleRef[]; readonly agentModules: readonly BazisModuleRef[]; readonly implementationVersion: string;
+  readonly imports?: readonly BazisModuleRef[]; readonly implementationVersion: string;
   readonly admission: { readonly bucket: string; readonly maxActiveRuns?: number };
-  readonly execution?: { readonly providerCallTimeoutMs?: number; readonly taskSchemaValidator?: AgentToolSchemaValidator; readonly toolExecutorOptions?: Pick<AgentToolExecutorOptions, "approvalPolicy" | "schemaValidator" | "auditSink" | "defaultTimeoutMs" | "scopeDisposeTimeoutMs" | "requiredPlatformHooks" | "hookRedaction">; };
+  readonly execution?: { readonly providerCallTimeoutMs?: number; readonly toolExecutorOptions?: Pick<AgentToolExecutorOptions, "approvalPolicy" | "schemaValidator" | "auditSink" | "defaultTimeoutMs" | "scopeDisposeTimeoutMs" | "requiredPlatformHooks" | "hookRedaction">; };
   readonly limits?: { readonly runTimeoutMs?: number; readonly maxSessionSteps?: number; readonly maxToolCallsPerStep?: number; readonly ownerLeaseMs?: number; readonly ownerHeartbeatMs?: number; readonly ownerStopGraceMs?: number; readonly authorizationTimeoutMs?: number; readonly checkpointProtectionTimeoutMs?: number; readonly databaseLockTimeoutMs?: number; readonly databaseStatementTimeoutMs?: number; readonly databaseWaitTimeoutMs?: number; readonly stopCheckIntervalMs?: number; readonly maxInputBytes?: number; readonly maxCheckpointBytes?: number; readonly maxJournalPayloadBytes?: number; readonly maxJournalEntries?: number; readonly reservedControlJournalEntries?: number; readonly defaultJournalPageSize?: number; readonly maxJournalPageSize?: number; };
 }
 export type AgentSessionErrorCodeV1 = `AGENT_SESSION_${"INVALID_REQUEST" | "FORBIDDEN" | "NOT_FOUND" | "CONFLICT" | "OWNER_ACTIVE" | "ADMISSION_UNAVAILABLE" | "NOT_RESUMABLE" | "DEADLINE_EXCEEDED" | "LIMIT_EXCEEDED" | "AMBIENT_TRANSACTION_FORBIDDEN" | "BINDING_MISMATCH" | "CHECKPOINT_UNAVAILABLE" | "CHECKPOINT_CORRUPT" | "OUTCOME_UNKNOWN" | "STORE_CORRUPT" | "STORE_UNAVAILABLE" | "AUTHORIZATION_UNAVAILABLE" | "HOST_STOPPING" | "UNSUPPORTED_VERSION" | "IDEMPOTENCY_CONFLICT" | "COMMIT_OUTCOME_UNKNOWN" | "CONFIG_MISMATCH"}`;

package/core/agent/session/entities.ts

@@ -13,7 +13,6 @@ export class AgentSessionRowV1 {
   @Column({ type: "text" }) ownerSubject = "";
   @Column({ type: "text", nullable: true }) tenant?: string;
   @Column({ type: "text" }) agentName = "";
-  @Column({ type: "text", nullable: true }) taskName?: string;
   @Column({ type: "text" }) implementationVersion = "";
   @Column({ type: "text" }) bindingHash = "";
   @Column({ type: "text" }) state = "created";

package/core/cache/COMPATIBILITY.md

@@ -1,12 +1,12 @@
 # Cache Compatibility
 
-The aliases below were removed in 0.96.1, before the first `bazis` npm release,
-so no published version ever contained them. Use the replacement.
+The names below were removed; use the replacement. The `cached*` helpers were
+public until 0.98.34, the others were removed in 0.96.1 before the first npm release.
 
 | Removed name | Kind | Replacement |
 | --- | --- | --- |
-| `autoCachedScoped` | public alias | `cachedScoped` |
-| `autoCachedSingleton` | public alias | `cachedSingleton` |
+| `autoCachedScoped`, `cachedScoped` | public helpers, removed in 0.98.34 | `scoped(...)`: the cache hook wraps it |
+| `autoCachedSingleton`, `cachedSingleton` | public helpers, removed in 0.98.34 | `singleton(...)` |
 | `warnInsecureOutputCacheRoute` | public alias | `guardInsecureOutputCacheRoute` |
 | `warnOnAuthorizedRoutesWithoutVaryByUser` | config switch | `insecureAuthorizedRouteBehavior` (`false` was `"ignore"`) |
 | `DEFAULT_CACHEABLE_METHODS` | internal alias | `DEFAULT_OUTPUT_CACHE_METHODS` |

package/core/cache/README.md

@@ -79,5 +79,5 @@ The `@/core/cache` core does not import Redis at all, only the
 
 ## Compatibility
 
-DI helpers are `cachedScoped` and `cachedSingleton`. Former aliases were
-removed before the first npm release; see [COMPATIBILITY.md](./COMPATIBILITY.md).
+Cached services are registered with the regular `scoped` / `singleton`; the cache
+hook wraps them. Removed names are listed in [COMPATIBILITY.md](./COMPATIBILITY.md).