@hahnfeld/teams-adapter 1.0.9

package/dist/draft-manager.js

@@ -0,0 +1,136 @@
+import { log } from "@openacp/plugin-sdk";
+import { splitMessage } from "./formatting.js";
+import { sendText } from "./send-utils.js";
+/** First flush fires quickly so the user sees content fast */
+const FIRST_FLUSH_INTERVAL = 500;
+/** Subsequent flushes are slower to avoid rate limits (Teams: 7 ops/sec/conversation) */
+const UPDATE_FLUSH_INTERVAL = 3000;
+const MAX_DISPLAY_LENGTH = 1900;
+export class TeamsMessageDraft {
+    context;
+    sendQueue;
+    sessionId;
+    buffer = "";
+    ref;
+    flushTimer;
+    flushPromise = Promise.resolve();
+    lastSentBuffer = "";
+    displayTruncated = false;
+    firstFlushPending = false;
+    finalizing = false;
+    constructor(context, sendQueue, sessionId) {
+        this.context = context;
+        this.sendQueue = sendQueue;
+        this.sessionId = sessionId;
+    }
+    /** Update the TurnContext to the latest inbound turn (prevents stale context refs) */
+    updateContext(context) {
+        this.context = context;
+    }
+    append(text) {
+        if (!text)
+            return;
+        this.buffer += text;
+        this.scheduleFlush();
+    }
+    getBuffer() {
+        return this.buffer;
+    }
+    scheduleFlush() {
+        if (this.flushTimer)
+            return;
+        // Fast first flush (500ms) for perceived responsiveness, then slower updates (3s)
+        const interval = this.ref?.activityId ? UPDATE_FLUSH_INTERVAL : FIRST_FLUSH_INTERVAL;
+        this.flushTimer = setTimeout(() => {
+            this.flushTimer = undefined;
+            this.flushPromise = this.flushPromise.then(() => this.flush()).catch(() => { });
+        }, interval);
+    }
+    async flush() {
+        // Streaming updates via updateActivity don't work with the teams.apps SDK
+        // context (it only has send(), not updateActivity()). Instead of trying to
+        // update in-place, we skip periodic flushes and let finalize() send the
+        // complete message. The typing indicator keeps the user informed.
+    }
+    async stripPattern(pattern) {
+        if (!this.buffer)
+            return;
+        try {
+            this.buffer = this.buffer.replace(pattern, "").trim();
+        }
+        catch {
+            // Regex failed — leave buffer unchanged
+        }
+    }
+    async finalize() {
+        if (this.finalizing)
+            return;
+        this.finalizing = true;
+        try {
+            await this._finalizeInner();
+        }
+        finally {
+            this.finalizing = false;
+        }
+    }
+    async _finalizeInner() {
+        if (this.flushTimer) {
+            clearTimeout(this.flushTimer);
+            this.flushTimer = undefined;
+        }
+        if (!this.buffer)
+            return;
+        // Send the complete text as new message(s), split if needed.
+        // We don't use updateActivity because the teams.apps SDK context
+        // doesn't support it — only send() is available.
+        const chunks = splitMessage(this.buffer, MAX_DISPLAY_LENGTH);
+        for (let i = 0; i < chunks.length; i++) {
+            const content = chunks[i];
+            try {
+                await this.sendQueue.enqueue(() => sendText(this.context, content), { type: "other" });
+            }
+            catch (err) {
+                log.warn({ err, sessionId: this.sessionId, chunk: i }, "[TeamsMessageDraft] finalize: chunk send failed");
+            }
+        }
+    }
+}
+export class TeamsDraftManager {
+    sendQueue;
+    drafts = new Map();
+    constructor(sendQueue) {
+        this.sendQueue = sendQueue;
+    }
+    getOrCreate(sessionId, context) {
+        let draft = this.drafts.get(sessionId);
+        if (!draft) {
+            draft = new TeamsMessageDraft(context, this.sendQueue, sessionId);
+            this.drafts.set(sessionId, draft);
+        }
+        else {
+            // Re-bind to the latest TurnContext to prevent stale context references
+            // when a new inbound message arrives on the same session (new turn).
+            draft.updateContext(context);
+        }
+        return draft;
+    }
+    hasDraft(sessionId) {
+        return this.drafts.has(sessionId);
+    }
+    getDraft(sessionId) {
+        return this.drafts.get(sessionId);
+    }
+    async finalize(sessionId, _context, _isAssistant) {
+        const draft = this.drafts.get(sessionId);
+        if (!draft)
+            return;
+        // Delete BEFORE awaiting to prevent concurrent finalize() calls
+        // from double-finalizing the same draft (matches Telegram pattern)
+        this.drafts.delete(sessionId);
+        await draft.finalize();
+    }
+    cleanup(sessionId) {
+        this.drafts.delete(sessionId);
+    }
+}
+//# sourceMappingURL=draft-manager.js.map

