@office-agents/sdk 0.0.1

package/dist/web/config.js

@@ -0,0 +1,41 @@
+import { getNamespace } from "../storage/namespace";
+function webConfigKey() {
+    return `${getNamespace().localStoragePrefix}-web-config`;
+}
+const DEFAULT_WEB_CONFIG = {
+    searchProvider: "ddgs",
+    fetchProvider: "basic",
+    apiKeys: {},
+};
+export function loadWebConfig() {
+    try {
+        const raw = localStorage.getItem(webConfigKey());
+        if (!raw)
+            return { ...DEFAULT_WEB_CONFIG };
+        const parsed = JSON.parse(raw);
+        return {
+            searchProvider: parsed.searchProvider || DEFAULT_WEB_CONFIG.searchProvider,
+            fetchProvider: parsed.fetchProvider || DEFAULT_WEB_CONFIG.fetchProvider,
+            apiKeys: {
+                ...DEFAULT_WEB_CONFIG.apiKeys,
+                ...(parsed.apiKeys || {}),
+            },
+        };
+    }
+    catch {
+        return { ...DEFAULT_WEB_CONFIG };
+    }
+}
+export function saveWebConfig(config) {
+    const current = loadWebConfig();
+    const next = {
+        searchProvider: config.searchProvider || current.searchProvider,
+        fetchProvider: config.fetchProvider || current.fetchProvider,
+        apiKeys: {
+            ...current.apiKeys,
+            ...(config.apiKeys || {}),
+        },
+    };
+    localStorage.setItem(webConfigKey(), JSON.stringify(next));
+}
+//# sourceMappingURL=config.js.map

package/dist/web/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/web/config.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,SAAS,YAAY;IACnB,OAAO,GAAG,YAAY,EAAE,CAAC,kBAAkB,aAAa,CAAC;AAC3D,CAAC;AAED,MAAM,kBAAkB,GAAc;IACpC,cAAc,EAAE,MAAM;IACtB,aAAa,EAAE,OAAO;IACtB,OAAO,EAAE,EAAE;CACZ,CAAC;AAEF,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,GAAG,kBAAkB,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAuB,CAAC;QACrD,OAAO;YACL,cAAc,EACZ,MAAM,CAAC,cAAc,IAAI,kBAAkB,CAAC,cAAc;YAC5D,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,kBAAkB,CAAC,aAAa;YACvE,OAAO,EAAE;gBACP,GAAG,kBAAkB,CAAC,OAAO;gBAC7B,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;aAC1B;SACF,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,GAAG,kBAAkB,EAAE,CAAC;IACnC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAA0B;IACtD,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,MAAM,IAAI,GAAc;QACtB,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,OAAO,CAAC,cAAc;QAC/D,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,OAAO,CAAC,aAAa;QAC5D,OAAO,EAAE;YACP,GAAG,OAAO,CAAC,OAAO;YAClB,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;SAC1B;KACF,CAAC;IACF,YAAY,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7D,CAAC"}

package/dist/web/fetch.d.ts

@@ -0,0 +1,5 @@
+import type { FetchProvider, FetchResult, WebContext } from "./types";
+export declare function listFetchProviders(): string[];
+export declare function getFetchProvider(providerId?: string): FetchProvider;
+export declare function fetchWeb(url: string, context?: WebContext, providerId?: string): Promise<FetchResult>;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/web/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/web/fetch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAgOtE,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C;AAED,wBAAgB,gBAAgB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,CAGnE;AAED,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,UAAe,EACxB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,WAAW,CAAC,CAGtB"}

package/dist/web/fetch.js

