@contractspec/lib.support-bot 1.44.0

package/dist/bot/tools.js

@@ -0,0 +1,137 @@
+import * as z from "zod";
+
+//#region src/bot/tools.ts
+const ticketSchema = z.object({
+	id: z.string(),
+	subject: z.string(),
+	body: z.string(),
+	channel: z.enum([
+		"email",
+		"chat",
+		"phone",
+		"portal"
+	]),
+	customerName: z.string().optional(),
+	customerEmail: z.string().optional(),
+	metadata: z.object().optional()
+});
+const supportCitationSchema = z.object({
+	label: z.string(),
+	url: z.string().optional(),
+	snippet: z.string().optional(),
+	score: z.number().optional()
+});
+const supportActionSchema = z.object({
+	type: z.enum([
+		"respond",
+		"escalate",
+		"refund",
+		"manual"
+	]),
+	label: z.string(),
+	payload: z.record(z.string(), z.string())
+});
+const supportResolutionSchema = z.object({
+	ticketId: z.string(),
+	answer: z.string(),
+	confidence: z.number(),
+	citations: supportCitationSchema.array(),
+	actions: supportActionSchema.array(),
+	escalationReason: z.string().optional(),
+	knowledgeUpdates: z.array(z.string()).optional()
+});
+const ticketClassificationSchema = z.object({
+	ticketId: z.string(),
+	category: z.enum([
+		"billing",
+		"technical",
+		"product",
+		"account",
+		"compliance",
+		"other"
+	]),
+	priority: z.enum([
+		"urgent",
+		"high",
+		"medium",
+		"low"
+	]),
+	sentiment: z.enum([
+		"positive",
+		"neutral",
+		"negative",
+		"frustrated"
+	]),
+	intents: z.array(z.string()),
+	tags: z.array(z.string()),
+	confidence: z.number(),
+	escalationRequired: z.boolean().optional()
+});
+function ensureTicket(input) {
+	if (!input || typeof input !== "object" || !("ticket" in input)) throw new Error("Input must include ticket");
+	const ticket = input.ticket;
+	if (!ticket?.id) throw new Error("Ticket is missing id");
+	return ticket;
+}
+function extractResolution(input) {
+	if (!input || typeof input !== "object" || !("resolution" in input)) return void 0;
+	return input.resolution;
+}
+function extractClassification(input) {
+	if (!input || typeof input !== "object" || !("classification" in input)) return void 0;
+	return input.classification;
+}
+function createSupportTools(options) {
+	return [
+		{
+			title: "support_classify_ticket",
+			description: "Classify a ticket for priority, sentiment, and category",
+			inputSchema: z.object({ ticket: ticketSchema }),
+			execute: async (input) => {
+				const ticket = ensureTicket(input);
+				const classification = await options.classifier.classify(ticket);
+				return {
+					content: JSON.stringify(classification),
+					metadata: { ticketId: ticket.id }
+				};
+			}
+		},
+		{
+			title: "support_resolve_ticket",
+			description: "Generate a knowledge-grounded resolution for a ticket",
+			inputSchema: z.object({ ticket: ticketSchema }),
+			execute: async (input) => {
+				const ticket = ensureTicket(input);
+				const resolution = await options.resolver.resolve(ticket);
+				return {
+					content: JSON.stringify(resolution),
+					metadata: { ticketId: ticket.id }
+				};
+			}
+		},
+		{
+			title: "support_draft_response",
+			description: "Draft a user-facing reply based on resolution + classification",
+			inputSchema: z.object({
+				ticket: ticketSchema,
+				resolution: supportResolutionSchema,
+				classification: ticketClassificationSchema
+			}),
+			execute: async (input) => {
+				const ticket = ensureTicket(input);
+				const resolution = extractResolution(input);
+				const classification = extractClassification(input);
+				if (!resolution || !classification) throw new Error("resolution and classification are required");
+				const draft = await options.responder.draft(ticket, resolution, classification);
+				return {
+					content: JSON.stringify(draft),
+					metadata: { ticketId: ticket.id }
+				};
+			}
+		}
+	];
+}
+
+//#endregion
+export { createSupportTools };
+//# sourceMappingURL=tools.js.map

