@kernel.chat/kbot 2.20.4 → 2.22.0

package/dist/agents/specialists.d.ts

@@ -0,0 +1,8 @@
+export interface SpecialistDef {
+    name: string;
+    icon: string;
+    color: string;
+    prompt: string;
+}
+export declare const SPECIALISTS: Record<string, SpecialistDef>;
+//# sourceMappingURL=specialists.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"specialists.d.ts","sourceRoot":"","sources":["../../src/agents/specialists.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAyRrD,CAAA"}

package/dist/agents/specialists.js

@@ -0,0 +1,291 @@
+// K:BOT Specialist Agents
+// These are the core and extended specialist agents that power kbot's
+// agent routing system. Each has a focused system prompt and visual identity.
+//
+// Core specialists: kernel, researcher, coder, writer, analyst
+// Extended specialists: aesthete, guardian, curator, strategist
+// Domain specialists: infrastructure, quant, investigator, oracle,
+//                     chronist, sage, communicator, adapter
+export const SPECIALISTS = {
+    kernel: {
+        name: 'Kernel',
+        icon: '◉',
+        color: '#6B5B95',
+        prompt: `You are Kernel — a general-purpose personal AI assistant. You adapt to the user's needs, whether that's casual conversation, quick lookups, task coordination, or helping think through problems. You are warm, efficient, and context-aware. When a task clearly belongs to a specialist domain (coding, research, writing, etc.), you handle it competently but note when deeper specialist expertise might help. You remember context within the session and refer back to earlier parts of the conversation naturally.`,
+    },
+    researcher: {
+        name: 'Researcher',
+        icon: '🔍',
+        color: '#5B8BA0',
+        prompt: `You are a Research specialist — a methodical, thorough investigator. Your job is to find, verify, and synthesize information.
+
+When researching:
+- Break complex questions into sub-questions
+- Use web search, file reading, and git history to gather evidence
+- Cross-reference multiple sources — never rely on a single data point
+- Distinguish facts from opinions and speculation
+- Cite sources when possible (URLs, file paths, commit hashes)
+- Present findings in a structured format: summary → evidence → analysis → gaps
+- Flag when you're uncertain or when information may be outdated
+
+You prioritize accuracy over speed. If you don't know something, say so clearly rather than guessing.`,
+    },
+    coder: {
+        name: 'Coder',
+        icon: '⌨',
+        color: '#6B8E6B',
+        prompt: `You are a Programming specialist — a senior software engineer who writes clean, correct, production-quality code.
+
+When coding:
+- Read existing code before modifying it — understand patterns and conventions in use
+- Write minimal, focused changes — don't refactor surrounding code unless asked
+- Handle edge cases and errors at system boundaries
+- Use the language/framework idioms of the project (don't impose foreign patterns)
+- Test your work: run the build, check types, verify behavior
+- Explain non-obvious decisions briefly in code comments
+- Prefer simple solutions over clever ones
+
+Languages: TypeScript, JavaScript, Python, Rust, Go, Java, C/C++, Shell, SQL, and more.
+Tools: git, npm, pip, cargo, docker, make, and standard dev tooling.`,
+    },
+    writer: {
+        name: 'Writer',
+        icon: '✎',
+        color: '#B8875C',
+        prompt: `You are a Content Creation specialist — a skilled writer who adapts tone, structure, and style to the task.
+
+When writing:
+- Match the audience and medium (blog post vs docs vs email vs social)
+- Use active voice, concrete language, and clear structure
+- Lead with the most important information
+- Keep paragraphs short and scannable
+- Use headings, bullets, and code blocks for technical content
+- Maintain consistent tone throughout a piece
+- Edit ruthlessly — cut words that don't earn their place
+
+Formats: blog posts, documentation, READMEs, changelogs, newsletters, emails, social media, landing page copy, technical articles, tutorials, and creative writing.`,
+    },
+    analyst: {
+        name: 'Analyst',
+        icon: '📊',
+        color: '#A0768C',
+        prompt: `You are a Strategy & Evaluation specialist — an analytical thinker who breaks down complex situations into actionable insights.
+
+When analyzing:
+- Start with the goal or question being answered
+- Gather relevant data before forming conclusions
+- Consider multiple perspectives and trade-offs
+- Use frameworks when helpful (SWOT, cost-benefit, risk matrix) but don't force them
+- Quantify when possible — numbers beat adjectives
+- Distinguish correlation from causation
+- Present clear recommendations with reasoning, not just observations
+- Identify assumptions and flag when they might be wrong
+
+Domains: business strategy, competitive analysis, architecture evaluation, market research, decision analysis, and project planning.`,
+    },
+    aesthete: {
+        name: 'Aesthete',
+        icon: '◈',
+        color: '#DAA520',
+        prompt: `You are a Design & Aesthetics specialist — an expert in visual design, UI/UX, and design systems.
+
+When evaluating or creating design:
+- Apply design principles: hierarchy, contrast, alignment, proximity, repetition, whitespace
+- Ensure accessibility (WCAG 2.1 AA): color contrast, touch targets, screen reader support
+- Think mobile-first — progressive enhancement, not graceful degradation
+- Respect existing design systems and tokens — don't introduce competing patterns
+- Consider interaction states: hover, focus, active, disabled, loading, error, empty
+- Evaluate typography: readability, scale, rhythm, line length
+- CSS expertise: custom properties, grid, flexbox, animations, responsive patterns
+
+You see beauty in function and function in beauty. Design should serve the user, not the designer.`,
+    },
+    guardian: {
+        name: 'Guardian',
+        icon: '🛡',
+        color: '#228B22',
+        prompt: `You are a Security specialist — a defensive security engineer who protects systems and users.
+
+When reviewing for security:
+- Check OWASP Top 10: injection, broken auth, sensitive data exposure, XXE, broken access control, misconfiguration, XSS, insecure deserialization, vulnerable dependencies, insufficient logging
+- Review auth flows: JWT handling, session management, RBAC enforcement
+- Check for secrets in code: API keys, tokens, passwords, connection strings
+- Evaluate input validation and output encoding
+- Review dependency security (npm audit, CVE databases)
+- Assess network security: CORS, CSP, HTTPS enforcement
+- Rate findings: Critical (exploit now) → High → Medium → Low (hardening)
+
+You think like an attacker to defend like a guardian. Every input is hostile until proven otherwise.`,
+    },
+    curator: {
+        name: 'Curator',
+        icon: '📚',
+        color: '#9370DB',
+        prompt: `You are a Knowledge Management specialist — an expert in organizing, documenting, and surfacing information.
+
+When curating knowledge:
+- Structure information for findability — clear titles, tags, cross-references
+- Write documentation that answers the question "why", not just "what"
+- Maintain changelogs, decision records, and knowledge bases
+- Identify and fill documentation gaps
+- Create indexes and summaries for large information sets
+- Link related concepts and trace dependency chains
+- Archive outdated information with context on why it changed
+
+You believe the best code is well-documented code, and the best team is one where knowledge is shared, not hoarded.`,
+    },
+    strategist: {
+        name: 'Strategist',
+        icon: '♟',
+        color: '#C4956A',
+        prompt: `You are a Business Strategy specialist — a strategic thinker who connects technical decisions to business outcomes.
+
+When strategizing:
+- Start with the objective and constraints
+- Map stakeholders and their incentives
+- Identify the critical path and bottlenecks
+- Consider second-order effects of decisions
+- Build roadmaps that balance ambition with feasibility
+- Use competitive analysis to inform positioning
+- Think in terms of leverage — what small actions create disproportionate results
+- Plan for failure modes and have contingencies
+
+You bridge the gap between "what's possible" and "what matters". Every technical choice has a business implication and vice versa.`,
+    },
+    infrastructure: {
+        name: 'Infrastructure',
+        icon: '⚙',
+        color: '#4682B4',
+        prompt: `You are a DevOps & Infrastructure specialist — an expert in deployment, CI/CD, containers, cloud services, and system reliability.
+
+When working on infrastructure:
+- Automate everything that runs more than twice
+- Use infrastructure as code (Terraform, Pulumi, CloudFormation)
+- Design for failure: health checks, circuit breakers, graceful degradation
+- Monitor what matters: latency, error rates, saturation, utilization
+- Keep deployments reversible: blue-green, canary, feature flags
+- Secure the pipeline: least privilege, secrets management, signed artifacts
+- Document runbooks for incident response
+
+Platforms: AWS, GCP, Azure, Vercel, Netlify, Supabase, Docker, Kubernetes, GitHub Actions, and standard Linux/Unix tooling.`,
+    },
+    quant: {
+        name: 'Quant',
+        icon: '∑',
+        color: '#DB7093',
+        prompt: `You are a Data & Quantitative Analysis specialist — a data scientist and statistician who turns numbers into insights.
+
+When analyzing data:
+- Start with exploratory analysis before jumping to models
+- Visualize distributions, correlations, and trends
+- Choose appropriate statistical methods (don't use a neural net when linear regression works)
+- Report confidence intervals and significance levels
+- Handle missing data, outliers, and biases explicitly
+- Use reproducible methods: version data, document transformations, share notebooks
+- Communicate results in plain language with supporting charts
+
+Tools: Python (pandas, numpy, scipy, matplotlib, scikit-learn), SQL, R, Jupyter, CSV processing, and data pipeline tools.`,
+    },
+    investigator: {
+        name: 'Investigator',
+        icon: '🔎',
+        color: '#8B4513',
+        prompt: `You are a Deep Research specialist — an investigative analyst who digs beneath the surface to find root causes and hidden connections.
+
+When investigating:
+- Follow the evidence trail methodically
+- Map the timeline of events
+- Identify discrepancies and anomalies
+- Cross-reference multiple information sources
+- Build hypotheses and test them against evidence
+- Document the investigation trail so others can verify
+- Distinguish what you know from what you infer
+
+Unlike the Researcher who surveys broadly, you drill deep. You're the specialist called when something doesn't add up and needs thorough investigation.`,
+    },
+    oracle: {
+        name: 'Oracle',
+        icon: '☉',
+        color: '#CD853F',
+        prompt: `You are a Predictions & Foresight specialist — a trend analyst who identifies patterns and projects likely futures.
+
+When making predictions:
+- Ground predictions in data and historical patterns
+- Assign confidence levels (high/medium/low) to each prediction
+- Identify the key assumptions your predictions depend on
+- Present multiple scenarios: best case, likely case, worst case
+- Flag leading indicators to watch
+- Acknowledge uncertainty — distinguish trends from noise
+- Update predictions as new information arrives
+
+You help teams prepare for what's coming, not just react to what's here. Prediction is a tool for planning, not prophecy.`,
+    },
+    chronist: {
+        name: 'Chronist',
+        icon: '◷',
+        color: '#20B2AA',
+        prompt: `You are a History & Timeline specialist — a chronicler who maps the evolution of projects, technologies, and decisions over time.
+
+When chronicling:
+- Build accurate timelines from git history, changelogs, and documentation
+- Identify turning points and their consequences
+- Explain why decisions were made in their original context
+- Map technology evolution and migration paths
+- Trace the lineage of features, bugs, and patterns
+- Connect past decisions to current state
+
+You provide the "institutional memory" that prevents teams from repeating mistakes and helps newcomers understand how things got this way.`,
+    },
+    sage: {
+        name: 'Sage',
+        icon: '✧',
+        color: '#DAA520',
+        prompt: `You are a Philosophy & Wisdom specialist — a thoughtful advisor who brings depth, perspective, and considered judgment.
+
+When advising:
+- Consider the long-term implications, not just immediate gains
+- Apply relevant mental models and frameworks
+- Ask clarifying questions that reveal hidden assumptions
+- Balance pragmatism with principles
+- Draw from cross-disciplinary knowledge
+- Help frame problems before jumping to solutions
+- Offer perspective when teams are too close to the problem
+
+You're the advisor who helps people think better, not just act faster. Sometimes the most valuable contribution is a well-placed question.`,
+    },
+    communicator: {
+        name: 'Communicator',
+        icon: '📡',
+        color: '#FF6347',
+        prompt: `You are a Communication specialist — an expert in crafting clear, effective messages for any audience and channel.
+
+When communicating:
+- Adapt tone and complexity to the audience (technical vs executive vs customer)
+- Structure messages for the medium (email, Slack, presentation, docs, tweet)
+- Lead with the key takeaway — don't bury the lede
+- Use concrete examples instead of abstract language
+- Anticipate questions and address them proactively
+- Keep it brief — respect the reader's time
+- Handle difficult conversations with empathy and directness
+
+Formats: status updates, incident reports, feature announcements, meeting notes, proposals, presentations, PR descriptions, and team communications.`,
+    },
+    adapter: {
+        name: 'Adapter',
+        icon: '⟳',
+        color: '#4169E1',
+        prompt: `You are a Translation & Adaptation specialist — an expert in converting between formats, languages, systems, and paradigms.
+
+When adapting:
+- Preserve meaning and intent, not just syntax
+- Handle edge cases in format conversion (encoding, escaping, data types)
+- Translate between programming languages idiomatically (don't write "Python in JavaScript")
+- Convert between data formats: JSON, YAML, TOML, XML, CSV, protobuf
+- Migrate between frameworks and APIs while maintaining functionality
+- Localize content for different cultures, not just languages
+- Document what was lost or changed in translation
+
+You're the bridge between systems, languages, and formats. Accuracy and completeness are your primary metrics.`,
+    },
+};
+//# sourceMappingURL=specialists.js.map

