@harness-kernel/skills 0.0.0 → 0.5.0

package/dist/chunk-SIAWNALF.js

@@ -0,0 +1,196 @@
+import {
+  SkillActivatedEvent,
+  SkillActivationRequestedEvent,
+  SkillDeactivatedEvent
+} from "./chunk-FUZYYJJU.js";
+import {
+  SkillActivatedLog,
+  SkillActivationRequestedLog,
+  SkillDeactivatedLog
+} from "./chunk-TC7PNGST.js";
+import {
+  toSkillRegistry
+} from "./chunk-BF5PYWY6.js";
+
+// src/state.ts
+var DEFAULT_SKILL_STATE_KEY = "skills";
+function nowIso() {
+  return (/* @__PURE__ */ new Date()).toISOString();
+}
+function stateKey(options) {
+  return options?.stateKey?.trim() || DEFAULT_SKILL_STATE_KEY;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readSharedState(sessionOrState) {
+  if (isRecord(sessionOrState) && isRecord(sessionOrState.state) && typeof sessionOrState.state.get === "function") {
+    return sessionOrState.state.get();
+  }
+  return sessionOrState;
+}
+function normalizeActiveSkill(key, value) {
+  if (!isRecord(value)) return void 0;
+  const storedKey = typeof value.key === "string" && value.key.trim() ? value.key.trim() : key;
+  const activatedAt = typeof value.activatedAt === "string" && value.activatedAt.trim() ? value.activatedAt : nowIso();
+  return {
+    key: storedKey,
+    activatedAt,
+    ...typeof value.activatedByToolCallId === "string" && value.activatedByToolCallId.trim() ? { activatedByToolCallId: value.activatedByToolCallId } : {},
+    ...typeof value.reason === "string" && value.reason.trim() ? { reason: value.reason } : {}
+  };
+}
+function skillCatalogEntry(skill, options) {
+  return toSkillRegistry([skill]).catalog(options)[0];
+}
+function getSkillState(sessionOrState, options) {
+  const sharedState = readSharedState(sessionOrState);
+  const raw = sharedState[stateKey(options)];
+  if (!isRecord(raw) || !isRecord(raw.active)) return { active: {} };
+  const active = {};
+  for (const [key, value] of Object.entries(raw.active)) {
+    const normalized = normalizeActiveSkill(key, value);
+    if (normalized) active[key] = normalized;
+  }
+  return { active };
+}
+function setSkillState(session, state, options) {
+  session.state.update({
+    [stateKey(options)]: {
+      active: { ...state.active }
+    }
+  });
+}
+function listAvailableSkills(registry, options) {
+  return toSkillRegistry(registry).catalog(options);
+}
+function listActiveSkills(sessionOrState, registry, options) {
+  const skillState = getSkillState(sessionOrState, options);
+  return toSkillRegistry(registry).list().filter((skill) => Boolean(skillState.active[skill.key])).map((skill) => ({ ...skillCatalogEntry(skill, options), active: true }));
+}
+function listInactiveSkills(sessionOrState, registry, options) {
+  const skillState = getSkillState(sessionOrState, options);
+  return toSkillRegistry(registry).list().filter((skill) => !skillState.active[skill.key]).map((skill) => ({ ...skillCatalogEntry(skill, options), active: false }));
+}
+function isSkillActive(sessionOrState, key, options) {
+  return Boolean(getSkillState(sessionOrState, options).active[key]);
+}
+async function activateSkill(session, registry, input, options) {
+  const key = input.key.trim();
+  const skills = toSkillRegistry(registry);
+  const skill = skills.get(key);
+  const alreadyActive = isSkillActive(session, key, options);
+  const known = Boolean(skill);
+  await session.events.emit(SkillActivationRequestedEvent, {
+    key,
+    ...input.reason ? { reason: input.reason } : {},
+    known,
+    alreadyActive
+  });
+  session.log.emit(SkillActivationRequestedLog, {
+    skillKey: key,
+    known,
+    alreadyActive,
+    reason: input.reason
+  });
+  if (!skill) {
+    return {
+      ok: false,
+      key,
+      known: false,
+      alreadyActive,
+      code: "skill.unknown",
+      availableSkills: skills.catalog({ includeToolNames: true })
+    };
+  }
+  let active = getSkillState(session, options).active[key];
+  if (!active) {
+    active = {
+      key,
+      activatedAt: nowIso(),
+      ...session.toolCall?.id ? { activatedByToolCallId: session.toolCall.id } : {},
+      ...input.reason ? { reason: input.reason } : {}
+    };
+    const current = getSkillState(session, options);
+    setSkillState(session, {
+      active: {
+        ...current.active,
+        [key]: active
+      }
+    }, options);
+  }
+  await session.events.emit(SkillActivatedEvent, {
+    key,
+    ...skill.label ? { label: skill.label } : {},
+    ...input.reason ? { reason: input.reason } : {},
+    alreadyActive,
+    ...active.activatedByToolCallId ? { activatedByToolCallId: active.activatedByToolCallId } : {}
+  });
+  session.log.emit(SkillActivatedLog, {
+    skillKey: key,
+    label: skill.label,
+    alreadyActive
+  });
+  return {
+    ok: true,
+    key,
+    known: true,
+    alreadyActive,
+    skill: skillCatalogEntry(skill, { includeToolNames: true }),
+    active
+  };
+}
+async function deactivateSkill(session, registry, input, options) {
+  const key = input.key.trim();
+  const skills = toSkillRegistry(registry);
+  const skill = skills.get(key);
+  if (!skill) {
+    return {
+      ok: false,
+      key,
+      known: false,
+      alreadyInactive: true,
+      code: "skill.unknown",
+      availableSkills: skills.catalog({ includeToolNames: true })
+    };
+  }
+  const current = getSkillState(session, options);
+  const alreadyInactive = !current.active[key];
+  if (!alreadyInactive) {
+    const nextActive = { ...current.active };
+    delete nextActive[key];
+    setSkillState(session, { active: nextActive }, options);
+  }
+  await session.events.emit(SkillDeactivatedEvent, {
+    key,
+    ...skill.label ? { label: skill.label } : {},
+    ...input.reason ? { reason: input.reason } : {},
+    alreadyInactive,
+    ...session.toolCall?.id ? { deactivatedByToolCallId: session.toolCall.id } : {}
+  });
+  session.log.emit(SkillDeactivatedLog, {
+    skillKey: key,
+    label: skill.label,
+    alreadyInactive
+  });
+  return {
+    ok: true,
+    key,
+    known: true,
+    alreadyInactive,
+    skill: skillCatalogEntry(skill, { includeToolNames: true })
+  };
+}
+
+export {
+  DEFAULT_SKILL_STATE_KEY,
+  getSkillState,
+  setSkillState,
+  listAvailableSkills,
+  listActiveSkills,
+  listInactiveSkills,
+  isSkillActive,
+  activateSkill,
+  deactivateSkill
+};
+//# sourceMappingURL=chunk-SIAWNALF.js.map

package/dist/chunk-SIAWNALF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/state.ts"],"sourcesContent":["import type {\n  AgentActionSession,\n  AgentReadSession,\n  AgentSharedState,\n} from \"@harness-kernel/core\";\nimport type { HarnessSkill } from \"./skill.js\";\nimport {\n  type SkillCatalogEntry,\n  type SkillCatalogOptions,\n  type SkillRegistry,\n  toSkillRegistry,\n} from \"./registry.js\";\nimport {\n  SkillActivatedEvent,\n  SkillActivationRequestedEvent,\n  SkillDeactivatedEvent,\n} from \"./events.js\";\nimport {\n  SkillActivatedLog,\n  SkillActivationRequestedLog,\n  SkillDeactivatedLog,\n} from \"./logs.js\";\n\nexport const DEFAULT_SKILL_STATE_KEY = \"skills\";\n\nexport interface SkillStateOptions {\n  stateKey?: string;\n}\n\nexport interface ActiveSkillState {\n  key: string;\n  activatedAt: string;\n  activatedByToolCallId?: string;\n  reason?: string;\n}\n\nexport interface SkillState {\n  active: Record<string, ActiveSkillState>;\n}\n\nexport type SkillErrorCode = \"skill.unknown\" | \"skill.required\";\n\nexport interface SkillActivationResult {\n  ok: boolean;\n  key: string;\n  known: boolean;\n  alreadyActive: boolean;\n  skill?: SkillCatalogEntry;\n  active?: ActiveSkillState;\n  code?: \"skill.unknown\";\n  availableSkills?: SkillCatalogEntry[];\n}\n\nexport interface SkillDeactivationResult {\n  ok: boolean;\n  key: string;\n  known: boolean;\n  alreadyInactive: boolean;\n  skill?: SkillCatalogEntry;\n  code?: \"skill.unknown\";\n  availableSkills?: SkillCatalogEntry[];\n}\n\nexport interface SkillToolOptions extends SkillStateOptions {}\n\nfunction nowIso(): string {\n  return new Date().toISOString();\n}\n\nfunction stateKey(options?: SkillStateOptions): string {\n  return options?.stateKey?.trim() || DEFAULT_SKILL_STATE_KEY;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction readSharedState(sessionOrState: AgentReadSession | AgentSharedState): AgentSharedState {\n  if (\n    isRecord(sessionOrState)\n    && isRecord(sessionOrState.state)\n    && typeof sessionOrState.state.get === \"function\"\n  ) {\n    return sessionOrState.state.get() as AgentSharedState;\n  }\n  return sessionOrState as AgentSharedState;\n}\n\nfunction normalizeActiveSkill(key: string, value: unknown): ActiveSkillState | undefined {\n  if (!isRecord(value)) return undefined;\n  const storedKey = typeof value.key === \"string\" && value.key.trim() ? value.key.trim() : key;\n  const activatedAt = typeof value.activatedAt === \"string\" && value.activatedAt.trim()\n    ? value.activatedAt\n    : nowIso();\n  return {\n    key: storedKey,\n    activatedAt,\n    ...(typeof value.activatedByToolCallId === \"string\" && value.activatedByToolCallId.trim()\n      ? { activatedByToolCallId: value.activatedByToolCallId }\n      : {}),\n    ...(typeof value.reason === \"string\" && value.reason.trim() ? { reason: value.reason } : {}),\n  };\n}\n\nfunction skillCatalogEntry(skill: HarnessSkill, options?: SkillCatalogOptions): SkillCatalogEntry {\n  return toSkillRegistry([skill]).catalog(options)[0]!;\n}\n\nexport function getSkillState(\n  sessionOrState: AgentReadSession | AgentSharedState,\n  options?: SkillStateOptions,\n): SkillState {\n  const sharedState = readSharedState(sessionOrState);\n  const raw = sharedState[stateKey(options)];\n  if (!isRecord(raw) || !isRecord(raw.active)) return { active: {} };\n\n  const active: Record<string, ActiveSkillState> = {};\n  for (const [key, value] of Object.entries(raw.active)) {\n    const normalized = normalizeActiveSkill(key, value);\n    if (normalized) active[key] = normalized;\n  }\n  return { active };\n}\n\nexport function setSkillState(\n  session: AgentActionSession,\n  state: SkillState,\n  options?: SkillStateOptions,\n): void {\n  session.state.update({\n    [stateKey(options)]: {\n      active: { ...state.active },\n    },\n  } as Partial<AgentSharedState>);\n}\n\nexport function listAvailableSkills(\n  registry: SkillRegistry | HarnessSkill[],\n  options?: SkillCatalogOptions,\n): SkillCatalogEntry[] {\n  return toSkillRegistry(registry).catalog(options);\n}\n\nexport function listActiveSkills(\n  sessionOrState: AgentReadSession | AgentSharedState,\n  registry: SkillRegistry | HarnessSkill[],\n  options?: SkillCatalogOptions & SkillStateOptions,\n): SkillCatalogEntry[] {\n  const skillState = getSkillState(sessionOrState, options);\n  return toSkillRegistry(registry)\n    .list()\n    .filter((skill) => Boolean(skillState.active[skill.key]))\n    .map((skill) => ({ ...skillCatalogEntry(skill, options), active: true }));\n}\n\nexport function listInactiveSkills(\n  sessionOrState: AgentReadSession | AgentSharedState,\n  registry: SkillRegistry | HarnessSkill[],\n  options?: SkillCatalogOptions & SkillStateOptions,\n): SkillCatalogEntry[] {\n  const skillState = getSkillState(sessionOrState, options);\n  return toSkillRegistry(registry)\n    .list()\n    .filter((skill) => !skillState.active[skill.key])\n    .map((skill) => ({ ...skillCatalogEntry(skill, options), active: false }));\n}\n\nexport function isSkillActive(\n  sessionOrState: AgentReadSession | AgentSharedState,\n  key: string,\n  options?: SkillStateOptions,\n): boolean {\n  return Boolean(getSkillState(sessionOrState, options).active[key]);\n}\n\nexport async function activateSkill(\n  session: AgentActionSession,\n  registry: SkillRegistry | HarnessSkill[],\n  input: { key: string; reason?: string },\n  options?: SkillToolOptions,\n): Promise<SkillActivationResult> {\n  const key = input.key.trim();\n  const skills = toSkillRegistry(registry);\n  const skill = skills.get(key);\n  const alreadyActive = isSkillActive(session, key, options);\n  const known = Boolean(skill);\n\n  await session.events.emit(SkillActivationRequestedEvent, {\n    key,\n    ...(input.reason ? { reason: input.reason } : {}),\n    known,\n    alreadyActive,\n  });\n  session.log.emit(SkillActivationRequestedLog, {\n    skillKey: key,\n    known,\n    alreadyActive,\n    reason: input.reason,\n  });\n\n  if (!skill) {\n    return {\n      ok: false,\n      key,\n      known: false,\n      alreadyActive,\n      code: \"skill.unknown\",\n      availableSkills: skills.catalog({ includeToolNames: true }),\n    };\n  }\n\n  let active = getSkillState(session, options).active[key];\n  if (!active) {\n    active = {\n      key,\n      activatedAt: nowIso(),\n      ...(session.toolCall?.id ? { activatedByToolCallId: session.toolCall.id } : {}),\n      ...(input.reason ? { reason: input.reason } : {}),\n    };\n    const current = getSkillState(session, options);\n    setSkillState(session, {\n      active: {\n        ...current.active,\n        [key]: active,\n      },\n    }, options);\n  }\n\n  await session.events.emit(SkillActivatedEvent, {\n    key,\n    ...(skill.label ? { label: skill.label } : {}),\n    ...(input.reason ? { reason: input.reason } : {}),\n    alreadyActive,\n    ...(active.activatedByToolCallId ? { activatedByToolCallId: active.activatedByToolCallId } : {}),\n  });\n  session.log.emit(SkillActivatedLog, {\n    skillKey: key,\n    label: skill.label,\n    alreadyActive,\n  });\n\n  return {\n    ok: true,\n    key,\n    known: true,\n    alreadyActive,\n    skill: skillCatalogEntry(skill, { includeToolNames: true }),\n    active,\n  };\n}\n\nexport async function deactivateSkill(\n  session: AgentActionSession,\n  registry: SkillRegistry | HarnessSkill[],\n  input: { key: string; reason?: string },\n  options?: SkillToolOptions,\n): Promise<SkillDeactivationResult> {\n  const key = input.key.trim();\n  const skills = toSkillRegistry(registry);\n  const skill = skills.get(key);\n  if (!skill) {\n    return {\n      ok: false,\n      key,\n      known: false,\n      alreadyInactive: true,\n      code: \"skill.unknown\",\n      availableSkills: skills.catalog({ includeToolNames: true }),\n    };\n  }\n\n  const current = getSkillState(session, options);\n  const alreadyInactive = !current.active[key];\n  if (!alreadyInactive) {\n    const nextActive = { ...current.active };\n    delete nextActive[key];\n    setSkillState(session, { active: nextActive }, options);\n  }\n\n  await session.events.emit(SkillDeactivatedEvent, {\n    key,\n    ...(skill.label ? { label: skill.label } : {}),\n    ...(input.reason ? { reason: input.reason } : {}),\n    alreadyInactive,\n    ...(session.toolCall?.id ? { deactivatedByToolCallId: session.toolCall.id } : {}),\n  });\n  session.log.emit(SkillDeactivatedLog, {\n    skillKey: key,\n    label: skill.label,\n    alreadyInactive,\n  });\n\n  return {\n    ok: true,\n    key,\n    known: true,\n    alreadyInactive,\n    skill: skillCatalogEntry(skill, { includeToolNames: true }),\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-TC7PNGST.js

@@ -0,0 +1,41 @@
+// src/logs.ts
+import { HarnessLog } from "@harness-kernel/core/runner/logging";
+var SkillActivationRequestedLog = class extends HarnessLog {
+  level = "info";
+  category = "agent";
+  levelFor(fields) {
+    return fields.known ? "info" : "warn";
+  }
+  message(fields) {
+    return `skill.activation.requested key=${fields.skillKey} known=${fields.known} alreadyActive=${fields.alreadyActive}`;
+  }
+};
+var SkillActivatedLog = class extends HarnessLog {
+  level = "info";
+  category = "agent";
+  message(fields) {
+    return `skill.activated key=${fields.skillKey} alreadyActive=${fields.alreadyActive}`;
+  }
+};
+var SkillDeactivatedLog = class extends HarnessLog {
+  level = "info";
+  category = "agent";
+  message(fields) {
+    return `skill.deactivated key=${fields.skillKey} alreadyInactive=${fields.alreadyInactive}`;
+  }
+};
+var SkillRequiredLog = class extends HarnessLog {
+  level = "warn";
+  category = "tool";
+  message(fields) {
+    return `skill.required key=${fields.skillKey} tool=${fields.toolName} reason=${fields.reason}`;
+  }
+};
+
+export {
+  SkillActivationRequestedLog,
+  SkillActivatedLog,
+  SkillDeactivatedLog,
+  SkillRequiredLog
+};
+//# sourceMappingURL=chunk-TC7PNGST.js.map

package/dist/chunk-TC7PNGST.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/logs.ts"],"sourcesContent":["import { HarnessLog } from \"@harness-kernel/core/runner/logging\";\n\nexport interface SkillActivationRequestedLogFields {\n  skillKey: string;\n  known: boolean;\n  alreadyActive: boolean;\n  reason?: string;\n}\n\nexport interface SkillActivatedLogFields {\n  skillKey: string;\n  label?: string;\n  alreadyActive: boolean;\n}\n\nexport interface SkillDeactivatedLogFields {\n  skillKey: string;\n  label?: string;\n  alreadyInactive: boolean;\n}\n\nexport interface SkillRequiredLogFields {\n  skillKey: string;\n  toolName: string;\n  reason: \"inactive\" | \"unknown\";\n}\n\nexport class SkillActivationRequestedLog extends HarnessLog<SkillActivationRequestedLogFields> {\n  level = \"info\" as const;\n  category = \"agent\" as const;\n\n  levelFor(fields: SkillActivationRequestedLogFields): \"info\" | \"warn\" {\n    return fields.known ? \"info\" : \"warn\";\n  }\n\n  message(fields: SkillActivationRequestedLogFields): string {\n    return `skill.activation.requested key=${fields.skillKey} known=${fields.known} alreadyActive=${fields.alreadyActive}`;\n  }\n}\n\nexport class SkillActivatedLog extends HarnessLog<SkillActivatedLogFields> {\n  level = \"info\" as const;\n  category = \"agent\" as const;\n\n  message(fields: SkillActivatedLogFields): string {\n    return `skill.activated key=${fields.skillKey} alreadyActive=${fields.alreadyActive}`;\n  }\n}\n\nexport class SkillDeactivatedLog extends HarnessLog<SkillDeactivatedLogFields> {\n  level = \"info\" as const;\n  category = \"agent\" as const;\n\n  message(fields: SkillDeactivatedLogFields): string {\n    return `skill.deactivated key=${fields.skillKey} alreadyInactive=${fields.alreadyInactive}`;\n  }\n}\n\nexport class SkillRequiredLog extends HarnessLog<SkillRequiredLogFields> {\n  level = \"warn\" as const;\n  category = \"tool\" as const;\n\n  message(fields: SkillRequiredLogFields): string {\n    return `skill.required key=${fields.skillKey} tool=${fields.toolName} reason=${fields.reason}`;\n  }\n}\n"],"mappings":";AAAA,SAAS,kBAAkB;AA2BpB,IAAM,8BAAN,cAA0C,WAA8C;AAAA,EAC7F,QAAQ;AAAA,EACR,WAAW;AAAA,EAEX,SAAS,QAA4D;AACnE,WAAO,OAAO,QAAQ,SAAS;AAAA,EACjC;AAAA,EAEA,QAAQ,QAAmD;AACzD,WAAO,kCAAkC,OAAO,QAAQ,UAAU,OAAO,KAAK,kBAAkB,OAAO,aAAa;AAAA,EACtH;AACF;AAEO,IAAM,oBAAN,cAAgC,WAAoC;AAAA,EACzE,QAAQ;AAAA,EACR,WAAW;AAAA,EAEX,QAAQ,QAAyC;AAC/C,WAAO,uBAAuB,OAAO,QAAQ,kBAAkB,OAAO,aAAa;AAAA,EACrF;AACF;AAEO,IAAM,sBAAN,cAAkC,WAAsC;AAAA,EAC7E,QAAQ;AAAA,EACR,WAAW;AAAA,EAEX,QAAQ,QAA2C;AACjD,WAAO,yBAAyB,OAAO,QAAQ,oBAAoB,OAAO,eAAe;AAAA,EAC3F;AACF;AAEO,IAAM,mBAAN,cAA+B,WAAmC;AAAA,EACvE,QAAQ;AAAA,EACR,WAAW;AAAA,EAEX,QAAQ,QAAwC;AAC9C,WAAO,sBAAsB,OAAO,QAAQ,SAAS,OAAO,QAAQ,WAAW,OAAO,MAAM;AAAA,EAC9F;AACF;","names":[]}

