@contractspec/example.ai-support-bot 1.44.0

package/.turbo/turbo-build$colon$bundle.log

@@ -0,0 +1,25 @@
+$ tsdown
+ℹ tsdown v0.18.3 powered by rolldown v1.0.0-beta.57
+ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/ai-support-bot/tsdown.config.js 
+ℹ entry: src/example.ts, src/index.ts, src/setup.ts, src/docs/ai-support-bot.docblock.ts, src/docs/index.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ Cleaning 16 files
+ℹ dist/setup.js                             1.53 kB │ gzip: 0.75 kB
+ℹ dist/docs/ai-support-bot.docblock.js      1.35 kB │ gzip: 0.66 kB
+ℹ dist/example.js                           0.81 kB │ gzip: 0.44 kB
+ℹ dist/index.js                             0.19 kB │ gzip: 0.12 kB
+ℹ dist/docs/index.js                        0.04 kB │ gzip: 0.06 kB
+ℹ dist/setup.js.map                         2.70 kB │ gzip: 1.18 kB
+ℹ dist/docs/ai-support-bot.docblock.js.map  1.84 kB │ gzip: 0.85 kB
+ℹ dist/example.js.map                       1.17 kB │ gzip: 0.60 kB
+ℹ dist/example.d.ts.map                     0.14 kB │ gzip: 0.13 kB
+ℹ dist/setup.d.ts.map                       0.13 kB │ gzip: 0.13 kB
+ℹ dist/example.d.ts                         1.05 kB │ gzip: 0.44 kB
+ℹ dist/setup.d.ts                           0.17 kB │ gzip: 0.14 kB
+ℹ dist/index.d.ts                           0.13 kB │ gzip: 0.09 kB
+ℹ dist/docs/ai-support-bot.docblock.d.ts    0.01 kB │ gzip: 0.03 kB
+ℹ dist/docs/index.d.ts                      0.01 kB │ gzip: 0.03 kB
+ℹ 15 files, total: 11.29 kB
+✔ Build complete in 15638ms

package/.turbo/turbo-build.log

@@ -0,0 +1,26 @@
+$ bun build:types && bun build:bundle
+$ tsc --noEmit
+$ tsdown
+ℹ tsdown v0.18.3 powered by rolldown v1.0.0-beta.57
+ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/ai-support-bot/tsdown.config.js 
+ℹ entry: src/example.ts, src/index.ts, src/setup.ts, src/docs/ai-support-bot.docblock.ts, src/docs/index.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ dist/setup.js                             1.53 kB │ gzip: 0.75 kB
+ℹ dist/docs/ai-support-bot.docblock.js      1.35 kB │ gzip: 0.66 kB
+ℹ dist/example.js                           0.81 kB │ gzip: 0.44 kB
+ℹ dist/index.js                             0.19 kB │ gzip: 0.12 kB
+ℹ dist/docs/index.js                        0.04 kB │ gzip: 0.06 kB
+ℹ dist/setup.js.map                         2.70 kB │ gzip: 1.18 kB
+ℹ dist/docs/ai-support-bot.docblock.js.map  1.84 kB │ gzip: 0.85 kB
+ℹ dist/example.js.map                       1.17 kB │ gzip: 0.60 kB
+ℹ dist/example.d.ts.map                     0.14 kB │ gzip: 0.13 kB
+ℹ dist/setup.d.ts.map                       0.13 kB │ gzip: 0.13 kB
+ℹ dist/example.d.ts                         1.05 kB │ gzip: 0.44 kB
+ℹ dist/setup.d.ts                           0.17 kB │ gzip: 0.14 kB
+ℹ dist/index.d.ts                           0.13 kB │ gzip: 0.09 kB
+ℹ dist/docs/ai-support-bot.docblock.d.ts    0.01 kB │ gzip: 0.03 kB
+ℹ dist/docs/index.d.ts                      0.01 kB │ gzip: 0.03 kB
+ℹ 15 files, total: 11.29 kB
+✔ Build complete in 18164ms

package/CHANGELOG.md

