@levelcode/sdk 0.2.3 → 0.2.5

package/dist/sdk/src/client.d.ts

@@ -1,71 +0,0 @@
-import type { RunOptions, LevelCodeClientOptions } from './run';
-import type { RunState } from './run-state';
-import type { CreateTeamOptions, TeamStatus, RunWithTeamOptions } from './team';
-import type { TeamConfig } from '@levelcode/common/types/team-config';
-import type { TeamSummary } from '@levelcode/common/utils/team-discovery';
-export declare class LevelCodeClient {
-    options: LevelCodeClientOptions & {
-        apiKey: string;
-        fingerprintId: string;
-    };
-    constructor(options: LevelCodeClientOptions);
-    /**
-     * Run a LevelCode agent with the specified options.
-     *
-     * @param agent - The agent to run. Use 'base' for the default agent, or specify a custom agent ID if you made your own agent config.
-     * @param prompt - The user prompt describing what you want the agent to do.
-     * @param params - (Optional) Additional parameters for the agent. Most agents don't use this, but some custom agents can take a JSON object as input in addition to the user prompt string.
-     * @param handleEvent - (Optional) Callback function that receives every event during execution (assistant messages, tool calls, etc.). This allows you to stream the agent's progress in real-time. We will likely add a token-by-token streaming callback in the future.
-     * @param previousRun - (Optional) JSON state returned from a previous run() call. Use this to continue a conversation or session with the agent, maintaining context from previous interactions.
-     * @param projectFiles - (Optional) All the files in your project as a plain JavaScript object. Keys should be the full path from your current directory to each file, and values should be the string contents of the file. Example: { "src/index.ts": "console.log('hi')" }. This helps LevelCode pick good source files for context.
-     * @param knowledgeFiles - (Optional) Knowledge files to inject into every run() call. Uses the same schema as projectFiles - keys are file paths and values are file contents. These files are added directly to the agent's context.
-     * @param agentDefinitions - (Optional) Array of custom agent definitions. Each object should satisfy the AgentDefinition type. You can input the agent's id field into the agent parameter to run that agent.
-     * @param customToolDefinitions - (Optional) Array of custom tool definitions that extend the agent's capabilities. Each tool definition includes a name, Zod schema for input validation, and a handler function. These tools can be called by the agent during execution.
-     * @param maxAgentSteps - (Optional) Maximum number of steps the agent can take before stopping. Use this as a safety measure in case your agent starts going off the rails. A reasonable number is around 20.
-     * @param env - (Optional) Environment variables to pass to terminal commands executed by the agent. These will be merged with the current process environment, with the custom values taking precedence. Can also be provided in individual run() calls to override.
-     *
-     * @returns A Promise that resolves to a RunState JSON object which you can pass to a subsequent run() call to continue the run. Use result.output to get the agent's output.
-     */
-    run(options: RunOptions & LevelCodeClientOptions): Promise<RunState>;
-    /**
-     * Check connection to the LevelCode backend by hitting the /healthz endpoint.
-     *
-     * @returns Promise that resolves to true if connected, false otherwise
-     */
-    checkConnection(): Promise<boolean>;
-    /**
-     * Create a new team for coordinating multiple agents.
-     *
-     * @param name - Unique name for the team.
-     * @param options - Optional configuration including description, phase, preset, members, and settings.
-     * @returns The created TeamConfig.
-     */
-    createTeam(name: string, options?: CreateTeamOptions): TeamConfig;
-    /**
-     * Delete a team and all its associated data (inboxes, tasks).
-     *
-     * @param name - Name of the team to delete.
-     */
-    deleteTeam(name: string): void;
-    /**
-     * Get the full status of a team including its config, tasks, and member count.
-     *
-     * @param name - Name of the team.
-     * @returns TeamStatus with config, tasks array, and memberCount.
-     */
-    getTeamStatus(name: string): TeamStatus;
-    /**
-     * List all teams with summary information (name, phase, member count).
-     *
-     * @returns Array of TeamSummary objects.
-     */
-    listTeams(): TeamSummary[];
-    /**
-     * Run an agent as part of a team. The agent will be registered as a team member
-     * and the run will include team context.
-     *
-     * @param options - Run options extended with teamName, memberName, and role.
-     * @returns A Promise that resolves to a RunState.
-     */
-    runWithTeam(options: RunWithTeamOptions): Promise<RunState>;
-}

