getmosaic 0.1.0

package/README.md

@@ -0,0 +1,62 @@
+# Mosaic
+
+Mosaic is an opinionated intelligence agent that reads your team's internal streams — Slack, email, docs, CRM — scans market trends, and delivers sharp insights to drive product decisions and strategy.
+
+## Install
+
+```sh
+curl -fsSL https://raw.githubusercontent.com/agg111/mosaic/main/install.sh | sh
+```
+
+That's it. The installer sets up everything and walks you through connecting your sources.
+
+## Start
+
+```sh
+mosaic start
+```
+
+## Connect your sources
+
+Sign up at [hyperspell.com](https://hyperspell.com) and connect your team's tools:
+
+- Slack
+- Gmail
+- Notion / Google Drive
+- HubSpot / Salesforce (coming soon)
+
+Mosaic searches across all of them automatically.
+
+## What Mosaic can do
+
+| Ask Mosaic... | It will... |
+|---|---|
+| Generate a market report on X | Search internal knowledge + web, synthesize, save insights |
+| What do we know about our churn? | Search across Slack, email, docs |
+| Research our competitors | Pull live web data + internal context |
+| Remember that X is happening | Save it to memory for future reports |
+
+## Commands
+
+```sh
+mosaic start     # Start Mosaic
+mosaic stop      # Stop Mosaic
+mosaic status    # Show connected channels
+mosaic setup     # Re-run setup wizard
+```
+
+## Adding new capabilities
+
+To add a new tool:
+
+1. Create `src/tools/your-tool.ts`
+2. Add it to `src/tools/registry.ts`
+3. Rebuild: `npm run build`
+
+No other changes needed.
+
+## Requirements
+
+- Node.js 20+
+- [Hyperspell](https://hyperspell.com) account
+- [Anthropic](https://console.anthropic.com) API key

package/bin/mosaic.sh

@@ -0,0 +1,38 @@
+#!/bin/sh
+# Mosaic CLI wrapper
+
+COMMAND="${1:-help}"
+
+case "$COMMAND" in
+  start)
+    echo "Starting Mosaic..."
+    openclaw gateway run
+    ;;
+  stop)
+    openclaw gateway stop 2>/dev/null || pkill -f "openclaw gateway" 2>/dev/null || true
+    echo "Mosaic stopped."
+    ;;
+  status)
+    openclaw channels status
+    ;;
+  setup)
+    sh "$(dirname "$0")/../install.sh"
+    ;;
+  plugins)
+    openclaw plugins list
+    ;;
+  *)
+    echo ""
+    echo "  Mosaic — market intelligence for your team"
+    echo ""
+    echo "  Usage: mosaic <command>"
+    echo ""
+    echo "  Commands:"
+    echo "    start     Start Mosaic"
+    echo "    stop      Stop Mosaic"
+    echo "    status    Show connected channels and status"
+    echo "    setup     Re-run setup wizard"
+    echo "    plugins   List installed plugins"
+    echo ""
+    ;;
+esac

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+type OpenClawPluginApi = {
+    registerTool: (tool: unknown) => void;
+};
+declare const plugin: {
+    id: string;
+    name: string;
+    description: string;
+    register(api: OpenClawPluginApi, configValues?: Record<string, string>): void;
+};
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAGA,KAAK,iBAAiB,GAAG;IACvB,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACvC,CAAC;AAEF,QAAA,MAAM,MAAM;;;;kBAMI,iBAAiB,iBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAgBtE,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+import { MOSAIC_TOOLS } from "./src/tools/registry.js";
+import { setConfig } from "./src/config.js";
+const plugin = {
+    id: "mosaic",
+    name: "Mosaic",
+    description: "Market intelligence agent — distills signals from internal knowledge and the web into strategic reports",
+    register(api, configValues = {}) {
+        setConfig({
+            hyperspellApiKey: configValues.hyperspellApiKey ?? process.env.HYPERSPELL_API_KEY ?? "",
+            hyperspellUserId: configValues.hyperspellUserId ?? process.env.HYPERSPELL_USER_ID ?? "",
+            tavilyApiKey: configValues.tavilyApiKey ?? process.env.TAVILY_API_KEY,
+            anthropicApiKey: configValues.anthropicApiKey ?? process.env.ANTHROPIC_API_KEY,
+        });
+        for (const tool of MOSAIC_TOOLS) {
+            api.registerTool(tool);
+        }
+    },
+};
+export default plugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAM5C,MAAM,MAAM,GAAG;IACb,EAAE,EAAE,QAAQ;IACZ,IAAI,EAAE,QAAQ;IACd,WAAW,EACT,yGAAyG;IAE3G,QAAQ,CAAC,GAAsB,EAAE,eAAuC,EAAE;QACxE,SAAS,CAAC;YACR,gBAAgB,EACd,YAAY,CAAC,gBAAgB,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE;YACvE,gBAAgB,EACd,YAAY,CAAC,gBAAgB,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE;YACvE,YAAY,EACV,YAAY,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc;YACzD,eAAe,EACb,YAAY,CAAC,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB;SAChE,CAAC,CAAC;QAEH,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;YAChC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;CACF,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/src/config.d.ts