@@ -0,0 +1,211 @@
+# @contractspec/example.ai-support-bot
+
+## 1.44.0
+
+### Minor Changes
+
+- 5f3a868: chore: isolate branding to contractspec.io
+
+### Patch Changes
+
+- Updated dependencies [5f3a868]
+  - @contractspec/lib.support-bot@1.44.0
+  - @contractspec/lib.contracts@1.44.0
+  - @contractspec/lib.knowledge@1.44.0
+  - @contractspec/lib.logger@1.44.0
+  - @contractspec/lib.schema@1.44.0
+
+## 1.43.4
+
+### Patch Changes
+
+- 9216062: fix: cross-platform compatibility
+- Updated dependencies [9216062]
+  - @contractspec/lib.support-bot@1.43.4
+  - @contractspec/lib.contracts@1.43.4
+  - @contractspec/lib.knowledge@1.43.4
+  - @contractspec/lib.logger@1.43.3
+  - @contractspec/lib.schema@1.43.3
+
+## 1.43.3
+
+### Patch Changes
+
+- 24d9759: improve documentation
+- Updated dependencies [24d9759]
+  - @contractspec/lib.support-bot@1.43.3
+  - @contractspec/lib.contracts@1.43.3
+  - @contractspec/lib.knowledge@1.43.3
+  - @contractspec/lib.logger@1.43.2
+  - @contractspec/lib.schema@1.43.2
+
+## 1.43.2
+
+### Patch Changes
+
+- e147271: fix: improve stability
+- Updated dependencies [e147271]
+  - @contractspec/lib.support-bot@1.43.2
+  - @contractspec/lib.contracts@1.43.2
+  - @contractspec/lib.knowledge@1.43.2
+  - @contractspec/lib.logger@1.43.1
+  - @contractspec/lib.schema@1.43.1
+
+## 1.43.1
+
+### Patch Changes
+
+- Updated dependencies [f28fdad]
+  - @contractspec/lib.contracts@1.43.1
+  - @contractspec/lib.knowledge@1.43.1
+  - @contractspec/lib.support-bot@1.43.1
+
+## 1.43.0
+
+### Minor Changes
+
+- 042d072: feat: schema declaration using json schema, including zod
+
+### Patch Changes
+
+- Updated dependencies [042d072]
+  - @contractspec/lib.support-bot@1.43.0
+  - @contractspec/lib.contracts@1.43.0
+  - @contractspec/lib.knowledge@1.43.0
+  - @contractspec/lib.logger@1.43.0
+  - @contractspec/lib.schema@1.43.0
+
+## 1.42.10
+
+### Patch Changes
+
+- 1e6a0f1: fix: mcp server
+- Updated dependencies [1e6a0f1]
+  - @contractspec/lib.support-bot@1.42.10
+  - @contractspec/lib.contracts@1.42.10
+  - @contractspec/lib.knowledge@1.42.10
+  - @contractspec/lib.logger@1.42.10
+  - @contractspec/lib.schema@1.42.10
+
+## 1.42.9
+
+### Patch Changes
+
+- 9281db7: fix ModelRegistry
+- Updated dependencies [9281db7]
+  - @contractspec/lib.support-bot@1.42.9
+  - @contractspec/lib.contracts@1.42.9
+  - @contractspec/lib.knowledge@1.42.9
+  - @contractspec/lib.logger@1.42.9
+  - @contractspec/lib.schema@1.42.9
+
+## 1.42.8
+
+### Patch Changes
+
+- e07b5ac: fix
+- Updated dependencies [e07b5ac]
+  - @contractspec/lib.support-bot@1.42.8
+  - @contractspec/lib.contracts@1.42.8
+  - @contractspec/lib.knowledge@1.42.8
+  - @contractspec/lib.logger@1.42.8
+  - @contractspec/lib.schema@1.42.8
+
+## 1.42.7
+
+### Patch Changes
+
+- e9b575d: fix release
+- Updated dependencies [e9b575d]
+  - @contractspec/lib.support-bot@1.42.7
+  - @contractspec/lib.contracts@1.42.7
+  - @contractspec/lib.knowledge@1.42.7
+  - @contractspec/lib.logger@1.42.7
+  - @contractspec/lib.schema@1.42.7
+
+## 1.42.6
+
+### Patch Changes
+
+- 1500242: fix tooling
+- Updated dependencies [1500242]
+  - @contractspec/lib.support-bot@1.42.6
+  - @contractspec/lib.contracts@1.42.6
+  - @contractspec/lib.knowledge@1.42.6
+  - @contractspec/lib.logger@1.42.6
+  - @contractspec/lib.schema@1.42.6
+
+## 1.42.5
+
+### Patch Changes
+
+- 1299719: fix vscode
+- Updated dependencies [1299719]
+  - @contractspec/lib.support-bot@1.42.5
+  - @contractspec/lib.contracts@1.42.5
+  - @contractspec/lib.knowledge@1.42.5
+  - @contractspec/lib.logger@1.42.5
+  - @contractspec/lib.schema@1.42.5
+
+## 1.42.4
+
+### Patch Changes
+
+- ac28b99: fix: generate from openapi
+- Updated dependencies [ac28b99]
+  - @contractspec/lib.support-bot@1.42.4
+  - @contractspec/lib.contracts@1.42.4
+  - @contractspec/lib.knowledge@1.42.4
+  - @contractspec/lib.logger@1.42.4
+  - @contractspec/lib.schema@1.42.4
+
+## 1.42.3
+
+### Patch Changes
+
+- 3f5d015: fix(tooling): cicd
+- Updated dependencies [3f5d015]
+  - @contractspec/lib.contracts@1.42.3
+  - @contractspec/lib.knowledge@1.42.3
+  - @contractspec/lib.logger@1.42.3
+  - @contractspec/lib.schema@1.42.3
+  - @contractspec/lib.support-bot@1.42.3
+
+## 1.42.2
+
+### Patch Changes
+
+- 1f9ac4c: fix
+- Updated dependencies [1f9ac4c]
+  - @contractspec/lib.contracts@1.42.2
+  - @contractspec/lib.knowledge@1.42.2
+  - @contractspec/lib.logger@1.42.2
+  - @contractspec/lib.schema@1.42.2
+  - @contractspec/lib.support-bot@1.42.2
+
+## 1.42.1
+
+### Patch Changes
+
+- f043995: Fix release
+- Updated dependencies [f043995]
+  - @contractspec/lib.support-bot@1.42.1
+  - @contractspec/lib.contracts@1.42.1
+  - @contractspec/lib.knowledge@1.42.1
+  - @contractspec/lib.logger@1.42.1
+  - @contractspec/lib.schema@1.42.1
+
+## 1.42.0
+
+### Minor Changes
+
+- 8eefd9c: initial release
+
+### Patch Changes
+
+- Updated dependencies [8eefd9c]
+  - @contractspec/lib.contracts@1.42.0
+  - @contractspec/lib.knowledge@1.42.0
+  - @contractspec/lib.logger@1.42.0
+  - @contractspec/lib.schema@1.42.0
+  - @contractspec/lib.support-bot@1.42.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+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,12 @@
+# AI Support Bot Example
+
+Website: https://contractspec.io/
+
+
+Minimal wiring that shows how `@contractspec/lib.ai-agent` works together with `@contractspec/lib.support-bot`.
+
+## What it demonstrates
+
+- Create a SupportBot spec with confidence-based escalation.
+- Register ticket classification / resolver / auto-responder tools.
+- Run a mock ticket through the `AgentRunner` and inspect the draft reply.