package/dist/sdk/src/constants.d.ts

@@ -1,4 +0,0 @@
-import { IS_DEV, IS_TEST, IS_PROD } from '@levelcode/common/env';
-export { IS_DEV, IS_TEST, IS_PROD };
-export declare const LEVELCODE_BINARY = "levelcode";
-export declare const WEBSITE_URL: string;

package/dist/sdk/src/credentials.d.ts

@@ -1,58 +0,0 @@
-import type { ClientEnv } from '@levelcode/common/types/contracts/env';
-import type { User } from '@levelcode/common/util/credentials';
-export declare const userFromJson: (json: string) => User | null;
-/**
- * Get the config directory path based on the environment.
- * Uses the clientEnv to determine the environment suffix.
- */
-export declare const getConfigDir: (clientEnv?: ClientEnv) => string;
-/**
- * Get the credentials file path based on the environment.
- */
-export declare const getCredentialsPath: (clientEnv?: ClientEnv) => string;
-export declare const getUserCredentials: (clientEnv?: ClientEnv) => User | null;
-/**
- * Claude OAuth credentials stored in the credentials file.
- */
-export interface ClaudeOAuthCredentials {
-    accessToken: string;
-    refreshToken: string;
-    expiresAt: number;
-    connectedAt: number;
-}
-/**
- * Get Claude OAuth credentials from file or environment variable.
- * Environment variable takes precedence.
- * @returns OAuth credentials or null if not found
- */
-export declare const getClaudeOAuthCredentials: (clientEnv?: ClientEnv) => ClaudeOAuthCredentials | null;
-/**
- * Save Claude OAuth credentials to the credentials file.
- * Preserves existing user credentials.
- */
-export declare const saveClaudeOAuthCredentials: (credentials: ClaudeOAuthCredentials, clientEnv?: ClientEnv) => void;
-/**
- * Clear Claude OAuth credentials from the credentials file.
- * Preserves other credentials.
- */
-export declare const clearClaudeOAuthCredentials: (clientEnv?: ClientEnv) => void;
-/**
- * Check if Claude OAuth credentials are valid (not expired).
- * Returns true if credentials exist and haven't expired.
- */
-export declare const isClaudeOAuthValid: (clientEnv?: ClientEnv) => boolean;
-/**
- * Refresh the Claude OAuth access token using the refresh token.
- * Returns the new credentials if successful, null if refresh fails.
- * Uses a mutex to prevent concurrent refresh attempts.
- */
-export declare const refreshClaudeOAuthToken: (clientEnv?: ClientEnv) => Promise<ClaudeOAuthCredentials | null>;
-/**
- * Get valid Claude OAuth credentials, refreshing if necessary.
- * This is the main function to use when you need credentials for an API call.
- *
- * - Returns credentials immediately if valid (>5 min until expiry)
- * - Attempts refresh if token is expired or near-expiry
- * - Returns null if no credentials or refresh fails
- */
-export declare const getValidClaudeOAuthCredentials: (clientEnv?: ClientEnv) => Promise<ClaudeOAuthCredentials | null>;

package/dist/sdk/src/custom-tool.d.ts

@@ -1,32 +0,0 @@
-import type { ToolName } from '@levelcode/common/tools/constants';
-import type { ToolResultOutput } from '@levelcode/common/types/messages/content-part';
-import type { z } from 'zod/v4';
-export type CustomToolDefinition<N extends string = string, Args extends any = any, Input extends any = any> = {
-    toolName: N;
-    inputSchema: z.ZodType<Args, Input>;
-    description: string;
-    endsAgentStep: boolean;
-    exampleInputs: Input[];
-    execute: (params: Args) => Promise<ToolResultOutput[]>;
-};
-/**
- * Creates a CustomToolDefinition object
- *
- * @param toolName the name of the tool
- * @param inputSchema a Zod4 schema describing the input of the tool.
- * @param description a description of the tool to be passed to the LLM. This should describe what the tool does and when to use it.
- * @param endsAgentStep whether the tool ends the agent step. If `true`, this will be used as a "stop sequence" for the LLM. i.e. it will not be able to call any other tools after this one in a single step and must wait for the tool results. Used for tools that give more information to the LLM.
- * @param exampleInputs an array of example inputs for the tool.
- * @param execute what to do when the tool is called. Can be either a sync or async. Must return an array of {@linkcode ToolResultOutput}
- * @returns a {@linkcode CustomToolDefinition} object
- */
-export declare function getCustomToolDefinition<TN extends string, Args extends any, Input extends any>({ toolName, inputSchema, description, endsAgentStep, exampleInputs, execute, }: {
-    toolName: TN extends ToolName ? TN & {
-        error: `Hi there. This is a message from the LevelCode team: You have used a custom tool where you needed to use overrideTools instead for name: ${TN}`;
-    } : TN;
-    inputSchema: z.ZodType<Args, Input>;
-    description: string;
-    endsAgentStep?: boolean;
-    exampleInputs?: Input[];
-    execute: (params: Args) => Promise<ToolResultOutput[]> | ToolResultOutput[];
-}): CustomToolDefinition<TN, Args, Input>;