@@ -0,0 +1,9 @@
+export interface MosaicConfig {
+    hyperspellApiKey: string;
+    hyperspellUserId: string;
+    tavilyApiKey?: string;
+    anthropicApiKey?: string;
+}
+export declare function setConfig(config: MosaicConfig): void;
+export declare function getConfig(): MosaicConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/src/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAID,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAEpD;AAED,wBAAgB,SAAS,IAAI,YAAY,CAKxC"}

package/dist/src/config.js

@@ -0,0 +1,11 @@
+let _config = null;
+export function setConfig(config) {
+    _config = config;
+}
+export function getConfig() {
+    if (!_config) {
+        throw new Error("Mosaic: plugin not initialized. Ensure it is registered via OpenClaw.");
+    }
+    return _config;
+}
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAOA,IAAI,OAAO,GAAwB,IAAI,CAAC;AAExC,MAAM,UAAU,SAAS,CAAC,MAAoB;IAC5C,OAAO,GAAG,MAAM,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/src/hyperspell.d.ts

@@ -0,0 +1,3 @@
+import Hyperspell from "hyperspell";
+export declare function getClient(): Hyperspell;
+//# sourceMappingURL=hyperspell.d.ts.map

package/dist/src/hyperspell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperspell.d.ts","sourceRoot":"","sources":["../../src/hyperspell.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,YAAY,CAAC;AAGpC,wBAAgB,SAAS,IAAI,UAAU,CAGtC"}

package/dist/src/hyperspell.js

@@ -0,0 +1,7 @@
+import Hyperspell from "hyperspell";
+import { getConfig } from "./config.js";
+export function getClient() {
+    const { hyperspellApiKey, hyperspellUserId } = getConfig();
+    return new Hyperspell({ apiKey: hyperspellApiKey, userID: hyperspellUserId });
+}
+//# sourceMappingURL=hyperspell.js.map

package/dist/src/hyperspell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperspell.js","sourceRoot":"","sources":["../../src/hyperspell.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,UAAU,SAAS;IACvB,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,GAAG,SAAS,EAAE,CAAC;IAC3D,OAAO,IAAI,UAAU,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;AAChF,CAAC"}

package/dist/src/tools/generate-report.d.ts

@@ -0,0 +1,15 @@
+export declare const generateReportTool: {
+    name: string;
+    label: string;
+    description: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        topic: import("@sinclair/typebox").TString;
+    }>;
+    execute(_id: string, params: unknown): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+//# sourceMappingURL=generate-report.d.ts.map

package/dist/src/tools/generate-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-report.d.ts","sourceRoot":"","sources":["../../../src/tools/generate-report.ts"],"names":[],"mappings":"AA0DA,eAAO,MAAM,kBAAkB;;;;;;;iBAQV,MAAM,UAAU,OAAO;;;;;;CA2D3C,CAAC"}

package/dist/src/tools/generate-report.js

