wispy-ai 0.1.0

package/dist/integrations/google/youtube.js

@@ -0,0 +1,128 @@
+/**
+ * YouTube Integration
+ *
+ * Provides tools for searching videos, fetching video details, and
+ * retrieving channel information via the YouTube Data API v3.
+ *
+ * @see https://developers.google.com/youtube/v3/docs
+ */
+import { Integration } from "../base.js";
+const BASE = "https://www.googleapis.com/youtube/v3";
+export default class GoogleYouTubeIntegration extends Integration {
+    manifest = {
+        id: "google-youtube",
+        name: "YouTube",
+        category: "google",
+        version: "1.0.0",
+        description: "Search videos, get video details, and browse channels on YouTube.",
+        auth: { type: "api-key" },
+        tools: [
+            {
+                name: "google_youtube_search",
+                description: "Search for YouTube videos.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        query: { type: "string", description: "Search query." },
+                        maxResults: { type: "number", description: "Max results (default: 5, max: 50)." },
+                    },
+                    required: ["query"],
+                },
+            },
+            {
+                name: "google_youtube_video",
+                description: "Get detailed information about a YouTube video.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        videoId: { type: "string", description: "The YouTube video ID." },
+                    },
+                    required: ["videoId"],
+                },
+            },
+            {
+                name: "google_youtube_channel",
+                description: "Get information about a YouTube channel.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        channelId: { type: "string", description: "The YouTube channel ID." },
+                    },
+                    required: ["channelId"],
+                },
+            },
+        ],
+    };
+    /** Retrieve the YouTube / Google API key from environment variables. */
+    getApiKey() {
+        const key = process.env.GOOGLE_YOUTUBE_API_KEY || process.env.GOOGLE_API_KEY;
+        if (!key) {
+            throw new Error("GOOGLE_YOUTUBE_API_KEY or GOOGLE_API_KEY environment variable must be set.");
+        }
+        return key;
+    }
+    async executeTool(toolName, args) {
+        switch (toolName) {
+            case "google_youtube_search":
+                return this.search(args);
+            case "google_youtube_video":
+                return this.video(args);
+            case "google_youtube_channel":
+                return this.channel(args);
+            default:
+                return this.error(`Unknown tool: ${toolName}`);
+        }
+    }
+    async search(args) {
+        const maxResults = Math.min(Math.max(Number(args.maxResults ?? 5), 1), 50);
+        const params = new URLSearchParams({
+            key: this.getApiKey(),
+            part: "snippet",
+            type: "video",
+            q: args.query,
+            maxResults: String(maxResults),
+        });
+        const res = await fetch(`${BASE}/search?${params}`);
+        const data = await res.json();
+        const results = (data.items ?? []).map((item) => {
+            const snippet = item.snippet;
+            const id = item.id;
+            return {
+                videoId: id?.videoId,
+                title: snippet?.title,
+                description: snippet?.description,
+                channelTitle: snippet?.channelTitle,
+                publishedAt: snippet?.publishedAt,
+                thumbnail: snippet?.thumbnails?.high,
+            };
+        });
+        return this.ok(JSON.stringify(results, null, 2));
+    }
+    async video(args) {
+        const params = new URLSearchParams({
+            key: this.getApiKey(),
+            part: "snippet,contentDetails,statistics",
+            id: args.videoId,
+        });
+        const res = await fetch(`${BASE}/videos?${params}`);
+        const data = await res.json();
+        if (!data.items?.length) {
+            return this.error(`Video not found: ${args.videoId}`);
+        }
+        return this.ok(JSON.stringify(data.items[0], null, 2));
+    }
+    async channel(args) {
+        const params = new URLSearchParams({
+            key: this.getApiKey(),
+            part: "snippet,statistics,brandingSettings",
+            id: args.channelId,
+        });
+        const res = await fetch(`${BASE}/channels?${params}`);
+        const data = await res.json();
+        if (!data.items?.length) {
+            return this.error(`Channel not found: ${args.channelId}`);
+        }
+        return this.ok(JSON.stringify(data.items[0], null, 2));
+    }
+}
+//# sourceMappingURL=youtube.js.map

package/dist/integrations/google/youtube.js.map

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

