@cossistant/types 0.1.0 → 0.1.2

package/analytics.d.ts

@@ -0,0 +1,31 @@
+//#region src/analytics.d.ts
+/**
+ * Shared satisfaction index calculation.
+ *
+ * Pure functions with zero dependencies — reusable in API, workers, and frontend.
+ */
+declare const SATISFACTION_WEIGHTS: {
+  readonly rating: 0.4;
+  readonly sentiment: 0.25;
+  readonly responseTime: 0.2;
+  readonly resolution: 0.15;
+};
+declare const DEFAULT_SATISFACTION_SCORE = 50;
+/**
+ * Calculate response time score based on median response time.
+ * Faster responses = higher score.
+ */
+declare function calculateResponseTimeScore(medianSeconds: number | null): number | null;
+/**
+ * Calculate composite satisfaction index from multiple signals.
+ * Falls back to DEFAULT_SATISFACTION_SCORE when individual signals are missing.
+ */
+declare function calculateSatisfactionIndex(scores: {
+  ratingScore: number | null;
+  sentimentScore: number | null;
+  responseTimeScore: number | null;
+  resolutionScore: number | null;
+}): number;
+//#endregion
+export { DEFAULT_SATISFACTION_SCORE, SATISFACTION_WEIGHTS, calculateResponseTimeScore, calculateSatisfactionIndex };
+//# sourceMappingURL=analytics.d.ts.map

package/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","names":[],"sources":["../src/analytics.ts"],"sourcesContent":[],"mappings":";;AAMA;AAOA;AAMA;AA6BA;cA1Ca;;;;;;cAOA,0BAAA;;;;;iBAMG,0BAAA;;;;;iBA6BA,0BAAA"}

package/analytics.js

@@ -0,0 +1,41 @@
+//#region src/analytics.ts
+/**
+* Shared satisfaction index calculation.
+*
+* Pure functions with zero dependencies — reusable in API, workers, and frontend.
+*/
+const SATISFACTION_WEIGHTS = {
+	rating: .4,
+	sentiment: .25,
+	responseTime: .2,
+	resolution: .15
+};
+const DEFAULT_SATISFACTION_SCORE = 50;
+/**
+* Calculate response time score based on median response time.
+* Faster responses = higher score.
+*/
+function calculateResponseTimeScore(medianSeconds) {
+	if (medianSeconds === null) return null;
+	if (medianSeconds <= 300) return 100;
+	if (medianSeconds <= 900) return 85;
+	if (medianSeconds <= 3600) return 70;
+	if (medianSeconds <= 14400) return 50;
+	if (medianSeconds <= 86400) return 30;
+	return 10;
+}
+/**
+* Calculate composite satisfaction index from multiple signals.
+* Falls back to DEFAULT_SATISFACTION_SCORE when individual signals are missing.
+*/
+function calculateSatisfactionIndex(scores) {
+	const rating = scores.ratingScore ?? DEFAULT_SATISFACTION_SCORE;
+	const sentiment = scores.sentimentScore ?? DEFAULT_SATISFACTION_SCORE;
+	const responseTime = scores.responseTimeScore ?? DEFAULT_SATISFACTION_SCORE;
+	const resolution = scores.resolutionScore ?? DEFAULT_SATISFACTION_SCORE;
+	return SATISFACTION_WEIGHTS.rating * rating + SATISFACTION_WEIGHTS.sentiment * sentiment + SATISFACTION_WEIGHTS.responseTime * responseTime + SATISFACTION_WEIGHTS.resolution * resolution;
+}
+
+//#endregion
+export { DEFAULT_SATISFACTION_SCORE, SATISFACTION_WEIGHTS, calculateResponseTimeScore, calculateSatisfactionIndex };
+//# sourceMappingURL=analytics.js.map

