@contractspec/lib.support-bot 0.0.0-canary-20260113170453

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/app-config/lifecycle.d.ts

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

package/dist/contracts/src/app-config/runtime.d.ts

@@ -0,0 +1,13 @@
+import "../policy/spec.js";
+import "../telemetry/spec.js";
+import "../capabilities/index.js";
+import "../experiments/spec.js";
+import "../features/index.js";
+import "../data-views/index.js";
+import "../workflow/spec.js";
+import "../policy/registry.js";
+import "../themes.js";
+import "../integrations/spec.js";
+import "../integrations/connection.js";
+import "./spec.js";
+import "../knowledge/spec.js";

package/dist/contracts/src/app-config/spec.d.ts

@@ -0,0 +1,9 @@
+import "../ownership.js";
+import "../policy/spec.js";
+import "../capabilities/index.js";
+import "../experiments/spec.js";
+import "../features/index.js";
+import "../themes.js";
+import "../integrations/spec.js";
+import "./lifecycle.js";
+import "../registry.js";

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

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

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

@@ -0,0 +1,2 @@
+import "./capabilities.js";
+import "./openbanking.js";

package/dist/contracts/src/capabilities/openbanking.d.ts

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

package/dist/contracts/src/data-views/index.d.ts

@@ -0,0 +1,3 @@
+import "./types.js";
+import "./spec.js";
+import "./registry.js";

package/dist/contracts/src/data-views/registry.d.ts

@@ -0,0 +1,2 @@
+import "./spec.js";
+import "../registry.js";

package/dist/contracts/src/data-views/spec.d.ts

@@ -0,0 +1,2 @@
+import "../experiments/spec.js";
+import "./types.js";

package/dist/contracts/src/data-views/types.d.ts

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

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 "../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/README.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/README.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/vscode-extension.docblock.d.ts

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

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

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

package/dist/contracts/src/experiments/spec-resolver.d.ts

@@ -0,0 +1,4 @@
+import "../../../schema/src/index.js";
+import "../resources.js";
+import "../operations/index.js";
+import "../types.js";

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

@@ -0,0 +1,4 @@
+import "../ownership.js";
+import "../policy/spec.js";
+import "../telemetry/spec.js";
+import "../registry.js";

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

@@ -0,0 +1,4 @@
+import "./types.js";
+import "./registry.js";
+import "./install.js";
+import "./validation.js";

package/dist/contracts/src/features/install.d.ts

@@ -0,0 +1,6 @@
+import "../presentations/presentations.js";
+import "../capabilities/index.js";
+import "../operations/registry.js";
+import "./types.js";
+import "./registry.js";
+import "../presentations/index.js";

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

@@ -0,0 +1,2 @@
+import "../registry-utils.js";
+import "./types.js";

package/dist/contracts/src/features/types.d.ts

@@ -0,0 +1,5 @@
+import "../presentations/presentations.js";
+import "../ownership.js";
+import "../capabilities/index.js";
+import "../experiments/spec.js";
+import "../operations/index.js";

package/dist/contracts/src/features/validation.d.ts

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

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

@@ -0,0 +1,7 @@
+import "../../schema/src/index.js";
+import "./events.js";
+import "./resources.js";
+import "./operations/registry.js";
+import "./operations/index.js";
+import "./types.js";
+import "zod";

package/dist/contracts/src/integrations/connection.d.ts

@@ -0,0 +1 @@
+import "./spec.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/integrations/spec.d.ts

@@ -0,0 +1,3 @@
+import "../ownership.js";
+import "../capabilities/index.js";
+import "../registry.js";

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

@@ -0,0 +1,9 @@
+import "../ownership.js";
+import "../policy/spec.js";
+import "../registry.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":";;;;;KAIY,iBAAA"}

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

@@ -0,0 +1,2 @@
+import "./operation.js";
+import "./registry.js";

package/dist/contracts/src/operations/operation.d.ts

@@ -0,0 +1,6 @@
+import "../../../schema/src/index.js";
+import "../ownership.js";
+import "../policy/spec.js";
+import "../events.js";
+import "../resources.js";
+import "../tests/spec.js";

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

@@ -0,0 +1,6 @@
+import "../../../schema/src/index.js";
+import "../resources.js";
+import "./operation.js";
+import "../install.js";
+import "../types.js";
+import "../registry.js";

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: string;
+  /** 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/registry.d.ts

@@ -0,0 +1,2 @@
+import "./spec.js";
+import "../registry.js";

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: string;
+}
+//#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/index.d.ts

@@ -0,0 +1,3 @@
+import "./presentations.js";
+import "./transform-engine.js";
+import "./registry.js";

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

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

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

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

package/dist/contracts/src/presentations/transform-engine.d.ts

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

package/dist/contracts/src/registry-utils.d.ts

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

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

@@ -0,0 +1,3 @@
+import "./ownership.js";
+import "./registry-utils.js";
+import "./types.js";

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

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