@harness-kernel/skills 0.0.0 → 0.5.0

package/dist/provider.d.ts

@@ -0,0 +1,20 @@
+import { JsonObject, HarnessRoleSelector, HarnessContextProvider, AgentReadSession, ContextProviderOutput } from '@harness-kernel/core';
+import { HarnessSkill } from './skill.js';
+import { SkillRegistry } from './registry.js';
+import { SkillStateOptions } from './state.js';
+
+interface SkillPromptProviderOptions extends SkillStateOptions, JsonObject {
+    includeInactiveCatalog?: boolean;
+    includeToolNames?: boolean;
+    role?: HarnessRoleSelector;
+}
+declare class SkillPromptProvider extends HarnessContextProvider<SkillPromptProviderOptions> {
+    private readonly registry;
+    private readonly defaults;
+    label: string;
+    constructor(registry: SkillRegistry, defaults?: SkillPromptProviderOptions);
+    render(session: AgentReadSession, options?: SkillPromptProviderOptions): Promise<ContextProviderOutput>;
+}
+declare function createSkillPromptProvider(registry: SkillRegistry | HarnessSkill[], options?: SkillPromptProviderOptions): HarnessContextProvider;
+
+export { SkillPromptProvider, type SkillPromptProviderOptions, createSkillPromptProvider };

package/dist/provider.js

@@ -0,0 +1,13 @@
+import {
+  SkillPromptProvider,
+  createSkillPromptProvider
+} from "./chunk-THKBSLCD.js";
+import "./chunk-SIAWNALF.js";
+import "./chunk-FUZYYJJU.js";
+import "./chunk-TC7PNGST.js";
+import "./chunk-BF5PYWY6.js";
+export {
+  SkillPromptProvider,
+  createSkillPromptProvider
+};
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,26 @@
+import { JsonObject, HarnessTool } from '@harness-kernel/core';
+import { HarnessSkill } from './skill.js';
+
+interface SkillCatalogOptions {
+    includeToolNames?: boolean;
+    includeMetadata?: boolean;
+}
+interface SkillCatalogEntry {
+    key: string;
+    label?: string;
+    description: string;
+    active?: boolean;
+    toolNames?: string[];
+    metadata?: JsonObject;
+}
+interface SkillRegistry {
+    list(): HarnessSkill[];
+    get(key: string): HarnessSkill | undefined;
+    require(key: string): HarnessSkill;
+    catalog(options?: SkillCatalogOptions): SkillCatalogEntry[];
+    tools(): HarnessTool[];
+}
+declare function createSkillRegistry(skills: HarnessSkill[]): SkillRegistry;
+declare function toSkillRegistry(registryOrSkills: SkillRegistry | HarnessSkill[]): SkillRegistry;
+
+export { type SkillCatalogEntry, type SkillCatalogOptions, type SkillRegistry, createSkillRegistry, toSkillRegistry };

package/dist/registry.js

@@ -0,0 +1,9 @@
+import {
+  createSkillRegistry,
+  toSkillRegistry
+} from "./chunk-BF5PYWY6.js";
+export {
+  createSkillRegistry,
+  toSkillRegistry
+};
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/skill.d.ts

@@ -0,0 +1,22 @@
+import { AgentReadSession, HarnessTool, JsonObject } from '@harness-kernel/core';
+
+type SkillPromptResolver = (session: AgentReadSession, skill: HarnessSkill) => string | Promise<string>;
+interface HarnessSkill {
+    key: string;
+    label?: string;
+    description: string;
+    prompt?: string | SkillPromptResolver;
+    tools?: HarnessTool[];
+    metadata?: JsonObject;
+}
+interface HarnessSkillInput {
+    key: string;
+    label?: string;
+    description: string;
+    prompt?: string | SkillPromptResolver;
+    tools?: HarnessTool[];
+    metadata?: JsonObject;
+}
+declare function defineSkill(input: HarnessSkillInput): HarnessSkill;
+
+export { type HarnessSkill, type HarnessSkillInput, type SkillPromptResolver, defineSkill };