@@ -0,0 +1,115 @@
+import { Type } from "@sinclair/typebox";
+import Anthropic from "@anthropic-ai/sdk";
+import { getConfig } from "../config.js";
+import { searchMemoriesTool } from "./search-memories.js";
+import { webSearchTool } from "./web-search.js";
+import { rememberInsightTool } from "./remember-insight.js";
+const SYSTEM_PROMPT = `You are Mosaic, an opinionated market intelligence agent. Your job is to cut through noise and deliver sharp strategic insight by combining your team's internal knowledge with current market signals.
+
+When generating a report, always:
+- Run 2-3 targeted mosaic_search_memories queries to surface internal context
+- Run 2-3 mosaic_web_search queries to capture market trends and competitor moves
+- Save 2-3 key non-obvious insights with mosaic_remember_insight so future reports are smarter
+- Synthesize both into a structured, opinionated report
+
+Output in this exact format:
+
+# Market Report: [Topic]
+_Generated by Mosaic_
+
+## Executive Summary
+2-3 sentences capturing the single most important insight.
+
+## Market Trends
+Current dynamics, growth signals, and emerging patterns from the web.
+
+## Internal Context
+What the team already knows — signals from Slack, emails, docs.
+
+## Competitive Landscape
+Key players, recent moves, differentiation opportunities.
+
+## Recommendations
+3 concrete, actionable next steps.
+
+---
+_Sources: [list sources used]_
+
+Be specific, not generic. Surface the non-obvious. Skip filler. Do not add disclaimers about missing data.`;
+// Internal tools used by the report generation loop
+const INTERNAL_TOOLS = [searchMemoriesTool, webSearchTool, rememberInsightTool];
+const ANTHROPIC_TOOL_DEFS = INTERNAL_TOOLS.map((t) => ({
+    name: t.name,
+    description: t.description,
+    input_schema: {
+        type: "object",
+        properties: Object.fromEntries(Object.entries(t.parameters.properties ?? {}).map(([k, v]) => [
+            k,
+            { type: v.type, description: v.description },
+        ])),
+        required: Object.keys(t.parameters.properties ?? {}),
+    },
+}));
+export const generateReportTool = {
+    name: "mosaic_generate_report",
+    label: "Generate Market Report",
+    description: "Generate a full market intelligence report on a topic. Searches internal knowledge and the web, synthesizes findings, and saves key insights back to memory.",
+    parameters: Type.Object({
+        topic: Type.String({ description: "The topic, market, or product area to report on." }),
+    }),
+    async execute(_id, params) {
+        const { topic } = params;
+        const config = getConfig();
+        const apiKey = config.anthropicApiKey ?? process.env.ANTHROPIC_API_KEY;
+        if (!apiKey) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Anthropic API key not configured. Set it in plugin config or ANTHROPIC_API_KEY env var.",
+                    },
+                ],
+            };
+        }
+        const anthropic = new Anthropic({ apiKey });
+        const messages = [
+            { role: "user", content: `Generate a market report on: ${topic}` },
+        ];
+        try {
+            while (true) {
+                const response = await anthropic.messages.create({
+                    model: "claude-opus-4-6",
+                    max_tokens: 4096,
+                    system: SYSTEM_PROMPT,
+                    tools: ANTHROPIC_TOOL_DEFS,
+                    messages,
+                });
+                if (response.stop_reason === "end_turn") {
+                    const textBlock = response.content.find((b) => b.type === "text");
+                    const text = textBlock ? textBlock.text : "No report generated.";
+                    return { content: [{ type: "text", text }] };
+                }
+                messages.push({ role: "assistant", content: response.content });
+                const toolResults = [];
+                for (const block of response.content) {
+                    if (block.type !== "tool_use")
+                        continue;
+                    const tool = INTERNAL_TOOLS.find((t) => t.name === block.name);
+                    let resultText = "Tool not found.";
+                    if (tool) {
+                        const res = await tool.execute(block.id, block.input);
+                        resultText = res.content[0]?.text ?? "";
+                    }
+                    toolResults.push({ type: "tool_result", tool_use_id: block.id, content: resultText });
+                }
+                messages.push({ role: "user", content: toolResults });
+            }
+        }
+        catch (e) {
+            return {
+                content: [{ type: "text", text: `Report generation failed: ${e.message}` }],
+            };
+        }
+    },
+};
+//# sourceMappingURL=generate-report.js.map

package/dist/src/tools/generate-report.js.map

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

