helixmind 0.5.4

package/dist/index.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer } from './server.js';
+import { loadConfig } from './utils/config.js';
+import { setLogLevel, logger } from './utils/logger.js';
+async function main() {
+    const config = loadConfig();
+    setLogLevel(config.logLevel);
+    logger.info('Starting spiral-context-mcp server...');
+    const { server, engine } = createServer(config);
+    // Initialize embedding model (async, non-blocking for server start)
+    engine.initialize().catch(err => {
+        logger.warn(`Embedding initialization failed: ${err}. Running in fallback mode.`);
+    });
+    // Connect via STDIO transport
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info('spiral-context-mcp server connected via STDIO');
+    // Handle graceful shutdown
+    process.on('SIGINT', () => {
+        logger.info('Shutting down...');
+        engine.close();
+        process.exit(0);
+    });
+    process.on('SIGTERM', () => {
+        logger.info('Shutting down...');
+        engine.close();
+        process.exit(0);
+    });
+}
+main().catch(err => {
+    process.stderr.write(`Fatal error: ${err}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAExD,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE7B,MAAM,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IAErD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAEhD,oEAAoE;IACpE,MAAM,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;QAC9B,MAAM,CAAC,IAAI,CAAC,oCAAoC,GAAG,6BAA6B,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;IAEH,8BAA8B;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,MAAM,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;IAE7D,2BAA2B;IAC3B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACxB,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAChC,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACzB,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAChC,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;IACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,8 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { SpiralEngine } from './spiral/engine.js';
+import type { SpiralConfig } from './types.js';
+export declare function createServer(config: SpiralConfig): {
+    server: McpServer;
+    engine: SpiralEngine;
+};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMlD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,CAgE9F"}

package/dist/server.js

@@ -0,0 +1,44 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { SpiralEngine } from './spiral/engine.js';
+import { spiralQuerySchema, handleSpiralQuery } from './tools/spiral-query.js';
+import { spiralStoreSchema, handleSpiralStore } from './tools/spiral-store.js';
+import { handleSpiralStatus } from './tools/spiral-status.js';
+import { spiralCompactSchema, handleSpiralCompact } from './tools/spiral-compact.js';
+import { spiralRelateSchema, handleSpiralRelate } from './tools/spiral-relate.js';
+import { VERSION } from './cli/version.js';
+export function createServer(config) {
+    const engine = new SpiralEngine(config);
+    const server = new McpServer({ name: 'spiral-context-mcp', version: VERSION }, { capabilities: { logging: {} } });
+    // Tool: spiral_context – Query context across spiral levels
+    server.registerTool('spiral_context', {
+        title: 'Spiral Context',
+        description: 'Query the spiral context store. Returns proactively assembled context across Focus (L1), Association (L2), and Periphery (L3) levels.',
+        inputSchema: spiralQuerySchema,
+    }, async (args) => handleSpiralQuery(engine, args));
+    // Tool: spiral_store – Store new context
+    server.registerTool('spiral_store', {
+        title: 'Spiral Store',
+        description: 'Store new context in the spiral. Automatically generates embeddings, detects relations to existing context, and assigns the appropriate spiral level.',
+        inputSchema: spiralStoreSchema,
+    }, async (args) => handleSpiralStore(engine, args));
+    // Tool: spiral_status – Get spiral metrics
+    server.registerTool('spiral_status', {
+        title: 'Spiral Status',
+        description: 'Show the current state of the spiral context store: node counts per level, edge counts, storage size, and embedding status.',
+        inputSchema: {},
+    }, async () => handleSpiralStatus(engine));
+    // Tool: spiral_compact – Manual compaction
+    server.registerTool('spiral_compact', {
+        title: 'Spiral Compact',
+        description: 'Trigger manual compaction. Compresses old context nodes and optionally deletes very old ones in aggressive mode.',
+        inputSchema: spiralCompactSchema,
+    }, async (args) => handleSpiralCompact(engine, args));
+    // Tool: spiral_relate – Create manual relations
+    server.registerTool('spiral_relate', {
+        title: 'Spiral Relate',
+        description: 'Manually create a relation between two context nodes. Relations are used to proactively inject associated context.',
+        inputSchema: spiralRelateSchema,
+    }, async (args) => handleSpiralRelate(engine, args));
+    return { server, engine };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAElF,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IAExC,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,OAAO,EAAE,EAChD,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,CAClC,CAAC;IAEF,4DAA4D;IAC5D,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,uIAAuI;QACpJ,WAAW,EAAE,iBAAiB;KAC/B,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,CAChD,CAAC;IAEF,yCAAyC;IACzC,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,uJAAuJ;QACpK,WAAW,EAAE,iBAAiB;KAC/B,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,CAChD,CAAC;IAEF,2CAA2C;IAC3C,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,6HAA6H;QAC1I,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,IAAI,EAAE,CAAC,kBAAkB,CAAC,MAAM,CAAC,CACvC,CAAC;IAEF,2CAA2C;IAC3C,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,kHAAkH;QAC/H,WAAW,EAAE,mBAAmB;KACjC,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,CAClD,CAAC;IAEF,gDAAgD;IAChD,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,oHAAoH;QACjI,WAAW,EAAE,kBAAkB;KAChC,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,CACjD,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC"}

package/dist/shared/protocol-types.d.ts

@@ -0,0 +1,283 @@
+/**
+ * Shared Protocol Types — canonical definitions for CLI ↔ Web communication.
+ *
+ * This file is the single source of truth for wire types used in both:
+ * - CLI: src/cli/brain/control-protocol.ts (re-exports + CLI-only types)
+ * - Web: web/src/lib/cli-types.ts (re-exports + web-only types)
+ */
+export type SessionStatus = 'idle' | 'running' | 'done' | 'error' | 'paused';
+export interface SessionInfo {
+    id: string;
+    name: string;
+    icon: string;
+    status: SessionStatus;
+    startTime: number;
+    endTime: number;
+    elapsed: number;
+    outputLineCount: number;
+    recentOutput: string[];
+    result: {
+        text: string;
+        stepsCount: number;
+        errorsCount: number;
+    } | null;
+    /** Agent identity name (e.g. "@main", "@jarvis") */
+    agentName?: string;
+    /** Agent identity color hex (e.g. "#00d4ff") */
+    agentColor?: string;
+    /** Swarm ID if this session is a swarm worker */
+    swarmId?: string;
+    /** Sub-task ID within the swarm */
+    swarmTaskId?: number;
+}
+export interface InstanceMeta {
+    instanceId: string;
+    projectName: string;
+    projectPath: string;
+    model: string;
+    provider: string;
+    uptime: number;
+    version: string;
+    permissionMode?: 'safe' | 'skip-permissions' | 'yolo';
+}
+export interface Finding {
+    sessionName: string;
+    finding: string;
+    severity: 'critical' | 'high' | 'medium' | 'low' | 'info';
+    file: string;
+    timestamp: number;
+}
+export type BugStatus = 'open' | 'investigating' | 'fixed' | 'verified';
+export interface BugInfo {
+    id: number;
+    description: string;
+    file?: string;
+    line?: number;
+    status: BugStatus;
+    createdAt: number;
+    updatedAt: number;
+    fixedAt?: number;
+    fixDescription?: string;
+}
+export interface BrowserScreenshotInfo {
+    url: string;
+    title?: string;
+    timestamp: number;
+    imageBase64?: string;
+    analysis?: string;
+}
+export type JarvisTaskStatus = 'pending' | 'running' | 'completed' | 'failed' | 'paused';
+export type JarvisTaskPriority = 'high' | 'medium' | 'low';
+export type JarvisDaemonState = 'stopped' | 'running' | 'paused';
+export interface JarvisTaskInfo {
+    id: number;
+    title: string;
+    description: string;
+    status: JarvisTaskStatus;
+    priority: JarvisTaskPriority;
+    createdAt: number;
+    updatedAt: number;
+    startedAt?: number;
+    completedAt?: number;
+    result?: string;
+    error?: string;
+    retries: number;
+    maxRetries: number;
+    sessionId?: string;
+    dependencies?: number[];
+    tags?: string[];
+}
+export interface JarvisStatusInfo {
+    daemonState: JarvisDaemonState;
+    currentTaskId: number | null;
+    pendingCount: number;
+    completedCount: number;
+    failedCount: number;
+    totalCount: number;
+    uptimeMs: number;
+    autonomyLevel?: number;
+    thinkingPhase?: string;
+    activeWorkers?: number;
+    scope?: 'local' | 'global';
+    jarvisName?: string;
+}
+export interface ProposalInfo {
+    id: number;
+    title: string;
+    description: string;
+    rationale: string;
+    status: 'pending' | 'approved' | 'denied' | 'expired';
+    category: string;
+    affectedFiles: string[];
+    createdAt: number;
+    decidedAt?: number;
+    denialReason?: string;
+}
+export interface IdentityInfo {
+    traits: Record<string, number>;
+    trust: {
+        approvalRate: number;
+        successRate: number;
+        totalProposals: number;
+    };
+    autonomyLevel: number;
+    uptime: number;
+    recentLearnings: string[];
+}
+export interface ScheduleInfo {
+    id: number;
+    type: string;
+    expression: string;
+    taskTitle: string;
+    enabled: boolean;
+    nextRunAt?: number;
+    lastRunAt?: number;
+}
+export interface TriggerInfo {
+    id: number;
+    source: string;
+    pattern: string;
+    action: string;
+    enabled: boolean;
+    lastFiredAt?: number;
+}
+export interface WorkerInfo {
+    workerId: number;
+    taskId: number;
+    taskTitle: string;
+    status: 'running' | 'completed' | 'failed';
+    startedAt: number;
+    completedAt?: number;
+}
+export type SwarmStatus = 'idle' | 'planning' | 'executing' | 'completed' | 'failed' | 'aborted';
+export interface SwarmInfo {
+    id: string;
+    originalRequest: string;
+    status: SwarmStatus;
+    reason: string;
+    subTasks: SwarmSubTaskInfo[];
+    parallelGroups: number[][];
+    startedAt: number;
+    completedAt?: number;
+    totalCompleted: number;
+    totalFailed: number;
+}
+export interface SwarmSubTaskInfo {
+    id: number;
+    title: string;
+    description: string;
+    affectedFiles: string[];
+    dependencies: number[];
+    status: 'pending' | 'running' | 'completed' | 'failed';
+    sessionId?: string;
+    workerId?: number;
+    startedAt?: number;
+    completedAt?: number;
+    result?: string;
+}
+export interface ChatFileAttachment {
+    name: string;
+    mimeType: string;
+    sizeBytes: number;
+    dataBase64: string;
+}
+export interface ToolPermissionRequest {
+    id: string;
+    toolName: string;
+    toolInput: Record<string, unknown>;
+    permissionLevel: 'ask' | 'dangerous';
+    detail: string;
+    sessionId: string;
+    timestamp: number;
+    expiresAt: number;
+    reminderAt?: number;
+}
+export interface StatusBarInfo {
+    spiral: {
+        l1: number;
+        l2: number;
+        l3: number;
+        l4: number;
+        l5: number;
+        l6: number;
+    };
+    tokens: {
+        thisMessage: number;
+        thisSession: number;
+        sessionTotal: number;
+    };
+    tools: {
+        callsThisRound: number;
+    };
+    model: string;
+    git: {
+        branch: string;
+        uncommitted: number;
+    };
+    checkpoints: number;
+    permissionMode: 'safe' | 'skip' | 'yolo' | 'plan';
+    autonomous: boolean;
+    paused: boolean;
+    /** Plan mode active indicator */
+    planMode?: boolean;
+    /** Active plan status description */
+    plan?: string;
+}
+export interface CheckpointInfo {
+    id: number;
+    timestamp: number;
+    type: string;
+    label: string;
+    messageIndex: number;
+    hasFileSnapshots: boolean;
+    fileCount: number;
+    toolName?: string;
+}
+export type PlanStepStatusInfo = 'pending' | 'running' | 'done' | 'error' | 'skipped';
+export type PlanStatusInfo = 'drafting' | 'pending_approval' | 'approved' | 'executing' | 'completed' | 'failed' | 'rejected' | 'modified';
+export interface PlanStepInfo {
+    id: number;
+    title: string;
+    description: string;
+    tools: string[];
+    affectedFiles: string[];
+    dependencies: number[];
+    status: PlanStepStatusInfo;
+    result?: string;
+    error?: string;
+    startedAt?: number;
+    completedAt?: number;
+}
+export interface PlanInfo {
+    id: string;
+    title: string;
+    description: string;
+    steps: PlanStepInfo[];
+    status: PlanStatusInfo;
+    source: 'user_plan_mode' | 'jarvis_proposal' | 'auto_complex';
+    createdAt: number;
+    approvedAt?: number;
+    completedAt?: number;
+    rejectionReason?: string;
+    totalStepsCompleted: number;
+    totalStepsFailed: number;
+    proposalId?: number;
+}
+export type VoiceSessionState = 'idle' | 'listening' | 'processing' | 'speaking';
+export type VoiceProvider = 'elevenlabs' | 'web_speech';
+export type STTProvider = 'whisper' | 'web_speech';
+export interface VoiceConfig {
+    sttProvider: STTProvider;
+    ttsProvider: VoiceProvider;
+    elevenLabsApiKey?: string;
+    clonedVoiceId?: string;
+    whisperModel?: string;
+    vadSensitivity?: number;
+    enabled: boolean;
+}
+export interface WSMessage {
+    type: string;
+    requestId?: string;
+    timestamp: number;
+}
+//# sourceMappingURL=protocol-types.d.ts.map

package/dist/shared/protocol-types.d.ts.map

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

package/dist/shared/protocol-types.js

@@ -0,0 +1,9 @@
+/**
+ * Shared Protocol Types — canonical definitions for CLI ↔ Web communication.
+ *
+ * This file is the single source of truth for wire types used in both:
+ * - CLI: src/cli/brain/control-protocol.ts (re-exports + CLI-only types)
+ * - Web: web/src/lib/cli-types.ts (re-exports + web-only types)
+ */
+export {};
+//# sourceMappingURL=protocol-types.js.map

package/dist/shared/protocol-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-types.js","sourceRoot":"","sources":["../../src/shared/protocol-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/spiral/cloud/content-extractor.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Content Extractor — Processes raw web content into spiral-ready knowledge.
+ *
+ * Takes HTML text/extracted content and produces clean, structured
+ * knowledge chunks that can be stored in the spiral brain.
+ */
+export interface ExtractedKnowledge {
+    /** Compressed summary of the content */
+    summary: string;
+    /** Code examples found */
+    codeExamples: string[];
+    /** Key points / best practices */
+    keyPoints: string[];
+    /** Source URL */
+    source: string;
+    /** Estimated quality score 0-1 */
+    quality: number;
+}
+/**
+ * Extract structured knowledge from page content.
+ */
+export declare function extractKnowledge(content: string, sourceUrl: string, topic: string): ExtractedKnowledge;
+/**
+ * Format extracted knowledge into a spiral-storable string.
+ */
+export declare function formatForSpiral(knowledge: ExtractedKnowledge, topic: string): string;
+//# sourceMappingURL=content-extractor.d.ts.map

package/dist/spiral/cloud/content-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-extractor.d.ts","sourceRoot":"","sources":["../../../src/spiral/cloud/content-extractor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,kCAAkC;IAClC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iBAAiB;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,kBAAkB,CAapB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,kBAAkB,EAC7B,KAAK,EAAE,MAAM,GACZ,MAAM,CA6BR"}

package/dist/spiral/cloud/content-extractor.js

@@ -0,0 +1,175 @@
+/**
+ * Content Extractor — Processes raw web content into spiral-ready knowledge.
+ *
+ * Takes HTML text/extracted content and produces clean, structured
+ * knowledge chunks that can be stored in the spiral brain.
+ */
+/**
+ * Extract structured knowledge from page content.
+ */
+export function extractKnowledge(content, sourceUrl, topic) {
+    const codeExamples = extractCodeBlocks(content);
+    const keyPoints = extractKeyPoints(content, topic);
+    const summary = buildSummary(content, topic, keyPoints);
+    const quality = assessQuality(content, codeExamples, keyPoints, topic);
+    return {
+        summary,
+        codeExamples: codeExamples.slice(0, 3), // Max 3 code examples
+        keyPoints: keyPoints.slice(0, 8), // Max 8 key points
+        source: sourceUrl,
+        quality,
+    };
+}
+/**
+ * Format extracted knowledge into a spiral-storable string.
+ */
+export function formatForSpiral(knowledge, topic) {
+    const sections = [];
+    sections.push(`[Web Knowledge: ${topic}]`);
+    sections.push(`Source: ${knowledge.source}`);
+    sections.push('');
+    if (knowledge.summary) {
+        sections.push(knowledge.summary);
+        sections.push('');
+    }
+    if (knowledge.keyPoints.length > 0) {
+        sections.push('Key Points:');
+        for (const point of knowledge.keyPoints) {
+            sections.push(`- ${point}`);
+        }
+        sections.push('');
+    }
+    if (knowledge.codeExamples.length > 0) {
+        sections.push('Code Examples:');
+        for (const code of knowledge.codeExamples) {
+            sections.push(code);
+            sections.push('');
+        }
+    }
+    return sections.join('\n').slice(0, 4000); // Max 4000 chars per node
+}
+/**
+ * Extract code blocks from content (markdown-style or raw).
+ */
+function extractCodeBlocks(content) {
+    const blocks = [];
+    // Markdown fenced code blocks
+    const fencedPattern = /```[\w]*\n([\s\S]*?)```/g;
+    let match;
+    while ((match = fencedPattern.exec(content)) !== null) {
+        const code = match[1].trim();
+        if (code.length > 20 && code.length < 2000) {
+            blocks.push('```\n' + code + '\n```');
+        }
+    }
+    // Inline code (longer ones, likely examples)
+    const inlinePattern = /`([^`]{50,500})`/g;
+    while ((match = inlinePattern.exec(content)) !== null) {
+        blocks.push('`' + match[1].trim() + '`');
+    }
+    return blocks;
+}
+/**
+ * Extract key points related to the topic.
+ */
+function extractKeyPoints(content, topic) {
+    const points = [];
+    const topicWords = topic.toLowerCase().split(/\s+/);
+    const lines = content.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Skip empty, very short, or very long lines
+        if (trimmed.length < 20 || trimmed.length > 300)
+            continue;
+        // List items that mention the topic
+        if (trimmed.startsWith('- ') || trimmed.startsWith('* ') || /^\d+\./.test(trimmed)) {
+            const lower = trimmed.toLowerCase();
+            const isRelevant = topicWords.some(w => lower.includes(w));
+            if (isRelevant) {
+                points.push(trimmed.replace(/^[-*]\s+/, '').replace(/^\d+\.\s+/, ''));
+            }
+        }
+        // Sentences with "best practice", "should", "recommend", "important"
+        if (/\b(best practice|should|recommend|important|always|never|avoid|prefer|use|tip)\b/i.test(trimmed)) {
+            const lower = trimmed.toLowerCase();
+            const isRelevant = topicWords.some(w => lower.includes(w));
+            if (isRelevant && !trimmed.startsWith('#')) {
+                // Clean up and add
+                const clean = trimmed
+                    .replace(/^#+\s*/, '')
+                    .replace(/\*\*/g, '')
+                    .trim();
+                if (clean.length > 20 && !points.includes(clean)) {
+                    points.push(clean);
+                }
+            }
+        }
+    }
+    return points;
+}
+/**
+ * Build a concise summary from the content.
+ */
+function buildSummary(content, topic, keyPoints) {
+    // If we have key points, build summary from them
+    if (keyPoints.length >= 3) {
+        return `${topic}: ${keyPoints.slice(0, 3).join('. ')}.`;
+    }
+    // Otherwise extract first relevant paragraph
+    const paragraphs = content.split('\n\n');
+    const topicWords = topic.toLowerCase().split(/\s+/);
+    for (const para of paragraphs) {
+        const trimmed = para.trim();
+        if (trimmed.length < 50 || trimmed.length > 500)
+            continue;
+        if (trimmed.startsWith('```') || trimmed.startsWith('#'))
+            continue;
+        const lower = trimmed.toLowerCase();
+        if (topicWords.some(w => lower.includes(w))) {
+            return trimmed.slice(0, 300);
+        }
+    }
+    // Fallback: first substantial paragraph
+    for (const para of paragraphs) {
+        const trimmed = para.trim();
+        if (trimmed.length > 50 && trimmed.length < 500 && !trimmed.startsWith('```')) {
+            return trimmed.slice(0, 300);
+        }
+    }
+    return `Web knowledge about ${topic}`;
+}
+/**
+ * Assess the quality of extracted content.
+ * Higher quality = more code examples, more key points, topic relevance.
+ */
+function assessQuality(content, codeExamples, keyPoints, topic) {
+    let score = 0.3; // Base score for having any content
+    // Code examples boost quality
+    if (codeExamples.length > 0)
+        score += 0.2;
+    if (codeExamples.length >= 2)
+        score += 0.1;
+    // Key points boost quality
+    if (keyPoints.length >= 3)
+        score += 0.15;
+    if (keyPoints.length >= 5)
+        score += 0.1;
+    // Topic mention density
+    const topicWords = topic.toLowerCase().split(/\s+/);
+    const lower = content.toLowerCase();
+    let mentions = 0;
+    for (const word of topicWords) {
+        const regex = new RegExp(`\\b${escapeRegex(word)}\\b`, 'gi');
+        const matches = lower.match(regex);
+        mentions += matches?.length ?? 0;
+    }
+    if (mentions > 5)
+        score += 0.1;
+    if (mentions > 15)
+        score += 0.05;
+    return Math.min(1.0, score);
+}
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=content-extractor.js.map

package/dist/spiral/cloud/content-extractor.js.map

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

package/dist/spiral/cloud/search-provider.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Web Search Provider — Searches the internet for relevant knowledge.
+ *
+ * Uses DuckDuckGo Lite HTML search (no API key required).
+ * Falls back gracefully if no internet connection.
+ */
+export interface SearchResult {
+    title: string;
+    url: string;
+    snippet: string;
+}
+/**
+ * Search the web using DuckDuckGo Lite.
+ * Returns up to `maxResults` results.
+ */
+export declare function webSearch(query: string, maxResults?: number, signal?: AbortSignal): Promise<SearchResult[]>;
+/**
+ * Fetch the text content of a web page.
+ * Returns extracted text, limited to maxLength characters.
+ */
+export declare function fetchPageContent(url: string, maxLength?: number, signal?: AbortSignal, _redirectDepth?: number): Promise<string | null>;
+//# sourceMappingURL=search-provider.d.ts.map

package/dist/spiral/cloud/search-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-provider.d.ts","sourceRoot":"","sources":["../../../src/spiral/cloud/search-provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,MAAM,EACb,UAAU,GAAE,MAAU,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,EAAE,CAAC,CA4BzB;AAmED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,SAAS,GAAE,MAAa,EACxB,MAAM,CAAC,EAAE,WAAW,EACpB,cAAc,GAAE,MAAU,GACzB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA+DxB"}