package/dist/draft-manager.js.map

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

package/dist/formatting.d.ts

@@ -0,0 +1,121 @@
+export type { OutputMode, ToolDisplaySpec, ToolCardSnapshot, PlanEntry } from "@openacp/plugin-sdk";
+export declare const STATUS_ICONS: Record<string, string>;
+export declare const KIND_ICONS: Record<string, string>;
+export declare function progressBar(ratio: number, length?: number): string;
+export declare function formatTokens(n: number): string;
+export declare function truncateContent(text: string, max: number): string;
+/**
+ * Split text into chunks that fit within maxLength, preferring paragraph
+ * and line boundaries. Handles single lines longer than maxLength by
+ * hard-splitting at the limit.
+ */
+export declare function splitMessage(text: string, maxLength: number): string[];
+export declare function extractContentText(content: unknown): string;
+export declare function stripCodeFences(text: string): string;
+export declare function resolveToolIcon(kind: string, displayKind?: string, status?: string): string;
+export declare function formatToolTitle(name: string, _rawInput?: unknown, displayTitle?: string): string;
+export declare function formatToolSummary(name: string, rawInput?: unknown, displaySummary?: string): string;
+export declare function formatToolCall(tool: {
+    id: string;
+    name: string;
+    kind?: string;
+    status?: string;
+    content?: unknown;
+    rawInput?: unknown;
+    viewerLinks?: {
+        file?: string;
+        diff?: string;
+    };
+    viewerFilePath?: string;
+    displaySummary?: string;
+    displayTitle?: string;
+    displayKind?: string;
+}, verbosity?: "low" | "medium" | "high"): string;
+export declare function formatToolUpdate(tool: {
+    id: string;
+    name: string;
+    kind?: string;
+    status?: string;
+    content?: unknown;
+    rawInput?: unknown;
+    viewerLinks?: {
+        file?: string;
+        diff?: string;
+    };
+    viewerFilePath?: string;
+    displaySummary?: string;
+    displayTitle?: string;
+    displayKind?: string;
+}, verbosity?: "low" | "medium" | "high"): string;
+export declare function formatPlan(entries: {
+    content: string;
+    status: string;
+}[], verbosity?: "low" | "medium" | "high"): string;
+export declare function formatUsage(usage: {
+    tokensUsed?: number;
+    contextSize?: number;
+    cost?: number;
+}, verbosity?: "low" | "medium" | "high"): string;
+interface UsageData {
+    tokensUsed?: number;
+    contextSize?: number;
+    cost?: number;
+    duration?: number;
+}
+/** Structured usage card with FactSet and visual progress indicator */
+export declare function renderUsageCard(usage: UsageData, mode: "low" | "medium" | "high"): {
+    body: unknown[];
+};
+interface ToolCallCardMeta {
+    id: string;
+    name: string;
+    kind?: string;
+    status?: string;
+    rawInput?: unknown;
+    content?: unknown;
+    displaySummary?: string;
+    displayTitle?: string;
+    displayKind?: string;
+    viewerLinks?: {
+        file?: string;
+        diff?: string;
+    };
+    viewerFilePath?: string;
+}
+/** Structured tool call card with icon, name, status, and optional details */
+export declare function renderToolCallCard(tool: ToolCallCardMeta, verbosity: "low" | "medium" | "high"): {
+    body: unknown[];
+    actions?: unknown[];
+};
+/** Structured plan card with status-colored rows */
+export declare function renderPlanCard(entries: {
+    content: string;
+    status: string;
+}[], verbosity: "low" | "medium" | "high"): {
+    body: unknown[];
+};
+interface CitationSource {
+    /** File path or tool name */
+    name: string;
+    /** URL to view the file or diff */
+    url: string;
+    /** Short description or content snippet */
+    abstract?: string;
+    /** Icon type: "Source Code", "PDF", "Image", etc. */
+    iconType?: string;
+}
+/**
+ * Build Teams citation entities from file references.
+ *
+ * Teams displays citations as numbered in-text references [1] with hover popups
+ * showing the source name, description, and link. Max 20 per message.
+ *
+ * @see https://learn.microsoft.com/en-us/microsoftteams/platform/bots/how-to/bot-messages-ai-generated-content
+ */
+export declare function buildCitationEntities(sources: CitationSource[]): unknown[];
+/**
+ * Build citation text references like "[1]" to insert into message text.
+ * Returns a suffix string to append to the message.
+ */
+export declare function buildCitationSuffix(sources: CitationSource[]): string;
+//# sourceMappingURL=formatting.d.ts.map