package/dist/docs/ai-support-bot.docblock.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/ai-support-bot.docblock.js

@@ -0,0 +1,29 @@
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+
+//#region src/docs/ai-support-bot.docblock.ts
+registerDocBlocks([{
+	id: "docs.examples.ai-support-bot",
+	title: "AI Support Bot (example)",
+	summary: "Ticket classification + knowledge-grounded resolution + response drafting.",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/examples/ai-support-bot",
+	tags: [
+		"support",
+		"ai",
+		"example"
+	],
+	body: `## What this example shows\n- Classify a ticket into a support category.\n- Use a knowledge port to generate a grounded resolution.\n- Draft a response (email body) from the resolution.\n\n## Guardrails\n- Avoid logging raw ticket bodies/PII; prefer structured summaries.\n- Keep knowledge and ticket adapters explicit and testable.`
+}, {
+	id: "docs.examples.ai-support-bot.usage",
+	title: "AI Support Bot — Usage",
+	summary: "How to run the example and swap the knowledge adapter.",
+	kind: "usage",
+	visibility: "public",
+	route: "/docs/examples/ai-support-bot/usage",
+	tags: ["support", "usage"],
+	body: `## Usage\n- Call \`runAiSupportBotExample()\`.\n- Replace the \`knowledge.query\` implementation with a real knowledge service.\n\n## Notes\n- Keep outputs structured.\n- Use policy gates before exposing drafted replies to end-users.`
+}]);
+
+//#endregion
+//# sourceMappingURL=ai-support-bot.docblock.js.map

