@framers/agentos 0.1.28 → 0.1.30

package/dist/discovery/types.d.ts

@@ -0,0 +1,357 @@
+/**
+ * @fileoverview Core types for the Capability Discovery Engine.
+ * @module @framers/agentos/discovery/types
+ *
+ * Provides unified type definitions for normalizing tools, skills, extensions,
+ * and channels into a searchable, tiered capability discovery system.
+ *
+ * Key concepts:
+ * - CapabilityDescriptor: Unified shape for any capability in the system
+ * - Three-tier context budgeting: Always → Retrieved summaries → Full details
+ * - ICapabilityGraph: Abstraction for relationship graphs (graphology now, Neo4j later)
+ */
+import type { JSONSchemaObject } from '../core/tools/ITool.js';
+/**
+ * Kind discriminator for capability descriptors.
+ */
+export type CapabilityKind = 'tool' | 'skill' | 'extension' | 'channel' | 'voice' | 'productivity';
+/**
+ * Reference back to the original source of a capability.
+ * Used for lazy loading of full schemas/content.
+ */
+export type CapabilitySourceRef = {
+    type: 'tool';
+    toolName: string;
+} | {
+    type: 'skill';
+    skillName: string;
+    skillPath?: string;
+} | {
+    type: 'extension';
+    packageName: string;
+    extensionId: string;
+} | {
+    type: 'channel';
+    platform: string;
+} | {
+    type: 'manifest';
+    manifestPath: string;
+    entryId: string;
+};
+/**
+ * Unified representation of any capability in the system.
+ * Normalizes tools, skills, extensions, and channels into a single
+ * searchable shape for the discovery engine.
+ */
+export interface CapabilityDescriptor {
+    /**
+     * Globally unique ID.
+     * Convention: `${kind}:${name}` (e.g., "tool:web-search", "skill:github", "channel:telegram")
+     */
+    id: string;
+    /** Kind discriminator */
+    kind: CapabilityKind;
+    /** Machine-readable name (e.g., "web-search", "github", "telegram") */
+    name: string;
+    /** Human-readable display name */
+    displayName: string;
+    /**
+     * Natural language description.
+     * This is the primary text used for embedding generation — it should
+     * describe WHEN and WHY to use this capability, not just what it does.
+     */
+    description: string;
+    /** Category for coarse filtering (e.g., "information", "developer-tools", "communication") */
+    category: string;
+    /** Tags for additional matching signals */
+    tags: string[];
+    /** Required secret IDs (e.g., ["SERPER_API_KEY", "OPENAI_API_KEY"]) */
+    requiredSecrets: string[];
+    /** Required tool/binary dependencies (e.g., ["gh", "git"]) */
+    requiredTools: string[];
+    /** Whether this capability is currently available (installed, secrets present) */
+    available: boolean;
+    /** Whether this capability has side effects on external systems */
+    hasSideEffects?: boolean;
+    /**
+     * Full input/output schema (Tier 2 data — NOT embedded, loaded on demand).
+     * For tools: the JSON Schema inputSchema + outputSchema.
+     */
+    fullSchema?: JSONSchemaObject;
+    /**
+     * Full SKILL.md content or detailed documentation (Tier 2 data — NOT embedded, loaded on demand).
+     */
+    fullContent?: string;
+    /** Reference back to the original source for lazy loading */
+    sourceRef: CapabilitySourceRef;
+}
+/**
+ * Tier classification for context budget management.
+ *
+ * Tier 0: Always in context (~150 tokens) — category summaries only
+ * Tier 1: Retrieved on relevance (~200 tokens) — name + description + key params
+ * Tier 2: Deep pull (~1500 tokens) — full schema + examples + relationship context
+ */
+export declare enum CapabilityTier {
+    /** Always in context: category summaries */
+    TIER_0_ALWAYS = 0,
+    /** Retrieved on relevance: name + description + key params */
+    TIER_1_SUMMARY = 1,
+    /** Deep pull: full schema + examples + relationship context */
+    TIER_2_FULL = 2
+}
+/**
+ * A Tier 1 search result with relevance scoring.
+ */
+export interface Tier1Result {
+    capability: CapabilityDescriptor;
+    relevanceScore: number;
+    /** Compact summary text (~30-50 tokens per capability) */
+    summaryText: string;
+}
+/**
+ * A Tier 2 full-detail result.
+ */
+export interface Tier2Result {
+    capability: CapabilityDescriptor;
+    /** Full schema/content text for injection into context */
+    fullText: string;
+}
+/**
+ * Token budget tracking for a discovery result.
+ */
+export interface TokenEstimate {
+    tier0Tokens: number;
+    tier1Tokens: number;
+    tier2Tokens: number;
+    totalTokens: number;
+}
+/**
+ * Performance diagnostics for a discovery query.
+ */
+export interface DiscoveryDiagnostics {
+    queryTimeMs: number;
+    embeddingTimeMs: number;
+    graphTraversalTimeMs: number;
+    candidatesScanned: number;
+    capabilitiesRetrieved: number;
+}
+/**
+ * Complete result of a capability discovery query.
+ * Contains all three tiers of context, plus diagnostics.
+ */
+export interface CapabilityDiscoveryResult {
+    /** Tier 0: always-present category summaries */
+    tier0: string;
+    /** Tier 1: retrieved capability summaries with scores */
+    tier1: Tier1Result[];
+    /** Tier 2: full details for top-selected capabilities */
+    tier2: Tier2Result[];
+    /** Token budget tracking */
+    tokenEstimate: TokenEstimate;
+    /** Discovery diagnostics */
+    diagnostics: DiscoveryDiagnostics;
+}
+/**
+ * Configuration for the Capability Discovery Engine.
+ */
+export interface CapabilityDiscoveryConfig {
+    /** Maximum tokens for Tier 0 context. @default 200 */
+    tier0TokenBudget: number;
+    /** Maximum tokens for Tier 1 retrievals. @default 800 */
+    tier1TokenBudget: number;
+    /** Maximum tokens for Tier 2 full pulls. @default 2000 */
+    tier2TokenBudget: number;
+    /** Number of Tier 1 candidates to retrieve. @default 5 */
+    tier1TopK: number;
+    /** Number of Tier 2 candidates to fully expand. @default 2 */
+    tier2TopK: number;
+    /** Minimum relevance score for Tier 1 inclusion (0-1). @default 0.3 */
+    tier1MinRelevance: number;
+    /** Whether to use graph relationships for re-ranking. @default true */
+    useGraphReranking: boolean;
+    /** Vector store collection name for capability embeddings. @default 'capability_index' */
+    collectionName: string;
+    /** Embedding model ID to use (undefined = use default). */
+    embeddingModelId?: string;
+    /** Graph-based boost factor for related capabilities (0-1). @default 0.15 */
+    graphBoostFactor: number;
+}
+/**
+ * Default configuration values.
+ */
+export declare const DEFAULT_DISCOVERY_CONFIG: Readonly<CapabilityDiscoveryConfig>;
+/**
+ * Edge types in the capability relationship graph.
+ */
+export type CapabilityEdgeType = 'DEPENDS_ON' | 'COMPOSED_WITH' | 'SAME_CATEGORY' | 'TAGGED_WITH';
+/**
+ * A relationship edge between two capabilities.
+ */
+export interface CapabilityEdge {
+    sourceId: string;
+    targetId: string;
+    type: CapabilityEdgeType;
+    weight: number;
+}
+/**
+ * A related capability returned from graph traversal.
+ */
+export interface RelatedCapability {
+    id: string;
+    weight: number;
+    relationType: CapabilityEdgeType;
+}
+/**
+ * Abstraction for capability relationship graphs.
+ * Implemented by graphology now; can be swapped for Neo4j later.
+ */
+export interface ICapabilityGraph {
+    /**
+     * Build the graph from capability descriptors and preset co-occurrence data.
+     */
+    buildGraph(capabilities: CapabilityDescriptor[], presetCoOccurrences?: PresetCoOccurrence[]): void;
+    /**
+     * Get capabilities related to a given capability (1-hop neighbors).
+     */
+    getRelated(capabilityId: string): RelatedCapability[];
+    /**
+     * Get the subgraph for a set of capability IDs.
+     */
+    getSubgraph(capabilityIds: string[]): {
+        nodes: string[];
+        edges: CapabilityEdge[];
+    };
+    /** Number of nodes in the graph. */
+    nodeCount(): number;
+    /** Number of edges in the graph. */
+    edgeCount(): number;
+    /** Clear the graph. */
+    clear(): void;
+}
+/**
+ * Co-occurrence data from agent presets.
+ * Captures which capabilities are suggested together.
+ */
+export interface PresetCoOccurrence {
+    presetName: string;
+    capabilityIds: string[];
+}
+/**
+ * A scored search result from the capability index.
+ */
+export interface CapabilitySearchResult {
+    descriptor: CapabilityDescriptor;
+    score: number;
+}
+/**
+ * Sources for building the capability index.
+ */
+export interface CapabilityIndexSources {
+    /** Tool descriptors (from ToolOrchestrator or ITool[]) */
+    tools?: Array<{
+        id: string;
+        name: string;
+        displayName: string;
+        description: string;
+        category?: string;
+        inputSchema: JSONSchemaObject;
+        outputSchema?: JSONSchemaObject;
+        requiredCapabilities?: string[];
+        hasSideEffects?: boolean;
+    }>;
+    /** Skill entries (from SkillRegistry) */
+    skills?: Array<{
+        name: string;
+        description: string;
+        content: string;
+        category?: string;
+        tags?: string[];
+        requiredSecrets?: string[];
+        requiredTools?: string[];
+        sourcePath?: string;
+        metadata?: {
+            primaryEnv?: string;
+            requires?: {
+                bins?: string[];
+            };
+        };
+    }>;
+    /** Extension catalog entries */
+    extensions?: Array<{
+        id: string;
+        name: string;
+        displayName: string;
+        description: string;
+        category: string;
+        requiredSecrets?: string[];
+        available?: boolean;
+    }>;
+    /** Channel catalog entries */
+    channels?: Array<{
+        platform: string;
+        displayName: string;
+        description: string;
+        tier?: string;
+        capabilities?: string[];
+    }>;
+    /** File-based manifest entries */
+    manifests?: CapabilityDescriptor[];
+}
+/**
+ * Structure of a CAPABILITY.yaml manifest file.
+ */
+export interface CapabilityManifestFile {
+    id: string;
+    kind: CapabilityKind;
+    name: string;
+    displayName: string;
+    description: string;
+    category: string;
+    tags?: string[];
+    requiredSecrets?: string[];
+    requiredTools?: string[];
+    hasSideEffects?: boolean;
+    inputSchema?: JSONSchemaObject;
+    skillContent?: string;
+}
+/**
+ * Options for a discovery query.
+ */
+export interface DiscoveryQueryOptions {
+    /** Override default config for this query */
+    config?: Partial<CapabilityDiscoveryConfig>;
+    /** Filter by capability kind */
+    kind?: CapabilityKind | 'any';
+    /** Filter by category */
+    category?: string;
+    /** Only include available capabilities */
+    onlyAvailable?: boolean;
+}
+/**
+ * The main Capability Discovery Engine interface.
+ */
+export interface ICapabilityDiscoveryEngine {
+    /**
+     * Initialize the engine: build index + graph from all sources.
+     */
+    initialize(sources: CapabilityIndexSources): Promise<void>;
+    /**
+     * Discover capabilities relevant to a user message.
+     * Returns a tiered, token-budgeted result.
+     */
+    discover(userMessage: string, options?: DiscoveryQueryOptions): Promise<CapabilityDiscoveryResult>;
+    /**
+     * Get full detail for a specific capability (Tier 2 pull).
+     */
+    getCapabilityDetail(id: string): CapabilityDescriptor | undefined;
+    /**
+     * Refresh the index incrementally (e.g., after manifest file changes).
+     */
+    refreshIndex(sources?: Partial<CapabilityIndexSources>): Promise<void>;
+    /** Whether the engine is initialized. */
+    isInitialized(): boolean;
+    /** Get all registered capability IDs. */
+    listCapabilityIds(): string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/discovery/types.d.ts.map

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

package/dist/discovery/types.js

@@ -0,0 +1,46 @@
+/**
+ * @fileoverview Core types for the Capability Discovery Engine.
+ * @module @framers/agentos/discovery/types
+ *
+ * Provides unified type definitions for normalizing tools, skills, extensions,
+ * and channels into a searchable, tiered capability discovery system.
+ *
+ * Key concepts:
+ * - CapabilityDescriptor: Unified shape for any capability in the system
+ * - Three-tier context budgeting: Always → Retrieved summaries → Full details
+ * - ICapabilityGraph: Abstraction for relationship graphs (graphology now, Neo4j later)
+ */
+// ============================================================================
+// TIER SYSTEM
+// ============================================================================
+/**
+ * Tier classification for context budget management.
+ *
+ * Tier 0: Always in context (~150 tokens) — category summaries only
+ * Tier 1: Retrieved on relevance (~200 tokens) — name + description + key params
+ * Tier 2: Deep pull (~1500 tokens) — full schema + examples + relationship context
+ */
+export var CapabilityTier;
+(function (CapabilityTier) {
+    /** Always in context: category summaries */
+    CapabilityTier[CapabilityTier["TIER_0_ALWAYS"] = 0] = "TIER_0_ALWAYS";
+    /** Retrieved on relevance: name + description + key params */
+    CapabilityTier[CapabilityTier["TIER_1_SUMMARY"] = 1] = "TIER_1_SUMMARY";
+    /** Deep pull: full schema + examples + relationship context */
+    CapabilityTier[CapabilityTier["TIER_2_FULL"] = 2] = "TIER_2_FULL";
+})(CapabilityTier || (CapabilityTier = {}));
+/**
+ * Default configuration values.
+ */
+export const DEFAULT_DISCOVERY_CONFIG = {
+    tier0TokenBudget: 200,
+    tier1TokenBudget: 800,
+    tier2TokenBudget: 2000,
+    tier1TopK: 5,
+    tier2TopK: 2,
+    tier1MinRelevance: 0.3,
+    useGraphReranking: true,
+    collectionName: 'capability_index',
+    graphBoostFactor: 0.15,
+};
+//# sourceMappingURL=types.js.map

package/dist/discovery/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/discovery/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAqFH,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,cAOX;AAPD,WAAY,cAAc;IACxB,4CAA4C;IAC5C,qEAAiB,CAAA;IACjB,8DAA8D;IAC9D,uEAAkB,CAAA;IAClB,+DAA+D;IAC/D,iEAAe,CAAA;AACjB,CAAC,EAPW,cAAc,KAAd,cAAc,QAOzB;AA6FD;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAwC;IAC3E,gBAAgB,EAAE,GAAG;IACrB,gBAAgB,EAAE,GAAG;IACrB,gBAAgB,EAAE,IAAI;IACtB,SAAS,EAAE,CAAC;IACZ,SAAS,EAAE,CAAC;IACZ,iBAAiB,EAAE,GAAG;IACtB,iBAAiB,EAAE,IAAI;IACvB,cAAc,EAAE,kBAAkB;IAClC,gBAAgB,EAAE,IAAI;CACvB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framers/agentos",
-  "version": "0.1.28",
+  "version": "0.1.30",
   "description": "Modular AgentOS orchestration library",
   "type": "module",
   "main": "dist/index.js",
@@ -88,6 +88,11 @@
       "default": "./dist/core/tools/*.js",
       "types": "./dist/core/tools/*.d.ts"
     },
+    "./discovery": {
+      "import": "./dist/discovery/index.js",
+      "default": "./dist/discovery/index.js",
+      "types": "./dist/discovery/index.d.ts"
+    },
     "./package.json": "./package.json",
     "./*": {
       "import": "./dist/*.js",