@traits-dev/core 0.1.0 → 0.3.0

package/README.md

@@ -1,6 +1,6 @@
 # @traits-dev/core
 
-Core SDK for traits.dev personality profiles: validate, compile, inject, and evaluate.
+Core SDK for traits.dev voice profiles and behavioral policies: validate, compile, inject, and evaluate.
 
 ## Install
 

package/dist/{index-CkGiIKnu.d.cts → index-CFhdB_nQ.d.cts}

@@ -25,6 +25,15 @@ interface ContextAdaptation {
     inject?: string[];
     priority?: number;
 }
+interface CapabilityHandoff {
+    trigger: string;
+    action: string;
+}
+interface ProfileCapabilities {
+    tools: string[];
+    constraints: string[];
+    handoff: CapabilityHandoff;
+}
 interface PersonalityProfile {
     schema: string;
     meta: {
@@ -53,6 +62,7 @@ interface PersonalityProfile {
     vocabulary?: VocabularyConstraints;
     behavioral_rules?: string[];
     context_adaptations?: ContextAdaptation[];
+    capabilities?: ProfileCapabilities;
     localization?: Record<string, unknown>;
     channel_adaptations?: Record<string, unknown>;
     extends?: string;
@@ -179,6 +189,18 @@ declare function injectPersonality({ compiledPersonality, system, model }: {
     model?: string;
 }): string;
 
+type EvalScenarioCategory = "standard" | "frustrated" | "edge" | "multi-turn" | "formal" | "casual" | "mixed";
+type EvalScenarioMessage = {
+    role: "user" | "assistant";
+    content: string;
+};
+type EvalScenario = {
+    id: string;
+    category: EvalScenarioCategory;
+    domain?: string;
+    messages: EvalScenarioMessage[];
+    expected_behavior?: string;
+};
 type EvalSample = {
     id?: string;
     prompt?: string;
@@ -349,4 +371,4 @@ declare function runImportAnalysis(promptText: unknown, options?: ImportOptions)
     yaml: string;
 }>;
 
-export { runImportAnalysis as A, runTier1EvaluationForProfile as B, type CompileOptions as C, type DimensionName as D, type EvalSample as E, runTier2Evaluation as F, runTier2EvaluationForProfile as G, type HumorDimensionObject as H, type ImportOptions as I, runTier3Evaluation as J, runTier3EvaluationForProfile as K, type Level as L, validateEvalScenario as M, validateEvalScenarios as N, validateProfile as O, type PersonalityProfile as P, validateResolvedProfile as Q, type Tier1Options as T, type ValidationResult as V, type ValidationCheckSummary as a, type ValidationDiagnostic as b, type CompiledPersonality as c, type ContextAdaptation as d, type ContextResolution as e, type DimensionObject as f, type DimensionShorthand as g, type DimensionValue as h, type ExtendsDiagnostics as i, type ExtendsResult as j, type HumorDimensionValue as k, type HumorStyle as l, type Tier2Options as m, type Tier3Options as n, type VocabularyConstraints as o, compileProfile as p, compileResolvedProfile as q, runTier1Evaluation as r, evaluateTier1Response as s, injectPersonality as t, loadProfileFile as u, mapImportAnalysisToProfile as v, normalizeProfile as w, renderImportedProfileYAML as x, resolveActiveContext as y, resolveExtends as z };
+export { renderImportedProfileYAML as A, resolveActiveContext as B, type CapabilityHandoff as C, type DimensionName as D, type EvalScenario as E, resolveExtends as F, runImportAnalysis as G, type HumorDimensionObject as H, type ImportOptions as I, runTier1EvaluationForProfile as J, runTier2Evaluation as K, type Level as L, runTier2EvaluationForProfile as M, runTier3Evaluation as N, runTier3EvaluationForProfile as O, type PersonalityProfile as P, validateEvalScenario as Q, validateEvalScenarios as R, validateProfile as S, type Tier1Options as T, validateResolvedProfile as U, type ValidationResult as V, type ValidationCheckSummary as a, type ValidationDiagnostic as b, type CompileOptions as c, type CompiledPersonality as d, type ContextAdaptation as e, type ContextResolution as f, type DimensionObject as g, type DimensionShorthand as h, type DimensionValue as i, type EvalSample as j, type ExtendsDiagnostics as k, type ExtendsResult as l, type HumorDimensionValue as m, type HumorStyle as n, type ProfileCapabilities as o, type Tier2Options as p, type Tier3Options as q, runTier1Evaluation as r, type VocabularyConstraints as s, compileProfile as t, compileResolvedProfile as u, evaluateTier1Response as v, injectPersonality as w, loadProfileFile as x, mapImportAnalysisToProfile as y, normalizeProfile as z };

package/dist/{index-CkGiIKnu.d.ts → index-CFhdB_nQ.d.ts}

@@ -25,6 +25,15 @@ interface ContextAdaptation {
     inject?: string[];
     priority?: number;
 }
+interface CapabilityHandoff {
+    trigger: string;
+    action: string;
+}
+interface ProfileCapabilities {
+    tools: string[];
+    constraints: string[];
+    handoff: CapabilityHandoff;
+}
 interface PersonalityProfile {
     schema: string;
     meta: {
@@ -53,6 +62,7 @@ interface PersonalityProfile {
     vocabulary?: VocabularyConstraints;
     behavioral_rules?: string[];
     context_adaptations?: ContextAdaptation[];
+    capabilities?: ProfileCapabilities;
     localization?: Record<string, unknown>;
     channel_adaptations?: Record<string, unknown>;
     extends?: string;
@@ -179,6 +189,18 @@ declare function injectPersonality({ compiledPersonality, system, model }: {
     model?: string;
 }): string;
 
+type EvalScenarioCategory = "standard" | "frustrated" | "edge" | "multi-turn" | "formal" | "casual" | "mixed";
+type EvalScenarioMessage = {
+    role: "user" | "assistant";
+    content: string;
+};
+type EvalScenario = {
+    id: string;
+    category: EvalScenarioCategory;
+    domain?: string;
+    messages: EvalScenarioMessage[];
+    expected_behavior?: string;
+};
 type EvalSample = {
     id?: string;
     prompt?: string;
@@ -349,4 +371,4 @@ declare function runImportAnalysis(promptText: unknown, options?: ImportOptions)
     yaml: string;
 }>;
 
-export { runImportAnalysis as A, runTier1EvaluationForProfile as B, type CompileOptions as C, type DimensionName as D, type EvalSample as E, runTier2Evaluation as F, runTier2EvaluationForProfile as G, type HumorDimensionObject as H, type ImportOptions as I, runTier3Evaluation as J, runTier3EvaluationForProfile as K, type Level as L, validateEvalScenario as M, validateEvalScenarios as N, validateProfile as O, type PersonalityProfile as P, validateResolvedProfile as Q, type Tier1Options as T, type ValidationResult as V, type ValidationCheckSummary as a, type ValidationDiagnostic as b, type CompiledPersonality as c, type ContextAdaptation as d, type ContextResolution as e, type DimensionObject as f, type DimensionShorthand as g, type DimensionValue as h, type ExtendsDiagnostics as i, type ExtendsResult as j, type HumorDimensionValue as k, type HumorStyle as l, type Tier2Options as m, type Tier3Options as n, type VocabularyConstraints as o, compileProfile as p, compileResolvedProfile as q, runTier1Evaluation as r, evaluateTier1Response as s, injectPersonality as t, loadProfileFile as u, mapImportAnalysisToProfile as v, normalizeProfile as w, renderImportedProfileYAML as x, resolveActiveContext as y, resolveExtends as z };
+export { renderImportedProfileYAML as A, resolveActiveContext as B, type CapabilityHandoff as C, type DimensionName as D, type EvalScenario as E, resolveExtends as F, runImportAnalysis as G, type HumorDimensionObject as H, type ImportOptions as I, runTier1EvaluationForProfile as J, runTier2Evaluation as K, type Level as L, runTier2EvaluationForProfile as M, runTier3Evaluation as N, runTier3EvaluationForProfile as O, type PersonalityProfile as P, validateEvalScenario as Q, validateEvalScenarios as R, validateProfile as S, type Tier1Options as T, validateResolvedProfile as U, type ValidationResult as V, type ValidationCheckSummary as a, type ValidationDiagnostic as b, type CompileOptions as c, type CompiledPersonality as d, type ContextAdaptation as e, type ContextResolution as f, type DimensionObject as g, type DimensionShorthand as h, type DimensionValue as i, type EvalSample as j, type ExtendsDiagnostics as k, type ExtendsResult as l, type HumorDimensionValue as m, type HumorStyle as n, type ProfileCapabilities as o, type Tier2Options as p, type Tier3Options as q, runTier1Evaluation as r, type VocabularyConstraints as s, compileProfile as t, compileResolvedProfile as u, evaluateTier1Response as v, injectPersonality as w, loadProfileFile as x, mapImportAnalysisToProfile as y, normalizeProfile as z };

package/dist/index.cjs

@@ -112,6 +112,7 @@ var PASS_THROUGH_FIELDS = /* @__PURE__ */ new Set([
   "vocabulary",
   "behavioral_rules",
   "context_adaptations",
+  "capabilities",
   "extends",
   "behavioral_rules_remove",
   "context_adaptations_remove"
@@ -194,6 +195,27 @@ function mergeContextAdaptations(parentAdaptations = [], childAdaptations = [])
   }
   return out;
 }
+function mergeCapabilities(parentCapabilities, childCapabilities) {
+  if (!parentCapabilities && !childCapabilities) return void 0;
+  if (!parentCapabilities) return clone(childCapabilities);
+  if (!childCapabilities) return clone(parentCapabilities);
+  const mergedTools = dedupCaseInsensitive([
+    ...asArray(parentCapabilities.tools),
+    ...asArray(childCapabilities.tools)
+  ]);
+  const mergedConstraints = dedupCaseInsensitive([
+    ...asArray(parentCapabilities.constraints),
+    ...asArray(childCapabilities.constraints)
+  ]);
+  return {
+    tools: mergedTools,
+    constraints: mergedConstraints,
+    handoff: {
+      trigger: childCapabilities.handoff?.trigger ?? parentCapabilities.handoff?.trigger ?? "",
+      action: childCapabilities.handoff?.action ?? parentCapabilities.handoff?.action ?? ""
+    }
+  };
+}
 function removeCaseInsensitive(items, removals) {
   const removalSet = new Set(
     asArray(removals).map((item) => String(item).toLowerCase())
@@ -252,6 +274,10 @@ function mergeProfiles(parentProfile, childProfile) {
     parentProfile.context_adaptations,
     childProfile.context_adaptations
   );
+  merged.capabilities = mergeCapabilities(
+    parentProfile.capabilities,
+    childProfile.capabilities
+  );
   for (const [key, value] of Object.entries(childProfile)) {
     if (PASS_THROUGH_FIELDS.has(key)) {
       continue;
@@ -380,6 +406,7 @@ function checkOverspec(profile) {
 
 // src/validator/schema.ts
 var HUMOR_STYLES = ["none", "dry", "subtle-wit", "playful"];
+var SUPPORTED_SCHEMAS = /* @__PURE__ */ new Set(["v1.4", "v1.5"]);
 var TOP_LEVEL_KEYS = /* @__PURE__ */ new Set([
   "schema",
   "meta",
@@ -388,6 +415,7 @@ var TOP_LEVEL_KEYS = /* @__PURE__ */ new Set([
   "vocabulary",
   "behavioral_rules",
   "context_adaptations",
+  "capabilities",
   "localization",
   "channel_adaptations",
   "extends",
@@ -400,6 +428,7 @@ var VOCABULARY_KEYS = /* @__PURE__ */ new Set([
   "preferred_terms_remove",
   "forbidden_terms_remove"
 ]);
+var CAPABILITIES_KEYS = /* @__PURE__ */ new Set(["tools", "constraints", "handoff"]);
 function isObject(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
@@ -576,7 +605,7 @@ function validateSchema(profile) {
       `Missing required "schema" field`,
       "schema"
     );
-  } else if (profile.schema !== "v1.4") {
+  } else if (!SUPPORTED_SCHEMAS.has(profile.schema)) {
     pushDiagnostic(
       structureDiagnostics,
       "V001",
@@ -724,6 +753,76 @@ function validateSchema(profile) {
       "behavioral_rules"
     );
   }
+  if (profile.capabilities != null) {
+    if (profile.schema !== "v1.5") {
+      pushDiagnostic(
+        structureDiagnostics,
+        "V001",
+        `The "capabilities" section requires schema version "v1.5"`,
+        "capabilities"
+      );
+    }
+    if (!isObject(profile.capabilities)) {
+      pushDiagnostic(
+        structureDiagnostics,
+        "V001",
+        `Expected "capabilities" to be an object`,
+        "capabilities"
+      );
+    } else {
+      for (const key of Object.keys(profile.capabilities)) {
+        if (!CAPABILITIES_KEYS.has(key)) {
+          pushDiagnostic(
+            structureDiagnostics,
+            "V001",
+            `Unknown capabilities key "${key}"`,
+            `capabilities.${key}`
+          );
+        }
+      }
+      if (!isStringArray(profile.capabilities.tools)) {
+        pushDiagnostic(
+          structureDiagnostics,
+          "V001",
+          `Expected "capabilities.tools" to be an array of strings`,
+          "capabilities.tools"
+        );
+      }
+      if (!isStringArray(profile.capabilities.constraints)) {
+        pushDiagnostic(
+          structureDiagnostics,
+          "V001",
+          `Expected "capabilities.constraints" to be an array of strings`,
+          "capabilities.constraints"
+        );
+      }
+      if (!isObject(profile.capabilities.handoff)) {
+        pushDiagnostic(
+          structureDiagnostics,
+          "V001",
+          `Expected "capabilities.handoff" to be an object`,
+          "capabilities.handoff"
+        );
+      } else {
+        if (!isString(profile.capabilities.handoff.trigger)) {
+          pushDiagnostic(
+            structureDiagnostics,
+            "V001",
+            `Expected "capabilities.handoff.trigger" to be a non-empty string`,
+            "capabilities.handoff.trigger"
+          );
+        }
+        if (!isString(profile.capabilities.handoff.action)) {
+          pushDiagnostic(
+            structureDiagnostics,
+            "V001",
+            `Expected "capabilities.handoff.action" to be a non-empty string`,
+            "capabilities.handoff.action"
+          );
+        }
+      }
+    }
+  }
   if (profile.behavioral_rules_remove != null && !isStringArray(profile.behavioral_rules_remove)) {
     pushDiagnostic(
       structureDiagnostics,
@@ -940,6 +1039,38 @@ var S005_PATTERNS = [
   { id: "mode-switching", regex: /\b(switch|change)\b.*\bmode\b/i },
   { id: "jailbreak-language", regex: /\b(jailbreak|dan mode|developer mode)\b/i }
 ];
+var S008_ACTION_PATTERNS = [
+  {
+    id: "take-care-of",
+    regex: /\b(i(?:'ll| will)\s+take\s+care\s+of)\b/i,
+    toolHints: ["case", "ticket", "workflow", "task", "support", "assist"]
+  },
+  {
+    id: "escalate",
+    regex: /\b(i(?:'ll| will)\s+escalat(?:e|ing)|i\s+can\s+escalate)\b/i,
+    toolHints: ["escalat", "ticket"]
+  },
+  {
+    id: "contact-or-notify",
+    regex: /\b(i(?:'ll| will)\s+(?:contact|notify|reach out to|message))\b/i,
+    toolHints: ["contact", "notify", "message", "email", "sms", "ticket"]
+  },
+  {
+    id: "refund-action",
+    regex: /\b(i(?:'ll| will)\s+(?:issue|process|submit)\s+(?:a\s+)?refund)\b/i,
+    toolHints: ["refund", "payment", "billing"]
+  },
+  {
+    id: "schedule-action",
+    regex: /\b(i(?:'ll| will)\s+(?:schedule|book|reschedule))\b/i,
+    toolHints: ["schedule", "calendar", "appointment", "booking"]
+  },
+  {
+    id: "generic-i-will-action",
+    regex: /\b(i(?:'ll| will)\s+(?:handle|resolve|fix|approve|arrange|dispatch|submit))\b/i,
+    toolHints: []
+  }
+];
 function normalizeText(value) {
   return String(value ?? "").trim();
 }
@@ -1010,6 +1141,21 @@ function collectS005Candidates(profile) {
   });
   return candidates.filter((item) => item.text.length > 0);
 }
+function collectS008Candidates(profile) {
+  const candidates = [];
+  asArray(profile?.behavioral_rules).forEach((rule, idx) => {
+    candidates.push({
+      location: `behavioral_rules[${idx}]`,
+      text: normalizeText(rule)
+    });
+  });
+  return candidates.filter((item) => item.text.length > 0);
+}
+function hasCapabilityForPattern(tools, pattern) {
+  if (tools.length === 0) return false;
+  if (pattern.toolHints.length === 0) return tools.length > 0;
+  return pattern.toolHints.some((hint) => tools.some((tool) => tool.includes(hint)));
+}
 function matchPatterns(candidates, patterns, code, severity) {
   const diagnostics = [];
   for (const candidate of candidates) {
@@ -1104,6 +1250,28 @@ function checkS003(profile) {
 function checkS005(profile) {
   return matchPatterns(collectS005Candidates(profile), S005_PATTERNS, "S005", "warning");
 }
+function checkS008(profile) {
+  if (!profile?.capabilities) return [];
+  const tools = asArray(profile.capabilities.tools).map(
+    (tool) => String(tool).toLowerCase()
+  );
+  const diagnostics = [];
+  for (const candidate of collectS008Candidates(profile)) {
+    for (const pattern of S008_ACTION_PATTERNS) {
+      if (!pattern.regex.test(candidate.text)) continue;
+      if (hasCapabilityForPattern(tools, pattern)) break;
+      const expectedTools = pattern.toolHints.length > 0 ? pattern.toolHints.map((hint) => `"*${hint}*"`).join(", ") : "a concrete action tool";
+      diagnostics.push({
+        code: "S008",
+        severity: "warning",
+        message: `Action-claiming language matched "${pattern.id}" at ${candidate.location}, but capabilities.tools does not indicate support (expected ${expectedTools}).`,
+        location: candidate.location
+      });
+      break;
+    }
+  }
+  return diagnostics;
+}
 
 // src/validator/inheritance.ts
 var SAFETY_ADAPTATION_NAME = /(crisis|emergency|harm|suicid|self[-_ ]?harm)/i;
@@ -1229,6 +1397,7 @@ function validateResolvedProfile(profile, options = {}) {
     ...checkS002(profile),
     ...checkS003(profile),
     ...checkS005(profile),
+    ...checkS008(profile),
     ...checkS007(profile),
     ...overspec.diagnostics
   ];
@@ -1672,6 +1841,26 @@ function renderPersonalityText(profile, model, contextResolution, compileOptions
       lines.push(`- ${rule}`);
     }
   }
+  if (profile.schema === "v1.5" && profile.capabilities) {
+    const capabilities = profile.capabilities;
+    const tools = asArray(capabilities.tools);
+    const constraints = asArray(capabilities.constraints);
+    lines.push("");
+    lines.push("[CAPABILITY BOUNDARIES]");
+    lines.push(
+      `Tools: ${tools.length > 0 ? tools.join("; ") : "(none \u2014 advisory only, no side-effect tools configured)"}`
+    );
+    lines.push("Constraints:");
+    if (constraints.length === 0) {
+      lines.push("- (none)");
+    } else {
+      for (const constraint of constraints) {
+        lines.push(`- ${constraint}`);
+      }
+    }
+    lines.push(`Handoff trigger: ${capabilities.handoff.trigger}`);
+    lines.push(`Handoff action: ${capabilities.handoff.action}`);
+  }
   if (contextResolution.matched.length > 0) {
     lines.push("");
     lines.push("[ACTIVE CONTEXT]");

package/dist/index.d.cts

@@ -1 +1 @@
-export { C as CompileOptions, c as CompiledPersonality, d as ContextAdaptation, e as ContextResolution, D as DimensionName, f as DimensionObject, g as DimensionShorthand, h as DimensionValue, E as EvalSample, i as ExtendsDiagnostics, j as ExtendsResult, H as HumorDimensionObject, k as HumorDimensionValue, l as HumorStyle, I as ImportOptions, L as Level, P as PersonalityProfile, T as Tier1Options, m as Tier2Options, n as Tier3Options, b as ValidationDiagnostic, V as ValidationResult, o as VocabularyConstraints, p as compileProfile, q as compileResolvedProfile, s as evaluateTier1Response, t as injectPersonality, u as loadProfileFile, w as normalizeProfile, y as resolveActiveContext, z as resolveExtends, A as runImportAnalysis, r as runTier1Evaluation, B as runTier1EvaluationForProfile, F as runTier2Evaluation, G as runTier2EvaluationForProfile, J as runTier3Evaluation, K as runTier3EvaluationForProfile, M as validateEvalScenario, N as validateEvalScenarios, O as validateProfile, Q as validateResolvedProfile } from './index-CkGiIKnu.cjs';
+export { C as CapabilityHandoff, c as CompileOptions, d as CompiledPersonality, e as ContextAdaptation, f as ContextResolution, D as DimensionName, g as DimensionObject, h as DimensionShorthand, i as DimensionValue, j as EvalSample, k as ExtendsDiagnostics, l as ExtendsResult, H as HumorDimensionObject, m as HumorDimensionValue, n as HumorStyle, I as ImportOptions, L as Level, P as PersonalityProfile, o as ProfileCapabilities, T as Tier1Options, p as Tier2Options, q as Tier3Options, b as ValidationDiagnostic, V as ValidationResult, s as VocabularyConstraints, t as compileProfile, u as compileResolvedProfile, v as evaluateTier1Response, w as injectPersonality, x as loadProfileFile, z as normalizeProfile, B as resolveActiveContext, F as resolveExtends, G as runImportAnalysis, r as runTier1Evaluation, J as runTier1EvaluationForProfile, K as runTier2Evaluation, M as runTier2EvaluationForProfile, N as runTier3Evaluation, O as runTier3EvaluationForProfile, Q as validateEvalScenario, R as validateEvalScenarios, S as validateProfile, U as validateResolvedProfile } from './index-CFhdB_nQ.cjs';

package/dist/index.d.ts

@@ -1 +1 @@
-export { C as CompileOptions, c as CompiledPersonality, d as ContextAdaptation, e as ContextResolution, D as DimensionName, f as DimensionObject, g as DimensionShorthand, h as DimensionValue, E as EvalSample, i as ExtendsDiagnostics, j as ExtendsResult, H as HumorDimensionObject, k as HumorDimensionValue, l as HumorStyle, I as ImportOptions, L as Level, P as PersonalityProfile, T as Tier1Options, m as Tier2Options, n as Tier3Options, b as ValidationDiagnostic, V as ValidationResult, o as VocabularyConstraints, p as compileProfile, q as compileResolvedProfile, s as evaluateTier1Response, t as injectPersonality, u as loadProfileFile, w as normalizeProfile, y as resolveActiveContext, z as resolveExtends, A as runImportAnalysis, r as runTier1Evaluation, B as runTier1EvaluationForProfile, F as runTier2Evaluation, G as runTier2EvaluationForProfile, J as runTier3Evaluation, K as runTier3EvaluationForProfile, M as validateEvalScenario, N as validateEvalScenarios, O as validateProfile, Q as validateResolvedProfile } from './index-CkGiIKnu.js';
+export { C as CapabilityHandoff, c as CompileOptions, d as CompiledPersonality, e as ContextAdaptation, f as ContextResolution, D as DimensionName, g as DimensionObject, h as DimensionShorthand, i as DimensionValue, j as EvalSample, k as ExtendsDiagnostics, l as ExtendsResult, H as HumorDimensionObject, m as HumorDimensionValue, n as HumorStyle, I as ImportOptions, L as Level, P as PersonalityProfile, o as ProfileCapabilities, T as Tier1Options, p as Tier2Options, q as Tier3Options, b as ValidationDiagnostic, V as ValidationResult, s as VocabularyConstraints, t as compileProfile, u as compileResolvedProfile, v as evaluateTier1Response, w as injectPersonality, x as loadProfileFile, z as normalizeProfile, B as resolveActiveContext, F as resolveExtends, G as runImportAnalysis, r as runTier1Evaluation, J as runTier1EvaluationForProfile, K as runTier2Evaluation, M as runTier2EvaluationForProfile, N as runTier3Evaluation, O as runTier3EvaluationForProfile, Q as validateEvalScenario, R as validateEvalScenarios, S as validateProfile, U as validateResolvedProfile } from './index-CFhdB_nQ.js';

package/dist/index.js

@@ -58,6 +58,7 @@ var PASS_THROUGH_FIELDS = /* @__PURE__ */ new Set([
   "vocabulary",
   "behavioral_rules",
   "context_adaptations",
+  "capabilities",
   "extends",
   "behavioral_rules_remove",
   "context_adaptations_remove"
@@ -140,6 +141,27 @@ function mergeContextAdaptations(parentAdaptations = [], childAdaptations = [])
   }
   return out;
 }
+function mergeCapabilities(parentCapabilities, childCapabilities) {
+  if (!parentCapabilities && !childCapabilities) return void 0;
+  if (!parentCapabilities) return clone(childCapabilities);
+  if (!childCapabilities) return clone(parentCapabilities);
+  const mergedTools = dedupCaseInsensitive([
+    ...asArray(parentCapabilities.tools),
+    ...asArray(childCapabilities.tools)
+  ]);
+  const mergedConstraints = dedupCaseInsensitive([
+    ...asArray(parentCapabilities.constraints),
+    ...asArray(childCapabilities.constraints)
+  ]);
+  return {
+    tools: mergedTools,
+    constraints: mergedConstraints,
+    handoff: {
+      trigger: childCapabilities.handoff?.trigger ?? parentCapabilities.handoff?.trigger ?? "",
+      action: childCapabilities.handoff?.action ?? parentCapabilities.handoff?.action ?? ""
+    }
+  };
+}
 function removeCaseInsensitive(items, removals) {
   const removalSet = new Set(
     asArray(removals).map((item) => String(item).toLowerCase())
@@ -198,6 +220,10 @@ function mergeProfiles(parentProfile, childProfile) {
     parentProfile.context_adaptations,
     childProfile.context_adaptations
   );
+  merged.capabilities = mergeCapabilities(
+    parentProfile.capabilities,
+    childProfile.capabilities
+  );
   for (const [key, value] of Object.entries(childProfile)) {
     if (PASS_THROUGH_FIELDS.has(key)) {
       continue;
@@ -326,6 +352,7 @@ function checkOverspec(profile) {
 
 // src/validator/schema.ts
 var HUMOR_STYLES = ["none", "dry", "subtle-wit", "playful"];
+var SUPPORTED_SCHEMAS = /* @__PURE__ */ new Set(["v1.4", "v1.5"]);
 var TOP_LEVEL_KEYS = /* @__PURE__ */ new Set([
   "schema",
   "meta",
@@ -334,6 +361,7 @@ var TOP_LEVEL_KEYS = /* @__PURE__ */ new Set([
   "vocabulary",
   "behavioral_rules",
   "context_adaptations",
+  "capabilities",
   "localization",
   "channel_adaptations",
   "extends",
@@ -346,6 +374,7 @@ var VOCABULARY_KEYS = /* @__PURE__ */ new Set([
   "preferred_terms_remove",
   "forbidden_terms_remove"
 ]);
+var CAPABILITIES_KEYS = /* @__PURE__ */ new Set(["tools", "constraints", "handoff"]);
 function isObject(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
@@ -522,7 +551,7 @@ function validateSchema(profile) {
       `Missing required "schema" field`,
       "schema"
     );
-  } else if (profile.schema !== "v1.4") {
+  } else if (!SUPPORTED_SCHEMAS.has(profile.schema)) {
     pushDiagnostic(
       structureDiagnostics,
       "V001",
@@ -670,6 +699,76 @@ function validateSchema(profile) {
       "behavioral_rules"
     );
   }
+  if (profile.capabilities != null) {
+    if (profile.schema !== "v1.5") {
+      pushDiagnostic(
+        structureDiagnostics,
+        "V001",
+        `The "capabilities" section requires schema version "v1.5"`,
+        "capabilities"
+      );
+    }
+    if (!isObject(profile.capabilities)) {
+      pushDiagnostic(
+        structureDiagnostics,
+        "V001",
+        `Expected "capabilities" to be an object`,
+        "capabilities"
+      );
+    } else {
+      for (const key of Object.keys(profile.capabilities)) {
+        if (!CAPABILITIES_KEYS.has(key)) {
+          pushDiagnostic(
+            structureDiagnostics,
+            "V001",
+            `Unknown capabilities key "${key}"`,
+            `capabilities.${key}`
+          );
+        }
+      }
+      if (!isStringArray(profile.capabilities.tools)) {
+        pushDiagnostic(
+          structureDiagnostics,
+          "V001",
+          `Expected "capabilities.tools" to be an array of strings`,
+          "capabilities.tools"
+        );
+      }
+      if (!isStringArray(profile.capabilities.constraints)) {
+        pushDiagnostic(
+          structureDiagnostics,
+          "V001",
+          `Expected "capabilities.constraints" to be an array of strings`,
+          "capabilities.constraints"
+        );
+      }
+      if (!isObject(profile.capabilities.handoff)) {
+        pushDiagnostic(
+          structureDiagnostics,
+          "V001",
+          `Expected "capabilities.handoff" to be an object`,
+          "capabilities.handoff"
+        );
+      } else {
+        if (!isString(profile.capabilities.handoff.trigger)) {
+          pushDiagnostic(
+            structureDiagnostics,
+            "V001",
+            `Expected "capabilities.handoff.trigger" to be a non-empty string`,
+            "capabilities.handoff.trigger"
+          );
+        }
+        if (!isString(profile.capabilities.handoff.action)) {
+          pushDiagnostic(
+            structureDiagnostics,
+            "V001",
+            `Expected "capabilities.handoff.action" to be a non-empty string`,
+            "capabilities.handoff.action"
+          );
+        }
+      }
+    }
+  }
   if (profile.behavioral_rules_remove != null && !isStringArray(profile.behavioral_rules_remove)) {
     pushDiagnostic(
       structureDiagnostics,
@@ -886,6 +985,38 @@ var S005_PATTERNS = [
   { id: "mode-switching", regex: /\b(switch|change)\b.*\bmode\b/i },
   { id: "jailbreak-language", regex: /\b(jailbreak|dan mode|developer mode)\b/i }
 ];
+var S008_ACTION_PATTERNS = [
+  {
+    id: "take-care-of",
+    regex: /\b(i(?:'ll| will)\s+take\s+care\s+of)\b/i,
+    toolHints: ["case", "ticket", "workflow", "task", "support", "assist"]
+  },
+  {
+    id: "escalate",
+    regex: /\b(i(?:'ll| will)\s+escalat(?:e|ing)|i\s+can\s+escalate)\b/i,
+    toolHints: ["escalat", "ticket"]
+  },
+  {
+    id: "contact-or-notify",
+    regex: /\b(i(?:'ll| will)\s+(?:contact|notify|reach out to|message))\b/i,
+    toolHints: ["contact", "notify", "message", "email", "sms", "ticket"]
+  },
+  {
+    id: "refund-action",
+    regex: /\b(i(?:'ll| will)\s+(?:issue|process|submit)\s+(?:a\s+)?refund)\b/i,
+    toolHints: ["refund", "payment", "billing"]
+  },
+  {
+    id: "schedule-action",
+    regex: /\b(i(?:'ll| will)\s+(?:schedule|book|reschedule))\b/i,
+    toolHints: ["schedule", "calendar", "appointment", "booking"]
+  },
+  {
+    id: "generic-i-will-action",
+    regex: /\b(i(?:'ll| will)\s+(?:handle|resolve|fix|approve|arrange|dispatch|submit))\b/i,
+    toolHints: []
+  }
+];
 function normalizeText(value) {
   return String(value ?? "").trim();
 }
@@ -956,6 +1087,21 @@ function collectS005Candidates(profile) {
   });
   return candidates.filter((item) => item.text.length > 0);
 }
+function collectS008Candidates(profile) {
+  const candidates = [];
+  asArray(profile?.behavioral_rules).forEach((rule, idx) => {
+    candidates.push({
+      location: `behavioral_rules[${idx}]`,
+      text: normalizeText(rule)
+    });
+  });
+  return candidates.filter((item) => item.text.length > 0);
+}
+function hasCapabilityForPattern(tools, pattern) {
+  if (tools.length === 0) return false;
+  if (pattern.toolHints.length === 0) return tools.length > 0;
+  return pattern.toolHints.some((hint) => tools.some((tool) => tool.includes(hint)));
+}
 function matchPatterns(candidates, patterns, code, severity) {
   const diagnostics = [];
   for (const candidate of candidates) {
@@ -1050,6 +1196,28 @@ function checkS003(profile) {
 function checkS005(profile) {
   return matchPatterns(collectS005Candidates(profile), S005_PATTERNS, "S005", "warning");
 }
+function checkS008(profile) {
+  if (!profile?.capabilities) return [];
+  const tools = asArray(profile.capabilities.tools).map(
+    (tool) => String(tool).toLowerCase()
+  );
+  const diagnostics = [];
+  for (const candidate of collectS008Candidates(profile)) {
+    for (const pattern of S008_ACTION_PATTERNS) {
+      if (!pattern.regex.test(candidate.text)) continue;
+      if (hasCapabilityForPattern(tools, pattern)) break;
+      const expectedTools = pattern.toolHints.length > 0 ? pattern.toolHints.map((hint) => `"*${hint}*"`).join(", ") : "a concrete action tool";
+      diagnostics.push({
+        code: "S008",
+        severity: "warning",
+        message: `Action-claiming language matched "${pattern.id}" at ${candidate.location}, but capabilities.tools does not indicate support (expected ${expectedTools}).`,
+        location: candidate.location
+      });
+      break;
+    }
+  }
+  return diagnostics;
+}
 
 // src/validator/inheritance.ts
 var SAFETY_ADAPTATION_NAME = /(crisis|emergency|harm|suicid|self[-_ ]?harm)/i;
@@ -1175,6 +1343,7 @@ function validateResolvedProfile(profile, options = {}) {
     ...checkS002(profile),
     ...checkS003(profile),
     ...checkS005(profile),
+    ...checkS008(profile),
     ...checkS007(profile),
     ...overspec.diagnostics
   ];
@@ -1618,6 +1787,26 @@ function renderPersonalityText(profile, model, contextResolution, compileOptions
       lines.push(`- ${rule}`);
     }
   }
+  if (profile.schema === "v1.5" && profile.capabilities) {
+    const capabilities = profile.capabilities;
+    const tools = asArray(capabilities.tools);
+    const constraints = asArray(capabilities.constraints);
+    lines.push("");
+    lines.push("[CAPABILITY BOUNDARIES]");
+    lines.push(
+      `Tools: ${tools.length > 0 ? tools.join("; ") : "(none \u2014 advisory only, no side-effect tools configured)"}`
+    );
+    lines.push("Constraints:");
+    if (constraints.length === 0) {
+      lines.push("- (none)");
+    } else {
+      for (const constraint of constraints) {
+        lines.push(`- ${constraint}`);
+      }
+    }
+    lines.push(`Handoff trigger: ${capabilities.handoff.trigger}`);
+    lines.push(`Handoff action: ${capabilities.handoff.action}`);
+  }
   if (contextResolution.matched.length > 0) {
     lines.push("");
     lines.push("[ACTIVE CONTEXT]");