@defai.digital/ability-domain 13.0.3

package/dist/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../src/manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAE3D;;GAEG;AACH,MAAM,OAAO,qBAAqB;IAEb;IACA;IAFnB,YACmB,QAAyB,EACzB,SAA8B,6BAA6B;QAD3D,aAAQ,GAAR,QAAQ,CAAiB;QACzB,WAAM,GAAN,MAAM,CAAqD;IAC3E,CAAC;IAEJ;;OAEG;IACH,KAAK,CAAC,mBAAmB,CACvB,OAAe,EACf,IAAY,EACZ,aAAwB,EACxB,YAAqB;QAErB,MAAM,GAAG,GAAG,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC;QAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;QAElD,+BAA+B;QAC/B,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAE9D,uCAAuC;QACvC,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAC1C,OAAO;YACP,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,IAAI,EAAE,CAAC;SAClE,CAAC,CAAC,CAAC;QAEJ,2BAA2B;QAC3B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAEzC,yBAAyB;QACzB,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CACnB,OAAe,EACf,IAAY,EACZ,aAAwB,EACxB,OAAiC;QAEjC,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC;QAC/E,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,qBAAqB,CAAC;QAE1E,yBAAyB;QACzB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAC9C,OAAO,EACP,IAAI,EACJ,aAAa,EACb,YAAY,CACb,CAAC;QAEF,yBAAyB;QACzB,MAAM,iBAAiB,GAAa,EAAE,CAAC;QACvC,MAAM,YAAY,GAAa,EAAE,CAAC;QAClC,IAAI,aAAa,GAAG,CAAC,CAAC;QACtB,IAAI,SAAS,GAAG,KAAK,CAAC;QAEtB,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE,CAAC;YAChC,MAAM,aAAa,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAE3D,IAAI,aAAa,GAAG,aAAa,GAAG,SAAS,EAAE,CAAC;gBAC9C,SAAS,GAAG,IAAI,CAAC;gBACjB,MAAM;YACR,CAAC;YAED,MAAM,MAAM,GAAG,OAAO,EAAE,eAAe;gBACrC,CAAC,CAAC,MAAM,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,SAAS,MAAM;gBACtD,CAAC,CAAC,EAAE,CAAC;YAEP,YAAY,CAAC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;YAC5C,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAC1C,aAAa,IAAI,aAAa,CAAC;QACjC,CAAC;QAED,OAAO;YACL,OAAO;YACP,iBAAiB;YACjB,eAAe,EAAE,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC;YACjD,UAAU,EAAE,aAAa;YACzB,SAAS;SACV,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,sBAAsB,CAAC,OAAe;QAC1C,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YACxB,OAAO,EAAE,IAAI;YACb,YAAY,EAAE,OAAO;SACtB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,YAAY,CAClB,OAAgB,EAChB,SAAmB,EACnB,aAAuB;QAEvB,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,qBAAqB;QACrB,IAAI,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9C,KAAK,IAAI,GAAG,CAAC;QACf,CAAC;QAED,cAAc;QACd,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;YACrC,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;gBAC1C,KAAK,IAAI,EAAE,CAAC;YACd,CAAC;QACH,CAAC;QAED,iBAAiB;QACjB,IAAI,OAAO,CAAC,QAAQ,IAAI,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YAC3E,KAAK,IAAI,EAAE,CAAC;QACd,CAAC;QAED,oCAAoC;QACpC,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QACzE,MAAM,cAAc,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAChF,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,cAAc,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;QAE1C,iBAAiB;QACjB,KAAK,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC;QAEvC,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,IAAY;QAClC,OAAO,IAAI;aACR,KAAK,CAAC,aAAa,CAAC;aACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;aAC3B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,IAAY;QACjC,0CAA0C;QAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAyB,EACzB,MAAqC;IAErC,OAAO,IAAI,qBAAqB,CAAC,QAAQ,EAAE;QACzC,GAAG,6BAA6B;QAChC,GAAG,MAAM;KACV,CAAC,CAAC;AACL,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Ability Registry
+ *
+ * In-memory storage for abilities with filtering support.
+ */
+import type { Ability } from '@defai.digital/contracts';
+import type { AbilityRegistry, AbilityFilter } from './types.js';
+/**
+ * In-memory ability registry implementation
+ */
+export declare class InMemoryAbilityRegistry implements AbilityRegistry {
+    private abilities;
+    register(ability: Ability): Promise<void>;
+    get(abilityId: string): Promise<Ability | undefined>;
+    list(filter?: AbilityFilter): Promise<Ability[]>;
+    remove(abilityId: string): Promise<void>;
+    exists(abilityId: string): Promise<boolean>;
+    clear(): Promise<void>;
+}
+/**
+ * Creates an in-memory ability registry
+ */
+export declare function createAbilityRegistry(): AbilityRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEjE;;GAEG;AACH,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,OAAO,CAAC,SAAS,CAA8B;IAEzC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAIpD,IAAI,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IA0ChD,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CAEvD"}

