@n1k1t/pipelain 0.4.15 → 1.0.1

package/.claude/settings.local.json

@@ -0,0 +1,7 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npx jest *)"
+    ]
+  }
+}

package/AGENTS.md

@@ -0,0 +1,20 @@
+# AGENTS.md
+
+Instructions for AI agents working in this repository (`@n1k1t/pipelain`).
+
+## Mandatory rules
+
+- If the `caveman` skill is installed, use it for communication in this session.
+
+## Project documentation
+
+Before starting work, review the documentation in `.ai/docs`:
+
+- [`.ai/docs/structure.md`](.ai/docs/structure.md) — project structure, purpose of the main directories and files.
+- [`.ai/docs/style.md`](.ai/docs/style.md) — code style: import/export order, object and function formatting.
+
+## Useful commands
+
+- `npm test` — run tests (Jest).
+- `npm run build:check` — type-check without building (`tsc --noEmit`).
+- `npm run build` — build the project into `lib/`.

package/README.md

@@ -33,14 +33,17 @@ Powerful utility to build and execute type-safe AI pipelines with structured out
   - [AI Step with LLM Configuration](#ai-step-with-llm-configuration)
   - [AI Step with Fallback](#ai-step-with-fallback)
   - [Debugging AI Steps](#debugging-ai-steps)
+  - [Execution Reports](#execution-reports)
   - [Combining self and ai Steps](#combining-self-and-ai-steps)
   - [Parallel Execution with swarm](#parallel-execution-with-swarm)
   - [Iterative Execution with loop](#iterative-execution-with-loop)
   - [Multi-Provider Pipelines](#multi-provider-pipelines)
+  - [Custom Model Routing](#custom-model-routing)
   - [MCP (Model Context Protocol) Integration](#mcp-model-context-protocol-integration)
   - [Using Skills](#using-skills)
 - [Extensions](#extensions)
   - [Custom LLM Tools](#custom-llm-tools)
+  - [LLM Tool Hooks](#llm-tool-hooks)
   - [Custom LLM Skills](#custom-llm-skills)
   - [Registering Skills from Markdown](#registering-skills-from-markdown)
 - [License](#license)
@@ -114,9 +117,11 @@ The following environment variables are supported:
 | --- | --- | --- |
 | `PIPELAIN_API_KEY` | API key for the LLM provider. | - |
 | `PIPELAIN_API_URL` | Custom API URL for the LLM provider. | - |
-| `PIPELAIN_SKILLS_PATHS` | Directories paths where LLM skills are stored (separated by `;`). | `~/.agents/skills` |
+| `PIPELAIN_SKILLS_PATHS` | Directories paths where LLM skills are stored (separated by `;`). | `./.agents/skills;~/.agents/skills` |
 | `PIPELAIN_MODEL` | Default LLM model to use. | `gemini-flash-latest` |
 | `PIPELAIN_PROVIDER` | LLM provider name (e.g., `google`, `openai`). | - |
+| `PIPELAIN_FLAGS_REPORT` | Save an HTML report of the pipeline execution. | `false` |
+| `PIPELAIN_FLAGS_DEBUG` | Enable debug mode for all AI steps. | `false` |
 | `EXA_API_KEY` | API key for Exa web search tools. | - |
 
 ## Pipeline Step Utilities
@@ -136,7 +141,7 @@ Used to create different types of steps:
 General-purpose utilities:
 - `content`: `ContentFactory` instance to create structured prompt content (articles, tasks, rules, attachments).
 - `bash`: Execute shell commands on the local machine.
-- `log`: Emit log events for the current pipeline session.
+- `log`: Emit `INFO` log events for the current pipeline session (shown in stdout and HTML reports).
 
 ### `context`
 Shared state and configuration:
@@ -209,13 +214,13 @@ To use a custom logger or override specific event handlers, use `PipelineStdout`
 import { PipelineStdout } from '@n1k1t/pipelain';
 
 const customStdout = PipelineStdout
-  .build(console) // Pass any logger with .info and .warn methods
-  .override('log', (event) => {
-    console.log(`[CUSTOM LOG] ${event.message}`);
+  .build(console) // Pass any logger with .info, .warn and .debug methods
+  .override('log', ({ level, message }) => {
+    console.log(`[${level}]`, ...message);
   })
-  .override('step:run', (event) => {
-    if (event.meta.state === 'SUCCESS') {
-      console.log(`Step ${event.step.title} finished in ${event.meta.spent}ms`);
+  .override('step:run', ({ step }) => {
+    if (step.meta.is('DONE')) {
+      console.log(`Step ${step.title} finished in ${step.meta.spent}ms`);
     }
   });
 
@@ -225,6 +230,17 @@ const customStdout = PipelineStdout
 })();
 ```
 
+Each pipeline, step and AI action has a `meta` object with its execution state:
+
+| Property / Method | Description |
+| --- | --- |
+| `state` | `'INIT' \| 'PENDING' \| 'DONE' \| 'ERROR'` |
+| `spent` | Time spent since creation (ms). |
+| `timestamp` | Creation timestamp. |
+| `is(state \| state[])` | Checks the current state. |
+
+The `log` event has a `level` field: `'DEBUG' | 'INFO' | 'WARN'`. `utils.log(...)` emits `INFO`.
+
 ### Structured Prompt Content
 
 You can combine multiple content types to create a rich, structured prompt for the AI:
@@ -353,7 +369,28 @@ You can use the `.debug()` method to inspect the prompts sent to the AI. When de
 )
 ```
 
-The prompt will be saved to: `.pipelain/${timestamp}-${session-id}/${step-title}.md`.
+The prompt will be saved to: `.pipelain/debug/YYYY-MM-DD--HH-mm-ss--<session-id>/<step-number>.<step-trace>.md`.
+
+### Execution Reports
+
+Use `.report()` on the pipeline compiler (or set `PIPELAIN_FLAGS_REPORT=true`) to save an HTML report of the AI steps execution:
+
+```ts
+const pipeline = PipelineCompiler
+  .build('Translate')
+  .report() // Enables HTML report
+  .input(z.string())
+  .step('translated', ({ factory, context }) => factory
+    .ai('Translating')
+    .prompt([`Translate "${context.input}" into Spanish`])
+  );
+```
+
+The report is saved into `.pipelain/reports/YYYY-MM-DD--HH-mm-ss--<session-id>.html` and includes:
+
+- AI steps with messages, actions (tools, reasoning, fallbacks), output and timing;
+- `INFO` and `WARN` logs emitted via `utils.log`;
+- token usage per provider and model (prompt, cached, completion) and total session time.
 
 ### Combining `self` and `ai` Steps
 
@@ -504,6 +541,29 @@ const pipeline = PipelineCompiler
   );
 ```
 
+### Custom Model Routing
+
+`LlmRouter` picks a provider by model name. Use `register` to route models matched by a [minimatch](https://github.com/isaacs/minimatch) pattern to your own provider:
+
+```ts
+import { LlmRouter, llm } from '@n1k1t/pipelain';
+
+const router = LlmRouter
+  .build()
+  .register('corp-*', (model) => llm.providers.LlmProxyProvider.build(model, {
+    name: 'corp', // Shown in usage stats and reports instead of "proxy"
+    connection: { key: process.env.CORP_API_KEY!, url: 'https://llm.corp.local/v1' },
+  }));
+
+pipeline.step('analysis', ({ factory }) => factory
+  .ai('Corp Analysis')
+  .llm(() => router.provide('corp-gpt-4o'))
+  .prompt(['...'])
+);
+```
+
+Registrations are checked in order and the first match wins. Unmatched models fall back to the default routing.
+
 ### MCP (Model Context Protocol) Integration
 
 You can integrate MCP servers into your pipeline steps. This allows the AI to use tools provided by external MCP servers. You can also filter which tools are enabled:
@@ -526,6 +586,9 @@ pipeline.step('mcp_research', ({ factory, context }) => factory
           enabled: ['list-files', 'read-file'],
           // Or disable specific tools
           // disabled: ['delete-file'],
+
+          // Add prefix to tool names (e.g. "gdrive_read-file")
+          prefix: 'gdrive_',
         },
       }),
     ],
@@ -534,6 +597,8 @@ pipeline.step('mcp_research', ({ factory, context }) => factory
 );
 ```
 
+Use `tools.prefix` to avoid name conflicts between MCP servers or with built-in tools. The `enabled` and `disabled` patterns match tool names without the prefix. Hooks by name (`LlmHook.build('gdrive_read-file')`) match tool names with the prefix.
+
 ### Using Skills
 
 Skills allow you to inject reusable domain-specific instructions or workflows into your AI steps. You can manage them via `factory.skills`:
@@ -562,7 +627,7 @@ You can create custom tools for the AI using `LlmToolCompiler`. This allows the
 
 ```ts
 import z from 'zod/v3';
-import { LlmToolCompiler } from '@n1k1t/pipelain';
+import { LlmToolCompiler, LlmToolExecutionError } from '@n1k1t/pipelain';
 
 // 1. Define the tool
 const weatherTool = LlmToolCompiler
@@ -575,6 +640,11 @@ const weatherTool = LlmToolCompiler
     condition: z.string()
   }))
   .execute(() => async ({ city }) => {
+    if (!city.trim()) {
+      // Errors are reported back to the AI as "Execution failed: <reason>"
+      throw LlmToolExecutionError.build('City name is empty');
+    }
+
     // Your implementation here
     return { temperature: 22, condition: 'Sunny' };
   });
@@ -592,6 +662,77 @@ pipeline.step('weather_report', ({ factory, context }) => factory
 );
 ```
 
+### LLM Tool Hooks
+
+Use `LlmHook` to intercept tool calls inside an `ai` step. With a hook you can validate or modify the input, override the output, skip the original execution or handle errors. Provide hooks to the step with the `.hooks([...])` method.
+
+A hook matches a tool by one of these targets:
+
+- `LlmHook.build('name')` matches a tool by its name (built-in, custom or MCP tool).
+- `LlmHook.build(compiler)` matches a tool compiled from the same `LlmToolCompiler` instance or its clones (for example, built-in tools with options).
+- `LlmHook.build(tool)` matches the same `Tool` instance.
+
+When a hook has a name (`LlmHook.build(compiler, { name: 'weather' })`), the name has priority over the compiler or tool.
+
+Each hook has two handlers:
+
+- `before({ input, next, session, context, step })` runs instead of the original `execute`. The original `execute` runs only when you call `next(input)`. If you do not call `next`, the returned value becomes the tool output.
+- `after({ output, input, session, context, step })` runs after `before` is settled. `output` is a `PromiseSettledResult`, so you can handle errors. The returned value becomes the final tool output and must match the tool output type. By default, `after` rethrows the error or returns the value.
+
+```ts
+import { LlmHook, LlmToolExecutionError } from '@n1k1t/pipelain';
+
+// Restrict paths of the built-in "write" tool
+const guard = LlmHook
+  .build<{ input: { path: string; content: string } }>('write')
+  .before(({ input, next }) => {
+    if (input.path.startsWith('/etc')) {
+      throw LlmToolExecutionError.build('Writing to /etc is not allowed');
+    }
+
+    return next(input);
+  });
+
+// Cache results of the custom tool and convert errors for the AI
+const cache = new Map<string, { temperature: number; condition: string }>();
+const weather = LlmHook
+  .build(weatherTool)
+  .before(async ({ input, next }) => {
+    const cached = cache.get(input.city);
+    if (cached) {
+      return cached;
+    }
+
+    const output = await next(input);
+
+    cache.set(input.city, output);
+    return output;
+  })
+  .after(({ output }) => {
+    if (output.status === 'rejected') {
+      throw LlmToolExecutionError.build(output.reason);
+    }
+
+    return output.value;
+  });
+
+pipeline.step('hooked', ({ factory, context }) => factory
+  .ai('Executing with hooks')
+  .llm(({ context }) => context.llm.assign({
+    tools: factory.tools
+      .files('read-write')
+      .custom({ weather: weatherTool })
+      .provide(),
+  }))
+  .hooks([guard, weather])
+  .prompt([`Check weather in ${context.input} and save it to weather.md`])
+);
+```
+
+When several hooks match the same tool, they run in the order of the array: the `before` handler of the first hook runs first, and its `after` handler runs last.
+
+> Built-in tools with options (for example, `write` in `files('read-write')`) are clones of the original compiler. A hook built from `llm.tools.write` matches them too.
+
 ### Custom LLM Skills
 
 You can also provide custom skills programmatically:

package/assets/report/index.hbs

@@ -22,13 +22,21 @@
           PipelAIn Report
         </h1>
         <div class="session-info">
-          <div class="info-item">
-            <span class="info-label">Session ID:</span>
-            <span class="info-value text-mono">{{session.id}}</span>
+          <div class="info-column">
+            <div class="info-item">
+              <span class="info-label">Session ID:</span>
+              <span class="info-value text-mono">{{session.id}}</span>
+            </div>
           </div>
-          <div class="info-item">
-            <span class="info-label">Timestamp:</span>
-            <span class="info-value">{{formatDate session.timestamp}} {{formatTime session.timestamp}}</span>
+          <div class="info-column">
+            <div class="info-item">
+              <span class="info-label">Timestamp:</span>
+              <span class="info-value">{{formatDate session.timestamp}} {{formatTime session.timestamp}}</span>
+            </div>
+            <div class="info-item">
+              <span class="info-label">Spent:</span>
+              <span class="info-value">{{formatDuration session.spent}}</span>
+            </div>
           </div>
         </div>
       </div>
@@ -37,12 +45,16 @@
       <div class="metrics-grid">
         <div class="metric-card">
           <div class="metric-label">Total Tokens</div>
-          <div class="metric-value">{{sum usage.llm.total.prompt usage.llm.total.completion}}</div>
+          <div class="metric-value">{{sum (sum usage.llm.total.prompt usage.llm.total.cached) usage.llm.total.completion}}</div>
         </div>
         <div class="metric-card">
           <div class="metric-label">Prompt Tokens</div>
           <div class="metric-value">{{usage.llm.total.prompt}}</div>
         </div>
+        <div class="metric-card">
+          <div class="metric-label">Cached Tokens</div>
+          <div class="metric-value">{{usage.llm.total.cached}}</div>
+        </div>
         <div class="metric-card">
           <div class="metric-label">Completion Tokens</div>
           <div class="metric-value">{{usage.llm.total.completion}}</div>
@@ -52,31 +64,69 @@
 
     <!-- Snapshots -->
     <main class="snapshots-section">
-      <h2 class="section-title">Steps <span class="text-muted">({{snapshots.length}})</span></h2>
+      <h2 class="section-title">Snapshots <span class="text-muted">({{snapshots.length}})</span></h2>
 
       <div class="snapshots-list">
         {{#each snapshots}}
-          <details class="snapshot-card {{#if error}}state-error{{else}}state-done{{/if}}">
+          {{#if (eq type "log")}}
+          <!-- Log -->
+          <details class="snapshot-card state-log log-{{level}}">
+            <summary class="snapshot-summary">
+              <div class="summary-left">
+                <span class="expand-arrow">▶</span>
+                <span class="action-type-badge badge-log-{{level}}">{{level}}</span>
+                <span class="log-preview text-mono">{{message}}</span>
+              </div>
+            </summary>
+
+            <div class="snapshot-content">
+              <pre class="log-message"><code>{{message}}</code></pre>
+            </div>
+          </details>
+          {{else}}
+          <details class="snapshot-card {{#if (eq type "step:error")}}state-error{{else}}state-done{{/if}}">
             <summary class="snapshot-summary">
               <div class="summary-left">
                 <span class="expand-arrow">▶</span>
+                {{#if (eq type "step:error")}}
+                  <span class="action-type-badge badge-error">ERROR</span>
+                {{else}}
+                  <span class="action-type-badge badge-success">DONE</span>
+                {{/if}}
                 <span class="step-title">{{step.title}}</span>
               </div>
               <div class="summary-right">
                 <span class="llm-tag text-muted">{{llm.name}}/{{llm.model}}</span>
-                {{#if error}}
-                  <span class="badge badge-error">ERROR</span>
-                {{else}}
-                  {{#if usage.totalTokens}}
-                    <span class="usage-tag">{{usage.totalTokens}} tokens</span>
-                  {{/if}}
-                  <span class="badge badge-success">DONE</span>
+                {{#if (tokens usage "total")}}
+                  <span class="usage-tag">{{tokens usage "total"}} tokens</span>
                 {{/if}}
-                <span class="time-tag text-muted">{{formatTime timestamp}}</span>
+                <span class="time-tag text-muted">{{formatDuration meta.spent}}</span>
               </div>
             </summary>
 
             <div class="snapshot-content">
+              {{#if usage}}
+                <!-- Step Tokens -->
+                <div class="tokens-grid">
+                  <div class="token-cell">
+                    <span class="token-label">Total Tokens</span>
+                    <span class="token-value text-mono">{{tokens usage "total"}}</span>
+                  </div>
+                  <div class="token-cell">
+                    <span class="token-label">Prompt Tokens</span>
+                    <span class="token-value text-mono">{{tokens usage "prompt"}}</span>
+                  </div>
+                  <div class="token-cell">
+                    <span class="token-label">Cached Tokens</span>
+                    <span class="token-value text-mono">{{tokens usage "cached"}}</span>
+                  </div>
+                  <div class="token-cell">
+                    <span class="token-label">Completion Tokens</span>
+                    <span class="token-value text-mono">{{tokens usage "completion"}}</span>
+                  </div>
+                </div>
+              {{/if}}
+
               <!-- Step Metrics -->
               <div class="step-meta">
                 <div class="meta-row">
@@ -84,15 +134,14 @@
                   <span class="meta-value text-mono">{{llm.name}}/{{llm.model}}</span>
                 </div>
 
-                {{#if usage}}
-                  <div class="meta-row">
-                    <span class="meta-label">Usage:</span>
-                    <span class="meta-value text-mono">{{usage.inputTokens}} (prompt) + {{usage.outputTokens}} (completion)</span>
-                  </div>
-                {{/if}}
+                <div class="meta-row">
+                  <span class="meta-label">Started:</span>
+                  <span class="meta-value text-mono">{{formatTime meta.timestamp}}</span>
+                </div>
               </div>
 
-              {{#if error}}
+
+              {{#if (eq type "step:error")}}
                 <div class="error-box">
                   <div class="error-header">
                     <svg class="error-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
@@ -167,6 +216,9 @@
                           {{#if (eq type "ai:tool")}}
                             <span class="action-type-badge badge-tool">TOOL</span>
                             <span class="action-name text-mono">{{name}}</span>
+                            {{#if (previewInput input)}}
+                              <span class="action-preview text-mono">{{previewInput input}}</span>
+                            {{/if}}
                           {{else if (eq type "ai:fallback")}}
                             <span class="action-type-badge badge-fallback">FALLBACK</span>
                             <span class="action-name text-mono">{{llm.old.model}}</span>
@@ -177,6 +229,7 @@
                         <div class="summary-right">
                           {{#if (eq type "ai:fallback")}}
                             <span class="badge badge-error">{{error.type}}</span>
+                            <span class="time-tag">{{formatDuration meta.spent}}</span>
                           {{else}}
                             <span class="llm-tag text-muted">{{llm.name}}/{{llm.model}}</span>
                             <span class="badge badge-{{meta.state}}">{{meta.state}}</span>
@@ -321,6 +374,7 @@
               </div>
             </div>
           </details>
+          {{/if}}
         {{/each}}
       </div>
     </main>

package/assets/report/main.css

@@ -72,14 +72,25 @@ body {
 
 .session-info {
   display: flex;
-  flex-direction: column;
-  gap: 10px;
+  flex-wrap: wrap;
+  gap: 10px 20px;
   background: var(--card-bg);
   padding: 10px 20px;
   border-radius: 8px;
   border: 1px solid var(--border);
 }
 
+.info-column {
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+}
+
+.info-column + .info-column {
+  padding-left: 20px;
+  border-left: 1px solid var(--border);
+}
+
 .info-item {
   display: flex;
   gap: 10px;
@@ -200,6 +211,46 @@ details[open] > summary .expand-arrow {
   border-left: 4px solid var(--color-error);
 }
 
+.snapshot-card.state-log {
+  border-left: 4px solid var(--color-info);
+}
+
+.snapshot-card.state-log.log-WARN {
+  border-left-color: var(--color-warning);
+}
+
+.snapshot-card.state-log.log-DEBUG {
+  border-left-color: var(--border);
+}
+
+.snapshot-card.state-log .summary-left {
+  min-width: 0;
+  flex: 1;
+}
+
+.log-preview {
+  font-size: 12px;
+  color: var(--text-muted);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  min-width: 0;
+}
+
+.log-message {
+  margin: 0;
+  white-space: pre-wrap;
+  word-break: break-word;
+}
+
+.snapshot-summary {
+  font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+}
+
+.snapshot-summary .summary-right {
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+}
+
 .snapshot-summary .step-title {
   font-size: 14px;
   font-weight: 600;
@@ -274,6 +325,21 @@ details[open] > summary .expand-arrow {
   color: var(--color-reasoning);
 }
 
+.badge-log-INFO {
+  background: var(--color-info-bg);
+  color: var(--color-info);
+}
+
+.badge-log-WARN {
+  background: var(--color-warning-bg);
+  color: var(--color-warning);
+}
+
+.badge-log-DEBUG {
+  background: var(--border);
+  color: var(--text-muted);
+}
+
 .badge-fallback {
   background: var(--color-warning-bg);
   color: var(--color-warning);
@@ -316,7 +382,37 @@ details[open] > summary .expand-arrow {
   padding: 10px 20px;
   border-radius: 6px;
   border: 1px solid rgba(255, 255, 255, 0.03);
-  margin-bottom: 20px;
+}
+
+.tokens-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(120px, 1fr));
+  gap: 10px;
+}
+
+.token-cell {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  text-align: center;
+  gap: 4px;
+  padding: 8px 12px;
+  border-radius: 6px;
+  border: 1px solid rgba(255, 255, 255, 0.03);
+  background: rgba(255, 255, 255, 0.02);
+}
+
+.token-label {
+  color: var(--text-muted);
+  font-size: 11px;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+}
+
+.token-value {
+  color: var(--color-info);
+  font-size: 16px;
+  font-weight: 700;
 }
 
 .text-muted {
@@ -377,6 +473,29 @@ details[open] > summary .expand-arrow {
   flex-shrink: 0;
 }
 
+.action-card.action-type-ai\:tool > summary {
+  flex-wrap: nowrap;
+  gap: 10px;
+}
+
+.action-card.action-type-ai\:tool .summary-left {
+  min-width: 0;
+  flex: 1;
+}
+
+.action-card.action-type-ai\:tool .summary-right {
+  flex-shrink: 0;
+}
+
+.action-preview {
+  font-size: 11px;
+  color: var(--text-muted);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  min-width: 0;
+}
+
 .action-content {
   padding: 10px 20px;
   border-top: 1px solid var(--border);

package/lib/src/index.d.ts

@@ -12,12 +12,14 @@ export * from './models/pipeline/steps/ai/errors';
 export * from './models/project';
 export * from './models/file';
 export * from './models/bash';
+export * from './models/meta';
 export * from './models/content/factory';
 export * from './models/content/types';
 export * from './models/llm/providers/model';
 export * from './models/llm/tools/model';
 export * from './models/llm/factory';
 export * from './models/llm/router';
+export * from './models/llm/hook';
 export * from './models/llm/mcp';
 export * as content from './models/content/kinds';
 export * as stdout from './models/pipeline/stdout/compiled';

package/lib/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,CAAC;AAEjB,OAAO,KAAK,SAAS,MAAM,wBAAwB,CAAC;AACpD,OAAO,KAAK,KAAK,MAAM,oBAAoB,CAAC;AAE5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AAExC,cAAc,oCAAoC,CAAC;AACnD,cAAc,mCAAmC,CAAC;AAElD,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAE9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AAEvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AAEjC,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAC;AAClD,OAAO,KAAK,MAAM,MAAM,mCAAmC,CAAC;AAE5D,eAAO,MAAM,GAAG;;;CAGf,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,CAAC;AAEjB,OAAO,KAAK,SAAS,MAAM,wBAAwB,CAAC;AACpD,OAAO,KAAK,KAAK,MAAM,oBAAoB,CAAC;AAE5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AAExC,cAAc,oCAAoC,CAAC;AACnD,cAAc,mCAAmC,CAAC;AAElD,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAE9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AAEvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AAEjC,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAC;AAClD,OAAO,KAAK,MAAM,MAAM,mCAAmC,CAAC;AAE5D,eAAO,MAAM,GAAG;;;CAGf,CAAC"}

package/lib/src/index.js

@@ -51,12 +51,14 @@ __exportStar(require("./models/pipeline/steps/ai/errors"), exports);
 __exportStar(require("./models/project"), exports);
 __exportStar(require("./models/file"), exports);
 __exportStar(require("./models/bash"), exports);
+__exportStar(require("./models/meta"), exports);
 __exportStar(require("./models/content/factory"), exports);
 __exportStar(require("./models/content/types"), exports);
 __exportStar(require("./models/llm/providers/model"), exports);
 __exportStar(require("./models/llm/tools/model"), exports);
 __exportStar(require("./models/llm/factory"), exports);
 __exportStar(require("./models/llm/router"), exports);
+__exportStar(require("./models/llm/hook"), exports);
 __exportStar(require("./models/llm/mcp"), exports);
 exports.content = __importStar(require("./models/content/kinds"));
 exports.stdout = __importStar(require("./models/pipeline/stdout/compiled"));

package/lib/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,mBAAiB;AAEjB,kEAAoD;AACpD,0DAA4C;AAE5C,4DAA0C;AAC1C,4DAA0C;AAC1C,2DAAyC;AACzC,2DAAyC;AACzC,2DAAyC;AACzC,0DAAwC;AAExC,qEAAmD;AACnD,oEAAkD;AAElD,mDAAiC;AACjC,gDAA8B;AAC9B,gDAA8B;AAE9B,2DAAyC;AACzC,yDAAuC;AAEvC,+DAA6C;AAC7C,2DAAyC;AACzC,uDAAqC;AACrC,sDAAoC;AACpC,mDAAiC;AAEjC,kEAAkD;AAClD,4EAA4D;AAE/C,QAAA,GAAG,GAAG;IACjB,SAAS;IACT,KAAK;CACN,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,mBAAiB;AAEjB,kEAAoD;AACpD,0DAA4C;AAE5C,4DAA0C;AAC1C,4DAA0C;AAC1C,2DAAyC;AACzC,2DAAyC;AACzC,2DAAyC;AACzC,0DAAwC;AAExC,qEAAmD;AACnD,oEAAkD;AAElD,mDAAiC;AACjC,gDAA8B;AAC9B,gDAA8B;AAC9B,gDAA8B;AAE9B,2DAAyC;AACzC,yDAAuC;AAEvC,+DAA6C;AAC7C,2DAAyC;AACzC,uDAAqC;AACrC,sDAAoC;AACpC,oDAAkC;AAClC,mDAAiC;AAEjC,kEAAkD;AAClD,4EAA4D;AAE/C,QAAA,GAAG,GAAG;IACjB,SAAS;IACT,KAAK;CACN,CAAC"}

package/lib/src/models/index.d.ts

@@ -3,6 +3,7 @@ export * from './project';
 export * from './content';
 export * from './file';
 export * from './bash';
+export * from './meta';
 export * from './llm';
 export * from './vfs';
 export * from './rg';