@soederpop/luca 0.0.25 → 0.0.28

package/src/container.ts

@@ -10,6 +10,7 @@ import { pluralize, singularize } from 'inflect'
 import { z } from 'zod'
 import { ContainerStateSchema, describeZodShape } from './schemas/base'
 import { getContainerBuildTimeData, type ContainerIntrospection, type RegistryIntrospection, type IntrospectionSection } from './introspection/index'
+import { ContainerDescriber } from './container-describer'
 
 export { z }
 
@@ -148,6 +149,16 @@ export class Container<Features extends AvailableFeatures = AvailableFeatures, C
     }
   }
 
+  private _describer?: ContainerDescriber
+
+  /** Lazy-initialized ContainerDescriber for introspecting registries, helpers, and members. */
+  get describer(): ContainerDescriber {
+    if (!this._describer) {
+      this._describer = new ContainerDescriber(this)
+    }
+    return this._describer
+  }
+
   /**
    * Add a value to the container's shared context, which is passed to all helper instances.
    * Accepts either a key and value, or an object of key-value pairs to add.

package/src/helper.ts

@@ -138,9 +138,16 @@ export abstract class Helper<T extends HelperState = HelperState, K extends Help
     this.container.emit('helperInitialized', this)
   }
   
-  /** 
+  /**
+   * The static shortcut identifier for this helper type, e.g. "features.assistant".
+  */
+  get shortcut(): string {
+    return (this.constructor as any).shortcut || ''
+  }
+
+  /**
    * Every helper has a cache key which is computed at the time it is created through the container.
-   * 
+   *
    * This ensures only a single instance of the helper exists for the requested options.
   */
   get cacheKey() {
@@ -189,6 +196,26 @@ export abstract class Helper<T extends HelperState = HelperState, K extends Help
     return this
   }
 
+  /**
+   * Called when another helper (e.g. an assistant) consumes this helper's
+   * tools via `use()`. Override this to detect the consumer type and react —
+   * for example, adding system prompt extensions to an assistant.
+   *
+   * Use `consumer.shortcut` to identify the consumer type:
+   * ```typescript
+   * override setupToolsConsumer(consumer: Helper) {
+   *   if (consumer.shortcut === 'features.assistant') {
+   *     (consumer as any).addSystemPromptExtension('myFeature', 'usage hints here')
+   *   }
+   * }
+   * ```
+   *
+   * The default implementation is a no-op.
+   *
+   * @param consumer - The helper instance that is consuming this helper's tools
+   */
+  setupToolsConsumer(consumer: Helper): void {}
+
   /**
    * Collect all tools from the inheritance chain and instance, returning
    * { schemas, handlers } with matching keys. Walks the prototype chain