package/dist/registry.js

@@ -0,0 +1,64 @@
+/**
+ * Ability Registry
+ *
+ * In-memory storage for abilities with filtering support.
+ */
+/**
+ * In-memory ability registry implementation
+ */
+export class InMemoryAbilityRegistry {
+    abilities = new Map();
+    async register(ability) {
+        this.abilities.set(ability.abilityId, ability);
+    }
+    async get(abilityId) {
+        return this.abilities.get(abilityId);
+    }
+    async list(filter) {
+        let results = Array.from(this.abilities.values());
+        if (filter) {
+            if (filter.category !== undefined) {
+                results = results.filter((a) => a.category === filter.category);
+            }
+            if (filter.tags !== undefined && filter.tags.length > 0) {
+                results = results.filter((a) => filter.tags.some((tag) => a.tags?.includes(tag)));
+            }
+            if (filter.enabled !== undefined) {
+                results = results.filter((a) => a.enabled === filter.enabled);
+            }
+            if (filter.applicableTo !== undefined) {
+                results = results.filter((a) => {
+                    // Check if excluded
+                    if (a.excludeFrom?.includes(filter.applicableTo)) {
+                        return false;
+                    }
+                    // Check if applicable (empty means all)
+                    if (!a.applicableTo || a.applicableTo.length === 0) {
+                        return true;
+                    }
+                    return (a.applicableTo.includes('*') ||
+                        a.applicableTo.includes(filter.applicableTo));
+                });
+            }
+        }
+        // Sort by priority (higher first)
+        results.sort((a, b) => (b.priority ?? 50) - (a.priority ?? 50));
+        return results;
+    }
+    async remove(abilityId) {
+        this.abilities.delete(abilityId);
+    }
+    async exists(abilityId) {
+        return this.abilities.has(abilityId);
+    }
+    async clear() {
+        this.abilities.clear();
+    }
+}
+/**
+ * Creates an in-memory ability registry
+ */
+export function createAbilityRegistry() {
+    return new InMemoryAbilityRegistry();
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Ability Domain Types
+ */
+import { type Ability, type AbilityInjectionResult } from '@defai.digital/contracts';
+/**
+ * Ability registry interface
+ */
+export interface AbilityRegistry {
+    /**
+     * Register an ability
+     */
+    register(ability: Ability): Promise<void>;
+    /**
+     * Get an ability by ID
+     */
+    get(abilityId: string): Promise<Ability | undefined>;
+    /**
+     * List all abilities
+     */
+    list(filter?: AbilityFilter): Promise<Ability[]>;
+    /**
+     * Remove an ability
+     */
+    remove(abilityId: string): Promise<void>;
+    /**
+     * Check if ability exists
+     */
+    exists(abilityId: string): Promise<boolean>;
+    /**
+     * Clear all abilities
+     */
+    clear(): Promise<void>;
+}
+/**
+ * Filter for listing abilities
+ */
+export interface AbilityFilter {
+    category?: string;
+    tags?: string[];
+    enabled?: boolean;
+    applicableTo?: string;
+}
+/**
+ * Ability loader interface
+ */
+export interface AbilityLoader {
+    /**
+     * Load an ability by ID
+     */
+    load(abilityId: string): Promise<Ability | undefined>;
+    /**
+     * Load all abilities from the source
+     */
+    loadAll(): Promise<Ability[]>;
+    /**
+     * Check if ability exists
+     */
+    exists(abilityId: string): Promise<boolean>;
+    /**
+     * Reload abilities from source
+     */
+    reload(): Promise<void>;
+}
+/**
+ * Ability loader configuration
+ */
+export interface AbilityLoaderConfig {
+    /** Directory to load abilities from */
+    abilitiesDir: string;
+    /** File extensions to load */
+    extensions?: string[];
+}
+/**
+ * Ability manager interface - coordinates loading and injection
+ */
+export interface AbilityManager {
+    /**
+     * Get abilities for an agent based on task
+     */
+    getAbilitiesForTask(agentId: string, task: string, coreAbilities?: string[], maxAbilities?: number): Promise<Ability[]>;
+    /**
+     * Inject abilities into agent context
+     */
+    injectAbilities(agentId: string, task: string, coreAbilities?: string[], options?: AbilityInjectionOptions): Promise<AbilityInjectionResult>;
+    /**
+     * Get all abilities applicable to an agent
+     */
+    getApplicableAbilities(agentId: string): Promise<Ability[]>;
+}
+/**
+ * Options for ability injection
+ */
+export interface AbilityInjectionOptions {
+    maxAbilities?: number;
+    maxTokens?: number;
+    includeMetadata?: boolean;
+}
+/**
+ * Ability domain configuration
+ */
+export interface AbilityDomainConfig {
+    abilitiesDir: string;
+    maxAbilitiesPerAgent: number;
+    maxTokensPerInjection: number;
+    cacheEnabled: boolean;
+}
+/**
+ * Default ability domain configuration
+ */
+export declare const DEFAULT_ABILITY_DOMAIN_CONFIG: AbilityDomainConfig;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,sBAAsB,EAG5B,MAAM,0BAA0B,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IAErD;;OAEG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAEjD;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5C;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IAEtD;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAE9B;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5C;;OAEG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,mBAAmB,CACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,aAAa,CAAC,EAAE,MAAM,EAAE,EACxB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAEtB;;OAEG;IACH,eAAe,CACb,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,aAAa,CAAC,EAAE,MAAM,EAAE,EACxB,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAEnC;;OAEG;IACH,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;CAC7D;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,6BAA6B,EAAE,mBAK3C,CAAC"}

package/dist/types.js

@@ -0,0 +1,14 @@
+/**
+ * Ability Domain Types
+ */
+import { LIMIT_ABILITY_TOKENS, LIMIT_ABILITIES_INJECT, } from '@defai.digital/contracts';
+/**
+ * Default ability domain configuration
+ */
+export const DEFAULT_ABILITY_DOMAIN_CONFIG = {
+    abilitiesDir: 'examples/abilities',
+    maxAbilitiesPerAgent: LIMIT_ABILITIES_INJECT,
+    maxTokensPerInjection: LIMIT_ABILITY_TOKENS,
+    cacheEnabled: true,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAGL,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAmIlC;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAwB;IAChE,YAAY,EAAE,oBAAoB;IAClC,oBAAoB,EAAE,sBAAsB;IAC5C,qBAAqB,EAAE,oBAAoB;IAC3C,YAAY,EAAE,IAAI;CACnB,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@defai.digital/ability-domain",
+  "version": "13.0.3",
+  "type": "module",
+  "description": "Ability management for AutomatosX agents",
+  "license": "Apache-2.0",
+  "author": "DEFAI Private Limited",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/defai-digital/automatosx.git",
+    "directory": "packages/core/ability-domain"
+  },
+  "homepage": "https://github.com/defai-digital/automatosx#readme",
+  "bugs": {
+    "url": "https://github.com/defai-digital/automatosx/issues"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@defai.digital/contracts": "13.0.3"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.2"
+  },
+  "peerDependencies": {
+    "zod": "^3.23.0"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rm -rf dist"
+  }
+}

