veryfront 0.1.215 → 0.1.217

package/esm/cli/commands/knowledge/command-helpers.d.ts

@@ -0,0 +1,48 @@
+import type { KnowledgeIngestFailedFileResult, KnowledgeIngestFileResult, KnowledgeIngestSkippedFileResult } from "./result.js";
+export type KnowledgeSource = {
+    kind: "local";
+    input: string;
+    localPath: string;
+} | {
+    kind: "upload";
+    input: string;
+    uploadPath: string;
+    localPath: string;
+};
+export interface KnowledgeSourceCollection {
+    sources: KnowledgeSource[];
+    skipped: KnowledgeIngestSkippedFileResult[];
+}
+export declare function normalizeKnowledgeInputPath(inputPath: string): string;
+export declare function normalizeProjectUploadPath(inputPath: string): string;
+export declare function formatKnowledgeUploadSource(uploadPath: string): string;
+export declare function resolveExplicitUploadPath(inputPath: string): string;
+export declare function isLikelyLocalPath(value: string): boolean;
+export declare function isProjectUploadReference(value: string): boolean;
+export declare function stripChatUploadPrefix(name: string): string;
+export declare function resolveKnowledgeDownloadOutputDir(outputDir: string): string;
+export declare function createFailedKnowledgeSource(input: {
+    source: string;
+    localSourcePath: string;
+    message: string;
+    reason: KnowledgeIngestFailedFileResult["reason"];
+}): KnowledgeIngestFailedFileResult;
+export declare function collectLocalFiles(root: string, recursive: boolean): Promise<KnowledgeSourceCollection>;
+export declare function buildSourceReference(source: KnowledgeSource): string;
+export declare function buildSuggestedSlug(source: KnowledgeSource, index: number): string;
+export declare function ensureUniqueSlugs(sources: KnowledgeSource[]): string[];
+export declare function deriveKnowledgeRemotePath(outputPath: string, outputDir: string, knowledgePath: string): string;
+export declare function createKnowledgeIngestResult(input: {
+    source: string;
+    localSourcePath: string;
+    outputPath: string;
+    remotePath: string;
+    parser: {
+        slug: string;
+        stats: Record<string, unknown>;
+        warnings: string[];
+        source_type: string;
+        summary: string;
+    };
+}): KnowledgeIngestFileResult;
+//# sourceMappingURL=command-helpers.d.ts.map

package/esm/cli/commands/knowledge/command-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-helpers.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/knowledge/command-helpers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,+BAA+B,EAC/B,yBAAyB,EACzB,gCAAgC,EACjC,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7E,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,OAAO,EAAE,gCAAgC,EAAE,CAAC;CAC7C;AASD,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAMrE;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAKtE;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAanE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGxD;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAI/D;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,iCAAiC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3E;AAgBD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,+BAA+B,CAAC,QAAQ,CAAC,CAAC;CACnD,GAAG,+BAA+B,CAOlC;AAmCD,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,OAAO,GACjB,OAAO,CAAC,yBAAyB,CAAC,CA8DpC;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAIpE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAgCjF;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,EAAE,CAQtE;AAED,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,GACpB,MAAM,CAQR;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,GAAG,yBAAyB,CAY5B"}

package/esm/cli/commands/knowledge/command-helpers.js