package/dist/docs/ai-support-bot.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-support-bot.docblock.js","names":[],"sources":["../../src/docs/ai-support-bot.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nconst blocks: DocBlock[] = [\n  {\n    id: 'docs.examples.ai-support-bot',\n    title: 'AI Support Bot (example)',\n    summary:\n      'Ticket classification + knowledge-grounded resolution + response drafting.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/examples/ai-support-bot',\n    tags: ['support', 'ai', 'example'],\n    body: `## What this example shows\\n- Classify a ticket into a support category.\\n- Use a knowledge port to generate a grounded resolution.\\n- Draft a response (email body) from the resolution.\\n\\n## Guardrails\\n- Avoid logging raw ticket bodies/PII; prefer structured summaries.\\n- Keep knowledge and ticket adapters explicit and testable.`,\n  },\n  {\n    id: 'docs.examples.ai-support-bot.usage',\n    title: 'AI Support Bot — Usage',\n    summary: 'How to run the example and swap the knowledge adapter.',\n    kind: 'usage',\n    visibility: 'public',\n    route: '/docs/examples/ai-support-bot/usage',\n    tags: ['support', 'usage'],\n    body: `## Usage\\n- Call \\`runAiSupportBotExample()\\`.\\n- Replace the \\`knowledge.query\\` implementation with a real knowledge service.\\n\\n## Notes\\n- Keep outputs structured.\\n- Use policy gates before exposing drafted replies to end-users.`,\n  },\n];\n\nregisterDocBlocks(blocks);\n"],"mappings":";;;AA2BA,kBAxB2B,CACzB;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAW;EAAM;EAAU;CAClC,MAAM;CACP,EACD;CACE,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM,CAAC,WAAW,QAAQ;CAC1B,MAAM;CACP,CACF,CAEwB"}

package/dist/docs/index.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/index.js

@@ -0,0 +1 @@
+import "./ai-support-bot.docblock.js";

package/dist/example.d.ts

@@ -0,0 +1,34 @@
+//#region src/example.d.ts
+declare const example: {
+  readonly id: "ai-support-bot";
+  readonly title: "AI Support Bot";
+  readonly summary: "Classify and resolve a support ticket (with a drafted response) using the support-bot and knowledge libraries.";
+  readonly tags: readonly ["support", "ai", "tickets", "knowledge"];
+  readonly kind: "script";
+  readonly visibility: "public";
+  readonly docs: {
+    readonly rootDocId: "docs.examples.ai-support-bot";
+    readonly usageDocId: "docs.examples.ai-support-bot.usage";
+  };
+  readonly entrypoints: {
+    readonly packageName: "@contractspec/example.ai-support-bot";
+    readonly docs: "./docs";
+  };
+  readonly surfaces: {
+    readonly templates: true;
+    readonly sandbox: {
+      readonly enabled: true;
+      readonly modes: readonly ["markdown"];
+    };
+    readonly studio: {
+      readonly enabled: true;
+      readonly installable: true;
+    };
+    readonly mcp: {
+      readonly enabled: true;
+    };
+  };
+};
+//#endregion
+export { example as default };
+//# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"sourcesContent":[],"mappings":";cAAM;EAAA,SAAA,EAsBI,EAAA,gBAAA"}

package/dist/example.js

@@ -0,0 +1,39 @@
+//#region src/example.ts
+const example = {
+	id: "ai-support-bot",
+	title: "AI Support Bot",
+	summary: "Classify and resolve a support ticket (with a drafted response) using the support-bot and knowledge libraries.",
+	tags: [
+		"support",
+		"ai",
+		"tickets",
+		"knowledge"
+	],
+	kind: "script",
+	visibility: "public",
+	docs: {
+		rootDocId: "docs.examples.ai-support-bot",
+		usageDocId: "docs.examples.ai-support-bot.usage"
+	},
+	entrypoints: {
+		packageName: "@contractspec/example.ai-support-bot",
+		docs: "./docs"
+	},
+	surfaces: {
+		templates: true,
+		sandbox: {
+			enabled: true,
+			modes: ["markdown"]
+		},
+		studio: {
+			enabled: true,
+			installable: true
+		},
+		mcp: { enabled: true }
+	}
+};
+var example_default = example;
+
+//#endregion
+export { example_default as default };
+//# sourceMappingURL=example.js.map

