@cossistant/types 0.0.33 → 0.1.0

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

@@ -0,0 +1,37 @@
+//#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"];
+type AiAgentToolId = (typeof AI_AGENT_TOOL_IDS)[number];
+declare const AI_AGENT_BEHAVIOR_SETTING_KEYS: readonly ["canResolve", "canMarkSpam", "canSetPriority", "canEscalate", "autoGenerateTitle", "autoAnalyzeSentiment"];
+type AiAgentBehaviorSettingKey = (typeof AI_AGENT_BEHAVIOR_SETTING_KEYS)[number];
+type AiAgentToolCatalogEntry = {
+  id: AiAgentToolId;
+  label: string;
+  description: string;
+  category: AiAgentToolCategory;
+  isSystem: boolean;
+  isRequired: boolean;
+  isToggleable: boolean;
+  behaviorSettingKey: AiAgentBehaviorSettingKey | null;
+  defaultTemplateNames: string[];
+};
+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[];
+//#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 };
+//# sourceMappingURL=ai-agent-capabilities.d.ts.map

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

@@ -0,0 +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"}

package/api/ai-agent-capabilities.js

@@ -0,0 +1,432 @@
+import { serializeSkillFileContent, stripSkillMarkdownExtension } from "../skill-file-format.js";
+
+//#region src/api/ai-agent-capabilities.ts
+const AI_AGENT_TOOL_CATEGORIES = [
+	"system",
+	"messaging",
+	"action",
+	"context",
+	"analysis"
+];
+const AI_AGENT_TOOL_IDS = [
+	"searchKnowledgeBase",
+	"identifyVisitor",
+	"updateConversationTitle",
+	"updateSentiment",
+	"setPriority",
+	"sendMessage",
+	"sendPrivateMessage",
+	"respond",
+	"escalate",
+	"resolve",
+	"markSpam",
+	"skip"
+];
+const AI_AGENT_BEHAVIOR_SETTING_KEYS = [
+	"canResolve",
+	"canMarkSpam",
+	"canSetPriority",
+	"canEscalate",
+	"autoGenerateTitle",
+	"autoAnalyzeSentiment"
+];
+const AI_AGENT_TOOL_CATALOG = [
+	{
+		id: "searchKnowledgeBase",
+		label: "Search Knowledge Base",
+		description: "Looks up product or policy facts in your trained knowledge before answering.",
+		category: "context",
+		isSystem: true,
+		isRequired: true,
+		isToggleable: false,
+		behaviorSettingKey: null,
+		defaultTemplateNames: ["deep-research.md", "grounded-answers.md"]
+	},
+	{
+		id: "identifyVisitor",
+		label: "Identify Visitor",
+		description: "Links visitor details to a contact record when name and email are collected.",
+		category: "context",
+		isSystem: true,
+		isRequired: true,
+		isToggleable: false,
+		behaviorSettingKey: null,
+		defaultTemplateNames: ["visitor-identification.md"]
+	},
+	{
+		id: "updateConversationTitle",
+		label: "Update Conversation Title",
+		description: "Sets or refreshes the conversation title once the topic is clear.",
+		category: "analysis",
+		isSystem: false,
+		isRequired: false,
+		isToggleable: true,
+		behaviorSettingKey: "autoGenerateTitle",
+		defaultTemplateNames: ["title-hygiene.md"]
+	},
+	{
+		id: "updateSentiment",
+		label: "Update Sentiment",
+		description: "Tracks tone shifts and keeps conversation sentiment metadata up to date.",
+		category: "analysis",
+		isSystem: false,
+		isRequired: false,
+		isToggleable: true,
+		behaviorSettingKey: "autoAnalyzeSentiment",
+		defaultTemplateNames: ["sentiment-tracking.md"]
+	},
+	{
+		id: "setPriority",
+		label: "Set Priority",
+		description: "Adjusts urgency level for critical issues so teams can triage quickly.",
+		category: "analysis",
+		isSystem: false,
+		isRequired: false,
+		isToggleable: true,
+		behaviorSettingKey: "canSetPriority",
+		defaultTemplateNames: ["priority-triage.md"]
+	},
+	{
+		id: "sendMessage",
+		label: "Send Public Message",
+		description: "Sends a visible reply to the visitor.",
+		category: "messaging",
+		isSystem: true,
+		isRequired: true,
+		isToggleable: false,
+		behaviorSettingKey: null,
+		defaultTemplateNames: ["tone-and-voice.md", "short-clear-replies.md"]
+	},
+	{
+		id: "sendPrivateMessage",
+		label: "Send Private Note",
+		description: "Adds internal-only notes for teammates that visitors cannot see.",
+		category: "messaging",
+		isSystem: true,
+		isRequired: true,
+		isToggleable: false,
+		behaviorSettingKey: null,
+		defaultTemplateNames: ["handoff-notes.md"]
+	},
+	{
+		id: "respond",
+		label: "Finish: Respond",
+		description: "Marks turn complete after responding to the visitor.",
+		category: "action",
+		isSystem: true,
+		isRequired: true,
+		isToggleable: false,
+		behaviorSettingKey: null,
+		defaultTemplateNames: ["reply-or-stay-silent.md"]
+	},
+	{
+		id: "escalate",
+		label: "Finish: Escalate",
+		description: "Hands off the conversation to a human agent when needed.",
+		category: "action",
+		isSystem: false,
+		isRequired: false,
+		isToggleable: true,
+		behaviorSettingKey: "canEscalate",
+		defaultTemplateNames: ["escalation-playbook.md"]
+	},
+	{
+		id: "resolve",
+		label: "Finish: Resolve",
+		description: "Marks the conversation as resolved when it is fully handled.",
+		category: "action",
+		isSystem: false,
+		isRequired: false,
+		isToggleable: true,
+		behaviorSettingKey: "canResolve",
+		defaultTemplateNames: ["resolution-checklist.md"]
+	},
+	{
+		id: "markSpam",
+		label: "Finish: Mark Spam",
+		description: "Flags obvious spam or abuse and closes the conversation.",
+		category: "action",
+		isSystem: false,
+		isRequired: false,
+		isToggleable: true,
+		behaviorSettingKey: "canMarkSpam",
+		defaultTemplateNames: ["spam-detection.md"]
+	},
+	{
+		id: "skip",
+		label: "Finish: Skip",
+		description: "Intentionally stays silent when no response is needed from AI.",
+		category: "action",
+		isSystem: true,
+		isRequired: true,
+		isToggleable: false,
+		behaviorSettingKey: null,
+		defaultTemplateNames: ["reply-or-stay-silent.md"]
+	}
+];
+const AI_AGENT_DEFAULT_SKILL_TEMPLATE_DEFINITIONS = [
+	{
+		name: "reply-or-stay-silent.md",
+		label: "Reply Or Stay Silent",
+		description: "Defines when the AI should answer and when it should intentionally stay silent.",
+		content: `## Reply Decision
+
+- Reply when the visitor still needs a clear, concrete answer.
+- Stay silent when a human already answered well or when the message is only acknowledgement.
+- If unsure whether to reply, prefer one short helpful message over multiple partial replies.
+
+## Tool Notes
+
+- Use [@Send Public Message](mention:tool:sendMessage) only when a reply adds value.
+- Finish with [@Finish: Respond](mention:tool:respond) after replying.
+- Use [@Finish: Skip](mention:tool:skip) when no reply is required.`,
+		suggestedToolIds: [
+			"sendMessage",
+			"respond",
+			"skip"
+		]
+	},
+	{
+		name: "tone-and-voice.md",
+		label: "Tone And Voice",
+		description: "Keeps replies concise, empathetic, and aligned with a support tone.",
+		content: `## Tone
+
+- Be concise, direct, and calm.
+- Prefer plain language over jargon.
+- Keep messages to 1-2 short sentences when possible.
+
+## Empathy
+
+- Acknowledge frustration without over-apologizing.
+- Focus on the next useful action.
+
+## Tool Notes
+
+- Send customer-visible text through [@Send Public Message](mention:tool:sendMessage).`,
+		suggestedToolIds: ["sendMessage"]
+	},
+	{
+		name: "short-clear-replies.md",
+		label: "Short Clear Replies",
+		description: "Enforces short, structured customer-facing responses.",
+		content: `## Message Shape
+
+- First sentence: direct answer.
+- Optional second sentence: next step or clarifying question.
+- Avoid multi-paragraph replies unless the question is complex.
+
+## Tool Notes
+
+- Send the final customer reply with [@Send Public Message](mention:tool:sendMessage).`,
+		suggestedToolIds: ["sendMessage"]
+	},
+	{
+		name: "deep-research.md",
+		label: "Deep Research",
+		description: "Guides multi-pass retrieval before giving factual or policy answers.",
+		content: `## Research Workflow
+
+- For factual/product/policy questions, search before answering.
+- Start with a short focused query, then broaden if needed.
+- Use at least one follow-up search if confidence is low.
+
+## Tool Notes
+
+- Use [@Search Knowledge Base](mention:tool:searchKnowledgeBase) for retrieval.
+- Only send final claims after grounding them in retrieved context.`,
+		suggestedToolIds: ["searchKnowledgeBase"]
+	},
+	{
+		name: "grounded-answers.md",
+		label: "Grounded Answers",
+		description: "Prevents hallucinations and enforces transparent uncertainty.",
+		content: `## Grounding Rules
+
+- Do not invent product, policy, or pricing details.
+- If information is missing, say so clearly and offer escalation.
+- Prefer partial certainty over confident guessing.
+
+## Tool Notes
+
+- Validate facts with [@Search Knowledge Base](mention:tool:searchKnowledgeBase).
+- If unsupported, use [@Finish: Escalate](mention:tool:escalate) when available.`,
+		suggestedToolIds: ["searchKnowledgeBase", "escalate"]
+	},
+	{
+		name: "visitor-identification.md",
+		label: "Visitor Identification",
+		description: "Controls when and how to request name/email and identify the visitor.",
+		content: `## Identification Policy
+
+- Ask for name and email only when needed for account-specific help.
+- Validate that the name field contains a name and email field contains an email.
+- Update details if the visitor corrects their information.
+
+## Tool Notes
+
+- Link identity with [@Identify Visitor](mention:tool:identifyVisitor).`,
+		suggestedToolIds: ["identifyVisitor"]
+	},
+	{
+		name: "escalation-playbook.md",
+		label: "Escalation Playbook",
+		description: "Defines when escalation is mandatory and what to include in handoff.",
+		content: `## Escalate When
+
+- The visitor asks for a human.
+- You cannot find reliable information.
+- Legal, compliance, billing, or high-risk judgment is required.
+
+## Handoff Quality
+
+- Tell the visitor what happens next.
+- Leave concise internal context for teammates.
+
+## Tool Notes
+
+- Notify visitor with [@Send Public Message](mention:tool:sendMessage).
+- Add handoff context via [@Send Private Note](mention:tool:sendPrivateMessage).
+- Finish with [@Finish: Escalate](mention:tool:escalate).`,
+		suggestedToolIds: [
+			"sendMessage",
+			"sendPrivateMessage",
+			"escalate"
+		]
+	},
+	{
+		name: "resolution-checklist.md",
+		label: "Resolution Checklist",
+		description: "Ensures conversations are only resolved after clear completion criteria.",
+		content: `## Resolve Criteria
+
+- The visitor's request is fully addressed.
+- No unresolved dependency remains.
+- The final response includes a clear closure.
+
+## Tool Notes
+
+- Send closure text with [@Send Public Message](mention:tool:sendMessage).
+- Finish with [@Finish: Resolve](mention:tool:resolve).`,
+		suggestedToolIds: ["sendMessage", "resolve"]
+	},
+	{
+		name: "spam-detection.md",
+		label: "Spam Detection",
+		description: "Sets strict criteria for spam classification.",
+		content: `## Spam Heuristics
+
+- Mark as spam only for obvious bot, phishing, or abusive noise.
+- Do not mark difficult but valid customer requests as spam.
+
+## Tool Notes
+
+- Use [@Finish: Mark Spam](mention:tool:markSpam) only when highly confident.`,
+		suggestedToolIds: ["markSpam"]
+	},
+	{
+		name: "priority-triage.md",
+		label: "Priority Triage",
+		description: "Standardizes urgency assignment for incoming issues.",
+		content: `## Priority Rules
+
+- Urgent: outages, security incidents, severe business impact.
+- High: blocked workflow with no workaround.
+- Normal: standard product support requests.
+- Low: informational or minor questions.
+
+## Tool Notes
+
+- Set urgency with [@Set Priority](mention:tool:setPriority).`,
+		suggestedToolIds: ["setPriority"]
+	},
+	{
+		name: "sentiment-tracking.md",
+		label: "Sentiment Tracking",
+		description: "Encourages sentiment updates when tone changes.",
+		content: `## Sentiment Updates
+
+- Update sentiment when tone shifts meaningfully.
+- Keep reason short and factual.
+- Avoid over-updating on minor wording changes.
+
+## Tool Notes
+
+- Record tone with [@Update Sentiment](mention:tool:updateSentiment).`,
+		suggestedToolIds: ["updateSentiment"]
+	},
+	{
+		name: "title-hygiene.md",
+		label: "Title Hygiene",
+		description: "Keeps conversation titles clear and actionable.",
+		content: `## Title Standards
+
+- Keep titles short and specific.
+- Reflect the primary issue, not generic phrases.
+- Update title if topic changes significantly.
+
+## Tool Notes
+
+- Use [@Update Conversation Title](mention:tool:updateConversationTitle).`,
+		suggestedToolIds: ["updateConversationTitle"]
+	},
+	{
+		name: "handoff-notes.md",
+		label: "Handoff Notes",
+		description: "Improves private notes shared with human teammates.",
+		content: `## Private Note Checklist
+
+- Include issue summary, key facts, and what was already tried.
+- Add urgency and expected next action.
+- Keep notes scannable and concise.
+
+## Tool Notes
+
+- Send internal details with [@Send Private Note](mention:tool:sendPrivateMessage).`,
+		suggestedToolIds: ["sendPrivateMessage"]
+	}
+];
+const AI_AGENT_DEFAULT_SKILL_TEMPLATES = AI_AGENT_DEFAULT_SKILL_TEMPLATE_DEFINITIONS.map((template) => ({
+	...template,
+	content: serializeSkillFileContent({
+		name: stripSkillMarkdownExtension(template.name),
+		description: template.description,
+		body: template.content
+	})
+}));
+const AI_AGENT_SYSTEM_SKILL_METADATA = [
+	{
+		name: "agent.md",
+		label: "Agent Identity",
+		description: "Core role, persona, and mission of the assistant."
+	},
+	{
+		name: "security.md",
+		label: "Security Guardrails",
+		description: "Critical safety and confidentiality rules that should stay strict."
+	},
+	{
+		name: "behaviour.md",
+		label: "Behavior Policy",
+		description: "Runtime behavior and mode-specific operating guidance."
+	},
+	{
+		name: "participation.md",
+		label: "Participation Policy",
+		description: "Rules for when AI should participate versus intentionally stay silent."
+	},
+	{
+		name: "grounding.md",
+		label: "Grounding Policy",
+		description: "Instructions for factual grounding and knowledge retrieval discipline."
+	},
+	{
+		name: "capabilities.md",
+		label: "Capabilities Contract",
+		description: "Capability boundaries and references to optional behavior skills."
+	}
+];
+
+//#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 };
+//# sourceMappingURL=ai-agent-capabilities.js.map