package/dist/sdk/src/env.d.ts

@@ -1,31 +0,0 @@
-/**
- * SDK environment helper for dependency injection.
- *
- * This module provides SDK-specific env helpers that extend the base
- * process env with SDK-specific vars for binary paths and WASM.
- */
-import type { SdkEnv } from './types/env';
-/**
- * Get SDK environment values.
- * Composes from getBaseEnv() + SDK-specific vars.
- */
-export declare const getSdkEnv: () => SdkEnv;
-export declare const getLevelCodeApiKeyFromEnv: () => string | undefined;
-export declare const getSystemProcessEnv: () => NodeJS.ProcessEnv;
-export declare const getByokOpenrouterApiKeyFromEnv: () => string | undefined;
-/**
- * Get Claude OAuth token from environment variable.
- * This allows users to provide their Claude Pro/Max OAuth token for direct Anthropic API access.
- */
-export declare const getClaudeOAuthTokenFromEnv: () => string | undefined;
-export declare const getOpenRouterApiKeyFromEnv: () => string | undefined;
-export declare const getOpenRouterBaseUrlFromEnv: () => string | undefined;
-export declare const getAnthropicApiKeyFromEnv: () => string | undefined;
-export declare const getAnthropicBaseUrlFromEnv: () => string | undefined;
-/**
- * Standalone mode: bypass all backend dependencies, route LLM calls directly.
- * Default mode when no backend URL (NEXT_PUBLIC_LEVELCODE_APP_URL) is configured.
- * Also activates when a direct provider key (OPENROUTER_API_KEY or ANTHROPIC_API_KEY)
- * is set AND LEVELCODE_API_KEY is NOT set.
- */
-export declare const isStandaloneMode: () => boolean;

package/dist/sdk/src/error-utils.d.ts

@@ -1,55 +0,0 @@
-/**
- * SDK Error Utilities
- *
- * Simple utilities for error handling based on HTTP status codes.
- * Uses the AI SDK's error types which include statusCode property.
- */
-/**
- * Error type with statusCode property
- */
-export type HttpError = Error & {
-    statusCode: number;
-};
-/**
- * HTTP status codes that should trigger automatic retry
- */
-export declare const RETRYABLE_STATUS_CODES: Set<number>;
-/**
- * Creates an Error with a statusCode property
- */
-export declare function createHttpError(message: string, statusCode: number): HttpError;
-/**
- * Creates an authentication error (401)
- */
-export declare function createAuthError(message?: string): HttpError;
-/**
- * Creates a forbidden error (403)
- */
-export declare function createForbiddenError(message?: string): HttpError;
-/**
- * Creates a payment required error (402)
- */
-export declare function createPaymentRequiredError(message?: string): HttpError;
-/**
- * Creates a server error (500 by default, or custom 5xx)
- */
-export declare function createServerError(message?: string, statusCode?: number): HttpError;
-/**
- * Creates a network error (503 - service unavailable)
- * Used for connection failures, DNS errors, timeouts, etc.
- */
-export declare function createNetworkError(message?: string): HttpError;
-/**
- * Checks if an HTTP status code is retryable
- */
-export declare function isRetryableStatusCode(statusCode: number | undefined): boolean;
-/**
- * Extracts the statusCode from an error if available.
- * Checks both 'statusCode' (our convention) and 'status' (AI SDK's APICallError convention).
- */
-export declare function getErrorStatusCode(error: unknown): number | undefined;
-/**
- * Sanitizes error messages for display
- * Removes sensitive information and formats for user consumption
- */
-export declare function sanitizeErrorMessage(error: unknown): string;