package/dist/formatting.d.ts.map

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

package/dist/formatting.js

@@ -0,0 +1,392 @@
+// Status/Kind constants
+export const STATUS_ICONS = {
+    pending: "⏳", in_progress: "🔄", completed: "✅", failed: "❌",
+    cancelled: "🚫", running: "🔄", done: "✅", error: "❌",
+};
+export const KIND_ICONS = {
+    read: "📖", edit: "✏️", write: "✏️", delete: "🗑️", execute: "▶️",
+    command: "▶️", bash: "▶️", terminal: "▶️", search: "🔍", web: "🌐",
+    fetch: "🌐", agent: "🧠", think: "🧠", install: "📦", move: "📦", other: "🛠️",
+};
+export function progressBar(ratio, length = 10) {
+    const filled = Math.round(Math.min(1, Math.max(0, ratio)) * length);
+    return "▓".repeat(filled) + "░".repeat(length - filled);
+}
+export function formatTokens(n) {
+    if (n >= 1000)
+        return `${Math.round(n / 1000)}k`;
+    return String(n);
+}
+export function truncateContent(text, max) {
+    const suffix = "… (truncated)";
+    if (text.length <= max)
+        return text;
+    return text.slice(0, max - suffix.length) + suffix;
+}
+/**
+ * Split text into chunks that fit within maxLength, preferring paragraph
+ * and line boundaries. Handles single lines longer than maxLength by
+ * hard-splitting at the limit.
+ */
+export function splitMessage(text, maxLength) {
+    if (text.length <= maxLength)
+        return [text];
+    const paragraphs = text.split("\n\n");
+    const chunks = [];
+    let current = "";
+    const pushCurrent = () => {
+        if (current) {
+            chunks.push(current);
+            current = "";
+        }
+    };
+    // Hard-split a single string that exceeds maxLength
+    const hardSplit = (s) => {
+        while (s.length > maxLength) {
+            chunks.push(s.slice(0, maxLength));
+            s = s.slice(maxLength);
+        }
+        return s; // remainder
+    };
+    for (const para of paragraphs) {
+        const candidate = current ? `${current}\n\n${para}` : para;
+        if (candidate.length <= maxLength) {
+            current = candidate;
+            continue;
+        }
+        // Candidate exceeds limit — flush current and process para separately
+        pushCurrent();
+        if (para.length <= maxLength) {
+            current = para;
+            continue;
+        }
+        // Para exceeds limit — try splitting on line boundaries
+        const lines = para.split("\n");
+        for (const line of lines) {
+            if (line.length > maxLength) {
+                // Line itself exceeds limit — hard-split it
+                pushCurrent();
+                current = hardSplit(line);
+                continue;
+            }
+            const lineCandidate = current ? `${current}\n${line}` : line;
+            if (lineCandidate.length > maxLength) {
+                pushCurrent();
+                current = line;
+            }
+            else {
+                current = lineCandidate;
+            }
+        }
+    }
+    if (current)
+        chunks.push(current);
+    return chunks;
+}
+export function extractContentText(content) {
+    if (content == null)
+        return "";
+    if (typeof content === "string")
+        return content;
+    if (Array.isArray(content)) {
+        return content.map((c) => {
+            if (typeof c === "string")
+                return c;
+            if (c && typeof c === "object" && "text" in c)
+                return String(c.text);
+            return "";
+        }).filter(Boolean).join("\n");
+    }
+    if (typeof content === "object" && content !== null && "text" in content) {
+        return String(content.text);
+    }
+    return "";
+}
+export function stripCodeFences(text) {
+    return text.replace(/^```[\w]*\n?/gm, "").replace(/\n?```$/gm, "").trim();
+}
+export function resolveToolIcon(kind, displayKind, status) {
+    if (status && STATUS_ICONS[status])
+        return STATUS_ICONS[status];
+    if (displayKind && KIND_ICONS[displayKind])
+        return KIND_ICONS[displayKind];
+    if (kind && KIND_ICONS[kind])
+        return KIND_ICONS[kind];
+    return "🔧";
+}
+export function formatToolTitle(name, _rawInput, displayTitle) {
+    if (displayTitle)
+        return displayTitle;
+    return name;
+}
+export function formatToolSummary(name, rawInput, displaySummary) {
+    if (displaySummary)
+        return displaySummary;
+    if (rawInput && typeof rawInput === "object") {
+        const input = rawInput;
+        if (input.pattern)
+            return `${name} "${input.pattern}"`;
+        if (input.file_path)
+            return `${name} ${input.file_path}`;
+    }
+    return name;
+}
+export function formatToolCall(tool, verbosity = "medium") {
+    const si = resolveToolIcon(tool.kind ?? "", tool.displayKind, tool.status);
+    const name = tool.name || "Tool";
+    const label = verbosity === "low"
+        ? formatToolTitle(name, tool.rawInput, tool.displayTitle)
+        : formatToolSummary(name, tool.rawInput, tool.displaySummary);
+    let text = `${si} **${label}**`;
+    if (tool.viewerLinks) {
+        const fn = tool.viewerFilePath ? tool.viewerFilePath.split("/").pop() || tool.viewerFilePath : "";
+        const fileLink = tool.viewerLinks.file;
+        const diffLink = tool.viewerLinks.diff;
+        if (fileLink) {
+            text += "\n[View " + (fn || "file") + "](" + fileLink + ")";
+        }
+        if (diffLink) {
+            text += "\n[View diff" + (fn ? " - " + fn : "") + "](" + diffLink + ")";
+        }
+    }
+    if (verbosity === "high" && (tool.rawInput || tool.content)) {
+        const maxLen = 500;
+        let detail = "";
+        if (tool.rawInput) {
+            const inputStr = typeof tool.rawInput === "string" ? tool.rawInput : JSON.stringify(tool.rawInput, null, 2);
+            if (inputStr && inputStr !== "{}") {
+                detail += `\n**Input:**\n\`\`\`\n${truncateContent(inputStr, maxLen)}\n\`\`\``;
+            }
+        }
+        const contentText = stripCodeFences(extractContentText(tool.content));
+        if (contentText) {
+            detail += `\n**Output:**\n\`\`\`\n${truncateContent(contentText, maxLen)}\n\`\`\``;
+        }
+        text += detail;
+    }
+    return text;
+}
+export function formatToolUpdate(tool, verbosity = "medium") {
+    return formatToolCall(tool, verbosity);
+}
+export function formatPlan(entries, verbosity = "medium") {
+    if (verbosity === "medium") {
+        const done = entries.filter((e) => e.status === "completed").length;
+        return `📋 **Plan:** ${done}/${entries.length} steps completed`;
+    }
+    const statusIconMap = {
+        pending: "⏳", in_progress: "🔄", completed: "✅",
+    };
+    const lines = entries.map((e, i) => `${statusIconMap[e.status] || "⬜"} ${i + 1}. ${e.content}`);
+    return `**Plan:**\n${lines.join("\n")}`;
+}
+export function formatUsage(usage, verbosity = "medium") {
+    const { tokensUsed, contextSize, cost } = usage;
+    if (tokensUsed == null)
+        return "📊 Usage data unavailable";
+    if (verbosity === "medium") {
+        const costStr = cost != null ? ` · $${cost.toFixed(2)}` : "";
+        return `📊 ${formatTokens(tokensUsed)} tokens${costStr}`;
+    }
+    if (contextSize == null)
+        return `📊 ${formatTokens(tokensUsed)} tokens`;
+    const ratio = tokensUsed / contextSize;
+    const pct = Math.round(ratio * 100);
+    const bar = progressBar(ratio);
+    const emoji = pct >= 85 ? "⚠️" : "📊";
+    let text = `${emoji} ${formatTokens(tokensUsed)} / ${formatTokens(contextSize)} tokens\n${bar} ${pct}%`;
+    if (cost != null)
+        text += `\n💰 $${cost.toFixed(2)}`;
+    return text;
+}
+/** Structured usage card with FactSet and visual progress indicator */
+export function renderUsageCard(usage, mode) {
+    const { tokensUsed, contextSize, cost, duration } = usage;
+    if (tokensUsed == null) {
+        return { body: [{ type: "TextBlock", text: "📊 Usage data unavailable", wrap: true, isSubtle: true }] };
+    }
+    if (mode === "low") {
+        return { body: [{ type: "TextBlock", text: `📊 ${formatTokens(tokensUsed)} tokens`, wrap: true }] };
+    }
+    const body = [];
+    // Header
+    const pct = contextSize ? Math.round((tokensUsed / contextSize) * 100) : null;
+    const headerColor = pct != null && pct >= 85 ? "Attention" : "Default";
+    body.push({ type: "TextBlock", text: "📊 Usage Summary", weight: "Bolder", size: "Medium", color: headerColor });
+    // Facts
+    const facts = [
+        { title: "Tokens", value: formatTokens(tokensUsed) },
+    ];
+    if (contextSize)
+        facts.push({ title: "Context", value: `${formatTokens(contextSize)} (${pct}%)` });
+    if (cost != null)
+        facts.push({ title: "Cost", value: `$${cost.toFixed(4)}` });
+    if (duration != null)
+        facts.push({ title: "Duration", value: `${(duration / 1000).toFixed(1)}s` });
+    body.push({ type: "FactSet", facts, separator: true });
+    // Visual progress bar (context usage)
+    if (contextSize && mode === "high") {
+        body.push({
+            type: "TextBlock",
+            text: `\`${progressBar(tokensUsed / contextSize, 20)}\` ${pct}%`,
+            fontType: "Monospace",
+            size: "Small",
+            isSubtle: true,
+        });
+    }
+    return { body };
+}
+/** Structured tool call card with icon, name, status, and optional details */
+export function renderToolCallCard(tool, verbosity) {
+    const icon = resolveToolIcon(tool.kind ?? "", tool.displayKind, tool.status);
+    const name = tool.name || "Tool";
+    const label = verbosity === "low"
+        ? formatToolTitle(name, tool.rawInput, tool.displayTitle)
+        : formatToolSummary(name, tool.rawInput, tool.displaySummary);
+    const statusColor = tool.status === "completed" ? "Good" : tool.status === "error" ? "Attention" : "Default";
+    const body = [];
+    // Header row: icon + tool name + status
+    body.push({
+        type: "ColumnSet",
+        columns: [
+            {
+                type: "Column",
+                width: "auto",
+                items: [{ type: "TextBlock", text: icon, size: "Medium" }],
+            },
+            {
+                type: "Column",
+                width: "stretch",
+                items: [
+                    { type: "TextBlock", text: `**${label}**`, wrap: true },
+                    ...(tool.status ? [{ type: "TextBlock", text: tool.status, size: "Small", isSubtle: true, color: statusColor, spacing: "None" }] : []),
+                ],
+            },
+        ],
+    });
+    // High verbosity: show input/output
+    if (verbosity === "high") {
+        const maxLen = 400;
+        if (tool.rawInput) {
+            const inputStr = typeof tool.rawInput === "string" ? tool.rawInput : JSON.stringify(tool.rawInput, null, 2);
+            if (inputStr && inputStr !== "{}") {
+                body.push({ type: "TextBlock", text: "**Input:**", size: "Small", spacing: "Medium" });
+                body.push({ type: "TextBlock", text: `\`\`\`\n${truncateContent(inputStr, maxLen)}\n\`\`\``, wrap: true, fontType: "Monospace", size: "Small" });
+            }
+        }
+        const contentText = stripCodeFences(extractContentText(tool.content));
+        if (contentText) {
+            body.push({ type: "TextBlock", text: "**Output:**", size: "Small", spacing: "Medium" });
+            body.push({ type: "TextBlock", text: `\`\`\`\n${truncateContent(contentText, maxLen)}\n\`\`\``, wrap: true, fontType: "Monospace", size: "Small" });
+        }
+    }
+    // Actions: viewer links
+    const actions = [];
+    if (tool.viewerLinks) {
+        const fn = tool.viewerFilePath?.split("/").pop() || "file";
+        if (tool.viewerLinks.file) {
+            actions.push({ type: "Action.OpenUrl", title: `View ${fn}`, url: tool.viewerLinks.file });
+        }
+        if (tool.viewerLinks.diff) {
+            actions.push({ type: "Action.OpenUrl", title: `View diff`, url: tool.viewerLinks.diff });
+        }
+    }
+    return { body, ...(actions.length > 0 ? { actions } : {}) };
+}
+/** Structured plan card with status-colored rows */
+export function renderPlanCard(entries, verbosity) {
+    const done = entries.filter((e) => e.status === "completed").length;
+    const total = entries.length;
+    const body = [];
+    // Header with progress
+    body.push({
+        type: "ColumnSet",
+        columns: [
+            { type: "Column", width: "stretch", items: [{ type: "TextBlock", text: "📋 **Plan**", weight: "Bolder" }] },
+            { type: "Column", width: "auto", items: [{ type: "TextBlock", text: `${done}/${total}`, isSubtle: true }] },
+        ],
+    });
+    if (verbosity === "medium" && total > 5) {
+        // Compact summary for medium verbosity with many steps
+        body.push({ type: "TextBlock", text: `${done} of ${total} steps completed`, isSubtle: true });
+        return { body };
+    }
+    // Step rows with status colors
+    const statusColors = {
+        completed: "Good", in_progress: "Accent", pending: "Default",
+    };
+    const statusIcons = {
+        completed: "✅", in_progress: "🔄", pending: "⬜",
+    };
+    for (let i = 0; i < entries.length; i++) {
+        const e = entries[i];
+        const icon = statusIcons[e.status] || "⬜";
+        const color = statusColors[e.status] || "Default";
+        body.push({
+            type: "ColumnSet",
+            spacing: "Small",
+            columns: [
+                { type: "Column", width: "auto", items: [{ type: "TextBlock", text: icon }] },
+                { type: "Column", width: "stretch", items: [{ type: "TextBlock", text: `${i + 1}. ${e.content}`, wrap: true, color }] },
+            ],
+        });
+    }
+    return { body };
+}
+/**
+ * Build Teams citation entities from file references.
+ *
+ * Teams displays citations as numbered in-text references [1] with hover popups
+ * showing the source name, description, and link. Max 20 per message.
+ *
+ * @see https://learn.microsoft.com/en-us/microsoftteams/platform/bots/how-to/bot-messages-ai-generated-content
+ */
+export function buildCitationEntities(sources) {
+    if (sources.length === 0)
+        return [];
+    return [{
+            type: "https://schema.org/Message",
+            "@type": "Message",
+            "@context": "https://schema.org",
+            additionalType: ["AIGeneratedContent"],
+            citation: sources.slice(0, 20).map((source, i) => ({
+                "@type": "Claim",
+                position: i + 1,
+                appearance: {
+                    "@type": "DigitalDocument",
+                    name: source.name.slice(0, 80),
+                    url: source.url,
+                    ...(source.abstract ? { abstract: source.abstract.slice(0, 160) } : {}),
+                    image: { "@type": "ImageObject", name: source.iconType ?? guessIconType(source.name) },
+                },
+            })),
+        }];
+}
+/**
+ * Build citation text references like "[1]" to insert into message text.
+ * Returns a suffix string to append to the message.
+ */
+export function buildCitationSuffix(sources) {
+    if (sources.length === 0)
+        return "";
+    return "\n\n" + sources.slice(0, 20).map((s, i) => `[${i + 1}] ${s.name}`).join("\n");
+}
+/** Guess the Teams citation icon type from a file extension */
+function guessIconType(name) {
+    const ext = name.split(".").pop()?.toLowerCase() ?? "";
+    const codeExts = new Set(["ts", "js", "tsx", "jsx", "py", "rs", "go", "java", "c", "cpp", "h", "cs", "rb", "swift", "kt", "sh", "yaml", "yml", "json", "toml", "xml", "html", "css", "scss", "sql", "md"]);
+    if (codeExts.has(ext))
+        return "Source Code";
+    if (ext === "pdf")
+        return "PDF";
+    if (["png", "jpg", "jpeg", "gif", "svg", "webp"].includes(ext))
+        return "Image";
+    if (["doc", "docx"].includes(ext))
+        return "Microsoft Word";
+    if (["xls", "xlsx"].includes(ext))
+        return "Microsoft Excel";
+    if (["ppt", "pptx"].includes(ext))
+        return "Microsoft PowerPoint";
+    return "Source Code";
+}
+//# sourceMappingURL=formatting.js.map