@@ -0,0 +1,174 @@
+import { Readability } from "@mozilla/readability";
+import TurndownService from "turndown";
+function isHtmlContentType(contentType) {
+    const ct = contentType.split(";")[0].trim().toLowerCase();
+    return ct === "text/html" || ct === "application/xhtml+xml";
+}
+function isTextContentType(contentType) {
+    const ct = contentType.split(";")[0].trim().toLowerCase();
+    if (ct.startsWith("text/"))
+        return true;
+    return (ct === "application/json" ||
+        ct === "application/xml" ||
+        ct === "application/javascript");
+}
+function getApiKey(context, providerId) {
+    return context.apiKeys?.[providerId];
+}
+async function fetchWithProxy(url, proxyUrl, init) {
+    if (proxyUrl) {
+        try {
+            return await fetch(`${proxyUrl}/?url=${encodeURIComponent(url)}`, init);
+        }
+        catch (err) {
+            throw new Error(`CORS proxy fetch failed: ${err instanceof Error ? err.message : err}`);
+        }
+    }
+    try {
+        return await fetch(url, init);
+    }
+    catch {
+        throw new Error("Fetch blocked by CORS and no CORS proxy is configured. Enable the CORS proxy in Settings.");
+    }
+}
+function extractContentFromHtml(url, html) {
+    const doc = new DOMParser().parseFromString(html, "text/html");
+    const base = doc.createElement("base");
+    base.href = url;
+    doc.head.prepend(base);
+    const reader = new Readability(doc);
+    const article = reader.parse();
+    const td = new TurndownService({
+        headingStyle: "atx",
+        codeBlockStyle: "fenced",
+        bulletListMarker: "-",
+    });
+    td.remove(["script", "style", "footer"]);
+    let title;
+    let content;
+    const metadata = { URL: url };
+    if (article) {
+        title = article.title;
+        if (article.byline)
+            metadata.Author = article.byline;
+        if (article.siteName)
+            metadata.Site = article.siteName;
+        content = td.turndown(article.content).trim();
+    }
+    else {
+        title = doc.querySelector("title")?.textContent ?? url;
+        content = td.turndown(doc.body?.innerHTML ?? "").trim();
+    }
+    return {
+        kind: "text",
+        contentType: "text/markdown",
+        text: content,
+        title,
+        metadata,
+    };
+}
+const basicFetchProvider = {
+    id: "basic",
+    async fetch(url, context) {
+        const resp = await fetchWithProxy(url, context.proxyUrl);
+        if (!resp.ok) {
+            throw new Error(`Fetch failed: ${resp.status} ${resp.statusText}`);
+        }
+        const contentType = resp.headers.get("content-type") ?? "";
+        if (isHtmlContentType(contentType)) {
+            return extractContentFromHtml(url, await resp.text());
+        }
+        if (isTextContentType(contentType)) {
+            return {
+                kind: "text",
+                contentType,
+                text: await resp.text(),
+            };
+        }
+        return {
+            kind: "binary",
+            contentType,
+            data: new Uint8Array(await resp.arrayBuffer()),
+        };
+    },
+};
+function toExaTextResult(inputUrl, response) {
+    const first = response.results?.[0];
+    if (!first)
+        return null;
+    const text = first.text?.trim() ||
+        first.summary?.trim() ||
+        first.highlights?.filter(Boolean).join("\n\n").trim() ||
+        "";
+    if (!text)
+        return null;
+    const metadata = {
+        URL: first.url || inputUrl,
+    };
+    if (first.author)
+        metadata.Author = first.author;
+    if (first.publishedDate)
+        metadata.Published = first.publishedDate;
+    if (response.requestId)
+        metadata.ExaRequestId = response.requestId;
+    if (first.id)
+        metadata.ExaId = first.id;
+    return {
+        kind: "text",
+        contentType: "text/markdown",
+        title: first.title || first.url || inputUrl,
+        text,
+        metadata,
+    };
+}
+const exaFetchProvider = {
+    id: "exa",
+    requiresApiKey: true,
+    async fetch(url, context) {
+        const apiKey = getApiKey(context, "exa");
+        if (!apiKey) {
+            throw new Error("Exa fetch requires an API key. Configure it in Settings > Web > API Keys.");
+        }
+        const endpoint = "https://api.exa.ai/contents";
+        const body = {
+            urls: [url],
+            text: true,
+        };
+        const resp = await fetchWithProxy(endpoint, context.proxyUrl, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "x-api-key": apiKey,
+            },
+            body: JSON.stringify(body),
+        });
+        if (resp.ok) {
+            const json = (await resp.json());
+            const parsed = toExaTextResult(url, json);
+            if (parsed)
+                return parsed;
+            return basicFetchProvider.fetch(url, context);
+        }
+        if (resp.status === 401 || resp.status === 403) {
+            throw new Error(`Exa fetch failed: ${resp.status} ${resp.statusText}`);
+        }
+        return basicFetchProvider.fetch(url, context);
+    },
+};
+const PROVIDERS = {
+    basic: basicFetchProvider,
+    exa: exaFetchProvider,
+};
+export function listFetchProviders() {
+    return Object.keys(PROVIDERS);
+}
+export function getFetchProvider(providerId) {
+    if (!providerId)
+        return basicFetchProvider;
+    return PROVIDERS[providerId] || basicFetchProvider;
+}
+export async function fetchWeb(url, context = {}, providerId) {
+    const provider = getFetchProvider(providerId);
+    return provider.fetch(url, context);
+}
+//# sourceMappingURL=fetch.js.map

