@nebutra/support-deflector 0.1.3 → 0.1.5

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @nebutra/support-deflector
 
+## 0.1.5
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @nebutra/capability-kit@2.0.0
+  - @nebutra/errors@2.0.0
+  - @nebutra/event-log@2.0.0
+  - @nebutra/content-store@0.1.5
+  - @nebutra/play-loader@0.1.4
+  - @nebutra/generation-context@0.1.4
+
 ## 0.1.3
 
 ### Patch Changes

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@nebutra/support-deflector",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Confidence-gated customer support Play package for founder-owned support automation",
   "private": false,
   "license": "MIT",
   "type": "module",
   "nebutra": {
+    "graph": "labs",
     "status": "wip",
     "productionReady": false,
     "surface": "play-product",
@@ -23,18 +24,22 @@
     "category": "ai",
     "summary": "Support Play product that triages tickets into auto-answer, suggest, or escalate decisions"
   },
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
   },
   "dependencies": {
-    "@nebutra/capability-kit": "0.2.2",
-    "@nebutra/content-store": "0.1.2",
-    "@nebutra/errors": "0.1.2",
-    "@nebutra/generation-context": "0.1.2",
-    "@nebutra/event-log": "0.1.2",
-    "@nebutra/play-loader": "0.1.2"
+    "@nebutra/capability-kit": "2.0.0",
+    "@nebutra/content-store": "0.1.5",
+    "@nebutra/errors": "2.0.0",
+    "@nebutra/event-log": "2.0.0",
+    "@nebutra/generation-context": "0.1.4",
+    "@nebutra/play-loader": "0.1.4"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",
@@ -55,6 +60,12 @@
   "publishConfig": {
     "access": "public"
   },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
   "scripts": {
     "build": "tsup",
     "test": "vitest run",

package/.nebutra/debug/content-store.jsonl

@@ -1,24 +0,0 @@
-{"at":"2026-05-18T14:42:47.511Z","type":"reindex","tenantId":"tenant_a","files":0}
-{"at":"2026-05-18T14:42:47.514Z","type":"write","tenantId":"tenant_a","path":"support/tickets/ticket_1.json"}
-{"at":"2026-05-18T14:42:47.522Z","type":"reindex","tenantId":"tenant_a","files":0}
-{"at":"2026-05-18T14:43:18.065Z","type":"reindex","tenantId":"tenant_a","files":0}
-{"at":"2026-05-18T14:43:18.069Z","type":"write","tenantId":"tenant_a","path":"support/tickets/ticket_1.json"}
-{"at":"2026-05-18T14:43:18.077Z","type":"reindex","tenantId":"tenant_a","files":0}
-{"at":"2026-05-18T14:46:58.860Z","type":"reindex","tenantId":"tenant_a","files":0}
-{"at":"2026-05-18T14:46:58.868Z","type":"write","tenantId":"tenant_a","path":"support/tickets/ticket_1.json"}
-{"at":"2026-05-18T14:46:58.885Z","type":"reindex","tenantId":"tenant_a","files":0}
-{"at":"2026-05-18T14:49:15.261Z","type":"reindex","tenantId":"tenant_a","files":0}
-{"at":"2026-05-18T14:49:15.269Z","type":"write","tenantId":"tenant_a","path":"support/tickets/ticket_1.json"}
-{"at":"2026-05-18T14:49:15.284Z","type":"reindex","tenantId":"tenant_a","files":0}
-{"at":"2026-05-18T14:52:55.141Z","type":"reindex","tenantId":"tenant_a","files":0}
-{"at":"2026-05-18T14:52:55.144Z","type":"write","tenantId":"tenant_a","path":"support/tickets/ticket_1.json"}
-{"at":"2026-05-18T14:52:55.151Z","type":"reindex","tenantId":"tenant_a","files":0}
-{"at":"2026-05-19T05:25:19.177Z","type":"reindex","tenantId":"tenant_a","files":0}
-{"at":"2026-05-19T05:25:19.181Z","type":"write","tenantId":"tenant_a","path":"support/tickets/ticket_1.json"}
-{"at":"2026-05-19T05:25:19.187Z","type":"reindex","tenantId":"tenant_a","files":0}
-{"at":"2026-05-30T21:07:17.661Z","type":"reindex","tenantId":"tenant_a","files":0}
-{"at":"2026-05-30T21:07:17.669Z","type":"write","tenantId":"tenant_a","path":"support/tickets/ticket_1.json"}
-{"at":"2026-05-30T21:07:17.689Z","type":"reindex","tenantId":"tenant_a","files":0}
-{"at":"2026-07-01T01:40:46.757Z","type":"reindex","tenantId":"tenant_a","files":0}
-{"at":"2026-07-01T01:40:46.791Z","type":"write","tenantId":"tenant_a","path":"support/tickets/ticket_1.json"}
-{"at":"2026-07-01T01:40:46.902Z","type":"reindex","tenantId":"tenant_a","files":0}

package/.nebutra/debug/event-log.jsonl

@@ -1,8 +0,0 @@
-{"traceId":"support_ticket_ticket_1_mpbbcrbu","kind":"content_write","affected":["support/tickets/ticket_1.json"],"parent":null,"snapshot":{"support/tickets/ticket_1.json":"{\n  \"ticket\": {\n    \"id\": \"ticket_1\",\n    \"tenantId\": \"tenant_a\",\n    \"customer\": {\n      \"id\": \"customer_1\",\n      \"email\": \"a@example.com\",\n      \"plan\": \"free\"\n    },\n    \"subject\": \"How do refunds work?\",\n    \"body\": \"Can I get a refund if I cancel this week?\"\n  },\n  \"decision\": {\n    \"play\": \"ticket_triage\",\n    \"action\": \"auto-answer\",\n    \"confidence\": 0.9,\n    \"classification\": {\n      \"category\": \"billing\",\n      \"sentiment\": \"neutral\",\n      \"highValue\": false,\n      \"complaint\": false\n    },\n    \"reply\": {\n      \"subject\": \"Re: How do refunds work?\",\n      \"body\": \"Refunds are available within 14 days. If you want, reply here and we will help with the next step.\",\n      \"citations\": [\n        \"kb_refund\"\n      ]\n    }\n  }\n}\n"},"id":"0159324ba9e04ef756841e6cdbfabd1dac01c7c671399606a429d5b7763ec7a3","tenantId":"tenant_a","at":"2026-05-18T14:42:47.515Z","summary":"content_write touched 1 path(s)","objectHashes":["e79f9ed0f7be6b3229b5eff19a9f5e242fb2575fe56c38dfdda06bf56d882706"]}
-{"traceId":"support_ticket_ticket_1_mpbbdewl","kind":"content_write","affected":["support/tickets/ticket_1.json"],"parent":null,"snapshot":{"support/tickets/ticket_1.json":"{\n  \"ticket\": {\n    \"id\": \"ticket_1\",\n    \"tenantId\": \"tenant_a\",\n    \"customer\": {\n      \"id\": \"customer_1\",\n      \"email\": \"a@example.com\",\n      \"plan\": \"free\"\n    },\n    \"subject\": \"How do refunds work?\",\n    \"body\": \"Can I get a refund if I cancel this week?\"\n  },\n  \"decision\": {\n    \"play\": \"ticket_triage\",\n    \"action\": \"auto-answer\",\n    \"confidence\": 0.9,\n    \"classification\": {\n      \"category\": \"billing\",\n      \"sentiment\": \"neutral\",\n      \"highValue\": false,\n      \"complaint\": false\n    },\n    \"reply\": {\n      \"subject\": \"Re: How do refunds work?\",\n      \"body\": \"Refunds are available within 14 days. If you want, reply here and we will help with the next step.\",\n      \"citations\": [\n        \"kb_refund\"\n      ]\n    }\n  }\n}\n"},"id":"6cc0b872a13bf1d3a629c79cd34fc6065ee246820ff8ad9b9ed750437d0ebbd0","tenantId":"tenant_a","at":"2026-05-18T14:43:18.070Z","summary":"content_write touched 1 path(s)","objectHashes":["e79f9ed0f7be6b3229b5eff19a9f5e242fb2575fe56c38dfdda06bf56d882706"]}
-{"traceId":"support_ticket_ticket_1_mpbbi59w","kind":"content_write","affected":["support/tickets/ticket_1.json"],"parent":null,"snapshot":{"support/tickets/ticket_1.json":"{\n  \"ticket\": {\n    \"id\": \"ticket_1\",\n    \"tenantId\": \"tenant_a\",\n    \"customer\": {\n      \"id\": \"customer_1\",\n      \"email\": \"a@example.com\",\n      \"plan\": \"free\"\n    },\n    \"subject\": \"How do refunds work?\",\n    \"body\": \"Can I get a refund if I cancel this week?\"\n  },\n  \"decision\": {\n    \"play\": \"ticket_triage\",\n    \"action\": \"auto-answer\",\n    \"confidence\": 0.9,\n    \"classification\": {\n      \"category\": \"billing\",\n      \"sentiment\": \"neutral\",\n      \"highValue\": false,\n      \"complaint\": false\n    },\n    \"reply\": {\n      \"subject\": \"Re: How do refunds work?\",\n      \"body\": \"Refunds are available within 14 days. If you want, reply here and we will help with the next step.\",\n      \"citations\": [\n        \"kb_refund\"\n      ]\n    }\n  }\n}\n"},"id":"260d0399f35022be282b386901cc1a9234f644ea5b08cf41d72b23265321a159","tenantId":"tenant_a","at":"2026-05-18T14:46:58.871Z","summary":"content_write touched 1 path(s)","objectHashes":["e79f9ed0f7be6b3229b5eff19a9f5e242fb2575fe56c38dfdda06bf56d882706"]}
-{"traceId":"support_ticket_ticket_1_mpbbl2it","kind":"content_write","affected":["support/tickets/ticket_1.json"],"parent":null,"snapshot":{"support/tickets/ticket_1.json":"{\n  \"ticket\": {\n    \"id\": \"ticket_1\",\n    \"tenantId\": \"tenant_a\",\n    \"customer\": {\n      \"id\": \"customer_1\",\n      \"email\": \"a@example.com\",\n      \"plan\": \"free\"\n    },\n    \"subject\": \"How do refunds work?\",\n    \"body\": \"Can I get a refund if I cancel this week?\"\n  },\n  \"decision\": {\n    \"play\": \"ticket_triage\",\n    \"action\": \"auto-answer\",\n    \"confidence\": 0.9,\n    \"classification\": {\n      \"category\": \"billing\",\n      \"sentiment\": \"neutral\",\n      \"highValue\": false,\n      \"complaint\": false\n    },\n    \"reply\": {\n      \"subject\": \"Re: How do refunds work?\",\n      \"body\": \"Refunds are available within 14 days. If you want, reply here and we will help with the next step.\",\n      \"citations\": [\n        \"kb_refund\"\n      ]\n    }\n  }\n}\n"},"id":"6028e0dea1613330851b76045afdee123a40cc4aaf6967f879c2ec6a8d73f7da","tenantId":"tenant_a","at":"2026-05-18T14:49:15.271Z","summary":"content_write touched 1 path(s)","objectHashes":["e79f9ed0f7be6b3229b5eff19a9f5e242fb2575fe56c38dfdda06bf56d882706"]}
-{"traceId":"support_ticket_ticket_1_mpbbps6g","kind":"content_write","affected":["support/tickets/ticket_1.json"],"parent":null,"snapshot":{"support/tickets/ticket_1.json":"{\n  \"ticket\": {\n    \"id\": \"ticket_1\",\n    \"tenantId\": \"tenant_a\",\n    \"customer\": {\n      \"id\": \"customer_1\",\n      \"email\": \"a@example.com\",\n      \"plan\": \"free\"\n    },\n    \"subject\": \"How do refunds work?\",\n    \"body\": \"Can I get a refund if I cancel this week?\"\n  },\n  \"decision\": {\n    \"play\": \"ticket_triage\",\n    \"action\": \"auto-answer\",\n    \"confidence\": 0.9,\n    \"classification\": {\n      \"category\": \"billing\",\n      \"sentiment\": \"neutral\",\n      \"highValue\": false,\n      \"complaint\": false\n    },\n    \"reply\": {\n      \"subject\": \"Re: How do refunds work?\",\n      \"body\": \"Refunds are available within 14 days. If you want, reply here and we will help with the next step.\",\n      \"citations\": [\n        \"kb_refund\"\n      ]\n    }\n  }\n}\n"},"id":"a4538cd355acc38f2bea8c4157e5084282330344282c32260cca963227039de9","tenantId":"tenant_a","at":"2026-05-18T14:52:55.145Z","summary":"content_write touched 1 path(s)","objectHashes":["e79f9ed0f7be6b3229b5eff19a9f5e242fb2575fe56c38dfdda06bf56d882706"]}
-{"traceId":"support_ticket_ticket_1_mpc6vp3h","kind":"content_write","affected":["support/tickets/ticket_1.json"],"parent":null,"snapshot":{"support/tickets/ticket_1.json":"{\n  \"ticket\": {\n    \"id\": \"ticket_1\",\n    \"tenantId\": \"tenant_a\",\n    \"customer\": {\n      \"id\": \"customer_1\",\n      \"email\": \"a@example.com\",\n      \"plan\": \"free\"\n    },\n    \"subject\": \"How do refunds work?\",\n    \"body\": \"Can I get a refund if I cancel this week?\"\n  },\n  \"decision\": {\n    \"play\": \"ticket_triage\",\n    \"action\": \"auto-answer\",\n    \"confidence\": 0.9,\n    \"classification\": {\n      \"category\": \"billing\",\n      \"sentiment\": \"neutral\",\n      \"highValue\": false,\n      \"complaint\": false\n    },\n    \"reply\": {\n      \"subject\": \"Re: How do refunds work?\",\n      \"body\": \"Refunds are available within 14 days. If you want, reply here and we will help with the next step.\",\n      \"citations\": [\n        \"kb_refund\"\n      ]\n    }\n  }\n}\n"},"id":"ac23d8981d7f37cc896019911e6256e082e039d4f42d48184f08c2b3036f0c13","tenantId":"tenant_a","at":"2026-05-19T05:25:19.182Z","summary":"content_write touched 1 path(s)","objectHashes":["e79f9ed0f7be6b3229b5eff19a9f5e242fb2575fe56c38dfdda06bf56d882706"]}
-{"at":"2026-05-30T21:07:17.673Z","traceId":"support_ticket_ticket_1_mpsudgdi","kind":"content_write","affected":["support/tickets/ticket_1.json"],"parent":null,"snapshot":{"support/tickets/ticket_1.json":"{\n  \"ticket\": {\n    \"id\": \"ticket_1\",\n    \"tenantId\": \"tenant_a\",\n    \"customer\": {\n      \"id\": \"customer_1\",\n      \"email\": \"a@example.com\",\n      \"plan\": \"free\"\n    },\n    \"subject\": \"How do refunds work?\",\n    \"body\": \"Can I get a refund if I cancel this week?\"\n  },\n  \"decision\": {\n    \"play\": \"ticket_triage\",\n    \"action\": \"auto-answer\",\n    \"confidence\": 0.9,\n    \"classification\": {\n      \"category\": \"billing\",\n      \"sentiment\": \"neutral\",\n      \"highValue\": false,\n      \"complaint\": false\n    },\n    \"reply\": {\n      \"subject\": \"Re: How do refunds work?\",\n      \"body\": \"Refunds are available within 14 days. If you want, reply here and we will help with the next step.\",\n      \"citations\": [\n        \"kb_refund\"\n      ]\n    }\n  }\n}\n"},"id":"a1fb106d15db970f8d27d3c644fd96d17ec6d2c96de6cbd8b5d023f2a3c3be93","tenantId":"tenant_a","summary":"content_write touched 1 path(s)","objectHashes":["e79f9ed0f7be6b3229b5eff19a9f5e242fb2575fe56c38dfdda06bf56d882706"]}
-{"at":"2026-07-01T01:40:46.794Z","traceId":"support_ticket_ticket_1_mr1eskef","kind":"content_write","affected":["support/tickets/ticket_1.json"],"parent":null,"snapshot":{"support/tickets/ticket_1.json":"{\n  \"ticket\": {\n    \"id\": \"ticket_1\",\n    \"tenantId\": \"tenant_a\",\n    \"customer\": {\n      \"id\": \"customer_1\",\n      \"email\": \"a@example.com\",\n      \"plan\": \"free\"\n    },\n    \"subject\": \"How do refunds work?\",\n    \"body\": \"Can I get a refund if I cancel this week?\"\n  },\n  \"decision\": {\n    \"play\": \"ticket_triage\",\n    \"action\": \"auto-answer\",\n    \"confidence\": 0.9,\n    \"classification\": {\n      \"category\": \"billing\",\n      \"sentiment\": \"neutral\",\n      \"highValue\": false,\n      \"complaint\": false\n    },\n    \"reply\": {\n      \"subject\": \"Re: How do refunds work?\",\n      \"body\": \"Refunds are available within 14 days. If you want, reply here and we will help with the next step.\",\n      \"citations\": [\n        \"kb_refund\"\n      ]\n    }\n  }\n}\n"},"id":"51bb8ca6110ee8ca731e729ea92f1e3f9c15e46a7cec12ed9379b25659f1a216","tenantId":"tenant_a","summary":"content_write touched 1 path(s)","objectHashes":["e79f9ed0f7be6b3229b5eff19a9f5e242fb2575fe56c38dfdda06bf56d882706"]}

package/.nebutra/debug/support-deflector.jsonl

@@ -1,8 +0,0 @@
-{"at":"2026-05-18T14:42:47.516Z","type":"ticket_decision","tenantId":"tenant_a","ticketId":"ticket_1","action":"auto-answer","eventId":"0159324ba9e04ef756841e6cdbfabd1dac01c7c671399606a429d5b7763ec7a3"}
-{"at":"2026-05-18T14:43:18.070Z","type":"ticket_decision","tenantId":"tenant_a","ticketId":"ticket_1","action":"auto-answer","eventId":"6cc0b872a13bf1d3a629c79cd34fc6065ee246820ff8ad9b9ed750437d0ebbd0"}
-{"at":"2026-05-18T14:46:58.872Z","type":"ticket_decision","tenantId":"tenant_a","ticketId":"ticket_1","action":"auto-answer","eventId":"260d0399f35022be282b386901cc1a9234f644ea5b08cf41d72b23265321a159"}
-{"at":"2026-05-18T14:49:15.274Z","type":"ticket_decision","tenantId":"tenant_a","ticketId":"ticket_1","action":"auto-answer","eventId":"6028e0dea1613330851b76045afdee123a40cc4aaf6967f879c2ec6a8d73f7da"}
-{"at":"2026-05-18T14:52:55.146Z","type":"ticket_decision","tenantId":"tenant_a","ticketId":"ticket_1","action":"auto-answer","eventId":"a4538cd355acc38f2bea8c4157e5084282330344282c32260cca963227039de9"}
-{"at":"2026-05-19T05:25:19.182Z","type":"ticket_decision","tenantId":"tenant_a","ticketId":"ticket_1","action":"auto-answer","eventId":"ac23d8981d7f37cc896019911e6256e082e039d4f42d48184f08c2b3036f0c13"}
-{"at":"2026-05-30T21:07:17.675Z","type":"ticket_decision","tenantId":"tenant_a","ticketId":"ticket_1","action":"auto-answer","eventId":"a1fb106d15db970f8d27d3c644fd96d17ec6d2c96de6cbd8b5d023f2a3c3be93"}
-{"at":"2026-07-01T01:40:46.796Z","type":"ticket_decision","tenantId":"tenant_a","ticketId":"ticket_1","action":"auto-answer","eventId":"51bb8ca6110ee8ca731e729ea92f1e3f9c15e46a7cec12ed9379b25659f1a216"}

package/.turbo/turbo-build.log

@@ -1,22 +0,0 @@
-
-> @nebutra/support-deflector@0.1.3 build /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/ai/support-deflector
-> tsup
-
-CLI Building entry: src/cli.ts, src/index.ts
-CLI Using tsconfig: tsconfig.json
-CLI tsup v8.5.1
-CLI Using tsup config: /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/ai/support-deflector/tsup.config.ts
-CLI Target: es2022
-CLI Cleaning output folder
-ESM Build start
-ESM dist/cli.js                1.65 KB
-ESM dist/index.js              248.00 B
-ESM dist/chunk-EBB2GRYR.js     5.97 KB
-ESM dist/index.js.map          71.00 B
-ESM dist/chunk-EBB2GRYR.js.map 13.22 KB
-ESM dist/cli.js.map            2.80 KB
-ESM ⚡️ Build success in 44ms
-DTS Build start
-DTS ⚡️ Build success in 1559ms
-DTS dist/cli.d.ts   13.00 B
-DTS dist/index.d.ts 3.08 KB

package/.turbo/turbo-test.log

@@ -1,16 +0,0 @@
-
-> @nebutra/support-deflector@0.1.2 test /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/ai/support-deflector
-> vitest run
-
-
- RUN  v4.1.4 /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/ai/support-deflector
-
-(node:57826) ExperimentalWarning: SQLite is an experimental feature and might change at any time
-(Use `node --trace-warnings ...` to show where the warning was created)
- ✓ src/index.test.ts (5 tests) 191ms
-
- Test Files  1 passed (1)
-      Tests  5 passed (5)
-   Start at  09:40:45
-   Duration  1.31s (transform 373ms, setup 0ms, import 518ms, tests 191ms, environment 0ms)
-

package/.turbo/turbo-typecheck.log

@@ -1,4 +0,0 @@
-
-> @nebutra/support-deflector@0.1.3 typecheck /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/ai/support-deflector
-> tsc --noEmit
-

package/examples/classify.ts

@@ -1,15 +0,0 @@
-import { classifyTicket } from "../src/index";
-
-process.stdout.write(
-  `${JSON.stringify(
-    classifyTicket({
-      id: "ticket_1",
-      tenantId: "local",
-      customer: { id: "customer_1", email: "a@example.com", plan: "enterprise" },
-      subject: "Production bug",
-      body: "I am angry because this broke production.",
-    }),
-    null,
-    2,
-  )}\n`,
-);

package/examples/decision.ts

@@ -1,25 +0,0 @@
-import { decideTicket } from "../src/index";
-
-process.stdout.write(
-  `${JSON.stringify(
-    decideTicket(
-      {
-        id: "ticket_1",
-        tenantId: "local",
-        customer: { id: "customer_1", email: "a@example.com", plan: "free" },
-        subject: "Refund",
-        body: "How do refunds work?",
-      },
-      [
-        {
-          id: "kb_refund",
-          title: "Refund policy",
-          body: "Refunds are available within 14 days.",
-        },
-      ],
-      { autoReplyThreshold: 0.82 },
-    ),
-    null,
-    2,
-  )}\n`,
-);

package/examples/quickstart.ts

@@ -1,33 +0,0 @@
-import { SupportDeflector } from "../src/index";
-
-const support = await SupportDeflector.open(".nebutra/support-deflector-example", {
-  tenantId: "local",
-});
-
-try {
-  process.stdout.write(
-    `${JSON.stringify(
-      await support.handleTicket({
-        ticket: {
-          id: "ticket_demo",
-          tenantId: "local",
-          customer: { id: "customer_1", email: "a@example.com", plan: "free" },
-          subject: "How do refunds work?",
-          body: "Can I get a refund if I cancel this week?",
-        },
-        articles: [
-          {
-            id: "kb_refund",
-            title: "Refund policy",
-            body: "Refunds are available within 14 days. Contact support with your account email.",
-          },
-        ],
-        policy: { autoReplyThreshold: 0.82 },
-      }),
-      null,
-      2,
-    )}\n`,
-  );
-} finally {
-  await support.close();
-}

package/plays/ticket_triage/SKILL.md

@@ -1,36 +0,0 @@
----
-name: ticket_triage
-kind: play
-version: 1.0.0
-description: Triage a support ticket into auto-answer, suggest-answer, or escalate
-inputs:
-  ticket: { type: object }
-  support_policy: { type: object }
-outputs:
-  decision: { type: file, path: support/tickets/ticket.json, mime: application/json }
-budget:
-  duration_s: 30
-  cost_usd: 0.2
-required_skills:
-  - knowledge_base.search
-  - content_store.write
-  - event_log.commit
-sub_agents:
-  - role: support_triager
-    allowed_skills: [knowledge_base.search, content_store.write]
-  - role: escalation_summarizer
-    allowed_skills: [content_store.write]
-depends_on_plays: []
----
-
-## What this play does
-
-Classifies a new customer-support ticket, finds relevant knowledge, then returns
-a confidence-gated decision.
-
-## Rules
-
-- Escalate angry, complaint, or high-value customer tickets.
-- Auto-answer only when confidence exceeds policy threshold.
-- Keep the founder in control of medium-confidence replies.
-- Redact personally sensitive data before trace-store emission.

package/src/cli.ts

@@ -1,50 +0,0 @@
-import { readSupportDeflectorDebug, SupportDeflector } from "./index";
-
-const command = process.argv[2] ?? "doctor";
-const root = process.env.SUPPORT_DEFLECTOR_ROOT ?? ".nebutra/support-deflector";
-const tenantId = process.env.NEBUTRA_TENANT_ID ?? "local";
-
-if (command === "doctor") {
-  const support = await SupportDeflector.open(root, { tenantId });
-  try {
-    process.stdout.write(`${JSON.stringify(await support.doctor(), null, 2)}\n`);
-  } finally {
-    await support.close();
-  }
-} else if (command === "quickstart") {
-  const support = await SupportDeflector.open(root, { tenantId });
-  try {
-    process.stdout.write(
-      `${JSON.stringify(
-        await support.handleTicket({
-          ticket: {
-            id: "ticket_demo",
-            tenantId,
-            customer: { id: "customer_demo", email: "demo@example.com", plan: "free" },
-            subject: "How do refunds work?",
-            body: "Can I get a refund if I cancel this week?",
-          },
-          articles: [
-            {
-              id: "kb_refund",
-              title: "Refund policy",
-              body: "Refunds are available within 14 days. Contact support with your account email.",
-            },
-          ],
-          policy: { autoReplyThreshold: 0.82 },
-        }),
-        null,
-        2,
-      )}\n`,
-    );
-  } finally {
-    await support.close();
-  }
-} else if (command === "debug") {
-  process.stdout.write(
-    `${JSON.stringify({ capability: "support-deflector", entries: await readSupportDeflectorDebug() }, null, 2)}\n`,
-  );
-} else {
-  process.stderr.write(`Unknown support-deflector command: ${command}\n`);
-  process.exitCode = 1;
-}

package/src/index.test.ts

@@ -1,106 +0,0 @@
-import { mkdtemp, readFile, rm } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { parsePlayMarkdown } from "@nebutra/play-loader";
-import { afterEach, describe, expect, it } from "vitest";
-import { classifyTicket, decideTicket, readSupportDeflectorDebug, SupportDeflector } from "./index";
-
-let root: string | undefined;
-let support: SupportDeflector | undefined;
-
-const ticket = {
-  id: "ticket_1",
-  tenantId: "tenant_a",
-  customer: { id: "customer_1", email: "a@example.com", plan: "free" },
-  subject: "How do refunds work?",
-  body: "Can I get a refund if I cancel this week?",
-} as const;
-
-const articles = [
-  {
-    id: "kb_refund",
-    title: "Refund policy",
-    body: "Refunds are available within 14 days. Contact support and include your account email.",
-  },
-];
-
-afterEach(async () => {
-  if (support) await support.close();
-  if (root) await rm(root, { recursive: true, force: true });
-  root = undefined;
-  support = undefined;
-});
-
-async function open(): Promise<SupportDeflector> {
-  root = await mkdtemp(join(tmpdir(), "support-deflector-"));
-  support = await SupportDeflector.open(root, { tenantId: "tenant_a" });
-  return support;
-}
-
-describe("support-deflector", () => {
-  it("classifies customer tickets conservatively", () => {
-    expect(classifyTicket(ticket)).toMatchObject({ category: "billing", sentiment: "neutral" });
-    expect(
-      classifyTicket({
-        ...ticket,
-        body: "I am angry and this bug broke production for our enterprise team",
-      }),
-    ).toMatchObject({ category: "bug", sentiment: "angry", highValue: true });
-  });
-
-  it("uses confidence gates to decide auto-answer, suggest, or escalate", () => {
-    const auto = decideTicket(ticket, articles, { autoReplyThreshold: 0.82 });
-    const escalate = decideTicket(
-      {
-        ...ticket,
-        body: "I am angry and this broke production",
-        customer: { ...ticket.customer, plan: "enterprise" },
-      },
-      articles,
-      { autoReplyThreshold: 0.82 },
-    );
-
-    expect(auto.action).toBe("auto-answer");
-    expect(auto.reply?.body).toContain("Refunds are available within 14 days");
-    expect(escalate.action).toBe("escalate");
-  });
-
-  it("runs ticket_triage and records the decision", async () => {
-    const runtime = await open();
-
-    const decision = await runtime.handleTicket({
-      ticket,
-      articles,
-      policy: { autoReplyThreshold: 0.82 },
-    });
-
-    expect(decision.play).toBe("ticket_triage");
-    expect(decision.action).toBe("auto-answer");
-    expect(decision.eventId).toEqual(expect.any(String));
-    await expect(readSupportDeflectorDebug(root)).resolves.toEqual(expect.any(Array));
-  });
-
-  it("requires tenant context before persistent operations", async () => {
-    const runtime = await open();
-
-    await expect(
-      runtime.handleTicket({
-        ticket: { ...ticket, tenantId: "" },
-        articles,
-        policy: { autoReplyThreshold: 0.82 },
-      }),
-    ).rejects.toMatchObject({
-      capability: "support-deflector",
-      suggestion: expect.stringContaining("tenantId"),
-    });
-  });
-
-  it("keeps ticket triage as SKILL.md instead of a new workflow format", async () => {
-    const skill = await readFile(join(process.cwd(), "plays", "ticket_triage", "SKILL.md"), "utf8");
-    const play = parsePlayMarkdown(skill);
-
-    expect(play.meta).toMatchObject({ name: "ticket_triage", kind: "play" });
-    expect(play.requiredSkills).toContain("knowledge_base.search");
-    expect(play.subAgents.map((agent) => agent.role)).toContain("support_triager");
-  });
-});

package/src/index.ts

@@ -1,271 +0,0 @@
-import { mkdir } from "node:fs/promises";
-import { dirname, join } from "node:path";
-import { requireCapabilityTenant } from "@nebutra/capability-kit";
-import { appendCapabilityDebug, readCapabilityDebug } from "@nebutra/capability-kit/debug";
-import { ContentStore } from "@nebutra/content-store";
-import { CapabilityError } from "@nebutra/errors";
-import { EventLog } from "@nebutra/event-log";
-import { assetId } from "@nebutra/generation-context";
-
-export type TicketCategory = "billing" | "bug" | "how_to" | "sales" | "other";
-export type TicketSentiment = "neutral" | "angry" | "positive";
-export type SupportAction = "auto-answer" | "suggest-answer" | "escalate";
-
-export interface SupportTicket {
-  readonly id: string;
-  readonly tenantId?: string;
-  readonly customer: {
-    readonly id: string;
-    readonly email: string;
-    readonly plan?: string;
-  };
-  readonly subject: string;
-  readonly body: string;
-}
-
-export interface KnowledgeArticle {
-  readonly id: string;
-  readonly title: string;
-  readonly body: string;
-}
-
-export interface TicketClassification {
-  readonly category: TicketCategory;
-  readonly sentiment: TicketSentiment;
-  readonly highValue: boolean;
-  readonly complaint: boolean;
-}
-
-export interface SupportPolicy {
-  readonly autoReplyThreshold: number;
-  readonly escalateOnComplaint?: boolean;
-  readonly escalateOnHighValueCustomer?: boolean;
-}
-
-export interface SupportReply {
-  readonly subject: string;
-  readonly body: string;
-  readonly citations: readonly string[];
-}
-
-export interface SupportDecision {
-  readonly play: "ticket_triage";
-  readonly action: SupportAction;
-  readonly confidence: number;
-  readonly classification: TicketClassification;
-  readonly reply?: SupportReply;
-  readonly escalationSummary?: string;
-  readonly eventId?: string;
-}
-
-export interface HandleTicketInput {
-  readonly ticket: SupportTicket;
-  readonly articles: readonly KnowledgeArticle[];
-  readonly policy: SupportPolicy;
-}
-
-export interface SupportDoctorReport {
-  readonly capability: "support-deflector";
-  readonly ok: boolean;
-  readonly checkedAt: string;
-  readonly plays: readonly string[];
-  readonly mode: "confidence-gated";
-  readonly channels: readonly { readonly provider: string; readonly ok: boolean }[];
-}
-
-export interface SupportDeflectorOptions {
-  readonly tenantId?: string;
-  readonly root?: string;
-  readonly debugRoot?: string;
-  readonly contentStore?: ContentStore;
-  readonly eventLog?: EventLog;
-}
-
-function includesAny(text: string, terms: readonly string[]): boolean {
-  return terms.some((term) => text.includes(term));
-}
-
-export function classifyTicket(ticket: SupportTicket): TicketClassification {
-  const text = `${ticket.subject} ${ticket.body}`.toLowerCase();
-  const category: TicketCategory = includesAny(text, ["bug", "broke", "error", "production"])
-    ? "bug"
-    : includesAny(text, ["refund", "invoice", "billing", "cancel"])
-      ? "billing"
-      : includesAny(text, ["how", "setup", "configure"])
-        ? "how_to"
-        : includesAny(text, ["pricing", "demo", "sales"])
-          ? "sales"
-          : "other";
-  const angry = includesAny(text, ["angry", "furious", "broken", "terrible", "lawsuit"]);
-  const positive = includesAny(text, ["thanks", "great", "love"]);
-  const highValue = ticket.customer.plan === "enterprise" || includesAny(text, ["enterprise"]);
-  return {
-    category,
-    sentiment: angry ? "angry" : positive ? "positive" : "neutral",
-    highValue,
-    complaint: angry || includesAny(text, ["complaint", "refund now", "unacceptable"]),
-  };
-}
-
-function matchArticle(
-  ticket: SupportTicket,
-  articles: readonly KnowledgeArticle[],
-): KnowledgeArticle | undefined {
-  const text = `${ticket.subject} ${ticket.body}`.toLowerCase();
-  return (
-    articles.find((article) =>
-      article.title
-        .toLowerCase()
-        .split(/\s+/)
-        .filter((term) => term.length > 3)
-        .some((term) => text.includes(term)),
-    ) ??
-    articles.find((article) =>
-      article.body
-        .toLowerCase()
-        .split(/\W+/)
-        .filter((term) => term.length > 6)
-        .some((term) => text.includes(term)),
-    )
-  );
-}
-
-function synthesizeReply(ticket: SupportTicket, article: KnowledgeArticle): SupportReply {
-  const firstSentence = article.body.split(".")[0]?.trim() ?? article.body;
-  return {
-    subject: `Re: ${ticket.subject}`,
-    body: `${firstSentence}. If you want, reply here and we will help with the next step.`,
-    citations: [article.id],
-  };
-}
-
-export function decideTicket(
-  ticket: SupportTicket,
-  articles: readonly KnowledgeArticle[],
-  policy: SupportPolicy,
-): SupportDecision {
-  const classification = classifyTicket(ticket);
-  const article = matchArticle(ticket, articles);
-  const confidence = article ? (classification.category === "other" ? 0.72 : 0.9) : 0.35;
-  const shouldEscalate =
-    (policy.escalateOnComplaint ?? true) && classification.complaint
-      ? true
-      : (policy.escalateOnHighValueCustomer ?? true) && classification.highValue;
-  if (shouldEscalate) {
-    return {
-      play: "ticket_triage",
-      action: "escalate",
-      confidence,
-      classification,
-      ...(article ? { reply: synthesizeReply(ticket, article) } : {}),
-      escalationSummary: `${ticket.customer.email} needs founder attention for ${classification.category}.`,
-    };
-  }
-  if (article && confidence >= policy.autoReplyThreshold) {
-    return {
-      play: "ticket_triage",
-      action: "auto-answer",
-      confidence,
-      classification,
-      reply: synthesizeReply(ticket, article),
-    };
-  }
-  return {
-    play: "ticket_triage",
-    action: "suggest-answer",
-    confidence,
-    classification,
-    ...(article ? { reply: synthesizeReply(ticket, article) } : {}),
-  };
-}
-
-export class SupportDeflector {
-  readonly #tenantId: string | undefined;
-  readonly #debugRoot: string;
-  readonly #contentStore: ContentStore;
-  readonly #eventLog: EventLog;
-
-  private constructor(
-    options: SupportDeflectorOptions & { contentStore: ContentStore; eventLog: EventLog },
-  ) {
-    this.#tenantId = options.tenantId;
-    this.#debugRoot = options.debugRoot ?? process.cwd();
-    this.#contentStore = options.contentStore;
-    this.#eventLog = options.eventLog;
-  }
-
-  static async open(
-    root = ".nebutra/support-deflector",
-    options: Omit<SupportDeflectorOptions, "root" | "contentStore" | "eventLog"> = {},
-  ): Promise<SupportDeflector> {
-    const tenantId = options.tenantId ?? "local";
-    await mkdir(root, { recursive: true });
-    const contentStore = await ContentStore.open(join(root, "content"), { tenantId });
-    const eventLog = await EventLog.open(join(root, "event-log"), { tenantId });
-    return new SupportDeflector({ ...options, tenantId, root, contentStore, eventLog });
-  }
-
-  async handleTicket(input: HandleTicketInput): Promise<SupportDecision> {
-    const tenantId = requireCapabilityTenant({
-      explicit: input.ticket.tenantId,
-      fallback: this.#tenantId,
-      onMissing: () =>
-        new CapabilityError("support-deflector", "Support Deflector requires tenant context", {
-          suggestion: "Pass tenantId with the ticket or construct SupportDeflector with tenantId.",
-          statusCode: 400,
-        }),
-    });
-    const decision = decideTicket(input.ticket, input.articles, input.policy);
-    const artifactPath = `support/tickets/${input.ticket.id}.json`;
-    const content = `${JSON.stringify({ ticket: input.ticket, decision }, null, 2)}\n`;
-    await this.#contentStore.write(artifactPath, content);
-    const eventId = await this.#eventLog.commit({
-      traceId: assetId("support_ticket", input.ticket.id),
-      kind: "content_write",
-      affected: [artifactPath],
-      parent: null,
-      snapshot: { [artifactPath]: content },
-    });
-    await this.#debug({
-      type: "ticket_decision",
-      tenantId,
-      ticketId: input.ticket.id,
-      action: decision.action,
-      eventId,
-    });
-    return { ...decision, eventId };
-  }
-
-  async doctor(): Promise<SupportDoctorReport> {
-    return {
-      capability: "support-deflector",
-      ok: true,
-      checkedAt: new Date().toISOString(),
-      plays: ["ticket_triage"],
-      mode: "confidence-gated",
-      channels: [
-        { provider: "local-ticket", ok: true },
-        { provider: "chatwoot-bridge", ok: false },
-        { provider: "email-bridge", ok: false },
-      ],
-    };
-  }
-
-  async close(): Promise<void> {
-    await this.#contentStore.close();
-  }
-
-  async #debug(entry: Record<string, unknown>): Promise<void> {
-    await mkdir(dirname(join(this.#debugRoot, ".nebutra", "debug", "support-deflector.jsonl")), {
-      recursive: true,
-    });
-    await appendCapabilityDebug("support-deflector", entry, { root: this.#debugRoot });
-  }
-}
-
-export async function readSupportDeflectorDebug(
-  root = process.cwd(),
-  limit = 20,
-): Promise<unknown[]> {
-  return readCapabilityDebug("support-deflector", { root, limit });
-}

package/tsconfig.json

@@ -1,9 +0,0 @@
-{
-  "extends": "../../../tsconfig.base.json",
-  "compilerOptions": {
-    "outDir": "dist",
-    "rootDir": ".",
-    "types": ["node", "vitest"]
-  },
-  "include": ["src/**/*.ts", "examples/**/*.ts"]
-}

package/tsup.config.ts

@@ -1,11 +0,0 @@
-import { defineConfig } from "tsup";
-
-export default defineConfig({
-  entry: ["src/index.ts", "src/cli.ts"],
-  format: ["esm"],
-  sourcemap: true,
-  dts: true,
-  clean: true,
-  target: "es2022",
-  external: [/^@nebutra\//],
-});