@struktur/sdk 2.2.0 → 2.3.1

package/dist/artifacts/fileToArtifact.d.ts

@@ -0,0 +1,8 @@
+import type { Artifact } from "../types";
+import { type ArtifactProviders } from "./providers";
+export type FileToArtifactOptions = {
+    mimeType: string;
+    providers?: ArtifactProviders;
+};
+export declare const fileToArtifact: (buffer: Buffer, options: FileToArtifactOptions) => Promise<Artifact>;
+//# sourceMappingURL=fileToArtifact.d.ts.map

package/dist/artifacts/fileToArtifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileToArtifact.d.ts","sourceRoot":"","sources":["../../src/artifacts/fileToArtifact.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAA4B,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE/E,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B,CAAC;AAgBF,eAAO,MAAM,cAAc,GACzB,QAAQ,MAAM,EACd,SAAS,qBAAqB,KAC7B,OAAO,CAAC,QAAQ,CAkBlB,CAAC"}

package/dist/artifacts/input.d.ts

@@ -0,0 +1,60 @@
+import type { Artifact, ArtifactContent, ArtifactImage } from "../types";
+import { type ArtifactProviders } from "./providers";
+import type { ParsersConfig } from "../parsers/types";
+export type SerializedArtifactImage = Omit<ArtifactImage, "contents"> & {
+    contents?: never;
+};
+export type SerializedArtifactContent = Omit<ArtifactContent, "media"> & {
+    media?: SerializedArtifactImage[];
+};
+export type SerializedArtifact = Omit<Artifact, "raw" | "contents"> & {
+    contents: SerializedArtifactContent[];
+    raw?: never;
+};
+export type SerializedArtifacts = SerializedArtifact | SerializedArtifact[];
+export type ArtifactInput = {
+    kind: "artifact-json";
+    data: unknown;
+} | {
+    kind: "text";
+    text: string;
+    id?: string;
+} | {
+    kind: "file";
+    path: string;
+    mimeType?: string;
+    id?: string;
+} | {
+    kind: "buffer";
+    buffer: Buffer;
+    mimeType: string;
+    id?: string;
+};
+export type ArtifactInputParser = {
+    name: string;
+    canParse: (input: ArtifactInput) => boolean;
+    parse: (input: ArtifactInput, options?: {
+        providers?: ArtifactProviders;
+        parsers?: ParsersConfig;
+        includeImages?: boolean;
+        screenshots?: boolean;
+        screenshotScale?: number;
+        screenshotWidth?: number;
+    }) => Promise<Artifact[]>;
+};
+export declare const registerArtifactInputParser: (parser: ArtifactInputParser) => void;
+export declare const clearArtifactInputParsers: () => void;
+export declare const validateSerializedArtifacts: (data: unknown) => SerializedArtifact[];
+export declare const hydrateSerializedArtifacts: (items: SerializedArtifact[]) => Artifact[];
+export declare const parseSerializedArtifacts: (text: string) => SerializedArtifact[];
+export declare const splitTextIntoContents: (text: string) => ArtifactContent[];
+export declare const parse: (input: ArtifactInput, options?: {
+    parsers?: ArtifactInputParser[];
+    providers?: ArtifactProviders;
+    parserConfig?: ParsersConfig;
+    includeImages?: boolean;
+    screenshots?: boolean;
+    screenshotScale?: number;
+    screenshotWidth?: number;
+}) => Promise<Artifact[]>;
+//# sourceMappingURL=input.d.ts.map

package/dist/artifacts/input.d.ts.map

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

package/dist/artifacts/providers.d.ts

@@ -0,0 +1,5 @@
+import type { Artifact } from "../types";
+export type ArtifactProvider = (buffer: Buffer) => Promise<Artifact>;
+export type ArtifactProviders = Record<string, ArtifactProvider>;
+export declare const defaultArtifactProviders: ArtifactProviders;
+//# sourceMappingURL=providers.d.ts.map

package/dist/artifacts/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../src/artifacts/providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAErE,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAEjE,eAAO,MAAM,wBAAwB,EAAE,iBAAsB,CAAC"}