package/dist/chunk-THKBSLCD.js

@@ -0,0 +1,84 @@
+import {
+  listActiveSkills,
+  listAvailableSkills,
+  listInactiveSkills
+} from "./chunk-SIAWNALF.js";
+import {
+  toSkillRegistry
+} from "./chunk-BF5PYWY6.js";
+
+// src/provider.ts
+import {
+  HarnessContextProvider,
+  systemRole
+} from "@harness-kernel/core";
+function renderTools(toolNames) {
+  return toolNames?.length ? ` Tools: ${toolNames.join(", ")}.` : "";
+}
+function renderCatalogLine(entry) {
+  const label = entry.label && entry.label !== entry.key ? ` (${entry.label})` : "";
+  return `- ${entry.key}${label}: ${entry.description}.${renderTools(entry.toolNames)}`;
+}
+var SkillPromptProvider = class extends HarnessContextProvider {
+  constructor(registry, defaults = {}) {
+    super();
+    this.registry = registry;
+    this.defaults = defaults;
+    this.role = defaults.role ?? systemRole;
+  }
+  registry;
+  defaults;
+  label = "Skill Context";
+  async render(session, options) {
+    const config = { ...this.defaults, ...options };
+    const includeInactiveCatalog = config.includeInactiveCatalog ?? true;
+    const includeToolNames = config.includeToolNames ?? true;
+    const catalogOptions = { includeToolNames, includeMetadata: false };
+    const available = listAvailableSkills(this.registry, catalogOptions);
+    const active = listActiveSkills(session, this.registry, { ...catalogOptions, stateKey: config.stateKey });
+    const inactive = listInactiveSkills(session, this.registry, { ...catalogOptions, stateKey: config.stateKey });
+    const activeKeys = new Set(active.map((entry) => entry.key));
+    const activeSkills = this.registry.list().filter((skill) => activeKeys.has(skill.key));
+    const activePrompts = [];
+    for (const skill of activeSkills) {
+      if (!skill.prompt) continue;
+      const prompt = typeof skill.prompt === "function" ? await skill.prompt(session, skill) : skill.prompt;
+      if (!prompt.trim()) continue;
+      activePrompts.push(`## ${skill.label ?? skill.key} (${skill.key})
+${prompt.trim()}`);
+    }
+    const sections = [
+      "Skills are procedural capabilities. Activate a skill with activate_skill before using gated tools from that skill.",
+      'A gated tool that is called too early returns data.code = "skill.required" and names the required skill.',
+      `Active skills: ${active.length ? active.map((entry) => entry.key).join(", ") : "none"}.`
+    ];
+    if (includeInactiveCatalog) {
+      sections.push([
+        "Available skills:",
+        ...available.length ? available.map(renderCatalogLine) : ["- none"]
+      ].join("\n"));
+      sections.push(`Inactive skills: ${inactive.length ? inactive.map((entry) => entry.key).join(", ") : "none"}.`);
+    }
+    if (activePrompts.length) {
+      sections.push(["Active skill instructions:", ...activePrompts].join("\n\n"));
+    }
+    return {
+      role: config.role ?? this.role ?? systemRole,
+      content: sections.join("\n\n"),
+      metadata: {
+        stateKey: config.stateKey,
+        activeSkills: active.map((entry) => entry.key),
+        availableSkills: available.map((entry) => entry.key)
+      }
+    };
+  }
+};
+function createSkillPromptProvider(registry, options) {
+  return new SkillPromptProvider(toSkillRegistry(registry), options);
+}
+
+export {
+  SkillPromptProvider,
+  createSkillPromptProvider
+};
+//# sourceMappingURL=chunk-THKBSLCD.js.map