package/dist/src/tools/registry.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Tool registry — add new tools here and they are automatically registered with OpenClaw.
+ *
+ * To add a tool:
+ *   1. Create src/tools/your-tool.ts following the existing pattern
+ *   2. Import it below and add to MOSAIC_TOOLS
+ */
+export declare const MOSAIC_TOOLS: ({
+    name: string;
+    label: string;
+    description: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        query: import("@sinclair/typebox").TString;
+    }>;
+    execute(_id: string, params: unknown): Promise<{
+        content: {
+            type: "text";
+            text: any;
+        }[];
+    }>;
+} | {
+    name: string;
+    label: string;
+    description: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        text: import("@sinclair/typebox").TString;
+    }>;
+    execute(_id: string, params: unknown): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+} | {
+    name: string;
+    label: string;
+    description: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        topic: import("@sinclair/typebox").TString;
+    }>;
+    execute(_id: string, params: unknown): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+})[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/src/tools/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/tools/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUxB,CAAC"}

package/dist/src/tools/registry.js

@@ -0,0 +1,21 @@
+/**
+ * Tool registry — add new tools here and they are automatically registered with OpenClaw.
+ *
+ * To add a tool:
+ *   1. Create src/tools/your-tool.ts following the existing pattern
+ *   2. Import it below and add to MOSAIC_TOOLS
+ */
+import { searchMemoriesTool } from "./search-memories.js";
+import { webSearchTool } from "./web-search.js";
+import { rememberInsightTool } from "./remember-insight.js";
+import { generateReportTool } from "./generate-report.js";
+export const MOSAIC_TOOLS = [
+    // Memory & knowledge
+    searchMemoriesTool,
+    rememberInsightTool,
+    // Web research
+    webSearchTool,
+    // Orchestrated workflows
+    generateReportTool,
+];
+//# sourceMappingURL=registry.js.map

package/dist/src/tools/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/tools/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,qBAAqB;IACrB,kBAAkB;IAClB,mBAAmB;IAEnB,eAAe;IACf,aAAa;IAEb,yBAAyB;IACzB,kBAAkB;CACnB,CAAC"}

package/dist/src/tools/remember-insight.d.ts

@@ -0,0 +1,15 @@
+export declare const rememberInsightTool: {
+    name: string;
+    label: string;
+    description: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        text: import("@sinclair/typebox").TString;
+    }>;
+    execute(_id: string, params: unknown): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+//# sourceMappingURL=remember-insight.d.ts.map

package/dist/src/tools/remember-insight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remember-insight.d.ts","sourceRoot":"","sources":["../../../src/tools/remember-insight.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,mBAAmB;;;;;;;iBAWX,MAAM,UAAU,OAAO;;;;;;CAY3C,CAAC"}

package/dist/src/tools/remember-insight.js

@@ -0,0 +1,27 @@
+import { Type } from "@sinclair/typebox";
+import { getClient } from "../hyperspell.js";
+export const rememberInsightTool = {
+    name: "mosaic_remember_insight",
+    label: "Remember Insight",
+    description: "Save a key insight or finding to memory so future reports can reference it. " +
+        "Use when you discover something non-obvious — a competitor move, pricing signal, customer pattern, or market trend.",
+    parameters: Type.Object({
+        text: Type.String({
+            description: "The insight to save, written as a clear self-contained fact.",
+        }),
+    }),
+    async execute(_id, params) {
+        const { text } = params;
+        try {
+            const client = getClient();
+            await client.memories.add({ text, metadata: { source: "mosaic" } });
+            return { content: [{ type: "text", text: "Insight saved." }] };
+        }
+        catch (e) {
+            return {
+                content: [{ type: "text", text: `Failed to save insight: ${e.message}` }],
+            };
+        }
+    },
+};
+//# sourceMappingURL=remember-insight.js.map

package/dist/src/tools/remember-insight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remember-insight.js","sourceRoot":"","sources":["../../../src/tools/remember-insight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,yBAAyB;IAC/B,KAAK,EAAE,kBAAkB;IACzB,WAAW,EACT,8EAA8E;QAC9E,qHAAqH;IACvH,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;QACtB,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;YAChB,WAAW,EAAE,8DAA8D;SAC5E,CAAC;KACH,CAAC;IACF,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,MAAe;QACxC,MAAM,EAAE,IAAI,EAAE,GAAG,MAA0B,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;YAC3B,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;YACpE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,EAAE,CAAC;QAC1E,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,2BAA2B,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;aACnF,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/src/tools/search-memories.d.ts

@@ -0,0 +1,15 @@
+export declare const searchMemoriesTool: {
+    name: string;
+    label: string;
+    description: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        query: import("@sinclair/typebox").TString;
+    }>;
+    execute(_id: string, params: unknown): Promise<{
+        content: {
+            type: "text";
+            text: any;
+        }[];
+    }>;
+};
+//# sourceMappingURL=search-memories.d.ts.map