package/dist/bot/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","names":[],"sources":["../../src/bot/tools.ts"],"sourcesContent":["import type { TicketResolver } from '../rag/ticket-resolver';\nimport type { TicketClassifier } from '../tickets/classifier';\nimport type { AutoResponder } from './auto-responder';\nimport type {\n  SupportAction,\n  SupportCitation,\n  SupportResolution,\n  SupportTicket,\n  TicketCategory,\n  TicketClassification,\n  TicketPriority,\n  TicketSentiment,\n} from '../types';\nimport type { Tool } from '@ai-sdk/provider-utils';\nimport * as z from 'zod';\n\nconst ticketSchema = z.object({\n  id: z.string(),\n  subject: z.string(),\n  body: z.string(),\n  channel: z.enum(['email', 'chat', 'phone', 'portal']),\n  customerName: z.string().optional(),\n  customerEmail: z.string().optional(),\n  metadata: z.object().optional(),\n}) satisfies z.ZodType<SupportTicket>;\nconst supportCitationSchema = z.object({\n  label: z.string(),\n  url: z.string().optional(),\n  snippet: z.string().optional(),\n  score: z.number().optional(),\n}) satisfies z.ZodType<SupportCitation>;\nconst supportActionSchema = z.object({\n  type: z.enum(['respond', 'escalate', 'refund', 'manual']),\n  label: z.string(),\n  payload: z.record(z.string(), z.string()),\n}) satisfies z.ZodType<SupportAction>;\nconst supportResolutionSchema = z.object({\n  ticketId: z.string(),\n  answer: z.string(),\n  confidence: z.number(),\n  citations: supportCitationSchema.array(),\n  actions: supportActionSchema.array(),\n  escalationReason: z.string().optional(),\n  knowledgeUpdates: z.array(z.string()).optional(),\n}) satisfies z.ZodType<SupportResolution>;\nconst ticketClassificationSchema = z.object({\n  ticketId: z.string(),\n  category: z.enum([\n    'billing',\n    'technical',\n    'product',\n    'account',\n    'compliance',\n    'other',\n  ]) satisfies z.ZodType<TicketCategory>,\n  priority: z.enum([\n    'urgent',\n    'high',\n    'medium',\n    'low',\n  ]) satisfies z.ZodType<TicketPriority>,\n  sentiment: z.enum([\n    'positive',\n    'neutral',\n    'negative',\n    'frustrated',\n  ]) satisfies z.ZodType<TicketSentiment>,\n  intents: z.array(z.string()),\n  tags: z.array(z.string()),\n  confidence: z.number(),\n  escalationRequired: z.boolean().optional(),\n}) satisfies z.ZodType<TicketClassification>;\n\nfunction ensureTicket(input: unknown): SupportTicket {\n  if (!input || typeof input !== 'object' || !('ticket' in input)) {\n    throw new Error('Input must include ticket');\n  }\n  const ticket = (input as { ticket: SupportTicket }).ticket;\n  if (!ticket?.id) throw new Error('Ticket is missing id');\n  return ticket;\n}\n\nfunction extractResolution(input: unknown): SupportResolution | undefined {\n  if (!input || typeof input !== 'object' || !('resolution' in input))\n    return undefined;\n  return (input as { resolution?: SupportResolution }).resolution;\n}\n\nfunction extractClassification(\n  input: unknown\n): TicketClassification | undefined {\n  if (!input || typeof input !== 'object' || !('classification' in input))\n    return undefined;\n  return (input as { classification?: TicketClassification }).classification;\n}\n\nexport interface SupportToolsetOptions {\n  resolver: TicketResolver;\n  classifier: TicketClassifier;\n  responder: AutoResponder;\n}\n\nexport function createSupportTools(options: SupportToolsetOptions): Tool[] {\n  const classifyTool: Tool = {\n    title: 'support_classify_ticket',\n    description: 'Classify a ticket for priority, sentiment, and category',\n    inputSchema: z.object({ ticket: ticketSchema }),\n    execute: async (input: unknown) => {\n      const ticket = ensureTicket(input);\n      const classification = await options.classifier.classify(ticket);\n      return {\n        content: JSON.stringify(classification),\n        metadata: { ticketId: ticket.id },\n      };\n    },\n  };\n\n  const resolveTool: Tool = {\n    title: 'support_resolve_ticket',\n    description: 'Generate a knowledge-grounded resolution for a ticket',\n    inputSchema: z.object({ ticket: ticketSchema }),\n    execute: async (input: unknown) => {\n      const ticket = ensureTicket(input);\n      const resolution = await options.resolver.resolve(ticket);\n      return {\n        content: JSON.stringify(resolution),\n        metadata: { ticketId: ticket.id },\n      };\n    },\n  };\n\n  const responderTool: Tool = {\n    title: 'support_draft_response',\n    description:\n      'Draft a user-facing reply based on resolution + classification',\n    inputSchema: z.object({\n      ticket: ticketSchema,\n      resolution: supportResolutionSchema,\n      classification: ticketClassificationSchema,\n    }),\n    execute: async (input: unknown) => {\n      const ticket = ensureTicket(input);\n      const resolution = extractResolution(input);\n      const classification = extractClassification(input);\n      if (!resolution || !classification) {\n        throw new Error('resolution and classification are required');\n      }\n      const draft = await options.responder.draft(\n        ticket,\n        resolution,\n        classification\n      );\n      return {\n        content: JSON.stringify(draft),\n        metadata: { ticketId: ticket.id },\n      };\n    },\n  };\n\n  return [classifyTool, resolveTool, responderTool];\n}\n"],"mappings":"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"}

package/dist/contracts/src/docs/accessibility_wcag_compliance_specs.docblock.d.ts

@@ -0,0 +1 @@
+import "./index.js";