package/api/ai-agent-capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-agent-capabilities.js","names":["AI_AGENT_TOOL_CATALOG: readonly AiAgentToolCatalogEntry[]","AI_AGENT_DEFAULT_SKILL_TEMPLATES: readonly AiAgentDefaultSkillTemplateEntry[]","AI_AGENT_SYSTEM_SKILL_METADATA: readonly AiAgentSystemSkillMetadataEntry[]"],"sources":["../../src/api/ai-agent-capabilities.ts"],"sourcesContent":["import {\n\tserializeSkillFileContent,\n\tstripSkillMarkdownExtension,\n} from \"../skill-file-format\";\n\nexport const AI_AGENT_TOOL_CATEGORIES = [\n\t\"system\",\n\t\"messaging\",\n\t\"action\",\n\t\"context\",\n\t\"analysis\",\n] as const;\n\nexport type AiAgentToolCategory = (typeof AI_AGENT_TOOL_CATEGORIES)[number];\n\nexport const AI_AGENT_TOOL_IDS = [\n\t\"searchKnowledgeBase\",\n\t\"identifyVisitor\",\n\t\"updateConversationTitle\",\n\t\"updateSentiment\",\n\t\"setPriority\",\n\t\"sendMessage\",\n\t\"sendPrivateMessage\",\n\t\"respond\",\n\t\"escalate\",\n\t\"resolve\",\n\t\"markSpam\",\n\t\"skip\",\n] as const;\n\nexport type AiAgentToolId = (typeof AI_AGENT_TOOL_IDS)[number];\n\nexport const AI_AGENT_BEHAVIOR_SETTING_KEYS = [\n\t\"canResolve\",\n\t\"canMarkSpam\",\n\t\"canSetPriority\",\n\t\"canEscalate\",\n\t\"autoGenerateTitle\",\n\t\"autoAnalyzeSentiment\",\n] as const;\n\nexport type AiAgentBehaviorSettingKey =\n\t(typeof AI_AGENT_BEHAVIOR_SETTING_KEYS)[number];\n\nexport type AiAgentToolCatalogEntry = {\n\tid: AiAgentToolId;\n\tlabel: string;\n\tdescription: string;\n\tcategory: AiAgentToolCategory;\n\tisSystem: boolean;\n\tisRequired: boolean;\n\tisToggleable: boolean;\n\tbehaviorSettingKey: AiAgentBehaviorSettingKey | null;\n\tdefaultTemplateNames: string[];\n};\n\nexport const AI_AGENT_TOOL_CATALOG: readonly AiAgentToolCatalogEntry[] = [\n\t{\n\t\tid: \"searchKnowledgeBase\",\n\t\tlabel: \"Search Knowledge Base\",\n\t\tdescription:\n\t\t\t\"Looks up product or policy facts in your trained knowledge before answering.\",\n\t\tcategory: \"context\",\n\t\tisSystem: true,\n\t\tisRequired: true,\n\t\tisToggleable: false,\n\t\tbehaviorSettingKey: null,\n\t\tdefaultTemplateNames: [\"deep-research.md\", \"grounded-answers.md\"],\n\t},\n\t{\n\t\tid: \"identifyVisitor\",\n\t\tlabel: \"Identify Visitor\",\n\t\tdescription:\n\t\t\t\"Links visitor details to a contact record when name and email are collected.\",\n\t\tcategory: \"context\",\n\t\tisSystem: true,\n\t\tisRequired: true,\n\t\tisToggleable: false,\n\t\tbehaviorSettingKey: null,\n\t\tdefaultTemplateNames: [\"visitor-identification.md\"],\n\t},\n\t{\n\t\tid: \"updateConversationTitle\",\n\t\tlabel: \"Update Conversation Title\",\n\t\tdescription:\n\t\t\t\"Sets or refreshes the conversation title once the topic is clear.\",\n\t\tcategory: \"analysis\",\n\t\tisSystem: false,\n\t\tisRequired: false,\n\t\tisToggleable: true,\n\t\tbehaviorSettingKey: \"autoGenerateTitle\",\n\t\tdefaultTemplateNames: [\"title-hygiene.md\"],\n\t},\n\t{\n\t\tid: \"updateSentiment\",\n\t\tlabel: \"Update Sentiment\",\n\t\tdescription:\n\t\t\t\"Tracks tone shifts and keeps conversation sentiment metadata up to date.\",\n\t\tcategory: \"analysis\",\n\t\tisSystem: false,\n\t\tisRequired: false,\n\t\tisToggleable: true,\n\t\tbehaviorSettingKey: \"autoAnalyzeSentiment\",\n\t\tdefaultTemplateNames: [\"sentiment-tracking.md\"],\n\t},\n\t{\n\t\tid: \"setPriority\",\n\t\tlabel: \"Set Priority\",\n\t\tdescription:\n\t\t\t\"Adjusts urgency level for critical issues so teams can triage quickly.\",\n\t\tcategory: \"analysis\",\n\t\tisSystem: false,\n\t\tisRequired: false,\n\t\tisToggleable: true,\n\t\tbehaviorSettingKey: \"canSetPriority\",\n\t\tdefaultTemplateNames: [\"priority-triage.md\"],\n\t},\n\t{\n\t\tid: \"sendMessage\",\n\t\tlabel: \"Send Public Message\",\n\t\tdescription: \"Sends a visible reply to the visitor.\",\n\t\tcategory: \"messaging\",\n\t\tisSystem: true,\n\t\tisRequired: true,\n\t\tisToggleable: false,\n\t\tbehaviorSettingKey: null,\n\t\tdefaultTemplateNames: [\"tone-and-voice.md\", \"short-clear-replies.md\"],\n\t},\n\t{\n\t\tid: \"sendPrivateMessage\",\n\t\tlabel: \"Send Private Note\",\n\t\tdescription:\n\t\t\t\"Adds internal-only notes for teammates that visitors cannot see.\",\n\t\tcategory: \"messaging\",\n\t\tisSystem: true,\n\t\tisRequired: true,\n\t\tisToggleable: false,\n\t\tbehaviorSettingKey: null,\n\t\tdefaultTemplateNames: [\"handoff-notes.md\"],\n\t},\n\t{\n\t\tid: \"respond\",\n\t\tlabel: \"Finish: Respond\",\n\t\tdescription: \"Marks turn complete after responding to the visitor.\",\n\t\tcategory: \"action\",\n\t\tisSystem: true,\n\t\tisRequired: true,\n\t\tisToggleable: false,\n\t\tbehaviorSettingKey: null,\n\t\tdefaultTemplateNames: [\"reply-or-stay-silent.md\"],\n\t},\n\t{\n\t\tid: \"escalate\",\n\t\tlabel: \"Finish: Escalate\",\n\t\tdescription: \"Hands off the conversation to a human agent when needed.\",\n\t\tcategory: \"action\",\n\t\tisSystem: false,\n\t\tisRequired: false,\n\t\tisToggleable: true,\n\t\tbehaviorSettingKey: \"canEscalate\",\n\t\tdefaultTemplateNames: [\"escalation-playbook.md\"],\n\t},\n\t{\n\t\tid: \"resolve\",\n\t\tlabel: \"Finish: Resolve\",\n\t\tdescription: \"Marks the conversation as resolved when it is fully handled.\",\n\t\tcategory: \"action\",\n\t\tisSystem: false,\n\t\tisRequired: false,\n\t\tisToggleable: true,\n\t\tbehaviorSettingKey: \"canResolve\",\n\t\tdefaultTemplateNames: [\"resolution-checklist.md\"],\n\t},\n\t{\n\t\tid: \"markSpam\",\n\t\tlabel: \"Finish: Mark Spam\",\n\t\tdescription: \"Flags obvious spam or abuse and closes the conversation.\",\n\t\tcategory: \"action\",\n\t\tisSystem: false,\n\t\tisRequired: false,\n\t\tisToggleable: true,\n\t\tbehaviorSettingKey: \"canMarkSpam\",\n\t\tdefaultTemplateNames: [\"spam-detection.md\"],\n\t},\n\t{\n\t\tid: \"skip\",\n\t\tlabel: \"Finish: Skip\",\n\t\tdescription:\n\t\t\t\"Intentionally stays silent when no response is needed from AI.\",\n\t\tcategory: \"action\",\n\t\tisSystem: true,\n\t\tisRequired: true,\n\t\tisToggleable: false,\n\t\tbehaviorSettingKey: null,\n\t\tdefaultTemplateNames: [\"reply-or-stay-silent.md\"],\n\t},\n] as const;\n\nconst AI_AGENT_DEFAULT_SKILL_TEMPLATE_DEFINITIONS = [\n\t{\n\t\tname: \"reply-or-stay-silent.md\",\n\t\tlabel: \"Reply Or Stay Silent\",\n\t\tdescription:\n\t\t\t\"Defines when the AI should answer and when it should intentionally stay silent.\",\n\t\tcontent: `## Reply Decision\n\n- Reply when the visitor still needs a clear, concrete answer.\n- Stay silent when a human already answered well or when the message is only acknowledgement.\n- If unsure whether to reply, prefer one short helpful message over multiple partial replies.\n\n## Tool Notes\n\n- Use [@Send Public Message](mention:tool:sendMessage) only when a reply adds value.\n- Finish with [@Finish: Respond](mention:tool:respond) after replying.\n- Use [@Finish: Skip](mention:tool:skip) when no reply is required.`,\n\t\tsuggestedToolIds: [\"sendMessage\", \"respond\", \"skip\"] as const,\n\t},\n\t{\n\t\tname: \"tone-and-voice.md\",\n\t\tlabel: \"Tone And Voice\",\n\t\tdescription:\n\t\t\t\"Keeps replies concise, empathetic, and aligned with a support tone.\",\n\t\tcontent: `## Tone\n\n- Be concise, direct, and calm.\n- Prefer plain language over jargon.\n- Keep messages to 1-2 short sentences when possible.\n\n## Empathy\n\n- Acknowledge frustration without over-apologizing.\n- Focus on the next useful action.\n\n## Tool Notes\n\n- Send customer-visible text through [@Send Public Message](mention:tool:sendMessage).`,\n\t\tsuggestedToolIds: [\"sendMessage\"] as const,\n\t},\n\t{\n\t\tname: \"short-clear-replies.md\",\n\t\tlabel: \"Short Clear Replies\",\n\t\tdescription: \"Enforces short, structured customer-facing responses.\",\n\t\tcontent: `## Message Shape\n\n- First sentence: direct answer.\n- Optional second sentence: next step or clarifying question.\n- Avoid multi-paragraph replies unless the question is complex.\n\n## Tool Notes\n\n- Send the final customer reply with [@Send Public Message](mention:tool:sendMessage).`,\n\t\tsuggestedToolIds: [\"sendMessage\"] as const,\n\t},\n\t{\n\t\tname: \"deep-research.md\",\n\t\tlabel: \"Deep Research\",\n\t\tdescription:\n\t\t\t\"Guides multi-pass retrieval before giving factual or policy answers.\",\n\t\tcontent: `## Research Workflow\n\n- For factual/product/policy questions, search before answering.\n- Start with a short focused query, then broaden if needed.\n- Use at least one follow-up search if confidence is low.\n\n## Tool Notes\n\n- Use [@Search Knowledge Base](mention:tool:searchKnowledgeBase) for retrieval.\n- Only send final claims after grounding them in retrieved context.`,\n\t\tsuggestedToolIds: [\"searchKnowledgeBase\"] as const,\n\t},\n\t{\n\t\tname: \"grounded-answers.md\",\n\t\tlabel: \"Grounded Answers\",\n\t\tdescription:\n\t\t\t\"Prevents hallucinations and enforces transparent uncertainty.\",\n\t\tcontent: `## Grounding Rules\n\n- Do not invent product, policy, or pricing details.\n- If information is missing, say so clearly and offer escalation.\n- Prefer partial certainty over confident guessing.\n\n## Tool Notes\n\n- Validate facts with [@Search Knowledge Base](mention:tool:searchKnowledgeBase).\n- If unsupported, use [@Finish: Escalate](mention:tool:escalate) when available.`,\n\t\tsuggestedToolIds: [\"searchKnowledgeBase\", \"escalate\"] as const,\n\t},\n\t{\n\t\tname: \"visitor-identification.md\",\n\t\tlabel: \"Visitor Identification\",\n\t\tdescription:\n\t\t\t\"Controls when and how to request name/email and identify the visitor.\",\n\t\tcontent: `## Identification Policy\n\n- Ask for name and email only when needed for account-specific help.\n- Validate that the name field contains a name and email field contains an email.\n- Update details if the visitor corrects their information.\n\n## Tool Notes\n\n- Link identity with [@Identify Visitor](mention:tool:identifyVisitor).`,\n\t\tsuggestedToolIds: [\"identifyVisitor\"] as const,\n\t},\n\t{\n\t\tname: \"escalation-playbook.md\",\n\t\tlabel: \"Escalation Playbook\",\n\t\tdescription:\n\t\t\t\"Defines when escalation is mandatory and what to include in handoff.\",\n\t\tcontent: `## Escalate When\n\n- The visitor asks for a human.\n- You cannot find reliable information.\n- Legal, compliance, billing, or high-risk judgment is required.\n\n## Handoff Quality\n\n- Tell the visitor what happens next.\n- Leave concise internal context for teammates.\n\n## Tool Notes\n\n- Notify visitor with [@Send Public Message](mention:tool:sendMessage).\n- Add handoff context via [@Send Private Note](mention:tool:sendPrivateMessage).\n- Finish with [@Finish: Escalate](mention:tool:escalate).`,\n\t\tsuggestedToolIds: [\n\t\t\t\"sendMessage\",\n\t\t\t\"sendPrivateMessage\",\n\t\t\t\"escalate\",\n\t\t] as const,\n\t},\n\t{\n\t\tname: \"resolution-checklist.md\",\n\t\tlabel: \"Resolution Checklist\",\n\t\tdescription:\n\t\t\t\"Ensures conversations are only resolved after clear completion criteria.\",\n\t\tcontent: `## Resolve Criteria\n\n- The visitor's request is fully addressed.\n- No unresolved dependency remains.\n- The final response includes a clear closure.\n\n## Tool Notes\n\n- Send closure text with [@Send Public Message](mention:tool:sendMessage).\n- Finish with [@Finish: Resolve](mention:tool:resolve).`,\n\t\tsuggestedToolIds: [\"sendMessage\", \"resolve\"] as const,\n\t},\n\t{\n\t\tname: \"spam-detection.md\",\n\t\tlabel: \"Spam Detection\",\n\t\tdescription: \"Sets strict criteria for spam classification.\",\n\t\tcontent: `## Spam Heuristics\n\n- Mark as spam only for obvious bot, phishing, or abusive noise.\n- Do not mark difficult but valid customer requests as spam.\n\n## Tool Notes\n\n- Use [@Finish: Mark Spam](mention:tool:markSpam) only when highly confident.`,\n\t\tsuggestedToolIds: [\"markSpam\"] as const,\n\t},\n\t{\n\t\tname: \"priority-triage.md\",\n\t\tlabel: \"Priority Triage\",\n\t\tdescription: \"Standardizes urgency assignment for incoming issues.\",\n\t\tcontent: `## Priority Rules\n\n- Urgent: outages, security incidents, severe business impact.\n- High: blocked workflow with no workaround.\n- Normal: standard product support requests.\n- Low: informational or minor questions.\n\n## Tool Notes\n\n- Set urgency with [@Set Priority](mention:tool:setPriority).`,\n\t\tsuggestedToolIds: [\"setPriority\"] as const,\n\t},\n\t{\n\t\tname: \"sentiment-tracking.md\",\n\t\tlabel: \"Sentiment Tracking\",\n\t\tdescription: \"Encourages sentiment updates when tone changes.\",\n\t\tcontent: `## Sentiment Updates\n\n- Update sentiment when tone shifts meaningfully.\n- Keep reason short and factual.\n- Avoid over-updating on minor wording changes.\n\n## Tool Notes\n\n- Record tone with [@Update Sentiment](mention:tool:updateSentiment).`,\n\t\tsuggestedToolIds: [\"updateSentiment\"] as const,\n\t},\n\t{\n\t\tname: \"title-hygiene.md\",\n\t\tlabel: \"Title Hygiene\",\n\t\tdescription: \"Keeps conversation titles clear and actionable.\",\n\t\tcontent: `## Title Standards\n\n- Keep titles short and specific.\n- Reflect the primary issue, not generic phrases.\n- Update title if topic changes significantly.\n\n## Tool Notes\n\n- Use [@Update Conversation Title](mention:tool:updateConversationTitle).`,\n\t\tsuggestedToolIds: [\"updateConversationTitle\"] as const,\n\t},\n\t{\n\t\tname: \"handoff-notes.md\",\n\t\tlabel: \"Handoff Notes\",\n\t\tdescription: \"Improves private notes shared with human teammates.\",\n\t\tcontent: `## Private Note Checklist\n\n- Include issue summary, key facts, and what was already tried.\n- Add urgency and expected next action.\n- Keep notes scannable and concise.\n\n## Tool Notes\n\n- Send internal details with [@Send Private Note](mention:tool:sendPrivateMessage).`,\n\t\tsuggestedToolIds: [\"sendPrivateMessage\"] as const,\n\t},\n] as const;\n\ntype AiAgentDefaultSkillTemplateEntry = {\n\tname: string;\n\tlabel: string;\n\tdescription: string;\n\tcontent: string;\n\tsuggestedToolIds: readonly AiAgentToolId[];\n};\n\nexport const AI_AGENT_DEFAULT_SKILL_TEMPLATES: readonly AiAgentDefaultSkillTemplateEntry[] =\n\tAI_AGENT_DEFAULT_SKILL_TEMPLATE_DEFINITIONS.map((template) => ({\n\t\t...template,\n\t\tcontent: serializeSkillFileContent({\n\t\t\tname: stripSkillMarkdownExtension(template.name),\n\t\t\tdescription: template.description,\n\t\t\tbody: template.content,\n\t\t}),\n\t}));\n\nexport type AiAgentDefaultSkillTemplate =\n\t(typeof AI_AGENT_DEFAULT_SKILL_TEMPLATES)[number];\n\nexport type AiAgentSystemSkillMetadataEntry = {\n\tname:\n\t\t| \"agent.md\"\n\t\t| \"security.md\"\n\t\t| \"behaviour.md\"\n\t\t| \"participation.md\"\n\t\t| \"grounding.md\"\n\t\t| \"capabilities.md\";\n\tlabel: string;\n\tdescription: string;\n};\n\nexport const AI_AGENT_SYSTEM_SKILL_METADATA: readonly AiAgentSystemSkillMetadataEntry[] =\n\t[\n\t\t{\n\t\t\tname: \"agent.md\",\n\t\t\tlabel: \"Agent Identity\",\n\t\t\tdescription: \"Core role, persona, and mission of the assistant.\",\n\t\t},\n\t\t{\n\t\t\tname: \"security.md\",\n\t\t\tlabel: \"Security Guardrails\",\n\t\t\tdescription:\n\t\t\t\t\"Critical safety and confidentiality rules that should stay strict.\",\n\t\t},\n\t\t{\n\t\t\tname: \"behaviour.md\",\n\t\t\tlabel: \"Behavior Policy\",\n\t\t\tdescription: \"Runtime behavior and mode-specific operating guidance.\",\n\t\t},\n\t\t{\n\t\t\tname: \"participation.md\",\n\t\t\tlabel: \"Participation Policy\",\n\t\t\tdescription:\n\t\t\t\t\"Rules for when AI should participate versus intentionally stay silent.\",\n\t\t},\n\t\t{\n\t\t\tname: \"grounding.md\",\n\t\t\tlabel: \"Grounding Policy\",\n\t\t\tdescription:\n\t\t\t\t\"Instructions for factual grounding and knowledge retrieval discipline.\",\n\t\t},\n\t\t{\n\t\t\tname: \"capabilities.md\",\n\t\t\tlabel: \"Capabilities Contract\",\n\t\t\tdescription:\n\t\t\t\t\"Capability boundaries and references to optional behavior skills.\",\n\t\t},\n\t];\n"],"mappings":"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"}