package/dist/integrations/loader.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Integration loader — discovers and registers all integrations.
+ *
+ * Scans the integrations directory for modules that export a default class
+ * extending Integration. Auto-enables integrations listed in config.
+ */
+import type { IntegrationContext } from "./base.js";
+import { IntegrationRegistry } from "./registry.js";
+/**
+ * Load all built-in integrations and register them.
+ * This function imports each integration module directly (no filesystem scan)
+ * for reliability across platforms and bundlers.
+ */
+export declare function loadIntegrations(ctx: IntegrationContext, enabledIds?: string[]): Promise<IntegrationRegistry>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/integrations/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/integrations/loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAe,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAKpD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,kBAAkB,EACvB,UAAU,GAAE,MAAM,EAAO,GACxB,OAAO,CAAC,mBAAmB,CAAC,CA+B9B"}

package/dist/integrations/loader.js

@@ -0,0 +1,97 @@
+/**
+ * Integration loader — discovers and registers all integrations.
+ *
+ * Scans the integrations directory for modules that export a default class
+ * extending Integration. Auto-enables integrations listed in config.
+ */
+import { IntegrationRegistry } from "./registry.js";
+import { createLogger } from "../infra/logger.js";
+const log = createLogger("integrations");
+/**
+ * Load all built-in integrations and register them.
+ * This function imports each integration module directly (no filesystem scan)
+ * for reliability across platforms and bundlers.
+ */
+export async function loadIntegrations(ctx, enabledIds = []) {
+    const registry = new IntegrationRegistry(ctx.credentialManager);
+    // Import all integration modules
+    const modules = await importAllIntegrations(ctx);
+    for (const mod of modules) {
+        try {
+            registry.register(mod);
+            log.debug("Registered: %s", mod.manifest.id);
+        }
+        catch (err) {
+            log.warn("Failed to register %s: %s", mod.manifest.id, err);
+        }
+    }
+    log.info("Loaded %d integration(s)", registry.size);
+    // Auto-enable configured integrations
+    for (const id of enabledIds) {
+        try {
+            await registry.enable(id);
+        }
+        catch (err) {
+            log.warn("Failed to enable %s: %s", id, err);
+        }
+    }
+    if (registry.enabledCount > 0) {
+        log.info("Enabled %d integration(s)", registry.enabledCount);
+    }
+    return registry;
+}
+/**
+ * Import all integration modules. Each module exports a default class.
+ * We use explicit imports for tree-shaking and bundler compatibility.
+ */
+async function importAllIntegrations(ctx) {
+    const instances = [];
+    const importSafe = async (path) => {
+        try {
+            const mod = await import(path);
+            if (mod.default) {
+                instances.push(new mod.default(ctx));
+            }
+        }
+        catch {
+            // Integration not available (missing deps, etc.)
+        }
+    };
+    // Google
+    await importSafe("./google/calendar.js");
+    await importSafe("./google/gmail.js");
+    await importSafe("./google/drive.js");
+    await importSafe("./google/docs.js");
+    await importSafe("./google/sheets.js");
+    await importSafe("./google/meet.js");
+    await importSafe("./google/maps.js");
+    await importSafe("./google/search.js");
+    await importSafe("./google/youtube.js");
+    // Chat
+    await importSafe("./chat/discord.js");
+    await importSafe("./chat/slack.js");
+    await importSafe("./chat/whatsapp.js");
+    // AI Models
+    await importSafe("./ai-models/openai.js");
+    await importSafe("./ai-models/anthropic.js");
+    await importSafe("./ai-models/ollama.js");
+    // Productivity
+    await importSafe("./productivity/notion.js");
+    await importSafe("./productivity/obsidian.js");
+    await importSafe("./productivity/github.js");
+    await importSafe("./productivity/linear.js");
+    // Music
+    await importSafe("./music/spotify.js");
+    // Smart Home
+    await importSafe("./smart-home/hue.js");
+    await importSafe("./smart-home/homeassistant.js");
+    // Tools
+    await importSafe("./tools/browser.js");
+    await importSafe("./tools/webhooks.js");
+    await importSafe("./tools/weather.js");
+    // Social
+    await importSafe("./social/twitter.js");
+    await importSafe("./social/email-smtp.js");
+    return instances;
+}
+//# sourceMappingURL=loader.js.map

package/dist/integrations/loader.js.map

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