package/dist/contracts/src/docs/index.d.ts

@@ -0,0 +1,25 @@
+import "./presentations.js";
+import { DocId } from "./registry.js";
+import "./accessibility_wcag_compliance_specs.docblock.js";
+import "./tech/lifecycle-stage-system.docblock.js";
+import "./tech/presentation-runtime.docblock.js";
+import "./tech/auth/better-auth-nextjs.docblock.js";
+import "./tech/schema/README.docblock.js";
+import "./tech/templates/runtime.docblock.js";
+import "../workflow/overview.docblock.js";
+import "./tech/mcp-endpoints.docblock.js";
+import "./tech/vscode-extension.docblock.js";
+import "./tech/telemetry-ingest.docblock.js";
+import "./tech/contracts/openapi-export.docblock.js";
+import "./tech/contracts/openapi-import.docblock.js";
+import "../workspace-config/workspace-config.docblock.js";
+import "./tech/studio/workspaces.docblock.js";
+import "./tech/studio/sandbox-unlogged.docblock.js";
+import "./tech/studio/workspace-ops.docblock.js";
+import "./tech/studio/project-routing.docblock.js";
+import "./tech/studio/platform-admin-panel.docblock.js";
+import "./tech/studio/learning-events.docblock.js";
+import "./tech/studio/learning-journeys.docblock.js";
+import "./tech/studio/project-access-teams.docblock.js";
+import "./tech/studio/team-invitations.docblock.js";
+import "./tech/llm/llm-integration.docblock.js";

package/dist/contracts/src/docs/presentations.d.ts

@@ -0,0 +1,2 @@
+import "../presentations/presentations.js";
+import "../ownership.js";

package/dist/contracts/src/docs/registry.d.ts

@@ -0,0 +1,10 @@
+import "../presentations/presentations.js";
+import "./presentations.js";
+
+//#region ../contracts/src/docs/registry.d.ts
+type DocId = string & {
+  __docId: true;
+};
+//#endregion
+export { DocId };
+//# sourceMappingURL=registry.d.ts.map

package/dist/contracts/src/docs/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","names":[],"sources":["../../../../../contracts/src/docs/registry.ts"],"sourcesContent":[],"mappings":";;;;KASY,KAAA;EAAA,OAAA,EAAK,IAAA"}

package/dist/contracts/src/docs/tech/auth/better-auth-nextjs.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/contracts/src/docs/tech/contracts/openapi-export.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/contracts/src/docs/tech/contracts/openapi-import.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/contracts/src/docs/tech/lifecycle-stage-system.docblock.d.ts

@@ -0,0 +1 @@
+import "../index.js";

package/dist/contracts/src/docs/tech/llm/llm-integration.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/contracts/src/docs/tech/mcp-endpoints.docblock.d.ts

@@ -0,0 +1 @@
+import "../index.js";

package/dist/contracts/src/docs/tech/presentation-runtime.docblock.d.ts

@@ -0,0 +1 @@
+import "../index.js";

package/dist/contracts/src/docs/tech/schema/README.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/contracts/src/docs/tech/studio/learning-events.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/contracts/src/docs/tech/studio/learning-journeys.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/contracts/src/docs/tech/studio/platform-admin-panel.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/contracts/src/docs/tech/studio/project-access-teams.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/contracts/src/docs/tech/studio/project-routing.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/contracts/src/docs/tech/studio/sandbox-unlogged.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/contracts/src/docs/tech/studio/team-invitations.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/contracts/src/docs/tech/studio/workspace-ops.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/contracts/src/docs/tech/studio/workspaces.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/contracts/src/docs/tech/telemetry-ingest.docblock.d.ts

@@ -0,0 +1 @@
+import "../index.js";

package/dist/contracts/src/docs/tech/templates/runtime.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/contracts/src/docs/tech/vscode-extension.docblock.d.ts

@@ -0,0 +1 @@
+import "../index.js";

package/dist/contracts/src/integrations/providers/llm.d.ts

