@contractspec/example.ai-support-bot 0.0.0-canary-20260113170453

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@contractspec/example.ai-support-bot",
+  "version": "0.0.0-canary-20260113170453",
+  "description": "AI support bot example: classify and resolve a support ticket using @contractspec/lib.support-bot.",
+  "type": "module",
+  "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": "0.0.0-canary-20260113170453",
+    "@contractspec/lib.knowledge": "0.0.0-canary-20260113170453",
+    "@contractspec/lib.contracts": "0.0.0-canary-20260113170453",
+    "@contractspec/lib.logger": "0.0.0-canary-20260113170453"
+  },
+  "devDependencies": {
+    "@contractspec/tool.tsdown": "0.0.0-canary-20260113170453",
+    "@contractspec/tool.typescript": "0.0.0-canary-20260113170453",
+    "tsdown": "^0.19.0",
+    "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/"
+  },
+  "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,32 @@
+import { defineExample } from '@contractspec/lib.contracts';
+
+const example = defineExample({
+  meta: {
+    key: 'ai-support-bot',
+    version: '1.0.0',
+    title: 'AI Support Bot',
+    description:
+      'Classify and resolve a support ticket (with a drafted response) using the support-bot and knowledge libraries.',
+    kind: 'script',
+    visibility: 'public',
+    stability: 'experimental',
+    owners: ['@platform.core'],
+    tags: ['support', 'ai', 'tickets', 'knowledge'],
+  },
+  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 },
+  },
+});
+
+export default example;

package/src/index.ts

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

package/src/setup.ts

@@ -0,0 +1,49 @@
+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 type { KnowledgeAnswer } from '@contractspec/lib.knowledge/query/service';
+import type { SupportTicket } from '@contractspec/lib.support-bot/types';
+import { Logger, LogLevel } from '@contractspec/lib.logger';
+import type { LoggerConfig } from '@contractspec/lib.logger/types';
+
+const logger = new Logger({
+  level: process.env.NODE_ENV === 'production' ? LogLevel.INFO : LogLevel.DEBUG,
+  environment:
+    (process.env.NODE_ENV as LoggerConfig['environment']) || 'development',
+  enableColors: process.env.NODE_ENV !== 'production',
+});
+
+export async function runAiSupportBotExample(): Promise<void> {
+  const knowledge = {
+    async query(question: string): Promise<KnowledgeAnswer> {
+      return {
+        answer: `The payout will retrigger automatically. (${question.slice(0, 40)}…)`,
+        references: [],
+      };
+    },
+  };
+
+  const resolver = new TicketResolver({ knowledge });
+  const classifier = new TicketClassifier();
+  const responder = new AutoResponder();
+
+  const ticket: SupportTicket = {
+    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 },
+  });
+}

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends": "@contractspec/tool.typescript/react-library.json",
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"],
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  }
+}
+
+