@contractspec/example.ai-support-bot 1.57.0 → 1.59.0

package/.turbo/turbo-build.log

@@ -1,31 +1,32 @@
-$ bun build:types && bun build:bundle
-$ tsc --noEmit
-$ tsdown
-ℹ tsdown v0.20.3 powered by rolldown v1.0.0-rc.3
-ℹ 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.96 kB │ gzip: 0.51 kB
-ℹ dist/index.js                             0.16 kB │ gzip: 0.11 kB
-ℹ dist/docs/index.js                        0.04 kB │ gzip: 0.06 kB
-ℹ dist/setup.js.map                         2.68 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.43 kB │ gzip: 0.70 kB
-ℹ dist/example.d.ts.map                     0.13 kB │ gzip: 0.13 kB
-ℹ dist/setup.d.ts.map                       0.12 kB │ gzip: 0.12 kB
-ℹ dist/example.d.ts                         0.25 kB │ gzip: 0.17 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: 10.80 kB
-[PLUGIN_TIMINGS] Warning: Your build spent significant time in plugins. Here is a breakdown:
-  - tsdown:external (62%)
-  - rolldown-plugin-dts:generate (37%)
-See https://rolldown.rs/options/checks#plugintimings for more details.
+$ contractspec-bun-build prebuild
+$ bun run prebuild && bun run build:bundle && bun run build:types
+$ contractspec-bun-build prebuild
+$ contractspec-bun-build transpile
+[contractspec-bun-build] transpile target=bun root=src entries=5
+Bundled 5 modules in 19ms
 
-✔ Build complete in 22342ms
+  docs/ai-support-bot.docblock.js  1.35 KB  (entry point)
+  ./index.js                       3.72 KB  (entry point)
+  docs/index.js                    1.35 KB  (entry point)
+  ./example.js                     0.96 KB  (entry point)
+  ./setup.js                       1.44 KB  (entry point)
+
+[contractspec-bun-build] transpile target=node root=src entries=5
+Bundled 5 modules in 29ms
+
+  docs/ai-support-bot.docblock.js  1.34 KB  (entry point)
+  ./index.js                       3.71 KB  (entry point)
+  docs/index.js                    1.34 KB  (entry point)
+  ./example.js                     0.95 KB  (entry point)
+  ./setup.js                       1.43 KB  (entry point)
+
+[contractspec-bun-build] transpile target=browser root=src entries=5
+Bundled 5 modules in 37ms
+
+  docs/ai-support-bot.docblock.js  1.34 KB  (entry point)
+  ./index.js                       3.71 KB  (entry point)
+  docs/index.js                    1.34 KB  (entry point)
+  ./example.js                     0.95 KB  (entry point)
+  ./setup.js                       1.43 KB  (entry point)
+
+$ contractspec-bun-build types

package/.turbo/turbo-prebuild.log

@@ -0,0 +1 @@
+$ contractspec-bun-build prebuild

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # @contractspec/example.ai-support-bot
 
+## 1.59.0
+
+### Minor Changes
+
+- 1a0cf44: fix: publishConfig not supported by bun
+
+### Patch Changes
+
+- Updated dependencies [1a0cf44]
+  - @contractspec/lib.support-bot@1.59.0
+  - @contractspec/lib.contracts@1.59.0
+  - @contractspec/lib.knowledge@1.59.0
+  - @contractspec/lib.logger@1.59.0
+
+## 1.58.0
+
+### Minor Changes
+
+- d1f0fd0: chore: Migrate non-app package builds from tsdown to shared Bun tooling, add `@contractspec/tool.bun`, and standardize `prebuild`/`build`/`typecheck` with platform-aware exports and `tsc` declaration emission into `dist`.
+
+### Patch Changes
+
+- Updated dependencies [d1f0fd0]
+- Updated dependencies [4355a9e]
+  - @contractspec/lib.support-bot@1.58.0
+  - @contractspec/lib.contracts@1.58.0
+  - @contractspec/lib.knowledge@1.58.0
+  - @contractspec/lib.logger@1.58.0
+
 ## 1.57.0
 
 ### Minor Changes

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

@@ -0,0 +1,38 @@
+// src/docs/ai-support-bot.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    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
+- Classify a ticket into a support category.
+- Use a knowledge port to generate a grounded resolution.
+- Draft a response (email body) from the resolution.
+
+## Guardrails
+- Avoid logging raw ticket bodies/PII; prefer structured summaries.
+- 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
+- Call \`runAiSupportBotExample()\`.
+- Replace the \`knowledge.query\` implementation with a real knowledge service.
+
+## Notes
+- Keep outputs structured.
+- Use policy gates before exposing drafted replies to end-users.`
+  }
+];
+registerDocBlocks(blocks);

package/dist/browser/docs/index.js

@@ -0,0 +1,38 @@
+// src/docs/ai-support-bot.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    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
+- Classify a ticket into a support category.
+- Use a knowledge port to generate a grounded resolution.
+- Draft a response (email body) from the resolution.
+
+## Guardrails
+- Avoid logging raw ticket bodies/PII; prefer structured summaries.
+- 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
+- Call \`runAiSupportBotExample()\`.
+- Replace the \`knowledge.query\` implementation with a real knowledge service.
+
+## Notes
+- Keep outputs structured.
+- Use policy gates before exposing drafted replies to end-users.`
+  }
+];
+registerDocBlocks(blocks);

package/dist/browser/example.js

@@ -0,0 +1,33 @@
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var 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 }
+  }
+});
+var example_default = example;
+export {
+  example_default as default
+};