package/analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.js","names":[],"sources":["../src/analytics.ts"],"sourcesContent":["/**\n * Shared satisfaction index calculation.\n *\n * Pure functions with zero dependencies — reusable in API, workers, and frontend.\n */\n\nexport const SATISFACTION_WEIGHTS = {\n\trating: 0.4,\n\tsentiment: 0.25,\n\tresponseTime: 0.2,\n\tresolution: 0.15,\n} as const;\n\nexport const DEFAULT_SATISFACTION_SCORE = 50;\n\n/**\n * Calculate response time score based on median response time.\n * Faster responses = higher score.\n */\nexport function calculateResponseTimeScore(\n\tmedianSeconds: number | null\n): number | null {\n\tif (medianSeconds === null) {\n\t\treturn null;\n\t}\n\n\tif (medianSeconds <= 300) {\n\t\treturn 100; // ≤5 min\n\t}\n\tif (medianSeconds <= 900) {\n\t\treturn 85; // ≤15 min\n\t}\n\tif (medianSeconds <= 3600) {\n\t\treturn 70; // ≤1 hour\n\t}\n\tif (medianSeconds <= 14_400) {\n\t\treturn 50; // ≤4 hours\n\t}\n\tif (medianSeconds <= 86_400) {\n\t\treturn 30; // ≤24 hours\n\t}\n\treturn 10; // >24 hours\n}\n\n/**\n * Calculate composite satisfaction index from multiple signals.\n * Falls back to DEFAULT_SATISFACTION_SCORE when individual signals are missing.\n */\nexport function calculateSatisfactionIndex(scores: {\n\tratingScore: number | null;\n\tsentimentScore: number | null;\n\tresponseTimeScore: number | null;\n\tresolutionScore: number | null;\n}): number {\n\tconst rating = scores.ratingScore ?? DEFAULT_SATISFACTION_SCORE;\n\tconst sentiment = scores.sentimentScore ?? DEFAULT_SATISFACTION_SCORE;\n\tconst responseTime = scores.responseTimeScore ?? DEFAULT_SATISFACTION_SCORE;\n\tconst resolution = scores.resolutionScore ?? DEFAULT_SATISFACTION_SCORE;\n\n\treturn (\n\t\tSATISFACTION_WEIGHTS.rating * rating +\n\t\tSATISFACTION_WEIGHTS.sentiment * sentiment +\n\t\tSATISFACTION_WEIGHTS.responseTime * responseTime +\n\t\tSATISFACTION_WEIGHTS.resolution * resolution\n\t);\n}\n"],"mappings":";;;;;;AAMA,MAAa,uBAAuB;CACnC,QAAQ;CACR,WAAW;CACX,cAAc;CACd,YAAY;CACZ;AAED,MAAa,6BAA6B;;;;;AAM1C,SAAgB,2BACf,eACgB;AAChB,KAAI,kBAAkB,KACrB,QAAO;AAGR,KAAI,iBAAiB,IACpB,QAAO;AAER,KAAI,iBAAiB,IACpB,QAAO;AAER,KAAI,iBAAiB,KACpB,QAAO;AAER,KAAI,iBAAiB,MACpB,QAAO;AAER,KAAI,iBAAiB,MACpB,QAAO;AAER,QAAO;;;;;;AAOR,SAAgB,2BAA2B,QAKhC;CACV,MAAM,SAAS,OAAO,eAAe;CACrC,MAAM,YAAY,OAAO,kBAAkB;CAC3C,MAAM,eAAe,OAAO,qBAAqB;CACjD,MAAM,aAAa,OAAO,mBAAmB;AAE7C,QACC,qBAAqB,SAAS,SAC9B,qBAAqB,YAAY,YACjC,qBAAqB,eAAe,eACpC,qBAAqB,aAAa"}

package/api/ai-agent-capabilities.d.ts

@@ -1,37 +1,34 @@
 //#region src/api/ai-agent-capabilities.d.ts
 declare const AI_AGENT_TOOL_CATEGORIES: readonly ["system", "messaging", "action", "context", "analysis"];
 type AiAgentToolCategory = (typeof AI_AGENT_TOOL_CATEGORIES)[number];
-declare const AI_AGENT_TOOL_IDS: readonly ["searchKnowledgeBase", "identifyVisitor", "updateConversationTitle", "updateSentiment", "setPriority", "sendMessage", "sendPrivateMessage", "respond", "escalate", "resolve", "markSpam", "skip"];
+declare const AI_AGENT_TOOL_GROUPS: readonly ["behavior", "actions"];
+type AiAgentToolGroup = (typeof AI_AGENT_TOOL_GROUPS)[number];
+declare const AI_AGENT_TOOL_IDS: readonly ["searchKnowledgeBase", "identifyVisitor", "updateConversationTitle", "updateSentiment", "setPriority", "categorizeConversation", "sendMessage", "sendPrivateMessage", "respond", "escalate", "resolve", "markSpam", "skip"];
 type AiAgentToolId = (typeof AI_AGENT_TOOL_IDS)[number];
-declare const AI_AGENT_BEHAVIOR_SETTING_KEYS: readonly ["canResolve", "canMarkSpam", "canSetPriority", "canEscalate", "autoGenerateTitle", "autoAnalyzeSentiment"];
+declare const AI_AGENT_BEHAVIOR_SETTING_KEYS: readonly ["canResolve", "canMarkSpam", "canSetPriority", "canEscalate", "autoCategorize", "autoGenerateTitle", "autoAnalyzeSentiment"];
 type AiAgentBehaviorSettingKey = (typeof AI_AGENT_BEHAVIOR_SETTING_KEYS)[number];
+type AiAgentToolDefaultSkill = {
+  name: string;
+  label: string;
+  description: string;
+  content: string;
+};
 type AiAgentToolCatalogEntry = {
   id: AiAgentToolId;
   label: string;
   description: string;
   category: AiAgentToolCategory;
+  group: AiAgentToolGroup;
+  order: number;
   isSystem: boolean;
   isRequired: boolean;
   isToggleable: boolean;
   behaviorSettingKey: AiAgentBehaviorSettingKey | null;
-  defaultTemplateNames: string[];
+  defaultSkill: AiAgentToolDefaultSkill;
 };
 declare const AI_AGENT_TOOL_CATALOG: readonly AiAgentToolCatalogEntry[];
-type AiAgentDefaultSkillTemplateEntry = {
-  name: string;
-  label: string;
-  description: string;
-  content: string;
-  suggestedToolIds: readonly AiAgentToolId[];
-};
-declare const AI_AGENT_DEFAULT_SKILL_TEMPLATES: readonly AiAgentDefaultSkillTemplateEntry[];
-type AiAgentDefaultSkillTemplate = (typeof AI_AGENT_DEFAULT_SKILL_TEMPLATES)[number];
-type AiAgentSystemSkillMetadataEntry = {
-  name: "agent.md" | "security.md" | "behaviour.md" | "participation.md" | "grounding.md" | "capabilities.md";
-  label: string;
-  description: string;
-};
-declare const AI_AGENT_SYSTEM_SKILL_METADATA: readonly AiAgentSystemSkillMetadataEntry[];
+declare const AI_AGENT_RESERVED_TOOL_SKILL_TEMPLATE_NAMES: readonly string[];
+declare const AI_AGENT_DROPPED_SKILL_TEMPLATE_NAMES: readonly ["reply-or-stay-silent.md", "send-message-behavior.md", "deep-research.md", "grounded-answers.md", "visitor-identification.md", "escalation-playbook.md", "resolution-checklist.md", "spam-detection.md", "priority-triage.md", "sentiment-tracking.md", "title-hygiene.md", "handoff-notes.md", "tone-and-voice.md", "short-clear-replies.md", "wait.md"];
 //#endregion
-export { AI_AGENT_BEHAVIOR_SETTING_KEYS, AI_AGENT_DEFAULT_SKILL_TEMPLATES, AI_AGENT_SYSTEM_SKILL_METADATA, AI_AGENT_TOOL_CATALOG, AI_AGENT_TOOL_CATEGORIES, AI_AGENT_TOOL_IDS, AiAgentBehaviorSettingKey, AiAgentDefaultSkillTemplate, AiAgentSystemSkillMetadataEntry, AiAgentToolCatalogEntry, AiAgentToolCategory, AiAgentToolId };
+export { AI_AGENT_BEHAVIOR_SETTING_KEYS, AI_AGENT_DROPPED_SKILL_TEMPLATE_NAMES, AI_AGENT_RESERVED_TOOL_SKILL_TEMPLATE_NAMES, AI_AGENT_TOOL_CATALOG, AI_AGENT_TOOL_CATEGORIES, AI_AGENT_TOOL_GROUPS, AI_AGENT_TOOL_IDS, AiAgentBehaviorSettingKey, AiAgentToolCatalogEntry, AiAgentToolCategory, AiAgentToolDefaultSkill, AiAgentToolGroup, AiAgentToolId };
 //# sourceMappingURL=ai-agent-capabilities.d.ts.map

package/api/ai-agent-capabilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-agent-capabilities.d.ts","names":[],"sources":["../../src/api/ai-agent-capabilities.ts"],"sourcesContent":[],"mappings":";cAKa;AAAA,KAQD,mBAAA,GAFF,CAAA,OAEgC,wBAFhC,CAAA,CAAA,MAAA,CAAA;AAEE,cAEC,iBAFkB,EAAW,SAAA,CAAA,qBAAwB,EAAA,iBAAA,EAAA,yBAAA,EAAA,iBAAA,EAAA,aAAA,EAAA,aAAA,EAAA,oBAAA,EAAA,SAAA,EAAA,UAAA,EAAA,SAAA,EAAA,UAAA,EAAA,MAAA,CAAA;AAErD,KAeD,aAAA,GAFF,CAAA,OAE0B,iBAF1B,CAAA,CAAA,MAAA,CAAA;AAEE,cAEC,8BAFwC,EAAA,SAAA,CAAA,YAAA,EAAA,aAAA,EAAA,gBAAA,EAAA,aAAA,EAAA,mBAAA,EAAA,sBAAA,CAAA;AAExC,KASD,yBAAA,GAFF,CAAA,OAGD,8BAHC,CAAA,CAAA,MAAA,CAAA;AAEE,KAGA,uBAAA,GAHyB;EAGzB,EAAA,EACP,aADO;EACP,KAAA,EAAA,MAAA;EAGM,WAAA,EAAA,MAAA;EAIU,QAAA,EAJV,mBAIU;EAAyB,QAAA,EAAA,OAAA;EAIjC,UAAA,EAAA,OAAA;EAgXR,YAAA,EAAA,OAAA;EAQQ,kBAAA,EA5XQ,yBAoYjB,GARoD,IAAA;EAU5C,oBAAA,EAAA,MAAA,EAA2B;AAGvC,CAAA;AAYa,cAjZA,qBAqbX,EAAA,SArb2C,uBAiZS,EAAA;KAjCjD,gCAAA;;;;;6BAKuB;;cAGf,2CAA2C;KAU5C,2BAAA,WACH;KAEG,+BAAA;;;;;cAYC,yCAAyC"}
+{"version":3,"file":"ai-agent-capabilities.d.ts","names":[],"sources":["../../src/api/ai-agent-capabilities.ts"],"sourcesContent":[],"mappings":";cAKa;AAAA,KAQD,mBAAA,GAFF,CAAA,OAEgC,wBAFhC,CAAA,CAAA,MAAA,CAAA;AAEE,cAEC,oBAF6B,EAAA,SAAA,CAAA,UAAA,EAAwB,SAAA,CAAA;AAErD,KACD,gBAAA,GADwD,CAAA,OAC7B,oBAD6B,CAAA,CAAA,MAAA,CAAA;AACxD,cAEC,iBAF0B,EAAA,SAAA,CAAA,qBAAoB,EAAA,iBAAA,EAAA,yBAAA,EAAA,iBAAA,EAAA,aAAA,EAAA,wBAAA,EAAA,aAAA,EAAA,oBAAA,EAAA,SAAA,EAAA,UAAA,EAAA,SAAA,EAAA,UAAA,EAAA,MAAA,CAAA;AAE9C,KAgBD,aAAA,GAFF,CAAA,OAE0B,iBAF1B,CAAA,CAAA,MAAA,CAAA;AAEE,cAEC,8BAFwC,EAAA,SAAA,CAAA,YAAA,EAAA,aAAA,EAAA,gBAAA,EAAA,aAAA,EAAA,gBAAA,EAAA,mBAAA,EAAA,sBAAA,CAAA;AAExC,KAUD,yBAAA,GAFF,CAAA,OAGD,8BAHC,CAAA,CAAA,MAAA,CAAA;AAEE,KAGA,uBAAA,GAHyB;EAGzB,IAAA,EAAA,MAAA;EAOA,KAAA,EAAA,MAAA;EACP,WAAA,EAAA,MAAA;EAGM,OAAA,EAAA,MAAA;CACH;AAKa,KAVT,uBAAA,GAUS;EACN,EAAA,EAVV,aAUU;EAAuB,KAAA,EAAA,MAAA;EAiTzB,WAAA,EAAA,MAAA;EAaA,QAAA,EArUF,mBAqUE;EAIA,KAAA,EAxUL,gBAwUK;;;;;sBAnUQ;gBACN;;cAiTF,gCAAgC;cAahC;cAIA"}