universal-agent-protocol 0.10.3 → 2.0.0

package/dist/cli/uap.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * Universal Agent Protocol (UAP) CLI
+ *
+ * This is the main UAP command-line interface that works independently
+ * from opencode. It provides project initialization, configuration,
+ * and integration with various agent harnesses.
+ */
+export {};
+//# sourceMappingURL=uap.d.ts.map

package/dist/cli/uap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uap.d.ts","sourceRoot":"","sources":["../../src/cli/uap.ts"],"names":[],"mappings":";AACA;;;;;;GAMG"}

package/dist/cli/uap.js

@@ -0,0 +1,346 @@
+#!/usr/bin/env node
+/**
+ * Universal Agent Protocol (UAP) CLI
+ *
+ * This is the main UAP command-line interface that works independently
+ * from opencode. It provides project initialization, configuration,
+ * and integration with various agent harnesses.
+ */
+import { execSync } from 'child_process';
+import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const projectRoot = path.resolve(__dirname, '..', '..');
+const UAP_VERSION = '2.0.0';
+class UAPCli {
+    async run(args) {
+        const command = args[0];
+        switch (command) {
+            case 'init':
+                await this.init();
+                break;
+            case 'setup':
+                await this.setup(args.slice(1));
+                break;
+            case 'install':
+                await this.install(args.slice(1));
+                break;
+            case 'uninstall':
+                await this.uninstall();
+                break;
+            case 'hooks':
+                await this.hooks(args.slice(1));
+                break;
+            case 'plugins':
+                await this.plugins(args.slice(1));
+                break;
+            case 'version':
+            case '-v':
+            case '--version':
+                console.log(`uap version ${UAP_VERSION}`);
+                break;
+            case '--help':
+            case '-h':
+            default:
+                this.printHelp();
+                break;
+        }
+    }
+    printHelp() {
+        console.log(`
+Universal Agent Protocol (UAP) v${UAP_VERSION}
+AI agents that learn and remember across sessions
+
+USAGE:
+  uap <command> [options]
+
+COMMANDS:
+  init              Initialize UAP in current project
+  setup [options]   Run comprehensive UAP setup
+  install <harness> Install UAP plugins for specific harness (opencode, etc.)
+  uninstall         Remove UAP from current project
+  hooks             Manage UAP hooks
+  plugins           List and manage UAP plugins
+
+OPTIONS:
+  -p, --project     Target project directory
+  -h, --harness     Target agent harness (opencode, claude-code, etc.)
+  -f, --force       Force operations without confirmation
+  -v, --verbose     Enable verbose output
+  --version         Show version number
+  --help            Show this help message
+
+EXAMPLES:
+  uap init                    # Initialize UAP in current directory
+  uap setup -p all           # Full setup with all components
+  uap install opencode       # Install UAP plugins for opencode harness
+  uap hooks list             # List available hooks
+`);
+    }
+    async init() {
+        console.log('🔧 Initializing Universal Agent Protocol...\n');
+        const projectDir = process.cwd();
+        const uapConfig = path.join(projectDir, '.uap.json');
+        const claudeMd = path.join(projectDir, 'CLAUDE.md');
+        // Create .uap.json config
+        const config = {
+            version: UAP_VERSION,
+            project: projectDir,
+            initialized: true,
+            timestamp: new Date().toISOString(),
+            features: {
+                memory: true,
+                hooks: true,
+                plugins: true,
+                droids: false,
+                skills: false,
+            },
+        };
+        writeFileSync(uapConfig, JSON.stringify(config, null, 2));
+        console.log('✓ Created .uap.json configuration');
+        // Check if CLAUDE.md exists
+        if (!existsSync(claudeMd)) {
+            console.log('ℹ No CLAUDE.md found. You can create one manually or with: uap setup -p claude-md');
+        }
+        else {
+            console.log('✓ CLAUDE.md detected');
+        }
+        console.log('\n✅ UAP initialized successfully!');
+        console.log(`\nNext steps:`);
+        console.log(`  uap setup -p all     # Run full setup`);
+        console.log(`  uap install opencode # Install for opencode harness`);
+    }
+    async setup(args) {
+        console.log('🔧 Running UAP setup...\n');
+        const projectDir = process.cwd();
+        // Check if initialized
+        const uapConfigPath = path.join(projectDir, '.uap.json');
+        if (!existsSync(uapConfigPath)) {
+            console.log('❌ UAP not initialized. Run: uap init');
+            return;
+        }
+        const config = JSON.parse(readFileSync(uapConfigPath, 'utf8'));
+        // Install components based on options
+        const hasAll = args.includes('-p') || args.includes('--project');
+        const setupMemory = hasAll || args.includes('memory');
+        const setupHooks = hasAll || args.includes('hooks');
+        const setupMCP = hasAll || args.includes('mcp-router');
+        if (setupMemory) {
+            await this.installMemory(projectDir);
+        }
+        if (setupHooks) {
+            await this.installHooks(projectDir);
+        }
+        if (setupMCP) {
+            await this.installMCPRouter(projectDir);
+        }
+        // Update config
+        config.lastSetup = new Date().toISOString();
+        writeFileSync(uapConfigPath, JSON.stringify(config, null, 2));
+        console.log('\n✅ UAP setup complete!');
+    }
+    async install(args) {
+        if (args.length === 0) {
+            console.log('❌ Please specify a harness: uap install <harness>');
+            console.log('Available harnesses: opencode, claude-code, etc.');
+            return;
+        }
+        const harness = args[0];
+        console.log(`🔧 Installing UAP plugins for ${harness}...\n`);
+        switch (harness) {
+            case 'opencode':
+                await this.installForOpencode();
+                break;
+            case 'claude-code':
+                await this.installForClaudeCode();
+                break;
+            default:
+                console.log(`ℹ Plugin installation for ${harness} not yet implemented.`);
+                console.log('Available harnesses: opencode, claude-code');
+        }
+    }
+    async installForOpencode() {
+        const homeDir = process.env.HOME || '';
+        const opencodeDir = path.join(homeDir, '.opencode');
+        const pluginsDir = path.join(opencodeDir, 'plugin');
+        if (!existsSync(opencodeDir)) {
+            console.log(`ℹ Opencode not found at ${opencodeDir}`);
+            console.log('Installing UAP to opencode...');
+            mkdirSync(pluginsDir, { recursive: true });
+        }
+        else {
+            mkdirSync(pluginsDir, { recursive: true });
+        }
+        await this.copyPluginsToDir(pluginsDir);
+        // Create opencode config if needed
+        const opencodeConfig = path.join(opencodeDir, 'config.json');
+        if (!existsSync(opencodeConfig)) {
+            const config = {
+                uapEnabled: true,
+                uapVersion: UAP_VERSION,
+                installedAt: new Date().toISOString(),
+            };
+            writeFileSync(opencodeConfig, JSON.stringify(config, null, 2));
+            console.log('✓ Created opencode config with UAP integration');
+        }
+        console.log('\n✅ UAP successfully integrated with opencode!');
+    }
+    async installForClaudeCode() {
+        const homeDir = process.env.HOME || '';
+        const claudeCodeDir = path.join(homeDir, '.claude', 'code');
+        const hooksDir = path.join(claudeCodeDir, '.factory', 'hooks');
+        if (!existsSync(claudeCodeDir)) {
+            console.log(`ℹ Claude Code not found at ${claudeCodeDir}`);
+            console.log('Installing UAP to claude-code...');
+            mkdirSync(hooksDir, { recursive: true });
+        }
+        else {
+            mkdirSync(hooksDir, { recursive: true });
+        }
+        // Copy hook scripts for claude-code from plugin directory
+        const hooks = ['session-start.sh', 'pre-compact.sh'];
+        for (const hook of hooks) {
+            const src = path.join(projectRoot, 'tools', 'agents', 'plugin', hook);
+            const dest = path.join(hooksDir, hook);
+            if (existsSync(src)) {
+                try {
+                    const content = readFileSync(src, 'utf8');
+                    writeFileSync(dest, content);
+                    console.log(`✓ Installed ${hook}`);
+                }
+                catch (e) {
+                    console.log(`✗ Failed to install ${hook}: ${e}`);
+                }
+            }
+            else {
+                console.log(`ℹ Hook not found: ${hook}`);
+            }
+        }
+        // Create claude-code config if needed
+        const claudeConfig = path.join(claudeCodeDir, 'config.json');
+        if (!existsSync(claudeConfig)) {
+            const config = {
+                uapEnabled: true,
+                uapVersion: UAP_VERSION,
+                installedAt: new Date().toISOString(),
+            };
+            writeFileSync(claudeConfig, JSON.stringify(config, null, 2));
+            console.log('✓ Created claude-code config with UAP integration');
+        }
+        console.log('\n✅ UAP successfully integrated with claude-code!');
+    }
+    async copyPluginsToDir(destDir) {
+        const uapPlugins = [
+            'uap-commands.ts',
+            'uap-droids.ts',
+            'uap-skills.ts',
+            'uap-patterns.ts',
+            'session-start.sh',
+            'pre-compact.sh',
+        ];
+        for (const plugin of uapPlugins) {
+            const src = path.join(projectRoot, 'tools', 'agents', 'plugin', plugin);
+            const dest = path.join(destDir, plugin);
+            if (existsSync(src)) {
+                try {
+                    const content = readFileSync(src, 'utf8');
+                    writeFileSync(dest, content);
+                    console.log(`✓ Installed ${plugin}`);
+                }
+                catch (e) {
+                    console.log(`✗ Failed to install ${plugin}: ${e}`);
+                }
+            }
+            else {
+                console.log(`ℹ Plugin not found: ${plugin}`);
+            }
+        }
+    }
+    async installMemory(projectDir) {
+        console.log('🔧 Setting up memory system...');
+        const memoryDir = path.join(projectDir, 'agents', 'data', 'memory');
+        mkdirSync(memoryDir, { recursive: true });
+        const shortTermDB = path.join(memoryDir, 'short_term.db');
+        const longTermDB = path.join(memoryDir, 'long_term.db');
+        // Initialize SQLite databases
+        try {
+            execSync(`sqlite3 ${shortTermDB} "CREATE TABLE IF NOT EXISTS memories (id INTEGER PRIMARY KEY, content TEXT, metadata TEXT, created_at DATETIME DEFAULT CURRENT_TIMESTAMP);"`);
+            console.log('✓ Created short-term memory database');
+            execSync(`sqlite3 ${longTermDB} "CREATE TABLE IF NOT EXISTS lessons (id INTEGER PRIMARY KEY, title TEXT, content TEXT, category TEXT, importance INTEGER, created_at DATETIME DEFAULT CURRENT_TIMESTAMP);"`);
+            console.log('✓ Created long-term memory database');
+        }
+        catch (e) {
+            console.log('ℹ SQLite not available for in-memory setup');
+        }
+        console.log('✅ Memory system initialized!');
+    }
+    async installHooks(projectDir) {
+        console.log('🔧 Installing UAP hooks...');
+        const hooksDir = path.join(projectDir, '.factory', 'hooks');
+        mkdirSync(hooksDir, { recursive: true });
+        // Copy hook scripts
+        const hooks = ['session-start.sh', 'pre-compact.sh'];
+        for (const hook of hooks) {
+            const src = path.join(projectRoot, '.factory', 'hooks', hook);
+            const dest = path.join(hooksDir, hook);
+            if (existsSync(src)) {
+                try {
+                    const content = readFileSync(src, 'utf8');
+                    writeFileSync(dest, content);
+                    console.log(`✓ Installed ${hook}`);
+                }
+                catch (e) {
+                    console.log(`✗ Failed to install ${hook}: ${e}`);
+                }
+            }
+            else {
+                console.log(`ℹ Hook not found: ${hook}`);
+            }
+        }
+        console.log('✅ Hooks installed!');
+    }
+    async installMCPRouter(_projectDir) {
+        console.log('🔧 Setting up MCP Router...');
+        // MCP router setup would go here
+        console.log('ℹ MCP Router configuration pending implementation');
+        console.log('✅ MCP Router placeholder created!');
+    }
+    async uninstall() {
+        console.log('❌ UAP uninstall not yet implemented');
+        console.log('To manually remove UAP:');
+        console.log('  rm -rf .uap.json .factory/hooks agents/data/memory');
+    }
+    async hooks(args) {
+        const command = args[0];
+        switch (command) {
+            case 'list':
+                console.log('Available UAP hooks:');
+                console.log('  - session-start: Run at session initialization');
+                console.log('  - pre-compact: Run before context compression');
+                console.log('  - post-complete: Run after task completion');
+                break;
+            case 'install':
+                await this.installHooks(process.cwd());
+                break;
+            default:
+                this.printHelp();
+        }
+    }
+    async plugins(args) {
+        console.log('UAP Plugins:');
+        console.log('  - uap-session-hooks: Session management hooks');
+        console.log('  - uap-commands: UAP command definitions');
+        console.log('  - uap-droids: Specialized agent droids');
+        console.log('  - uap-skills: Domain-specific skills');
+        console.log('  - uap-patterns: Reusable coding patterns');
+        if (args[0] === 'install') {
+            await this.install(args.slice(1));
+        }
+    }
+}
+// Main entry point
+const cli = new UAPCli();
+cli.run(process.argv.slice(2)).catch(console.error);
+//# sourceMappingURL=uap.js.map