package/dist/integrations/music/spotify.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Spotify Integration
+ *
+ * Provides playback control, search, and playlist management via the Spotify Web API.
+ * Requires OAuth2 with appropriate scopes for playback and playlist access.
+ *
+ * @requires SPOTIFY_ACCESS_TOKEN - OAuth2 access token (refreshed externally).
+ * @see https://developer.spotify.com/documentation/web-api
+ */
+import { Integration, type IntegrationManifest, type ToolResult } from "../base.js";
+export default class SpotifyIntegration extends Integration {
+    readonly manifest: IntegrationManifest;
+    private request;
+    executeTool(toolName: string, args: Record<string, unknown>): Promise<ToolResult>;
+    private nowPlaying;
+    private play;
+    private pause;
+    private search;
+    private addToPlaylist;
+}
+//# sourceMappingURL=spotify.d.ts.map

package/dist/integrations/music/spotify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spotify.d.ts","sourceRoot":"","sources":["../../../src/integrations/music/spotify.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,KAAK,mBAAmB,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAIpF,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,WAAW;IACzD,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAyDpC;YAEY,OAAO;IAcf,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;YAqBzE,UAAU;YAeV,IAAI;YAOJ,KAAK;YAML,MAAM;YAiBN,aAAa;CAS5B"}

package/dist/integrations/music/spotify.js

@@ -0,0 +1,161 @@
+/**
+ * Spotify Integration
+ *
+ * Provides playback control, search, and playlist management via the Spotify Web API.
+ * Requires OAuth2 with appropriate scopes for playback and playlist access.
+ *
+ * @requires SPOTIFY_ACCESS_TOKEN - OAuth2 access token (refreshed externally).
+ * @see https://developer.spotify.com/documentation/web-api
+ */
+import { Integration } from "../base.js";
+const API_BASE = "https://api.spotify.com/v1";
+export default class SpotifyIntegration extends Integration {
+    manifest = {
+        id: "spotify",
+        name: "Spotify",
+        category: "music",
+        version: "1.0.0",
+        description: "Control playback, search tracks, and manage playlists on Spotify.",
+        auth: {
+            type: "oauth2",
+            scopes: ["user-read-playback-state", "user-modify-playback-state", "playlist-read-private", "playlist-modify-public"],
+            envVars: ["SPOTIFY_ACCESS_TOKEN"],
+        },
+        tools: [
+            {
+                name: "spotify_now_playing",
+                description: "Get the currently playing track.",
+                parameters: { type: "object", properties: {} },
+            },
+            {
+                name: "spotify_play",
+                description: "Start or resume playback, optionally with a specific URI.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        uri: { type: "string", description: "Spotify URI to play (e.g. spotify:track:xxx). Optional." },
+                    },
+                },
+            },
+            {
+                name: "spotify_pause",
+                description: "Pause playback.",
+                parameters: { type: "object", properties: {} },
+            },
+            {
+                name: "spotify_search",
+                description: "Search for tracks, albums, or artists.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        query: { type: "string", description: "Search query." },
+                        type: { type: "string", description: "Type to search for.", enum: ["track", "album", "artist"], default: "track" },
+                    },
+                    required: ["query"],
+                },
+            },
+            {
+                name: "spotify_add_to_playlist",
+                description: "Add a track to a playlist.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        playlistId: { type: "string", description: "Playlist ID." },
+                        uri: { type: "string", description: "Spotify URI of the track to add." },
+                    },
+                    required: ["playlistId", "uri"],
+                },
+            },
+        ],
+    };
+    async request(path, options = {}) {
+        const creds = await this.getCredentials();
+        if (!creds?.SPOTIFY_ACCESS_TOKEN)
+            throw new Error("Missing SPOTIFY_ACCESS_TOKEN");
+        return fetch(`${API_BASE}${path}`, {
+            ...options,
+            headers: {
+                Authorization: `Bearer ${creds.SPOTIFY_ACCESS_TOKEN}`,
+                "Content-Type": "application/json",
+                ...options.headers,
+            },
+        });
+    }
+    async executeTool(toolName, args) {
+        try {
+            switch (toolName) {
+                case "spotify_now_playing":
+                    return await this.nowPlaying();
+                case "spotify_play":
+                    return await this.play(args.uri);
+                case "spotify_pause":
+                    return await this.pause();
+                case "spotify_search":
+                    return await this.search(args.query, args.type ?? "track");
+                case "spotify_add_to_playlist":
+                    return await this.addToPlaylist(args.playlistId, args.uri);
+                default:
+                    return this.error(`Unknown tool: ${toolName}`);
+            }
+        }
+        catch (err) {
+            return this.error(`Spotify error: ${err.message}`);
+        }
+    }
+    async nowPlaying() {
+        const res = await this.request("/me/player/currently-playing");
+        if (res.status === 204)
+            return this.ok("Nothing is currently playing.");
+        if (!res.ok)
+            return this.error(`Failed: ${res.status}`);
+        const data = await res.json();
+        if (!data.item)
+            return this.ok("Nothing is currently playing.");
+        const track = data.item;
+        const artists = track.artists.map((a) => a.name).join(", ");
+        return this.ok(`Now playing: ${track.name} by ${artists} (${track.album.name})`, {
+            uri: track.uri,
+            isPlaying: data.is_playing,
+            progressMs: data.progress_ms,
+        });
+    }
+    async play(uri) {
+        const body = uri ? JSON.stringify({ uris: [uri] }) : undefined;
+        const res = await this.request("/me/player/play", { method: "PUT", body });
+        if (!res.ok && res.status !== 204)
+            return this.error(`Play failed: ${res.status}`);
+        return this.ok(uri ? `Playing: ${uri}` : "Playback resumed.");
+    }
+    async pause() {
+        const res = await this.request("/me/player/pause", { method: "PUT" });
+        if (!res.ok && res.status !== 204)
+            return this.error(`Pause failed: ${res.status}`);
+        return this.ok("Playback paused.");
+    }
+    async search(query, type) {
+        const res = await this.request(`/search?q=${encodeURIComponent(query)}&type=${type}&limit=10`);
+        if (!res.ok)
+            return this.error(`Search failed: ${res.status}`);
+        const data = await res.json();
+        const key = `${type}s`;
+        const items = data[key]?.items ?? [];
+        const summary = items
+            .map((item) => {
+            const artists = item.artists?.map((a) => a.name).join(", ") ?? "";
+            return `${item.name}${artists ? ` - ${artists}` : ""} (${item.uri})`;
+        })
+            .join("\n");
+        return this.ok(summary || "No results found.", { count: items.length });
+    }
+    async addToPlaylist(playlistId, uri) {
+        const res = await this.request(`/playlists/${playlistId}/tracks`, {
+            method: "POST",
+            body: JSON.stringify({ uris: [uri] }),
+        });
+        if (!res.ok)
+            return this.error(`Add to playlist failed: ${res.status}`);
+        const data = await res.json();
+        return this.ok(`Track added to playlist.`, { snapshotId: data.snapshot_id });
+    }
+}
+//# sourceMappingURL=spotify.js.map

