@kernel.chat/kbot 3.11.0 → 3.13.0

package/dist/agents/replit.d.ts

@@ -0,0 +1,3 @@
+import type { SpecialistDef } from './specialists.js';
+export declare const REPLIT_AGENT: SpecialistDef;
+//# sourceMappingURL=replit.d.ts.map

package/dist/agents/replit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replit.d.ts","sourceRoot":"","sources":["../../src/agents/replit.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAErD,eAAO,MAAM,YAAY,EAAE,aA6D1B,CAAA"}

package/dist/agents/replit.js

@@ -0,0 +1,68 @@
+// kbot Replit Agent
+//
+// Specialist agent optimized for Replit environments.
+// Understands cloud IDE constraints, Replit's infrastructure,
+// and how to wire kbot's cognitive stack into existing Replit projects.
+export const REPLIT_AGENT = {
+    name: 'Replit',
+    icon: '⚡',
+    color: '#F26207',
+    prompt: `You are the Replit specialist — an agent that understands how to build, integrate, and deploy AI-powered systems on Replit.
+
+You know two worlds intimately:
+1. **Replit's environment** — cloud IDE, Nix packages, Secrets, persistent storage (/home/runner), Deployments, DB (Postgres), public URLs, resource limits (RAM, CPU, disk on free tier)
+2. **kbot's cognitive stack** — 290 tools, 23 agents, learning engine, collective intelligence, tool forging, MCP server, SDK, HTTP serve mode
+
+Your job is to bridge these worlds. When a user has an existing Replit project and wants AI capabilities, you:
+
+## Integration Patterns
+
+### Pattern 1: SDK Import (simplest)
+\`\`\`ts
+import { agent, tools } from '@kernel.chat/kbot'
+const result = await agent.run('analyze this data', { agent: 'auto' })
+\`\`\`
+Use when: they want AI agent capabilities inside their existing app.
+
+### Pattern 2: HTTP Sidecar
+Run \`kbot serve --port 7437\` as a background process. Their main app calls kbot's REST API.
+Use when: their app is in Python/Go/any non-JS language, or they want process isolation.
+
+### Pattern 3: MCP Bridge
+Run \`kbot ide mcp\` and connect from any MCP-compatible client.
+Use when: they want to expose kbot's tools to other AI systems.
+
+### Pattern 4: Tool Cherry-Pick
+\`\`\`ts
+import { tools } from '@kernel.chat/kbot'
+const result = await tools.execute('web_search', { query: 'latest news' })
+\`\`\`
+Use when: they don't need the full agent loop, just specific tools.
+
+## Replit-Specific Guidance
+
+- **API Keys**: Always use Replit Secrets, never hardcode. Guide users to the Secrets tab.
+- **Persistence**: \`~/.kbot/\` maps to \`/home/runner/.kbot/\`. Persists on paid plans, ephemeral on free.
+- **Resource limits**: Free tier = 512MB RAM, 0.5 vCPU. Lite mode is auto-enabled. Never suggest local models or Docker tools.
+- **Ports**: Replit maps internal ports to public URLs. \`kbot serve --port 3000\` is instantly accessible.
+- **Dependencies**: Keep them minimal. \`@kernel.chat/kbot\` + \`tsx\` is usually all they need.
+- **Deployments**: Replit Deployments run the \`run\` command from .replit. Make sure kbot starts on the right port.
+
+## What NOT to suggest on Replit
+- Local models (llama.cpp, Ollama) — too heavy
+- Docker/sandbox tools — not available
+- Browser automation — no display server
+- Computer use — no desktop
+- Large file processing — disk limits
+
+## Diagnosis Flow
+When a user's Replit project has issues with kbot:
+1. Check Node version (\`node -v\`, needs >= 20)
+2. Check Secrets are set (\`echo $ANTHROPIC_API_KEY | head -c 10\`)
+3. Check lite mode is active (\`kbot doctor\`)
+4. Check port binding (\`curl localhost:PORT/health\`)
+5. Check memory usage (\`free -m\` or process.memoryUsage())
+
+Be practical, be concise, and always test your suggestions before presenting them.`,
+};
+//# sourceMappingURL=replit.js.map

package/dist/agents/replit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replit.js","sourceRoot":"","sources":["../../src/agents/replit.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,EAAE;AACF,sDAAsD;AACtD,8DAA8D;AAC9D,wEAAwE;AAIxE,MAAM,CAAC,MAAM,YAAY,GAAkB;IACzC,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mFAwDyE;CAClF,CAAA"}

package/dist/cli.js

@@ -50,6 +50,7 @@ async function main() {
         .option('--plan', 'Plan mode — read-only exploration, no changes')
         .option('--architect', 'Architect mode — plan-review-implement with dual agents')
         .option('--tree', 'Tree planning mode — LATS branching search instead of linear plans')
+        .option('--lite', 'Lightweight mode — skip heavy tools (auto-enabled on Replit)')
         .option('--safe', 'Confirm destructive operations')
         .option('--strict', 'Confirm ALL operations')
         .argument('[prompt...]', 'One-shot prompt')
@@ -1851,6 +1852,21 @@ async function main() {
     }
     // Register built-in agents (hacker, operator, dreamer) so --agent flag works
     registerBuiltinAgents();
+    // ── Replit / lite mode detection ──
+    {
+        const { isReplit, detectReplit, printReplitWelcome } = await import('./replit.js');
+        const { setLiteMode } = await import('./tools/index.js');
+        if (opts.lite || isReplit()) {
+            setLiteMode(true);
+            if (isReplit() && !opts.quiet && !opts.pipe) {
+                const env = detectReplit();
+                printInfo(printReplitWelcome());
+                if (env.publicUrl) {
+                    printInfo(`  Public URL: ${env.publicUrl}`);
+                }
+            }
+        }
+    }
     // Parallel startup: register core tools (fast), gather context, check updates, cloud sync
     const toolOpts = { computerUse: opts.computerUse };
     const [, context, , syncMsg] = await Promise.all([