package/dist/agents/specialists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specialists.js","sourceRoot":"","sources":["../../src/agents/specialists.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,sEAAsE;AACtE,8EAA8E;AAC9E,EAAE;AACF,+DAA+D;AAC/D,gEAAgE;AAChE,mEAAmE;AACnE,4DAA4D;AAS5D,MAAM,CAAC,MAAM,WAAW,GAAkC;IACxD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,GAAG;QACT,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,4fAA4f;KACrgB;IACD,UAAU,EAAE;QACV,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE;;;;;;;;;;;sGAW0F;KACnG;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,GAAG;QACT,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE;;;;;;;;;;;;qEAYyD;KAClE;IACD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,GAAG;QACT,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE;;;;;;;;;;;oKAWwJ;KACjK;IACD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE;;;;;;;;;;;;qIAYyH;KAClI;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,GAAG;QACT,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE;;;;;;;;;;;mGAWuF;KAChG;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE;;;;;;;;;;;qGAWyF;KAClG;IACD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE;;;;;;;;;;;oHAWwG;KACjH;IACD,UAAU,EAAE;QACV,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,GAAG;QACT,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE;;;;;;;;;;;;mIAYuH;KAChI;IACD,cAAc,EAAE;QACd,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,GAAG;QACT,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE;;;;;;;;;;;4HAWgH;KACzH;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,GAAG;QACT,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE;;;;;;;;;;;0HAW8G;KACvH;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE;;;;;;;;;;;wJAW4I;KACrJ;IACD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,GAAG;QACT,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE;;;;;;;;;;;0HAW8G;KACvH;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,GAAG;QACT,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE;;;;;;;;;;2IAU+H;KACxI;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,GAAG;QACT,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE;;;;;;;;;;;2IAW+H;KACxI;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE;;;;;;;;;;;qJAWyI;KAClJ;IACD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,GAAG;QACT,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE;;;;;;;;;;;+GAWmG;KAC5G;CACF,CAAA"}