@@ -0,0 +1,83 @@
+//#region ../contracts/src/integrations/providers/llm.d.ts
+type LLMRole = 'system' | 'user' | 'assistant' | 'tool';
+interface LLMTextPart {
+  type: 'text';
+  text: string;
+}
+interface LLMToolCallPart {
+  type: 'tool-call';
+  id: string;
+  name: string;
+  arguments: string;
+}
+interface LLMToolResultPart {
+  type: 'tool-result';
+  toolCallId: string;
+  output: string;
+}
+type LLMContentPart = LLMTextPart | LLMToolCallPart | LLMToolResultPart;
+interface LLMMessage {
+  role: LLMRole;
+  content: LLMContentPart[];
+  name?: string;
+  toolCallId?: string;
+  metadata?: Record<string, string>;
+}
+interface LLMToolDefinition {
+  name: string;
+  description?: string;
+  inputSchema: unknown;
+}
+interface LLMTokenUsage {
+  promptTokens: number;
+  completionTokens: number;
+  totalTokens: number;
+}
+interface LLMChatOptions {
+  model?: string;
+  temperature?: number;
+  topP?: number;
+  maxOutputTokens?: number;
+  stopSequences?: string[];
+  responseFormat?: 'text' | 'json';
+  tools?: LLMToolDefinition[];
+  userId?: string;
+  metadata?: Record<string, string>;
+  timeoutMs?: number;
+  signal?: AbortSignal;
+}
+interface LLMResponse {
+  message: LLMMessage;
+  usage?: LLMTokenUsage;
+  finishReason?: 'stop' | 'length' | 'tool_call' | 'content_filter';
+  raw?: unknown;
+}
+type LLMStreamChunk = {
+  type: 'message_delta';
+  delta: LLMContentPart;
+  index: number;
+} | {
+  type: 'tool_call';
+  call: LLMToolCallPart;
+  index: number;
+} | {
+  type: 'usage';
+  usage: LLMTokenUsage;
+} | {
+  type: 'error';
+  error: Error;
+} | {
+  type: 'end';
+  response: LLMResponse;
+};
+interface TokenCountResult {
+  promptTokens: number;
+}
+interface LLMProvider {
+  chat(messages: LLMMessage[], options?: LLMChatOptions): Promise<LLMResponse>;
+  stream(messages: LLMMessage[], options?: LLMChatOptions): AsyncIterable<LLMStreamChunk>;
+  countTokens(messages: LLMMessage[]): Promise<TokenCountResult>;
+}
+//#endregion
+export { LLMProvider };
+//# sourceMappingURL=llm.d.ts.map

package/dist/contracts/src/integrations/providers/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","names":[],"sources":["../../../../../../contracts/src/integrations/providers/llm.ts"],"sourcesContent":[],"mappings":";KAAY,OAAA;AAAA,UAEK,WAAA,CAFE;EAEF,IAAA,EAAA,MAAA;EAKA,IAAA,EAAA,MAAA;AAOjB;AAMY,UAbK,eAAA,CAaS;EAAG,IAAA,EAAA,WAAA;EAAc,EAAA,EAAA,MAAA;EAAkB,IAAA,EAAA,MAAA;EAAiB,SAAA,EAAA,MAAA;AAE9E;AACQ,UATS,iBAAA,CAST;EACG,IAAA,EAAA,aAAA;EAGE,UAAA,EAAA,MAAA;EAAM,MAAA,EAAA,MAAA;AAGnB;AAMiB,KAhBL,cAAA,GAAiB,WAgBC,GAhBa,eAgBb,GAhB+B,iBAgB/B;AAMb,UApBA,UAAA,CAoBc;EAOrB,IAAA,EA1BF,OA0BE;EAEG,OAAA,EA3BF,cA2BE,EAAA;EAEF,IAAA,CAAA,EAAA,MAAA;EAAW,UAAA,CAAA,EAAA,MAAA;EAGL,QAAA,CAAA,EA7BJ,MA6Be,CAAA,MAAA,EACjB,MAAA,CAAA;AAMX;AAGa,UApCI,iBAAA,CAoCJ;EAKD,IAAA,EAAA,MAAA;EAKC,WAAA,CAAA,EAAA,MAAA;EAIA,WAAA,EAAA,OAAA;;AAIc,UAhDV,aAAA,CAgDU;EAGV,YAAA,EAAA,MAAgB;EAIhB,gBAAW,EAAA,MAAA;EACX,WAAA,EAAA,MAAA;;AAAiD,UAlDjD,cAAA,CAkDiD;EAAR,KAAA,CAAA,EAAA,MAAA;EAE5C,WAAA,CAAA,EAAA,MAAA;EACA,IAAA,CAAA,EAAA,MAAA;EACK,eAAA,CAAA,EAAA,MAAA;EAAd,aAAA,CAAA,EAAA,MAAA,EAAA;EACmB,cAAA,CAAA,EAAA,MAAA,GAAA,MAAA;EAAuB,KAAA,CAAA,EAhDrC,iBAgDqC,EAAA;EAAR,MAAA,CAAA,EAAA,MAAA;EAAO,QAAA,CAAA,EA9CjC,MA8CiC,CAAA,MAAA,EAAA,MAAA,CAAA;;WA5CnC;;UAGM,WAAA;WACN;UACD;;;;KAKE,cAAA;;SAGC;;;;QAKD;;;;SAKC;;;SAIA;;;YAIG;;UAGC,gBAAA;;;UAIA,WAAA;iBACA,wBAAwB,iBAAiB,QAAQ;mBAEpD,wBACA,iBACT,cAAc;wBACK,eAAe,QAAQ"}

package/dist/contracts/src/knowledge/spec.d.ts

@@ -0,0 +1,8 @@
+import "../ownership.js";
+import "../policy/spec.js";
+
+//#region ../contracts/src/knowledge/spec.d.ts
+type KnowledgeCategory = 'canonical' | 'operational' | 'external' | 'ephemeral';
+//#endregion
+export { KnowledgeCategory };
+//# sourceMappingURL=spec.d.ts.map