package/dist/sdk/src/impl/__tests__/prompt-result.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/sdk/src/impl/agent-runtime.d.ts

@@ -1,8 +0,0 @@
-import type { AgentRuntimeDeps, AgentRuntimeScopedDeps } from '@levelcode/common/types/contracts/agent-runtime';
-import type { ClientEnv } from '@levelcode/common/types/contracts/env';
-import type { Logger } from '@levelcode/common/types/contracts/logger';
-export declare function getAgentRuntimeImpl(params: {
-    logger?: Logger;
-    apiKey: string;
-    clientEnv?: ClientEnv;
-} & Pick<AgentRuntimeScopedDeps, 'handleStepsLogChunk' | 'requestToolCall' | 'requestMcpToolData' | 'requestFiles' | 'requestOptionalFile' | 'sendAction' | 'sendSubagentChunk'>): AgentRuntimeDeps & AgentRuntimeScopedDeps;

package/dist/sdk/src/impl/database.d.ts

@@ -1,7 +0,0 @@
-import type { AddAgentStepFn, FetchAgentFromDatabaseFn, FinishAgentRunFn, GetUserInfoFromApiKeyInput, GetUserInfoFromApiKeyOutput, StartAgentRunFn, UserColumn } from '@levelcode/common/types/contracts/database';
-import type { ParamsOf } from '@levelcode/common/types/function-params';
-export declare function getUserInfoFromApiKey<T extends UserColumn>(params: GetUserInfoFromApiKeyInput<T>): GetUserInfoFromApiKeyOutput<T>;
-export declare function fetchAgentFromDatabase(params: ParamsOf<FetchAgentFromDatabaseFn>): ReturnType<FetchAgentFromDatabaseFn>;
-export declare function startAgentRun(params: ParamsOf<StartAgentRunFn>): ReturnType<StartAgentRunFn>;
-export declare function finishAgentRun(params: ParamsOf<FinishAgentRunFn>): ReturnType<FinishAgentRunFn>;
-export declare function addAgentStep(params: ParamsOf<AddAgentStepFn>): ReturnType<AddAgentStepFn>;

package/dist/sdk/src/impl/llm.d.ts

@@ -1,8 +0,0 @@
-import type { PromptAiSdkFn, PromptAiSdkStreamFn, PromptAiSdkStructuredInput, PromptAiSdkStructuredOutput } from '@levelcode/common/types/contracts/llm';
-import type { ParamsOf } from '@levelcode/common/types/function-params';
-export declare function promptAiSdkStream(params: ParamsOf<PromptAiSdkStreamFn> & {
-    skipClaudeOAuth?: boolean;
-    onClaudeOAuthStatusChange?: (isActive: boolean) => void;
-}): ReturnType<PromptAiSdkStreamFn>;
-export declare function promptAiSdk(params: ParamsOf<PromptAiSdkFn>): ReturnType<PromptAiSdkFn>;
-export declare function promptAiSdkStructured<T>(params: PromptAiSdkStructuredInput<T>): PromptAiSdkStructuredOutput<T>;

package/dist/sdk/src/impl/model-provider.d.ts