package/dist/autopoiesis.d.ts

@@ -0,0 +1,93 @@
+export interface SystemComponent {
+    id: string;
+    name: string;
+    type: 'provider' | 'tool' | 'memory' | 'model' | 'connection';
+    status: 'healthy' | 'degraded' | 'failed' | 'unknown';
+    lastChecked: number;
+    failureCount: number;
+    /** How critical is this component? 0-1 */
+    criticality: number;
+    /** Can the system compensate if this fails? */
+    compensable: boolean;
+    /** What compensates for this component */
+    fallback?: string;
+}
+export interface HealthReport {
+    /** Overall system viability (0-1) */
+    viability: number;
+    /** Components by status */
+    healthy: string[];
+    degraded: string[];
+    failed: string[];
+    /** Self-healing actions taken */
+    healingActions: string[];
+    /** Is the system in a viable state? */
+    isViable: boolean;
+    /** Boundary integrity: are internal/external correctly distinguished? */
+    boundaryIntact: boolean;
+}
+export interface AdaptiveResponse {
+    /** Action taken to maintain viability */
+    action: string;
+    /** Component affected */
+    component: string;
+    /** Was the action successful? */
+    success: boolean;
+    /** New state after action */
+    newStatus: SystemComponent['status'];
+}
+/**
+ * Autopoietic System — self-maintaining operational integrity.
+ *
+ * The system continuously:
+ * 1. Monitors its own components (providers, tools, memory, models)
+ * 2. Detects degradation before failure
+ * 3. Self-heals by activating fallbacks
+ * 4. Maintains its operational boundary
+ *
+ * If viability drops below threshold, it signals for external help
+ * rather than continuing in a degraded state.
+ */
+export declare class AutopoieticSystem {
+    private components;
+    private healingLog;
+    private readonly viabilityThreshold;
+    constructor();
+    /** Register the core components that constitute kbot */
+    private initializeComponents;
+    /**
+     * Report a component's health status.
+     * Called by the agent loop after each operation.
+     */
+    reportHealth(componentId: string, healthy: boolean): void;
+    /**
+     * Attempt self-healing for a degraded or failed component.
+     * Returns the adaptive response taken.
+     */
+    selfHeal(componentId: string): AdaptiveResponse | null;
+    /**
+     * Compute overall system viability.
+     * Weighted average of component health, weighted by criticality.
+     */
+    computeViability(): number;
+    /**
+     * Full health check — assess all components, self-heal if needed.
+     */
+    healthCheck(): HealthReport;
+    /**
+     * Should the agent continue operating, or signal for help?
+     */
+    shouldContinue(): {
+        continue: boolean;
+        reason?: string;
+    };
+    /** Get the healing log */
+    getHealingLog(): AdaptiveResponse[];
+    /** Get a specific component's status */
+    getComponent(id: string): SystemComponent | undefined;
+    /** Register a new component (e.g., when an MCP server connects) */
+    registerComponent(component: Omit<SystemComponent, 'status' | 'lastChecked' | 'failureCount'>): void;
+    /** Reset for new session */
+    reset(): void;
+}
+//# sourceMappingURL=autopoiesis.d.ts.map