package/src/index.ts

@@ -0,0 +1,50 @@
+/**
+ * @defai.digital/ability-domain
+ *
+ * Ability management for AutomatosX agents.
+ * Abilities are reusable knowledge modules that can be loaded
+ * into agent contexts based on task requirements.
+ */
+
+// Types
+export type {
+  AbilityRegistry,
+  AbilityFilter,
+  AbilityLoader,
+  AbilityLoaderConfig,
+  AbilityManager,
+  AbilityInjectionOptions,
+  AbilityDomainConfig,
+} from './types.js';
+
+export { DEFAULT_ABILITY_DOMAIN_CONFIG } from './types.js';
+
+// Registry
+export { InMemoryAbilityRegistry, createAbilityRegistry } from './registry.js';
+
+// Loader
+export { FileSystemAbilityLoader, createAbilityLoader } from './loader.js';
+
+// Manager
+export { DefaultAbilityManager, createAbilityManager } from './manager.js';
+
+// Re-export contract types
+export type {
+  Ability,
+  AbilityManifest,
+  AbilityLoadResult,
+  AbilityInjectionRequest,
+  AbilityInjectionResult,
+} from '@defai.digital/contracts';
+
+export {
+  AbilitySchema,
+  AbilityManifestSchema,
+  AbilityLoadResultSchema,
+  AbilityInjectionRequestSchema,
+  AbilityInjectionResultSchema,
+  AbilityErrorCode,
+  validateAbility,
+  safeValidateAbility,
+  validateAbilityInjectionRequest,
+} from '@defai.digital/contracts';

