@jangts/agent-core 0.3.5 → 0.5.0

package/dist/esm/kits/{intents → domains}/registry.js

@@ -1,8 +1,9 @@
 import { assertion } from '../../utils/synchronous.js';
 import { breakWhile } from '../../utils/rules.js';
 import { registrationData } from '../../utils/registration.js';
+import { ModelToolRegistry } from '../../capabilities/model.js';
 /**
- * Intent semantics and allowed values are configuration; the registry owns their common lifecycle.
+ * Goal semantics and allowed values are configuration; the registry owns their common lifecycle.
  *
  * Registration order is preserved by `ids`, `definitions`, `values` and `entries`; once
  * `seal()` is called the set is final and further registration is rejected.
@@ -12,6 +13,7 @@ export class IntentRegistry {
     static create = createIntentRegistry;
     byId = new Map();
     sealed = false;
+    modelView;
     policy;
     /**
      * @param policy - Optional id pattern, vocabulary lists, error wording and assertion hook.
@@ -25,7 +27,7 @@ export class IntentRegistry {
             'targetModes',
             'contextTiers',
             'actions',
-            'steps',
+            'delegates',
             'handoffValues',
             'tags',
         ];
@@ -47,16 +49,16 @@ export class IntentRegistry {
         });
     }
     /**
-     * Validate, freeze and add one intent.
+     * Validate, freeze and add one domain Tool.
      *
      * Checks run in a fixed order — sealed, identity, context contract, auxiliary actions,
-     * handoff, plan, steps — so the reported violation is stable when several rules fail.
+     * handoff, plan, delegates — so the reported violation is stable when several rules fail.
      *
-     * @param input - Intent declaration; the App's own assertion receives this original object,
+     * @param input - Goal declaration; the App's own assertion receives this original object,
      *   not the compiled copy, so helpers and prototype methods keep working.
      * @returns This registry, for chaining.
      * @throws A configured error for a sealed registry, invalid identity or vocabulary values,
-     *   empty/duplicate steps, or a duplicate intent id.
+     *   empty/duplicate delegates, or a duplicate Tool id.
      */
     register(input) {
         const id = input.id;
@@ -64,7 +66,7 @@ export class IntentRegistry {
             ...registrationData(input, [
                 'id',
                 'description',
-                'steps',
+                'delegates',
                 'scopePolicy',
                 'targetPolicy',
                 'contextTier',
@@ -74,7 +76,11 @@ export class IntentRegistry {
             ]),
             id,
             description: input.description,
-            steps: input.steps,
+            delegates: (typeof input.asIntent === 'object' && input.asIntent !== null
+                ? input.asIntent.delegates
+                : undefined) ??
+                input.delegates ??
+                [],
             scopePolicy: input.scopePolicy,
             targetPolicy: input.targetPolicy,
             contextTier: input.contextTier,
@@ -83,7 +89,7 @@ export class IntentRegistry {
             preparedHandoff: input.preparedHandoff,
         };
         const policy = this.policy;
-        const invalid = policy.errors?.invalid ?? 'Invalid intent definition';
+        const invalid = policy.errors?.invalid ?? 'Invalid intent Tool definition';
         const tags = policy.tags ?? [];
         const validName = (name) => {
             if (typeof name !== 'string' || !name.trim())
@@ -141,75 +147,112 @@ export class IntentRegistry {
             },
             {
                 occur: [
-                    () => !definition.steps.length,
-                    () => definition.steps.some((step) => policy.steps !== undefined && !policy.steps.includes(step)),
-                    () => new Set(definition.steps).size !== definition.steps.length,
+                    () => (input.delegates !== undefined ||
+                        (typeof input.asIntent === 'object' &&
+                            input.asIntent !== null &&
+                            input.asIntent.delegates !== undefined)) &&
+                        !definition.delegates.length,
+                    () => definition.delegates.some((delegate) => policy.delegates !== undefined && !policy.delegates.includes(delegate)),
+                    () => new Set(definition.delegates).size !== definition.delegates.length,
                 ],
                 error: invalid,
-                tags: ['steps'],
+                tags: ['delegates'],
             },
         ], tags);
         // App assertions may use implementation helpers; never pass a compiled view as the source
         // instance.
         assertion(policy.assertDefinition?.(input), 'Registry definition assertions must return void synchronously');
-        breakWhile(this.byId.has(definition.id), () => policy.errors?.duplicate?.(definition.id) ??
-            new Error(`Duplicate intent: ${definition.id}`), [...tags, 'duplicate']);
+        breakWhile(this.byId.has(definition.id), () => policy.errors?.duplicate?.(definition.id) ?? new Error(`Duplicate tool: ${definition.id}`), [...tags, 'duplicate']);
         this.byId.set(definition.id, Object.freeze({
             ...definition,
-            steps: Object.freeze([...definition.steps]),
+            ...new ModelToolRegistry([
+                {
+                    id: input.id,
+                    description: input.description,
+                    active: typeof input.active === 'function' ? input.active.bind(input) : input.active,
+                    asIntent: typeof input.asIntent === 'function' ? input.asIntent.bind(input) : input.asIntent,
+                    inputSchema: input.inputSchema ?? {
+                        jsonSchema: { type: 'object' },
+                        parse(value) {
+                            if (!value || typeof value !== 'object' || Array.isArray(value))
+                                throw new TypeError('Tool input must be an object');
+                            return value;
+                        },
+                    },
+                    resolve: input.resolve?.bind(input) ?? ((value) => ({ toolId: id, input: value })),
+                },
+            ]).require(input.id),
+            delegates: Object.freeze([...definition.delegates]),
             ...(definition.auxiliaryActions
                 ? { auxiliaryActions: Object.freeze([...definition.auxiliaryActions]) }
                 : {}),
         }));
+        this.modelView = undefined;
         return this;
     }
-    /** Register every intent in iteration order. */
+    /** Register every domain Tool in iteration order. */
     registerAll(definitions) {
         for (const definition of definitions)
             this.register(definition);
         return this;
     }
-    /** Registered intent for `goal`, or `undefined` when it is absent. */
+    /** Registered domain Tool for `id`, or `undefined` when it is absent. */
     get(goal) {
         return this.byId.get(goal);
     }
-    /** Whether an intent id is registered. */
+    /** Whether a Tool id is registered. */
     has(goal) {
         return this.byId.has(goal);
     }
-    /** Registered intent ids in registration order. */
+    /** Registered Tool ids in registration order. */
     ids() {
         return Object.freeze([...this.byId.keys()]);
     }
-    /** Registered intents in registration order. */
+    /** Registered goals in registration order. */
     get definitions() {
         return Object.freeze([...this.byId.values()]);
     }
-    /** Iterate the registered intents. */
+    /** Iterate the registered goals. */
     values() {
         return this.byId.values();
     }
-    /** Iterate `[id, intent]` pairs. */
+    /** Demand discovery uses tool metadata; domain fields remain attached to these same IDs. */
+    withIntent(context) {
+        return this.models().withIntent(context);
+    }
+    /** Resolve a grouped transport's selected Tool through that Tool's own parser and resolver. */
+    resolve(selection, context) {
+        return this.models().resolve(selection, context);
+    }
+    /** Explicit node selection uses the same immutable model projection. */
+    select(ids, ...context) {
+        return context.length ? this.models().select(ids, context[0]) : this.models().select(ids);
+    }
+    /** Cache only immutable declarations; request activation is evaluated by each projection. */
+    models() {
+        return (this.modelView ??= new ModelToolRegistry(this.byId.values()).seal());
+    }
+    /** Iterate `[id, tool]` pairs. */
     entries() {
         return this.byId.entries();
     }
     /**
-     * Registered intent for `id`.
+     * Registered domain Tool for `id`.
      *
      * @throws TypeError When the id is not registered.
      */
     require(id) {
         const value = this.byId.get(id);
         if (!value)
-            throw new TypeError(`Unknown intent: ${id}`);
+            throw new TypeError(`Unknown tool: ${id}`);
         return value;
     }
-    /** Whether the intent declares this step; unknown intents allow nothing. */
-    allows(goal, step) {
-        return this.byId.get(goal)?.steps.includes(step) ?? false;
+    /** Whether the Tool declares this delegate; unknown goals allow nothing. */
+    allows(goal, delegate) {
+        return this.byId.get(goal)?.delegates.includes(delegate) ?? false;
     }
     /**
-     * Copy the selected intents out of the registry.
+     * Copy the selected goals out of the registry.
      *
      * @param goals - Ids to include; the default is every registered id, in registry order.
      * @returns Descriptions whose arrays are copied so callers cannot mutate registry state.
@@ -218,7 +261,10 @@ export class IntentRegistry {
         const selected = new Set(goals);
         return [...this.byId.values()]
             .filter((item) => selected.has(item.id))
-            .map((item) => ({ ...item, steps: [...item.steps] }));
+            .map((item) => ({
+            ...item,
+            delegates: [...item.delegates],
+        }));
     }
     /** Finalize the registry; no registration is accepted afterwards. */
     seal() {
@@ -229,7 +275,7 @@ export class IntentRegistry {
 /**
  * Create and seal a complete catalog; use the constructor for incremental installation.
  *
- * @param definitions - Intent declarations registered in iteration order.
+ * @param definitions - Goal declarations registered in iteration order.
  * @param policy - Optional registry policy forwarded to the constructor.
  * @returns A sealed registry.
  * @throws A configured error for the first invalid or duplicate declaration.

package/dist/esm/kits/{intents → domains}/scopes.d.ts

@@ -1,13 +1,13 @@
 /**
- * Intents Kit: an ordered, sealable registry of scope declarations and their aliases.
+ * Domain Tools Kit: an ordered, sealable registry of scope declarations and their aliases.
  *
- * Place in the package: part of the `intents` Kit. Categories, extra fields and intent
+ * Place in the package: part of the domain Tool Kit. Categories, extra fields and intent
  * acceptance policy are App configuration; this class owns validation, alias normalization,
  * relationship lookups and sealing.
  *
  * Exports: `ScopeRegistry`, `createScopeRegistry`, and the scope registry types.
  */
-import type { ScopeDefinition, ScopeDescription, ScopeRegistryPolicy, RegisteredScope, RegisteredScopeEvidence } from '../../structs/kits/intents/scopes.js';
+import type { ScopeDefinition, ScopeDescription, ScopeRegistryPolicy, RegisteredScope, RegisteredScopeEvidence } from '../../structs/kits/domains/scopes.js';
 /**
  * Generic scope relationships; categories, intent policy and extra fields belong to the host.
  *
@@ -33,11 +33,11 @@ export declare class ScopeRegistry<Definition extends ScopeDefinition = ScopeDef
      * Every name is checked for conflicts before any of them is stored, so a rejected scope
      * leaves no partial alias entry behind.
      *
-     * @param input - Scope declaration; the raw object is retained for `acceptsIntent` overrides
+     * @param input - Scope declaration; the raw object is retained for `acceptsTool` overrides
      *   while the compiled copy serves lookups.
      * @returns This registry, for chaining.
      * @throws A configured error for a sealed registry, an invalid name/description/category,
-     *   a missing required binding, duplicate intent ids or an already-claimed name.
+     *   a missing required binding, duplicate Tool ids or an already-claimed name.
      */
     register(input: Definition): this;
     /** Register every scope in iteration order. */
@@ -45,9 +45,9 @@ export declare class ScopeRegistry<Definition extends ScopeDefinition = ScopeDef
     /** Finalize the registry; no registration is accepted afterwards. */
     seal(): this;
     /** Registered scopes in registration order. */
-    get definitions(): readonly Readonly<Omit<Readonly<ScopeDefinition & import("../../utils/registration.js").RegistrationData<Definition> & Pick<Definition, Extract<keyof Definition, keyof ScopeDefinition>>>, "evidence" | ("toolIds" | "intentIds" | "queryScopeIds" | "knowledgeTopicIds" | "aliases")> & {
+    get definitions(): readonly Readonly<Omit<Readonly<ScopeDefinition & import("../../utils/registration.js").RegistrationData<Definition> & Pick<Definition, Extract<keyof Definition, keyof ScopeDefinition>>>, "evidence" | ("toolIds" | "goalIds" | "queryScopeIds" | "knowledgeTopicIds" | "aliases")> & {
         readonly toolIds: [NonNullable<Definition["toolIds"]>] extends [never] ? readonly [] : NonNullable<Definition["toolIds"]> extends readonly string[] ? Readonly<readonly string[] & Definition["toolIds"]> : readonly string[];
-        readonly intentIds: [NonNullable<Definition["intentIds"]>] extends [never] ? readonly [] : NonNullable<Definition["intentIds"]> extends readonly string[] ? Readonly<readonly string[] & Definition["intentIds"]> : readonly string[];
+        readonly goalIds: [NonNullable<Definition["goalIds"]>] extends [never] ? readonly [] : NonNullable<Definition["goalIds"]> extends readonly string[] ? Readonly<readonly string[] & Definition["goalIds"]> : readonly string[];
         readonly queryScopeIds: [NonNullable<Definition["queryScopeIds"]>] extends [never] ? readonly [] : NonNullable<Definition["queryScopeIds"]> extends readonly string[] ? Readonly<readonly string[] & Definition["queryScopeIds"]> : readonly string[];
         readonly knowledgeTopicIds: [NonNullable<Definition["knowledgeTopicIds"]>] extends [never] ? readonly [] : NonNullable<Definition["knowledgeTopicIds"]> extends readonly string[] ? Readonly<readonly string[] & Definition["knowledgeTopicIds"]> : readonly string[];
         readonly aliases: [NonNullable<Definition["aliases"]>] extends [never] ? readonly [] : NonNullable<Definition["aliases"]> extends readonly string[] ? Readonly<readonly string[] & Definition["aliases"]> : readonly string[];
@@ -57,9 +57,9 @@ export declare class ScopeRegistry<Definition extends ScopeDefinition = ScopeDef
     /** Registered scope ids in registration order; aliases are not included. */
     ids(): readonly string[];
     /** Iterate the registered scopes. */
-    values(): MapIterator<Readonly<Omit<Readonly<ScopeDefinition & import("../../utils/registration.js").RegistrationData<Definition> & Pick<Definition, Extract<keyof Definition, keyof ScopeDefinition>>>, "evidence" | ("toolIds" | "intentIds" | "queryScopeIds" | "knowledgeTopicIds" | "aliases")> & {
+    values(): MapIterator<Readonly<Omit<Readonly<ScopeDefinition & import("../../utils/registration.js").RegistrationData<Definition> & Pick<Definition, Extract<keyof Definition, keyof ScopeDefinition>>>, "evidence" | ("toolIds" | "goalIds" | "queryScopeIds" | "knowledgeTopicIds" | "aliases")> & {
         readonly toolIds: [NonNullable<Definition["toolIds"]>] extends [never] ? readonly [] : NonNullable<Definition["toolIds"]> extends readonly string[] ? Readonly<readonly string[] & Definition["toolIds"]> : readonly string[];
-        readonly intentIds: [NonNullable<Definition["intentIds"]>] extends [never] ? readonly [] : NonNullable<Definition["intentIds"]> extends readonly string[] ? Readonly<readonly string[] & Definition["intentIds"]> : readonly string[];
+        readonly goalIds: [NonNullable<Definition["goalIds"]>] extends [never] ? readonly [] : NonNullable<Definition["goalIds"]> extends readonly string[] ? Readonly<readonly string[] & Definition["goalIds"]> : readonly string[];
         readonly queryScopeIds: [NonNullable<Definition["queryScopeIds"]>] extends [never] ? readonly [] : NonNullable<Definition["queryScopeIds"]> extends readonly string[] ? Readonly<readonly string[] & Definition["queryScopeIds"]> : readonly string[];
         readonly knowledgeTopicIds: [NonNullable<Definition["knowledgeTopicIds"]>] extends [never] ? readonly [] : NonNullable<Definition["knowledgeTopicIds"]> extends readonly string[] ? Readonly<readonly string[] & Definition["knowledgeTopicIds"]> : readonly string[];
         readonly aliases: [NonNullable<Definition["aliases"]>] extends [never] ? readonly [] : NonNullable<Definition["aliases"]> extends readonly string[] ? Readonly<readonly string[] & Definition["aliases"]> : readonly string[];
@@ -67,9 +67,9 @@ export declare class ScopeRegistry<Definition extends ScopeDefinition = ScopeDef
         evidence: [NonNullable<Definition["evidence"]>] extends [never] ? readonly [] : NonNullable<Definition["evidence"]> extends readonly import("../evidence.js").EvidenceRequirement[] ? readonly import("../evidence.js").EvidenceRequirement[] & Definition["evidence"] extends infer T extends readonly import("../evidence.js").EvidenceRequirement[] ? { readonly [Index in keyof T]: Readonly<import("../../utils/registration.js").RegistrationData<T[Index]>>; } : never : readonly Readonly<import("../../utils/registration.js").RegistrationData<NonNullable<Definition["evidence"]>[number]>>[];
     }>>;
     /** Iterate `[id, scope]` pairs. */
-    entries(): MapIterator<[string, Readonly<Omit<Readonly<ScopeDefinition & import("../../utils/registration.js").RegistrationData<Definition> & Pick<Definition, Extract<keyof Definition, keyof ScopeDefinition>>>, "evidence" | ("toolIds" | "intentIds" | "queryScopeIds" | "knowledgeTopicIds" | "aliases")> & {
+    entries(): MapIterator<[string, Readonly<Omit<Readonly<ScopeDefinition & import("../../utils/registration.js").RegistrationData<Definition> & Pick<Definition, Extract<keyof Definition, keyof ScopeDefinition>>>, "evidence" | ("toolIds" | "goalIds" | "queryScopeIds" | "knowledgeTopicIds" | "aliases")> & {
         readonly toolIds: [NonNullable<Definition["toolIds"]>] extends [never] ? readonly [] : NonNullable<Definition["toolIds"]> extends readonly string[] ? Readonly<readonly string[] & Definition["toolIds"]> : readonly string[];
-        readonly intentIds: [NonNullable<Definition["intentIds"]>] extends [never] ? readonly [] : NonNullable<Definition["intentIds"]> extends readonly string[] ? Readonly<readonly string[] & Definition["intentIds"]> : readonly string[];
+        readonly goalIds: [NonNullable<Definition["goalIds"]>] extends [never] ? readonly [] : NonNullable<Definition["goalIds"]> extends readonly string[] ? Readonly<readonly string[] & Definition["goalIds"]> : readonly string[];
         readonly queryScopeIds: [NonNullable<Definition["queryScopeIds"]>] extends [never] ? readonly [] : NonNullable<Definition["queryScopeIds"]> extends readonly string[] ? Readonly<readonly string[] & Definition["queryScopeIds"]> : readonly string[];
         readonly knowledgeTopicIds: [NonNullable<Definition["knowledgeTopicIds"]>] extends [never] ? readonly [] : NonNullable<Definition["knowledgeTopicIds"]> extends readonly string[] ? Readonly<readonly string[] & Definition["knowledgeTopicIds"]> : readonly string[];
         readonly aliases: [NonNullable<Definition["aliases"]>] extends [never] ? readonly [] : NonNullable<Definition["aliases"]> extends readonly string[] ? Readonly<readonly string[] & Definition["aliases"]> : readonly string[];
@@ -81,9 +81,9 @@ export declare class ScopeRegistry<Definition extends ScopeDefinition = ScopeDef
      *
      * @throws TypeError When the name resolves to nothing.
      */
-    require(id: string): Readonly<Omit<Readonly<ScopeDefinition & import("../../utils/registration.js").RegistrationData<Definition> & Pick<Definition, Extract<keyof Definition, keyof ScopeDefinition>>>, "evidence" | ("toolIds" | "intentIds" | "queryScopeIds" | "knowledgeTopicIds" | "aliases")> & {
+    require(id: string): Readonly<Omit<Readonly<ScopeDefinition & import("../../utils/registration.js").RegistrationData<Definition> & Pick<Definition, Extract<keyof Definition, keyof ScopeDefinition>>>, "evidence" | ("toolIds" | "goalIds" | "queryScopeIds" | "knowledgeTopicIds" | "aliases")> & {
         readonly toolIds: [NonNullable<Definition["toolIds"]>] extends [never] ? readonly [] : NonNullable<Definition["toolIds"]> extends readonly string[] ? Readonly<readonly string[] & Definition["toolIds"]> : readonly string[];
-        readonly intentIds: [NonNullable<Definition["intentIds"]>] extends [never] ? readonly [] : NonNullable<Definition["intentIds"]> extends readonly string[] ? Readonly<readonly string[] & Definition["intentIds"]> : readonly string[];
+        readonly goalIds: [NonNullable<Definition["goalIds"]>] extends [never] ? readonly [] : NonNullable<Definition["goalIds"]> extends readonly string[] ? Readonly<readonly string[] & Definition["goalIds"]> : readonly string[];
         readonly queryScopeIds: [NonNullable<Definition["queryScopeIds"]>] extends [never] ? readonly [] : NonNullable<Definition["queryScopeIds"]> extends readonly string[] ? Readonly<readonly string[] & Definition["queryScopeIds"]> : readonly string[];
         readonly knowledgeTopicIds: [NonNullable<Definition["knowledgeTopicIds"]>] extends [never] ? readonly [] : NonNullable<Definition["knowledgeTopicIds"]> extends readonly string[] ? Readonly<readonly string[] & Definition["knowledgeTopicIds"]> : readonly string[];
         readonly aliases: [NonNullable<Definition["aliases"]>] extends [never] ? readonly [] : NonNullable<Definition["aliases"]> extends readonly string[] ? Readonly<readonly string[] & Definition["aliases"]> : readonly string[];
@@ -99,10 +99,10 @@ export declare class ScopeRegistry<Definition extends ScopeDefinition = ScopeDef
     /**
      * Whether a scope accepts an intent.
      *
-     * The App may override the declared `intentIds` through `acceptsIntent`; without an
+     * The App may override the declared `goalIds` through `acceptsTool`; without an
      * override the membership check applies.
      */
-    acceptsIntent(scope: string, goal: string): boolean;
+    acceptsTool(scope: string, goal: string): boolean;
     /** Whether the scope declares this query scope; a null scope accepts nothing. */
     acceptsQuery(scope: string | null, queryScope: string): boolean;
     /** Whether the scope belongs to the given App category. */
@@ -116,9 +116,9 @@ export declare class ScopeRegistry<Definition extends ScopeDefinition = ScopeDef
     /** Declared context tier of one scope, if any. */
     contextTier(scope?: string | null): Definition['contextTier'] | undefined;
     /**
-     * Copy the scopes that accept at least one of the given intents.
+     * Copy the scopes that accept at least one of the given goals.
      *
-     * @param goals - Intent ids to filter by; omit to include every registered scope.
+     * @param goals - Goal ids to filter by; omit to include every registered scope.
      * @returns Descriptions whose arrays are copied so callers cannot mutate registry state.
      */
     describe(goals?: readonly string[]): ScopeDescription<Definition>[];
@@ -132,4 +132,4 @@ export declare class ScopeRegistry<Definition extends ScopeDefinition = ScopeDef
  * @throws A configured error for the first invalid or duplicate declaration.
  */
 export declare function createScopeRegistry<Definition extends ScopeDefinition>(definitions: Iterable<Definition>, policy?: ScopeRegistryPolicy<Definition>): ScopeRegistry<Definition>;
-export type { ScopeDefinition, ScopeDescription, ScopeRegistryPolicy, RegisteredScope, RegisteredScopeEvidence, } from '../../structs/kits/intents/scopes.js';
+export type { ScopeDefinition, ScopeDescription, ScopeRegistryPolicy, RegisteredScope, RegisteredScopeEvidence, } from '../../structs/kits/domains/scopes.js';

package/dist/esm/kits/{intents → domains}/scopes.js

@@ -31,7 +31,7 @@ export class ScopeRegistry {
             ...registrationData(policy, [
                 'idPattern',
                 'assertDefinition',
-                'acceptsIntent',
+                'acceptsTool',
                 'errors',
                 ...listFields,
             ]),
@@ -43,7 +43,7 @@ export class ScopeRegistry {
                     invalid: typeof invalid === 'function' ? invalid.bind(errorPorts) : invalid,
                 }),
             assertDefinition: policy.assertDefinition?.bind(policy),
-            acceptsIntent: policy.acceptsIntent?.bind(policy),
+            acceptsTool: policy.acceptsTool?.bind(policy),
         });
     }
     /**
@@ -52,11 +52,11 @@ export class ScopeRegistry {
      * Every name is checked for conflicts before any of them is stored, so a rejected scope
      * leaves no partial alias entry behind.
      *
-     * @param input - Scope declaration; the raw object is retained for `acceptsIntent` overrides
+     * @param input - Scope declaration; the raw object is retained for `acceptsTool` overrides
      *   while the compiled copy serves lookups.
      * @returns This registry, for chaining.
      * @throws A configured error for a sealed registry, an invalid name/description/category,
-     *   a missing required binding, duplicate intent ids or an already-claimed name.
+     *   a missing required binding, duplicate Tool ids or an already-claimed name.
      */
     register(input) {
         const definition = {
@@ -64,7 +64,7 @@ export class ScopeRegistry {
                 'id',
                 'description',
                 'category',
-                'intentIds',
+                'goalIds',
                 'queryScopeIds',
                 'knowledgeTopicIds',
                 'toolIds',
@@ -75,7 +75,7 @@ export class ScopeRegistry {
             id: input.id,
             description: input.description,
             category: input.category,
-            intentIds: input.intentIds ?? [],
+            goalIds: input.goalIds ?? [],
             queryScopeIds: input.queryScopeIds ?? [],
             knowledgeTopicIds: input.knowledgeTopicIds ?? [],
             toolIds: input.toolIds ?? [],
@@ -110,9 +110,9 @@ export class ScopeRegistry {
                 tags: ['identity'],
             },
             {
-                occur: () => policy.requireIntents === true && !definition.intentIds.length,
+                occur: () => policy.requireGoals === true && !definition.goalIds.length,
                 error: invalid,
-                tags: ['intents', 'required'],
+                tags: ['goals', 'required'],
             },
             {
                 occur: [
@@ -126,18 +126,18 @@ export class ScopeRegistry {
             },
             {
                 occur: [
-                    () => definition.intentIds.some((intent) => typeof intent !== 'string'),
-                    () => new Set(definition.intentIds).size !== definition.intentIds.length,
+                    () => definition.goalIds.some((intent) => typeof intent !== 'string'),
+                    () => new Set(definition.goalIds).size !== definition.goalIds.length,
                 ],
                 error: invalid,
-                tags: ['intents', 'values'],
+                tags: ['goals', 'values'],
             },
         ], tags);
         assertion(policy.assertDefinition?.(input), 'Registry definition assertions must return void synchronously');
         breakWhile(names.some((name) => this.byId.has(name) || this.aliases.has(name)), invalid, [...tags, 'duplicate']);
         const frozen = Object.freeze({
             ...definition,
-            intentIds: Object.freeze([...definition.intentIds]),
+            goalIds: Object.freeze([...definition.goalIds]),
             toolIds: Object.freeze([...definition.toolIds]),
             queryScopeIds: Object.freeze([...definition.queryScopeIds]),
             knowledgeTopicIds: Object.freeze([...definition.knowledgeTopicIds]),
@@ -203,16 +203,16 @@ export class ScopeRegistry {
     /**
      * Whether a scope accepts an intent.
      *
-     * The App may override the declared `intentIds` through `acceptsIntent`; without an
+     * The App may override the declared `goalIds` through `acceptsTool`; without an
      * override the membership check applies.
      */
-    acceptsIntent(scope, goal) {
+    acceptsTool(scope, goal) {
         const definition = this.get(scope);
         if (!definition)
             return false;
-        const ids = definition.intentIds;
-        return this.policy.acceptsIntent
-            ? booleanResult(this.policy.acceptsIntent(this.sources.get(this.normalize(scope)), goal), 'Scope intent predicates must return boolean synchronously')
+        const ids = definition.goalIds;
+        return this.policy.acceptsTool
+            ? booleanResult(this.policy.acceptsTool(this.sources.get(this.normalize(scope)), goal), 'Scope intent predicates must return boolean synchronously')
             : ids.includes(goal);
     }
     /** Whether the scope declares this query scope; a null scope accepts nothing. */
@@ -241,18 +241,18 @@ export class ScopeRegistry {
         return this.get(scope)?.contextTier;
     }
     /**
-     * Copy the scopes that accept at least one of the given intents.
+     * Copy the scopes that accept at least one of the given goals.
      *
-     * @param goals - Intent ids to filter by; omit to include every registered scope.
+     * @param goals - Goal ids to filter by; omit to include every registered scope.
      * @returns Descriptions whose arrays are copied so callers cannot mutate registry state.
      */
     describe(goals) {
         const selected = goals ? new Set(goals) : undefined;
         return [...this.byId.values()]
-            .filter((item) => !selected || item.intentIds.some((goal) => selected.has(goal)))
+            .filter((item) => !selected || item.goalIds.some((goal) => selected.has(goal)))
             .map((item) => ({
             ...item,
-            intentIds: [...item.intentIds],
+            goalIds: [...item.goalIds],
             queryScopeIds: [...item.queryScopeIds],
             knowledgeTopicIds: [...item.knowledgeTopicIds],
             toolIds: [...item.toolIds],

package/dist/esm/kits/index.d.ts

@@ -5,13 +5,13 @@
  * path; this file only exists for callers that prefer one import for the whole set. Core
  * never imports from this directory, so nothing here becomes a runtime requirement.
  *
- * Exports: the Kit namespaces (`Interaction`, `Intents`, `Tools`, `Knowledge`, `Answering`,
+ * Exports: the Kit namespaces (`Interaction`, `Tools`, `Knowledge`, `Answering`,
  * `Presentation`, `Normalization`, `Delivery`, `Projection`, `Aggregation`, `Retrieval`,
- * `Evidence`, `Policies`, `Candidates`, `TextSkills`, `TextSearch`, `ModelCalls`,
- * `VectorSearch`) plus every Kit type. Individual Kit paths stay the default.
+ * `Evidence`, `Policies`, `Candidates`, `TextSkills`, `TextSearch`, `TextBlocks`,
+ * `ModelCalls`, `VectorSearch`) plus every Kit type. Individual Kit paths stay the default.
  */
 export { Interaction } from './interaction/index.js';
-export { Intents } from './intents/index.js';
+export * from './domains/index.js';
 export { Tools } from './tools.js';
 export { Knowledge } from './knowledge/index.js';
 export { Answering } from './answering/index.js';
@@ -27,8 +27,9 @@ export { Candidates } from './candidates.js';
 export { TextSkills } from './text-skills.js';
 export { TextSearch } from './search.js';
 export * from './search.js';
+export { TextBlocks } from './text-blocks.js';
+export * from './text-blocks.js';
 export * from './interaction/index.js';
-export * from './intents/index.js';
 export * from './tools.js';
 export * from './knowledge/index.js';
 export * from './answering/index.js';

package/dist/esm/kits/index.js

@@ -5,13 +5,13 @@
  * path; this file only exists for callers that prefer one import for the whole set. Core
  * never imports from this directory, so nothing here becomes a runtime requirement.
  *
- * Exports: the Kit namespaces (`Interaction`, `Intents`, `Tools`, `Knowledge`, `Answering`,
+ * Exports: the Kit namespaces (`Interaction`, `Tools`, `Knowledge`, `Answering`,
  * `Presentation`, `Normalization`, `Delivery`, `Projection`, `Aggregation`, `Retrieval`,
- * `Evidence`, `Policies`, `Candidates`, `TextSkills`, `TextSearch`, `ModelCalls`,
- * `VectorSearch`) plus every Kit type. Individual Kit paths stay the default.
+ * `Evidence`, `Policies`, `Candidates`, `TextSkills`, `TextSearch`, `TextBlocks`,
+ * `ModelCalls`, `VectorSearch`) plus every Kit type. Individual Kit paths stay the default.
  */
 export { Interaction } from './interaction/index.js';
-export { Intents } from './intents/index.js';
+export * from './domains/index.js';
 export { Tools } from './tools.js';
 export { Knowledge } from './knowledge/index.js';
 export { Answering } from './answering/index.js';
@@ -27,9 +27,10 @@ export { Candidates } from './candidates.js';
 export { TextSkills } from './text-skills.js';
 export { TextSearch } from './search.js';
 export * from './search.js';
+export { TextBlocks } from './text-blocks.js';
+export * from './text-blocks.js';
 // Types remain available with either individual or explicit bulk imports.
 export * from './interaction/index.js';
-export * from './intents/index.js';
 export * from './tools.js';
 export * from './knowledge/index.js';
 export * from './answering/index.js';

package/dist/esm/kits/knowledge/catalog.js

@@ -7,6 +7,7 @@
  *
  * Exports: `defineKnowledgeCatalog`, and the knowledge document/read/snapshot types.
  */
+import { nativeSubFlowSync } from '../../diagnostics/native-sub-flow.js';
 import { readonlyCatalog } from '../../utils/catalog.js';
 import { compileKnowledgeDocument, knowledgeText } from './sections.js';
 import { observeSafely } from '../../utils/observer.js';
@@ -65,37 +66,39 @@ export function defineKnowledgeCatalog(documents, options = {}) {
         ...readonlyCatalog([...catalog.values()].map((entry) => entry.document), (id) => new TypeError(`Unknown knowledge document: ${id}`)),
         sectionIds,
         assertSelection,
-        read(input) {
-            const { read, entry } = resolve(input), raw = read.selection;
-            const selection = raw.mode === 'document'
-                ? Object.freeze({ mode: 'document' })
-                : Object.freeze({ mode: raw.mode, sectionIds: Object.freeze([...raw.sectionIds]) });
-            const content = (selection.mode === 'document'
-                ? knowledgeText(entry.document.parts)
-                : selection.sectionIds
-                    .map((id) => knowledgeText(entry.sections.get(id).parts, selection.mode === 'subtree'))
-                    .join('\n\n')).trim();
-            if (maxChars !== undefined && content.length > maxChars)
-                throw new RangeError('Knowledge selection exceeds its budget');
-            // Preserve the existing opaque snapshot identity format.
-            const identitySelection = selection.mode === 'document'
-                ? selection
-                : { mode: selection.mode, sections: selection.sectionIds };
-            const snapshot = Object.freeze({
-                documentId: read.documentId,
-                selection,
-                revision: entry.document.revision,
-                locale: entry.document.locale,
-                content,
-                id: JSON.stringify([
-                    read.documentId,
-                    entry.document.revision,
-                    entry.document.locale,
-                    identitySelection,
-                ]),
+        read(input, context = {}) {
+            return nativeSubFlowSync(context, 'knowledge', input.documentId, () => {
+                const { read, entry } = resolve(input), raw = read.selection;
+                const selection = raw.mode === 'document'
+                    ? Object.freeze({ mode: 'document' })
+                    : Object.freeze({ mode: raw.mode, sectionIds: Object.freeze([...raw.sectionIds]) });
+                const content = (selection.mode === 'document'
+                    ? knowledgeText(entry.document.parts)
+                    : selection.sectionIds
+                        .map((id) => knowledgeText(entry.sections.get(id).parts, selection.mode === 'subtree'))
+                        .join('\n\n')).trim();
+                if (maxChars !== undefined && content.length > maxChars)
+                    throw new RangeError('Knowledge selection exceeds its budget');
+                // Preserve the existing opaque snapshot identity format.
+                const identitySelection = selection.mode === 'document'
+                    ? selection
+                    : { mode: selection.mode, sections: selection.sectionIds };
+                const snapshot = Object.freeze({
+                    documentId: read.documentId,
+                    selection,
+                    revision: entry.document.revision,
+                    locale: entry.document.locale,
+                    content,
+                    id: JSON.stringify([
+                        read.documentId,
+                        entry.document.revision,
+                        entry.document.locale,
+                        identitySelection,
+                    ]),
+                });
+                observeSafely(observe, snapshot);
+                return snapshot;
             });
-            observeSafely(observe, snapshot);
-            return snapshot;
         },
     });
 }

package/dist/esm/kits/policies.d.ts

@@ -38,7 +38,7 @@ export declare function definePolicySet<Input, Kind extends string>(definitions:
  *   boolean `handled` or omits `value` while claiming to have handled the input.
  */
 export declare function defineRecoveryChain<Input, Result>(definitions: readonly RecoveryDefinition<Input, Result>[]): Readonly<{
-    tryRecover: (input: Input) => RecoveryResult<Result>;
+    tryRecover: (input: Input, execution?: Partial<import("../structs/common.js").ExecutionContext>) => RecoveryResult<Result>;
     definitions: readonly Readonly<{
         id: string;
         description: string;