package/dist/chunk-THKBSLCD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/provider.ts"],"sourcesContent":["import {\n  HarnessContextProvider,\n  systemRole,\n  type AgentReadSession,\n  type ContextProviderOutput,\n  type HarnessRoleSelector,\n  type JsonObject,\n} from \"@harness-kernel/core\";\nimport type { HarnessSkill } from \"./skill.js\";\nimport { type SkillRegistry, toSkillRegistry } from \"./registry.js\";\nimport {\n  listActiveSkills,\n  listAvailableSkills,\n  listInactiveSkills,\n  type SkillStateOptions,\n} from \"./state.js\";\n\nexport interface SkillPromptProviderOptions extends SkillStateOptions, JsonObject {\n  includeInactiveCatalog?: boolean;\n  includeToolNames?: boolean;\n  role?: HarnessRoleSelector;\n}\n\nfunction renderTools(toolNames: string[] | undefined): string {\n  return toolNames?.length ? ` Tools: ${toolNames.join(\", \")}.` : \"\";\n}\n\nfunction renderCatalogLine(entry: {\n  key: string;\n  label?: string;\n  description: string;\n  toolNames?: string[];\n}): string {\n  const label = entry.label && entry.label !== entry.key ? ` (${entry.label})` : \"\";\n  return `- ${entry.key}${label}: ${entry.description}.${renderTools(entry.toolNames)}`;\n}\n\nexport class SkillPromptProvider extends HarnessContextProvider<SkillPromptProviderOptions> {\n  label = \"Skill Context\";\n\n  constructor(\n    private readonly registry: SkillRegistry,\n    private readonly defaults: SkillPromptProviderOptions = {},\n  ) {\n    super();\n    this.role = defaults.role ?? systemRole;\n  }\n\n  async render(session: AgentReadSession, options?: SkillPromptProviderOptions): Promise<ContextProviderOutput> {\n    const config = { ...this.defaults, ...options };\n    const includeInactiveCatalog = config.includeInactiveCatalog ?? true;\n    const includeToolNames = config.includeToolNames ?? true;\n    const catalogOptions = { includeToolNames, includeMetadata: false };\n    const available = listAvailableSkills(this.registry, catalogOptions);\n    const active = listActiveSkills(session, this.registry, { ...catalogOptions, stateKey: config.stateKey });\n    const inactive = listInactiveSkills(session, this.registry, { ...catalogOptions, stateKey: config.stateKey });\n    const activeKeys = new Set(active.map((entry) => entry.key));\n    const activeSkills = this.registry.list().filter((skill) => activeKeys.has(skill.key));\n    const activePrompts: string[] = [];\n\n    for (const skill of activeSkills) {\n      if (!skill.prompt) continue;\n      const prompt = typeof skill.prompt === \"function\"\n        ? await skill.prompt(session, skill)\n        : skill.prompt;\n      if (!prompt.trim()) continue;\n      activePrompts.push(`## ${skill.label ?? skill.key} (${skill.key})\\n${prompt.trim()}`);\n    }\n\n    const sections = [\n      \"Skills are procedural capabilities. Activate a skill with activate_skill before using gated tools from that skill.\",\n      \"A gated tool that is called too early returns data.code = \\\"skill.required\\\" and names the required skill.\",\n      `Active skills: ${active.length ? active.map((entry) => entry.key).join(\", \") : \"none\"}.`,\n    ];\n\n    if (includeInactiveCatalog) {\n      sections.push([\n        \"Available skills:\",\n        ...(available.length ? available.map(renderCatalogLine) : [\"- none\"]),\n      ].join(\"\\n\"));\n      sections.push(`Inactive skills: ${inactive.length ? inactive.map((entry) => entry.key).join(\", \") : \"none\"}.`);\n    }\n\n    if (activePrompts.length) {\n      sections.push([\"Active skill instructions:\", ...activePrompts].join(\"\\n\\n\"));\n    }\n\n    return {\n      role: config.role ?? this.role ?? systemRole,\n      content: sections.join(\"\\n\\n\"),\n      metadata: {\n        stateKey: config.stateKey,\n        activeSkills: active.map((entry) => entry.key),\n        availableSkills: available.map((entry) => entry.key),\n      },\n    };\n  }\n}\n\nexport function createSkillPromptProvider(\n  registry: SkillRegistry | HarnessSkill[],\n  options?: SkillPromptProviderOptions,\n): HarnessContextProvider {\n  return new SkillPromptProvider(toSkillRegistry(registry), options);\n}\n"],"mappings":"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","names":[]}

