@superblocksteam/vite-plugin-file-sync 1.99.99-next.2 → 2.0.0-SNAPSHOT.2143e2e95d0107ab

package/dist/ai-service/app-skills/manager.js

@@ -0,0 +1,259 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { getLogger } from "../../util/logger.js";
+import { LLMObsTracer } from "../llmobs/tracer.js";
+import { factNameToFileName, parseSkillFile, serializeSkillFile, } from "./parser.js";
+/** Relative path from the app root where app skill facts are stored */
+const APP_SKILLS_RELATIVE_DIR = "skills/app";
+/** Virtual path prefix shown to the user/UI */
+const VIRTUAL_PATH_PREFIX = ".superblocks/skills/app";
+function escapeXml(value) {
+    return value
+        .replaceAll("&", "&")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("'", "&apos;");
+}
+/**
+ * Manages reading and writing app skill fact files on disk.
+ *
+ * Facts are stored as markdown files with YAML frontmatter in
+ * `<appRootDirPath>/skills/app/*.md`.
+ */
+export class AppSkillsManager {
+    appRootDirPath;
+    tracer;
+    constructor(appRootDirPath, tracer = LLMObsTracer.instance) {
+        this.appRootDirPath = appRootDirPath;
+        this.tracer = tracer;
+    }
+    get skillsDir() {
+        return path.join(this.appRootDirPath, APP_SKILLS_RELATIVE_DIR);
+    }
+    toVirtualPath(absolutePath) {
+        const fileName = path.basename(absolutePath);
+        return `${VIRTUAL_PATH_PREFIX}/${fileName}`;
+    }
+    fromVirtualPath(virtualPath) {
+        const fileName = path.basename(virtualPath);
+        return path.join(this.skillsDir, fileName);
+    }
+    /**
+     * Load all facts from disk. Returns an empty array if the directory doesn't exist.
+     */
+    async loadFacts() {
+        let entries;
+        try {
+            entries = await fs.readdir(this.skillsDir);
+        }
+        catch (err) {
+            if (err.code === "ENOENT") {
+                return [];
+            }
+            throw err;
+        }
+        const facts = [];
+        for (const entry of entries) {
+            if (!entry.endsWith(".md"))
+                continue;
+            const absolutePath = path.join(this.skillsDir, entry);
+            try {
+                const raw = await fs.readFile(absolutePath, "utf-8");
+                const parsed = parseSkillFile(raw);
+                if (parsed) {
+                    facts.push({ ...parsed, path: this.toVirtualPath(absolutePath) });
+                }
+            }
+            catch (error) {
+                getLogger().warn({ absolutePath, error }, "Failed to read or parse skill file");
+            }
+        }
+        // Sort by createdAt ascending (oldest first)
+        facts.sort((a, b) => {
+            if (a.createdAt && b.createdAt) {
+                return a.createdAt.localeCompare(b.createdAt);
+            }
+            return 0;
+        });
+        return facts;
+    }
+    /**
+     * Convert loaded AppSkillFact array to AiAppFact array for the UI.
+     */
+    static toAiAppFacts(facts) {
+        return facts.map((f) => ({
+            path: f.path,
+            name: f.name,
+            description: f.description,
+            content: f.content,
+            accessType: f.accessType,
+            isEnabled: f.isEnabled,
+            createdAt: f.createdAt,
+        }));
+    }
+    /**
+     * Find a fact by display name (case-insensitive).
+     */
+    async findFactByName(name) {
+        const normalizedName = name.trim().toLowerCase();
+        if (!normalizedName) {
+            return undefined;
+        }
+        const facts = await this.loadFacts();
+        return facts.find((fact) => fact.name.trim().toLowerCase() === normalizedName);
+    }
+    /**
+     * Save a new fact to disk. If a fact with the same name already exists, it will be overwritten.
+     */
+    async saveFact(fact) {
+        await fs.mkdir(this.skillsDir, { recursive: true });
+        const createdAt = new Date().toISOString();
+        const fileName = `${factNameToFileName(fact.name)}.md`;
+        const absolutePath = path.join(this.skillsDir, fileName);
+        const parsed = {
+            name: fact.name,
+            description: fact.description,
+            content: fact.content,
+            accessType: "on_demand",
+            isEnabled: fact.isEnabled !== false,
+            createdAt,
+        };
+        await fs.writeFile(absolutePath, serializeSkillFile(parsed), "utf-8");
+        return {
+            ...parsed,
+            path: this.toVirtualPath(absolutePath),
+        };
+    }
+    /**
+     * Update an existing fact by its virtual path.
+     */
+    async updateFact(virtualPath, updates) {
+        const absolutePath = this.fromVirtualPath(virtualPath);
+        const raw = await fs.readFile(absolutePath, "utf-8");
+        const parsed = parseSkillFile(raw);
+        if (!parsed) {
+            throw new Error(`Could not parse fact file at ${virtualPath}`);
+        }
+        const updated = {
+            ...parsed,
+            name: updates.name,
+            description: updates.description,
+            content: updates.content,
+        };
+        await fs.writeFile(absolutePath, serializeSkillFile(updated), "utf-8");
+        return {
+            ...updated,
+            path: virtualPath,
+        };
+    }
+    /**
+     * Delete a fact file by its virtual path.
+     */
+    async deleteFact(virtualPath) {
+        const absolutePath = this.fromVirtualPath(virtualPath);
+        try {
+            await fs.unlink(absolutePath);
+        }
+        catch (err) {
+            if (err.code === "ENOENT") {
+                // Already gone — not an error
+                return;
+            }
+            throw err;
+        }
+    }
+    /**
+     * Toggle the isEnabled field of a fact by its virtual path.
+     * Returns the updated AiAppFact.
+     */
+    async toggleFact(virtualPath, isEnabled) {
+        const absolutePath = this.fromVirtualPath(virtualPath);
+        const raw = await fs.readFile(absolutePath, "utf-8");
+        const parsed = parseSkillFile(raw);
+        if (!parsed) {
+            throw new Error(`Could not parse fact file at ${virtualPath}`);
+        }
+        const updated = { ...parsed, isEnabled };
+        await fs.writeFile(absolutePath, serializeSkillFile(updated), "utf-8");
+        return {
+            ...updated,
+            path: virtualPath,
+        };
+    }
+    /**
+     * Load facts and format them for injection into the system prompt.
+     * Only includes facts where isEnabled=true AND accessType="always".
+     * Facts with accessType="on_demand" are listed by path but not auto-injected.
+     */
+    async loadFactsForPrompt() {
+        return (await this.loadFactsForPromptBundle()).section;
+    }
+    async loadFactsForPromptBundle() {
+        return this.tracer.trace({ kind: "task", name: "app_skills.load" }, (span) => this.loadAndFormatFactsForPrompt(span));
+    }
+    async loadAndFormatFactsForPrompt(span) {
+        const startedAt = performance.now();
+        const facts = await this.loadFacts();
+        this.tracer.annotate(span, {
+            metadata: {
+                durationMs: Math.round(performance.now() - startedAt),
+                factCount: facts.length,
+            },
+        });
+        const alwaysOn = facts.filter((f) => f.isEnabled && f.accessType === "always");
+        const onDemand = facts.filter((f) => f.isEnabled && f.accessType === "on_demand");
+        if (alwaysOn.length === 0 && onDemand.length === 0) {
+            return {
+                alwaysInjectDedupeKeys: [],
+                onDemandIndexCount: 0,
+                section: "",
+            };
+        }
+        const sections = [];
+        if (alwaysOn.length > 0) {
+            const items = alwaysOn
+                .map((f) => `### ${f.name}
+${f.description ? `${f.description}\n\n` : ""}${f.content}`)
+                .join("\n\n");
+            sections.push(`<app_knowledge>
+## App-Specific Knowledge
+
+The following knowledge entries were explicitly saved by the user for this application. They are MANDATORY on every turn and override general defaults.
+
+**You MUST:**
+- Apply every enabled app knowledge entry regardless of what the task is
+- Treat them as authoritative user-defined requirements, not optional hints
+- If a knowledge entry specifies a pattern, style, or constraint: follow it without exception
+- These take precedence over your general defaults, but never over safety guidelines
+
+${items}
+</app_knowledge>`);
+        }
+        if (onDemand.length > 0) {
+            const items = onDemand
+                .map((f) => {
+                const location = `${APP_SKILLS_RELATIVE_DIR}/${path.basename(f.path)}`;
+                return `  <knowledge type="app">
+    <name>${escapeXml(f.name)}</name>
+    <description>${escapeXml(f.description)}</description>
+    <location>${escapeXml(location)}</location>
+  </knowledge>`;
+            })
+                .join("\n");
+            sections.push(`<app_knowledge_index>
+## Available App-Specific Knowledge
+
+These app-specific knowledge files are saved by the user for this application. Before implementing, review the entries below and use \`build_readFile <location>\` to load any entry relevant to the current task.
+
+${items}
+</app_knowledge_index>`);
+        }
+        return {
+            alwaysInjectDedupeKeys: alwaysOn.map((fact) => `${APP_SKILLS_RELATIVE_DIR}/${path.basename(fact.path)}`),
+            onDemandIndexCount: onDemand.length,
+            section: sections.join("\n\n"),
+        };
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/ai-service/app-skills/manager.js.map

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

package/dist/ai-service/app-skills/parser.d.ts

@@ -0,0 +1,53 @@
+/**
+ * The frontmatter fields stored in each app skill fact file.
+ */
+export type ParsedSkillFileFrontmatter = {
+    name: string;
+    description: string;
+    /**
+     * "always"    — injected into every system prompt automatically.
+     * "on_demand" — only injected when Clark explicitly retrieves it (default for new facts).
+     */
+    accessType: "always" | "on_demand";
+    isEnabled: boolean;
+    createdAt?: string;
+};
+/**
+ * A parsed app skill fact: frontmatter + body content.
+ */
+export type ParsedSkillFile = ParsedSkillFileFrontmatter & {
+    /** The markdown body below the frontmatter */
+    content: string;
+};
+/**
+ * A loaded app skill fact with its disk path.
+ */
+export type AppSkillFact = ParsedSkillFile & {
+    path: string;
+};
+/**
+ * Parse a markdown file that has YAML frontmatter.
+ *
+ * Expected format:
+ * ```
+ * ---
+ * name: "..."
+ * description: "..."
+ * accessType: always
+ * isEnabled: true
+ * createdAt: "..."
+ * ---
+ *
+ * The body content goes here.
+ * ```
+ */
+export declare function parseSkillFile(raw: string): ParsedSkillFile | null;
+/**
+ * Serialize a skill fact back to a markdown file string with YAML frontmatter.
+ */
+export declare function serializeSkillFile(fact: ParsedSkillFile): string;
+/**
+ * Convert a fact name to a safe file name (kebab-case, no special chars).
+ */
+export declare function factNameToFileName(name: string): string;
+//# sourceMappingURL=parser.d.ts.map

package/dist/ai-service/app-skills/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/ai-service/app-skills/parser.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,UAAU,EAAE,QAAQ,GAAG,WAAW,CAAC;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,0BAA0B,GAAG;IACzD,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,eAAe,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAI9D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CA0ClE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAahE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQvD"}

package/dist/ai-service/app-skills/parser.js

@@ -0,0 +1,82 @@
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+const FRONTMATTER_DELIMITER = "---";
+/**
+ * Parse a markdown file that has YAML frontmatter.
+ *
+ * Expected format:
+ * ```
+ * ---
+ * name: "..."
+ * description: "..."
+ * accessType: always
+ * isEnabled: true
+ * createdAt: "..."
+ * ---
+ *
+ * The body content goes here.
+ * ```
+ */
+export function parseSkillFile(raw) {
+    const trimmed = raw.trimStart();
+    if (!trimmed.startsWith(FRONTMATTER_DELIMITER)) {
+        return null;
+    }
+    const afterFirstDelimiter = trimmed.slice(FRONTMATTER_DELIMITER.length);
+    const endIndex = afterFirstDelimiter.indexOf(`\n${FRONTMATTER_DELIMITER}`);
+    if (endIndex === -1) {
+        return null;
+    }
+    const yamlStr = afterFirstDelimiter.slice(0, endIndex).trim();
+    const content = afterFirstDelimiter
+        .slice(endIndex + FRONTMATTER_DELIMITER.length + 1)
+        .trimStart();
+    let frontmatter;
+    try {
+        frontmatter = parseYaml(yamlStr) ?? {};
+    }
+    catch {
+        return null;
+    }
+    if (typeof frontmatter.name !== "string" || !frontmatter.name) {
+        return null;
+    }
+    return {
+        name: frontmatter.name,
+        description: typeof frontmatter.description === "string"
+            ? frontmatter.description
+            : "",
+        accessType: frontmatter.accessType === "always" ? "always" : "on_demand",
+        isEnabled: frontmatter.isEnabled !== false,
+        createdAt: typeof frontmatter.createdAt === "string"
+            ? frontmatter.createdAt
+            : undefined,
+        content,
+    };
+}
+/**
+ * Serialize a skill fact back to a markdown file string with YAML frontmatter.
+ */
+export function serializeSkillFile(fact) {
+    const frontmatter = {
+        name: fact.name,
+        description: fact.description,
+        accessType: fact.accessType,
+        isEnabled: fact.isEnabled,
+    };
+    if (fact.createdAt) {
+        frontmatter.createdAt = fact.createdAt;
+    }
+    const yamlStr = stringifyYaml(frontmatter).trimEnd();
+    return `---\n${yamlStr}\n---\n\n${fact.content}\n`;
+}
+/**
+ * Convert a fact name to a safe file name (kebab-case, no special chars).
+ */
+export function factNameToFileName(name) {
+    return (name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 60) || "fact");
+}
+//# sourceMappingURL=parser.js.map

package/dist/ai-service/app-skills/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../src/ai-service/app-skills/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AA8BtE,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAEpC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC;IAChC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,qBAAqB,CAAC,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,mBAAmB,GAAG,OAAO,CAAC,KAAK,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACxE,MAAM,QAAQ,GAAG,mBAAmB,CAAC,OAAO,CAAC,KAAK,qBAAqB,EAAE,CAAC,CAAC;IAC3E,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9D,MAAM,OAAO,GAAG,mBAAmB;SAChC,KAAK,CAAC,QAAQ,GAAG,qBAAqB,CAAC,MAAM,GAAG,CAAC,CAAC;SAClD,SAAS,EAAE,CAAC;IAEf,IAAI,WAAoC,CAAC;IACzC,IAAI,CAAC;QACH,WAAW,GAAI,SAAS,CAAC,OAAO,CAA6B,IAAI,EAAE,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,OAAO,WAAW,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAC9D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,WAAW,EACT,OAAO,WAAW,CAAC,WAAW,KAAK,QAAQ;YACzC,CAAC,CAAC,WAAW,CAAC,WAAW;YACzB,CAAC,CAAC,EAAE;QACR,UAAU,EAAE,WAAW,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW;QACxE,SAAS,EAAE,WAAW,CAAC,SAAS,KAAK,KAAK;QAC1C,SAAS,EACP,OAAO,WAAW,CAAC,SAAS,KAAK,QAAQ;YACvC,CAAC,CAAC,WAAW,CAAC,SAAS;YACvB,CAAC,CAAC,SAAS;QACf,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAqB;IACtD,MAAM,WAAW,GAA4B;QAC3C,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAC;IACF,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,WAAW,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IACzC,CAAC;IAED,MAAM,OAAO,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC;IACrD,OAAO,QAAQ,OAAO,YAAY,IAAI,CAAC,OAAO,IAAI,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,CACL,IAAI;SACD,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,MAAM,CAC1B,CAAC;AACJ,CAAC"}

package/dist/ai-service/attachment-upload.d.ts

@@ -0,0 +1,33 @@
+import { type AttachmentUploadMetadata } from "@superblocksteam/shared";
+import type { Logger } from "../util/logger.js";
+interface AttachmentUploadResult {
+    fileName: string;
+    url: string;
+    expirationDate: number;
+    mimeType?: string;
+    storageKey?: string;
+    scopeType?: "org" | "app";
+    applicationId?: string;
+}
+/**
+ * Uploads a file to Bucketeer's generic attachments endpoint.
+ */
+export declare function uploadAttachmentToBucketeer({ applicationId, file, fileName, prefix, metadata, branchId, commitId, useServerUpload, superblocksBaseUrl, jwt, logger, }: {
+    applicationId: string;
+    file: File | Blob | {
+        data: string;
+        mimeType: string;
+        name?: string;
+    };
+    fileName?: string;
+    prefix?: string;
+    metadata?: AttachmentUploadMetadata;
+    branchId?: string;
+    commitId?: string;
+    useServerUpload?: boolean;
+    superblocksBaseUrl: string;
+    jwt: string;
+    logger: Logger;
+}): Promise<AttachmentUploadResult>;
+export {};
+//# sourceMappingURL=attachment-upload.d.ts.map

package/dist/ai-service/attachment-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-upload.d.ts","sourceRoot":"","sources":["../../src/ai-service/attachment-upload.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,wBAAwB,EAC9B,MAAM,yBAAyB,CAAC;AAIjC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGhD,UAAU,sBAAsB;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAAC,EAChD,aAAa,EACb,IAAI,EACJ,QAAQ,EACR,MAA6B,EAC7B,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,eAAuB,EACvB,kBAAkB,EAClB,GAAG,EACH,MAAM,GACP,EAAE;IACD,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAiHlC"}

package/dist/ai-service/attachment-upload.js

@@ -0,0 +1,98 @@
+import { buildAttachmentUploadFormData, isUserFacingUploadError, toAttachmentUploadDescriptor, uploadAttachmentToServerApi, } from "@superblocksteam/shared";
+import { getBucketeerUrlFromSuperblocksUrl } from "@superblocksteam/util";
+import { getErrorMeta } from "../util/logger.js";
+import { getScopedToken } from "./util/scoped-token-utils.js";
+/**
+ * Uploads a file to Bucketeer's generic attachments endpoint.
+ */
+export async function uploadAttachmentToBucketeer({ applicationId, file, fileName, prefix = "message-attachment", metadata, branchId, commitId, useServerUpload = false, superblocksBaseUrl, jwt, logger, }) {
+    const descriptor = toAttachmentUploadDescriptor(file, {
+        fallbackFileName: fileName,
+    });
+    if (!descriptor) {
+        throw new Error("Unsupported attachment upload input");
+    }
+    const buildFormData = () => {
+        return buildAttachmentUploadFormData({
+            descriptor,
+            prefix,
+            metadata,
+            branchId,
+            commitId,
+        });
+    };
+    const uploadViaServer = async () => {
+        const payload = await uploadAttachmentToServerApi({
+            baseUrl: superblocksBaseUrl,
+            authorization: `Bearer ${jwt}`,
+            descriptor,
+            scopeType: "app",
+            purpose: "attachment",
+            applicationId,
+            branchName: branchId,
+            commitId,
+            prefix,
+            metadata,
+        });
+        return {
+            fileName: payload.fileName || descriptor.fileName,
+            url: payload.contentUrl ?? payload.signedUrl,
+            expirationDate: Math.floor(new Date(payload.signedUrlExpiresAt).getTime() / 1000),
+            mimeType: (typeof payload.mimeType === "string" && payload.mimeType.trim()) ||
+                descriptor.mimeType,
+            storageKey: payload.storageKey,
+            scopeType: payload.scopeType,
+            applicationId: payload.applicationId,
+        };
+    };
+    const uploadViaBucketeer = async () => {
+        let scopedToken;
+        try {
+            scopedToken = await getScopedToken({
+                applicationId,
+                superblocksBaseUrl,
+                jwt,
+            });
+        }
+        catch (error) {
+            logger.error("[uploadAttachmentToBucketeer] Failed to get scoped token", getErrorMeta(error));
+            throw error;
+        }
+        const bucketeerUrl = getBucketeerUrlFromSuperblocksUrl(superblocksBaseUrl);
+        const uploadUrl = `${bucketeerUrl}/applications/${applicationId}/attachments`;
+        const response = await fetch(uploadUrl, {
+            method: "POST",
+            body: buildFormData(),
+            headers: {
+                Authorization: `Bearer ${scopedToken}`,
+            },
+        });
+        if (!response.ok) {
+            const errorText = await response
+                .text()
+                .catch(() => "Unable to read error response");
+            logger.error(`[uploadAttachmentToBucketeer] Upload failed: status=${response.status}, error=${errorText}`);
+            throw new Error(`Attachment upload failed: ${response.statusText}`);
+        }
+        const result = (await response.json());
+        return {
+            fileName: result.fileName || descriptor.fileName,
+            url: result.url,
+            expirationDate: result.expirationDate,
+            mimeType: descriptor.mimeType,
+        };
+    };
+    if (useServerUpload) {
+        try {
+            return await uploadViaServer();
+        }
+        catch (error) {
+            if (isUserFacingUploadError(error)) {
+                throw error;
+            }
+            logger.warn("[uploadAttachmentToBucketeer] Server upload failed, falling back to Bucketeer", getErrorMeta(error));
+        }
+    }
+    return uploadViaBucketeer();
+}
+//# sourceMappingURL=attachment-upload.js.map

package/dist/ai-service/attachment-upload.js.map

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

package/dist/ai-service/attachments/index.d.ts

@@ -0,0 +1,2 @@
+export { AttachmentsStore } from "./store.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/ai-service/attachments/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai-service/attachments/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/ai-service/attachments/index.js

@@ -0,0 +1,2 @@
+export { AttachmentsStore } from "./store.js";
+//# sourceMappingURL=index.js.map

package/dist/ai-service/attachments/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ai-service/attachments/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/ai-service/attachments/parse-data-url.d.ts

@@ -0,0 +1,5 @@
+export declare function parseDataUrl(dataUrl: string): {
+    mediaType: string;
+    data: string;
+} | null;
+//# sourceMappingURL=parse-data-url.d.ts.map

package/dist/ai-service/attachments/parse-data-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-data-url.d.ts","sourceRoot":"","sources":["../../../src/ai-service/attachments/parse-data-url.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,GACd;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAa5C"}

package/dist/ai-service/attachments/parse-data-url.js

@@ -0,0 +1,14 @@
+export function parseDataUrl(dataUrl) {
+    // Match only the header so large attachments never enter a payload capture.
+    const header = /^data:([^;]+);base64,/.exec(dataUrl);
+    if (!header?.[1]) {
+        return null;
+    }
+    const data = dataUrl.slice(header[0].length);
+    // Preserve the former nonempty, single-line payload contract.
+    if (!data || /[\r\n\u2028\u2029]/.test(data)) {
+        return null;
+    }
+    return { mediaType: header[1], data };
+}
+//# sourceMappingURL=parse-data-url.js.map

package/dist/ai-service/attachments/parse-data-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-data-url.js","sourceRoot":"","sources":["../../../src/ai-service/attachments/parse-data-url.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CAC1B,OAAe;IAEf,4EAA4E;IAC5E,MAAM,MAAM,GAAG,uBAAuB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC7C,8DAA8D;IAC9D,IAAI,CAAC,IAAI,IAAI,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;AACxC,CAAC"}