@soederpop/luca 0.0.32 → 0.0.34

package/src/container.ts

@@ -644,13 +644,13 @@ export class Container<Features extends AvailableFeatures = AvailableFeatures, C
    *
    * @example
    * ```ts
-   * const info = container.inspect()
+   * const info = container.introspect()
    * console.log(info.methods)   // all public methods with descriptions
    * console.log(info.getters)   // all getters with return types
    * console.log(info.registries) // features, clients, servers, etc.
    * ```
    */
-  inspect(): ContainerIntrospection {
+  introspect(): ContainerIntrospection {
     const className = this.constructor.name
     const buildTimeData = getContainerBuildTimeData(className) || {}
 
@@ -723,11 +723,11 @@ export class Container<Features extends AvailableFeatures = AvailableFeatures, C
    *
    * @example
    * ```ts
-   * console.log(container.inspectAsText())           // full description
-   * console.log(container.inspectAsText('methods'))   // just methods
+   * console.log(container.introspectAsText())           // full description
+   * console.log(container.introspectAsText('methods'))   // just methods
    * ```
    */
-  inspectAsText(sectionOrDepth?: IntrospectionSection | number, startHeadingDepth?: number): string {
+  introspectAsText(sectionOrDepth?: IntrospectionSection | number, startHeadingDepth?: number): string {
     let section: IntrospectionSection | undefined
     let depth = 1
 
@@ -738,18 +738,13 @@ export class Container<Features extends AvailableFeatures = AvailableFeatures, C
       depth = sectionOrDepth
     }
 
-    const data = this.inspect()
+    const data = this.introspect()
     return presentContainerIntrospectionAsMarkdown(data, depth, section)
   }
 
-  /** Alias for inspectAsText. */
-  introspectAsText(sectionOrDepth?: IntrospectionSection | number, startHeadingDepth?: number): string {
-    return this.inspectAsText(sectionOrDepth, startHeadingDepth)
-  }
-  
-  /** Alias for inspect, returns JSON introspection data. */
+  /** Returns JSON introspection data. */
   introspectAsJSON(): ContainerIntrospection {
-    return this.inspect()
+    return this.introspect()
   }
 
   /**
@@ -758,7 +753,7 @@ export class Container<Features extends AvailableFeatures = AvailableFeatures, C
    *
    * @example
    * ```ts
-   * console.log(container.inspectAsType())
+   * console.log(container.introspectAsType())
    * // interface NodeContainer {
    * //   feature<T>(id: string, options?: object): T;
    * //   readonly uuid: string;
@@ -766,12 +761,8 @@ export class Container<Features extends AvailableFeatures = AvailableFeatures, C
    * // }
    * ```
    */
-  inspectAsType(): string {
-    return this.introspectAsType()
-  }
-
   introspectAsType(): string {
-    const data = this.inspect()
+    const data = this.introspect()
     return presentContainerIntrospectionAsTypeScript(data)
   }
 

package/src/helper.ts

@@ -50,22 +50,12 @@ export abstract class Helper<T extends HelperState = HelperState, K extends Help
     return {} as T
   }
 
-  /** Alias for introspect */
-  static inspect(section?: IntrospectionSection) : HelperIntrospection | undefined {
-    return this.introspect(section)
-  }
-
   static introspect(section?: IntrospectionSection) : HelperIntrospection | undefined {
     const data = introspect((this as any).shortcut || '')
     if (!data || !section) return data
     return filterIntrospection(data, section)
   }
 
-  /** Alias for introspectAsText */
-  static inspectAsText(sectionOrDepth?: IntrospectionSection | number, startHeadingDepth?: number) : string {
-    return this.introspectAsText(sectionOrDepth, startHeadingDepth)
-  }
-
   static introspectAsText(sectionOrDepth?: IntrospectionSection | number, startHeadingDepth?: number) : string {
     const { section, depth } = resolveIntrospectAsTextArgs(sectionOrDepth, startHeadingDepth)
     const introspection = this.introspect()
@@ -80,7 +70,7 @@ export abstract class Helper<T extends HelperState = HelperState, K extends Help
    *
    * @example
    * ```ts
-   * console.log(container.feature('fs').inspectAsType())
+   * console.log(container.feature('fs').introspectAsType())
    * // interface FS {
    * //   readonly cwd: string;
    * //   readFile(path: string): Promise<string>;
@@ -88,10 +78,6 @@ export abstract class Helper<T extends HelperState = HelperState, K extends Help
    * // }
    * ```
    */
-  static inspectAsType(section?: IntrospectionSection) : string {
-    return this.introspectAsType(section)
-  }
-
   static introspectAsType(section?: IntrospectionSection) : string {
     const introspection = this.introspect()
     if (!introspection) return ''
@@ -113,11 +99,6 @@ export abstract class Helper<T extends HelperState = HelperState, K extends Help
     return filterIntrospection(base, section)
   }
 
-  /** Alias for introspect */
-  inspect(section?: IntrospectionSection) : HelperIntrospection | undefined {
-    return this.introspect(section)
-  }
-
   /**
    * Returns the introspection data formatted as a markdown string.
    *
@@ -131,11 +112,6 @@ export abstract class Helper<T extends HelperState = HelperState, K extends Help
     return presentIntrospectionJSONAsMarkdown(introspection, depth, section)
   }
 
-  /** Alias for introspectAsText */
-  inspectAsText(sectionOrDepth?: IntrospectionSection | number, startHeadingDepth?: number) : string {
-    return this.introspectAsText(sectionOrDepth, startHeadingDepth)
-  }
-
   /**
    * Returns the introspection data formatted as a TypeScript interface declaration.
    * Useful for AI agents that reason better with structured type information,
@@ -147,11 +123,6 @@ export abstract class Helper<T extends HelperState = HelperState, K extends Help
     return presentIntrospectionAsTypeScript(introspection, section)
   }
 
-  /** Alias for introspectAsType */
-  inspectAsType(section?: IntrospectionSection) : string {
-    return this.introspectAsType(section)
-  }
-
   constructor(options: K, context: ContainerContext) {
     const optionSchema = (this.constructor as any).optionsSchema
     if (optionSchema && typeof optionSchema.safeParse === 'function') {
@@ -178,6 +149,20 @@ export abstract class Helper<T extends HelperState = HelperState, K extends Help
 
     this.container.emit('helperInitialized', this)
   }
+
+  /**
+   * Returns the names of the methods for this helper.
+  */
+  get $methods() : string[] {
+    return Object.keys((this.introspect() || {}).methods || [])
+  }
+ 
+  /**
+   * Returns the names of the getters for this helper.
+  */
+  get $getters() : string[] {
+    return Object.keys((this.introspect() || {}).getters || [])
+  }
   
   /**
    * The static shortcut identifier for this helper type, e.g. "features.assistant".
@@ -265,7 +250,7 @@ export abstract class Helper<T extends HelperState = HelperState, K extends Help
    * If a tool has no explicit handler but this instance has a method with
    * the same name, a handler is auto-generated that delegates to that method.
    */
-  toTools(): { schemas: Record<string, z.ZodType>, handlers: Record<string, Function> } {
+  toTools(options?: { only?: string[], except?: string[] }): { schemas: Record<string, z.ZodType>, handlers: Record<string, Function> } {
     // Walk the prototype chain collecting static tools (parent-first, child overwrites)
     const merged: Record<string, { schema: z.ZodType, description?: string, handler?: Function }> = {}
     const chain: Function[] = []
@@ -285,10 +270,16 @@ export abstract class Helper<T extends HelperState = HelperState, K extends Help
     // Instance tools win over static
     Object.assign(merged, this._instanceTools)
 
+    // Filter tools by only/except before building schemas and handlers
+    let names = Object.keys(merged)
+    if (options?.only) names = names.filter(n => options.only!.includes(n))
+    if (options?.except) names = names.filter(n => !options.except!.includes(n))
+
     const schemas: Record<string, z.ZodType> = {}
     const handlers: Record<string, Function> = {}
 
-    for (const [name, entry] of Object.entries(merged)) {
+    for (const name of names) {
+      const entry = merged[name]!
       // If the tool entry has a description but the schema doesn't, attach it
       // so addTool() picks it up from jsonSchema.description.
       schemas[name] = entry.description && !entry.schema.description
@@ -842,4 +833,4 @@ function normalizeTypeString(type: string): string {
     }
   )
   return type
-}
+}