package/dist/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["const example = {\n  id: 'ai-support-bot',\n  title: 'AI Support Bot',\n  summary:\n    'Classify and resolve a support ticket (with a drafted response) using the support-bot and knowledge libraries.',\n  tags: ['support', 'ai', 'tickets', 'knowledge'],\n  kind: 'script',\n  visibility: 'public',\n  docs: {\n    rootDocId: 'docs.examples.ai-support-bot',\n    usageDocId: 'docs.examples.ai-support-bot.usage',\n  },\n  entrypoints: {\n    packageName: '@contractspec/example.ai-support-bot',\n    docs: './docs',\n  },\n  surfaces: {\n    templates: true,\n    sandbox: { enabled: true, modes: ['markdown'] },\n    studio: { enabled: true, installable: true },\n    mcp: { enabled: true },\n  },\n} as const;\n\nexport default example;\n"],"mappings":";AAAA,MAAM,UAAU;CACd,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;EAAC;EAAW;EAAM;EAAW;EAAY;CAC/C,MAAM;CACN,YAAY;CACZ,MAAM;EACJ,WAAW;EACX,YAAY;EACb;CACD,aAAa;EACX,aAAa;EACb,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GAAE,SAAS;GAAM,OAAO,CAAC,WAAW;GAAE;EAC/C,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF;AAED,sBAAe"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import example from "./example.js";
+import { runAiSupportBotExample } from "./setup.js";
+export { example, runAiSupportBotExample };

package/dist/index.js

@@ -0,0 +1,5 @@
+import example_default from "./example.js";
+import { runAiSupportBotExample } from "./setup.js";
+import "./docs/index.js";
+
+export { example_default as example, runAiSupportBotExample };

package/dist/setup.d.ts

@@ -0,0 +1,5 @@
+//#region src/setup.d.ts
+declare function runAiSupportBotExample(): Promise<void>;
+//#endregion
+export { runAiSupportBotExample };
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","names":[],"sources":["../src/setup.ts"],"sourcesContent":[],"mappings":";iBAesB,sBAAA,CAAA,GAA0B"}

package/dist/setup.js