package/dist/integrations/music/spotify.js.map

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

package/dist/integrations/productivity/github.d.ts

@@ -0,0 +1,20 @@
+/**
+ * GitHub Integration
+ *
+ * Provides access to GitHub repositories -- create issues, list issues,
+ * create pull requests, and read file contents via the GitHub REST API.
+ *
+ * @requires GITHUB_TOKEN - Personal access token or fine-grained token.
+ * @see https://docs.github.com/en/rest
+ */
+import { Integration, type IntegrationManifest, type ToolResult } from "../base.js";
+export default class GitHubIntegration extends Integration {
+    readonly manifest: IntegrationManifest;
+    private request;
+    executeTool(toolName: string, args: Record<string, unknown>): Promise<ToolResult>;
+    private createIssue;
+    private listIssues;
+    private createPR;
+    private getFile;
+}
+//# sourceMappingURL=github.d.ts.map

package/dist/integrations/productivity/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../../src/integrations/productivity/github.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,KAAK,mBAAmB,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAIpF,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,WAAW;IACxD,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAoEpC;YAEY,OAAO;IAmBf,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;YAmBzE,WAAW;YAQX,UAAU;YAMV,QAAQ;YAQR,OAAO;CAMtB"}

package/dist/integrations/productivity/github.js

@@ -0,0 +1,146 @@
+/**
+ * GitHub Integration
+ *
+ * Provides access to GitHub repositories -- create issues, list issues,
+ * create pull requests, and read file contents via the GitHub REST API.
+ *
+ * @requires GITHUB_TOKEN - Personal access token or fine-grained token.
+ * @see https://docs.github.com/en/rest
+ */
+import { Integration } from "../base.js";
+const API_BASE = "https://api.github.com";
+export default class GitHubIntegration extends Integration {
+    manifest = {
+        id: "github",
+        name: "GitHub",
+        category: "productivity",
+        version: "1.0.0",
+        description: "Create issues, list issues, create PRs, and read files on GitHub.",
+        auth: {
+            type: "token",
+            envVars: ["GITHUB_TOKEN"],
+        },
+        tools: [
+            {
+                name: "github_create_issue",
+                description: "Create a new issue in a repository.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        owner: { type: "string", description: "Repository owner." },
+                        repo: { type: "string", description: "Repository name." },
+                        title: { type: "string", description: "Issue title." },
+                        body: { type: "string", description: "Issue body (Markdown)." },
+                    },
+                    required: ["owner", "repo", "title"],
+                },
+            },
+            {
+                name: "github_list_issues",
+                description: "List issues in a repository.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        owner: { type: "string", description: "Repository owner." },
+                        repo: { type: "string", description: "Repository name." },
+                        state: { type: "string", description: "Filter by state.", enum: ["open", "closed", "all"], default: "open" },
+                    },
+                    required: ["owner", "repo"],
+                },
+            },
+            {
+                name: "github_create_pr",
+                description: "Create a pull request.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        owner: { type: "string", description: "Repository owner." },
+                        repo: { type: "string", description: "Repository name." },
+                        title: { type: "string", description: "PR title." },
+                        body: { type: "string", description: "PR description." },
+                        head: { type: "string", description: "Head branch." },
+                        base: { type: "string", description: "Base branch.", default: "main" },
+                    },
+                    required: ["owner", "repo", "title", "head", "base"],
+                },
+            },
+            {
+                name: "github_get_file",
+                description: "Get the contents of a file from a repository.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        owner: { type: "string", description: "Repository owner." },
+                        repo: { type: "string", description: "Repository name." },
+                        path: { type: "string", description: "File path within the repo." },
+                    },
+                    required: ["owner", "repo", "path"],
+                },
+            },
+        ],
+    };
+    async request(path, options = {}) {
+        const creds = await this.getCredentials();
+        if (!creds?.GITHUB_TOKEN)
+            throw new Error("Missing GITHUB_TOKEN");
+        const res = await fetch(`${API_BASE}${path}`, {
+            ...options,
+            headers: {
+                Authorization: `Bearer ${creds.GITHUB_TOKEN}`,
+                Accept: "application/vnd.github+json",
+                "X-GitHub-Api-Version": "2022-11-28",
+                "Content-Type": "application/json",
+                ...options.headers,
+            },
+        });
+        if (!res.ok)
+            throw new Error(`GitHub ${res.status}: ${await res.text()}`);
+        return res.json();
+    }
+    async executeTool(toolName, args) {
+        try {
+            switch (toolName) {
+                case "github_create_issue":
+                    return await this.createIssue(args.owner, args.repo, args.title, args.body);
+                case "github_list_issues":
+                    return await this.listIssues(args.owner, args.repo, args.state ?? "open");
+                case "github_create_pr":
+                    return await this.createPR(args.owner, args.repo, args.title, args.body, args.head, args.base);
+                case "github_get_file":
+                    return await this.getFile(args.owner, args.repo, args.path);
+                default:
+                    return this.error(`Unknown tool: ${toolName}`);
+            }
+        }
+        catch (err) {
+            return this.error(`GitHub error: ${err.message}`);
+        }
+    }
+    async createIssue(owner, repo, title, body) {
+        const data = await this.request(`/repos/${owner}/${repo}/issues`, {
+            method: "POST",
+            body: JSON.stringify({ title, body }),
+        });
+        return this.ok(`Issue #${data.number} created: ${data.html_url}`, { number: data.number, url: data.html_url });
+    }
+    async listIssues(owner, repo, state) {
+        const data = await this.request(`/repos/${owner}/${repo}/issues?state=${state}&per_page=30`);
+        const summary = data.map((i) => `#${i.number} [${i.state}] ${i.title}`).join("\n");
+        return this.ok(summary || "No issues found.", { count: data.length });
+    }
+    async createPR(owner, repo, title, body, head, base) {
+        const data = await this.request(`/repos/${owner}/${repo}/pulls`, {
+            method: "POST",
+            body: JSON.stringify({ title, body, head, base }),
+        });
+        return this.ok(`PR #${data.number} created: ${data.html_url}`, { number: data.number, url: data.html_url });
+    }
+    async getFile(owner, repo, path) {
+        const data = await this.request(`/repos/${owner}/${repo}/contents/${path}`);
+        if (data.type !== "file")
+            return this.error(`Path is not a file: ${data.type}`);
+        const content = Buffer.from(data.content, "base64").toString("utf-8");
+        return this.ok(content, { path: data.path, sha: data.sha, size: data.size });
+    }
+}
+//# sourceMappingURL=github.js.map

package/dist/integrations/productivity/github.js.map

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