@@ -1,61 +0,0 @@
-/**
- * Model provider abstraction for routing requests to the appropriate LLM provider.
- *
- * Routing priority:
- * 1. Claude OAuth: Direct requests to Anthropic API using user's OAuth token
- * 2. Standalone + OPENROUTER_API_KEY: Direct requests to OpenRouter (or custom base via OPENROUTER_BASE_URL)
- * 3. Standalone + ANTHROPIC_API_KEY: Direct requests to Anthropic API (or custom base via ANTHROPIC_BASE_URL)
- * 4. Non-standalone: Requests through LevelCode backend (which routes to OpenRouter)
- */
-import type { LanguageModel } from 'ai';
-/**
- * Mark Claude OAuth as rate-limited. Subsequent requests will skip Claude OAuth
- * and use LevelCode backend until the reset time.
- * @param resetAt - When the rate limit resets. If not provided, guesses 5 minutes from now.
- */
-export declare function markClaudeOAuthRateLimited(resetAt?: Date): void;
-/**
- * Check if Claude OAuth is currently rate-limited.
- * Returns true if rate-limited and reset time hasn't passed.
- */
-export declare function isClaudeOAuthRateLimited(): boolean;
-/**
- * Reset the Claude OAuth rate limit cache.
- * Call this when user reconnects their Claude subscription.
- */
-export declare function resetClaudeOAuthRateLimit(): void;
-/**
- * Fetch the rate limit reset time from Anthropic's quota API.
- * Returns the earliest reset time (whichever limit is more restrictive).
- * Returns null if fetch fails or no reset time is available.
- */
-export declare function fetchClaudeOAuthResetTime(accessToken: string): Promise<Date | null>;
-/**
- * Parameters for requesting a model.
- */
-export interface ModelRequestParams {
-    /** LevelCode API key for backend authentication */
-    apiKey: string;
-    /** Model ID (OpenRouter format, e.g., "anthropic/claude-sonnet-4") */
-    model: string;
-    /** If true, skip Claude OAuth and use LevelCode backend (for fallback after rate limit) */
-    skipClaudeOAuth?: boolean;
-}
-/**
- * Result from getModelForRequest.
- */
-export interface ModelResult {
-    /** The language model to use for requests */
-    model: LanguageModel;
-    /** Whether this model uses Claude OAuth direct (affects cost tracking) */
-    isClaudeOAuth: boolean;
-}
-/**
- * Get the appropriate model for a request.
- *
- * If Claude OAuth credentials are available and the model is a Claude model,
- * returns an Anthropic direct model. Otherwise, returns the LevelCode backend model.
- *
- * This function is async because it may need to refresh the OAuth token.
- */
-export declare function getModelForRequest(params: ModelRequestParams): Promise<ModelResult>;

package/dist/sdk/src/index.d.ts

@@ -1,42 +0,0 @@
-export type * from '@levelcode/common/types/json';
-export type * from '@levelcode/common/types/messages/levelcode-message';
-export type * from '@levelcode/common/types/messages/data-content';
-export type * from '@levelcode/common/types/print-mode';
-export type { TextPart, ImagePart, } from '@levelcode/common/types/messages/content-part';
-export { run } from './run';
-export { getFiles } from './tools/read-files';
-export type { FileFilter, FileFilterResult } from './tools/read-files';
-export type { RunOptions, MessageContent, TextContent, ImageContent, } from './run';
-export { buildUserMessageContent } from '@levelcode/agent-runtime/util/messages';
-export type { AgentDefinition } from '@levelcode/common/templates/initial-agents-dir/types/agent-definition';
-export type { ToolName } from '@levelcode/common/tools/constants';
-export type { ClientToolCall, ClientToolName, LevelCodeToolOutput, } from '@levelcode/common/tools/list';
-export * from './client';
-export * from './team';
-export * from './custom-tool';
-export * from './native/ripgrep';
-export * from './run-state';
-export { ToolHelpers } from './tools';
-export * from './constants';
-export { getUserInfoFromApiKey } from './impl/database';
-export { isStandaloneMode, getOpenRouterApiKeyFromEnv } from './env';
-export * from './credentials';
-export { loadLocalAgents } from './agents/load-agents';
-export { loadMCPConfig, loadMCPConfigSync } from './agents/load-mcp-config';
-export { loadSkills } from './skills/load-skills';
-export { formatAvailableSkillsXml } from '@levelcode/common/util/skills';
-export type { LoadSkillsOptions } from './skills/load-skills';
-export type { SkillDefinition, SkillsMap } from '@levelcode/common/types/skill';
-export type { LoadedAgents, LoadedAgentDefinition, LoadLocalAgentsResult, AgentValidationError, } from './agents/load-agents';
-export type { MCPFileConfig, LoadedMCPConfig, } from './agents/load-mcp-config';
-export { validateAgents } from './validate-agents';
-export type { ValidationResult, ValidateAgentsOptions } from './validate-agents';
-export { isRetryableStatusCode, getErrorStatusCode, sanitizeErrorMessage, RETRYABLE_STATUS_CODES, createHttpError, createAuthError, createForbiddenError, createPaymentRequiredError, createServerError, createNetworkError, } from './error-utils';
-export type { HttpError } from './error-utils';
-export { MAX_RETRIES_PER_MESSAGE, RETRY_BACKOFF_BASE_DELAY_MS, RETRY_BACKOFF_MAX_DELAY_MS, RECONNECTION_MESSAGE_DURATION_MS, RECONNECTION_RETRY_DELAY_MS, } from './retry-config';
-export type { LevelCodeFileSystem } from '@levelcode/common/types/filesystem';
-export { getFileTokenScores, setWasmDir } from '@levelcode/code-map';
-export type { FileTokenData, TokenCallerMap } from '@levelcode/code-map';
-export { runTerminalCommand } from './tools/run-terminal-command';
-export { promptAiSdk, promptAiSdkStream, promptAiSdkStructured, } from './impl/llm';
-export { resetClaudeOAuthRateLimit } from './impl/model-provider';