package/dist/cli/uap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uap.js","sourceRoot":"","sources":["../../src/cli/uap.ts"],"names":[],"mappings":";AACA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AACxE,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAC3C,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAExD,MAAM,WAAW,GAAG,OAAO,CAAC;AAE5B,MAAM,MAAM;IACV,KAAK,CAAC,GAAG,CAAC,IAAc;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAExB,QAAQ,OAAO,EAAE,CAAC;YAChB,KAAK,MAAM;gBACT,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;gBAClB,MAAM;YACR,KAAK,OAAO;gBACV,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAChC,MAAM;YACR,KAAK,SAAS;gBACZ,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAClC,MAAM;YACR,KAAK,WAAW;gBACd,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;gBACvB,MAAM;YACR,KAAK,OAAO;gBACV,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAChC,MAAM;YACR,KAAK,SAAS;gBACZ,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAClC,MAAM;YACR,KAAK,SAAS,CAAC;YACf,KAAK,IAAI,CAAC;YACV,KAAK,WAAW;gBACd,OAAO,CAAC,GAAG,CAAC,eAAe,WAAW,EAAE,CAAC,CAAC;gBAC1C,MAAM;YACR,KAAK,QAAQ,CAAC;YACd,KAAK,IAAI,CAAC;YACV;gBACE,IAAI,CAAC,SAAS,EAAE,CAAC;gBACjB,MAAM;QACV,CAAC;IACH,CAAC;IAEO,SAAS;QACf,OAAO,CAAC,GAAG,CAAC;kCACkB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2B5C,CAAC,CAAC;IACD,CAAC;IAEO,KAAK,CAAC,IAAI;QAChB,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;QAE7D,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QAEpD,0BAA0B;QAC1B,MAAM,MAAM,GAAG;YACb,OAAO,EAAE,WAAW;YACpB,OAAO,EAAE,UAAU;YACnB,WAAW,EAAE,IAAI;YACjB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,QAAQ,EAAE;gBACR,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,IAAI;gBACX,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,KAAK;gBACb,MAAM,EAAE,KAAK;aACd;SACF,CAAC;QAEF,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC1D,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;QAEjD,4BAA4B;QAC5B,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,GAAG,CACT,mFAAmF,CACpF,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QACtC,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;QACvD,OAAO,CAAC,GAAG,CAAC,uDAAuD,CAAC,CAAC;IACvE,CAAC;IAEO,KAAK,CAAC,KAAK,CAAC,IAAc;QAChC,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;QAEzC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAEjC,uBAAuB;QACvB,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QACzD,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;YACpD,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC;QAE/D,sCAAsC;QACtC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACjE,MAAM,WAAW,GAAG,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACtD,MAAM,UAAU,GAAG,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QAEvD,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;QAED,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAC1C,CAAC;QAED,gBAAgB;QAChB,MAAM,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC5C,aAAa,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAE9D,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IACzC,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,IAAc;QAClC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;YACjE,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC;YAChE,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,iCAAiC,OAAO,OAAO,CAAC,CAAC;QAE7D,QAAQ,OAAO,EAAE,CAAC;YAChB,KAAK,UAAU;gBACb,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;gBAChC,MAAM;YACR,KAAK,aAAa;gBAChB,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;gBAClC,MAAM;YACR;gBACE,OAAO,CAAC,GAAG,CAAC,6BAA6B,OAAO,uBAAuB,CAAC,CAAC;gBACzE,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,kBAAkB;QAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;QACvC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QACpD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAEpD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,2BAA2B,WAAW,EAAE,CAAC,CAAC;YACtD,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;YAC7C,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,MAAM,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAExC,mCAAmC;QACnC,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;QAC7D,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YAChC,MAAM,MAAM,GAAG;gBACb,UAAU,EAAE,IAAI;gBAChB,UAAU,EAAE,WAAW;gBACvB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACtC,CAAC;YACF,aAAa,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC/D,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;QAChE,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;IAChE,CAAC;IAEO,KAAK,CAAC,oBAAoB;QAChC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;QACvC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QAE/D,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,8BAA8B,aAAa,EAAE,CAAC,CAAC;YAC3D,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;YAChD,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QAED,0DAA0D;QAC1D,MAAM,KAAK,GAAG,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAAC;QACrD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;YACtE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAEvC,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpB,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;oBAC1C,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;oBAC7B,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC;gBACrC,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC;gBACnD,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QAED,sCAAsC;QACtC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;QAC7D,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG;gBACb,UAAU,EAAE,IAAI;gBAChB,UAAU,EAAE,WAAW;gBACvB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACtC,CAAC;YACF,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC7D,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;QACnE,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;IACnE,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAC,OAAe;QAC5C,MAAM,UAAU,GAAG;YACjB,iBAAiB;YACjB,eAAe;YACf,eAAe;YACf,iBAAiB;YACjB,kBAAkB;YAClB,gBAAgB;SACjB,CAAC;QAEF,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YACxE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAExC,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpB,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;oBAC1C,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;oBAC7B,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,EAAE,CAAC,CAAC;gBACvC,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,OAAO,CAAC,GAAG,CAAC,uBAAuB,MAAM,KAAK,CAAC,EAAE,CAAC,CAAC;gBACrD,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,uBAAuB,MAAM,EAAE,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,UAAkB;QAC5C,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;QAE9C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QACpE,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE1C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;QAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QAExD,8BAA8B;QAC9B,IAAI,CAAC;YACH,QAAQ,CACN,WAAW,WAAW,8IAA8I,CACrK,CAAC;YACF,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;YAEpD,QAAQ,CACN,WAAW,UAAU,6KAA6K,CACnM,CAAC;YACF,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;QAC5D,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;IAC9C,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,UAAkB;QAC3C,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAE1C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QAC5D,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEzC,oBAAoB;QACpB,MAAM,KAAK,GAAG,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAAC;QAErD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;YAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAEvC,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpB,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;oBAC1C,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;oBAC7B,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC;gBACrC,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC;gBACnD,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACpC,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAC,WAAmB;QAChD,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;QAE3C,iCAAiC;QACjC,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;QACjE,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;IACnD,CAAC;IAEO,KAAK,CAAC,SAAS;QACrB,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;IACtE,CAAC;IAEO,KAAK,CAAC,KAAK,CAAC,IAAc;QAChC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAExB,QAAQ,OAAO,EAAE,CAAC;YAChB,KAAK,MAAM;gBACT,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;gBACpC,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC;gBAChE,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;gBAC/D,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;gBAC5D,MAAM;YACR,KAAK,SAAS;gBACZ,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;gBACvC,MAAM;YACR;gBACE,IAAI,CAAC,SAAS,EAAE,CAAC;QACrB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,IAAc;QAClC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;QAE1D,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;CACF;AAED,mBAAmB;AACnB,MAAM,GAAG,GAAG,IAAI,MAAM,EAAE,CAAC;AACzB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-agent-protocol",
-  "version": "0.10.3",
+  "version": "2.0.0",
   "description": "Autonomous AI agent memory system with CLAUDE.md protocol enforcement",
   "type": "module",
   "main": "dist/index.js",
