@nodeskai/genehub-sdk 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,187 @@
+import { GeneAdapter, GeneManifest, InstallOptions, InstallResult, UninstallResult, UninstallOptions, InstalledGene, GeneListParams, PaginatedData, Gene, GeneVersion, Genome, ResolvedGene } from '@nodeskai/genehub-types';
+
+declare abstract class BaseAdapter implements GeneAdapter {
+    abstract readonly product: string;
+    abstract detect(): Promise<boolean>;
+    install(manifest: GeneManifest, options?: InstallOptions): Promise<InstallResult>;
+    protected abstract doInstall(manifest: GeneManifest, options?: InstallOptions): Promise<InstallResult>;
+    protected onPostInstall(_manifest: GeneManifest, _result: InstallResult): Promise<void>;
+    protected onPostUninstall(_slug: string, _result: UninstallResult): Promise<void>;
+    uninstall(slug: string, options?: UninstallOptions): Promise<UninstallResult>;
+    protected abstract doUninstall(slug: string, options?: UninstallOptions): Promise<UninstallResult>;
+    abstract list(): Promise<InstalledGene[]>;
+    abstract isInstalled(slug: string): Promise<boolean>;
+    abstract getInstalledVersion(slug: string): Promise<string | null>;
+    protected generateSkillContent(manifest: GeneManifest, metadataNamespace: string): string;
+    protected parseSkillVersion(content: string): string | null;
+}
+
+declare class GenericAdapter extends BaseAdapter {
+    readonly product = "generic";
+    private genesDir;
+    constructor(options?: {
+        genesDir?: string;
+    });
+    detect(): Promise<boolean>;
+    protected doInstall(manifest: GeneManifest, options?: InstallOptions): Promise<InstallResult>;
+    protected doUninstall(slug: string, _options?: UninstallOptions): Promise<UninstallResult>;
+    list(): Promise<InstalledGene[]>;
+    isInstalled(slug: string): Promise<boolean>;
+    getInstalledVersion(slug: string): Promise<string | null>;
+}
+
+declare function detectAdapter(): Promise<GeneAdapter>;
+declare function getAdapter(product: string): GeneAdapter;
+
+declare class NanobotAdapter extends BaseAdapter {
+    readonly product = "nanobot";
+    private workspace;
+    constructor(options?: {
+        workspace?: string;
+    });
+    private get skillsDir();
+    detect(): Promise<boolean>;
+    protected doInstall(manifest: GeneManifest, options?: InstallOptions): Promise<InstallResult>;
+    protected onPostInstall(manifest: GeneManifest, _result: InstallResult): Promise<void>;
+    protected doUninstall(slug: string, _options?: UninstallOptions): Promise<UninstallResult>;
+    protected onPostUninstall(slug: string, _result: UninstallResult): Promise<void>;
+    list(): Promise<InstalledGene[]>;
+    isInstalled(slug: string): Promise<boolean>;
+    getInstalledVersion(slug: string): Promise<string | null>;
+    private writeMemoryEntry;
+    private buildNanobotSkillContent;
+    private mergeNanobotMcpConfig;
+}
+
+declare class OpenClawAdapter extends BaseAdapter {
+    readonly product = "openclaw";
+    private skillsDir;
+    private configPath;
+    private configDir;
+    private workspaceDir;
+    constructor(options?: {
+        skillsDir?: string;
+        configPath?: string;
+        workspaceDir?: string;
+        configDir?: string;
+    });
+    detect(): Promise<boolean>;
+    protected doInstall(manifest: GeneManifest, options?: InstallOptions): Promise<InstallResult>;
+    protected onPostInstall(manifest: GeneManifest, _result: InstallResult): Promise<void>;
+    protected doUninstall(slug: string, _options?: UninstallOptions): Promise<UninstallResult>;
+    protected onPostUninstall(slug: string, _result: UninstallResult): Promise<void>;
+    list(): Promise<InstalledGene[]>;
+    isInstalled(slug: string): Promise<boolean>;
+    getInstalledVersion(slug: string): Promise<string | null>;
+    private updateAgentsMd;
+    private writeMemoryEntry;
+    private mergeOpenClawConfig;
+    private mergeMcpServers;
+    notifySkillChange(geneName: string, action: 'installed' | 'updated' | 'uninstalled'): Promise<void>;
+    /**
+     * Clear cached skillsSnapshot from all OpenClaw sessions.
+     * Without this, OpenClaw keeps using the stale skill list even after restart.
+     */
+    private invalidateSkillSnapshots;
+    /**
+     * Inject evolution notification into all active session JSONL files.
+     *
+     * Old conversation history may contain stale skill listings from the agent.
+     * The LLM repeats its previous answer instead of re-checking the system prompt.
+     * By appending a user+assistant message pair about the evolution, we override
+     * the stale context. Also resets systemSent to force system prompt rebuild.
+     */
+    private injectEvolutionNotification;
+}
+
+type GeneHubClientOptions = {
+    registryUrl: string;
+    token?: string;
+};
+declare class GeneHubClient {
+    private baseUrl;
+    private token?;
+    constructor(options: GeneHubClientOptions);
+    private request;
+    searchGenes(params?: GeneListParams): Promise<PaginatedData<Gene>>;
+    getGene(slug: string): Promise<Gene>;
+    getManifest(slug: string, version?: string): Promise<GeneManifest>;
+    getVersions(slug: string): Promise<GeneVersion[]>;
+    getVersion(slug: string, version: string): Promise<GeneVersion>;
+    getGenome(slug: string): Promise<Genome>;
+    publishGene(manifest: GeneManifest): Promise<Gene>;
+    publishVersion(slug: string, manifest: GeneManifest, changelog?: string): Promise<Gene>;
+    resolve(slug: string, version?: string, product?: string): Promise<{
+        plan: ResolvedGene[];
+        warnings: string[];
+    }>;
+    reportInstall(slug: string): Promise<void>;
+    reportEffectiveness(slug: string, report: {
+        metric_type: string;
+        value: number;
+        context?: string;
+    }): Promise<void>;
+}
+
+type LearningMode = 'learn' | 'create' | 'forget';
+type LearningScenario = {
+    title: string;
+    context: string;
+    expected_focus: string;
+};
+type LearningTask = {
+    mode: LearningMode;
+    task_id: string;
+    gene_slug: string;
+    gene_name: string;
+    gene_version: string;
+    gene_content: string;
+    gene_meta: {
+        name: string;
+        description: string;
+        category: string;
+        short_description: string;
+    };
+    learning?: {
+        objectives?: string[];
+        scenarios?: LearningScenario[];
+        force_deep_learn?: boolean;
+    };
+    callback_path: string;
+    created_at: string;
+};
+type LearningDecision = 'direct_install' | 'learned' | 'failed' | 'created' | 'forgotten' | 'simplified' | 'forget_failed';
+type LearningResult = {
+    task_id: string;
+    gene_slug: string;
+    mode: LearningMode;
+    decision: LearningDecision;
+    content?: string;
+    self_eval?: number;
+    reason?: string;
+    completed_at: string;
+};
+
+type LearningEngineOptions = {
+    workspaceDir: string;
+    adapter?: GeneAdapter;
+};
+declare class LearningEngine {
+    private workspaceDir;
+    private adapter?;
+    constructor(options: LearningEngineOptions);
+    private get tasksDir();
+    private get resultsDir();
+    ensureMetaGeneInstalled(): Promise<boolean>;
+    private injectBootInstruction;
+    createLearningTask(manifest: GeneManifest): Promise<LearningTask>;
+    createForgetTask(slug: string, name: string, skillContent: string): Promise<void>;
+    checkResult(slug: string): Promise<LearningResult | null>;
+    listPendingTasks(): Promise<string[]>;
+    listCompletedResults(): Promise<LearningResult[]>;
+    applyResult(slug: string, skillsDir: string): Promise<boolean>;
+    cleanupTask(slug: string): Promise<void>;
+    private parseResult;
+}
+
+export { GeneHubClient, GenericAdapter, LearningEngine, type LearningEngineOptions, type LearningResult, type LearningTask, NanobotAdapter, OpenClawAdapter, detectAdapter, getAdapter };