package/dist/sdk/src/native/ripgrep.d.ts

@@ -1,7 +0,0 @@
-import type { SdkEnv } from '../types/env';
-/**
- * Get the path to the bundled ripgrep binary based on the current platform
- * @param importMetaUrl - import.meta.url from the calling module
- * @returns Path to the ripgrep binary
- */
-export declare function getBundledRgPath(importMetaUrl?: string, env?: SdkEnv): string;

package/dist/sdk/src/retry-config.d.ts

@@ -1,46 +0,0 @@
-/**
- * Retry Configuration Constants
- *
- * This module defines constants for retry behavior and exponential backoff.
- * Used by the CLI to automatically retry failed messages after reconnection.
- *
- * @example
- * ```typescript
- * import { MAX_RETRIES_PER_MESSAGE, RETRY_BACKOFF_BASE_DELAY_MS } from '@levelcode/sdk'
- *
- * let retryCount = 0
- * let backoffDelay = RETRY_BACKOFF_BASE_DELAY_MS
- *
- * while (retryCount < MAX_RETRIES_PER_MESSAGE) {
- *   await new Promise(resolve => setTimeout(resolve, backoffDelay))
- *   // ... retry logic
- *   backoffDelay = Math.min(backoffDelay * 2, RETRY_BACKOFF_MAX_DELAY_MS)
- *   retryCount++
- * }
- * ```
- */
-/**
- * Maximum number of retry attempts per message
- * After this many attempts, the message is marked as permanently failed
- */
-export declare const MAX_RETRIES_PER_MESSAGE = 3;
-/**
- * Base delay in milliseconds for exponential backoff
- * First retry: 1s, Second: 2s, Third: 4s, Fourth: 8s (capped)
- */
-export declare const RETRY_BACKOFF_BASE_DELAY_MS = 1000;
-/**
- * Maximum delay in milliseconds for exponential backoff
- * Prevents backoff from growing indefinitely
- */
-export declare const RETRY_BACKOFF_MAX_DELAY_MS = 8000;
-/**
- * Duration in milliseconds to show the reconnection message
- * After this time, the message auto-hides
- */
-export declare const RECONNECTION_MESSAGE_DURATION_MS = 2000;
-/**
- * Delay in milliseconds before retrying messages after reconnection
- * Gives the connection time to stabilize before attempting retries
- */
-export declare const RECONNECTION_RETRY_DELAY_MS = 500;

package/dist/sdk/src/run-state.d.ts