@@ -0,0 +1,45 @@
+import { TicketResolver } from "@contractspec/lib.support-bot/rag";
+import { TicketClassifier } from "@contractspec/lib.support-bot/tickets";
+import { AutoResponder } from "@contractspec/lib.support-bot/bot";
+import { LogLevel, Logger } from "@contractspec/lib.logger";
+
+//#region src/setup.ts
+const logger = new Logger({
+	level: process.env.NODE_ENV === "production" ? LogLevel.INFO : LogLevel.DEBUG,
+	environment: process.env.NODE_ENV || "development",
+	enableColors: process.env.NODE_ENV !== "production"
+});
+async function runAiSupportBotExample() {
+	const resolver = new TicketResolver({ knowledge: { async query(question) {
+		return {
+			answer: `The payout will retrigger automatically. (${question.slice(0, 40)}…)`,
+			references: []
+		};
+	} } });
+	const classifier = new TicketClassifier();
+	const responder = new AutoResponder();
+	const ticket = {
+		id: "TIC-42",
+		subject: "Payout failed",
+		body: "Hello, our supplier payout failed twice yesterday. Can you confirm status? It is urgent.",
+		channel: "email",
+		customerName: "Ivy",
+		metadata: { accountId: "acct_789" }
+	};
+	const classification = await classifier.classify(ticket);
+	const resolution = await resolver.resolve(ticket);
+	const draft = await responder.draft(ticket, resolution, classification);
+	logger.info("Support bot run completed", {
+		ticketId: ticket.id,
+		classification,
+		resolution,
+		emailDraft: {
+			subject: draft.subject,
+			body: draft.body
+		}
+	});
+}
+
+//#endregion
+export { runAiSupportBotExample };
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","names":["ticket: SupportTicket"],"sources":["../src/setup.ts"],"sourcesContent":["import { TicketResolver } from '@contractspec/lib.support-bot/rag';\nimport { TicketClassifier } from '@contractspec/lib.support-bot/tickets';\nimport { AutoResponder } from '@contractspec/lib.support-bot/bot';\nimport type { KnowledgeAnswer } from '@contractspec/lib.knowledge/query/service';\nimport type { SupportTicket } from '@contractspec/lib.support-bot/types';\nimport { Logger, LogLevel } from '@contractspec/lib.logger';\nimport type { LoggerConfig } from '@contractspec/lib.logger/types';\n\nconst logger = new Logger({\n  level: process.env.NODE_ENV === 'production' ? LogLevel.INFO : LogLevel.DEBUG,\n  environment:\n    (process.env.NODE_ENV as LoggerConfig['environment']) || 'development',\n  enableColors: process.env.NODE_ENV !== 'production',\n});\n\nexport async function runAiSupportBotExample(): Promise<void> {\n  const knowledge = {\n    async query(question: string): Promise<KnowledgeAnswer> {\n      return {\n        answer: `The payout will retrigger automatically. (${question.slice(0, 40)}…)`,\n        references: [],\n      };\n    },\n  };\n\n  const resolver = new TicketResolver({ knowledge });\n  const classifier = new TicketClassifier();\n  const responder = new AutoResponder();\n\n  const ticket: SupportTicket = {\n    id: 'TIC-42',\n    subject: 'Payout failed',\n    body: 'Hello, our supplier payout failed twice yesterday. Can you confirm status? It is urgent.',\n    channel: 'email',\n    customerName: 'Ivy',\n    metadata: { accountId: 'acct_789' },\n  };\n\n  const classification = await classifier.classify(ticket);\n  const resolution = await resolver.resolve(ticket);\n  const draft = await responder.draft(ticket, resolution, classification);\n\n  logger.info('Support bot run completed', {\n    ticketId: ticket.id,\n    classification,\n    resolution,\n    emailDraft: { subject: draft.subject, body: draft.body },\n  });\n}\n"],"mappings":";;;;;;AAQA,MAAM,SAAS,IAAI,OAAO;CACxB,OAAO,QAAQ,IAAI,aAAa,eAAe,SAAS,OAAO,SAAS;CACxE,aACG,QAAQ,IAAI,YAA4C;CAC3D,cAAc,QAAQ,IAAI,aAAa;CACxC,CAAC;AAEF,eAAsB,yBAAwC;CAU5D,MAAM,WAAW,IAAI,eAAe,EAAE,WATpB,EAChB,MAAM,MAAM,UAA4C;AACtD,SAAO;GACL,QAAQ,6CAA6C,SAAS,MAAM,GAAG,GAAG,CAAC;GAC3E,YAAY,EAAE;GACf;IAEJ,EAEgD,CAAC;CAClD,MAAM,aAAa,IAAI,kBAAkB;CACzC,MAAM,YAAY,IAAI,eAAe;CAErC,MAAMA,SAAwB;EAC5B,IAAI;EACJ,SAAS;EACT,MAAM;EACN,SAAS;EACT,cAAc;EACd,UAAU,EAAE,WAAW,YAAY;EACpC;CAED,MAAM,iBAAiB,MAAM,WAAW,SAAS,OAAO;CACxD,MAAM,aAAa,MAAM,SAAS,QAAQ,OAAO;CACjD,MAAM,QAAQ,MAAM,UAAU,MAAM,QAAQ,YAAY,eAAe;AAEvE,QAAO,KAAK,6BAA6B;EACvC,UAAU,OAAO;EACjB;EACA;EACA,YAAY;GAAE,SAAS,MAAM;GAAS,MAAM,MAAM;GAAM;EACzD,CAAC"}

package/example.ts