package/dist/browser/index.js

@@ -0,0 +1,113 @@
+// src/docs/ai-support-bot.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    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
+- Classify a ticket into a support category.
+- Use a knowledge port to generate a grounded resolution.
+- Draft a response (email body) from the resolution.
+
+## Guardrails
+- Avoid logging raw ticket bodies/PII; prefer structured summaries.
+- 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
+- Call \`runAiSupportBotExample()\`.
+- Replace the \`knowledge.query\` implementation with a real knowledge service.
+
+## Notes
+- Keep outputs structured.
+- Use policy gates before exposing drafted replies to end-users.`
+  }
+];
+registerDocBlocks(blocks);
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var 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 }
+  }
+});
+var example_default = example;
+
+// src/setup.ts
+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 { Logger, LogLevel } from "@contractspec/lib.logger";
+var logger = new Logger({
+  level: LogLevel.DEBUG,
+  environment: "development",
+  enableColors: true
+});
+async function runAiSupportBotExample() {
+  const knowledge = {
+    async query(question) {
+      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 = {
+    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 }
+  });
+}
+export {
+  runAiSupportBotExample,
+  example_default as example
+};

package/dist/browser/setup.js

@@ -0,0 +1,43 @@
+// src/setup.ts
+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 { Logger, LogLevel } from "@contractspec/lib.logger";
+var logger = new Logger({
+  level: LogLevel.DEBUG,
+  environment: "development",
+  enableColors: true
+});
+async function runAiSupportBotExample() {
+  const knowledge = {
+    async query(question) {
+      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 = {
+    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 }
+  });
+}
+export {
+  runAiSupportBotExample
+};

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

@@ -1 +1,2 @@
-export { };
+export {};
+//# sourceMappingURL=ai-support-bot.docblock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-support-bot.docblock.d.ts","sourceRoot":"","sources":["../../src/docs/ai-support-bot.docblock.ts"],"names":[],"mappings":""}

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

@@ -1,29 +1,39 @@
+// @bun
+// src/docs/ai-support-bot.docblock.ts
 import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    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
+- Classify a ticket into a support category.
+- Use a knowledge port to generate a grounded resolution.
+- Draft a response (email body) from the resolution.
 
-//#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.`
-}]);
+## Guardrails
+- Avoid logging raw ticket bodies/PII; prefer structured summaries.
+- Keep knowledge and ticket adapters explicit and testable.`
+  },
+  {
+    id: "docs.examples.ai-support-bot.usage",
+    title: "AI Support Bot \u2014 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
+- Call \`runAiSupportBotExample()\`.
+- Replace the \`knowledge.query\` implementation with a real knowledge service.
 
-//#endregion
-//# sourceMappingURL=ai-support-bot.docblock.js.map
+## Notes
+- Keep outputs structured.
+- Use policy gates before exposing drafted replies to end-users.`
+  }
+];
+registerDocBlocks(blocks);

package/dist/docs/index.d.ts

@@ -1 +1,2 @@
-export { };
+import './ai-support-bot.docblock';
+//# sourceMappingURL=index.d.ts.map

package/dist/docs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/docs/index.ts"],"names":[],"mappings":"AAAA,OAAO,2BAA2B,CAAC"}

package/dist/docs/index.js

@@ -1 +1,39 @@
-import "./ai-support-bot.docblock.js";
+// @bun
+// src/docs/ai-support-bot.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    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
+- Classify a ticket into a support category.
+- Use a knowledge port to generate a grounded resolution.
+- Draft a response (email body) from the resolution.
+
+## Guardrails
+- Avoid logging raw ticket bodies/PII; prefer structured summaries.
+- Keep knowledge and ticket adapters explicit and testable.`
+  },
+  {
+    id: "docs.examples.ai-support-bot.usage",
+    title: "AI Support Bot \u2014 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
+- Call \`runAiSupportBotExample()\`.
+- Replace the \`knowledge.query\` implementation with a real knowledge service.
+
+## Notes
+- Keep outputs structured.
+- Use policy gates before exposing drafted replies to end-users.`
+  }
+];
+registerDocBlocks(blocks);

package/dist/example.d.ts

@@ -1,7 +1,3 @@
-import * as _contractspec_lib_contracts0 from "@contractspec/lib.contracts";
-
-//#region src/example.d.ts
-declare const example: _contractspec_lib_contracts0.ExampleSpec;
-//#endregion
-export { example as default };
+declare const example: import("@contractspec/lib.contracts").ExampleSpec;
+export default example;
 //# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"mappings":";;;cAEM,OAAA,EA2BJ,4BAAA,CA3BW,WAAA"}
+{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../src/example.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,OAAO,mDA2BX,CAAC;AAEH,eAAe,OAAO,CAAC"}

package/dist/example.js

@@ -1,45 +1,34 @@
+// @bun
+// src/example.ts
 import { defineExample } from "@contractspec/lib.contracts";
-
-//#region src/example.ts
-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 }
-	}
+var 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 }
+  }
 });
-
-//#endregion
-export { example as default };
-//# sourceMappingURL=example.js.map
+var example_default = example;
+export {
+  example_default as default
+};

package/dist/index.d.ts

@@ -1,3 +1,4 @@
-import example from "./example.js";
-import { runAiSupportBotExample } from "./setup.js";
-export { example, runAiSupportBotExample };
+export * from './setup';
+export { default as example } from './example';
+import './docs';
+//# 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,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,QAAQ,CAAC"}