@@ -1,81 +0,0 @@
-export { KNOWLEDGE_FILE_NAMES, PRIMARY_KNOWLEDGE_FILE_NAME, isKnowledgeFile, } from '@levelcode/common/constants/knowledge';
-import type { CustomToolDefinition } from './custom-tool';
-import type { AgentDefinition } from '@levelcode/common/templates/initial-agents-dir/types/agent-definition';
-import type { Logger } from '@levelcode/common/types/contracts/logger';
-import type { LevelCodeFileSystem } from '@levelcode/common/types/filesystem';
-import type { Message } from '@levelcode/common/types/messages/levelcode-message';
-import type { AgentOutput, SessionState } from '@levelcode/common/types/session-state';
-import type { LevelCodeSpawn } from '@levelcode/common/types/spawn';
-/**
- * Given a list of candidate file paths, selects the one with highest priority.
- * Priority order: knowledge.md > AGENTS.md > CLAUDE.md (case-insensitive).
- * Returns undefined if no knowledge files are found.
- * @internal Exported for testing
- */
-export declare function selectHighestPriorityKnowledgeFile(candidates: string[]): string | undefined;
-export type RunState = {
-    sessionState?: SessionState;
-    output: AgentOutput;
-};
-export type InitialSessionStateOptions = {
-    cwd?: string;
-    projectFiles?: Record<string, string>;
-    knowledgeFiles?: Record<string, string>;
-    /** User-provided knowledge files that will be merged with home directory files */
-    userKnowledgeFiles?: Record<string, string>;
-    agentDefinitions?: AgentDefinition[];
-    customToolDefinitions?: CustomToolDefinition[];
-    maxAgentSteps?: number;
-    fs?: LevelCodeFileSystem;
-    spawn?: LevelCodeSpawn;
-    logger?: Logger;
-};
-/**
- * Loads user knowledge files from the home directory.
- * Checks for ~/.knowledge.md, ~/.AGENTS.md, and ~/.CLAUDE.md with priority fallback.
- * Matching is case-insensitive (e.g., ~/.KNOWLEDGE.md will match).
- * Returns a record with the tilde-prefixed path as key (e.g., "~/.knowledge.md").
- * @internal Exported for testing
- */
-export declare function loadUserKnowledgeFiles(params: {
-    fs: LevelCodeFileSystem;
-    logger: Logger;
-    /** Optional home directory override for testing */
-    homeDir?: string;
-}): Promise<Record<string, string>>;
-/**
- * Selects knowledge files from a list of file paths with fallback logic.
- * For each directory, checks for knowledge.md first, then AGENTS.md, then CLAUDE.md.
- * @internal Exported for testing
- */
-export declare function selectKnowledgeFilePaths(allFilePaths: string[]): string[];
-export declare function initialSessionState(params: InitialSessionStateOptions): Promise<SessionState>;
-export declare function generateInitialRunState({ cwd, projectFiles, knowledgeFiles, userKnowledgeFiles, agentDefinitions, customToolDefinitions, maxAgentSteps, fs, }: {
-    cwd: string;
-    projectFiles?: Record<string, string>;
-    knowledgeFiles?: Record<string, string>;
-    userKnowledgeFiles?: Record<string, string>;
-    agentDefinitions?: AgentDefinition[];
-    customToolDefinitions?: CustomToolDefinition[];
-    maxAgentSteps?: number;
-    fs: LevelCodeFileSystem;
-}): Promise<RunState>;
-export declare function withAdditionalMessage({ runState, message, }: {
-    runState: RunState;
-    message: Message;
-}): RunState;
-export declare function withMessageHistory({ runState, messages, }: {
-    runState: RunState;
-    messages: Message[];
-}): RunState;
-/**
- * Applies overrides to an existing session state, allowing specific fields to be updated
- * even when continuing from a previous run.
- */
-export declare function applyOverridesToSessionState(cwd: string | undefined, baseSessionState: SessionState, overrides: {
-    projectFiles?: Record<string, string>;
-    knowledgeFiles?: Record<string, string>;
-    agentDefinitions?: AgentDefinition[];
-    customToolDefinitions?: CustomToolDefinition[];
-    maxAgentSteps?: number;
-}): Promise<SessionState>;

package/dist/sdk/src/run.d.ts