package/dist/src/tools/search-memories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-memories.d.ts","sourceRoot":"","sources":["../../../src/tools/search-memories.ts"],"names":[],"mappings":"AAyBA,eAAO,MAAM,kBAAkB;;;;;;;iBASV,MAAM,UAAU,OAAO;;;;;;CA8C3C,CAAC"}

package/dist/src/tools/search-memories.js

@@ -0,0 +1,74 @@
+import { Type } from "@sinclair/typebox";
+import { getClient } from "../hyperspell.js";
+async function fetchAllWithContent(client) {
+    const items = [];
+    let cursor;
+    do {
+        const r = await client.memories.list({ limit: 100, cursor });
+        const page = r.body?.items ?? r.items ?? [];
+        for (const item of page) {
+            try {
+                const full = await client.memories.get(item.resource_id, { source: item.source });
+                const text = (full.data ?? []).map((d) => d.text ?? "").join("\n").trim();
+                const memory = (full.memories ?? []).join(" ").trim();
+                items.push({ source: item.source, title: item.title, text: text || memory });
+            }
+            catch {
+                items.push({ source: item.source, title: item.title, text: "" });
+            }
+        }
+        cursor = r.body?.next_cursor ?? r.next_cursor;
+        if (!cursor || page.length === 0)
+            break;
+    } while (true);
+    return items;
+}
+export const searchMemoriesTool = {
+    name: "mosaic_search_memories",
+    label: "Search Internal Knowledge",
+    description: "Search your team's connected sources (Slack, Gmail, Notion, Drive) for internal context. " +
+        "Use to find what the team already knows — past discussions, decisions, emails, docs.",
+    parameters: Type.Object({
+        query: Type.String({ description: "Search query for internal knowledge" }),
+    }),
+    async execute(_id, params) {
+        const { query } = params;
+        try {
+            const client = getClient();
+            // Try semantic search first
+            const result = await client.memories.search({ query, answer: false });
+            const documents = result.documents ?? result.results ?? [];
+            if (documents.length > 0) {
+                const text = documents
+                    .map((m) => {
+                    const src = m.source ?? "unknown";
+                    const title = m.title ? `${m.title}\n` : "";
+                    const snippet = (m.text ?? m.content ?? "").slice(0, 400);
+                    return `[${src}] ${title}${snippet}`;
+                })
+                    .join("\n\n---\n\n");
+                return { content: [{ type: "text", text }] };
+            }
+            // Fallback: fetch all memories and do keyword match
+            console.log(`[mosaic] search API returned 0 results for "${query}", falling back to full fetch`);
+            const allItems = await fetchAllWithContent(client);
+            if (allItems.length === 0) {
+                return { content: [{ type: "text", text: "No internal sources connected yet." }] };
+            }
+            const q = query.toLowerCase();
+            const matched = allItems.filter((m) => m.title?.toLowerCase().includes(q) || m.text?.toLowerCase().includes(q));
+            const results = matched.length > 0 ? matched : allItems; // if no keyword match, return all
+            const text = results
+                .map((m) => {
+                const snippet = (m.text ?? "").slice(0, 600);
+                return `[${m.source}] ${m.title}\n${snippet}`;
+            })
+                .join("\n\n---\n\n");
+            return { content: [{ type: "text", text }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: `Memory search failed: ${e.message}` }] };
+        }
+    },
+};
+//# sourceMappingURL=search-memories.js.map

package/dist/src/tools/search-memories.js.map

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

package/dist/src/tools/web-search.d.ts

@@ -0,0 +1,15 @@
+export declare const webSearchTool: {
+    name: string;
+    label: string;
+    description: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        query: import("@sinclair/typebox").TString;
+    }>;
+    execute(_id: string, params: unknown): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+//# sourceMappingURL=web-search.d.ts.map

package/dist/src/tools/web-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.d.ts","sourceRoot":"","sources":["../../../src/tools/web-search.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,aAAa;;;;;;;iBAQL,MAAM,UAAU,OAAO;;;;;;CAqC3C,CAAC"}

