@bpmnkit/casen-worker-ai 0.1.0

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> @bpmnkit/casen-worker-ai@0.1.0 build /home/adam/github.com/bpmnkit/monorepo/plugins-cli/casen-worker-ai
+> tsc
+

package/.turbo/turbo-check.log

@@ -0,0 +1,5 @@
+
+> @bpmnkit/casen-worker-ai@0.1.0 check /home/adam/github.com/bpmnkit/monorepo/plugins-cli/casen-worker-ai
+> biome check .
+
+Checked 14 files in 13ms. No fixes applied.

package/.turbo/turbo-test.log

@@ -0,0 +1,18 @@
+
+> @bpmnkit/casen-worker-ai@0.1.0 test /home/adam/github.com/bpmnkit/monorepo/plugins-cli/casen-worker-ai
+> vitest run
+
+
+ RUN  v3.2.4 /home/adam/github.com/bpmnkit/monorepo/plugins-cli/casen-worker-ai
+
+ ✓ src/config.test.ts (3 tests) 11ms
+ ✓ src/operations/summarize.test.ts (3 tests) 11ms
+ ✓ src/operations/extract.test.ts (5 tests) 20ms
+ ✓ src/operations/classify.test.ts (7 tests) 7ms
+ ✓ src/operations/decide.test.ts (5 tests) 16ms
+
+ Test Files  5 passed (5)
+      Tests  23 passed (23)
+   Start at  13:49:38
+   Duration  1.09s (transform 1.29s, setup 0ms, collect 2.21s, tests 65ms, environment 5ms, prepare 814ms)
+

package/.turbo/turbo-typecheck.log