@@ -1,79 +0,0 @@
-import type { CustomToolDefinition } from './custom-tool';
-import type { RunState } from './run-state';
-import type { FileFilter } from './tools/read-files';
-import type { AgentDefinition } from '@levelcode/common/templates/initial-agents-dir/types/agent-definition';
-import type { PublishedToolName } from '@levelcode/common/tools/constants';
-import type { ClientToolCall, ClientToolName, LevelCodeToolOutput } from '@levelcode/common/tools/list';
-import type { Logger } from '@levelcode/common/types/contracts/logger';
-import type { LevelCodeFileSystem } from '@levelcode/common/types/filesystem';
-import type { ToolMessage } from '@levelcode/common/types/messages/levelcode-message';
-import type { PrintModeEvent } from '@levelcode/common/types/print-mode';
-import type { Source } from '@levelcode/common/types/source';
-import type { LevelCodeSpawn } from '@levelcode/common/types/spawn';
-export type LevelCodeClientOptions = {
-    apiKey?: string;
-    cwd?: string;
-    projectFiles?: Record<string, string>;
-    knowledgeFiles?: Record<string, string>;
-    agentDefinitions?: AgentDefinition[];
-    maxAgentSteps?: number;
-    env?: Record<string, string>;
-    handleEvent?: (event: PrintModeEvent) => void | Promise<void>;
-    handleStreamChunk?: (chunk: string | {
-        type: 'subagent_chunk';
-        agentId: string;
-        agentType: string;
-        chunk: string;
-    } | {
-        type: 'reasoning_chunk';
-        agentId: string;
-        ancestorRunIds: string[];
-        chunk: string;
-    }) => void | Promise<void>;
-    /** Optional filter to classify files before reading (runs before gitignore check) */
-    fileFilter?: FileFilter;
-    overrideTools?: Partial<{
-        [K in ClientToolName & PublishedToolName]: (input: ClientToolCall<K>['input']) => Promise<LevelCodeToolOutput<K>>;
-    } & {
-        read_files: (input: {
-            filePaths: string[];
-        }) => Promise<Record<string, string | null>>;
-    }>;
-    customToolDefinitions?: CustomToolDefinition[];
-    fsSource?: Source<LevelCodeFileSystem>;
-    spawnSource?: Source<LevelCodeSpawn>;
-    logger?: Logger;
-};
-export type ImageContent = {
-    type: 'image';
-    image: string;
-    mediaType: string;
-};
-export type TextContent = {
-    type: 'text';
-    text: string;
-};
-export type MessageContent = TextContent | ImageContent;
-export type RunOptions = {
-    agent: string | AgentDefinition;
-    prompt: string;
-    /** Content array for multimodal messages (text + images) */
-    content?: MessageContent[];
-    params?: Record<string, any>;
-    previousRun?: RunState;
-    extraToolResults?: ToolMessage[];
-    signal?: AbortSignal;
-    costMode?: string;
-};
-type RunExecutionOptions = RunOptions & LevelCodeClientOptions & {
-    apiKey: string;
-    fingerprintId: string;
-};
-export declare function run(options: RunExecutionOptions): Promise<RunState>;
-/**
- * Extracts an HTTP status code from an error message string.
- * Parses common error patterns to identify the underlying status code.
- * Returns the status code if found, undefined otherwise.
- */
-export declare const extractStatusCodeFromMessage: (errorMessage: string) => number | undefined;
-export {};

package/dist/sdk/src/skills/load-skills.d.ts

@@ -1,42 +0,0 @@
-import { type SkillsMap } from '@levelcode/common/types/skill';
-export { formatAvailableSkillsXml } from '@levelcode/common/util/skills';
-export type LoadSkillsOptions = {
-    /** Working directory for project skills. Defaults to process.cwd() */
-    cwd?: string;
-    /** Optional specific skills directory path */
-    skillsPath?: string;
-    /** Whether to log errors during loading */
-    verbose?: boolean;
-};
-/**
- * Load skills from .agents/skills and .claude/skills directories.
- *
- * By default, searches for skills in (later overrides earlier):
- * - `~/.claude/skills/` (global, Claude Code compatible)
- * - `~/.agents/skills/` (global)
- * - `{cwd}/.claude/skills/` (project, Claude Code compatible)
- * - `{cwd}/.agents/skills/` (project, highest priority)
- *
- * Each skill must be in its own directory with a SKILL.md file:
- * - `.agents/skills/my-skill/SKILL.md`
- * - `.claude/skills/my-skill/SKILL.md`
- *
- * @param options.cwd - Working directory for project skills
- * @param options.skillsPath - Optional path to a specific skills directory
- * @param options.verbose - Whether to log errors during loading
- * @returns Record of skill definitions keyed by skill name
- *
- * @example
- * ```typescript
- * // Load from default locations
- * const skills = await loadSkills({ verbose: true })
- *
- * // Load from a specific directory
- * const skills = await loadSkills({ skillsPath: './my-skills' })
- *
- * // Access a skill
- * const gitReleaseSkill = skills['git-release']
- * console.log(gitReleaseSkill.description)
- * ```
- */
-export declare function loadSkills(options?: LoadSkillsOptions): Promise<SkillsMap>;