package/dist/contracts/src/knowledge/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","names":[],"sources":["../../../../../contracts/src/knowledge/spec.ts"],"sourcesContent":[],"mappings":";;;;KAGY,iBAAA"}

package/dist/contracts/src/ownership.d.ts

@@ -0,0 +1,61 @@
+import { DocId } from "./docs/registry.js";
+import "./docs/index.js";
+
+//#region ../contracts/src/ownership.d.ts
+declare const StabilityEnum: {
+  readonly Idea: "idea";
+  readonly InCreation: "in_creation";
+  readonly Experimental: "experimental";
+  readonly Beta: "beta";
+  readonly Stable: "stable";
+  readonly Deprecated: "deprecated";
+};
+type Stability = (typeof StabilityEnum)[keyof typeof StabilityEnum];
+declare const OwnersEnum: {
+  readonly PlatformCore: "platform.core";
+  readonly PlatformSigil: "platform.sigil";
+  readonly PlatformMarketplace: "platform.marketplace";
+  readonly PlatformMessaging: "platform.messaging";
+  readonly PlatformContent: "platform.content";
+  readonly PlatformFeatureFlags: "platform.featureflags";
+  readonly PlatformFinance: "platform.finance";
+};
+type Owner = (typeof OwnersEnum)[keyof typeof OwnersEnum] | (string & {});
+declare const TagsEnum: {
+  readonly Spots: "spots";
+  readonly Collectivity: "collectivity";
+  readonly Marketplace: "marketplace";
+  readonly Sellers: "sellers";
+  readonly Auth: "auth";
+  readonly Login: "login";
+  readonly Signup: "signup";
+  readonly Guide: "guide";
+  readonly Docs: "docs";
+  readonly I18n: "i18n";
+  readonly Incident: "incident";
+  readonly Automation: "automation";
+  readonly Hygiene: "hygiene";
+};
+type Tag = (typeof TagsEnum)[keyof typeof TagsEnum] | (string & {});
+interface OwnerShipMeta {
+  /** Breaking changes => bump version */
+  version: number;
+  /** Fully-qualified spec key (e.g., "sigil.beginSignup") */
+  key: string;
+  /** Human-friendly spec title (e.g., "Signup begin") */
+  title?: string;
+  /** Short human-friendly summary */
+  description: string;
+  domain?: string;
+  /** Lifecycle marker for comms & tooling */
+  stability: Stability;
+  /** Owners for CODEOWNERS / on-call / approvals */
+  owners: Owner[];
+  /** Search tags, grouping, docs navigation */
+  tags: Tag[];
+  /** Doc block(s) for this operation. */
+  docId?: DocId[];
+}
+//#endregion
+export { OwnerShipMeta };
+//# sourceMappingURL=ownership.d.ts.map

package/dist/contracts/src/ownership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ownership.d.ts","names":[],"sources":["../../../../contracts/src/ownership.ts"],"sourcesContent":[],"mappings":";;;;cAIa;;;EAAA,SAAA,YAOH,EAAA,cAAA;EACE,SAAA,IAAS,EAAA,MAAA;EAGR,SAAA,MAQH,EAAA,QAAA;EACE,SAAK,UAAA,EACL,YAAyB;AAMrC,CAAA;AAeY,KAlCA,SAAA,GAkCc,CAAA,OAlCM,aAkCyB,CAAA,CAAA,MAAA,OAlCG,aAkCH,CAAA;AAIxC,cAnCJ,UAmCiB,EAAA;EAWjB,SAAA,YAAA,EAAA,eAAA;EAEH,SAAA,aAAA,EAAA,gBAAA;EAEF,SAAA,mBAAA,EAAA,sBAAA;EAGE,SAAA,iBAAA,EAAA,oBAAA;EAAK,SAAA,eAAA,EAAA,kBAAA;;;;KA5CH,KAAA,WACA,yBAAyB;cAMxB;;;;;;;;;;;;;;;KAeD,GAAA,WAAc,uBAAuB;UAIhC,aAAA;;;;;;;;;;;aAWJ;;UAEH;;QAEF;;UAGE"}

package/dist/contracts/src/policy/spec.d.ts

@@ -0,0 +1,11 @@
+import "../ownership.js";
+
+//#region ../contracts/src/policy/spec.d.ts
+
+interface PolicyRef {
+  key: string;
+  version: number;
+}
+//#endregion
+export { PolicyRef };
+//# sourceMappingURL=spec.d.ts.map

package/dist/contracts/src/policy/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","names":[],"sources":["../../../../../contracts/src/policy/spec.ts"],"sourcesContent":[],"mappings":";;;;UAmHiB,SAAA"}

package/dist/contracts/src/presentations/presentations.d.ts

@@ -0,0 +1,2 @@
+import "../../../schema/src/index.js";
+import "../ownership.js";

package/dist/contracts/src/workflow/overview.docblock.d.ts

@@ -0,0 +1 @@
+import "../docs/index.js";