@@ -0,0 +1,4 @@
+
+> @bpmnkit/casen-worker-ai@0.1.0 typecheck /home/adam/github.com/bpmnkit/monorepo/plugins-cli/casen-worker-ai
+> tsc --noEmit
+

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @bpmnkit/casen-worker-ai
+
+## 0.1.0
+
+### Minor Changes
+
+- Initial release — AI task worker plugin supporting classify, summarize, extract, and decide operations via Claude.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 urbanisierung
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,177 @@
+<div align="center">
+  <a href="https://bpmnkit.com"><img src="https://bpmnkit.com/favicon.svg" width="72" height="72" alt="BPMN Kit logo"></a>
+  <h1>@bpmnkit/casen-worker-ai</h1>
+  <p>AI task worker plugin for casen — classify, summarize, extract, and decide using Claude</p>
+
+  [![npm](https://img.shields.io/npm/v/@bpmnkit/casen-worker-ai?style=flat-square&color=6244d7)](https://www.npmjs.com/package/@bpmnkit/casen-worker-ai)
+  [![license](https://img.shields.io/npm/l/@bpmnkit/casen-worker-ai?style=flat-square)](https://github.com/bpmnkit/monorepo/blob/main/LICENSE)
+  [![typescript](https://img.shields.io/badge/TypeScript-strict-6244d7?style=flat-square&logo=typescript&logoColor=white)](https://github.com/bpmnkit/monorepo)
+
+  [Website](https://bpmnkit.com) · [Documentation](https://docs.bpmnkit.com) · [GitHub](https://github.com/bpmnkit/monorepo) · [Changelog](https://github.com/bpmnkit/monorepo/blob/main/plugins-cli/casen-worker-ai/CHANGELOG.md)
+</div>
+
+---
+
+## Overview
+
+`casen-worker-ai` is an official `casen` CLI plugin that brings AI-powered task processing into Camunda 8 workflows. It subscribes to four job types and uses the [Anthropic Claude API](https://anthropic.com) to complete each job with structured output.
+
+This is the right tool when you need AI logic in a process but don't want to build a full microservice — start the worker once and any process in your cluster can delegate AI tasks to it.
+
+## Why a worker instead of the HTTP connector?
+
+The built-in Camunda HTTP connector can call any API but cannot:
+- Validate or parse the response and fail the job if the output is malformed
+- Route Anthropic rate-limit errors (429) to Camunda's retry budget with back-off
+- Throw a typed BPMN error that an error boundary event can catch
+
+The worker handles all three via `failJob` and `throwJobError`, giving your process model clean error paths.
+
+## Installation
+
+```sh
+casen plugin install casen-worker-ai
+```
+
+Set your Anthropic API key before starting:
+
+```sh
+export ANTHROPIC_API_KEY=sk-ant-...
+casen ai-worker
+```
+
+## Configuration
+
+| Environment variable | Default | Description |
+|---|---|---|
+| `ANTHROPIC_API_KEY` | **required** | Your Anthropic API key |
+| `AI_MODEL` | `claude-3-5-haiku-20241022` | Model ID to use |
+| `AI_MAX_TOKENS` | `1024` | Token budget per call |
+| `AI_TIMEOUT_MS` | `60000` | HTTP timeout in ms |
+
+## Operations
+
+### `com.bpmnkit.ai.classify` — Classify text
+
+Classifies text into one of the provided categories.
+
+**Input variables:**
+
+| Variable | Type | Required | Description |
+|---|---|---|---|
+| `input` | string | ✓ | Text to classify |
+| `categories` | string[] | ✓ | Allowed category names |
+| `context` | string | — | Optional domain context |
+
+**Output variables:** `category`, `confidence` (0–1), `rationale`, `aiModel`, `processedAt`
+
+**BPMN error codes:** `AI_INVALID_CATEGORY`, `AI_PARSE_ERROR`, `AI_API_ERROR`, `AI_INVALID_INPUT`
+
+```xml
+<bpmn:serviceTask id="ClassifyTicket" name="Classify ticket">
+  <bpmn:extensionElements>
+    <zeebe:taskDefinition type="com.bpmnkit.ai.classify" retries="3" />
+    <zeebe:taskHeaders>
+      <zeebe:header key="retryBackoff" value="PT30S" />
+    </zeebe:taskHeaders>
+    <zeebe:ioMapping>
+      <zeebe:input source="=ticket.body" target="input" />
+      <zeebe:input source='=["billing","technical","cancellation","general"]' target="categories" />
+    </zeebe:ioMapping>
+  </bpmn:extensionElements>
+</bpmn:serviceTask>
+```
+
+### `com.bpmnkit.ai.summarize` — Summarize text
+
+Summarizes text to a target length and style.
+
+**Input variables:**
+
+| Variable | Type | Required | Description |
+|---|---|---|---|
+| `input` | string | ✓ | Text to summarize |
+| `maxWords` | number | — | Target word count (default: 100) |
+| `style` | `"bullet"` | `"paragraph"` | — | Output style (default: `"paragraph"`) |
+
+**Output variables:** `summary`, `wordCount`, `aiModel`, `processedAt`
+
+### `com.bpmnkit.ai.extract` — Extract structured fields
+
+Extracts named fields from unstructured text. Missing fields are reported but the job still completes — use a gateway on `=missingFields` to decide whether to auto-proceed or route to manual review.
+
+**Input variables:**
+
+| Variable | Type | Required | Description |
+|---|---|---|---|
+| `input` | string | ✓ | Unstructured text |
+| `fields` | string[] | ✓ | Field names to extract |
+| `schema` | object | — | Type hints per field, e.g. `{ amount: "number" }` |
+
+**Output variables:** `extracted` (object), `missingFields` (array), `aiModel`, `processedAt`
+
+### `com.bpmnkit.ai.decide` — Make a boolean decision
+
+Answers a yes/no question based on context and an optional policy statement. Use `confidence` at a gateway to route low-confidence decisions to human review.
+
+**Input variables:**
+
+| Variable | Type | Required | Description |
+|---|---|---|---|
+| `question` | string | ✓ | The yes/no question |
+| `context` | string | ✓ | Relevant facts |
+| `policy` | string | — | Natural language policy the model must apply |
+
+**Output variables:** `decision` (boolean), `rationale`, `confidence` (0–1), `aiModel`, `processedAt`
+
+## Example workflow: Credit decision
+
+```
+Start Event
+  → summarize (summarize application notes, maxWords=150)
+  → decide     (question="Approve loan?", policy="Score ≥ 680 and amount ≤ 50k")
+  → Gateway: decision=true and confidence≥0.8 → Auto-approve
+             decision=false and confidence≥0.8 → Auto-deny
+             default                           → Human review
+```
+
+## Error handling
+
+Add boundary events to your service tasks to handle AI failures gracefully:
+
+- **Error boundary** catching `AI_PARSE_ERROR` → route to a manual input fallback task
+- **Timer boundary** (PT5M) → escalation path if the worker is not running
+- Set `retries="3"` and `retryBackoff="PT30S"` on the task definition — the worker signals Camunda to retry via `failJob` on rate limits and network timeouts
+
+---
+
+## Related Packages
+
+| Package | Description |
+|---------|-------------|
+| [`@bpmnkit/core`](https://www.npmjs.com/package/@bpmnkit/core) | BPMN/DMN/Form parser, builder, layout engine |
+| [`@bpmnkit/canvas`](https://www.npmjs.com/package/@bpmnkit/canvas) | Zero-dependency SVG BPMN viewer |
+| [`@bpmnkit/editor`](https://www.npmjs.com/package/@bpmnkit/editor) | Full-featured interactive BPMN editor |
+| [`@bpmnkit/engine`](https://www.npmjs.com/package/@bpmnkit/engine) | Lightweight BPMN process execution engine |
+| [`@bpmnkit/feel`](https://www.npmjs.com/package/@bpmnkit/feel) | FEEL expression language parser & evaluator |
+| [`@bpmnkit/plugins`](https://www.npmjs.com/package/@bpmnkit/plugins) | 22 composable canvas plugins |
+| [`@bpmnkit/api`](https://www.npmjs.com/package/@bpmnkit/api) | Camunda 8 REST API TypeScript client |
+| [`@bpmnkit/ascii`](https://www.npmjs.com/package/@bpmnkit/ascii) | Render BPMN diagrams as Unicode ASCII art |
+| [`@bpmnkit/ui`](https://www.npmjs.com/package/@bpmnkit/ui) | Shared design tokens and UI components |
+| [`@bpmnkit/profiles`](https://www.npmjs.com/package/@bpmnkit/profiles) | Shared auth, profile storage, and client factories for CLI & proxy |
+| [`@bpmnkit/operate`](https://www.npmjs.com/package/@bpmnkit/operate) | Monitoring & operations frontend for Camunda clusters |
+| [`@bpmnkit/connector-gen`](https://www.npmjs.com/package/@bpmnkit/connector-gen) | Generate connector templates from OpenAPI specs |
+| [`@bpmnkit/cli`](https://www.npmjs.com/package/@bpmnkit/cli) | Camunda 8 command-line interface (casen) |
+| [`@bpmnkit/proxy`](https://www.npmjs.com/package/@bpmnkit/proxy) | Local AI bridge and Camunda API proxy server |
+| [`@bpmnkit/cli-sdk`](https://www.npmjs.com/package/@bpmnkit/cli-sdk) | Plugin authoring SDK for the casen CLI |
+| [`@bpmnkit/create-casen-plugin`](https://www.npmjs.com/package/@bpmnkit/create-casen-plugin) | Scaffold a new casen CLI plugin in seconds |
+| [`@bpmnkit/casen-report`](https://www.npmjs.com/package/@bpmnkit/casen-report) | HTML reports from Camunda 8 incident and SLA data |
+| [`@bpmnkit/casen-worker-http`](https://www.npmjs.com/package/@bpmnkit/casen-worker-http) | Example HTTP worker plugin — completes jobs with live JSONPlaceholder API data |
+
+## License
+
+[MIT](https://github.com/bpmnkit/monorepo/blob/main/LICENSE) © BPMN Kit — made by [u11g](https://u11g.com)
+
+<div align="center">
+  <a href="https://bpmnkit.com"><img src="https://bpmnkit.com/favicon.svg" width="32" height="32" alt="BPMN Kit"></a>
+</div>

package/dist/config.d.ts

@@ -0,0 +1,13 @@
+export interface AiWorkerConfig {
+    apiKey: string;
+    model: string;
+    maxTokens: number;
+    timeoutMs: number;
+}
+/**
+ * Resolves config from environment variables.
+ * Throws immediately if ANTHROPIC_API_KEY is absent so the error surfaces at
+ * worker startup rather than mid-job.
+ */
+export declare function resolveConfig(): AiWorkerConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CACjB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,cAAc,CAc9C"}

package/dist/config.js

@@ -0,0 +1,19 @@
+/**
+ * Resolves config from environment variables.
+ * Throws immediately if ANTHROPIC_API_KEY is absent so the error surfaces at
+ * worker startup rather than mid-job.
+ */
+export function resolveConfig() {
+    const apiKey = process.env.ANTHROPIC_API_KEY;
+    if (!apiKey) {
+        throw new Error("ANTHROPIC_API_KEY is not set. Export it before starting the AI worker:\n" +
+            "  export ANTHROPIC_API_KEY=sk-ant-...");
+    }
+    return {
+        apiKey,
+        model: process.env.AI_MODEL ?? "claude-3-5-haiku-20241022",
+        maxTokens: Number(process.env.AI_MAX_TOKENS ?? "1024"),
+        timeoutMs: Number(process.env.AI_TIMEOUT_MS ?? "60000"),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,MAAM,UAAU,aAAa;IAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAA;IAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACd,0EAA0E;YACzE,uCAAuC,CACxC,CAAA;IACF,CAAC;IACD,OAAO;QACN,MAAM;QACN,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,2BAA2B;QAC1D,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,MAAM,CAAC;QACtD,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,OAAO,CAAC;KACvD,CAAA;AACF,CAAC"}

package/dist/config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.test.d.ts.map

package/dist/config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.d.ts","sourceRoot":"","sources":["../src/config.test.ts"],"names":[],"mappings":""}

package/dist/config.test.js

@@ -0,0 +1,35 @@
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { resolveConfig } from "./config.js";
+describe("resolveConfig", () => {
+    const original = { ...process.env };
+    beforeEach(() => {
+        for (const key of ["ANTHROPIC_API_KEY", "AI_MODEL", "AI_MAX_TOKENS", "AI_TIMEOUT_MS"]) {
+            Reflect.deleteProperty(process.env, key);
+        }
+    });
+    afterEach(() => {
+        Object.assign(process.env, original);
+    });
+    it("throws when ANTHROPIC_API_KEY is not set", () => {
+        expect(() => resolveConfig()).toThrow("ANTHROPIC_API_KEY");
+    });
+    it("returns defaults when only API key is set", () => {
+        process.env.ANTHROPIC_API_KEY = "sk-test";
+        const cfg = resolveConfig();
+        expect(cfg.apiKey).toBe("sk-test");
+        expect(cfg.model).toBe("claude-3-5-haiku-20241022");
+        expect(cfg.maxTokens).toBe(1024);
+        expect(cfg.timeoutMs).toBe(60000);
+    });
+    it("overrides defaults from env vars", () => {
+        process.env.ANTHROPIC_API_KEY = "sk-test";
+        process.env.AI_MODEL = "claude-opus-4-6";
+        process.env.AI_MAX_TOKENS = "2048";
+        process.env.AI_TIMEOUT_MS = "30000";
+        const cfg = resolveConfig();
+        expect(cfg.model).toBe("claude-opus-4-6");
+        expect(cfg.maxTokens).toBe(2048);
+        expect(cfg.timeoutMs).toBe(30000);
+    });
+});
+//# sourceMappingURL=config.test.js.map

package/dist/config.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.js","sourceRoot":"","sources":["../src/config.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC9B,MAAM,QAAQ,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;IAEnC,UAAU,CAAC,GAAG,EAAE;QACf,KAAK,MAAM,GAAG,IAAI,CAAC,mBAAmB,EAAE,UAAU,EAAE,eAAe,EAAE,eAAe,CAAC,EAAE,CAAC;YACvF,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;QACzC,CAAC;IACF,CAAC,CAAC,CAAA;IAEF,SAAS,CAAC,GAAG,EAAE;QACd,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;IACrC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAA;IAC3D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACpD,OAAO,CAAC,GAAG,CAAC,iBAAiB,GAAG,SAAS,CAAA;QACzC,MAAM,GAAG,GAAG,aAAa,EAAE,CAAA;QAC3B,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAClC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAA;QACnD,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC3C,OAAO,CAAC,GAAG,CAAC,iBAAiB,GAAG,SAAS,CAAA;QACzC,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,iBAAiB,CAAA;QACxC,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,MAAM,CAAA;QAClC,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,OAAO,CAAA;QACnC,MAAM,GAAG,GAAG,aAAa,EAAE,CAAA;QAC3B,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;QACzC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import { type CasenPlugin } from "@bpmnkit/cli-sdk";
+declare const plugin: CasenPlugin;
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAuB,MAAM,kBAAkB,CAAA;AAOxE,QAAA,MAAM,MAAM,EAAE,WA4Cb,CAAA;AAED,eAAe,MAAM,CAAA"}

package/dist/index.js

@@ -0,0 +1,53 @@
+import { createWorkerCommand } from "@bpmnkit/cli-sdk";
+import { resolveConfig } from "./config.js";
+import { classify } from "./operations/classify.js";
+import { decide } from "./operations/decide.js";
+import { extract } from "./operations/extract.js";
+import { summarize } from "./operations/summarize.js";
+const plugin = {
+    id: "com.bpmnkit.casen-worker-ai",
+    name: "AI Worker",
+    version: "0.1.0",
+    groups: [
+        {
+            name: "ai-worker",
+            description: "AI-powered job workers — classify, summarize, extract, decide",
+            commands: [
+                createWorkerCommand({
+                    jobType: "com.bpmnkit.ai.classify",
+                    description: "Classify text into one of the given categories",
+                    defaultVariables: { category: "unknown", confidence: 0, rationale: "no handler" },
+                    async processJob(job) {
+                        return classify(job, resolveConfig());
+                    },
+                }),
+                createWorkerCommand({
+                    jobType: "com.bpmnkit.ai.summarize",
+                    description: "Summarize text to a given length and style",
+                    defaultVariables: { summary: "", wordCount: 0 },
+                    async processJob(job) {
+                        return summarize(job, resolveConfig());
+                    },
+                }),
+                createWorkerCommand({
+                    jobType: "com.bpmnkit.ai.extract",
+                    description: "Extract structured fields from unstructured text",
+                    defaultVariables: { extracted: {}, missingFields: [] },
+                    async processJob(job) {
+                        return extract(job, resolveConfig());
+                    },
+                }),
+                createWorkerCommand({
+                    jobType: "com.bpmnkit.ai.decide",
+                    description: "Make a boolean decision based on a question, context, and optional policy",
+                    defaultVariables: { decision: false, rationale: "", confidence: 0 },
+                    async processJob(job) {
+                        return decide(job, resolveConfig());
+                    },
+                }),
+            ],
+        },
+    ],
+};
+export default plugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAErD,MAAM,MAAM,GAAgB;IAC3B,EAAE,EAAE,6BAA6B;IACjC,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE;QACP;YACC,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,+DAA+D;YAC5E,QAAQ,EAAE;gBACT,mBAAmB,CAAC;oBACnB,OAAO,EAAE,yBAAyB;oBAClC,WAAW,EAAE,gDAAgD;oBAC7D,gBAAgB,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE;oBACjF,KAAK,CAAC,UAAU,CAAC,GAAG;wBACnB,OAAO,QAAQ,CAAC,GAAG,EAAE,aAAa,EAAE,CAAC,CAAA;oBACtC,CAAC;iBACD,CAAC;gBACF,mBAAmB,CAAC;oBACnB,OAAO,EAAE,0BAA0B;oBACnC,WAAW,EAAE,4CAA4C;oBACzD,gBAAgB,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE;oBAC/C,KAAK,CAAC,UAAU,CAAC,GAAG;wBACnB,OAAO,SAAS,CAAC,GAAG,EAAE,aAAa,EAAE,CAAC,CAAA;oBACvC,CAAC;iBACD,CAAC;gBACF,mBAAmB,CAAC;oBACnB,OAAO,EAAE,wBAAwB;oBACjC,WAAW,EAAE,kDAAkD;oBAC/D,gBAAgB,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE;oBACtD,KAAK,CAAC,UAAU,CAAC,GAAG;wBACnB,OAAO,OAAO,CAAC,GAAG,EAAE,aAAa,EAAE,CAAC,CAAA;oBACrC,CAAC;iBACD,CAAC;gBACF,mBAAmB,CAAC;oBACnB,OAAO,EAAE,uBAAuB;oBAChC,WAAW,EAAE,2EAA2E;oBACxF,gBAAgB,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE;oBACnE,KAAK,CAAC,UAAU,CAAC,GAAG;wBACnB,OAAO,MAAM,CAAC,GAAG,EAAE,aAAa,EAAE,CAAC,CAAA;oBACpC,CAAC;iBACD,CAAC;aACF;SACD;KACD;CACD,CAAA;AAED,eAAe,MAAM,CAAA"}

package/dist/llm.d.ts

@@ -0,0 +1,18 @@
+import type { AiWorkerConfig } from "./config.js";
+export declare class RetryableError extends Error {
+    constructor(message: string);
+}
+/**
+ * Calls the Anthropic messages API and returns the text content.
+ *
+ * Throws {@link RetryableError} for transient failures (rate limits, timeouts,
+ * 5xx errors) so callers can return `{ outcome: "fail" }` and let Camunda retry.
+ * Throws a plain Error for hard failures (auth, invalid request).
+ */
+export declare function callLlm(systemPrompt: string, userMessage: string, config: AiWorkerConfig): Promise<string>;
+/**
+ * Parses an LLM response as JSON. Handles responses wrapped in a markdown
+ * code fence (```json ... ```) which models sometimes emit.
+ */
+export declare function parseJsonResponse<T>(text: string): T;
+//# sourceMappingURL=llm.d.ts.map

package/dist/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../src/llm.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD,qBAAa,cAAe,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI3B;AAED;;;;;;GAMG;AACH,wBAAsB,OAAO,CAC5B,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,GACpB,OAAO,CAAC,MAAM,CAAC,CAiCjB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAMpD"}

package/dist/llm.js

@@ -0,0 +1,57 @@
+import Anthropic from "@anthropic-ai/sdk";
+export class RetryableError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "RetryableError";
+    }
+}
+/**
+ * Calls the Anthropic messages API and returns the text content.
+ *
+ * Throws {@link RetryableError} for transient failures (rate limits, timeouts,
+ * 5xx errors) so callers can return `{ outcome: "fail" }` and let Camunda retry.
+ * Throws a plain Error for hard failures (auth, invalid request).
+ */
+export async function callLlm(systemPrompt, userMessage, config) {
+    const client = new Anthropic({
+        apiKey: config.apiKey,
+        timeout: config.timeoutMs,
+        maxRetries: 0, // we let Camunda handle retries via failJob
+    });
+    let message;
+    try {
+        message = await client.messages.create({
+            model: config.model,
+            max_tokens: config.maxTokens,
+            system: systemPrompt,
+            messages: [{ role: "user", content: userMessage }],
+        });
+    }
+    catch (err) {
+        if (err instanceof Anthropic.RateLimitError ||
+            err instanceof Anthropic.APIConnectionTimeoutError) {
+            throw new RetryableError(err.message);
+        }
+        if (err instanceof Anthropic.InternalServerError) {
+            throw new RetryableError(err.message);
+        }
+        throw err;
+    }
+    const block = message.content[0];
+    if (!block || block.type !== "text") {
+        throw new Error("Unexpected response shape from Anthropic API");
+    }
+    return block.text;
+}
+/**
+ * Parses an LLM response as JSON. Handles responses wrapped in a markdown
+ * code fence (```json ... ```) which models sometimes emit.
+ */
+export function parseJsonResponse(text) {
+    const stripped = text
+        .replace(/^```(?:json)?\s*/i, "")
+        .replace(/\s*```\s*$/, "")
+        .trim();
+    return JSON.parse(stripped);
+}
+//# sourceMappingURL=llm.js.map

package/dist/llm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.js","sourceRoot":"","sources":["../src/llm.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,mBAAmB,CAAA;AAGzC,MAAM,OAAO,cAAe,SAAQ,KAAK;IACxC,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;IAC7B,CAAC;CACD;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC5B,YAAoB,EACpB,WAAmB,EACnB,MAAsB;IAEtB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC5B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,SAAS;QACzB,UAAU,EAAE,CAAC,EAAE,4CAA4C;KAC3D,CAAC,CAAA;IAEF,IAAI,OAA0B,CAAA;IAC9B,IAAI,CAAC;QACJ,OAAO,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;YACtC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,UAAU,EAAE,MAAM,CAAC,SAAS;YAC5B,MAAM,EAAE,YAAY;YACpB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;SAClD,CAAC,CAAA;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,IACC,GAAG,YAAY,SAAS,CAAC,cAAc;YACvC,GAAG,YAAY,SAAS,CAAC,yBAAyB,EACjD,CAAC;YACF,MAAM,IAAI,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACtC,CAAC;QACD,IAAI,GAAG,YAAY,SAAS,CAAC,mBAAmB,EAAE,CAAC;YAClD,MAAM,IAAI,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACtC,CAAC;QACD,MAAM,GAAG,CAAA;IACV,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IAChC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;IAChE,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAA;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAI,IAAY;IAChD,MAAM,QAAQ,GAAG,IAAI;SACnB,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC;SAChC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;SACzB,IAAI,EAAE,CAAA;IACR,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAM,CAAA;AACjC,CAAC"}

package/dist/operations/classify.d.ts

@@ -0,0 +1,16 @@
+import type { WorkerJob, WorkerJobResult } from "@bpmnkit/cli-sdk";
+import type { AiWorkerConfig } from "../config.js";
+/**
+ * Classifies job.variables.input into one of job.variables.categories.
+ *
+ * Required job variables:
+ * - input: string — the text to classify
+ * - categories: string[] — allowed category names
+ *
+ * Optional:
+ * - context: string — additional domain context for the model
+ *
+ * Output variables: category, confidence, rationale, aiModel, processedAt
+ */
+export declare function classify(job: WorkerJob, config: AiWorkerConfig): Promise<WorkerJobResult>;
+//# sourceMappingURL=classify.d.ts.map

package/dist/operations/classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../src/operations/classify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAelD;;;;;;;;;;;GAWG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAwD/F"}

package/dist/operations/classify.js

@@ -0,0 +1,74 @@
+import { RetryableError, callLlm, parseJsonResponse } from "../llm.js";
+const SYSTEM_PROMPT = `You are a text classification assistant.
+The user will provide text to classify and a list of allowed categories.
+Respond ONLY with valid JSON matching this exact shape:
+{ "category": "<one of the allowed categories>", "confidence": <0.0–1.0>, "rationale": "<one sentence>" }
+Do not include any prose outside the JSON object.`;
+/**
+ * Classifies job.variables.input into one of job.variables.categories.
+ *
+ * Required job variables:
+ * - input: string — the text to classify
+ * - categories: string[] — allowed category names
+ *
+ * Optional:
+ * - context: string — additional domain context for the model
+ *
+ * Output variables: category, confidence, rationale, aiModel, processedAt
+ */
+export async function classify(job, config) {
+    const input = String(job.variables.input ?? "");
+    const categories = job.variables.categories;
+    if (!Array.isArray(categories) || categories.length === 0) {
+        return {
+            outcome: "error",
+            errorCode: "AI_INVALID_INPUT",
+            errorMessage: 'Job variable "categories" must be a non-empty array of strings.',
+        };
+    }
+    const context = job.variables.context ? `\nContext: ${String(job.variables.context)}` : "";
+    const userMessage = `Allowed categories: ${JSON.stringify(categories)}${context}\n\nText to classify:\n${input}`;
+    let raw;
+    try {
+        raw = await callLlm(SYSTEM_PROMPT, userMessage, config);
+    }
+    catch (err) {
+        if (err instanceof RetryableError) {
+            return { outcome: "fail", errorMessage: err.message, retries: 2, retryBackOff: 30_000 };
+        }
+        return {
+            outcome: "error",
+            errorCode: "AI_API_ERROR",
+            errorMessage: err instanceof Error ? err.message : String(err),
+        };
+    }
+    let parsed;
+    try {
+        parsed = parseJsonResponse(raw);
+    }
+    catch {
+        return {
+            outcome: "error",
+            errorCode: "AI_PARSE_ERROR",
+            errorMessage: `Model returned non-JSON response: ${raw.slice(0, 200)}`,
+        };
+    }
+    if (!categories.includes(parsed.category)) {
+        return {
+            outcome: "error",
+            errorCode: "AI_INVALID_CATEGORY",
+            errorMessage: `Model returned category "${parsed.category}" which is not in the allowed list: ${JSON.stringify(categories)}`,
+        };
+    }
+    return {
+        outcome: "complete",
+        variables: {
+            category: parsed.category,
+            confidence: parsed.confidence,
+            rationale: parsed.rationale,
+            aiModel: config.model,
+            processedAt: new Date().toISOString(),
+        },
+    };
+}
+//# sourceMappingURL=classify.js.map

package/dist/operations/classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.js","sourceRoot":"","sources":["../../src/operations/classify.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAQtE,MAAM,aAAa,GAAG;;;;kDAI4B,CAAA;AAElD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAc,EAAE,MAAsB;IACpE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC,CAAA;IAC/C,MAAM,UAAU,GAAG,GAAG,CAAC,SAAS,CAAC,UAAU,CAAA;IAC3C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3D,OAAO;YACN,OAAO,EAAE,OAAO;YAChB,SAAS,EAAE,kBAAkB;YAC7B,YAAY,EAAE,iEAAiE;SAC/E,CAAA;IACF,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IAC1F,MAAM,WAAW,GAAG,uBAAuB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,OAAO,0BAA0B,KAAK,EAAE,CAAA;IAEhH,IAAI,GAAW,CAAA;IACf,IAAI,CAAC;QACJ,GAAG,GAAG,MAAM,OAAO,CAAC,aAAa,EAAE,WAAW,EAAE,MAAM,CAAC,CAAA;IACxD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,IAAI,GAAG,YAAY,cAAc,EAAE,CAAC;YACnC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,CAAA;QACxF,CAAC;QACD,OAAO;YACN,OAAO,EAAE,OAAO;YAChB,SAAS,EAAE,cAAc;YACzB,YAAY,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SAC9D,CAAA;IACF,CAAC;IAED,IAAI,MAAwB,CAAA;IAC5B,IAAI,CAAC;QACJ,MAAM,GAAG,iBAAiB,CAAmB,GAAG,CAAC,CAAA;IAClD,CAAC;IAAC,MAAM,CAAC;QACR,OAAO;YACN,OAAO,EAAE,OAAO;YAChB,SAAS,EAAE,gBAAgB;YAC3B,YAAY,EAAE,qCAAqC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;SACtE,CAAA;IACF,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3C,OAAO;YACN,OAAO,EAAE,OAAO;YAChB,SAAS,EAAE,qBAAqB;YAChC,YAAY,EAAE,4BAA4B,MAAM,CAAC,QAAQ,uCAAuC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE;SAC5H,CAAA;IACF,CAAC;IAED,OAAO;QACN,OAAO,EAAE,UAAU;QACnB,SAAS,EAAE;YACV,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,OAAO,EAAE,MAAM,CAAC,KAAK;YACrB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACrC;KACD,CAAA;AACF,CAAC"}

package/dist/operations/classify.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=classify.test.d.ts.map

package/dist/operations/classify.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.test.d.ts","sourceRoot":"","sources":["../../src/operations/classify.test.ts"],"names":[],"mappings":""}