package/dist/skill.js

@@ -0,0 +1,7 @@
+import {
+  defineSkill
+} from "./chunk-L3KCYHUW.js";
+export {
+  defineSkill
+};
+//# sourceMappingURL=skill.js.map

package/dist/skill.js.map

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

package/dist/state.d.ts

@@ -0,0 +1,55 @@
+import { AgentReadSession, AgentSharedState, AgentActionSession } from '@harness-kernel/core';
+import { HarnessSkill } from './skill.js';
+import { SkillCatalogEntry, SkillRegistry, SkillCatalogOptions } from './registry.js';
+
+declare const DEFAULT_SKILL_STATE_KEY = "skills";
+interface SkillStateOptions {
+    stateKey?: string;
+}
+interface ActiveSkillState {
+    key: string;
+    activatedAt: string;
+    activatedByToolCallId?: string;
+    reason?: string;
+}
+interface SkillState {
+    active: Record<string, ActiveSkillState>;
+}
+type SkillErrorCode = "skill.unknown" | "skill.required";
+interface SkillActivationResult {
+    ok: boolean;
+    key: string;
+    known: boolean;
+    alreadyActive: boolean;
+    skill?: SkillCatalogEntry;
+    active?: ActiveSkillState;
+    code?: "skill.unknown";
+    availableSkills?: SkillCatalogEntry[];
+}
+interface SkillDeactivationResult {
+    ok: boolean;
+    key: string;
+    known: boolean;
+    alreadyInactive: boolean;
+    skill?: SkillCatalogEntry;
+    code?: "skill.unknown";
+    availableSkills?: SkillCatalogEntry[];
+}
+interface SkillToolOptions extends SkillStateOptions {
+}
+declare function getSkillState(sessionOrState: AgentReadSession | AgentSharedState, options?: SkillStateOptions): SkillState;
+declare function setSkillState(session: AgentActionSession, state: SkillState, options?: SkillStateOptions): void;
+declare function listAvailableSkills(registry: SkillRegistry | HarnessSkill[], options?: SkillCatalogOptions): SkillCatalogEntry[];
+declare function listActiveSkills(sessionOrState: AgentReadSession | AgentSharedState, registry: SkillRegistry | HarnessSkill[], options?: SkillCatalogOptions & SkillStateOptions): SkillCatalogEntry[];
+declare function listInactiveSkills(sessionOrState: AgentReadSession | AgentSharedState, registry: SkillRegistry | HarnessSkill[], options?: SkillCatalogOptions & SkillStateOptions): SkillCatalogEntry[];
+declare function isSkillActive(sessionOrState: AgentReadSession | AgentSharedState, key: string, options?: SkillStateOptions): boolean;
+declare function activateSkill(session: AgentActionSession, registry: SkillRegistry | HarnessSkill[], input: {
+    key: string;
+    reason?: string;
+}, options?: SkillToolOptions): Promise<SkillActivationResult>;
+declare function deactivateSkill(session: AgentActionSession, registry: SkillRegistry | HarnessSkill[], input: {
+    key: string;
+    reason?: string;
+}, options?: SkillToolOptions): Promise<SkillDeactivationResult>;
+
+export { type ActiveSkillState, DEFAULT_SKILL_STATE_KEY, type SkillActivationResult, type SkillDeactivationResult, type SkillErrorCode, type SkillState, type SkillStateOptions, type SkillToolOptions, activateSkill, deactivateSkill, getSkillState, isSkillActive, listActiveSkills, listAvailableSkills, listInactiveSkills, setSkillState };

package/dist/state.js