package/dist/contracts/src/workspace-config/workspace-config.docblock.d.ts

@@ -0,0 +1 @@
+import "../docs/index.js";

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import { ClassificationResultPayload, ResolutionResultPayload, SupportAction, SupportBotSpec, SupportCitation, SupportResolution, SupportResponseDraft, SupportTicket, TicketCategory, TicketChannel, TicketClassification, TicketPriority, TicketSentiment } from "./types.js";
+import { AutoResponder, AutoResponderOptions } from "./bot/auto-responder.js";
+import { FeedbackMetrics, SupportFeedbackLoop } from "./bot/feedback-loop.js";
+import { KnowledgeRetriever, TicketResolver, TicketResolverOptions } from "./rag/ticket-resolver.js";
+import { TicketClassifier, TicketClassifierOptions } from "./tickets/classifier.js";
+import { SupportToolsetOptions, createSupportTools } from "./bot/tools.js";
+import "./bot/index.js";
+import { SupportBotDefinition, defineSupportBot } from "./spec.js";
+import "./rag/index.js";
+import "./tickets/index.js";
+export { AutoResponder, AutoResponderOptions, ClassificationResultPayload, FeedbackMetrics, KnowledgeRetriever, ResolutionResultPayload, SupportAction, SupportBotDefinition, SupportBotSpec, SupportCitation, SupportFeedbackLoop, SupportResolution, SupportResponseDraft, SupportTicket, SupportToolsetOptions, TicketCategory, TicketChannel, TicketClassification, TicketClassifier, TicketClassifierOptions, TicketPriority, TicketResolver, TicketResolverOptions, TicketSentiment, createSupportTools, defineSupportBot };

package/dist/index.js

@@ -0,0 +1,9 @@
+import { defineSupportBot } from "./spec.js";
+import { TicketResolver } from "./rag/ticket-resolver.js";
+import { TicketClassifier } from "./tickets/classifier.js";
+import { AutoResponder } from "./bot/auto-responder.js";
+import { SupportFeedbackLoop } from "./bot/feedback-loop.js";
+import { createSupportTools } from "./bot/tools.js";
+import "./bot/index.js";
+
+export { AutoResponder, SupportFeedbackLoop, TicketClassifier, TicketResolver, createSupportTools, defineSupportBot };

package/dist/rag/index.d.ts

@@ -0,0 +1,2 @@
+import { KnowledgeRetriever, TicketResolver, TicketResolverOptions } from "./ticket-resolver.js";
+export { KnowledgeRetriever, TicketResolver, TicketResolverOptions };

package/dist/rag/index.js

@@ -0,0 +1,3 @@
+import { TicketResolver } from "./ticket-resolver.js";
+
+export { TicketResolver };

package/dist/rag/ticket-resolver.d.ts

@@ -0,0 +1,25 @@
+import { SupportResolution, SupportTicket } from "../types.js";
+import { KnowledgeAnswer } from "@contractspec/lib.knowledge/query/service";
+
+//#region src/rag/ticket-resolver.d.ts
+interface KnowledgeRetriever {
+  query(question: string): Promise<KnowledgeAnswer>;
+}
+interface TicketResolverOptions {
+  knowledge: KnowledgeRetriever;
+  minConfidence?: number;
+  prependPrompt?: string;
+}
+declare class TicketResolver {
+  private readonly knowledge;
+  private readonly minConfidence;
+  private readonly prependPrompt?;
+  constructor(options: TicketResolverOptions);
+  resolve(ticket: SupportTicket): Promise<SupportResolution>;
+  private buildQuestion;
+  private toResolution;
+  private deriveConfidence;
+}
+//#endregion
+export { KnowledgeRetriever, TicketResolver, TicketResolverOptions };
+//# sourceMappingURL=ticket-resolver.d.ts.map

package/dist/rag/ticket-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticket-resolver.d.ts","names":[],"sources":["../../src/rag/ticket-resolver.ts"],"sourcesContent":[],"mappings":";;;;UAGiB,kBAAA;2BACU,QAAQ;AADnC;AAIiB,UAAA,qBAAA,CAAqB;EAMzB,SAAA,EALA,kBAKc;EAKJ,aAAA,CAAA,EAAA,MAAA;EAMC,aAAA,CAAA,EAAA,MAAA;;AAAgB,cAX3B,cAAA,CAW2B;EAAO,iBAAA,SAAA;;;uBANxB;kBAMC,gBAAgB,QAAQ"}

package/dist/rag/ticket-resolver.js

