@agent-inspect/studio 6.0.0 → 6.1.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import Database from 'better-sqlite3';
-import { Server } from 'node:http';
+import { Server, IncomingMessage, ServerResponse } from 'node:http';
 
 type StudioAuthMode = "none" | "basic";
 
@@ -13,6 +13,12 @@ interface StudioProjectRow {
     traceCount: number;
     importedAt: string;
 }
+type IngestFileKind = "ci" | "bundle";
+declare function resolveStudioDbPath(options: {
+    dbPath?: string;
+    cwd?: string;
+}): string;
+declare function openStudioDb(dbPath: string): Database.Database;
 
 declare const STUDIO_REGISTRY_SCHEMA_VERSION: "1.0";
 interface StudioRegistryProject {
@@ -24,18 +30,42 @@ interface StudioRegistryProject {
 interface StudioRegistryImport {
     ciArtifactsDir?: string;
     bundlesDir?: string;
+    fileDropDir?: string;
+    enabled?: boolean;
+}
+interface StudioRegistryGitHubIngest {
+    enabled?: boolean;
+    tokenEnv?: string;
+}
+interface StudioRegistryHttpIngest {
+    enabled?: boolean;
+    path?: string;
+    tokenEnv?: string;
+    maxBytes?: number;
+}
+interface StudioRegistryBundleUploadIngest {
+    enabled?: boolean;
+    maxBytes?: number;
+}
+interface StudioRegistryIngest {
+    github?: StudioRegistryGitHubIngest;
+    http?: StudioRegistryHttpIngest;
+    bundleUpload?: StudioRegistryBundleUploadIngest;
 }
 interface StudioRegistry {
     schemaVersion: typeof STUDIO_REGISTRY_SCHEMA_VERSION;
     name: string;
     projects: StudioRegistryProject[];
     import?: StudioRegistryImport;
+    ingest?: StudioRegistryIngest;
 }
 interface StudioRegistryParseResult {
     ok: boolean;
     registry?: StudioRegistry;
     errors: string[];
+    warnings: string[];
 }
+
 declare function parseStudioRegistry(input: unknown): StudioRegistryParseResult;
 declare function readStudioRegistryFile(filePath: string): Promise<StudioRegistryParseResult & {
     path: string;
@@ -50,12 +80,59 @@ interface StudioImportResult {
     warnings: string[];
 }
 
+interface FileDropImportOptions {
+    db: Database.Database;
+    registryPath: string;
+    registry: StudioRegistry;
+    /** Explicit opt-in required — ingest is disabled by default. */
+    enabled: boolean;
+    /** Override drop directory (CLI `--dir`). */
+    dropDir?: string;
+    /** Move successfully imported files into `dropDir/.imported/` instead of leaving copies. */
+    archiveAfterImport?: boolean;
+}
+interface FileDropImportedFile {
+    sourceKey: string;
+    sourceName: string;
+    destPath: string;
+    kind: IngestFileKind;
+    contentHash: string;
+    archived: boolean;
+}
+interface FileDropImportResult {
+    skipped: boolean;
+    reason?: string;
+    scanned: number;
+    imported: number;
+    skippedFiles: number;
+    errors: string[];
+    warnings: string[];
+    files: FileDropImportedFile[];
+}
+declare function importFileDrop(options: FileDropImportOptions): Promise<FileDropImportResult>;
+declare function importFileDropFromRegistry(options: {
+    db: Database.Database;
+    registryPath: string;
+    registry: StudioRegistry;
+    enabled: boolean;
+    dropDir?: string;
+    archiveAfterImport?: boolean;
+}): Promise<FileDropImportResult>;
+declare function runStudioFileDropImport(options: {
+    workspacePath?: string;
+    dbPath?: string;
+    cwd?: string;
+    dropDir?: string;
+    archiveAfterImport?: boolean;
+}): Promise<FileDropImportResult>;
+
 interface StudioContext {
     db: Database.Database;
     dbPath: string;
     registryPath: string;
     registry: StudioRegistry;
     importResult: StudioImportResult;
+    fileDropResult?: FileDropImportResult;
     projects: ImportedStudioProject[];
 }
 declare function createStudioContext(options?: StudioServerOptions): Promise<StudioContext>;
@@ -79,6 +156,14 @@ interface StudioServerOptions {
     passwordEnv?: string;
     /** Test hook: inject a preloaded context instead of importing on startup. */
     context?: StudioContext;
+    /** Run file-drop ingest once on startup (requires explicit opt-in). */
+    ingestFileDrop?: boolean;
+    /** Move imported drop files into `.imported/` after successful copy. */
+    archiveFileDrop?: boolean;
+    /** Enable HTTP ingest routes (requires explicit opt-in + ingest token env). */
+    ingestHttp?: boolean;
+    /** Env var name for HTTP ingest token (default STUDIO_INGEST_TOKEN). */
+    ingestTokenEnv?: string;
 }
 interface StudioServerInfo {
     host: string;
@@ -96,4 +181,100 @@ declare function startStudioServer(options?: StudioServerOptions): Promise<Studi
 
 declare const studioIndexHtml = "<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n  <meta charset=\"utf-8\" />\n  <title>AgentInspect Studio</title>\n  <style>\n    body { font-family: system-ui, sans-serif; margin: 1.5rem; line-height: 1.4; }\n    h1 { font-size: 1.25rem; }\n    .muted { color: #666; }\n  </style>\n</head>\n<body>\n  <h1>AgentInspect Studio</h1>\n  <p class=\"muted\">Self-hosted, read-only. JSONL and workspace manifests remain canonical.</p>\n  <p id=\"status\">Loading health\u2026</p>\n  <script>\n    fetch(\"/api/health\")\n      .then((res) => res.json())\n      .then((data) => {\n        document.getElementById(\"status\").textContent =\n          data.ok ? \"Studio is running (read-only).\" : \"Studio health check failed.\";\n      })\n      .catch(() => {\n        document.getElementById(\"status\").textContent = \"Studio health check failed.\";\n      });\n  </script>\n</body>\n</html>";
 
-export { type StudioRegistry, type StudioRegistryProject, type StudioServerInfo, type StudioServerOptions, createStudioContext, createStudioServer, parseStudioRegistry, readStudioRegistryFile, startStudioServer, studioIndexHtml, summarizeProjects };
+type StudioFetch = typeof fetch;
+interface GitHubArtifactImportOptions {
+    db: Database.Database;
+    registryPath: string;
+    registry: StudioRegistry;
+    repo: string;
+    runId: string;
+    artifactName: string;
+    /** Explicit opt-in required — disabled by default. */
+    enabled: boolean;
+    tokenEnv?: string;
+    fetchImpl?: StudioFetch;
+}
+interface GitHubArtifactImportResult {
+    skipped: boolean;
+    reason?: string;
+    imported: boolean;
+    destPath?: string;
+    sourceKey?: string;
+    contentHash?: string;
+    registryImportWarnings: string[];
+    errors: string[];
+}
+declare function downloadGitHubArtifactArchive(options: {
+    repo: string;
+    runId: string;
+    artifactName: string;
+    token: string;
+    fetchImpl?: StudioFetch;
+}): Promise<Buffer>;
+declare function importGitHubArtifact(options: GitHubArtifactImportOptions): Promise<GitHubArtifactImportResult>;
+declare function runStudioGitHubArtifactImport(options: {
+    workspacePath?: string;
+    dbPath?: string;
+    cwd?: string;
+    repo: string;
+    runId: string;
+    artifact: string;
+    tokenEnv?: string;
+    fetchImpl?: StudioFetch;
+}): Promise<GitHubArtifactImportResult>;
+
+interface BundleUploadImportOptions {
+    db: Database.Database;
+    registryPath: string;
+    registry: StudioRegistry;
+    bundlePath: string;
+    enabled: boolean;
+}
+interface BundleUploadImportResult {
+    skipped: boolean;
+    reason?: string;
+    imported: boolean;
+    destPath?: string;
+    sourceKey?: string;
+    errors: string[];
+    registryImportWarnings: string[];
+}
+declare function validateBundleDirectory(bundleDir: string): Promise<string[]>;
+declare function importBundleUpload(options: BundleUploadImportOptions): Promise<BundleUploadImportResult>;
+declare function runStudioBundleUploadImport(options: {
+    workspacePath?: string;
+    dbPath?: string;
+    cwd?: string;
+    bundlePath: string;
+}): Promise<BundleUploadImportResult>;
+
+declare const HTTP_INGEST_BUNDLE_PATH = "/api/ingest/bundle";
+declare const HTTP_INGEST_ARTIFACT_PATH = "/api/ingest/artifact";
+interface HttpIngestConfig {
+    enabled: boolean;
+    basePath: string;
+    tokenEnv: string;
+    maxBytes: number;
+}
+declare function resolveHttpIngestConfig(options: StudioServerOptions, registryEnabled?: boolean): HttpIngestConfig;
+declare function isHttpIngestRoute(pathname: string, config: HttpIngestConfig): boolean;
+declare function handleHttpIngestRequest(req: IncomingMessage, res: ServerResponse, ctx: StudioContext, options: StudioServerOptions, pathname: string): Promise<boolean>;
+
+declare function resolveIngestTokenEnv(options: {
+    tokenEnv?: string;
+    registryTokenEnv?: string;
+}): string;
+declare function resolveIngestToken(envName: string): string | undefined;
+declare function extractIngestTokenFromRequest(headers: {
+    authorization?: string | string[] | undefined;
+    "x-agentinspect-token"?: string | string[] | undefined;
+    "x-agent-inspect-token"?: string | string[] | undefined;
+}): string | undefined;
+declare function isIngestTokenValid(provided: string | undefined, expected: string | undefined): boolean;
+
+declare function resolveStudioRegistryPath(options: {
+    workspacePath?: string;
+    cwd?: string;
+}): Promise<string>;
+
+export { type BundleUploadImportResult, type FileDropImportOptions, type FileDropImportResult, type GitHubArtifactImportOptions, type GitHubArtifactImportResult, HTTP_INGEST_ARTIFACT_PATH, HTTP_INGEST_BUNDLE_PATH, type StudioFetch, type StudioRegistry, type StudioRegistryProject, type StudioServerInfo, type StudioServerOptions, createStudioContext, createStudioServer, downloadGitHubArtifactArchive, extractIngestTokenFromRequest, handleHttpIngestRequest, importBundleUpload, importFileDrop, importFileDropFromRegistry, importGitHubArtifact, isHttpIngestRoute, isIngestTokenValid, openStudioDb, parseStudioRegistry, readStudioRegistryFile, resolveHttpIngestConfig, resolveIngestToken, resolveIngestTokenEnv, resolveStudioDbPath, resolveStudioRegistryPath, runStudioBundleUploadImport, runStudioFileDropImport, runStudioGitHubArtifactImport, startStudioServer, studioIndexHtml, summarizeProjects, validateBundleDirectory };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import Database from 'better-sqlite3';
-import { Server } from 'node:http';
+import { Server, IncomingMessage, ServerResponse } from 'node:http';
 
 type StudioAuthMode = "none" | "basic";
 
@@ -13,6 +13,12 @@ interface StudioProjectRow {
     traceCount: number;
     importedAt: string;
 }
+type IngestFileKind = "ci" | "bundle";
+declare function resolveStudioDbPath(options: {
+    dbPath?: string;
+    cwd?: string;
+}): string;
+declare function openStudioDb(dbPath: string): Database.Database;
 
 declare const STUDIO_REGISTRY_SCHEMA_VERSION: "1.0";
 interface StudioRegistryProject {
@@ -24,18 +30,42 @@ interface StudioRegistryProject {
 interface StudioRegistryImport {
     ciArtifactsDir?: string;
     bundlesDir?: string;
+    fileDropDir?: string;
+    enabled?: boolean;
+}
+interface StudioRegistryGitHubIngest {
+    enabled?: boolean;
+    tokenEnv?: string;
+}
+interface StudioRegistryHttpIngest {
+    enabled?: boolean;
+    path?: string;
+    tokenEnv?: string;
+    maxBytes?: number;
+}
+interface StudioRegistryBundleUploadIngest {
+    enabled?: boolean;
+    maxBytes?: number;
+}
+interface StudioRegistryIngest {
+    github?: StudioRegistryGitHubIngest;
+    http?: StudioRegistryHttpIngest;
+    bundleUpload?: StudioRegistryBundleUploadIngest;
 }
 interface StudioRegistry {
     schemaVersion: typeof STUDIO_REGISTRY_SCHEMA_VERSION;
     name: string;
     projects: StudioRegistryProject[];
     import?: StudioRegistryImport;
+    ingest?: StudioRegistryIngest;
 }
 interface StudioRegistryParseResult {
     ok: boolean;
     registry?: StudioRegistry;
     errors: string[];
+    warnings: string[];
 }
+
 declare function parseStudioRegistry(input: unknown): StudioRegistryParseResult;
 declare function readStudioRegistryFile(filePath: string): Promise<StudioRegistryParseResult & {
     path: string;
@@ -50,12 +80,59 @@ interface StudioImportResult {
     warnings: string[];
 }
 
+interface FileDropImportOptions {
+    db: Database.Database;
+    registryPath: string;
+    registry: StudioRegistry;
+    /** Explicit opt-in required — ingest is disabled by default. */
+    enabled: boolean;
+    /** Override drop directory (CLI `--dir`). */
+    dropDir?: string;
+    /** Move successfully imported files into `dropDir/.imported/` instead of leaving copies. */
+    archiveAfterImport?: boolean;
+}
+interface FileDropImportedFile {
+    sourceKey: string;
+    sourceName: string;
+    destPath: string;
+    kind: IngestFileKind;
+    contentHash: string;
+    archived: boolean;
+}
+interface FileDropImportResult {
+    skipped: boolean;
+    reason?: string;
+    scanned: number;
+    imported: number;
+    skippedFiles: number;
+    errors: string[];
+    warnings: string[];
+    files: FileDropImportedFile[];
+}
+declare function importFileDrop(options: FileDropImportOptions): Promise<FileDropImportResult>;
+declare function importFileDropFromRegistry(options: {
+    db: Database.Database;
+    registryPath: string;
+    registry: StudioRegistry;
+    enabled: boolean;
+    dropDir?: string;
+    archiveAfterImport?: boolean;
+}): Promise<FileDropImportResult>;
+declare function runStudioFileDropImport(options: {
+    workspacePath?: string;
+    dbPath?: string;
+    cwd?: string;
+    dropDir?: string;
+    archiveAfterImport?: boolean;
+}): Promise<FileDropImportResult>;
+
 interface StudioContext {
     db: Database.Database;
     dbPath: string;
     registryPath: string;
     registry: StudioRegistry;
     importResult: StudioImportResult;
+    fileDropResult?: FileDropImportResult;
     projects: ImportedStudioProject[];
 }
 declare function createStudioContext(options?: StudioServerOptions): Promise<StudioContext>;
@@ -79,6 +156,14 @@ interface StudioServerOptions {
     passwordEnv?: string;
     /** Test hook: inject a preloaded context instead of importing on startup. */
     context?: StudioContext;
+    /** Run file-drop ingest once on startup (requires explicit opt-in). */
+    ingestFileDrop?: boolean;
+    /** Move imported drop files into `.imported/` after successful copy. */
+    archiveFileDrop?: boolean;
+    /** Enable HTTP ingest routes (requires explicit opt-in + ingest token env). */
+    ingestHttp?: boolean;
+    /** Env var name for HTTP ingest token (default STUDIO_INGEST_TOKEN). */
+    ingestTokenEnv?: string;
 }
 interface StudioServerInfo {
     host: string;
@@ -96,4 +181,100 @@ declare function startStudioServer(options?: StudioServerOptions): Promise<Studi
 
 declare const studioIndexHtml = "<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n  <meta charset=\"utf-8\" />\n  <title>AgentInspect Studio</title>\n  <style>\n    body { font-family: system-ui, sans-serif; margin: 1.5rem; line-height: 1.4; }\n    h1 { font-size: 1.25rem; }\n    .muted { color: #666; }\n  </style>\n</head>\n<body>\n  <h1>AgentInspect Studio</h1>\n  <p class=\"muted\">Self-hosted, read-only. JSONL and workspace manifests remain canonical.</p>\n  <p id=\"status\">Loading health\u2026</p>\n  <script>\n    fetch(\"/api/health\")\n      .then((res) => res.json())\n      .then((data) => {\n        document.getElementById(\"status\").textContent =\n          data.ok ? \"Studio is running (read-only).\" : \"Studio health check failed.\";\n      })\n      .catch(() => {\n        document.getElementById(\"status\").textContent = \"Studio health check failed.\";\n      });\n  </script>\n</body>\n</html>";
 
-export { type StudioRegistry, type StudioRegistryProject, type StudioServerInfo, type StudioServerOptions, createStudioContext, createStudioServer, parseStudioRegistry, readStudioRegistryFile, startStudioServer, studioIndexHtml, summarizeProjects };
+type StudioFetch = typeof fetch;
+interface GitHubArtifactImportOptions {
+    db: Database.Database;
+    registryPath: string;
+    registry: StudioRegistry;
+    repo: string;
+    runId: string;
+    artifactName: string;
+    /** Explicit opt-in required — disabled by default. */
+    enabled: boolean;
+    tokenEnv?: string;
+    fetchImpl?: StudioFetch;
+}
+interface GitHubArtifactImportResult {
+    skipped: boolean;
+    reason?: string;
+    imported: boolean;
+    destPath?: string;
+    sourceKey?: string;
+    contentHash?: string;
+    registryImportWarnings: string[];
+    errors: string[];
+}
+declare function downloadGitHubArtifactArchive(options: {
+    repo: string;
+    runId: string;
+    artifactName: string;
+    token: string;
+    fetchImpl?: StudioFetch;
+}): Promise<Buffer>;
+declare function importGitHubArtifact(options: GitHubArtifactImportOptions): Promise<GitHubArtifactImportResult>;
+declare function runStudioGitHubArtifactImport(options: {
+    workspacePath?: string;
+    dbPath?: string;
+    cwd?: string;
+    repo: string;
+    runId: string;
+    artifact: string;
+    tokenEnv?: string;
+    fetchImpl?: StudioFetch;
+}): Promise<GitHubArtifactImportResult>;
+
+interface BundleUploadImportOptions {
+    db: Database.Database;
+    registryPath: string;
+    registry: StudioRegistry;
+    bundlePath: string;
+    enabled: boolean;
+}
+interface BundleUploadImportResult {
+    skipped: boolean;
+    reason?: string;
+    imported: boolean;
+    destPath?: string;
+    sourceKey?: string;
+    errors: string[];
+    registryImportWarnings: string[];
+}
+declare function validateBundleDirectory(bundleDir: string): Promise<string[]>;
+declare function importBundleUpload(options: BundleUploadImportOptions): Promise<BundleUploadImportResult>;
+declare function runStudioBundleUploadImport(options: {
+    workspacePath?: string;
+    dbPath?: string;
+    cwd?: string;
+    bundlePath: string;
+}): Promise<BundleUploadImportResult>;
+
+declare const HTTP_INGEST_BUNDLE_PATH = "/api/ingest/bundle";
+declare const HTTP_INGEST_ARTIFACT_PATH = "/api/ingest/artifact";
+interface HttpIngestConfig {
+    enabled: boolean;
+    basePath: string;
+    tokenEnv: string;
+    maxBytes: number;
+}
+declare function resolveHttpIngestConfig(options: StudioServerOptions, registryEnabled?: boolean): HttpIngestConfig;
+declare function isHttpIngestRoute(pathname: string, config: HttpIngestConfig): boolean;
+declare function handleHttpIngestRequest(req: IncomingMessage, res: ServerResponse, ctx: StudioContext, options: StudioServerOptions, pathname: string): Promise<boolean>;
+
+declare function resolveIngestTokenEnv(options: {
+    tokenEnv?: string;
+    registryTokenEnv?: string;
+}): string;
+declare function resolveIngestToken(envName: string): string | undefined;
+declare function extractIngestTokenFromRequest(headers: {
+    authorization?: string | string[] | undefined;
+    "x-agentinspect-token"?: string | string[] | undefined;
+    "x-agent-inspect-token"?: string | string[] | undefined;
+}): string | undefined;
+declare function isIngestTokenValid(provided: string | undefined, expected: string | undefined): boolean;
+
+declare function resolveStudioRegistryPath(options: {
+    workspacePath?: string;
+    cwd?: string;
+}): Promise<string>;
+
+export { type BundleUploadImportResult, type FileDropImportOptions, type FileDropImportResult, type GitHubArtifactImportOptions, type GitHubArtifactImportResult, HTTP_INGEST_ARTIFACT_PATH, HTTP_INGEST_BUNDLE_PATH, type StudioFetch, type StudioRegistry, type StudioRegistryProject, type StudioServerInfo, type StudioServerOptions, createStudioContext, createStudioServer, downloadGitHubArtifactArchive, extractIngestTokenFromRequest, handleHttpIngestRequest, importBundleUpload, importFileDrop, importFileDropFromRegistry, importGitHubArtifact, isHttpIngestRoute, isIngestTokenValid, openStudioDb, parseStudioRegistry, readStudioRegistryFile, resolveHttpIngestConfig, resolveIngestToken, resolveIngestTokenEnv, resolveStudioDbPath, resolveStudioRegistryPath, runStudioBundleUploadImport, runStudioFileDropImport, runStudioGitHubArtifactImport, startStudioServer, studioIndexHtml, summarizeProjects, validateBundleDirectory };