package/dist/events.d.ts

@@ -0,0 +1,70 @@
+import * as _harness_kernel_core from '@harness-kernel/core';
+import { HarnessEvent } from '@harness-kernel/core';
+
+interface SkillActivationRequestedPayload {
+    key: string;
+    reason?: string;
+    known: boolean;
+    alreadyActive: boolean;
+}
+interface SkillActivatedPayload {
+    key: string;
+    label?: string;
+    reason?: string;
+    alreadyActive: boolean;
+    activatedByToolCallId?: string;
+}
+interface SkillDeactivatedPayload {
+    key: string;
+    label?: string;
+    reason?: string;
+    alreadyInactive: boolean;
+    deactivatedByToolCallId?: string;
+}
+interface SkillRequiredPayload {
+    key: string;
+    label?: string;
+    toolName: string;
+    reason: "inactive" | "unknown";
+}
+declare class SkillActivationRequestedEvent extends HarnessEvent<SkillActivationRequestedPayload> {
+    static type: string;
+    static schema: _harness_kernel_core.ObjectSchema<{
+        key: _harness_kernel_core.StringSchema;
+        reason: _harness_kernel_core.OptionalSchema<unknown, string | undefined>;
+        known: _harness_kernel_core.BooleanSchema;
+        alreadyActive: _harness_kernel_core.BooleanSchema;
+    }>;
+}
+declare class SkillActivatedEvent extends HarnessEvent<SkillActivatedPayload> {
+    static type: string;
+    static schema: _harness_kernel_core.ObjectSchema<{
+        key: _harness_kernel_core.StringSchema;
+        label: _harness_kernel_core.OptionalSchema<unknown, string | undefined>;
+        reason: _harness_kernel_core.OptionalSchema<unknown, string | undefined>;
+        alreadyActive: _harness_kernel_core.BooleanSchema;
+        activatedByToolCallId: _harness_kernel_core.OptionalSchema<unknown, string | undefined>;
+    }>;
+}
+declare class SkillDeactivatedEvent extends HarnessEvent<SkillDeactivatedPayload> {
+    static type: string;
+    static schema: _harness_kernel_core.ObjectSchema<{
+        key: _harness_kernel_core.StringSchema;
+        label: _harness_kernel_core.OptionalSchema<unknown, string | undefined>;
+        reason: _harness_kernel_core.OptionalSchema<unknown, string | undefined>;
+        alreadyInactive: _harness_kernel_core.BooleanSchema;
+        deactivatedByToolCallId: _harness_kernel_core.OptionalSchema<unknown, string | undefined>;
+    }>;
+}
+declare class SkillRequiredEvent extends HarnessEvent<SkillRequiredPayload> {
+    static type: string;
+    static schema: _harness_kernel_core.ObjectSchema<{
+        key: _harness_kernel_core.StringSchema;
+        label: _harness_kernel_core.OptionalSchema<unknown, string | undefined>;
+        toolName: _harness_kernel_core.StringSchema;
+        reason: _harness_kernel_core.EnumSchema<readonly ["inactive", "unknown"]>;
+    }>;
+}
+declare function skillEvents(): (typeof SkillActivationRequestedEvent | typeof SkillActivatedEvent | typeof SkillDeactivatedEvent | typeof SkillRequiredEvent)[];
+
+export { SkillActivatedEvent, type SkillActivatedPayload, SkillActivationRequestedEvent, type SkillActivationRequestedPayload, SkillDeactivatedEvent, type SkillDeactivatedPayload, SkillRequiredEvent, type SkillRequiredPayload, skillEvents };