@@ -0,0 +1,64 @@
+//#region src/rag/ticket-resolver.ts
+var TicketResolver = class {
+	knowledge;
+	minConfidence;
+	prependPrompt;
+	constructor(options) {
+		this.knowledge = options.knowledge;
+		this.minConfidence = options.minConfidence ?? .65;
+		this.prependPrompt = options.prependPrompt;
+	}
+	async resolve(ticket) {
+		const question = this.buildQuestion(ticket);
+		const answer = await this.knowledge.query(question);
+		return this.toResolution(ticket, answer);
+	}
+	buildQuestion(ticket) {
+		const header = [`Subject: ${ticket.subject}`, `Channel: ${ticket.channel}`];
+		if (ticket.customerName) header.push(`Customer: ${ticket.customerName}`);
+		return [
+			this.prependPrompt,
+			header.join("\n"),
+			"---",
+			ticket.body
+		].filter(Boolean).join("\n");
+	}
+	toResolution(ticket, answer) {
+		const citations = answer.references.map((ref) => {
+			return {
+				label: typeof ref.payload?.title === "string" ? ref.payload.title : typeof ref.payload?.documentId === "string" ? ref.payload.documentId : ref.id,
+				url: typeof ref.payload?.url === "string" ? ref.payload.url : void 0,
+				snippet: typeof ref.payload?.text === "string" ? ref.payload.text.slice(0, 280) : void 0,
+				score: ref.score
+			};
+		});
+		const confidence = this.deriveConfidence(answer);
+		const escalate = confidence < this.minConfidence || citations.length === 0;
+		return {
+			ticketId: ticket.id,
+			answer: answer.answer,
+			confidence,
+			citations,
+			actions: [escalate ? {
+				type: "escalate",
+				label: "Escalate for human review"
+			} : {
+				type: "respond",
+				label: "Send automated response"
+			}],
+			escalationReason: escalate ? "Insufficient confidence or missing knowledge references" : void 0,
+			knowledgeUpdates: escalate ? [ticket.body.slice(0, 200)] : void 0
+		};
+	}
+	deriveConfidence(answer) {
+		if (!answer.references.length) return .3;
+		const topScore = answer.references[0]?.score ?? .4;
+		const normalized = Math.min(1, Math.max(0, topScore));
+		const tokenPenalty = answer.usage?.completionTokens ? Math.min(answer.usage.completionTokens / 1e3, .2) : 0;
+		return Number((normalized - tokenPenalty).toFixed(2));
+	}
+};
+
+//#endregion
+export { TicketResolver };
+//# sourceMappingURL=ticket-resolver.js.map