@@ -0,0 +1,216 @@
+import { createFileSystem } from "../../../src/platform/index.js";
+import { basename, extname, join, normalize, relative } from "../../../src/platform/compat/path/index.js";
+import { classifyKnowledgeDirectoryPath, classifyKnowledgeSourcePath } from "./source-policy.js";
+function slugify(value) {
+    return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "document";
+}
+const CHAT_UPLOAD_PREFIX_RE = /^chat-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}-\d+-[a-z0-9]+-/i;
+export function normalizeKnowledgeInputPath(inputPath) {
+    const normalizedPath = normalize(inputPath).replace(/^\/+/, "").replace(/\\/g, "/");
+    if (!normalizedPath || normalizedPath.startsWith("..") || normalizedPath.startsWith("/")) {
+        throw new Error(`Invalid knowledge input path: ${inputPath}`);
+    }
+    return normalizedPath;
+}
+export function normalizeProjectUploadPath(inputPath) {
+    return normalizeKnowledgeInputPath(inputPath);
+}
+export function formatKnowledgeUploadSource(uploadPath) {
+    const normalizedPath = normalizeKnowledgeInputPath(uploadPath);
+    return normalizedPath === "uploads" || normalizedPath.startsWith("uploads/")
+        ? normalizedPath
+        : `uploads/${normalizedPath}`;
+}
+export function resolveExplicitUploadPath(inputPath) {
+    const normalizedInput = normalizeKnowledgeInputPath(inputPath);
+    const displayInput = inputPath.replace(/\\/g, "/");
+    const uploadPath = normalizeProjectUploadPath(inputPath);
+    if (!uploadPath || uploadPath === "uploads" || normalizedInput === "uploads" ||
+        normalizedInput.endsWith("/")) {
+        throw new Error(`Directory upload references require --path <prefix> --all: ${displayInput}`);
+    }
+    return uploadPath;
+}
+export function isLikelyLocalPath(value) {
+    return value.startsWith("/") || value.startsWith("./") || value.startsWith("../") ||
+        /^[A-Za-z]:[\\/]/.test(value);
+}
+export function isProjectUploadReference(value) {
+    if (isLikelyLocalPath(value))
+        return false;
+    const normalizedValue = normalize(value).replace(/\\/g, "/").replace(/^\/+/, "");
+    return normalizedValue === "uploads" || normalizedValue.startsWith("uploads/");
+}
+export function stripChatUploadPrefix(name) {
+    return name.replace(CHAT_UPLOAD_PREFIX_RE, "");
+}
+export function resolveKnowledgeDownloadOutputDir(outputDir) {
+    return join(outputDir, ".uploads");
+}
+function createSkippedKnowledgeSource(input) {
+    return {
+        source: input.source,
+        localSourcePath: input.localSourcePath ?? null,
+        message: input.message,
+        reason: input.reason,
+    };
+}
+export function createFailedKnowledgeSource(input) {
+    return {
+        source: input.source,
+        localSourcePath: input.localSourcePath,
+        message: input.message,
+        reason: input.reason,
+    };
+}
+function classifySourceOrSkip(input) {
+    const decision = classifyKnowledgeSourcePath(input.source);
+    if (decision.kind === "ingest") {
+        return null;
+    }
+    return createSkippedKnowledgeSource({
+        source: input.source,
+        localSourcePath: input.localSourcePath,
+        message: decision.message,
+        reason: decision.reason,
+    });
+}
+function classifyDirectoryOrSkip(input) {
+    const decision = classifyKnowledgeDirectoryPath(input.source);
+    if (decision.kind === "ingest") {
+        return null;
+    }
+    return createSkippedKnowledgeSource({
+        source: input.source,
+        localSourcePath: null,
+        message: decision.message,
+        reason: decision.reason,
+    });
+}
+export async function collectLocalFiles(root, recursive) {
+    const fs = createFileSystem();
+    const stat = await fs.stat(root);
+    if (stat.isFile) {
+        const skipped = classifySourceOrSkip({ source: root, localSourcePath: root });
+        return skipped == null
+            ? {
+                sources: [{ kind: "local", input: root, localPath: root }],
+                skipped: [],
+            }
+            : {
+                sources: [],
+                skipped: [skipped],
+            };
+    }
+    if (!stat.isDirectory) {
+        return { sources: [], skipped: [] };
+    }
+    const skippedRootDirectory = classifyDirectoryOrSkip({ source: root });
+    if (skippedRootDirectory != null) {
+        return {
+            sources: [],
+            skipped: [skippedRootDirectory],
+        };
+    }
+    const collection = {
+        sources: [],
+        skipped: [],
+    };
+    async function walk(dir) {
+        for await (const entry of fs.readDir(dir)) {
+            const entryPath = join(dir, entry.name);
+            if (entry.isDirectory) {
+                const skipped = classifyDirectoryOrSkip({ source: entryPath });
+                if (skipped != null) {
+                    collection.skipped.push(skipped);
+                    continue;
+                }
+                if (recursive)
+                    await walk(entryPath);
+                continue;
+            }
+            if (!entry.isFile) {
+                continue;
+            }
+            const skipped = classifySourceOrSkip({ source: entryPath, localSourcePath: entryPath });
+            if (skipped != null) {
+                collection.skipped.push(skipped);
+                continue;
+            }
+            collection.sources.push({ kind: "local", input: root, localPath: entryPath });
+        }
+    }
+    await walk(root);
+    collection.sources.sort((left, right) => left.localPath.localeCompare(right.localPath));
+    collection.skipped.sort((left, right) => left.source.localeCompare(right.source));
+    return collection;
+}
+export function buildSourceReference(source) {
+    return source.kind === "upload"
+        ? formatKnowledgeUploadSource(source.uploadPath)
+        : source.localPath;
+}
+export function buildSuggestedSlug(source, index) {
+    const normalized = normalize(source.kind === "upload" ? source.uploadPath : source.localPath).replace(/\\/g, "/");
+    let stripped;
+    if (source.kind === "upload") {
+        stripped = normalized
+            .replace(/^\/workspace\/uploads\//, "")
+            .replace(/^\/workspace\//, "")
+            .replace(/^uploads\//, "")
+            .replace(/\.[^.]+$/, "");
+    }
+    else if (normalized.startsWith("/workspace/uploads/")) {
+        stripped = normalized.replace(/^\/workspace\/uploads\//, "").replace(/\.[^.]+$/, "");
+    }
+    else if (normalized.startsWith("/workspace/")) {
+        stripped = normalized.replace(/^\/workspace\//, "").replace(/\.[^.]+$/, "");
+    }
+    else if (normalized.startsWith("/")) {
+        stripped = basename(normalized, extname(normalized));
+    }
+    else {
+        stripped = normalized.replace(/\.[^.]+$/, "");
+    }
+    const lastSlash = stripped.lastIndexOf("/");
+    if (lastSlash >= 0) {
+        const dir = stripped.slice(0, lastSlash + 1);
+        const file = stripChatUploadPrefix(stripped.slice(lastSlash + 1));
+        stripped = file ? `${dir}${file}` : stripped;
+    }
+    else {
+        stripped = stripChatUploadPrefix(stripped) || stripped;
+    }
+    return slugify(stripped || basename(normalized, extname(normalized)) || `document-${index + 1}`);
+}
+export function ensureUniqueSlugs(sources) {
+    const counts = new Map();
+    return sources.map((source, index) => {
+        const baseSlug = buildSuggestedSlug(source, index);
+        const nextCount = (counts.get(baseSlug) ?? 0) + 1;
+        counts.set(baseSlug, nextCount);
+        return nextCount === 1 ? baseSlug : `${baseSlug}-${nextCount}`;
+    });
+}
+export function deriveKnowledgeRemotePath(outputPath, outputDir, knowledgePath) {
+    const relativeOutputPath = relative(outputDir, outputPath).replace(/\\/g, "/");
+    if (!relativeOutputPath || relativeOutputPath.startsWith("..")) {
+        throw new Error(`Output path is outside output directory: ${outputPath}`);
+    }
+    const prefix = normalizeKnowledgeInputPath(knowledgePath);
+    const normalizedRelative = normalize(relativeOutputPath).replace(/^\/+/, "");
+    return `${prefix}/${normalizedRelative}`.replace(/\\/g, "/");
+}
+export function createKnowledgeIngestResult(input) {
+    return {
+        source: input.source,
+        localSourcePath: input.localSourcePath,
+        outputPath: input.outputPath,
+        remotePath: input.remotePath,
+        slug: input.parser.slug,
+        sourceType: input.parser.source_type,
+        summary: input.parser.summary,
+        stats: input.parser.stats,
+        warnings: input.parser.warnings,
+    };
+}

package/esm/cli/commands/knowledge/command.d.ts

@@ -6,9 +6,10 @@ type SafeParseResult<T> = {
     success: false;
     error: z.ZodError;
 };
-import { type CommandResult } from "../../../src/platform/compat/process.js";
+import { type CommandResult } from "../../../src/platform/index.js";
 import { type ApiClient } from "../../shared/config.js";
 import type { ParsedArgs } from "../../shared/types.js";
+import * as commandHelpers from "./command-helpers.js";
 import { type Logger } from "../../../src/utils/index.js";
 import { type KnowledgeIngestFailedFileResult, type KnowledgeIngestFileResult, type KnowledgeIngestSkippedFileResult } from "./result.js";
 export interface KnowledgeParserResult {
@@ -66,22 +67,16 @@ declare const KnowledgeIngestArgsSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type KnowledgeIngestOptions = z.infer<typeof KnowledgeIngestArgsSchema>;
 export declare function parseKnowledgeIngestArgs(args: ParsedArgs): SafeParseResult<KnowledgeIngestOptions>;
-export declare function normalizeKnowledgeInputPath(inputPath: string): string;
-export declare function normalizeProjectUploadPath(inputPath: string): string;
-export declare function formatKnowledgeUploadSource(uploadPath: string): string;
-export declare function isLikelyLocalPath(value: string): boolean;
-export declare function stripChatUploadPrefix(name: string): string;
-export declare function resolveKnowledgeDownloadOutputDir(outputDir: string): string;
-export declare function buildSuggestedSlug(source: KnowledgeSource, index: number): string;
-export declare function ensureUniqueSlugs(sources: KnowledgeSource[]): string[];
-export declare function deriveKnowledgeRemotePath(outputPath: string, outputDir: string, knowledgePath: string): string;
-export declare function createKnowledgeIngestResult(input: {
-    source: string;
-    localSourcePath: string;
-    outputPath: string;
-    remotePath: string;
-    parser: Pick<KnowledgeParserResult, "slug" | "stats" | "warnings" | "source_type" | "summary">;
-}): KnowledgeIngestFileResult;
+export declare const normalizeKnowledgeInputPath: typeof commandHelpers.normalizeKnowledgeInputPath;
+export declare const normalizeProjectUploadPath: typeof commandHelpers.normalizeProjectUploadPath;
+export declare const formatKnowledgeUploadSource: typeof commandHelpers.formatKnowledgeUploadSource;
+export declare const isLikelyLocalPath: typeof commandHelpers.isLikelyLocalPath;
+export declare const stripChatUploadPrefix: typeof commandHelpers.stripChatUploadPrefix;
+export declare const resolveKnowledgeDownloadOutputDir: typeof commandHelpers.resolveKnowledgeDownloadOutputDir;
+export declare const buildSuggestedSlug: typeof commandHelpers.buildSuggestedSlug;
+export declare const ensureUniqueSlugs: typeof commandHelpers.ensureUniqueSlugs;
+export declare const deriveKnowledgeRemotePath: typeof commandHelpers.deriveKnowledgeRemotePath;
+export declare const createKnowledgeIngestResult: typeof commandHelpers.createKnowledgeIngestResult;
 export declare function runKnowledgeParser(input: {
     filePath: string;
     outputDir: string;

package/esm/cli/commands/knowledge/command.d.ts.map

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

package/esm/cli/commands/knowledge/command.js

@@ -1,8 +1,7 @@
 import * as dntShim from "../../../_dnt.shims.js";
 import { z } from "zod";
-import { createFileSystem, getEnv } from "../../../src/platform/index.js";
-import { basename, extname, join, normalize, relative } from "../../../src/platform/compat/path/index.js";
-import { runCommand } from "../../../src/platform/compat/process.js";
+import { createFileSystem, getEnv, runCommand } from "../../../src/platform/index.js";
+import { basename } from "../../../src/platform/compat/path/index.js";
 import { withSpan } from "../../../src/observability/tracing/otlp-setup.js";
 import { cliLogger } from "../../utils/index.js";
 import { createApiClient, resolveConfigWithAuth } from "../../shared/config.js";
@@ -10,9 +9,10 @@ import { getStringArg } from "../../shared/parsed-args.js";
 import { downloadUploadToFile, listAllUploads } from "../uploads/command.js";
 import { putRemoteFileFromLocal } from "../files/command.js";
 import { knowledgeIngestPythonSource } from "./parser-source.js";
+import * as commandHelpers from "./command-helpers.js";
 import { createJobUserLogger, serverLogger } from "../../../src/utils/index.js";
 import { writeJobResultIfConfigured } from "../../utils/write-job-result.js";
-import { classifyKnowledgeDirectoryPath, classifyKnowledgeSourcePath } from "./source-policy.js";
+import { classifyKnowledgeSourcePath } from "./source-policy.js";
 import { buildKnowledgeIngestJobResult, } from "./result.js";
 const knowledgeJobLogger = serverLogger.component("knowledge-ingest");
 const KnowledgeIngestArgsSchema = z.object({
@@ -113,233 +113,45 @@ export function parseKnowledgeIngestArgs(args) {
         quiet: getBooleanArg(args, "quiet", "q"),
     });
 }
-export function normalizeKnowledgeInputPath(inputPath) {
-    const normalizedPath = normalize(inputPath).replace(/^\/+/, "").replace(/\\/g, "/");
-    if (!normalizedPath || normalizedPath.startsWith("..") || normalizedPath.startsWith("/")) {
-        throw new Error(`Invalid knowledge input path: ${inputPath}`);
-    }
-    return normalizedPath;
-}
-export function normalizeProjectUploadPath(inputPath) {
-    return normalizeKnowledgeInputPath(inputPath);
-}
-export function formatKnowledgeUploadSource(uploadPath) {
-    const normalizedPath = normalizeKnowledgeInputPath(uploadPath);
-    return normalizedPath === "uploads" || normalizedPath.startsWith("uploads/")
-        ? normalizedPath
-        : `uploads/${normalizedPath}`;
-}
-function resolveExplicitUploadPath(inputPath) {
-    const normalizedInput = normalizeKnowledgeInputPath(inputPath);
-    const displayInput = inputPath.replace(/\\/g, "/");
-    const uploadPath = normalizeProjectUploadPath(inputPath);
-    if (!uploadPath || uploadPath === "uploads" || normalizedInput === "uploads" ||
-        normalizedInput.endsWith("/")) {
-        throw new Error(`Directory upload references require --path <prefix> --all: ${displayInput}`);
-    }
-    return uploadPath;
-}
-export function isLikelyLocalPath(value) {
-    return value.startsWith("/") || value.startsWith("./") || value.startsWith("../") ||
-        /^[A-Za-z]:[\\/]/.test(value);
-}
-function isProjectUploadReference(value) {
-    if (isLikelyLocalPath(value))
-        return false;
-    const normalizedValue = normalize(value).replace(/\\/g, "/").replace(/^\/+/, "");
-    return normalizedValue === "uploads" || normalizedValue.startsWith("uploads/");
-}
-function slugify(value) {
-    return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "document";
-}
-/**
- * Strip the chat-upload prefix that Studio prepends to uploaded files.
- *
- * Studio stores uploads with a generated prefix like:
- *   chat-<uuid>-<timestamp>-<shortid>-<original-filename>
- *
- * This function removes the prefix so knowledge files use the clean
- * original filename (e.g. "agents" instead of
- * "chat-909d3dbc-5a9a-4156-97e4-bcceb5c2ec0d-1773942180291-fv1qg5-agents").
- */
-const CHAT_UPLOAD_PREFIX_RE = /^chat-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}-\d+-[a-z0-9]+-/i;
-export function stripChatUploadPrefix(name) {
-    return name.replace(CHAT_UPLOAD_PREFIX_RE, "");
-}
 function defaultOutputRoot() {
     return dntShim.Deno.makeTempDir({ prefix: "veryfront-knowledge-" });
 }
-export function resolveKnowledgeDownloadOutputDir(outputDir) {
-    return join(outputDir, ".uploads");
-}
-function createSkippedKnowledgeSource(input) {
-    return {
-        source: input.source,
-        localSourcePath: input.localSourcePath ?? null,
-        message: input.message,
-        reason: input.reason,
-    };
-}
-function createFailedKnowledgeSource(input) {
-    return {
-        source: input.source,
-        localSourcePath: input.localSourcePath,
-        message: input.message,
-        reason: input.reason,
-    };
-}
 function classifySourceOrSkip(input) {
     const decision = classifyKnowledgeSourcePath(input.source);
     if (decision.kind === "ingest") {
         return null;
     }
-    return createSkippedKnowledgeSource({
-        source: input.source,
-        localSourcePath: input.localSourcePath,
-        message: decision.message,
-        reason: decision.reason,
-    });
-}
-function classifyDirectoryOrSkip(input) {
-    const decision = classifyKnowledgeDirectoryPath(input.source);
-    if (decision.kind === "ingest") {
-        return null;
-    }
-    return createSkippedKnowledgeSource({
+    return {
         source: input.source,
-        localSourcePath: null,
+        localSourcePath: input.localSourcePath ?? null,
         message: decision.message,
         reason: decision.reason,
-    });
-}
-async function collectLocalFiles(root, recursive) {
-    const fs = createFileSystem();
-    const stat = await fs.stat(root);
-    if (stat.isFile) {
-        const skipped = classifySourceOrSkip({ source: root, localSourcePath: root });
-        return skipped == null
-            ? {
-                sources: [{ kind: "local", input: root, localPath: root }],
-                skipped: [],
-            }
-            : {
-                sources: [],
-                skipped: [skipped],
-            };
-    }
-    if (!stat.isDirectory) {
-        return { sources: [], skipped: [] };
-    }
-    const skippedRootDirectory = classifyDirectoryOrSkip({ source: root });
-    if (skippedRootDirectory != null) {
-        return {
-            sources: [],
-            skipped: [skippedRootDirectory],
-        };
-    }
-    const collection = {
-        sources: [],
-        skipped: [],
     };
-    async function walk(dir) {
-        for await (const entry of fs.readDir(dir)) {
-            const entryPath = join(dir, entry.name);
-            if (entry.isDirectory) {
-                const skipped = classifyDirectoryOrSkip({ source: entryPath });
-                if (skipped != null) {
-                    collection.skipped.push(skipped);
-                    continue;
-                }
-                if (recursive)
-                    await walk(entryPath);
-                continue;
-            }
-            if (!entry.isFile) {
-                continue;
-            }
-            const skipped = classifySourceOrSkip({ source: entryPath, localSourcePath: entryPath });
-            if (skipped != null) {
-                collection.skipped.push(skipped);
-                continue;
-            }
-            collection.sources.push({ kind: "local", input: root, localPath: entryPath });
-        }
-    }
-    await walk(root);
-    collection.sources.sort((left, right) => left.localPath.localeCompare(right.localPath));
-    collection.skipped.sort((left, right) => left.source.localeCompare(right.source));
-    return collection;
 }
-function buildSourceReference(source) {
-    return source.kind === "upload"
-        ? formatKnowledgeUploadSource(source.uploadPath)
-        : source.localPath;
+export const normalizeKnowledgeInputPath = commandHelpers.normalizeKnowledgeInputPath;
+export const normalizeProjectUploadPath = commandHelpers.normalizeProjectUploadPath;
+export const formatKnowledgeUploadSource = commandHelpers.formatKnowledgeUploadSource;
+export const isLikelyLocalPath = commandHelpers.isLikelyLocalPath;
+export const stripChatUploadPrefix = commandHelpers.stripChatUploadPrefix;
+export const resolveKnowledgeDownloadOutputDir = commandHelpers.resolveKnowledgeDownloadOutputDir;
+export const buildSuggestedSlug = commandHelpers.buildSuggestedSlug;
+export const ensureUniqueSlugs = commandHelpers.ensureUniqueSlugs;
+export const deriveKnowledgeRemotePath = commandHelpers.deriveKnowledgeRemotePath;
+export const createKnowledgeIngestResult = commandHelpers.createKnowledgeIngestResult;
+function resolveExplicitUploadPath(inputPath) {
+    return commandHelpers.resolveExplicitUploadPath(inputPath);
 }
-export function buildSuggestedSlug(source, index) {
-    const normalized = normalize(source.kind === "upload" ? source.uploadPath : source.localPath).replace(/\\/g, "/");
-    let stripped;
-    if (source.kind === "upload") {
-        stripped = normalized
-            .replace(/^\/workspace\/uploads\//, "")
-            .replace(/^\/workspace\//, "")
-            .replace(/^uploads\//, "")
-            .replace(/\.[^.]+$/, "");
-    }
-    else if (normalized.startsWith("/workspace/uploads/")) {
-        stripped = normalized.replace(/^\/workspace\/uploads\//, "").replace(/\.[^.]+$/, "");
-    }
-    else if (normalized.startsWith("/workspace/")) {
-        stripped = normalized.replace(/^\/workspace\//, "").replace(/\.[^.]+$/, "");
-    }
-    else if (normalized.startsWith("/")) {
-        stripped = basename(normalized, extname(normalized));
-    }
-    else {
-        stripped = normalized.replace(/\.[^.]+$/, "");
-    }
-    // Strip Studio's chat-upload prefix from the filename portion so that
-    // knowledge files use the original clean filename.
-    const lastSlash = stripped.lastIndexOf("/");
-    if (lastSlash >= 0) {
-        const dir = stripped.slice(0, lastSlash + 1);
-        const file = stripChatUploadPrefix(stripped.slice(lastSlash + 1));
-        stripped = file ? `${dir}${file}` : stripped;
-    }
-    else {
-        stripped = stripChatUploadPrefix(stripped) || stripped;
-    }
-    return slugify(stripped || basename(normalized, extname(normalized)) || `document-${index + 1}`);
+function isProjectUploadReference(value) {
+    return commandHelpers.isProjectUploadReference(value);
 }
-export function ensureUniqueSlugs(sources) {
-    const counts = new Map();
-    return sources.map((source, index) => {
-        const baseSlug = buildSuggestedSlug(source, index);
-        const nextCount = (counts.get(baseSlug) ?? 0) + 1;
-        counts.set(baseSlug, nextCount);
-        return nextCount === 1 ? baseSlug : `${baseSlug}-${nextCount}`;
-    });
+function createFailedKnowledgeSource(input) {
+    return commandHelpers.createFailedKnowledgeSource(input);
 }
-export function deriveKnowledgeRemotePath(outputPath, outputDir, knowledgePath) {
-    const relativeOutputPath = relative(outputDir, outputPath).replace(/\\/g, "/");
-    if (!relativeOutputPath || relativeOutputPath.startsWith("..")) {
-        throw new Error(`Output path is outside output directory: ${outputPath}`);
-    }
-    const prefix = normalizeKnowledgeInputPath(knowledgePath);
-    const normalizedRelative = normalize(relativeOutputPath).replace(/^\/+/, "");
-    return `${prefix}/${normalizedRelative}`.replace(/\\/g, "/");
+async function collectLocalFiles(root, recursive) {
+    return commandHelpers.collectLocalFiles(root, recursive);
 }
-export function createKnowledgeIngestResult(input) {
-    return {
-        source: input.source,
-        localSourcePath: input.localSourcePath,
-        outputPath: input.outputPath,
-        remotePath: input.remotePath,
-        slug: input.parser.slug,
-        sourceType: input.parser.source_type,
-        summary: input.parser.summary,
-        stats: input.parser.stats,
-        warnings: input.parser.warnings,
-    };
+function buildSourceReference(source) {
+    return commandHelpers.buildSourceReference(source);
 }
 export async function runKnowledgeParser(input) {
     const [result] = await runKnowledgeParsers({

package/esm/cli/help/command-definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-definitions.d.ts","sourceRoot":"","sources":["../../../src/cli/help/command-definitions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAyClD;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,eAuCtB,CAAC"}
+{"version":3,"file":"command-definitions.d.ts","sourceRoot":"","sources":["../../../src/cli/help/command-definitions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AA0ClD;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,eAwCtB,CAAC"}

package/esm/cli/help/command-definitions.js

@@ -42,6 +42,7 @@ import { skillsHelp } from "../commands/skills/command-help.js";
 import { configHelp } from "../commands/config/command-help.js";
 import { openHelp } from "../commands/open/command-help.js";
 import { completionsHelp } from "../commands/completions/command-help.js";
+import { extensionHelp } from "../commands/extension/command-help.js";
 /**
  * Central registry of all command help definitions.
  * Each command's help is imported from its respective command-help.ts file.
@@ -85,4 +86,5 @@ export const COMMANDS = {
     config: configHelp,
     open: openHelp,
     completions: completionsHelp,
+    extension: extensionHelp,
 };

package/esm/cli/mcp/remote-file-tool-helpers.d.ts

@@ -0,0 +1,5 @@
+export declare function getBranchParam(branch?: string): string;
+export declare function buildProjectApiPath(project: string, resource: string, branch?: string): string;
+export declare function buildProjectFilePath(project: string, filePath: string, branch?: string): string;
+export declare function slugToName(slug: string): string;
+//# sourceMappingURL=remote-file-tool-helpers.d.ts.map

package/esm/cli/mcp/remote-file-tool-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-file-tool-helpers.d.ts","sourceRoot":"","sources":["../../../src/cli/mcp/remote-file-tool-helpers.ts"],"names":[],"mappings":"AAQA,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAG9F;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/F;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK/C"}