package/dist/events.js

@@ -0,0 +1,15 @@
+import {
+  SkillActivatedEvent,
+  SkillActivationRequestedEvent,
+  SkillDeactivatedEvent,
+  SkillRequiredEvent,
+  skillEvents
+} from "./chunk-FUZYYJJU.js";
+export {
+  SkillActivatedEvent,
+  SkillActivationRequestedEvent,
+  SkillDeactivatedEvent,
+  SkillRequiredEvent,
+  skillEvents
+};
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+import { HarnessContextProvider, HarnessTool, HarnessEventClass } from '@harness-kernel/core';
+import { HarnessSkill } from './skill.js';
+export { HarnessSkillInput, SkillPromptResolver, defineSkill } from './skill.js';
+import { SkillRegistry } from './registry.js';
+export { SkillCatalogEntry, SkillCatalogOptions, createSkillRegistry, toSkillRegistry } from './registry.js';
+import { SkillPromptProviderOptions } from './provider.js';
+export { SkillPromptProvider, createSkillPromptProvider } from './provider.js';
+import { SkillGateOptions } from './tools.js';
+export { SkillActivationTool, SkillDeactivationTool, SkillListResult, SkillListTool, createSkillActivationTool, createSkillDeactivationTool, createSkillGatedTools, createSkillListTool } from './tools.js';
+export { ActiveSkillState, DEFAULT_SKILL_STATE_KEY, SkillActivationResult, SkillDeactivationResult, SkillErrorCode, SkillState, SkillStateOptions, SkillToolOptions, activateSkill, deactivateSkill, getSkillState, isSkillActive, listActiveSkills, listAvailableSkills, listInactiveSkills, setSkillState } from './state.js';
+export { SkillActivatedEvent, SkillActivatedPayload, SkillActivationRequestedEvent, SkillActivationRequestedPayload, SkillDeactivatedEvent, SkillDeactivatedPayload, SkillRequiredEvent, SkillRequiredPayload, skillEvents } from './events.js';
+export { SkillActivatedLog, SkillActivatedLogFields, SkillActivationRequestedLog, SkillActivationRequestedLogFields, SkillDeactivatedLog, SkillDeactivatedLogFields, SkillRequiredLog, SkillRequiredLogFields } from './logs.js';
+import '@harness-kernel/core/runner/logging';
+
+interface SkillKitOptions extends SkillPromptProviderOptions, SkillGateOptions {
+}
+interface SkillKit {
+    registry: SkillRegistry;
+    provider: HarnessContextProvider;
+    tools: HarnessTool[];
+    events: HarnessEventClass[];
+}
+declare function createSkillKit(skills: HarnessSkill[], options?: SkillKitOptions): SkillKit;
+
+export { HarnessSkill, SkillGateOptions, type SkillKit, type SkillKitOptions, SkillPromptProviderOptions, SkillRegistry, createSkillKit };

