@loopstack/observability-examples 0.1.0 → 0.1.2

package/README.md

@@ -1,6 +1,6 @@
 ---
 title: Observability Examples
-description: Workflow examples for observability in Loopstack — opt-in quota tracking and enforcement
+description: Workflow examples for observability in Loopstack — quota tracking, custom tool interceptors for tracing, custom quota calculators, and event-driven audit logging
 ---
 
 # @loopstack/observability-examples
@@ -40,26 +40,80 @@ import { ObservabilityExamplesModule } from '@loopstack/observability-examples';
 
 ## Examples
 
-| Example         | Studio title                    | Description                                                             |
-| --------------- | ------------------------------- | ----------------------------------------------------------------------- |
-| [Quota](#quota) | `Observability - Quota Example` | Check + report usage with `@loopstack/quota`, Redis-backed when enabled |
+| Example                                             | Studio title                                      | Description                                                                       |
+| --------------------------------------------------- | ------------------------------------------------- | --------------------------------------------------------------------------------- |
+| [Quota](#quota)                                     | `Observability - Quota Example`                   | Manual check + report usage with `@loopstack/quota`, Redis-backed when enabled    |
+| [Tracing Interceptor](#tracing-interceptor)         | `Observability - Tracing Interceptor Example`     | Custom `ToolInterceptor` measuring every tool execution app-wide                  |
+| [Custom Quota Calculator](#custom-quota-calculator) | `Observability - Custom Quota Calculator Example` | Custom `ToolQuotaCalculator` metering a tool automatically via `QuotaInterceptor` |
+| [Audit Log](#audit-log)                             | `Observability - Audit Log Example`               | `@OnEvent` listener recording workflow & document lifecycle events                |
 
 ---
 
 ## Quota
 
-Demonstrates opt-in quota tracking using `@loopstack/quota`:
+Demonstrates the manual quota API of `@loopstack/quota`:
 
 1. `quotaClient.checkQuota(userId, quotaType)` — verify available budget
 2. Perform the (placeholder) operation if allowed
 3. `quotaClient.report(userId, quotaType, amount)` — charge against the quota
 
-When `QuotaModule.forRoot({ enabled: false })`, both calls no-op. Set `enabled: true` plus Redis connection options to enforce real limits.
+When `QuotaModule.forRoot({ enabled: false })`, both calls no-op. Set `enabled: true` plus Redis connection options to enforce real limits. Note: with quota enabled, a user without a limit key in Redis is blocked by default.
+
+Built-in quota types: `llm-cost` (LLM token cost in microcents) and `processing-time-ms` (tool execution time).
 
 ### Files
 
 - `quota-example.workflow.ts` — workflow class
 
+## Tracing Interceptor
+
+Demonstrates writing a custom `ToolInterceptor`:
+
+- `@UseToolInterceptor({ priority: 10 })` registers the class app-wide — the framework discovers it via NestJS `DiscoveryService`, no manual wiring
+- The interceptor wraps **every** tool call (all modules), measures duration, and records entries in an injectable `ToolTraceService`
+- The workflow runs a few `SimulateWorkTool` calls, then filters the trace by its own `workflowId` and renders a markdown table
+
+Interceptors follow a chain pattern like NestJS interceptors: run logic before/after `next()`, transform results, short-circuit (caching), or catch errors. Lower priority runs first (outermost).
+
+### Files
+
+- `tracing-example.workflow.ts` — workflow class
+- `interceptors/tracing.interceptor.ts` — the custom `ToolInterceptor`
+- `services/tool-trace.service.ts` — injectable trace store
+- `tools/simulate-work.tool.ts` — demo tool that sleeps for a configurable duration
+
+## Custom Quota Calculator
+
+Demonstrates extending the quota system with a custom `ToolQuotaCalculator`:
+
+- `WordsProcessedQuotaCalculator` defines quota type `words-processed` and derives the charged amount from the tool result (word count)
+- The module registers it for `AnalyzeTextTool` in `onModuleInit` via `QuotaCalculatorRegistry`
+- The built-in `QuotaInterceptor` then checks the quota **before** and reports usage **after** every `AnalyzeTextTool` execution — the workflow just calls the tool, no manual check/report
+
+This is the recommended pattern for metering tools: the workflow stays clean, enforcement lives in the interceptor.
+
+### Files
+
+- `custom-calculator-example.workflow.ts` — workflow class
+- `calculators/words-processed.calculator.ts` — the custom `ToolQuotaCalculator`
+- `tools/analyze-text.tool.ts` — demo tool whose usage is metered
+
+## Audit Log
+
+Demonstrates subscribing to framework events for monitoring:
+
+- The framework dispatches lifecycle events on the `client.message` channel — e.g. `workflow.created`, `workflow.updated`, `document.created`
+- `AuditListener` uses `@OnEvent('client.message')` to capture every event into an injectable `AuditLogService` (bounded in-memory store)
+- The workflow saves a few documents to generate events, then renders its own audit trail filtered by `workflowId`
+
+This is the event-driven counterpart to the tracing interceptor: interceptors wrap tool calls, event listeners observe workflow and document lifecycle. Swap the in-memory store for a database or metrics exporter in production.
+
+### Files
+
+- `audit-log-example.workflow.ts` — workflow class
+- `listeners/audit.listener.ts` — the `@OnEvent` listener
+- `services/audit-log.service.ts` — injectable audit store
+
 ## About
 
 Author: [Jakob Klippel](https://www.linkedin.com/in/jakob-klippel/)

package/dist/index.d.ts

@@ -1,3 +1,13 @@
 export * from './observability-examples.module';
 export * from './workflows/quota/quota-example.workflow';
+export * from './workflows/tracing/tracing-example.workflow';
+export * from './workflows/tracing/services/tool-trace.service';
+export * from './workflows/tracing/interceptors/tracing.interceptor';
+export * from './workflows/tracing/tools/simulate-work.tool';
+export * from './workflows/custom-calculator/custom-calculator-example.workflow';
+export * from './workflows/custom-calculator/calculators/words-processed.calculator';
+export * from './workflows/custom-calculator/tools/analyze-text.tool';
+export * from './workflows/audit-log/audit-log-example.workflow';
+export * from './workflows/audit-log/services/audit-log.service';
+export * from './workflows/audit-log/listeners/audit.listener';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,cAAc,0CAA0C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,cAAc,0CAA0C,CAAC;AACzD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,iDAAiD,CAAC;AAChE,cAAc,sDAAsD,CAAC;AACrE,cAAc,8CAA8C,CAAC;AAC7D,cAAc,kEAAkE,CAAC;AACjF,cAAc,sEAAsE,CAAC;AACrF,cAAc,uDAAuD,CAAC;AACtE,cAAc,kDAAkD,CAAC;AACjE,cAAc,kDAAkD,CAAC;AACjE,cAAc,gDAAgD,CAAC"}

package/dist/index.js

@@ -16,4 +16,14 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./observability-examples.module"), exports);
 __exportStar(require("./workflows/quota/quota-example.workflow"), exports);
+__exportStar(require("./workflows/tracing/tracing-example.workflow"), exports);
+__exportStar(require("./workflows/tracing/services/tool-trace.service"), exports);
+__exportStar(require("./workflows/tracing/interceptors/tracing.interceptor"), exports);
+__exportStar(require("./workflows/tracing/tools/simulate-work.tool"), exports);
+__exportStar(require("./workflows/custom-calculator/custom-calculator-example.workflow"), exports);
+__exportStar(require("./workflows/custom-calculator/calculators/words-processed.calculator"), exports);
+__exportStar(require("./workflows/custom-calculator/tools/analyze-text.tool"), exports);
+__exportStar(require("./workflows/audit-log/audit-log-example.workflow"), exports);
+__exportStar(require("./workflows/audit-log/services/audit-log.service"), exports);
+__exportStar(require("./workflows/audit-log/listeners/audit.listener"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kEAAgD;AAChD,2EAAyD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kEAAgD;AAChD,2EAAyD;AACzD,+EAA6D;AAC7D,kFAAgE;AAChE,uFAAqE;AACrE,+EAA6D;AAC7D,mGAAiF;AACjF,uGAAqF;AACrF,wFAAsE;AACtE,mFAAiE;AACjE,mFAAiE;AACjE,iFAA+D"}

package/dist/observability-examples.module.d.ts

@@ -1,3 +1,8 @@
-export declare class ObservabilityExamplesModule {
+import { OnModuleInit } from '@nestjs/common';
+import { QuotaCalculatorRegistry } from '@loopstack/quota';
+export declare class ObservabilityExamplesModule implements OnModuleInit {
+    private readonly calculatorRegistry;
+    constructor(calculatorRegistry: QuotaCalculatorRegistry);
+    onModuleInit(): void;
 }
 //# sourceMappingURL=observability-examples.module.d.ts.map

package/dist/observability-examples.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observability-examples.module.d.ts","sourceRoot":"","sources":["../src/observability-examples.module.ts"],"names":[],"mappings":"AAKA,qBASa,2BAA2B;CAAG"}
+{"version":3,"file":"observability-examples.module.d.ts","sourceRoot":"","sources":["../src/observability-examples.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EAAE,uBAAuB,EAAe,MAAM,kBAAkB,CAAC;AAaxE,qBAoBa,2BAA4B,YAAW,YAAY;IAClD,OAAO,CAAC,QAAQ,CAAC,kBAAkB;gBAAlB,kBAAkB,EAAE,uBAAuB;IAExE,YAAY;CAGb"}

package/dist/observability-examples.module.js

@@ -5,24 +5,56 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ObservabilityExamplesModule = void 0;
 const common_1 = require("@nestjs/common");
 const common_2 = require("@loopstack/common");
 const quota_1 = require("@loopstack/quota");
+const audit_log_example_workflow_1 = require("./workflows/audit-log/audit-log-example.workflow");
+const audit_listener_1 = require("./workflows/audit-log/listeners/audit.listener");
+const audit_log_service_1 = require("./workflows/audit-log/services/audit-log.service");
+const words_processed_calculator_1 = require("./workflows/custom-calculator/calculators/words-processed.calculator");
+const custom_calculator_example_workflow_1 = require("./workflows/custom-calculator/custom-calculator-example.workflow");
+const analyze_text_tool_1 = require("./workflows/custom-calculator/tools/analyze-text.tool");
 const quota_example_workflow_1 = require("./workflows/quota/quota-example.workflow");
+const tracing_interceptor_1 = require("./workflows/tracing/interceptors/tracing.interceptor");
+const tool_trace_service_1 = require("./workflows/tracing/services/tool-trace.service");
+const simulate_work_tool_1 = require("./workflows/tracing/tools/simulate-work.tool");
+const tracing_example_workflow_1 = require("./workflows/tracing/tracing-example.workflow");
 let ObservabilityExamplesModule = class ObservabilityExamplesModule {
+    calculatorRegistry;
+    constructor(calculatorRegistry) {
+        this.calculatorRegistry = calculatorRegistry;
+    }
+    onModuleInit() {
+        this.calculatorRegistry.register('AnalyzeTextTool', new words_processed_calculator_1.WordsProcessedQuotaCalculator());
+    }
 };
 exports.ObservabilityExamplesModule = ObservabilityExamplesModule;
 exports.ObservabilityExamplesModule = ObservabilityExamplesModule = __decorate([
     (0, common_2.StudioApp)({
         title: 'Observability Examples',
-        workflows: [quota_example_workflow_1.QuotaExampleWorkflow],
+        workflows: [quota_example_workflow_1.QuotaExampleWorkflow, tracing_example_workflow_1.TracingExampleWorkflow, custom_calculator_example_workflow_1.CustomCalculatorExampleWorkflow, audit_log_example_workflow_1.AuditLogExampleWorkflow],
     }),
     (0, common_1.Module)({
         imports: [quota_1.QuotaModule.forRoot({ enabled: false })],
-        providers: [quota_example_workflow_1.QuotaExampleWorkflow],
-        exports: [quota_example_workflow_1.QuotaExampleWorkflow],
-    })
+        providers: [
+            quota_example_workflow_1.QuotaExampleWorkflow,
+            tracing_example_workflow_1.TracingExampleWorkflow,
+            tool_trace_service_1.ToolTraceService,
+            tracing_interceptor_1.TracingInterceptor,
+            simulate_work_tool_1.SimulateWorkTool,
+            custom_calculator_example_workflow_1.CustomCalculatorExampleWorkflow,
+            analyze_text_tool_1.AnalyzeTextTool,
+            audit_log_example_workflow_1.AuditLogExampleWorkflow,
+            audit_log_service_1.AuditLogService,
+            audit_listener_1.AuditListener,
+        ],
+        exports: [quota_example_workflow_1.QuotaExampleWorkflow, tracing_example_workflow_1.TracingExampleWorkflow, custom_calculator_example_workflow_1.CustomCalculatorExampleWorkflow, audit_log_example_workflow_1.AuditLogExampleWorkflow],
+    }),
+    __metadata("design:paramtypes", [quota_1.QuotaCalculatorRegistry])
 ], ObservabilityExamplesModule);
 //# sourceMappingURL=observability-examples.module.js.map

package/dist/observability-examples.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"observability-examples.module.js","sourceRoot":"","sources":["../src/observability-examples.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,8CAA8C;AAC9C,4CAA+C;AAC/C,qFAAgF;AAWzE,IAAM,2BAA2B,GAAjC,MAAM,2BAA2B;CAAG,CAAA;AAA9B,kEAA2B;sCAA3B,2BAA2B;IATvC,IAAA,kBAAS,EAAC;QACT,KAAK,EAAE,wBAAwB;QAC/B,SAAS,EAAE,CAAC,6CAAoB,CAAC;KAClC,CAAC;IACD,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,mBAAW,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAClD,SAAS,EAAE,CAAC,6CAAoB,CAAC;QACjC,OAAO,EAAE,CAAC,6CAAoB,CAAC;KAChC,CAAC;GACW,2BAA2B,CAAG"}
+{"version":3,"file":"observability-examples.module.js","sourceRoot":"","sources":["../src/observability-examples.module.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAsD;AACtD,8CAA8C;AAC9C,4CAAwE;AACxE,iGAA2F;AAC3F,mFAA+E;AAC/E,wFAAmF;AACnF,qHAAqH;AACrH,yHAAmH;AACnH,6FAAwF;AACxF,qFAAgF;AAChF,8FAA0F;AAC1F,wFAAmF;AACnF,qFAAgF;AAChF,2FAAsF;AAsB/E,IAAM,2BAA2B,GAAjC,MAAM,2BAA2B;IACT;IAA7B,YAA6B,kBAA2C;QAA3C,uBAAkB,GAAlB,kBAAkB,CAAyB;IAAG,CAAC;IAE5E,YAAY;QACV,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,iBAAiB,EAAE,IAAI,0DAA6B,EAAE,CAAC,CAAC;IAC3F,CAAC;CACF,CAAA;AANY,kEAA2B;sCAA3B,2BAA2B;IApBvC,IAAA,kBAAS,EAAC;QACT,KAAK,EAAE,wBAAwB;QAC/B,SAAS,EAAE,CAAC,6CAAoB,EAAE,iDAAsB,EAAE,oEAA+B,EAAE,oDAAuB,CAAC;KACpH,CAAC;IACD,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,mBAAW,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAClD,SAAS,EAAE;YACT,6CAAoB;YACpB,iDAAsB;YACtB,qCAAgB;YAChB,wCAAkB;YAClB,qCAAgB;YAChB,oEAA+B;YAC/B,mCAAe;YACf,oDAAuB;YACvB,mCAAe;YACf,8BAAa;SACd;QACD,OAAO,EAAE,CAAC,6CAAoB,EAAE,iDAAsB,EAAE,oEAA+B,EAAE,oDAAuB,CAAC;KAClH,CAAC;qCAEiD,+BAAuB;GAD7D,2BAA2B,CAMvC"}

package/dist/workflows/audit-log/audit-log-example.workflow.d.ts

@@ -0,0 +1,10 @@
+import { BaseWorkflow } from '@loopstack/common';
+import type { RunContext } from '@loopstack/common';
+import { AuditLogService } from './services/audit-log.service';
+export declare class AuditLogExampleWorkflow extends BaseWorkflow {
+    private readonly auditLog;
+    constructor(auditLog: AuditLogService);
+    doWork(): Promise<void>;
+    renderAudit(_state: object, ctx: RunContext): Promise<void>;
+}
+//# sourceMappingURL=audit-log-example.workflow.d.ts.map

package/dist/workflows/audit-log/audit-log-example.workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log-example.workflow.d.ts","sourceRoot":"","sources":["../../../src/workflows/audit-log/audit-log-example.workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA2D,MAAM,mBAAmB,CAAC;AAC1G,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,qBAKa,uBAAwB,SAAQ,YAAY;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,eAAe;IAKhD,MAAM;IAYN,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU;CAelD"}

package/dist/workflows/audit-log/audit-log-example.workflow.js

@@ -0,0 +1,66 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditLogExampleWorkflow = void 0;
+const common_1 = require("@loopstack/common");
+const audit_log_service_1 = require("./services/audit-log.service");
+let AuditLogExampleWorkflow = class AuditLogExampleWorkflow extends common_1.BaseWorkflow {
+    auditLog;
+    constructor(auditLog) {
+        super();
+        this.auditLog = auditLog;
+    }
+    async doWork() {
+        await this.documentStore.save(common_1.MessageDocument, {
+            role: 'assistant',
+            text: 'Doing some work — each saved document emits a `document.created` event.',
+        });
+        await this.documentStore.save(common_1.MessageDocument, {
+            role: 'assistant',
+            text: 'The audit listener captures these events app-wide.',
+        });
+    }
+    async renderAudit(_state, ctx) {
+        const entries = this.auditLog.forWorkflow(ctx.workflowId);
+        await this.documentStore.save(common_1.MarkdownDocument, {
+            markdown: [
+                '## Audit Trail',
+                '',
+                `Captured by \`AuditListener\` via \`@OnEvent('client.message')\` for workflow \`${ctx.workflowId}\`.`,
+                '',
+                '| Event type | User |',
+                '| ---------- | ---- |',
+                ...entries.map((e) => `| \`${e.type}\` | \`${e.userId ?? 'anonymous'}\` |`),
+            ].join('\n'),
+        });
+    }
+};
+exports.AuditLogExampleWorkflow = AuditLogExampleWorkflow;
+__decorate([
+    (0, common_1.Transition)({ to: 'auditing' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], AuditLogExampleWorkflow.prototype, "doWork", null);
+__decorate([
+    (0, common_1.Transition)({ from: 'auditing', to: 'end' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AuditLogExampleWorkflow.prototype, "renderAudit", null);
+exports.AuditLogExampleWorkflow = AuditLogExampleWorkflow = __decorate([
+    (0, common_1.Workflow)({
+        title: 'Observability - Audit Log Example',
+        description: 'Demonstrates subscribing to framework events — an @OnEvent("client.message") listener records every workflow and document lifecycle event into an injectable service. The workflow emits a few events, then renders its own audit trail.',
+    }),
+    __metadata("design:paramtypes", [audit_log_service_1.AuditLogService])
+], AuditLogExampleWorkflow);
+//# sourceMappingURL=audit-log-example.workflow.js.map

package/dist/workflows/audit-log/audit-log-example.workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log-example.workflow.js","sourceRoot":"","sources":["../../../src/workflows/audit-log/audit-log-example.workflow.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,8CAA0G;AAE1G,oEAA+D;AAOxD,IAAM,uBAAuB,GAA7B,MAAM,uBAAwB,SAAQ,qBAAY;IAC1B;IAA7B,YAA6B,QAAyB;QACpD,KAAK,EAAE,CAAC;QADmB,aAAQ,GAAR,QAAQ,CAAiB;IAEtD,CAAC;IAGK,AAAN,KAAK,CAAC,MAAM;QACV,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,wBAAe,EAAE;YAC7C,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,yEAAyE;SAChF,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,wBAAe,EAAE;YAC7C,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,oDAAoD;SAC3D,CAAC,CAAC;IACL,CAAC;IAGK,AAAN,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,GAAe;QAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAE1D,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,yBAAgB,EAAE;YAC9C,QAAQ,EAAE;gBACR,gBAAgB;gBAChB,EAAE;gBACF,mFAAmF,GAAG,CAAC,UAAU,KAAK;gBACtG,EAAE;gBACF,uBAAuB;gBACvB,uBAAuB;gBACvB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,MAAM,IAAI,WAAW,MAAM,CAAC;aAC5E,CAAC,IAAI,CAAC,IAAI,CAAC;SACb,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AAjCY,0DAAuB;AAM5B;IADL,IAAA,mBAAU,EAAC,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC;;;;qDAU9B;AAGK;IADL,IAAA,mBAAU,EAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;;;;0DAe3C;kCAhCU,uBAAuB;IALnC,IAAA,iBAAQ,EAAC;QACR,KAAK,EAAE,mCAAmC;QAC1C,WAAW,EACT,0OAA0O;KAC7O,CAAC;qCAEuC,mCAAe;GAD3C,uBAAuB,CAiCnC"}

package/dist/workflows/audit-log/listeners/audit.listener.d.ts

@@ -0,0 +1,9 @@
+import type { ClientMessage } from '@loopstack/contracts/events';
+import { AuditLogService } from '../services/audit-log.service';
+export declare class AuditListener {
+    private readonly auditLog;
+    private readonly logger;
+    constructor(auditLog: AuditLogService);
+    handle(payload: ClientMessage): void;
+}
+//# sourceMappingURL=audit.listener.d.ts.map

package/dist/workflows/audit-log/listeners/audit.listener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.listener.d.ts","sourceRoot":"","sources":["../../../../src/workflows/audit-log/listeners/audit.listener.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,qBACa,aAAa;IAGZ,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAFrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;gBAE5B,QAAQ,EAAE,eAAe;IAGtD,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;CASrC"}

package/dist/workflows/audit-log/listeners/audit.listener.js

@@ -0,0 +1,44 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var AuditListener_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditListener = void 0;
+const common_1 = require("@nestjs/common");
+const event_emitter_1 = require("@nestjs/event-emitter");
+const audit_log_service_1 = require("../services/audit-log.service");
+let AuditListener = AuditListener_1 = class AuditListener {
+    auditLog;
+    logger = new common_1.Logger(AuditListener_1.name);
+    constructor(auditLog) {
+        this.auditLog = auditLog;
+    }
+    handle(payload) {
+        const workflowId = 'workflowId' in payload ? payload.workflowId : undefined;
+        this.auditLog.record({
+            type: payload.type,
+            workflowId,
+            userId: payload.userId,
+        });
+        this.logger.log(`${payload.type} (workflow ${workflowId ?? '-'})`);
+    }
+};
+exports.AuditListener = AuditListener;
+__decorate([
+    (0, event_emitter_1.OnEvent)('client.message'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", void 0)
+], AuditListener.prototype, "handle", null);
+exports.AuditListener = AuditListener = AuditListener_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [audit_log_service_1.AuditLogService])
+], AuditListener);
+//# sourceMappingURL=audit.listener.js.map

package/dist/workflows/audit-log/listeners/audit.listener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.listener.js","sourceRoot":"","sources":["../../../../src/workflows/audit-log/listeners/audit.listener.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,2CAAoD;AACpD,yDAAgD;AAEhD,qEAAgE;AAGzD,IAAM,aAAa,qBAAnB,MAAM,aAAa;IAGK;IAFZ,MAAM,GAAG,IAAI,eAAM,CAAC,eAAa,CAAC,IAAI,CAAC,CAAC;IAEzD,YAA6B,QAAyB;QAAzB,aAAQ,GAAR,QAAQ,CAAiB;IAAG,CAAC;IAG1D,MAAM,CAAC,OAAsB;QAC3B,MAAM,UAAU,GAAG,YAAY,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5E,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,UAAU;YACV,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,cAAc,UAAU,IAAI,GAAG,GAAG,CAAC,CAAC;IACrE,CAAC;CACF,CAAA;AAfY,sCAAa;AAMxB;IADC,IAAA,uBAAO,EAAC,gBAAgB,CAAC;;;;2CASzB;wBAdU,aAAa;IADzB,IAAA,mBAAU,GAAE;qCAI4B,mCAAe;GAH3C,aAAa,CAezB"}

package/dist/workflows/audit-log/services/audit-log.service.d.ts

@@ -0,0 +1,11 @@
+export interface AuditEntry {
+    type: string;
+    workflowId?: string;
+    userId: string | null;
+}
+export declare class AuditLogService {
+    private readonly entries;
+    record(entry: AuditEntry): void;
+    forWorkflow(workflowId: string): AuditEntry[];
+}
+//# sourceMappingURL=audit-log.service.d.ts.map

package/dist/workflows/audit-log/services/audit-log.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log.service.d.ts","sourceRoot":"","sources":["../../../../src/workflows/audit-log/services/audit-log.service.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAID,qBACa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAE5C,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAO/B,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,EAAE;CAG9C"}

package/dist/workflows/audit-log/services/audit-log.service.js

@@ -0,0 +1,28 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditLogService = void 0;
+const common_1 = require("@nestjs/common");
+const MAX_ENTRIES = 200;
+let AuditLogService = class AuditLogService {
+    entries = [];
+    record(entry) {
+        this.entries.push(entry);
+        if (this.entries.length > MAX_ENTRIES) {
+            this.entries.shift();
+        }
+    }
+    forWorkflow(workflowId) {
+        return this.entries.filter((entry) => entry.workflowId === workflowId);
+    }
+};
+exports.AuditLogService = AuditLogService;
+exports.AuditLogService = AuditLogService = __decorate([
+    (0, common_1.Injectable)()
+], AuditLogService);
+//# sourceMappingURL=audit-log.service.js.map

package/dist/workflows/audit-log/services/audit-log.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log.service.js","sourceRoot":"","sources":["../../../../src/workflows/audit-log/services/audit-log.service.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA4C;AAQ5C,MAAM,WAAW,GAAG,GAAG,CAAC;AAGjB,IAAM,eAAe,GAArB,MAAM,eAAe;IACT,OAAO,GAAiB,EAAE,CAAC;IAE5C,MAAM,CAAC,KAAiB;QACtB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;YACtC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IAED,WAAW,CAAC,UAAkB;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;IACzE,CAAC;CACF,CAAA;AAbY,0CAAe;0BAAf,eAAe;IAD3B,IAAA,mBAAU,GAAE;GACA,eAAe,CAa3B"}

package/dist/workflows/custom-calculator/calculators/words-processed.calculator.d.ts

@@ -0,0 +1,7 @@
+import { ToolEnvelope, ToolExecutionContext } from '@loopstack/common';
+import { QuotaUsage, ToolQuotaCalculator } from '@loopstack/quota';
+export declare class WordsProcessedQuotaCalculator implements ToolQuotaCalculator {
+    quotaType: string;
+    calculateQuotaUsage(_context: ToolExecutionContext, result: ToolEnvelope): QuotaUsage | null;
+}
+//# sourceMappingURL=words-processed.calculator.d.ts.map

package/dist/workflows/custom-calculator/calculators/words-processed.calculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"words-processed.calculator.d.ts","sourceRoot":"","sources":["../../../../src/workflows/custom-calculator/calculators/words-processed.calculator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGnE,qBAAa,6BAA8B,YAAW,mBAAmB;IACvE,SAAS,SAAqB;IAE9B,mBAAmB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,MAAM,EAAE,YAAY,GAAG,UAAU,GAAG,IAAI;CAO7F"}

package/dist/workflows/custom-calculator/calculators/words-processed.calculator.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WordsProcessedQuotaCalculator = void 0;
+class WordsProcessedQuotaCalculator {
+    quotaType = 'words-processed';
+    calculateQuotaUsage(_context, result) {
+        const data = result.data;
+        if (typeof data?.words !== 'number') {
+            return null;
+        }
+        return { quotaType: this.quotaType, actualAmount: data.words };
+    }
+}
+exports.WordsProcessedQuotaCalculator = WordsProcessedQuotaCalculator;
+//# sourceMappingURL=words-processed.calculator.js.map

package/dist/workflows/custom-calculator/calculators/words-processed.calculator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"words-processed.calculator.js","sourceRoot":"","sources":["../../../../src/workflows/custom-calculator/calculators/words-processed.calculator.ts"],"names":[],"mappings":";;;AAIA,MAAa,6BAA6B;IACxC,SAAS,GAAG,iBAAiB,CAAC;IAE9B,mBAAmB,CAAC,QAA8B,EAAE,MAAoB;QACtE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAyC,CAAC;QAC9D,IAAI,OAAO,IAAI,EAAE,KAAK,KAAK,QAAQ,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,YAAY,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IACjE,CAAC;CACF;AAVD,sEAUC"}

package/dist/workflows/custom-calculator/custom-calculator-example.workflow.d.ts

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import { BaseWorkflow } from '@loopstack/common';
+import type { RunContext } from '@loopstack/common';
+import { QuotaClientService } from '@loopstack/quota';
+import { AnalyzeTextTool } from './tools/analyze-text.tool';
+declare const CustomCalculatorExampleArgsSchema: z.ZodObject<{
+    text: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+type CustomCalculatorExampleArgs = z.infer<typeof CustomCalculatorExampleArgsSchema>;
+export declare class CustomCalculatorExampleWorkflow extends BaseWorkflow<CustomCalculatorExampleArgs> {
+    private readonly analyzeTextTool;
+    private readonly quotaClient;
+    constructor(analyzeTextTool: AnalyzeTextTool, quotaClient: QuotaClientService);
+    analyze(_state: object, ctx: RunContext<CustomCalculatorExampleArgs>): Promise<void>;
+}
+export {};
+//# sourceMappingURL=custom-calculator-example.workflow.d.ts.map

package/dist/workflows/custom-calculator/custom-calculator-example.workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-calculator-example.workflow.d.ts","sourceRoot":"","sources":["../../../src/workflows/custom-calculator/custom-calculator-example.workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAA0C,MAAM,mBAAmB,CAAC;AACzF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAG5D,QAAA,MAAM,iCAAiC;;iBAErC,CAAC;AAEH,KAAK,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAErF,qBAMa,+BAAgC,SAAQ,YAAY,CAAC,2BAA2B,CAAC;IAE1F,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW;gBADX,eAAe,EAAE,eAAe,EAChC,WAAW,EAAE,kBAAkB;IAM5C,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,CAAC,2BAA2B,CAAC;CAuB3E"}

package/dist/workflows/custom-calculator/custom-calculator-example.workflow.js

@@ -0,0 +1,66 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomCalculatorExampleWorkflow = void 0;
+const zod_1 = require("zod");
+const common_1 = require("@loopstack/common");
+const quota_1 = require("@loopstack/quota");
+const analyze_text_tool_1 = require("./tools/analyze-text.tool");
+const CustomCalculatorExampleArgsSchema = zod_1.z.object({
+    text: zod_1.z.string().default('The quick brown fox jumps over the lazy dog'),
+});
+let CustomCalculatorExampleWorkflow = class CustomCalculatorExampleWorkflow extends common_1.BaseWorkflow {
+    analyzeTextTool;
+    quotaClient;
+    constructor(analyzeTextTool, quotaClient) {
+        super();
+        this.analyzeTextTool = analyzeTextTool;
+        this.quotaClient = quotaClient;
+    }
+    async analyze(_state, ctx) {
+        const result = await this.analyzeTextTool.call({ text: ctx.args.text });
+        const analysis = result.data;
+        const quota = await this.quotaClient.checkQuota(ctx.userId, 'words-processed');
+        await this.documentStore.save(common_1.MarkdownDocument, {
+            markdown: [
+                '## Text Analysis',
+                '',
+                `- Words: \`${analysis.words}\``,
+                `- Characters: \`${analysis.characters}\``,
+                '',
+                '## Quota `words-processed`',
+                '',
+                `- Used: \`${quota.used}\``,
+                `- Limit: \`${quota.limit}\` (\`-1\` = unlimited / quota disabled)`,
+                '',
+                'The `QuotaInterceptor` charged the word count automatically via `WordsProcessedQuotaCalculator`.',
+                'With `QuotaModule.forRoot({ enabled: false })` all quota calls no-op.',
+            ].join('\n'),
+        });
+    }
+};
+exports.CustomCalculatorExampleWorkflow = CustomCalculatorExampleWorkflow;
+__decorate([
+    (0, common_1.Transition)({ to: 'end' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], CustomCalculatorExampleWorkflow.prototype, "analyze", null);
+exports.CustomCalculatorExampleWorkflow = CustomCalculatorExampleWorkflow = __decorate([
+    (0, common_1.Workflow)({
+        title: 'Observability - Custom Quota Calculator Example',
+        description: 'Demonstrates a custom ToolQuotaCalculator — WordsProcessedQuotaCalculator meters AnalyzeTextTool by words in the result. The built-in QuotaInterceptor checks and reports the quota automatically; the workflow only calls the tool.',
+        schema: CustomCalculatorExampleArgsSchema,
+    }),
+    __metadata("design:paramtypes", [analyze_text_tool_1.AnalyzeTextTool,
+        quota_1.QuotaClientService])
+], CustomCalculatorExampleWorkflow);
+//# sourceMappingURL=custom-calculator-example.workflow.js.map

package/dist/workflows/custom-calculator/custom-calculator-example.workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-calculator-example.workflow.js","sourceRoot":"","sources":["../../../src/workflows/custom-calculator/custom-calculator-example.workflow.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6BAAwB;AACxB,8CAAyF;AAEzF,4CAAsD;AACtD,iEAA4D;AAG5D,MAAM,iCAAiC,GAAG,OAAC,CAAC,MAAM,CAAC;IACjD,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,6CAA6C,CAAC;CACxE,CAAC,CAAC;AAUI,IAAM,+BAA+B,GAArC,MAAM,+BAAgC,SAAQ,qBAAyC;IAEzE;IACA;IAFnB,YACmB,eAAgC,EAChC,WAA+B;QAEhD,KAAK,EAAE,CAAC;QAHS,oBAAe,GAAf,eAAe,CAAiB;QAChC,gBAAW,GAAX,WAAW,CAAoB;IAGlD,CAAC;IAGK,AAAN,KAAK,CAAC,OAAO,CAAC,MAAc,EAAE,GAA4C;QACxE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACxE,MAAM,QAAQ,GAAG,MAAM,CAAC,IAA6B,CAAC;QAEtD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;QAE/E,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,yBAAgB,EAAE;YAC9C,QAAQ,EAAE;gBACR,kBAAkB;gBAClB,EAAE;gBACF,cAAc,QAAQ,CAAC,KAAK,IAAI;gBAChC,mBAAmB,QAAQ,CAAC,UAAU,IAAI;gBAC1C,EAAE;gBACF,4BAA4B;gBAC5B,EAAE;gBACF,aAAa,KAAK,CAAC,IAAI,IAAI;gBAC3B,cAAc,KAAK,CAAC,KAAK,0CAA0C;gBACnE,EAAE;gBACF,kGAAkG;gBAClG,uEAAuE;aACxE,CAAC,IAAI,CAAC,IAAI,CAAC;SACb,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AAhCY,0EAA+B;AASpC;IADL,IAAA,mBAAU,EAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;;;;8DAuBzB;0CA/BU,+BAA+B;IAN3C,IAAA,iBAAQ,EAAC;QACR,KAAK,EAAE,iDAAiD;QACxD,WAAW,EACT,sOAAsO;QACxO,MAAM,EAAE,iCAAiC;KAC1C,CAAC;qCAGoC,mCAAe;QACnB,0BAAkB;GAHvC,+BAA+B,CAgC3C"}

package/dist/workflows/custom-calculator/tools/analyze-text.tool.d.ts

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import { BaseTool, ToolEnvelope } from '@loopstack/common';
+declare const AnalyzeTextSchema: z.ZodObject<{
+    text: z.ZodString;
+}, z.core.$strip>;
+type AnalyzeTextArgs = z.infer<typeof AnalyzeTextSchema>;
+export interface AnalyzeTextToolResult {
+    words: number;
+    characters: number;
+}
+export declare const AnalyzeTextToolResultSchema: z.ZodObject<{
+    words: z.ZodNumber;
+    characters: z.ZodNumber;
+}, z.core.$strict>;
+export declare class AnalyzeTextTool extends BaseTool<AnalyzeTextArgs, object, AnalyzeTextToolResult> {
+    protected handle(args: AnalyzeTextArgs): Promise<ToolEnvelope<AnalyzeTextToolResult>>;
+}
+export {};
+//# sourceMappingURL=analyze-text.tool.d.ts.map

package/dist/workflows/custom-calculator/tools/analyze-text.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-text.tool.d.ts","sourceRoot":"","sources":["../../../../src/workflows/custom-calculator/tools/analyze-text.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAQ,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjE,QAAA,MAAM,iBAAiB;;iBAErB,CAAC;AAEH,KAAK,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEzD,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,2BAA2B;;;kBAGtC,CAAC;AAEH,qBAOa,eAAgB,SAAQ,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,qBAAqB,CAAC;cAC3E,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,qBAAqB,CAAC,CAAC;CAI5F"}

package/dist/workflows/custom-calculator/tools/analyze-text.tool.js

@@ -0,0 +1,35 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnalyzeTextTool = exports.AnalyzeTextToolResultSchema = void 0;
+const zod_1 = require("zod");
+const common_1 = require("@loopstack/common");
+const AnalyzeTextSchema = zod_1.z.object({
+    text: zod_1.z.string(),
+});
+exports.AnalyzeTextToolResultSchema = zod_1.z.strictObject({
+    words: zod_1.z.number(),
+    characters: zod_1.z.number(),
+});
+let AnalyzeTextTool = class AnalyzeTextTool extends common_1.BaseTool {
+    async handle(args) {
+        const words = args.text.split(/\s+/).filter(Boolean).length;
+        return Promise.resolve({ data: { words, characters: args.text.length } });
+    }
+};
+exports.AnalyzeTextTool = AnalyzeTextTool;
+exports.AnalyzeTextTool = AnalyzeTextTool = __decorate([
+    (0, common_1.Tool)({
+        name: 'analyze_text',
+        description: 'Counts words and characters in a text. Its usage is metered by WordsProcessedQuotaCalculator.',
+        schema: AnalyzeTextSchema,
+        resultSchema: exports.AnalyzeTextToolResultSchema,
+        effects: 'none',
+    })
+], AnalyzeTextTool);
+//# sourceMappingURL=analyze-text.tool.js.map

package/dist/workflows/custom-calculator/tools/analyze-text.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-text.tool.js","sourceRoot":"","sources":["../../../../src/workflows/custom-calculator/tools/analyze-text.tool.ts"],"names":[],"mappings":";;;;;;;;;AAAA,6BAAwB;AACxB,8CAAiE;AAEjE,MAAM,iBAAiB,GAAG,OAAC,CAAC,MAAM,CAAC;IACjC,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAC;AASU,QAAA,2BAA2B,GAAG,OAAC,CAAC,YAAY,CAAC;IACxD,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;IACjB,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC;AASI,IAAM,eAAe,GAArB,MAAM,eAAgB,SAAQ,iBAAwD;IACjF,KAAK,CAAC,MAAM,CAAC,IAAqB;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;QAC5D,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5E,CAAC;CACF,CAAA;AALY,0CAAe;0BAAf,eAAe;IAP3B,IAAA,aAAI,EAAC;QACJ,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,+FAA+F;QAC5G,MAAM,EAAE,iBAAiB;QACzB,YAAY,EAAE,mCAA2B;QACzC,OAAO,EAAE,MAAM;KAChB,CAAC;GACW,eAAe,CAK3B"}