package/dist/web/fetch.js.map

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

package/dist/web/search.d.ts

@@ -0,0 +1,9 @@
+import type { ImageSearchOptions, ImageSearchResult, SearchOptions, SearchProvider, SearchResult, WebContext } from "./types";
+export declare function listSearchProviders(): {
+    id: string;
+    label: string;
+}[];
+export declare function getSearchProvider(providerId?: string): SearchProvider;
+export declare function searchWeb(query: string, options?: SearchOptions, context?: WebContext, providerId?: string): Promise<SearchResult[]>;
+export declare function searchImages(query: string, options?: ImageSearchOptions, context?: WebContext): Promise<ImageSearchResult[]>;
+//# sourceMappingURL=search.d.ts.map

package/dist/web/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/web/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,UAAU,EACX,MAAM,SAAS,CAAC;AA2PjB,wBAAgB,mBAAmB,IAAI;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAKrE;AAED,wBAAgB,iBAAiB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,cAAc,CAGrE;AAED,wBAAsB,SAAS,CAC7B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,aAAkB,EAC3B,OAAO,GAAE,UAAe,EACxB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,YAAY,EAAE,CAAC,CAGzB;AAED,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,kBAAuB,EAChC,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAkE9B"}

package/dist/web/search.js

@@ -0,0 +1,238 @@
+function parseHTML(html) {
+    return new DOMParser().parseFromString(html, "text/html");
+}
+function textOf(el) {
+    return (el?.textContent ?? "").replace(/\s+/g, " ").trim();
+}
+function getApiKey(context, providerId) {
+    return context.apiKeys?.[providerId];
+}
+async function fetchWithProxy(url, context, init) {
+    if (context.proxyUrl) {
+        try {
+            return await fetch(`${context.proxyUrl}/?url=${encodeURIComponent(url)}`, init);
+        }
+        catch (err) {
+            throw new Error(`CORS proxy search failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    try {
+        return await fetch(url, init);
+    }
+    catch {
+        throw new Error("Search blocked by CORS and no CORS proxy is configured. Enable the CORS proxy in Settings.");
+    }
+}
+const ddgsProvider = {
+    id: "ddgs",
+    async search(query, options, context) {
+        const { region = "us-en", timelimit, maxResults = 10, page = 1 } = options;
+        const body = new URLSearchParams({ q: query, l: region, b: "" });
+        if (page > 1)
+            body.set("s", String(10 + (page - 2) * 15));
+        if (timelimit)
+            body.set("df", timelimit);
+        const target = "https://html.duckduckgo.com/html/";
+        const resp = await fetchWithProxy(target, context, {
+            method: "POST",
+            headers: { "Content-Type": "application/x-www-form-urlencoded" },
+            body: body.toString(),
+        });
+        if (!resp.ok)
+            throw new Error(`Search failed: ${resp.status}`);
+        const doc = parseHTML(await resp.text());
+        if (doc.querySelector(".anomaly-modal, #challenge-form")) {
+            throw new Error("DuckDuckGo is rate-limiting requests (bot challenge). Try again later or use a different CORS proxy.");
+        }
+        const results = [];
+        for (const item of doc.querySelectorAll(".result")) {
+            const titleEl = item.querySelector(".result__title a, .result__a");
+            const bodyEl = item.querySelector(".result__snippet");
+            let href = titleEl?.getAttribute("href") ?? "";
+            if (!href || href.includes("duckduckgo.com/y.js"))
+                continue;
+            if (href.startsWith("//"))
+                href = `https:${href}`;
+            results.push({
+                title: textOf(titleEl),
+                href,
+                body: textOf(bodyEl),
+            });
+            if (results.length >= maxResults)
+                break;
+        }
+        return results;
+    },
+};
+const braveProvider = {
+    id: "brave",
+    requiresApiKey: true,
+    async search(query, options, context) {
+        const apiKey = getApiKey(context, "brave");
+        if (!apiKey) {
+            throw new Error("Brave search requires an API key. Configure it in Settings > Web > API Keys.");
+        }
+        const maxResults = options.maxResults ?? 10;
+        const offset = ((options.page ?? 1) - 1) * maxResults;
+        const country = options.region?.split("-")[0]?.toUpperCase() || "US";
+        const url = new URL("https://api.search.brave.com/res/v1/web/search");
+        url.searchParams.set("q", query);
+        url.searchParams.set("count", String(maxResults));
+        url.searchParams.set("offset", String(offset));
+        url.searchParams.set("country", country);
+        const resp = await fetchWithProxy(url.toString(), context, {
+            headers: {
+                Accept: "application/json",
+                "X-Subscription-Token": apiKey,
+            },
+        });
+        if (!resp.ok) {
+            throw new Error(`Brave search failed: ${resp.status} ${resp.statusText}`);
+        }
+        const data = (await resp.json());
+        return (data.web?.results || []).map((r) => ({
+            title: r.title || "",
+            href: r.url || "",
+            body: r.description || "",
+        }));
+    },
+};
+const serperProvider = {
+    id: "serper",
+    requiresApiKey: true,
+    async search(query, options, context) {
+        const apiKey = getApiKey(context, "serper");
+        if (!apiKey) {
+            throw new Error("Serper search requires an API key. Configure it in Settings > Web > API Keys.");
+        }
+        const [countryRaw, languageRaw] = (options.region || "us-en").split("-");
+        const country = countryRaw?.toLowerCase() || "us";
+        const language = languageRaw?.toLowerCase() || "en";
+        const body = {
+            q: query,
+            num: options.maxResults ?? 10,
+            page: options.page ?? 1,
+            gl: country,
+            hl: language,
+        };
+        if (options.timelimit)
+            body.tbs = `qdr:${options.timelimit}`;
+        const endpoint = "https://google.serper.dev/search";
+        const resp = await fetchWithProxy(endpoint, context, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "X-API-KEY": apiKey,
+            },
+            body: JSON.stringify(body),
+        });
+        if (!resp.ok) {
+            throw new Error(`Serper search failed: ${resp.status} ${resp.statusText}`);
+        }
+        const data = (await resp.json());
+        return (data.organic || []).map((r) => ({
+            title: r.title || "",
+            href: r.link || "",
+            body: r.snippet || "",
+        }));
+    },
+};
+const exaProvider = {
+    id: "exa",
+    requiresApiKey: true,
+    async search(query, options, context) {
+        const apiKey = getApiKey(context, "exa");
+        if (!apiKey) {
+            throw new Error("Exa search requires an API key. Configure it in Settings > Web > API Keys.");
+        }
+        const body = {
+            query,
+            numResults: options.maxResults ?? 10,
+            type: "auto",
+        };
+        const targetUrl = "https://api.exa.ai/search";
+        const resp = await fetchWithProxy(targetUrl, context, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "x-api-key": apiKey,
+            },
+            body: JSON.stringify(body),
+        });
+        if (!resp.ok) {
+            throw new Error(`Exa search failed: ${resp.status} ${resp.statusText}`);
+        }
+        const data = (await resp.json());
+        return (data.results || []).map((r) => ({
+            title: r.title || "",
+            href: r.url || "",
+            body: r.text || "",
+        }));
+    },
+};
+const PROVIDERS = {
+    ddgs: ddgsProvider,
+    brave: braveProvider,
+    serper: serperProvider,
+    exa: exaProvider,
+};
+const PROVIDER_LABELS = {
+    ddgs: "ddgs (free, easily rate limited)",
+};
+export function listSearchProviders() {
+    return Object.keys(PROVIDERS).map((id) => ({
+        id,
+        label: PROVIDER_LABELS[id] ?? id,
+    }));
+}
+export function getSearchProvider(providerId) {
+    if (!providerId)
+        return ddgsProvider;
+    return PROVIDERS[providerId] || ddgsProvider;
+}
+export async function searchWeb(query, options = {}, context = {}, providerId) {
+    const provider = getSearchProvider(providerId);
+    return provider.search(query, options, context);
+}
+export async function searchImages(query, options = {}, context = {}) {
+    const apiKey = getApiKey(context, "serper");
+    if (!apiKey) {
+        throw new Error("Image search requires a Serper API key. Configure it in Settings > Web > API Keys.");
+    }
+    const body = { q: query };
+    if (options.num)
+        body.num = options.num;
+    if (options.page)
+        body.page = options.page;
+    if (options.gl)
+        body.gl = options.gl;
+    if (options.hl)
+        body.hl = options.hl;
+    const endpoint = "https://google.serper.dev/images";
+    const resp = await fetchWithProxy(endpoint, context, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "X-API-KEY": apiKey,
+        },
+        body: JSON.stringify(body),
+    });
+    if (!resp.ok) {
+        throw new Error(`Serper image search failed: ${resp.status} ${resp.statusText}`);
+    }
+    const data = (await resp.json());
+    return (data.images || []).map((img, i) => ({
+        title: img.title || "",
+        imageUrl: img.imageUrl || "",
+        imageWidth: img.imageWidth || 0,
+        imageHeight: img.imageHeight || 0,
+        thumbnailUrl: img.thumbnailUrl || "",
+        thumbnailWidth: img.thumbnailWidth || 0,
+        thumbnailHeight: img.thumbnailHeight || 0,
+        source: img.source || "",
+        domain: img.domain || "",
+        link: img.link || "",
+        position: img.position || i + 1,
+    }));
+}
+//# sourceMappingURL=search.js.map

package/dist/web/search.js.map

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

package/dist/web/types.d.ts

@@ -0,0 +1,56 @@
+export interface SearchResult {
+    title: string;
+    href: string;
+    body: string;
+}
+export interface SearchOptions {
+    region?: string;
+    timelimit?: "d" | "w" | "m" | "y";
+    maxResults?: number;
+    page?: number;
+}
+export interface WebContext {
+    proxyUrl?: string;
+    apiKeys?: Record<string, string | undefined>;
+}
+export interface SearchProvider {
+    id: string;
+    requiresApiKey?: boolean;
+    search: (query: string, options: SearchOptions, context: WebContext) => Promise<SearchResult[]>;
+}
+export type FetchResult = {
+    kind: "text";
+    contentType: string;
+    text: string;
+    title?: string;
+    metadata?: Record<string, string>;
+} | {
+    kind: "binary";
+    contentType: string;
+    data: Uint8Array;
+};
+export interface ImageSearchResult {
+    title: string;
+    imageUrl: string;
+    imageWidth: number;
+    imageHeight: number;
+    thumbnailUrl: string;
+    thumbnailWidth: number;
+    thumbnailHeight: number;
+    source: string;
+    domain: string;
+    link: string;
+    position: number;
+}
+export interface ImageSearchOptions {
+    num?: number;
+    page?: number;
+    gl?: string;
+    hl?: string;
+}
+export interface FetchProvider {
+    id: string;
+    requiresApiKey?: boolean;
+    fetch: (url: string, context: WebContext) => Promise<FetchResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/web/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/web/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,CACN,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,UAAU,KAChB,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CAC9B;AAED,MAAM,MAAM,WAAW,GACnB;IACE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,UAAU,CAAC;CAClB,CAAC;AAEN,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;CACnE"}

package/dist/web/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/web/types.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@office-agents/sdk",
+  "version": "0.0.1",
+  "type": "module",
+  "description": "Headless SDK for Office Agents — agent runtime, tools, storage, VFS, skills, OAuth, and provider config for building AI-powered Office Add-ins",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@mariozechner/pi-agent-core": "^0.54.0",
+    "@mariozechner/pi-ai": "^0.54.0",
+    "@mozilla/readability": "^0.6.0",
+    "@sinclair/typebox": "^0.34.48",
+    "@types/turndown": "^5.0.6",
+    "idb": "^8.0.3",
+    "just-bash": "^2.7.0",
+    "mammoth": "^1.11.0",
+    "pdfjs-dist": "^5.4.624",
+    "ses": "^1.14.0",
+    "turndown": "^7.2.2",
+    "xlsx": "^0.18.5"
+  },
+  "peerDependencies": {
+    "@types/office-js": ">=1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@types/office-js": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/office-js": "^1.0.377"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "clean": "rm -rf dist"
+  }
+}