package/dist/index.js

@@ -0,0 +1,94 @@
+import {
+  SkillPromptProvider,
+  createSkillPromptProvider
+} from "./chunk-THKBSLCD.js";
+import {
+  defineSkill
+} from "./chunk-L3KCYHUW.js";
+import {
+  SkillActivationTool,
+  SkillDeactivationTool,
+  SkillListTool,
+  createSkillActivationTool,
+  createSkillDeactivationTool,
+  createSkillGatedTools,
+  createSkillListTool
+} from "./chunk-6XTSIVQV.js";
+import {
+  DEFAULT_SKILL_STATE_KEY,
+  activateSkill,
+  deactivateSkill,
+  getSkillState,
+  isSkillActive,
+  listActiveSkills,
+  listAvailableSkills,
+  listInactiveSkills,
+  setSkillState
+} from "./chunk-SIAWNALF.js";
+import {
+  SkillActivatedEvent,
+  SkillActivationRequestedEvent,
+  SkillDeactivatedEvent,
+  SkillRequiredEvent,
+  skillEvents
+} from "./chunk-FUZYYJJU.js";
+import {
+  SkillActivatedLog,
+  SkillActivationRequestedLog,
+  SkillDeactivatedLog,
+  SkillRequiredLog
+} from "./chunk-TC7PNGST.js";
+import {
+  createSkillRegistry,
+  toSkillRegistry
+} from "./chunk-BF5PYWY6.js";
+
+// src/index.ts
+function createSkillKit(skills, options) {
+  const registry = createSkillRegistry(skills);
+  return {
+    registry,
+    provider: createSkillPromptProvider(registry, options),
+    tools: [
+      createSkillActivationTool(registry, options),
+      createSkillDeactivationTool(registry, options),
+      createSkillListTool(registry, options),
+      ...createSkillGatedTools(registry, options)
+    ],
+    events: skillEvents()
+  };
+}
+export {
+  DEFAULT_SKILL_STATE_KEY,
+  SkillActivatedEvent,
+  SkillActivatedLog,
+  SkillActivationRequestedEvent,
+  SkillActivationRequestedLog,
+  SkillActivationTool,
+  SkillDeactivatedEvent,
+  SkillDeactivatedLog,
+  SkillDeactivationTool,
+  SkillListTool,
+  SkillPromptProvider,
+  SkillRequiredEvent,
+  SkillRequiredLog,
+  activateSkill,
+  createSkillActivationTool,
+  createSkillDeactivationTool,
+  createSkillGatedTools,
+  createSkillKit,
+  createSkillListTool,
+  createSkillPromptProvider,
+  createSkillRegistry,
+  deactivateSkill,
+  defineSkill,
+  getSkillState,
+  isSkillActive,
+  listActiveSkills,
+  listAvailableSkills,
+  listInactiveSkills,
+  setSkillState,
+  skillEvents,
+  toSkillRegistry
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { HarnessContextProvider, HarnessEventClass, HarnessTool } from \"@harness-kernel/core\";\nimport type { HarnessSkill } from \"./skill.js\";\nimport { createSkillRegistry, type SkillRegistry } from \"./registry.js\";\nimport { createSkillPromptProvider, type SkillPromptProviderOptions } from \"./provider.js\";\nimport {\n  createSkillActivationTool,\n  createSkillDeactivationTool,\n  createSkillGatedTools,\n  createSkillListTool,\n  type SkillGateOptions,\n} from \"./tools.js\";\nimport { skillEvents } from \"./events.js\";\n\nexport * from \"./skill.js\";\nexport * from \"./registry.js\";\nexport * from \"./state.js\";\nexport * from \"./provider.js\";\nexport * from \"./tools.js\";\nexport * from \"./events.js\";\nexport * from \"./logs.js\";\n\nexport interface SkillKitOptions extends SkillPromptProviderOptions, SkillGateOptions {}\n\nexport interface SkillKit {\n  registry: SkillRegistry;\n  provider: HarnessContextProvider;\n  tools: HarnessTool[];\n  events: HarnessEventClass[];\n}\n\nexport function createSkillKit(skills: HarnessSkill[], options?: SkillKitOptions): SkillKit {\n  const registry = createSkillRegistry(skills);\n  return {\n    registry,\n    provider: createSkillPromptProvider(registry, options),\n    tools: [\n      createSkillActivationTool(registry, options),\n      createSkillDeactivationTool(registry, options),\n      createSkillListTool(registry, options),\n      ...createSkillGatedTools(registry, options),\n    ],\n    events: skillEvents(),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BO,SAAS,eAAe,QAAwB,SAAqC;AAC1F,QAAM,WAAW,oBAAoB,MAAM;AAC3C,SAAO;AAAA,IACL;AAAA,IACA,UAAU,0BAA0B,UAAU,OAAO;AAAA,IACrD,OAAO;AAAA,MACL,0BAA0B,UAAU,OAAO;AAAA,MAC3C,4BAA4B,UAAU,OAAO;AAAA,MAC7C,oBAAoB,UAAU,OAAO;AAAA,MACrC,GAAG,sBAAsB,UAAU,OAAO;AAAA,IAC5C;AAAA,IACA,QAAQ,YAAY;AAAA,EACtB;AACF;","names":[]}