package/dist/src/tools/web-search.js

@@ -0,0 +1,48 @@
+import { Type } from "@sinclair/typebox";
+import { getConfig } from "../config.js";
+export const webSearchTool = {
+    name: "mosaic_web_search",
+    label: "Web Search",
+    description: "Search the web for current market trends, competitor news, industry data, and recent developments.",
+    parameters: Type.Object({
+        query: Type.String({ description: "Web search query for market trends and news" }),
+    }),
+    async execute(_id, params) {
+        const { query } = params;
+        const { tavilyApiKey } = getConfig();
+        if (!tavilyApiKey) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Web search is not configured. Add a Tavily API key to enable it.",
+                    },
+                ],
+            };
+        }
+        try {
+            const res = await fetch("https://api.tavily.com/search", {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    api_key: tavilyApiKey,
+                    query,
+                    max_results: 5,
+                    include_answer: true,
+                }),
+            });
+            const data = (await res.json());
+            const lines = [];
+            if (data.answer)
+                lines.push(`${data.answer}\n`);
+            for (const r of data.results ?? []) {
+                lines.push(`• ${r.title}\n  ${r.url}\n  ${(r.content ?? "").slice(0, 250)}`);
+            }
+            return { content: [{ type: "text", text: lines.join("\n\n") || "No results." }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: `Web search failed: ${e.message}` }] };
+        }
+    },
+};
+//# sourceMappingURL=web-search.js.map

package/dist/src/tools/web-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.js","sourceRoot":"","sources":["../../../src/tools/web-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,mBAAmB;IACzB,KAAK,EAAE,YAAY;IACnB,WAAW,EACT,oGAAoG;IACtG,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;QACtB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,6CAA6C,EAAE,CAAC;KACnF,CAAC;IACF,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,MAAe;QACxC,MAAM,EAAE,KAAK,EAAE,GAAG,MAA2B,CAAC;QAC9C,MAAM,EAAE,YAAY,EAAE,GAAG,SAAS,EAAE,CAAC;QAErC,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,kEAAkE;qBACzE;iBACF;aACF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,+BAA+B,EAAE;gBACvD,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,OAAO,EAAE,YAAY;oBACrB,KAAK;oBACL,WAAW,EAAE,CAAC;oBACd,cAAc,EAAE,IAAI;iBACrB,CAAC;aACH,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAQ,CAAC;YACvC,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;YAChD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;gBACnC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YAC/E,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC,EAAE,CAAC;QAC7F,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,sBAAsB,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC;QAC3F,CAAC;IACH,CAAC;CACF,CAAC"}

package/install.sh