package/dist/artifacts/urlToArtifact.d.ts

@@ -0,0 +1,3 @@
+import type { Artifact } from "../types";
+export declare const urlToArtifact: (url: string) => Promise<Artifact>;
+//# sourceMappingURL=urlToArtifact.d.ts.map

package/dist/artifacts/urlToArtifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlToArtifact.d.ts","sourceRoot":"","sources":["../../src/artifacts/urlToArtifact.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC,eAAO,MAAM,aAAa,GAAU,KAAK,MAAM,KAAG,OAAO,CAAC,QAAQ,CAgBjE,CAAC"}

package/dist/auth/config.d.ts

@@ -0,0 +1,34 @@
+import type { ParserDef, ParsersConfig } from "../parsers/types";
+type TelemetryConfig = {
+    enabled: boolean;
+    provider: string;
+    url?: string;
+    apiKey?: string;
+    projectName?: string;
+    publicKey?: string;
+    secretKey?: string;
+    baseUrl?: string;
+    sampleRate?: number;
+};
+export declare const getDefaultModel: () => Promise<string | undefined>;
+export declare const setDefaultModel: (model: string) => Promise<string>;
+export declare const listAliases: () => Promise<Record<string, string>>;
+export declare const getAlias: (alias: string) => Promise<string | undefined>;
+export declare const setAlias: (alias: string, model: string) => Promise<string>;
+export declare const deleteAlias: (alias: string) => Promise<boolean>;
+/**
+ * Resolve a model spec: if it matches a stored alias, return the aliased model string.
+ * Otherwise return the original spec unchanged.
+ */
+export declare const resolveAlias: (modelSpec: string) => Promise<string>;
+export declare const listParsers: () => Promise<ParsersConfig>;
+export declare const getParser: (mimeType: string) => Promise<ParserDef | undefined>;
+export declare const setParser: (mimeType: string, def: ParserDef) => Promise<void>;
+export declare const deleteParser: (mimeType: string) => Promise<boolean>;
+export declare const getTelemetryConfig: () => Promise<TelemetryConfig | undefined>;
+export declare const setTelemetryConfig: (config: TelemetryConfig) => Promise<void>;
+export declare const enableTelemetry: (provider: string, options: Omit<TelemetryConfig, "enabled" | "provider">) => Promise<void>;
+export declare const disableTelemetry: () => Promise<void>;
+export declare const deleteTelemetryConfig: () => Promise<boolean>;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/auth/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/auth/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjE,KAAK,eAAe,GAAG;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AA4CF,eAAO,MAAM,eAAe,mCAG3B,CAAC;AAEF,eAAO,MAAM,eAAe,GAAU,OAAO,MAAM,oBAKlD,CAAC;AAIF,eAAO,MAAM,WAAW,QAAa,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGlE,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAU,OAAO,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAGxE,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAU,OAAO,MAAM,EAAE,OAAO,MAAM,KAAG,OAAO,CAAC,MAAM,CAM3E,CAAC;AAEF,eAAO,MAAM,WAAW,GAAU,OAAO,MAAM,KAAG,OAAO,CAAC,OAAO,CAQhE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAU,WAAW,MAAM,KAAG,OAAO,CAAC,MAAM,CAGpE,CAAC;AAIF,eAAO,MAAM,WAAW,QAAa,OAAO,CAAC,aAAa,CAGzD,CAAC;AAEF,eAAO,MAAM,SAAS,GAAU,UAAU,MAAM,KAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAG/E,CAAC;AAEF,eAAO,MAAM,SAAS,GAAU,UAAU,MAAM,EAAE,KAAK,SAAS,KAAG,OAAO,CAAC,IAAI,CAU9E,CAAC;AAEF,eAAO,MAAM,YAAY,GAAU,UAAU,MAAM,KAAG,OAAO,CAAC,OAAO,CAQpE,CAAC;AAIF,eAAO,MAAM,kBAAkB,QAAa,OAAO,CAAC,eAAe,GAAG,SAAS,CAG9E,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAU,QAAQ,eAAe,KAAG,OAAO,CAAC,IAAI,CAI9E,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,UAAU,MAAM,EAChB,SAAS,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,UAAU,CAAC,KACrD,OAAO,CAAC,IAAI,CAQd,CAAC;AAEF,eAAO,MAAM,gBAAgB,QAAa,OAAO,CAAC,IAAI,CAMrD,CAAC;AAEF,eAAO,MAAM,qBAAqB,QAAa,OAAO,CAAC,OAAO,CAQ7D,CAAC"}

