pi-kot 0.1.21 → 0.1.22

package/server/extension-manager.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Extension manager — runtime discovery + install for pi.dev extensions.
+ * Scans ~/.pi/agent/ for installed extensions, agents, and packages,
+ * and exposes a curated recommendation catalog optimised for pi-kot.
+ *
+ * Architecture: extension dynamic detection pattern:
+ *   detect → activate — UI features light up based on what's installed.
+ *
+ * Update checking:
+ *   checkExtensionUpdates() compares installed vs. npm registry latest.
+ *   updateExtension() runs npm install to upgrade to latest.
+ */
+export interface DiscoveredExtension {
+    /** Package / extension name */
+    name: string;
+    /** Where it was found: 'extensions_dir' | 'agents_dir' | 'package' | 'builtin' */
+    source: "extensions_dir" | "agents_dir" | "package" | "builtin";
+    /** Human description */
+    description: string;
+    /** Version string if available */
+    version?: string;
+    /** Original package identifier (e.g. "npm:@ayulab/pi-rewind"). Only set for package source. */
+    package?: string;
+    /** The agent type definitions this extension provides (e.g. scout, planner) */
+    agentTypes?: string[];
+    /** What UI features this extension enables */
+    enablesFeatures?: string[];
+}
+export interface RecommendedExtension {
+    id: string;
+    name: string;
+    description: string;
+    /** npm package name (including npm: prefix for pi) */
+    package: string;
+    /** Category for grouping in UI */
+    category: "orchestration" | "tools" | "ui" | "integration" | "productivity";
+    /** Whether this extension is already installed */
+    installed: boolean;
+    /** True when this extension has been tested and verified to work with pi-kot */
+    verified?: boolean;
+    /** What agent types this extension provides */
+    providesAgentTypes?: string[];
+    /** What UI features this enables */
+    enablesFeatures?: string[];
+    /** Icon emoji */
+    icon: string;
+}
+export interface ExtensionsResponse {
+    /** Extensions currently detected in the pi agent directory */
+    detected: DiscoveredExtension[];
+    /** Curated recommendations optimised for pi-kot */
+    recommended: RecommendedExtension[];
+    /** Agent definitions found (scout, planner, etc.) */
+    agents: AgentDef[];
+}
+export interface AgentDef {
+    name: string;
+    description: string;
+    model?: string;
+    tools?: string[];
+    source: "file" | "builtin";
+}
+export declare function discoverExtensions(): Promise<ExtensionsResponse>;
+export declare function uninstallExtension(packageName: string): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+export declare function installExtension(packageName: string): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+export interface ExtensionUpdateInfo {
+    /** npm package name (without npm: prefix) */
+    package: string;
+    /** Display name */
+    name: string;
+    /** Currently installed version from node_modules/package.json */
+    installed: string | undefined;
+    /** Latest version available on npm registry */
+    latest: string | undefined;
+    /** Whether a newer version is available */
+    updateAvailable: boolean;
+}
+/** Clear the update cache so the next `checkExtensionUpdates()` hits npm fresh. */
+export declare function clearExtensionCache(): void;
+/**
+ * Check for updates on all installed npm packages.
+ * Reads installed versions from node_modules, then fetches latest
+ * from registry.npmjs.org. Results are cached for 60 seconds.
+ */
+export declare function checkExtensionUpdates(): Promise<ExtensionUpdateInfo[]>;
+/**
+ * Manual install — accepts any pi install spec through the SDK config path
+ * (settings.json + npm install). No CLI dependency.
+ *
+ * Supported formats:
+ *   npm:package-name    → npm install
+ *   git:github.com/user/repo → npm install via git URL
+ *   pi install <spec>   → strips prefix first (user typed the full command)
+ */
+export declare function installManualExtension(installSpec: string): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * Update an installed extension to the latest version via npm install.
+ * Equivalent to re-running the install but without touching settings.json
+ * (since it's already in the packages list).
+ */
+export declare function updateExtension(packageName: string): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/** Built-in agent definitions (builtin defaults like pi-subagents examples) */
+export declare const builtinAgentDefs: AgentDef[];
+//# sourceMappingURL=extension-manager.d.ts.map

package/server/extension-manager.d.ts.map

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