@@ -0,0 +1,26 @@
+import {
+  DEFAULT_SKILL_STATE_KEY,
+  activateSkill,
+  deactivateSkill,
+  getSkillState,
+  isSkillActive,
+  listActiveSkills,
+  listAvailableSkills,
+  listInactiveSkills,
+  setSkillState
+} from "./chunk-SIAWNALF.js";
+import "./chunk-FUZYYJJU.js";
+import "./chunk-TC7PNGST.js";
+import "./chunk-BF5PYWY6.js";
+export {
+  DEFAULT_SKILL_STATE_KEY,
+  activateSkill,
+  deactivateSkill,
+  getSkillState,
+  isSkillActive,
+  listActiveSkills,
+  listAvailableSkills,
+  listInactiveSkills,
+  setSkillState
+};
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,70 @@
+import * as _harness_kernel_core from '@harness-kernel/core';
+import { HarnessTool, InferInput, AgentActionSession, AgentToolResult } from '@harness-kernel/core';
+import { HarnessSkill } from './skill.js';
+import { SkillRegistry } from './registry.js';
+import { SkillActivationResult, SkillToolOptions, SkillDeactivationResult, listAvailableSkills, listActiveSkills, listInactiveSkills } from './state.js';
+
+declare const skillKeySchema: _harness_kernel_core.ObjectSchema<{
+    key: _harness_kernel_core.StringSchema;
+    reason: _harness_kernel_core.OptionalSchema<unknown, string | undefined>;
+}>;
+declare const listSkillsSchema: _harness_kernel_core.ObjectSchema<{
+    includeTools: _harness_kernel_core.DefaultSchema<unknown, boolean>;
+    includeInactive: _harness_kernel_core.DefaultSchema<unknown, boolean>;
+}>;
+type SkillKeyInput = InferInput<typeof skillKeySchema>;
+type ListSkillsInput = InferInput<typeof listSkillsSchema>;
+interface SkillGateOptions extends SkillToolOptions {
+    skillKeys?: string[];
+}
+interface SkillListResult {
+    ok: true;
+    available: ReturnType<typeof listAvailableSkills>;
+    active: ReturnType<typeof listActiveSkills>;
+    inactive?: ReturnType<typeof listInactiveSkills>;
+}
+declare class SkillActivationTool extends HarnessTool<SkillKeyInput, SkillActivationResult> {
+    private readonly registry;
+    private readonly options;
+    name: string;
+    description: string;
+    schema: _harness_kernel_core.ObjectSchema<{
+        key: _harness_kernel_core.StringSchema;
+        reason: _harness_kernel_core.OptionalSchema<unknown, string | undefined>;
+    }>;
+    risk: "safe";
+    constructor(registry: SkillRegistry, options?: SkillToolOptions);
+    execute(args: SkillKeyInput, session: AgentActionSession): Promise<AgentToolResult<SkillActivationResult>>;
+}
+declare class SkillDeactivationTool extends HarnessTool<SkillKeyInput, SkillDeactivationResult> {
+    private readonly registry;
+    private readonly options;
+    name: string;
+    description: string;
+    schema: _harness_kernel_core.ObjectSchema<{
+        key: _harness_kernel_core.StringSchema;
+        reason: _harness_kernel_core.OptionalSchema<unknown, string | undefined>;
+    }>;
+    risk: "safe";
+    constructor(registry: SkillRegistry, options?: SkillToolOptions);
+    execute(args: SkillKeyInput, session: AgentActionSession): Promise<AgentToolResult<SkillDeactivationResult>>;
+}
+declare class SkillListTool extends HarnessTool<ListSkillsInput, SkillListResult> {
+    private readonly registry;
+    private readonly options;
+    name: string;
+    description: string;
+    schema: _harness_kernel_core.ObjectSchema<{
+        includeTools: _harness_kernel_core.DefaultSchema<unknown, boolean>;
+        includeInactive: _harness_kernel_core.DefaultSchema<unknown, boolean>;
+    }>;
+    risk: "safe";
+    constructor(registry: SkillRegistry, options?: SkillToolOptions);
+    execute(args: ListSkillsInput, session: AgentActionSession): AgentToolResult<SkillListResult>;
+}
+declare function createSkillActivationTool(registry: SkillRegistry | HarnessSkill[], options?: SkillToolOptions): HarnessTool;
+declare function createSkillDeactivationTool(registry: SkillRegistry | HarnessSkill[], options?: SkillToolOptions): HarnessTool;
+declare function createSkillListTool(registry: SkillRegistry | HarnessSkill[], options?: SkillToolOptions): HarnessTool;
+declare function createSkillGatedTools(registry: SkillRegistry | HarnessSkill[], options?: SkillGateOptions): HarnessTool[];
+
+export { SkillActivationTool, SkillDeactivationTool, type SkillGateOptions, type SkillListResult, SkillListTool, createSkillActivationTool, createSkillDeactivationTool, createSkillGatedTools, createSkillListTool };