package/dist/auth/tokens.d.ts

@@ -0,0 +1,18 @@
+export type TokenStorageType = "auto" | "keychain" | "file";
+export type TokenEntry = {
+    storage: "keychain" | "file";
+    token?: string;
+    account?: string;
+    service?: string;
+};
+export declare const listStoredProviders: () => Promise<{
+    provider: string;
+    storage: "file" | "keychain";
+}[]>;
+export declare const setProviderToken: (provider: string, token: string, storage?: TokenStorageType) => Promise<"file" | "keychain">;
+export declare const deleteProviderToken: (provider: string) => Promise<boolean>;
+export declare const resolveProviderToken: (provider: string) => Promise<string | undefined>;
+export declare const getProviderTokenOrThrow: (provider: string) => Promise<string>;
+export declare const resolveProviderEnvVar: (provider: string) => "OPENAI_API_KEY" | "ANTHROPIC_API_KEY" | "GOOGLE_GENERATIVE_AI_API_KEY" | "OPENCODE_API_KEY" | "OPENROUTER_API_KEY" | undefined;
+export declare const maskToken: (token: string) => string;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/auth/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/auth/tokens.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;AAE5D,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,UAAU,GAAG,MAAM,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AA8GF,eAAO,MAAM,mBAAmB;;;IAM/B,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,UAAU,MAAM,EAChB,OAAO,MAAM,EACb,UAAS,gBAAyB,iCA8BnC,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAU,UAAU,MAAM,qBAkBzD,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAU,UAAU,MAAM,gCAgB1D,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAU,UAAU,MAAM,oBAM7D,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,UAAU,MAAM,oIAerD,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,WAKtC,CAAC"}

package/dist/chunking/ArtifactBatcher.d.ts

@@ -0,0 +1,11 @@
+import type { Artifact } from "../types";
+import type { DebugLogger } from "../debug/logger";
+import { type TokenCountOptions } from "../tokenization";
+export type BatchOptions = TokenCountOptions & {
+    maxTokens: number;
+    maxImages?: number;
+    modelMaxTokens?: number;
+    debug?: DebugLogger;
+};
+export declare const batchArtifacts: (artifacts: Artifact[], options: BatchOptions) => Artifact[][];
+//# sourceMappingURL=ArtifactBatcher.d.ts.map

package/dist/chunking/ArtifactBatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArtifactBatcher.d.ts","sourceRoot":"","sources":["../../src/chunking/ArtifactBatcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAC;AAGzB,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,cAAc,GACzB,WAAW,QAAQ,EAAE,EACrB,SAAS,YAAY,KACpB,QAAQ,EAAE,EA0FZ,CAAC"}

package/dist/chunking/ArtifactSplitter.d.ts

@@ -0,0 +1,10 @@
+import type { Artifact } from "../types";
+import type { DebugLogger } from "../debug/logger";
+import { type TokenCountOptions } from "../tokenization";
+export type SplitOptions = TokenCountOptions & {
+    maxTokens: number;
+    maxImages?: number;
+    debug?: DebugLogger;
+};
+export declare const splitArtifact: (artifact: Artifact, options: SplitOptions) => Artifact[];
+//# sourceMappingURL=ArtifactSplitter.d.ts.map

package/dist/chunking/ArtifactSplitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArtifactSplitter.d.ts","sourceRoot":"","sources":["../../src/chunking/ArtifactSplitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAmB,MAAM,UAAU,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAKL,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC;AA8CF,eAAO,MAAM,aAAa,GACxB,UAAU,QAAQ,EAClB,SAAS,YAAY,KACpB,QAAQ,EAuFV,CAAC"}