package/src/loader.ts

@@ -0,0 +1,209 @@
+/**
+ * Ability Loader
+ *
+ * Loads abilities from markdown files.
+ * Format: Each .md file is an ability with YAML frontmatter for metadata.
+ */
+
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import type { Ability } from '@defai.digital/contracts';
+import { validateAbility } from '@defai.digital/contracts';
+import type { AbilityLoader, AbilityLoaderConfig } from './types.js';
+
+// ============================================================================
+// Constants
+// ============================================================================
+
+const DEFAULT_EXTENSIONS = ['.md'];
+
+// ============================================================================
+// File System Ability Loader
+// ============================================================================
+
+/**
+ * Loads abilities from markdown files
+ */
+export class FileSystemAbilityLoader implements AbilityLoader {
+  private readonly config: Required<AbilityLoaderConfig>;
+  private cache = new Map<string, Ability>();
+  private loaded = false;
+
+  constructor(config: AbilityLoaderConfig) {
+    this.config = {
+      abilitiesDir: config.abilitiesDir,
+      extensions: config.extensions ?? DEFAULT_EXTENSIONS,
+    };
+  }
+
+  async load(abilityId: string): Promise<Ability | undefined> {
+    if (!this.loaded) {
+      await this.loadAll();
+    }
+    return this.cache.get(abilityId);
+  }
+
+  async loadAll(): Promise<Ability[]> {
+    this.cache.clear();
+
+    const dirPath = this.config.abilitiesDir;
+
+    if (!fs.existsSync(dirPath)) {
+      this.loaded = true;
+      return [];
+    }
+
+    const files = fs.readdirSync(dirPath);
+    const abilities: Ability[] = [];
+
+    for (const file of files) {
+      const ext = path.extname(file).toLowerCase();
+      if (!this.config.extensions.includes(ext)) {
+        continue;
+      }
+
+      const filePath = path.join(dirPath, file);
+      const ability = await this.loadFile(filePath, file);
+
+      if (ability) {
+        if (this.cache.has(ability.abilityId)) {
+          console.warn(
+            `Duplicate ability ID "${ability.abilityId}" in ${file}, skipping`
+          );
+          continue;
+        }
+
+        this.cache.set(ability.abilityId, ability);
+        abilities.push(ability);
+      }
+    }
+
+    this.loaded = true;
+    return abilities;
+  }
+
+  async exists(abilityId: string): Promise<boolean> {
+    if (!this.loaded) {
+      await this.loadAll();
+    }
+    return this.cache.has(abilityId);
+  }
+
+  async reload(): Promise<void> {
+    this.loaded = false;
+    await this.loadAll();
+  }
+
+  /**
+   * Load an ability from a markdown file
+   */
+  private async loadFile(
+    filePath: string,
+    fileName: string
+  ): Promise<Ability | undefined> {
+    try {
+      const content = fs.readFileSync(filePath, 'utf-8');
+      const { metadata, body } = this.parseMarkdown(content);
+
+      // Generate ability ID from filename if not in metadata
+      const abilityId = typeof metadata.abilityId === 'string'
+        ? metadata.abilityId
+        : fileName.replace(/\.md$/i, '').toLowerCase().replace(/[^a-z0-9-]/g, '-');
+
+      const ability: Ability = {
+        abilityId,
+        displayName: typeof metadata.displayName === 'string' ? metadata.displayName : this.titleCase(abilityId),
+        version: typeof metadata.version === 'string' ? metadata.version : undefined,
+        description: typeof metadata.description === 'string' ? metadata.description : undefined,
+        category: typeof metadata.category === 'string' ? metadata.category : undefined,
+        tags: Array.isArray(metadata.tags) ? metadata.tags as string[] : undefined,
+        content: body.trim(),
+        author: typeof metadata.author === 'string' ? metadata.author : undefined,
+        source: typeof metadata.source === 'string' ? metadata.source : undefined,
+        requires: Array.isArray(metadata.requires) ? metadata.requires as string[] : undefined,
+        conflicts: Array.isArray(metadata.conflicts) ? metadata.conflicts as string[] : undefined,
+        applicableTo: Array.isArray(metadata.applicableTo) ? metadata.applicableTo as string[] : undefined,
+        excludeFrom: Array.isArray(metadata.excludeFrom) ? metadata.excludeFrom as string[] : undefined,
+        priority: typeof metadata.priority === 'number' ? metadata.priority : 50,
+        enabled: typeof metadata.enabled === 'boolean' ? metadata.enabled : true,
+      };
+
+      // Validate
+      return validateAbility(ability);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : 'Unknown error';
+      console.warn(`Failed to load ability from ${filePath}: ${message}`);
+      return undefined;
+    }
+  }
+
+  /**
+   * Parse markdown with optional YAML frontmatter
+   */
+  private parseMarkdown(content: string): {
+    metadata: Record<string, unknown>;
+    body: string;
+  } {
+    const frontmatterRegex = /^---\n([\s\S]*?)\n---\n([\s\S]*)$/;
+    const match = frontmatterRegex.exec(content);
+
+    if (!match) {
+      return { metadata: {}, body: content };
+    }
+
+    const frontmatter = match[1]!;
+    const body = match[2]!;
+
+    // Simple YAML parser for frontmatter
+    const metadata: Record<string, unknown> = {};
+    const lines = frontmatter.split('\n');
+
+    for (const line of lines) {
+      const colonIndex = line.indexOf(':');
+      if (colonIndex === -1) continue;
+
+      const key = line.substring(0, colonIndex).trim();
+      let value: unknown = line.substring(colonIndex + 1).trim();
+
+      // Parse arrays
+      if (value === '') {
+        // Check if next lines are array items
+        continue;
+      }
+
+      // Parse booleans
+      if (value === 'true') value = true;
+      else if (value === 'false') value = false;
+      // Parse numbers
+      else if (/^\d+$/.test(value as string)) value = parseInt(value as string, 10);
+      // Parse arrays (simple inline format)
+      else if ((value as string).startsWith('[') && (value as string).endsWith(']')) {
+        value = (value as string)
+          .slice(1, -1)
+          .split(',')
+          .map((s) => s.trim().replace(/^['"]|['"]$/g, ''));
+      }
+
+      metadata[key] = value;
+    }
+
+    return { metadata, body };
+  }
+
+  /**
+   * Convert kebab-case to Title Case
+   */
+  private titleCase(str: string): string {
+    return str
+      .split('-')
+      .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+      .join(' ');
+  }
+}
+
+/**
+ * Creates a file system ability loader
+ */
+export function createAbilityLoader(config: AbilityLoaderConfig): AbilityLoader {
+  return new FileSystemAbilityLoader(config);
+}