package/dist/rag/ticket-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticket-resolver.js","names":[],"sources":["../../src/rag/ticket-resolver.ts"],"sourcesContent":["import type { KnowledgeAnswer } from '@contractspec/lib.knowledge/query/service';\nimport type { SupportResolution, SupportTicket } from '../types';\n\nexport interface KnowledgeRetriever {\n  query(question: string): Promise<KnowledgeAnswer>;\n}\n\nexport interface TicketResolverOptions {\n  knowledge: KnowledgeRetriever;\n  minConfidence?: number;\n  prependPrompt?: string;\n}\n\nexport class TicketResolver {\n  private readonly knowledge: KnowledgeRetriever;\n  private readonly minConfidence: number;\n  private readonly prependPrompt?: string;\n\n  constructor(options: TicketResolverOptions) {\n    this.knowledge = options.knowledge;\n    this.minConfidence = options.minConfidence ?? 0.65;\n    this.prependPrompt = options.prependPrompt;\n  }\n\n  async resolve(ticket: SupportTicket): Promise<SupportResolution> {\n    const question = this.buildQuestion(ticket);\n    const answer = await this.knowledge.query(question);\n    return this.toResolution(ticket, answer);\n  }\n\n  private buildQuestion(ticket: SupportTicket): string {\n    const header = [`Subject: ${ticket.subject}`, `Channel: ${ticket.channel}`];\n    if (ticket.customerName) header.push(`Customer: ${ticket.customerName}`);\n    const sections = [\n      this.prependPrompt,\n      header.join('\\n'),\n      '---',\n      ticket.body,\n    ].filter(Boolean);\n    return sections.join('\\n');\n  }\n\n  private toResolution(\n    ticket: SupportTicket,\n    answer: KnowledgeAnswer\n  ): SupportResolution {\n    const citations = answer.references.map((ref) => {\n      const label =\n        typeof ref.payload?.title === 'string'\n          ? ref.payload.title\n          : typeof ref.payload?.documentId === 'string'\n            ? ref.payload.documentId\n            : ref.id;\n      return {\n        label,\n        url: typeof ref.payload?.url === 'string' ? ref.payload.url : undefined,\n        snippet:\n          typeof ref.payload?.text === 'string'\n            ? ref.payload.text.slice(0, 280)\n            : undefined,\n        score: ref.score,\n      };\n    });\n\n    const confidence = this.deriveConfidence(answer);\n    const escalate = confidence < this.minConfidence || citations.length === 0;\n\n    return {\n      ticketId: ticket.id,\n      answer: answer.answer,\n      confidence,\n      citations,\n      actions: [\n        escalate\n          ? { type: 'escalate', label: 'Escalate for human review' }\n          : { type: 'respond', label: 'Send automated response' },\n      ],\n      escalationReason: escalate\n        ? 'Insufficient confidence or missing knowledge references'\n        : undefined,\n      knowledgeUpdates: escalate ? [ticket.body.slice(0, 200)] : undefined,\n    };\n  }\n\n  private deriveConfidence(answer: KnowledgeAnswer): number {\n    if (!answer.references.length) return 0.3;\n    const topScore = answer.references[0]?.score ?? 0.4;\n    const normalized = Math.min(1, Math.max(0, topScore));\n    const tokenPenalty = answer.usage?.completionTokens\n      ? Math.min(answer.usage.completionTokens / 1000, 0.2)\n      : 0;\n    return Number((normalized - tokenPenalty).toFixed(2));\n  }\n}\n"],"mappings":";AAaA,IAAa,iBAAb,MAA4B;CAC1B,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CAEjB,YAAY,SAAgC;AAC1C,OAAK,YAAY,QAAQ;AACzB,OAAK,gBAAgB,QAAQ,iBAAiB;AAC9C,OAAK,gBAAgB,QAAQ;;CAG/B,MAAM,QAAQ,QAAmD;EAC/D,MAAM,WAAW,KAAK,cAAc,OAAO;EAC3C,MAAM,SAAS,MAAM,KAAK,UAAU,MAAM,SAAS;AACnD,SAAO,KAAK,aAAa,QAAQ,OAAO;;CAG1C,AAAQ,cAAc,QAA+B;EACnD,MAAM,SAAS,CAAC,YAAY,OAAO,WAAW,YAAY,OAAO,UAAU;AAC3E,MAAI,OAAO,aAAc,QAAO,KAAK,aAAa,OAAO,eAAe;AAOxE,SANiB;GACf,KAAK;GACL,OAAO,KAAK,KAAK;GACjB;GACA,OAAO;GACR,CAAC,OAAO,QAAQ,CACD,KAAK,KAAK;;CAG5B,AAAQ,aACN,QACA,QACmB;EACnB,MAAM,YAAY,OAAO,WAAW,KAAK,QAAQ;AAO/C,UAAO;IACL,OANA,OAAO,IAAI,SAAS,UAAU,WAC1B,IAAI,QAAQ,QACZ,OAAO,IAAI,SAAS,eAAe,WACjC,IAAI,QAAQ,aACZ,IAAI;IAGV,KAAK,OAAO,IAAI,SAAS,QAAQ,WAAW,IAAI,QAAQ,MAAM;IAC9D,SACE,OAAO,IAAI,SAAS,SAAS,WACzB,IAAI,QAAQ,KAAK,MAAM,GAAG,IAAI,GAC9B;IACN,OAAO,IAAI;IACZ;IACD;EAEF,MAAM,aAAa,KAAK,iBAAiB,OAAO;EAChD,MAAM,WAAW,aAAa,KAAK,iBAAiB,UAAU,WAAW;AAEzE,SAAO;GACL,UAAU,OAAO;GACjB,QAAQ,OAAO;GACf;GACA;GACA,SAAS,CACP,WACI;IAAE,MAAM;IAAY,OAAO;IAA6B,GACxD;IAAE,MAAM;IAAW,OAAO;IAA2B,CAC1D;GACD,kBAAkB,WACd,4DACA;GACJ,kBAAkB,WAAW,CAAC,OAAO,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG;GAC5D;;CAGH,AAAQ,iBAAiB,QAAiC;AACxD,MAAI,CAAC,OAAO,WAAW,OAAQ,QAAO;EACtC,MAAM,WAAW,OAAO,WAAW,IAAI,SAAS;EAChD,MAAM,aAAa,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,SAAS,CAAC;EACrD,MAAM,eAAe,OAAO,OAAO,mBAC/B,KAAK,IAAI,OAAO,MAAM,mBAAmB,KAAM,GAAI,GACnD;AACJ,SAAO,QAAQ,aAAa,cAAc,QAAQ,EAAE,CAAC"}

package/dist/schema/src/EnumType.d.ts

@@ -0,0 +1,2 @@
+import "zod";
+import "graphql";

package/dist/schema/src/FieldType.d.ts

@@ -0,0 +1,2 @@
+import "zod";
+import "graphql";

package/dist/schema/src/GraphQLSchemaType.d.ts

@@ -0,0 +1,2 @@
+import "./SchemaModelType.js";
+import "zod";

package/dist/schema/src/JsonSchemaType.d.ts

@@ -0,0 +1,2 @@
+import "./SchemaModelType.js";
+import "zod";

package/dist/schema/src/ScalarTypeEnum.d.ts

@@ -0,0 +1 @@
+import "./FieldType.js";

package/dist/schema/src/SchemaModel.d.ts

@@ -0,0 +1,4 @@
+import "./FieldType.js";
+import "./EnumType.js";
+import "./SchemaModelType.js";
+import "zod";

package/dist/schema/src/SchemaModelType.d.ts

@@ -0,0 +1 @@
+import "zod";

package/dist/schema/src/ZodSchemaType.d.ts

@@ -0,0 +1,2 @@
+import "./SchemaModelType.js";
+import "zod";