package/dist/logs.d.ts

@@ -0,0 +1,46 @@
+import { HarnessLog } from '@harness-kernel/core/runner/logging';
+
+interface SkillActivationRequestedLogFields {
+    skillKey: string;
+    known: boolean;
+    alreadyActive: boolean;
+    reason?: string;
+}
+interface SkillActivatedLogFields {
+    skillKey: string;
+    label?: string;
+    alreadyActive: boolean;
+}
+interface SkillDeactivatedLogFields {
+    skillKey: string;
+    label?: string;
+    alreadyInactive: boolean;
+}
+interface SkillRequiredLogFields {
+    skillKey: string;
+    toolName: string;
+    reason: "inactive" | "unknown";
+}
+declare class SkillActivationRequestedLog extends HarnessLog<SkillActivationRequestedLogFields> {
+    level: "info";
+    category: "agent";
+    levelFor(fields: SkillActivationRequestedLogFields): "info" | "warn";
+    message(fields: SkillActivationRequestedLogFields): string;
+}
+declare class SkillActivatedLog extends HarnessLog<SkillActivatedLogFields> {
+    level: "info";
+    category: "agent";
+    message(fields: SkillActivatedLogFields): string;
+}
+declare class SkillDeactivatedLog extends HarnessLog<SkillDeactivatedLogFields> {
+    level: "info";
+    category: "agent";
+    message(fields: SkillDeactivatedLogFields): string;
+}
+declare class SkillRequiredLog extends HarnessLog<SkillRequiredLogFields> {
+    level: "warn";
+    category: "tool";
+    message(fields: SkillRequiredLogFields): string;
+}
+
+export { SkillActivatedLog, type SkillActivatedLogFields, SkillActivationRequestedLog, type SkillActivationRequestedLogFields, SkillDeactivatedLog, type SkillDeactivatedLogFields, SkillRequiredLog, type SkillRequiredLogFields };

package/dist/logs.js

@@ -0,0 +1,13 @@
+import {
+  SkillActivatedLog,
+  SkillActivationRequestedLog,
+  SkillDeactivatedLog,
+  SkillRequiredLog
+} from "./chunk-TC7PNGST.js";
+export {
+  SkillActivatedLog,
+  SkillActivationRequestedLog,
+  SkillDeactivatedLog,
+  SkillRequiredLog
+};
+//# sourceMappingURL=logs.js.map

package/dist/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}