@@ -0,0 +1 @@
+export { default } from './src/example';

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@contractspec/example.ai-support-bot",
+  "version": "1.44.0",
+  "description": "AI support bot example: classify and resolve a support ticket using @contractspec/lib.support-bot.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./docs": "./dist/docs/index.js",
+    "./docs/ai-support-bot.docblock": "./dist/docs/ai-support-bot.docblock.js",
+    "./example": "./dist/example.js",
+    "./setup": "./dist/setup.js",
+    "./*": "./*"
+  },
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:types && bun build:bundle",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit",
+    "dev": "bun build:bundle --watch",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@contractspec/lib.support-bot": "1.44.0",
+    "@contractspec/lib.knowledge": "1.44.0",
+    "@contractspec/lib.schema": "1.44.0",
+    "@contractspec/lib.contracts": "1.44.0",
+    "@contractspec/lib.logger": "1.44.0"
+  },
+  "devDependencies": {
+    "@contractspec/tool.tsdown": "1.44.0",
+    "@contractspec/tool.typescript": "1.44.0",
+    "tsdown": "^0.18.3",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": "./dist/index.js",
+      "./docs": "./dist/docs/index.js",
+      "./docs/ai-support-bot.docblock": "./dist/docs/ai-support-bot.docblock.js",
+      "./example": "./dist/example.js",
+      "./setup": "./dist/setup.js",
+      "./*": "./*"
+    },
+    "registry": "https://registry.npmjs.org/"
+  },
+  "module": "./dist/index.js",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/examples/ai-support-bot"
+  },
+  "homepage": "https://contractspec.io"
+}

package/setup.ts

@@ -0,0 +1,8 @@
+import { runAiSupportBotExample } from './src/setup';
+
+void runAiSupportBotExample().catch((error) => {
+  // Keep console usage limited to this demo entrypoint only.
+  // eslint-disable-next-line no-console
+  console.error(error);
+  process.exitCode = 1;
+});

package/src/docs/ai-support-bot.docblock.ts

@@ -0,0 +1,28 @@
+import type { DocBlock } from '@contractspec/lib.contracts/docs';
+import { registerDocBlocks } from '@contractspec/lib.contracts/docs';
+
+const blocks: DocBlock[] = [
+  {
+    id: 'docs.examples.ai-support-bot',
+    title: 'AI Support Bot (example)',
+    summary:
+      'Ticket classification + knowledge-grounded resolution + response drafting.',
+    kind: 'reference',
+    visibility: 'public',
+    route: '/docs/examples/ai-support-bot',
+    tags: ['support', 'ai', 'example'],
+    body: `## What this example shows\n- Classify a ticket into a support category.\n- Use a knowledge port to generate a grounded resolution.\n- Draft a response (email body) from the resolution.\n\n## Guardrails\n- Avoid logging raw ticket bodies/PII; prefer structured summaries.\n- Keep knowledge and ticket adapters explicit and testable.`,
+  },
+  {
+    id: 'docs.examples.ai-support-bot.usage',
+    title: 'AI Support Bot — Usage',
+    summary: 'How to run the example and swap the knowledge adapter.',
+    kind: 'usage',
+    visibility: 'public',
+    route: '/docs/examples/ai-support-bot/usage',
+    tags: ['support', 'usage'],
+    body: `## Usage\n- Call \`runAiSupportBotExample()\`.\n- Replace the \`knowledge.query\` implementation with a real knowledge service.\n\n## Notes\n- Keep outputs structured.\n- Use policy gates before exposing drafted replies to end-users.`,
+  },
+];
+
+registerDocBlocks(blocks);

package/src/docs/index.ts

@@ -0,0 +1 @@
+import './ai-support-bot.docblock';

package/src/example.ts

@@ -0,0 +1,25 @@
+const example = {
+  id: 'ai-support-bot',
+  title: 'AI Support Bot',
+  summary:
+    'Classify and resolve a support ticket (with a drafted response) using the support-bot and knowledge libraries.',
+  tags: ['support', 'ai', 'tickets', 'knowledge'],
+  kind: 'script',
+  visibility: 'public',
+  docs: {
+    rootDocId: 'docs.examples.ai-support-bot',
+    usageDocId: 'docs.examples.ai-support-bot.usage',
+  },
+  entrypoints: {
+    packageName: '@contractspec/example.ai-support-bot',
+    docs: './docs',
+  },
+  surfaces: {
+    templates: true,
+    sandbox: { enabled: true, modes: ['markdown'] },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true },
+  },
+} as const;
+
+export default example;

package/src/index.ts

@@ -0,0 +1,3 @@
+export * from './setup';
+export { default as example } from './example';
+import './docs';