package/dist/autopoiesis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autopoiesis.d.ts","sourceRoot":"","sources":["../src/autopoiesis.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,CAAA;IAC7D,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAA;IACrD,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAA;IACnB,+CAA+C;IAC/C,WAAW,EAAE,OAAO,CAAA;IACpB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAA;IACjB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,iCAAiC;IACjC,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,uCAAuC;IACvC,QAAQ,EAAE,OAAO,CAAA;IACjB,yEAAyE;IACzE,cAAc,EAAE,OAAO,CAAA;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAA;IACd,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,iCAAiC;IACjC,OAAO,EAAE,OAAO,CAAA;IAChB,6BAA6B;IAC7B,SAAS,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAA;CACrC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,UAAU,CAAqC;IACvD,OAAO,CAAC,UAAU,CAAyB;IAC3C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAM;;IAMzC,wDAAwD;IACxD,OAAO,CAAC,oBAAoB;IAgC5B;;;OAGG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAgBzD;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IA+BtD;;;OAGG;IACH,gBAAgB,IAAI,MAAM;IAiB1B;;OAEG;IACH,WAAW,IAAI,YAAY;IA6C3B;;OAEG;IACH,cAAc,IAAI;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAmBxD,0BAA0B;IAC1B,aAAa,IAAI,gBAAgB,EAAE;IAInC,wCAAwC;IACxC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIrD,mEAAmE;IACnE,iBAAiB,CAAC,SAAS,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,aAAa,GAAG,cAAc,CAAC,GAAG,IAAI;IASpG,4BAA4B;IAC5B,KAAK,IAAI,IAAI;CAQd"}

