@struktur/sdk 2.1.2 → 2.3.0

package/dist/tokenization.d.ts

@@ -0,0 +1,11 @@
+import type { Artifact, ArtifactContent, ArtifactImage } from "./types";
+export type TokenCountOptions = {
+    textTokenRatio?: number;
+    defaultImageTokens?: number;
+};
+export declare const estimateTextTokens: (text: string, options?: TokenCountOptions) => number;
+export declare const estimateImageTokens: (_image: ArtifactImage, options?: TokenCountOptions) => number;
+export declare const countContentTokens: (content: ArtifactContent, options?: TokenCountOptions) => number;
+export declare const countArtifactTokens: (artifact: Artifact, options?: TokenCountOptions) => number;
+export declare const countArtifactImages: (artifact: Artifact) => number;
+//# sourceMappingURL=tokenization.d.ts.map

package/dist/tokenization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenization.d.ts","sourceRoot":"","sources":["../src/tokenization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAYF,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,EAAE,UAAU,iBAAiB,WAG3E,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,aAAa,EACrB,UAAU,iBAAiB,WAI5B,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC7B,SAAS,eAAe,EACxB,UAAU,iBAAiB,WAkB5B,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC9B,UAAU,QAAQ,EAClB,UAAU,iBAAiB,WAU5B,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,UAAU,QAAQ,WAIrD,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,178 @@
+import type { JSONSchemaType } from "ajv";
+import type { DebugLogger } from "./debug/logger";
+export type ArtifactType = "text" | "image" | "pdf" | "file";
+export type ImageType = "embedded" | "screenshot";
+export type ArtifactImage = {
+    type: "image";
+    url?: string;
+    base64?: string;
+    contents?: Buffer;
+    text?: string;
+    x?: number;
+    y?: number;
+    width?: number;
+    height?: number;
+    imageType?: ImageType;
+};
+export type ArtifactContent = {
+    page?: number;
+    text?: string;
+    media?: ArtifactImage[];
+};
+export interface Artifact {
+    id: string;
+    type: ArtifactType;
+    raw: () => Promise<Buffer>;
+    contents: ArtifactContent[];
+    metadata?: Record<string, unknown>;
+    tokens?: number;
+}
+export type Usage = {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+};
+export type ExtractionResult<T> = {
+    data: T;
+    usage: Usage;
+    error?: Error;
+};
+/**
+ * Telemetry adapter interface for tracing extraction operations.
+ * This is a minimal interface that matches the full TelemetryAdapter from @struktur/telemetry.
+ * SDK users should import adapters from @struktur/telemetry package.
+ */
+export interface TelemetryAdapter {
+    readonly name: string;
+    readonly version: string;
+    initialize(): Promise<void>;
+    shutdown(): Promise<void>;
+    startSpan(context: {
+        name: string;
+        kind: "CHAIN" | "LLM" | "TOOL" | "AGENT" | "RETRIEVER" | "EMBEDDING" | "RERANKER";
+        parentSpan?: {
+            id: string;
+            traceId: string;
+        };
+        attributes?: Record<string, unknown>;
+        startTime?: number;
+    }): {
+        id: string;
+        traceId: string;
+        name: string;
+        kind: string;
+        startTime: number;
+        parentId?: string;
+    };
+    endSpan(span: {
+        id: string;
+    }, result?: {
+        status: "ok" | "error";
+        error?: Error;
+        output?: unknown;
+        latencyMs?: number;
+    }): void;
+    recordEvent(span: {
+        id: string;
+    }, event: unknown): void;
+    setAttributes(span: {
+        id: string;
+    }, attributes: Record<string, unknown>): void;
+    setContext(context: {
+        sessionId?: string;
+        userId?: string;
+        metadata?: Record<string, unknown>;
+        tags?: string[];
+    }): void;
+}
+export type StepInfo = {
+    step: number;
+    total?: number;
+    label?: string;
+    detail?: string;
+};
+export type ProgressInfo = {
+    current: number;
+    total: number;
+    percent?: number;
+};
+export type MessageInfo = {
+    role: "system" | "user" | "assistant" | "tool";
+    content: unknown;
+};
+export type TokenUsageInfo = Usage & {
+    model?: string;
+};
+export type RetryInfo = {
+    attempt: number;
+    maxAttempts: number;
+    reason?: string;
+};
+export type AgentToolStartInfo = {
+    toolName: string;
+    toolCallId: string;
+    args: Record<string, unknown>;
+};
+export type AgentToolEndInfo = {
+    toolCallId: string;
+    result?: Record<string, unknown>;
+    error?: string;
+};
+export type AgentMessageInfo = {
+    content: string;
+    role?: "assistant" | "user";
+};
+export type AgentReasoningInfo = {
+    thought: string;
+};
+export type AgentEvents = {
+    onAgentToolStart?: (info: AgentToolStartInfo) => void | Promise<void>;
+    onAgentToolEnd?: (info: AgentToolEndInfo) => void | Promise<void>;
+    onAgentMessage?: (info: AgentMessageInfo) => void | Promise<void>;
+    onAgentReasoning?: (info: AgentReasoningInfo) => void | Promise<void>;
+};
+export type ExtractionEvents = {
+    onStep?: (info: StepInfo) => void | Promise<void>;
+    onMessage?: (info: MessageInfo) => void | Promise<void>;
+    onProgress?: (info: ProgressInfo) => void | Promise<void>;
+    onTokenUsage?: (info: TokenUsageInfo) => void | Promise<void>;
+    onRetry?: (info: RetryInfo) => void | Promise<void>;
+} & AgentEvents;
+export type AnyJSONSchema = Record<string, unknown>;
+export type TypedJSONSchema<T> = JSONSchemaType<T>;
+export type ProviderModelsResult = {
+    provider: string;
+    ok: boolean;
+    models?: string[];
+    error?: string;
+};
+export type ExtractionOptions<T> = {
+    artifacts: Artifact[];
+    /**
+     * JSON Schema for the extracted output.
+     * Exactly one of `schema`, `fields`, or an inline schema via the CLI must be provided.
+     */
+    schema?: TypedJSONSchema<T> | AnyJSONSchema;
+    /**
+     * Shorthand schema definition as a comma-separated string of `name` or `name:type` tokens.
+     * E.g. `"title, price:number"`. Defaults to `string` when no type is specified.
+     * Mutually exclusive with `schema`.
+     */
+    fields?: string;
+    strategy: ExtractionStrategy<T>;
+    events?: ExtractionEvents;
+    debug?: DebugLogger;
+    strict?: boolean;
+    /**
+     * Telemetry adapter for tracing extraction operations.
+     * Supports Phoenix (Arize), Langfuse, and other OpenTelemetry-compatible providers.
+     * Import from `@struktur/telemetry` package and pass the adapter here.
+     */
+    telemetry?: TelemetryAdapter | null;
+};
+export interface ExtractionStrategy<T> {
+    name: string;
+    run(options: ExtractionOptions<T>): Promise<ExtractionResult<T>>;
+    getEstimatedSteps?: (artifacts: Artifact[]) => number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/validation/validator.d.ts

@@ -0,0 +1,20 @@
+import Ajv, { type AnySchema, type ErrorObject, type JSONSchemaType } from "ajv";
+export type ValidationErrors = ErrorObject[];
+export type ValidationMode = 'strict' | 'lenient';
+export type ValidationResult<T> = {
+    valid: true;
+    data: T;
+} | {
+    valid: false;
+    errors: ErrorObject[];
+};
+export declare class SchemaValidationError extends Error {
+    readonly errors: ValidationErrors;
+    constructor(message: string, errors: ValidationErrors);
+}
+export declare const createAjv: () => Ajv;
+export type SchemaInput<T> = JSONSchemaType<T> | AnySchema;
+export declare const validateOrThrow: <T>(ajv: Ajv, schema: SchemaInput<T>, data: unknown) => T;
+export declare const isRequiredError: (error: ErrorObject) => boolean;
+export declare const validateAllowingMissingRequired: <T>(ajv: Ajv, schema: SchemaInput<T>, data: unknown, isFinalAttempt?: boolean) => ValidationResult<T>;
+//# sourceMappingURL=validator.d.ts.map

package/dist/validation/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/validation/validator.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,EAAE,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAGjF,MAAM,MAAM,gBAAgB,GAAG,WAAW,EAAE,CAAC;AAE7C,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,SAAS,CAAC;AAElD,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAC1B;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GACxB;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC;AAE5C,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,SAAgB,MAAM,EAAE,gBAAgB,CAAC;gBAE7B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB;CAKtD;AAID,eAAO,MAAM,SAAS,WAcrB,CAAC;AAEF,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;AAE3D,eAAO,MAAM,eAAe,GAAI,CAAC,EAC/B,KAAK,GAAG,EACR,QAAQ,WAAW,CAAC,CAAC,CAAC,EACtB,MAAM,OAAO,KACZ,CAWF,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,OAAO,WAAW,KAAG,OAEpD,CAAC;AAEF,eAAO,MAAM,+BAA+B,GAAI,CAAC,EAC/C,KAAK,GAAG,EACR,QAAQ,WAAW,CAAC,CAAC,CAAC,EACtB,MAAM,OAAO,EACb,iBAAgB,OAAc,KAC7B,gBAAgB,CAAC,CAAC,CAsBpB,CAAC"}

package/package.json

@@ -1,35 +1,51 @@
 {
   "name": "@struktur/sdk",
-  "version": "2.1.2",
+  "version": "2.3.0",
   "license": "FSL-1.1-MIT",
   "type": "module",
-  "main": "src/index.ts",
-  "types": "src/index.ts",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts",
-    "./strategies": "./src/strategies/index.ts",
-    "./artifacts": "./src/artifacts/index.ts",
-    "./parsers": "./src/parsers/index.ts",
-    "./auth": "./src/auth/index.ts",
-    "./llm": "./src/llm/index.ts",
-    "./validation": "./src/validation/index.ts",
-    "./debug": "./src/debug/index.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./strategies": {
+      "types": "./dist/strategies.d.ts",
+      "import": "./dist/strategies.js"
+    },
+    "./parsers": {
+      "types": "./dist/parsers.d.ts",
+      "import": "./dist/parsers.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup && tsc --project tsconfig.build.json && node scripts/postbuild.mjs",
+    "prepublishOnly": "bun run build"
   },
   "dependencies": {
     "@ai-sdk/anthropic": "^3.0.0",
     "@ai-sdk/google": "^3.0.0",
     "@ai-sdk/openai": "^3.0.0",
+    "@ai-sdk/provider": "^3.0.8",
+    "@mariozechner/pi-coding-agent": "^0.57.1",
     "@openrouter/ai-sdk-provider": "^2.0.0",
-    "@struktur/agent-strategy": "2.1.2",
+    "@sinclair/typebox": "^0.34.48",
     "ai": "^6.0.97",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
-    "pdf-parse": "^2.4.5"
+    "just-bash": "^2.11.15",
+    "pdf-parse": "^2.4.5",
+    "zod": "^3.25.76"
   },
   "peerDependencies": {
     "typescript": "^5"
   },
   "devDependencies": {
-    "@types/bun": "latest"
+    "@types/bun": "latest",
+    "tsup": "^8.0.0"
   }
 }

package/src/agent-cli-integration.test.ts

@@ -1,47 +0,0 @@
-import { test, expect, describe } from "bun:test";
-import { agent, AgentStrategy } from "@struktur/sdk";
-
-describe("Agent Strategy CLI Integration", () => {
-  test("agent strategy accepts provider and modelId", () => {
-    const strategy = agent<{ name: string }>({
-      provider: "anthropic",
-      modelId: "claude-sonnet-4",
-      maxSteps: 30,
-    });
-
-    expect(strategy).toBeInstanceOf(AgentStrategy);
-    expect(strategy.name).toBe("agent");
-    expect(strategy.getEstimatedSteps()).toBe(30);
-  });
-
-  test("agent strategy works with openai", () => {
-    const strategy = agent<{ name: string }>({
-      provider: "openai",
-      modelId: "gpt-4o",
-      maxSteps: 50,
-    });
-
-    expect(strategy).toBeInstanceOf(AgentStrategy);
-    expect(strategy.name).toBe("agent");
-  });
-
-  test("agent strategy works with openrouter nested paths", () => {
-    const strategy = agent<{ name: string }>({
-      provider: "openrouter",
-      modelId: "anthropic/claude-sonnet-4",
-      maxSteps: 50,
-    });
-
-    expect(strategy).toBeInstanceOf(AgentStrategy);
-    expect(strategy.name).toBe("agent");
-  });
-
-  test("agent strategy uses default maxSteps", () => {
-    const strategy = agent<{ name: string }>({
-      provider: "anthropic",
-      modelId: "claude-sonnet-4",
-    });
-
-    expect(strategy.getEstimatedSteps()).toBe(50);
-  });
-});

package/src/agent-export.test.ts

@@ -1,17 +0,0 @@
-import { test, expect } from "bun:test";
-import { agent, AgentStrategy } from "@struktur/sdk";
-
-test("agent strategy is exported from @struktur/sdk", () => {
-  expect(agent).toBeDefined();
-  expect(typeof agent).toBe("function");
-});
-
-test("AgentStrategy class is exported from @struktur/sdk", () => {
-  const strategy = agent({
-    provider: "anthropic",
-    modelId: "claude-sonnet-4",
-    maxSteps: 10,
-  });
-  expect(strategy).toBeInstanceOf(AgentStrategy);
-  expect(strategy.name).toBe("agent");
-});

package/src/agent-tool-labels.test.ts

@@ -1,50 +0,0 @@
-import { test, expect, describe } from "bun:test";
-import { agent, AgentStrategy } from "@struktur/sdk";
-
-describe("Agent Strategy Tool Labels", () => {
-  test("strategy creates properly configured agent", () => {
-    const strategy = agent<{ title: string }>({
-      provider: "anthropic",
-      modelId: "claude-sonnet-4",
-      maxSteps: 25,
-    });
-
-    expect(strategy).toBeDefined();
-    expect(strategy.name).toBe("agent");
-  });
-
-  test("label format for read tool with file path only", () => {
-    const label = "Read artifact.json";
-    expect(label).toBe("Read artifact.json");
-  });
-
-  test("label format for read tool with limit", () => {
-    const label = "Read artifact.json (limit 100)";
-    expect(label).toBe("Read artifact.json (limit 100)");
-  });
-
-  test("label format for read tool with offset and limit", () => {
-    const label = "Read artifact.json (offset 101, limit 100)";
-    expect(label).toBe("Read artifact.json (offset 101, limit 100)");
-  });
-
-  test("label format for bash command", () => {
-    const label = "Bash: cat /artifacts/artifact.json";
-    expect(label).toBe("Bash: cat /artifacts/artifact.json");
-  });
-
-  test("label format for grep", () => {
-    const label = 'Grep "pattern" in artifact.json';
-    expect(label).toBe('Grep "pattern" in artifact.json');
-  });
-
-  test("label format for find", () => {
-    const label = 'Find "*.json" in /artifacts';
-    expect(label).toBe('Find "*.json" in /artifacts');
-  });
-
-  test("label format for ls", () => {
-    const label = "List /artifacts (recursive)";
-    expect(label).toBe("List /artifacts (recursive)");
-  });
-});

package/src/artifacts/AGENTS.md

@@ -1,16 +0,0 @@
-Artifacts module
-
-- Purpose: convert external inputs into Artifacts and manage parser configuration.
-- Key files: `fileToArtifact.ts`, `urlToArtifact.ts`, `providers.ts`, `input.ts`.
-- Design: `ParsersConfig` is the unified configuration system for all parsers (npm packages, CLI commands, and inline handlers). The `providers` registry is deprecated — use inline parsers in `ParsersConfig` instead.
-- `parse` accepts an optional `parserConfig: ParsersConfig` (from `src/parsers/types`) that takes priority over the deprecated providers registry. Custom parsers are resolved by MIME type.
-- `ParsersConfig` supports four parser types:
-  - `NpmParserDef` — npm package with `parseFile` or `parseStream` exports
-  - `CommandFileDef` — CLI command with `FILE_PATH` placeholder
-  - `CommandStdinDef` — CLI command that reads from stdin
-  - `InlineParserDef` — inline `(buffer: Buffer) => Promise<Artifact>` function (replaces the old providers registry)
-- JSON auto-detection: when MIME type is `application/json`, `fileParser` first attempts to validate the file as `SerializedArtifact[]`. If valid, it hydrates and returns them directly. If not valid, it checks `parsers` config for a custom parser; if none, throws a clear error.
-- `parseBufferInput` resolution order: (1) parsers config, (2) providers registry (deprecated), (3) JSON auto-detection, (4) built-in `application/pdf` (via `parsePdf`), (5) built-in text/*, (6) built-in image/*, (7) error.
-- `parse` accepts `includeImages?: boolean` which is forwarded to `parsePdf` for PDF inputs. Set to `false` to suppress image extraction (used by `--no-images` CLI flag).
-- `SerializedArtifactImage` schema validation accepts an optional `imageType` field with values `"embedded"` or `"screenshot"` to differentiate between embedded images extracted from PDFs and page screenshots.
-- Tests: `fileToArtifact.test.ts`, `urlToArtifact.test.ts`, `input.test.ts`, `providers.test.ts`.

package/src/artifacts/fileToArtifact.test.ts

@@ -1,37 +0,0 @@
-import { test, expect } from "bun:test";
-import { fileToArtifact } from "./fileToArtifact";
-import type { ArtifactType } from "../types";
-
-test("fileToArtifact uses custom providers", async () => {
-  const providers = {
-    "text/plain": async (buffer: Buffer): Promise<{ id: string; type: ArtifactType; raw: () => Promise<Buffer>; contents: { text: string }[] }> => ({
-      id: "a1",
-      type: "text",
-      raw: async () => buffer,
-      contents: [{ text: buffer.toString() }],
-    }),
-  };
-
-  const artifact = await fileToArtifact(Buffer.from("hello"), {
-    mimeType: "text/plain",
-    providers,
-  });
-
-  expect(artifact.id).toBe("a1");
-  expect(artifact.contents[0]?.text).toBe("hello");
-});
-
-test("fileToArtifact falls back to text for text/* mime types", async () => {
-  const artifact = await fileToArtifact(Buffer.from("hello world"), {
-    mimeType: "text/plain",
-  });
-
-  expect(artifact.type).toBe("text");
-  expect(artifact.contents[0]?.text).toBe("hello world");
-});
-
-test("fileToArtifact throws for unknown mime types", async () => {
-  await expect(
-    fileToArtifact(Buffer.from("test"), { mimeType: "application/unknown" })
-  ).rejects.toThrow("No artifact provider registered");
-});

package/src/artifacts/fileToArtifact.ts

@@ -1,44 +0,0 @@
-import type { Artifact } from "../types";
-import { defaultArtifactProviders, type ArtifactProviders } from "./providers";
-
-export type FileToArtifactOptions = {
-  mimeType: string;
-  providers?: ArtifactProviders;
-};
-
-const bufferToTextArtifact = (buffer: Buffer): Artifact => ({
-  id: `artifact-${crypto.randomUUID()}`,
-  type: "text",
-  raw: async () => buffer,
-  contents: [{ text: buffer.toString() }],
-});
-
-const bufferToImageArtifact = (buffer: Buffer): Artifact => ({
-  id: `artifact-${crypto.randomUUID()}`,
-  type: "image",
-  raw: async () => buffer,
-  contents: [{ media: [{ type: "image", contents: buffer }] }],
-});
-
-export const fileToArtifact = async (
-  buffer: Buffer,
-  options: FileToArtifactOptions
-): Promise<Artifact> => {
-  const providers = options.providers ?? defaultArtifactProviders;
-  const provider = providers[options.mimeType];
-  if (provider) {
-    return provider(buffer);
-  }
-
-  if (options.mimeType.startsWith("text/")) {
-    return bufferToTextArtifact(buffer);
-  }
-
-  if (options.mimeType.startsWith("image/")) {
-    return bufferToImageArtifact(buffer);
-  }
-
-  throw new Error(
-    `No artifact provider registered for ${options.mimeType}`
-  );
-};