package/dist/tools.js

@@ -0,0 +1,23 @@
+import {
+  SkillActivationTool,
+  SkillDeactivationTool,
+  SkillListTool,
+  createSkillActivationTool,
+  createSkillDeactivationTool,
+  createSkillGatedTools,
+  createSkillListTool
+} from "./chunk-6XTSIVQV.js";
+import "./chunk-SIAWNALF.js";
+import "./chunk-FUZYYJJU.js";
+import "./chunk-TC7PNGST.js";
+import "./chunk-BF5PYWY6.js";
+export {
+  SkillActivationTool,
+  SkillDeactivationTool,
+  SkillListTool,
+  createSkillActivationTool,
+  createSkillDeactivationTool,
+  createSkillGatedTools,
+  createSkillListTool
+};
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/package.json

@@ -1,13 +1,12 @@
 {
   "name": "@harness-kernel/skills",
-  "version": "0.0.0",
+  "version": "0.5.0",
   "type": "module",
-  "description": "Placeholder package for Harness Kernel skills.",
+  "description": "Package-only skill registry, prompts, gated tools, and audit events for Harness Kernel agents.",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Ducks-Software-AI-Infrastructure/harness-kernel.git",
-    "directory": "packages/skills"
+    "url": "git+https://github.com/Ducks-Software-AI-Infrastructure/harness-kernel.git"
   },
   "homepage": "https://ducks-software-ai-infrastructure.github.io/harness-kernel/docs/packages/skills/",
   "bugs": {
@@ -16,6 +15,7 @@
   "keywords": [
     "ai",
     "agents",
+    "runtime",
     "skills",
     "harness-kernel"
   ],
@@ -24,15 +24,53 @@
   },
   "exports": {
     ".": {
-      "import": "./index.js",
-      "types": "./index.d.ts"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./events": {
+      "types": "./dist/events.d.ts",
+      "import": "./dist/events.js"
+    },
+    "./logs": {
+      "types": "./dist/logs.d.ts",
+      "import": "./dist/logs.js"
+    },
+    "./provider": {
+      "types": "./dist/provider.d.ts",
+      "import": "./dist/provider.js"
+    },
+    "./registry": {
+      "types": "./dist/registry.d.ts",
+      "import": "./dist/registry.js"
+    },
+    "./skill": {
+      "types": "./dist/skill.d.ts",
+      "import": "./dist/skill.js"
+    },
+    "./state": {
+      "types": "./dist/state.d.ts",
+      "import": "./dist/state.js"
+    },
+    "./tools": {
+      "types": "./dist/tools.d.ts",
+      "import": "./dist/tools.js"
     },
     "./package.json": "./package.json"
   },
   "files": [
-    "index.js",
-    "index.d.ts",
+    "dist",
     "README.md",
     "NOTICE"
-  ]
-}
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "tsx src/skill.test.ts"
+  },
+  "dependencies": {
+    "@harness-kernel/core": "0.5.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/index.d.ts

@@ -1 +0,0 @@
-export declare const placeholder: true;

package/index.js

@@ -1 +0,0 @@
-export const placeholder = true;