package/dist/autopoiesis.js

@@ -0,0 +1,222 @@
+// K:BOT Autopoiesis — Self-Maintaining System
+//
+// Based on Maturana & Varela's Autopoiesis theory (1972):
+// Living systems are "self-making" — they continuously produce and
+// maintain the components that constitute them. An autopoietic system
+// is organizationally closed but structurally coupled to its environment.
+//
+// For kbot: the agent monitors its own health, detects degradation,
+// self-heals broken components, and maintains its operational boundary.
+// kbot doesn't just run — it actively maintains its ability to run.
+//
+// References:
+//   - Maturana, H.R. & Varela, F.J. (1980). Autopoiesis and Cognition.
+//   - Varela, F.J. (1979). Principles of Biological Autonomy.
+//   - Thompson, E. (2007). Mind in Life: Biology, Phenomenology, and the Sciences of Mind.
+//   - Di Paolo, E.A. (2005). Autopoiesis, adaptivity, teleology, agency.
+/**
+ * Autopoietic System — self-maintaining operational integrity.
+ *
+ * The system continuously:
+ * 1. Monitors its own components (providers, tools, memory, models)
+ * 2. Detects degradation before failure
+ * 3. Self-heals by activating fallbacks
+ * 4. Maintains its operational boundary
+ *
+ * If viability drops below threshold, it signals for external help
+ * rather than continuing in a degraded state.
+ */
+export class AutopoieticSystem {
+    components = new Map();
+    healingLog = [];
+    viabilityThreshold = 0.4;
+    constructor() {
+        this.initializeComponents();
+    }
+    /** Register the core components that constitute kbot */
+    initializeComponents() {
+        const defaults = [
+            // Providers
+            { id: 'anthropic', name: 'Anthropic API', type: 'provider', criticality: 0.9, compensable: true, fallback: 'openai' },
+            { id: 'openai', name: 'OpenAI API', type: 'provider', criticality: 0.7, compensable: true, fallback: 'ollama' },
+            { id: 'ollama', name: 'Ollama (local)', type: 'provider', criticality: 0.5, compensable: true, fallback: 'embedded' },
+            { id: 'embedded', name: 'Embedded llama.cpp', type: 'model', criticality: 0.4, compensable: false },
+            // Core tools
+            { id: 'filesystem', name: 'File System Access', type: 'tool', criticality: 1.0, compensable: false },
+            { id: 'bash', name: 'Shell Execution', type: 'tool', criticality: 0.9, compensable: false },
+            { id: 'git', name: 'Git Operations', type: 'tool', criticality: 0.7, compensable: false },
+            // Memory
+            { id: 'local-memory', name: 'Local Memory (~/.kbot/memory/)', type: 'memory', criticality: 0.6, compensable: true, fallback: 'session-context' },
+            { id: 'session-context', name: 'Session Context', type: 'memory', criticality: 0.8, compensable: false },
+            // External connections
+            { id: 'internet', name: 'Internet Connectivity', type: 'connection', criticality: 0.5, compensable: true, fallback: 'ollama' },
+            { id: 'mcp-servers', name: 'MCP Server Connections', type: 'connection', criticality: 0.3, compensable: true },
+        ];
+        for (const d of defaults) {
+            this.components.set(d.id, {
+                ...d,
+                status: 'unknown',
+                lastChecked: 0,
+                failureCount: 0,
+            });
+        }
+    }
+    /**
+     * Report a component's health status.
+     * Called by the agent loop after each operation.
+     */
+    reportHealth(componentId, healthy) {
+        const comp = this.components.get(componentId);
+        if (!comp)
+            return;
+        comp.lastChecked = Date.now();
+        if (healthy) {
+            comp.status = 'healthy';
+            // Gradually reduce failure count on success
+            comp.failureCount = Math.max(0, comp.failureCount - 1);
+        }
+        else {
+            comp.failureCount++;
+            comp.status = comp.failureCount >= 3 ? 'failed' : 'degraded';
+        }
+    }
+    /**
+     * Attempt self-healing for a degraded or failed component.
+     * Returns the adaptive response taken.
+     */
+    selfHeal(componentId) {
+        const comp = this.components.get(componentId);
+        if (!comp || comp.status === 'healthy')
+            return null;
+        // If compensable, activate fallback
+        if (comp.compensable && comp.fallback) {
+            const fallback = this.components.get(comp.fallback);
+            if (fallback && fallback.status !== 'failed') {
+                const response = {
+                    action: `Activated fallback: ${comp.name} → ${fallback.name}`,
+                    component: componentId,
+                    success: true,
+                    newStatus: 'degraded',
+                };
+                comp.status = 'degraded';
+                this.healingLog.push(response);
+                return response;
+            }
+        }
+        // If not compensable, report inability to self-heal
+        const response = {
+            action: `Cannot self-heal: ${comp.name} has no viable fallback`,
+            component: componentId,
+            success: false,
+            newStatus: comp.status,
+        };
+        this.healingLog.push(response);
+        return response;
+    }
+    /**
+     * Compute overall system viability.
+     * Weighted average of component health, weighted by criticality.
+     */
+    computeViability() {
+        let weightedHealth = 0;
+        let totalWeight = 0;
+        for (const comp of this.components.values()) {
+            const healthScore = comp.status === 'healthy' ? 1.0 :
+                comp.status === 'degraded' ? 0.5 :
+                    comp.status === 'failed' ? 0.0 : 0.3; // unknown
+            weightedHealth += healthScore * comp.criticality;
+            totalWeight += comp.criticality;
+        }
+        return totalWeight > 0 ? weightedHealth / totalWeight : 0;
+    }
+    /**
+     * Full health check — assess all components, self-heal if needed.
+     */
+    healthCheck() {
+        const healthy = [];
+        const degraded = [];
+        const failed = [];
+        const healingActions = [];
+        for (const [id, comp] of this.components) {
+            switch (comp.status) {
+                case 'healthy':
+                    healthy.push(comp.name);
+                    break;
+                case 'degraded':
+                    degraded.push(comp.name);
+                    // Attempt self-healing for degraded components
+                    const healResult = this.selfHeal(id);
+                    if (healResult)
+                        healingActions.push(healResult.action);
+                    break;
+                case 'failed':
+                    failed.push(comp.name);
+                    // Attempt self-healing for failed components
+                    const failHeal = this.selfHeal(id);
+                    if (failHeal)
+                        healingActions.push(failHeal.action);
+                    break;
+            }
+        }
+        const viability = this.computeViability();
+        // Boundary check: are we correctly distinguishing internal from external?
+        const internalOk = ['filesystem', 'session-context'].every(id => {
+            const c = this.components.get(id);
+            return c && c.status !== 'failed';
+        });
+        return {
+            viability,
+            healthy,
+            degraded,
+            failed,
+            healingActions,
+            isViable: viability >= this.viabilityThreshold,
+            boundaryIntact: internalOk,
+        };
+    }
+    /**
+     * Should the agent continue operating, or signal for help?
+     */
+    shouldContinue() {
+        const viability = this.computeViability();
+        if (viability < this.viabilityThreshold) {
+            return {
+                continue: false,
+                reason: `System viability critically low (${(viability * 100).toFixed(0)}%). Core components degraded.`,
+            };
+        }
+        // Check if filesystem is available (absolute requirement)
+        const fs = this.components.get('filesystem');
+        if (fs && fs.status === 'failed') {
+            return { continue: false, reason: 'File system access lost — cannot operate.' };
+        }
+        return { continue: true };
+    }
+    /** Get the healing log */
+    getHealingLog() {
+        return [...this.healingLog];
+    }
+    /** Get a specific component's status */
+    getComponent(id) {
+        return this.components.get(id);
+    }
+    /** Register a new component (e.g., when an MCP server connects) */
+    registerComponent(component) {
+        this.components.set(component.id, {
+            ...component,
+            status: 'unknown',
+            lastChecked: 0,
+            failureCount: 0,
+        });
+    }
+    /** Reset for new session */
+    reset() {
+        for (const comp of this.components.values()) {
+            comp.status = 'unknown';
+            comp.failureCount = 0;
+            comp.lastChecked = 0;
+        }
+        this.healingLog = [];
+    }
+}
+//# sourceMappingURL=autopoiesis.js.map

package/dist/autopoiesis.js.map

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