@@ -8,7 +8,8 @@
   "bin": {
     "qwen-tool-call-test": "./tools/agents/scripts/qwen-tool-call-test.js",
     "qwen-tool-call-wrapper": "./tools/agents/scripts/qwen-tool-call-wrapper.js",
-    "fix-qwen-template": "./tools/agents/scripts/fix-qwen-template.js"
+    "fix-qwen-template": "./tools/agents/scripts/fix-qwen-template.js",
+    "uap": "./dist/cli/uap.js"
   },
   "scripts": {
     "build": "tsc",

package/tools/agents/plugin/README.md

@@ -0,0 +1,91 @@
+# UAP Plugins
+
+This directory contains all UAP (Universal Agent Protocol) plugins, hooks, and utilities.
+
+## Plugin Files
+
+### TypeScript Plugins
+
+- **uap-commands.ts** - Defines UAP-specific commands for opencode integration
+- **uap-droids.ts** - Specialized agent droids (code reviewer, security auditor, etc.)
+- **uap-skills.ts** - Domain-specific skills (git workflow, testing patterns, etc.)
+- **uap-patterns.ts** - Reusable coding patterns distilled from experience
+
+### Shell Hooks
+
+- **session-start.sh** - Runs at session initialization to enforce UAP compliance
+- **pre-compact.sh** - Runs before context compression to preserve critical information
+
+## Usage
+
+### Install Plugins
+
+To install all UAP plugins for opencode:
+
+```bash
+uap install opencode
+```
+
+This will copy all plugin files to `~/.opencode/plugin/`.
+
+### Available Droids
+
+- **code-reviewer** - Reviews code changes for quality and security
+- **security-auditor** - Audits code for security vulnerabilities
+- **performance-optimizer** - Analyzes and optimizes performance bottlenecks
+- **unit-tester** - Generates comprehensive unit tests
+- **debug-helper** - Helps diagnose and fix bugs
+
+### Available Skills
+
+- **git-workflow** - Manages git workflows with worktrees and branches
+- **testing-patterns** - Applies testing best practices and patterns
+- **ci-cd-setup** - Configures continuous integration and deployment pipelines
+- **documentation-gen** - Generates and maintains project documentation
+
+### Available Patterns
+
+- **generic-uap-patterns** - Distilled patterns from tbench-specific implementation
+- **worktree-isolation** - Use git worktrees for isolated feature development
+- **session-persistence** - Maintain state across sessions using memory system
+- **task-tracking** - Track and manage tasks with UAP task system
+- **agent-coordination** - Coordinate multiple AI agents for complex tasks
+
+## Plugin Manifest
+
+Each plugin is registered in the `index.ts` file which exports:
+
+- Version information
+- Plugin manifest with hooks, droids, skills, and patterns
+- Individual plugin modules
+
+## Creating New Plugins
+
+To add a new plugin:
+
+1. Create a new TypeScript file in this directory
+2. Export definitions using the appropriate interfaces
+3. Add to the `index.ts` exports
+4. Register in the `uapPluginManifest`
+
+Example:
+
+```typescript
+export interface MyPlugin {
+  id: string;
+  name: string;
+  description: string;
+  enabled: boolean;
+}
+
+export const myPlugin: MyPlugin = {
+  id: 'my-plugin',
+  name: 'My Plugin',
+  description: 'Description of my plugin',
+  enabled: true,
+};
+```
+
+## License
+
+Part of Universal Agent Protocol v0.10.3

package/tools/agents/plugin/index.ts

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+/**
+ * UAP Plugin Index
+ *
+ * This file serves as the main entry point for all UAP plugins.
+ * It exports all available plugins, hooks, and utilities.
+ */
+
+import { uapCommands } from './uap-commands.js';
+import { uapDroids } from './uap-droids.js';
+import { uapSkills } from './uap-skills.js';
+import { uapPatterns } from './uap-patterns.js';
+
+export const UAP_VERSION = '0.10.3';
+
+export interface UAPPluginManifest {
+  name: string;
+  version: string;
+  description: string;
+  hooks?: string[];
+  droids?: string[];
+  skills?: string[];
+  patterns?: string[];
+}
+
+export const uapPluginManifest: UAPPluginManifest = {
+  name: 'universal-agent-protocol',
+  version: UAP_VERSION,
+  description: 'Universal Agent Protocol - AI agents that learn and remember across sessions',
+  hooks: ['session-start.sh', 'pre-compact.sh'],
+  droids: uapDroids.map((d) => d.id),
+  skills: uapSkills.map((s) => s.id),
+  patterns: uapPatterns.map((p) => p.id),
+};
+
+export { uapCommands, uapDroids, uapSkills, uapPatterns };
+
+// Default export for easy importing
+export default {
+  version: UAP_VERSION,
+  manifest: uapPluginManifest,
+  commands: uapCommands,
+  droids: uapDroids,
+  skills: uapSkills,
+  patterns: uapPatterns,
+};

package/tools/agents/plugin/pre-compact.sh

@@ -0,0 +1,68 @@
+#!/usr/bin/env bash
+# UAP Pre-Compact Hook for Claude Code
+# 1. Checks compliance state and warns on violations
+# 2. Writes a timestamp marker to the daily log before context compaction
+# 3. Marks any agents registered by this session as completed
+# Fails safely - never blocks the agent.
+set -euo pipefail
+
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-.}"
+DB_PATH="${PROJECT_DIR}/agents/data/memory/short_term.db"
+COORD_DB="${PROJECT_DIR}/agents/data/coordination/coordination.db"
+
+if [ ! -f "$DB_PATH" ]; then
+  exit 0
+fi
+
+TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+# Record a compaction marker in memory so sessions can detect context resets
+sqlite3 "$DB_PATH" "
+  INSERT OR IGNORE INTO memories (timestamp, type, content)
+  VALUES ('$TIMESTAMP', 'action', '[pre-compact] Context compaction at $TIMESTAMP');
+" 2>/dev/null || true
+
+# Check if any lessons were stored this session
+recent_lessons=$(sqlite3 "$DB_PATH" "
+  SELECT COUNT(*) FROM session_memories
+  WHERE timestamp >= datetime('now', '-2 hours')
+    AND type = 'decision';
+" 2>/dev/null || echo "0")
+
+output=""
+
+# Compliance reminder on compaction
+output+="<system-reminder>"$'\n'
+output+="## UAP COMPLIANCE REMINDER (Pre-Compact)"$'\n'
+output+=""$'\n'
+output+="Context is being compacted. Before continuing work after compaction:"$'\n'
+output+="1. Re-run: uap task ready"$'\n'
+output+="2. Re-query memory for current task context"$'\n'
+output+="3. Check for stale worktrees: uap worktree list"$'\n'
+output+=""$'\n'
+
+if [ "$recent_lessons" = "0" ]; then
+  output+="WARNING: No lessons stored this session. Before compaction completes,"$'\n'
+  output+="store a summary: sqlite3 ./agents/data/memory/short_term.db \"INSERT INTO session_memories (session_id,timestamp,type,content,importance) VALUES ('current',datetime('now'),'decision','<summary>',7);\""$'\n'
+fi
+
+output+="</system-reminder>"$'\n'
+
+echo "$output"
+
+# Clean up agents with recent heartbeats (likely from this session being compacted)
+if [ -f "$COORD_DB" ]; then
+  sqlite3 "$COORD_DB" "
+    DELETE FROM work_claims WHERE agent_id IN (
+      SELECT id FROM agent_registry
+      WHERE status='active' AND last_heartbeat >= datetime('now','-5 minutes')
+    );
+    UPDATE work_announcements SET completed_at='$TIMESTAMP'
+      WHERE completed_at IS NULL AND agent_id IN (
+        SELECT id FROM agent_registry
+        WHERE status='active' AND last_heartbeat >= datetime('now','-5 minutes')
+      );
+    UPDATE agent_registry SET status='completed'
+      WHERE status='active' AND last_heartbeat >= datetime('now','-5 minutes');
+  " 2>/dev/null || true
+fi

package/tools/agents/plugin/session-start.sh

@@ -0,0 +1,106 @@
+#!/usr/bin/env bash
+# UAP Session Start Hook for Claude Code
+# COMPLIANCE ENFORCEMENT: Outputs mandatory protocol checklist
+# that the AI agent MUST complete before any work begins.
+# Fails safely - never blocks the agent.
+set -euo pipefail
+
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-.}"
+DB_PATH="${PROJECT_DIR}/agents/data/memory/short_term.db"
+COORD_DB="${PROJECT_DIR}/agents/data/coordination/coordination.db"
+
+if [ ! -f "$DB_PATH" ]; then
+  exit 0
+fi
+
+# Clean stale agents from coordination DB (heartbeat >24h old)
+if [ -f "$COORD_DB" ]; then
+  sqlite3 "$COORD_DB" "
+    DELETE FROM work_claims WHERE agent_id IN (
+      SELECT id FROM agent_registry
+      WHERE status IN ('active','idle') AND last_heartbeat < datetime('now','-24 hours')
+    );
+    DELETE FROM work_announcements WHERE agent_id IN (
+      SELECT id FROM agent_registry
+      WHERE status IN ('active','idle') AND last_heartbeat < datetime('now','-24 hours')
+    ) AND completed_at IS NULL;
+    UPDATE agent_registry SET status='failed'
+      WHERE status IN ('active','idle') AND last_heartbeat < datetime('now','-24 hours');
+    DELETE FROM agent_registry
+      WHERE status IN ('completed','failed') AND started_at < datetime('now','-7 days');
+    DELETE FROM agent_messages WHERE created_at < datetime('now','-24 hours');
+  " 2>/dev/null || true
+fi
+
+output=""
+
+# ============================================================
+# COMPLIANCE ENFORCEMENT BLOCK
+# This is injected as system context. The AI MUST follow these.
+# ============================================================
+output+="<system-reminder>"$'\n'
+output+="## UAP COMPLIANCE - MANDATORY PROTOCOL"$'\n'
+output+=""$'\n'
+output+="You MUST complete these steps IN ORDER before doing ANY work."$'\n'
+output+="Skipping ANY step is a critical protocol violation."$'\n'
+output+=""$'\n'
+output+="### BEFORE WORK (execute these commands NOW):"$'\n'
+output+="1. Run: uap task ready"$'\n'
+output+="2. Run: sqlite3 ./agents/data/memory/short_term.db \"SELECT type, substr(content,1,80) FROM memories ORDER BY id DESC LIMIT 5;\""$'\n'
+output+="3. Run: uap memory query \"<relevant to user request>\""$'\n'
+output+="4. On work request: Run: uap task create --type <task|bug|feature> --title \"<description>\""$'\n'
+output+=""$'\n'
+output+="### DURING WORK:"$'\n'
+output+="5. ALL file changes MUST use worktree: uap worktree create <slug>"$'\n'
+output+="6. Work in .worktrees/NNN-<slug>/ directory"$'\n'
+output+=""$'\n'
+output+="### BEFORE COMMIT:"$'\n'
+output+="7. Self-review: git diff"$'\n'
+output+="8. Run tests if applicable"$'\n'
+output+=""$'\n'
+output+="### AFTER WORK:"$'\n'
+output+="9. Store lesson: sqlite3 ./agents/data/memory/short_term.db \"INSERT INTO session_memories (session_id,timestamp,type,content,importance) VALUES ('current',datetime('now'),'decision','<summary of work and lessons>',7);\""$'\n'
+output+="10. Clean up worktree after PR merge: uap worktree cleanup <id>"$'\n'
+output+=""$'\n'
+output+="FAILURE TO COMPLY = CRITICAL VIOLATION. This is life or death."$'\n'
+output+="</system-reminder>"$'\n\n'
+
+# Recent memories (last 24h, high importance)
+recent=$(sqlite3 "$DB_PATH" "
+  SELECT type, substr(content, 1, 120) FROM memories
+  WHERE timestamp >= datetime('now', '-1 day')
+  ORDER BY id DESC
+  LIMIT 10;
+" 2>/dev/null || true)
+
+if [ -n "$recent" ]; then
+  output+="## Recent Memory Context"$'\n'
+  output+="$recent"$'\n\n'
+fi
+
+# Open loops from session memories
+open_loops=$(sqlite3 "$DB_PATH" "
+  SELECT content FROM session_memories
+  WHERE type IN ('action','goal','decision')
+    AND importance >= 7
+  ORDER BY id DESC
+  LIMIT 5;
+" 2>/dev/null || true)
+
+if [ -n "$open_loops" ]; then
+  output+="## Open Loops"$'\n'
+  output+="$open_loops"$'\n'
+fi
+
+# Stale worktrees warning
+if [ -d "${PROJECT_DIR}/.worktrees" ]; then
+  stale_count=$(find "${PROJECT_DIR}/.worktrees" -maxdepth 1 -mindepth 1 -type d 2>/dev/null | wc -l)
+  if [ "$stale_count" -gt 0 ]; then
+    output+=$'\n'"## Stale Worktrees Warning"$'\n'
+    output+="There are $stale_count worktrees. Run 'uap worktree list' and clean up merged ones."$'\n'
+  fi
+fi
+
+if [ -n "$output" ]; then
+  echo "$output"
+fi

package/tools/agents/plugin/uap-commands.ts

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+/**
+ * UAP Commands Plugin for opencode
+ *
+ * Defines UAP-specific commands that can be used within opencode.
+ */
+
+export const uapCommands = {
+  name: 'uap',
+  description: 'Universal Agent Protocol commands',
+  commands: [
+    {
+      name: 'init',
+      description: 'Initialize UAP in current project',
+      usage: 'uap init',
+    },
+    {
+      name: 'setup',
+      description: 'Run comprehensive UAP setup',
+      usage: 'uap setup [-p all | memory | hooks | mcp-router]',
+    },
+    {
+      name: 'install',
+      description: 'Install UAP plugins for a harness',
+      usage: 'uap install <harness>',
+    },
+    {
+      name: 'task',
+      description: 'Create and manage tasks',
+      usage: 'uap task create --type <task|bug|feature> --title "<description>"',
+    },
+    {
+      name: 'worktree',
+      description: 'Manage git worktrees for isolated development',
+      usage: 'uap worktree <command>',
+    },
+    {
+      name: 'memory',
+      description: 'Query and manage memory system',
+      usage: 'uap memory query "<query>"',
+    },
+  ],
+};
+
+export default uapCommands;

package/tools/agents/plugin/uap-droids.ts

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+/**
+ * UAP Droids Plugin for opencode
+ *
+ * Defines specialized agent droids that can be invoked via UAP.
+ */
+
+export interface UDroidDefinition {
+  id: string;
+  name: string;
+  description: string;
+  category: 'code' | 'review' | 'debug' | 'test' | 'deploy';
+  enabled: boolean;
+}
+
+export const uapDroids: UDroidDefinition[] = [
+  {
+    id: 'code-reviewer',
+    name: 'Code Reviewer',
+    description: 'Reviews code changes for quality and security',
+    category: 'review',
+    enabled: true,
+  },
+  {
+    id: 'security-auditor',
+    name: 'Security Auditor',
+    description: 'Audits code for security vulnerabilities',
+    category: 'review',
+    enabled: false,
+  },
+  {
+    id: 'performance-optimizer',
+    name: 'Performance Optimizer',
+    description: 'Analyzes and optimizes performance bottlenecks',
+    category: 'code',
+    enabled: false,
+  },
+  {
+    id: 'unit-tester',
+    name: 'Unit Tester',
+    description: 'Generates comprehensive unit tests',
+    category: 'test',
+    enabled: true,
+  },
+  {
+    id: 'debug-helper',
+    name: 'Debug Helper',
+    description: 'Helps diagnose and fix bugs',
+    category: 'debug',
+    enabled: true,
+  },
+];
+
+export default uapDroids;

package/tools/agents/plugin/uap-patterns.ts

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+/**
+ * UAP Patterns Plugin for opencode
+ *
+ * Provides reusable coding patterns and distilled knowledge from tbench.
+ */
+
+export interface UpatternDefinition {
+  id: string;
+  name: string;
+  description: string;
+  category: 'memory' | 'workflow' | 'architecture' | 'testing';
+  tags: string[];
+}
+
+export const uapPatterns: UpatternDefinition[] = [
+  {
+    id: 'generic-uap-patterns',
+    name: 'Generic UAP Patterns',
+    description: 'Distilled patterns from tbench-specific implementation',
+    category: 'workflow',
+    tags: ['memory', 'hooks', 'patterns'],
+  },
+  {
+    id: 'worktree-isolation',
+    name: 'Worktree Isolation Pattern',
+    description: 'Use git worktrees for isolated feature development',
+    category: 'workflow',
+    tags: ['git', 'isolation', 'parallel'],
+  },
+  {
+    id: 'session-persistence',
+    name: 'Session Persistence Pattern',
+    description: 'Maintain state across sessions using memory system',
+    category: 'memory',
+    tags: ['state', 'persistence', 'context'],
+  },
+  {
+    id: 'task-tracking',
+    name: 'Task Tracking Pattern',
+    description: 'Track and manage tasks with UAP task system',
+    category: 'workflow',
+    tags: ['tasks', 'tracking', 'management'],
+  },
+  {
+    id: 'agent-coordination',
+    name: 'Agent Coordination Pattern',
+    description: 'Coordinate multiple AI agents for complex tasks',
+    category: 'architecture',
+    tags: ['agents', 'coordination', 'parallel'],
+  },
+];
+
+export default uapPatterns;

package/tools/agents/plugin/uap-skills.ts

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+/**
+ * UAP Skills Plugin for opencode
+ *
+ * Defines domain-specific skills that agents can use.
+ */
+
+export interface USkillDefinition {
+  id: string;
+  name: string;
+  description: string;
+  category: 'development' | 'testing' | 'deployment' | 'documentation';
+  triggers: string[];
+  enabled: boolean;
+}
+
+export const uapSkills: USkillDefinition[] = [
+  {
+    id: 'git-workflow',
+    name: 'Git Workflow',
+    description: 'Manages git workflows with worktrees and branches',
+    category: 'development',
+    triggers: ['git', 'branch', 'commit', 'push'],
+    enabled: true,
+  },
+  {
+    id: 'testing-patterns',
+    name: 'Testing Patterns',
+    description: 'Applies testing best practices and patterns',
+    category: 'testing',
+    triggers: ['test', 'spec', 'coverage'],
+    enabled: true,
+  },
+  {
+    id: 'ci-cd-setup',
+    name: 'CI/CD Setup',
+    description: 'Configures continuous integration and deployment pipelines',
+    category: 'deployment',
+    triggers: ['ci', 'cd', 'pipeline', 'workflow'],
+    enabled: false,
+  },
+  {
+    id: 'documentation-gen',
+    name: 'Documentation Generator',
+    description: 'Generates and maintains project documentation',
+    category: 'documentation',
+    triggers: ['doc', 'readme', 'comment'],
+    enabled: true,
+  },
+];
+
+export default uapSkills;