package/dist/debug/logger.d.ts

@@ -0,0 +1,169 @@
+import type { StepInfo, ProgressInfo, RetryInfo, TokenUsageInfo } from "../types";
+export type DebugLogger = ReturnType<typeof createDebugLogger>;
+export declare const createDebugLogger: (enabled: boolean) => {
+    cliInit: (data: {
+        args: Record<string, unknown>;
+    }) => void;
+    schemaLoaded: (data: {
+        source: string;
+        schemaSize: number;
+    }) => void;
+    artifactsLoaded: (data: {
+        count: number;
+        artifacts: Array<{
+            id: string;
+            type: string;
+            contentCount: number;
+            tokens?: number;
+        }>;
+        totalTokens: number;
+        totalImages: number;
+    }) => void;
+    modelResolved: (data: {
+        modelSpec: string;
+        resolvedModel: string;
+    }) => void;
+    strategyCreated: (data: {
+        strategy: string;
+        config: Record<string, unknown>;
+    }) => void;
+    chunkingStart: (data: {
+        artifactId: string;
+        totalTokens: number;
+        maxTokens: number;
+        maxImages?: number;
+    }) => void;
+    chunkingSplit: (data: {
+        artifactId: string;
+        originalContentCount: number;
+        splitContentCount: number;
+        splitReason: "text_too_long" | "content_limit";
+        originalTokens: number;
+        chunkSize: number;
+    }) => void;
+    chunkingResult: (data: {
+        artifactId: string;
+        chunksCreated: number;
+        chunkSizes: number[];
+    }) => void;
+    batchingStart: (data: {
+        totalArtifacts: number;
+        maxTokens: number;
+        maxImages?: number;
+        modelMaxTokens?: number;
+        effectiveMaxTokens: number;
+    }) => void;
+    batchCreated: (data: {
+        batchIndex: number;
+        artifactCount: number;
+        totalTokens: number;
+        totalImages: number;
+        artifactIds: string[];
+    }) => void;
+    batchingComplete: (data: {
+        totalBatches: number;
+        batches: Array<{
+            index: number;
+            artifactCount: number;
+            tokens: number;
+            images: number;
+        }>;
+    }) => void;
+    strategyRunStart: (data: {
+        strategy: string;
+        estimatedSteps: number;
+        artifactCount: number;
+    }) => void;
+    step: (data: StepInfo & {
+        strategy: string;
+    }) => void;
+    progress: (data: ProgressInfo & {
+        strategy: string;
+        context?: string;
+    }) => void;
+    llmCallStart: (data: {
+        callId: string;
+        model: string;
+        schemaName?: string;
+        systemLength: number;
+        userLength: number;
+        artifactCount: number;
+    }) => void;
+    llmCallComplete: (data: {
+        callId: string;
+        success: boolean;
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+        durationMs?: number;
+        error?: string;
+    }) => void;
+    retry: (data: RetryInfo & {
+        callId: string;
+    }) => void;
+    validationStart: (data: {
+        callId: string;
+        attempt: number;
+        maxAttempts: number;
+        strict: boolean;
+    }) => void;
+    validationSuccess: (data: {
+        callId: string;
+        attempt: number;
+    }) => void;
+    validationFailed: (data: {
+        callId: string;
+        attempt: number;
+        errors: unknown[];
+    }) => void;
+    mergeStart: (data: {
+        mergeId: string;
+        inputCount: number;
+        strategy: string;
+    }) => void;
+    mergeComplete: (data: {
+        mergeId: string;
+        success: boolean;
+        error?: string;
+    }) => void;
+    dedupeStart: (data: {
+        dedupeId: string;
+        itemCount: number;
+    }) => void;
+    dedupeComplete: (data: {
+        dedupeId: string;
+        duplicatesFound: number;
+        itemsRemoved: number;
+    }) => void;
+    tokenUsage: (data: TokenUsageInfo & {
+        context: string;
+    }) => void;
+    extractionComplete: (data: {
+        success: boolean;
+        totalInputTokens: number;
+        totalOutputTokens: number;
+        totalTokens: number;
+        error?: string;
+    }) => void;
+    promptSystem: (data: {
+        callId: string;
+        system: string;
+    }) => void;
+    promptUser: (data: {
+        callId: string;
+        user: unknown;
+    }) => void;
+    rawResponse: (data: {
+        callId: string;
+        response: unknown;
+    }) => void;
+    smartMergeField: (data: {
+        mergeId: string;
+        field: string;
+        operation: "merge_arrays" | "merge_objects" | "replace" | "concat";
+        leftCount?: number;
+        rightCount?: number;
+        resultCount?: number;
+    }) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/debug/logger.d.ts.map

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

package/dist/extract.d.ts

@@ -0,0 +1,3 @@
+import type { ExtractionOptions, ExtractionResult } from "./types";
+export declare const extract: <T>(options: ExtractionOptions<T>) => Promise<ExtractionResult<T>>;
+//# sourceMappingURL=extract.d.ts.map

package/dist/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../src/extract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAuDnE,eAAO,MAAM,OAAO,GAAU,CAAC,EAC7B,SAAS,iBAAiB,CAAC,CAAC,CAAC,KAC5B,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAwH7B,CAAC"}

package/dist/fields.d.ts

@@ -0,0 +1,75 @@
+/**
+ * fields.ts — Shorthand schema builder.
+ *
+ * Parses a comma-separated fields string into a minimal JSON Schema object.
+ * Supported type expressions:
+ *
+ *   string (default)   title
+ *   number / float     price:number  or  price:float
+ *   boolean / bool     active:boolean  or  active:bool
+ *   integer            count:integer
+ *   int                count:int  (integer + multipleOf:1 to disallow fractions)
+ *   enum               status:enum{draft|published|archived}
+ *   array of scalar    tags:array{string}
+ *   array (shorthand)  tags:array  (defaults to array{string})
+ *
+ * Aliases:
+ *   bool  → boolean
+ *   float → number
+ *   int   → integer (with multipleOf: 1)
+ *
+ * Examples:
+ *   parseFieldsString("title, description")
+ *   parseFieldsString("title, price:number")
+ *   parseFieldsString("title , price: number , active:boolean")
+ *   parseFieldsString("name, status:enum{draft|published}")
+ *   parseFieldsString("name, tags:array{string}")
+ *   parseFieldsString("name, tags:array")
+ *   parseFieldsString("count:int, ratio:float, enabled:bool")
+ */
+import type { AnyJSONSchema } from "./types";
+export type ScalarFieldType = "string" | "number" | "boolean" | "integer" | "int";
+export type ParsedField = {
+    name: string;
+    kind: "scalar";
+    type: ScalarFieldType;
+} | {
+    name: string;
+    kind: "enum";
+    values: string[];
+} | {
+    name: string;
+    kind: "array";
+    items: ScalarFieldType;
+};
+/** Legacy alias kept for backwards compatibility */
+export type FieldType = ScalarFieldType;
+/**
+ * Parse a comma-separated fields string into an array of ParsedField entries.
+ *
+ * @example
+ * parseFieldsString("title, price:number")
+ * // => [{ name: "title", kind: "scalar", type: "string" }, { name: "price", kind: "scalar", type: "number" }]
+ *
+ * parseFieldsString("status:enum{draft|published}")
+ * // => [{ name: "status", kind: "enum", values: ["draft", "published"] }]
+ *
+ * parseFieldsString("tags:array{string}")
+ * // => [{ name: "tags", kind: "array", items: "string" }]
+ */
+export declare const parseFieldsString: (fields: string) => ParsedField[];
+/**
+ * Build a minimal JSON Schema `object` from a parsed fields array.
+ * All fields are required; additionalProperties is false.
+ */
+export declare const buildSchemaFromParsedFields: (fields: ParsedField[]) => AnyJSONSchema;
+/**
+ * Convenience: parse a fields string and immediately build a JSON Schema.
+ *
+ * @example
+ * buildSchemaFromFields("title, price:number")
+ * buildSchemaFromFields("status:enum{draft|published|archived}")
+ * buildSchemaFromFields("tags:array{string}")
+ */
+export declare const buildSchemaFromFields: (fields: string) => AnyJSONSchema;
+//# sourceMappingURL=fields.d.ts.map

package/dist/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../src/fields.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAM7C,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,KAAK,CAAC;AAElF,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,eAAe,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,CAAC;AAE5D,oDAAoD;AACpD,MAAM,MAAM,SAAS,GAAG,eAAe,CAAC;AAqHxC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,KAAG,WAAW,EAwB7D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,2BAA2B,GACtC,QAAQ,WAAW,EAAE,KACpB,aA4BF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,MAAM,KAAG,aACC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+export type { Artifact, ArtifactContent, ArtifactImage, ArtifactType, ExtractionEvents, ExtractionOptions, ExtractionResult, ExtractionStrategy, Usage, AnyJSONSchema, TypedJSONSchema, AgentEvents, AgentToolStartInfo, AgentToolEndInfo, AgentMessageInfo, AgentReasoningInfo, TelemetryAdapter, } from "./types";
+export { extract } from "./extract";
+export { parseFieldsString, buildSchemaFromParsedFields, buildSchemaFromFields, } from "./fields";
+export type { ParsedField, FieldType } from "./fields";
+export type { ArtifactInput, ArtifactInputParser, SerializedArtifact, SerializedArtifactContent, SerializedArtifactImage, SerializedArtifacts, } from "./artifacts/input";
+export { urlToArtifact } from "./artifacts/urlToArtifact";
+export { fileToArtifact } from "./artifacts/fileToArtifact";
+export type { ArtifactProvider, ArtifactProviders } from "./artifacts/providers";
+export { defaultArtifactProviders } from "./artifacts/providers";
+export { registerArtifactInputParser, clearArtifactInputParsers, validateSerializedArtifacts, parseSerializedArtifacts, hydrateSerializedArtifacts, parse, splitTextIntoContents, } from "./artifacts/input";
+export * from "./strategies";
+export { collectStream } from "./parsers/collect";
+export type { ParserDef, ParsersConfig, InlineParserDef, NpmParserDef } from "./parsers/types";
+export { detectMimeType } from "./parsers/mime";
+export type { NpmParserEntry } from "./parsers/mime";
+export { runParser } from "./parsers/runner";
+export { parsePdf } from "./parsers/pdf";
+export { createDebugLogger } from "./debug/logger";
+export { listAllProviderModels, listProviderModels, resolveCheapestModel, } from "./llm/models";
+export { resolveModel } from "./llm/resolveModel";
+export { SchemaValidationError } from "./validation/validator";
+export { getDefaultModel, setDefaultModel, listAliases, getAlias, setAlias, deleteAlias, resolveAlias, listParsers, getParser, setParser, deleteParser, getTelemetryConfig, setTelemetryConfig, enableTelemetry, disableTelemetry, deleteTelemetryConfig, } from "./auth/config";
+export { listStoredProviders, setProviderToken, deleteProviderToken, resolveProviderToken, getProviderTokenOrThrow, resolveProviderEnvVar, maskToken, type TokenStorageType, type TokenEntry, } from "./auth/tokens";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,QAAQ,EACR,eAAe,EACf,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,EACL,aAAa,EACb,eAAe,EAEf,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAElB,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,iBAAiB,EACjB,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEvD,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,EACzB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,EACzB,2BAA2B,EAC3B,wBAAwB,EACxB,0BAA0B,EAC1B,KAAK,EACL,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAE3B,cAAc,cAAc,CAAC;AAG7B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGnD,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,OAAO,EACL,eAAe,EACf,eAAe,EACf,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,WAAW,EACX,SAAS,EACT,SAAS,EACT,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,UAAU,GAChB,MAAM,eAAe,CAAC"}