@@ -0,0 +1,196 @@
+#!/bin/sh
+set -e
+
+# Colors
+BOLD='\033[1m'
+GREEN='\033[0;32m'
+YELLOW='\033[0;33m'
+RED='\033[0;31m'
+DIM='\033[2m'
+NC='\033[0m'
+
+print()   { printf "${BOLD}%s${NC}\n" "$1"; }
+success() { printf "${GREEN}✓${NC} %s\n" "$1"; }
+warn()    { printf "${YELLOW}!${NC} %s\n" "$1"; }
+err()     { printf "${RED}✗${NC} %s\n" "$1"; exit 1; }
+dim()     { printf "${DIM}%s${NC}\n" "$1"; }
+skip()    { printf "${DIM}– %s (already set up)${NC}\n" "$1"; }
+
+echo ""
+echo "  ╔════════════════════════════════════════╗"
+echo "  ║              Mosaic                    ║"
+echo "  ║   Market intelligence for your team    ║"
+echo "  ╚════════════════════════════════════════╝"
+echo ""
+
+# ── 1. Check Node.js ──────────────────────────────────────────────────────────
+
+if ! command -v node >/dev/null 2>&1; then
+  err "Node.js is required. Install it from https://nodejs.org (v20+) and re-run."
+fi
+
+NODE_MAJOR=$(node -e "console.log(process.versions.node.split('.')[0])")
+if [ "$NODE_MAJOR" -lt 20 ]; then
+  err "Node.js v20+ required. Found: $(node --version). Upgrade at https://nodejs.org"
+fi
+
+success "Node.js $(node --version)"
+
+# ── 2. Install OpenClaw ───────────────────────────────────────────────────────
+
+if command -v openclaw >/dev/null 2>&1; then
+  skip "OpenClaw"
+else
+  print "\nInstalling OpenClaw..."
+  npm install -g openclaw --silent 2>/dev/null || npm install -g openclaw --ignore-scripts --silent
+  success "OpenClaw installed"
+fi
+
+# ── 3. Install Mosaic ─────────────────────────────────────────────────────────
+
+if command -v mosaic >/dev/null 2>&1 && openclaw plugins list 2>/dev/null | grep -q "mosaic"; then
+  skip "Mosaic"
+else
+  print "\nInstalling Mosaic..."
+  npm install -g mosaic --silent 2>/dev/null || npm install -g mosaic --ignore-scripts --silent
+  PLUGIN_PATH="$(npm root -g)/mosaic"
+  openclaw plugins install "$PLUGIN_PATH" 2>/dev/null || true
+  success "Mosaic installed"
+fi
+
+# ── 4. API Keys ───────────────────────────────────────────────────────────────
+
+ENV_FILE="$HOME/.openclaw/.env"
+mkdir -p "$HOME/.openclaw"
+
+if [ -f "$ENV_FILE" ] && grep -q "HYPERSPELL_API_KEY" "$ENV_FILE"; then
+  skip "API keys"
+else
+  echo ""
+  print "Connect your sources"
+  echo ""
+  dim "  Hyperspell connects your Slack, Notion, Gmail, and Drive."
+  dim "  Sign up free at https://hyperspell.com, then grab your API key."
+  echo ""
+
+  printf "  Hyperspell API Key: "
+  read -r HYPERSPELL_API_KEY
+  [ -z "$HYPERSPELL_API_KEY" ] && err "Hyperspell API key is required."
+
+  printf "  Hyperspell User ID: "
+  read -r HYPERSPELL_USER_ID
+  [ -z "$HYPERSPELL_USER_ID" ] && err "Hyperspell User ID is required."
+
+  echo ""
+  dim "  Anthropic API key — https://console.anthropic.com"
+  echo ""
+  printf "  Anthropic API Key: "
+  read -r ANTHROPIC_API_KEY
+  [ -z "$ANTHROPIC_API_KEY" ] && err "Anthropic API key is required."
+
+  echo ""
+  dim "  (Optional) Tavily for web search — https://tavily.com"
+  echo ""
+  printf "  Tavily API Key (enter to skip): "
+  read -r TAVILY_API_KEY
+
+  cat > "$ENV_FILE" << EOF
+HYPERSPELL_API_KEY=$HYPERSPELL_API_KEY
+HYPERSPELL_USER_ID=$HYPERSPELL_USER_ID
+ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY
+EOF
+  [ -n "$TAVILY_API_KEY" ] && echo "TAVILY_API_KEY=$TAVILY_API_KEY" >> "$ENV_FILE"
+  success "API keys saved"
+fi
+
+# ── 5. Slack ──────────────────────────────────────────────────────────────────
+
+if [ -f "$ENV_FILE" ] && grep -q "SLACK_BOT_TOKEN" "$ENV_FILE"; then
+  skip "Slack"
+else
+  echo ""
+  print "Connect Slack"
+  echo ""
+  dim "  Create a Slack app at https://api.slack.com/apps"
+  dim "  Need: Bot Token (xoxb-...) and App-Level Token (xapp-...)"
+  dim "  See setup guide: https://github.com/agg111/mosaic#slack-setup"
+  echo ""
+
+  printf "  Slack Bot Token (xoxb-...): "
+  read -r SLACK_BOT_TOKEN
+  [ -z "$SLACK_BOT_TOKEN" ] && err "Slack bot token is required."
+
+  printf "  Slack App Token (xapp-...): "
+  read -r SLACK_APP_TOKEN
+  [ -z "$SLACK_APP_TOKEN" ] && err "Slack app token is required."
+
+  cat >> "$ENV_FILE" << EOF
+SLACK_BOT_TOKEN=$SLACK_BOT_TOKEN
+SLACK_APP_TOKEN=$SLACK_APP_TOKEN
+EOF
+  success "Slack tokens saved"
+fi
+
+# ── 6. Write openclaw.json ────────────────────────────────────────────────────
+
+CONFIG_FILE="$HOME/.openclaw/openclaw.json"
+if [ -f "$CONFIG_FILE" ]; then
+  skip "OpenClaw config"
+else
+  cat > "$CONFIG_FILE" << 'EOF'
+{
+  "channels": {
+    "slack": {
+      "mode": "socket",
+      "enabled": true,
+      "botToken": "${SLACK_BOT_TOKEN}",
+      "appToken": "${SLACK_APP_TOKEN}",
+      "groupPolicy": "open",
+      "dmPolicy": "open",
+      "allowFrom": ["*"],
+      "nativeStreaming": true,
+      "streaming": "partial"
+    }
+  },
+  "plugins": {
+    "allow": ["mosaic"],
+    "entries": {
+      "mosaic": {
+        "enabled": true,
+        "config": {
+          "hyperspellApiKey": "${HYPERSPELL_API_KEY}",
+          "hyperspellUserId": "${HYPERSPELL_USER_ID}",
+          "anthropicApiKey": "${ANTHROPIC_API_KEY}",
+          "tavilyApiKey": "${TAVILY_API_KEY}"
+        }
+      }
+    }
+  },
+  "gateway": {
+    "mode": "local"
+  }
+}
+EOF
+  success "OpenClaw config written"
+fi
+
+openclaw config set gateway.mode local >/dev/null 2>&1 || true
+
+# ── 7. Done ───────────────────────────────────────────────────────────────────
+
+echo ""
+echo "  ╔════════════════════════════════════════╗"
+echo "  ║          Mosaic is ready!              ║"
+echo "  ╚════════════════════════════════════════╝"
+echo ""
+echo "  Next steps:"
+echo ""
+echo "  1. Connect your sources at https://hyperspell.com"
+echo "     (Slack, Notion, Gmail, Google Drive)"
+echo ""
+echo "  2. Start Mosaic:"
+echo ""
+echo "     mosaic start"
+echo ""
+echo "  Then @mention Mosaic in any Slack channel."
+echo ""

package/openclaw.plugin.json

@@ -0,0 +1,50 @@
+{
+  "id": "mosaic",
+  "name": "Mosaic",
+  "description": "Market intelligence agent — search internal knowledge and the web to generate strategy reports",
+  "version": "0.1.0",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "hyperspellApiKey": {
+        "type": "string",
+        "description": "Hyperspell API key for memory search"
+      },
+      "hyperspellUserId": {
+        "type": "string",
+        "description": "Your Hyperspell user ID"
+      },
+      "tavilyApiKey": {
+        "type": "string",
+        "description": "Tavily API key for web search (optional — disables web search if omitted)"
+      },
+      "anthropicApiKey": {
+        "type": "string",
+        "description": "Anthropic API key for report generation (falls back to ANTHROPIC_API_KEY env var)"
+      }
+    },
+    "required": ["hyperspellApiKey", "hyperspellUserId"]
+  },
+  "uiHints": {
+    "hyperspellApiKey": {
+      "label": "Hyperspell API Key",
+      "sensitive": true,
+      "placeholder": "hs-..."
+    },
+    "hyperspellUserId": {
+      "label": "Hyperspell User ID",
+      "placeholder": "your-username"
+    },
+    "tavilyApiKey": {
+      "label": "Tavily API Key (web search)",
+      "sensitive": true,
+      "placeholder": "tvly-..."
+    },
+    "anthropicApiKey": {
+      "label": "Anthropic API Key",
+      "sensitive": true,
+      "placeholder": "sk-ant-..."
+    }
+  }
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "getmosaic",
+  "version": "0.1.0",
+  "description": "Market intelligence agent — distills signals from your team and the market into strategic clarity",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "bin": {
+    "mosaic": "./bin/mosaic.sh"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "install.sh",
+    "openclaw.plugin.json",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepare": "tsc"
+  },
+  "openclaw": {
+    "extensions": ["./dist/index.js"]
+  },
+  "keywords": ["openclaw", "plugin", "market-intelligence", "hyperspell", "ai-agent"],
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.80.0",
+    "@sinclair/typebox": "^0.34.0",
+    "hyperspell": "^0.35.0"
+  },
+  "peerDependencies": {
+    "openclaw": "*"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.0"
+  }
+}