@levelcode/sdk 0.2.0 → 0.2.2

package/dist/agents/types/tools.d.ts

@@ -1,308 +0,0 @@
-/**
- * Union type of all available tool names
- */
-export type ToolName = 'add_message' | 'ask_user' | 'code_search' | 'end_turn' | 'find_files' | 'glob' | 'list_directory' | 'lookup_agent_info' | 'propose_str_replace' | 'propose_write_file' | 'read_docs' | 'read_files' | 'read_subtree' | 'run_file_change_hooks' | 'run_terminal_command' | 'set_messages' | 'set_output' | 'skill' | 'spawn_agents' | 'str_replace' | 'suggest_followups' | 'task_completed' | 'think_deeply' | 'web_search' | 'write_file' | 'write_todos';
-/**
- * Map of tool names to their parameter types
- */
-export interface ToolParamsMap {
-    add_message: AddMessageParams;
-    ask_user: AskUserParams;
-    code_search: CodeSearchParams;
-    end_turn: EndTurnParams;
-    find_files: FindFilesParams;
-    glob: GlobParams;
-    list_directory: ListDirectoryParams;
-    lookup_agent_info: LookupAgentInfoParams;
-    propose_str_replace: ProposeStrReplaceParams;
-    propose_write_file: ProposeWriteFileParams;
-    read_docs: ReadDocsParams;
-    read_files: ReadFilesParams;
-    read_subtree: ReadSubtreeParams;
-    run_file_change_hooks: RunFileChangeHooksParams;
-    run_terminal_command: RunTerminalCommandParams;
-    set_messages: SetMessagesParams;
-    set_output: SetOutputParams;
-    skill: SkillParams;
-    spawn_agents: SpawnAgentsParams;
-    str_replace: StrReplaceParams;
-    suggest_followups: SuggestFollowupsParams;
-    task_completed: TaskCompletedParams;
-    think_deeply: ThinkDeeplyParams;
-    web_search: WebSearchParams;
-    write_file: WriteFileParams;
-    write_todos: WriteTodosParams;
-}
-/**
- * Add a new message to the conversation history. To be used for complex requests that can't be solved in a single step, as you may forget what happened!
- */
-export interface AddMessageParams {
-    role: 'user' | 'assistant';
-    content: string;
-}
-/**
- * Ask the user multiple choice questions and pause execution until they respond.
- */
-export interface AskUserParams {
-    /** List of multiple choice questions to ask the user */
-    questions: {
-        /** The question to ask the user */
-        question: string;
-        /** Short label (max 12 chars) displayed as a chip/tag */
-        header?: string;
-        /** Array of answer options with label and optional description (minimum 2) */
-        options: {
-            /** The display text for this option */
-            label: string;
-            /** Explanation shown when option is focused */
-            description?: string;
-        }[];
-        /** If true, allows selecting multiple options (checkbox). If false, single selection only (radio). */
-        multiSelect?: boolean;
-        /** Validation rules for "Other" text input */
-        validation?: {
-            /** Maximum length for "Other" text input */
-            maxLength?: number;
-            /** Minimum length for "Other" text input */
-            minLength?: number;
-            /** Regex pattern for "Other" text input */
-            pattern?: string;
-            /** Custom error message when pattern fails */
-            patternError?: string;
-        };
-    }[];
-}
-/**
- * Search for string patterns in the project's files. This tool uses ripgrep (rg), a fast line-oriented search tool. Use this tool only when read_files is not sufficient to find the files you need.
- */
-export interface CodeSearchParams {
-    /** The pattern to search for. */
-    pattern: string;
-    /** Optional ripgrep flags to customize the search (e.g., "-i" for case-insensitive, "-g *.ts -g *.js" for TypeScript and JavaScript files only, "-g !*.test.ts" to exclude Typescript test files,  "-A 3" for 3 lines after match, "-B 2" for 2 lines before match). */
-    flags?: string;
-    /** Optional working directory to search within, relative to the project root. Defaults to searching the entire project. */
-    cwd?: string;
-    /** Maximum number of results to return per file. Defaults to 15. There is also a global limit of 250 results across all files. */
-    maxResults?: number;
-}
-/**
- * End your turn, regardless of any new tool results that might be coming. This will allow the user to type another prompt.
- */
-export interface EndTurnParams {
-}
-/**
- * Find several files related to a brief natural language description of the files or the name of a function or class you are looking for.
- */
-export interface FindFilesParams {
-    /** A brief natural language description of the files or the name of a function or class you are looking for. It's also helpful to mention a directory or two to look within. */
-    prompt: string;
-}
-/**
- * Search for files matching a glob pattern. Returns matching file paths sorted by modification time.
- */
-export interface GlobParams {
-    /** Glob pattern to match files against (e.g., *.js, src/glob/*.ts, glob/test/glob/*.go). */
-    pattern: string;
-    /** Optional working directory to search within, relative to project root. If not provided, searches from project root. */
-    cwd?: string;
-}
-/**
- * List files and directories in the specified path. Returns separate arrays of file names and directory names.
- */
-export interface ListDirectoryParams {
-    /** Directory path to list, relative to the project root. */
-    path: string;
-}
-/**
- * Retrieve information about an agent by ID
- */
-export interface LookupAgentInfoParams {
-    /** Agent ID (short local or full published format) */
-    agentId: string;
-}
-/**
- * Propose string replacements in a file without actually applying them.
- */
-export interface ProposeStrReplaceParams {
-    /** The path to the file to edit. */
-    path: string;
-    /** Array of replacements to make. */
-    replacements: {
-        /** The string to replace. This must be an *exact match* of the string you want to replace, including whitespace and punctuation. */
-        old: string;
-        /** The string to replace the corresponding old string with. Can be empty to delete. */
-        new: string;
-        /** Whether to allow multiple replacements of old string. */
-        allowMultiple?: boolean;
-    }[];
-}
-/**
- * Propose creating or editing a file without actually applying the changes.
- */
-export interface ProposeWriteFileParams {
-    /** Path to the file relative to the **project root** */
-    path: string;
-    /** What the change is intended to do in only one sentence. */
-    instructions: string;
-    /** Edit snippet to apply to the file. */
-    content: string;
-}
-/**
- * Fetch up-to-date documentation for libraries and frameworks using Context7 API.
- */
-export interface ReadDocsParams {
-    /** The library or framework name (e.g., "Next.js", "MongoDB", "React"). Use the official name as it appears in documentation if possible. Only public libraries available in Context7's database are supported, so small or private libraries may not be available. */
-    libraryTitle: string;
-    /** Specific topic to focus on (e.g., "routing", "hooks", "authentication") */
-    topic: string;
-    /** Optional maximum number of tokens to return. Defaults to 20000. Values less than 10000 are automatically increased to 10000. */
-    max_tokens?: number;
-}
-/**
- * Read the multiple files from disk and return their contents. Use this tool to read as many files as would be helpful to answer the user's request.
- */
-export interface ReadFilesParams {
-    /** List of file paths to read. */
-    paths: string[];
-}
-/**
- * Read one or more directory subtrees (as a blob including subdirectories, file names, and parsed variables within each source file) or return parsed variable names for files. If no paths are provided, returns the entire project tree.
- */
-export interface ReadSubtreeParams {
-    /** List of paths to directories or files. Relative to the project root. If omitted, the entire project tree is used. */
-    paths?: string[];
-    /** Maximum token budget for the subtree blob; the tree will be truncated to fit within this budget by first dropping file variables and then removing the most-nested files and directories. */
-    maxTokens?: number;
-}
-/**
- * Parameters for run_file_change_hooks tool
- */
-export interface RunFileChangeHooksParams {
-    /** List of file paths that were changed and should trigger file change hooks */
-    files: string[];
-}
-/**
- * Execute a CLI command from the **project root** (different from the user's cwd).
- */
-export interface RunTerminalCommandParams {
-    /** CLI command valid for user's OS. */
-    command: string;
-    /** Either SYNC (waits, returns output) or BACKGROUND (runs in background). Default SYNC */
-    process_type?: 'SYNC' | 'BACKGROUND';
-    /** The working directory to run the command in. Default is the project root. */
-    cwd?: string;
-    /** Set to -1 for no timeout. Does not apply for BACKGROUND commands. Default 30 */
-    timeout_seconds?: number;
-}
-/**
- * Set the conversation history to the provided messages.
- */
-export interface SetMessagesParams {
-    messages: any;
-}
-/**
- * JSON object to set as the agent output. This completely replaces any previous output. If the agent was spawned, this value will be passed back to its parent. If the agent has an outputSchema defined, the output will be validated against it.
- */
-export interface SetOutputParams {
-}
-/**
- * Load a skill's full instructions when relevant to the current task. Skills are loaded on-demand - only load them when you need their specific guidance.
- */
-export interface SkillParams {
-    /** The name of the skill to load */
-    name: string;
-}
-/**
- * Spawn multiple agents and send a prompt and/or parameters to each of them. These agents will run in parallel. Note that that means they will run independently. If you need to run agents sequentially, use spawn_agents with one agent at a time instead.
- */
-export interface SpawnAgentsParams {
-    agents: {
-        /** Agent to spawn */
-        agent_type: string;
-        /** Prompt to send to the agent */
-        prompt?: string;
-        /** Parameters object for the agent (if any) */
-        params?: Record<string, any>;
-    }[];
-}
-/**
- * Replace strings in a file with new strings.
- */
-export interface StrReplaceParams {
-    /** The path to the file to edit. */
-    path: string;
-    /** Array of replacements to make. */
-    replacements: {
-        /** The string to replace. This must be an *exact match* of the string you want to replace, including whitespace and punctuation. */
-        old: string;
-        /** The string to replace the corresponding old string with. Can be empty to delete. */
-        new: string;
-        /** Whether to allow multiple replacements of old string. */
-        allowMultiple?: boolean;
-    }[];
-}
-/**
- * Suggest clickable followup prompts to the user.
- */
-export interface SuggestFollowupsParams {
-    /** List of suggested followup prompts the user can click to send */
-    followups: {
-        /** The full prompt text to send as a user message when clicked */
-        prompt: string;
-        /** Short display label for the card (defaults to truncated prompt if not provided) */
-        label?: string;
-    }[];
-}
-/**
- * Signal that the task is complete. Use this tool when:
-- The user's request is completely fulfilled
-- You need clarification from the user before continuing
-- You are stuck or need help from the user to continue
-
-This tool explicitly marks the end of your work on the current task.
- */
-export interface TaskCompletedParams {
-}
-/**
- * Deeply consider complex tasks by brainstorming approaches and tradeoffs step-by-step.
- */
-export interface ThinkDeeplyParams {
-    /** Detailed step-by-step analysis. Initially keep each step concise (max ~5-7 words per step). */
-    thought: string;
-}
-/**
- * Search the web for current information using Linkup API.
- */
-export interface WebSearchParams {
-    /** The search query to find relevant web content */
-    query: string;
-    /** Search depth - 'standard' for quick results, 'deep' for more comprehensive search. Default is 'standard'. */
-    depth?: 'standard' | 'deep';
-}
-/**
- * Create or edit a file with the given content.
- */
-export interface WriteFileParams {
-    /** Path to the file relative to the **project root** */
-    path: string;
-    /** What the change is intended to do in only one sentence. */
-    instructions: string;
-    /** Edit snippet to apply to the file. */
-    content: string;
-}
-/**
- * Write a todo list to track tasks for multi-step implementations. Use this frequently to maintain an updated step-by-step plan.
- */
-export interface WriteTodosParams {
-    /** List of todos with their completion status. Add ALL of the applicable tasks to the list, so you don't forget to do anything. Try to order the todos the same way you will complete them. Do not mark todos as completed if you have not completed them yet! */
-    todos: {
-        /** Description of the task */
-        task: string;
-        /** Whether the task is completed */
-        completed: boolean;
-    }[];
-}
-/**
- * Get parameters type for a specific tool
- */
-export type GetToolParams<T extends ToolName> = ToolParamsMap[T];

package/dist/agents/types/util-types.d.ts

@@ -1,134 +0,0 @@
-export type JSONValue = null | string | number | boolean | JSONObject | JSONArray;
-export type JSONObject = {
-    [key: string]: JSONValue;
-};
-export type JSONArray = JSONValue[];
-/**
- * JSON Schema definition (for prompt schema or output schema)
- */
-export type JsonSchema = {
-    type?: 'object' | 'array' | 'string' | 'number' | 'boolean' | 'null' | 'integer';
-    description?: string;
-    properties?: Record<string, JsonSchema | boolean>;
-    required?: string[];
-    enum?: Array<string | number | boolean | null>;
-    [k: string]: unknown;
-};
-export type JsonObjectSchema = JsonSchema & {
-    type: 'object';
-};
-export type DataContent = string | Uint8Array | ArrayBuffer | Buffer;
-export type ProviderMetadata = Record<string, Record<string, JSONValue>>;
-export type TextPart = {
-    type: 'text';
-    text: string;
-    providerOptions?: ProviderMetadata;
-};
-export type ImagePart = {
-    type: 'image';
-    image: DataContent;
-    mediaType?: string;
-    providerOptions?: ProviderMetadata;
-};
-export type FilePart = {
-    type: 'file';
-    data: DataContent;
-    filename?: string;
-    mediaType: string;
-    providerOptions?: ProviderMetadata;
-};
-export type ReasoningPart = {
-    type: 'reasoning';
-    text: string;
-    providerOptions?: ProviderMetadata;
-};
-export type ToolCallPart = {
-    type: 'tool-call';
-    toolCallId: string;
-    toolName: string;
-    input: Record<string, unknown>;
-    providerOptions?: ProviderMetadata;
-    providerExecuted?: boolean;
-};
-export type ToolResultOutput = {
-    type: 'json';
-    value: JSONValue;
-} | {
-    type: 'media';
-    data: string;
-    mediaType: string;
-};
-export type AuxiliaryMessageData = {
-    providerOptions?: ProviderMetadata;
-    tags?: string[];
-    /**
-     * Unix timestamp (ms) when the message was added to history.
-     * Used to detect prompt cache expiry (>5 min gap = cache miss).
-     * This field is stripped before sending to the LLM.
-     */
-    sentAt?: number;
-    /** @deprecated Use tags instead. */
-    timeToLive?: 'agentStep' | 'userPrompt';
-    /** @deprecated Use tags instead. */
-    keepDuringTruncation?: boolean;
-    /** @deprecated Use tags instead. */
-    keepLastTags?: string[];
-};
-export type SystemMessage = {
-    role: 'system';
-    content: TextPart[];
-} & AuxiliaryMessageData;
-export type UserMessage = {
-    role: 'user';
-    content: (TextPart | ImagePart | FilePart)[];
-} & AuxiliaryMessageData;
-export type AssistantMessage = {
-    role: 'assistant';
-    content: (TextPart | ReasoningPart | ToolCallPart)[];
-} & AuxiliaryMessageData;
-export type ToolMessage = {
-    role: 'tool';
-    toolCallId: string;
-    toolName: string;
-    content: ToolResultOutput[];
-} & AuxiliaryMessageData;
-export type Message = SystemMessage | UserMessage | AssistantMessage | ToolMessage;
-/**
- * MCP server configuration for stdio-based servers.
- *
- * Environment variables in `env` can be:
- * - A plain string value (hardcoded, e.g., `'production'`)
- * - A `$VAR_NAME` reference to read from local environment (e.g., `'$NOTION_TOKEN'`)
- *
- * The `$VAR_NAME` syntax reads from `process.env.VAR_NAME` at agent load time.
- * This keeps secrets out of your agent definitions - store them in `.env.local` instead.
- *
- * @example
- * ```typescript
- * env: {
- *   // Read NOTION_TOKEN from local .env file
- *   NOTION_TOKEN: '$NOTION_TOKEN',
- *   // Read MY_API_KEY from local env, pass as API_KEY to MCP server
- *   API_KEY: '$MY_API_KEY',
- *   // Hardcoded value (non-secret)
- *   NODE_ENV: 'production',
- * }
- * ```
- */
-export type MCPConfig = {
-    type?: 'stdio';
-    command: string;
-    args?: string[];
-    env?: Record<string, string>;
-} | {
-    type?: 'http' | 'sse';
-    url: string;
-    params?: Record<string, string>;
-    headers?: Record<string, string>;
-};
-export interface Logger {
-    debug: (data: any, msg?: string) => void;
-    info: (data: any, msg?: string) => void;
-    warn: (data: any, msg?: string) => void;
-    error: (data: any, msg?: string) => void;
-}

package/dist/common/src/actions.d.ts

@@ -1,176 +0,0 @@
-import { z } from 'zod/v4';
-import type { GrantType } from './types/grant';
-import type { MCPConfig } from './types/mcp';
-import type { ToolMessage } from './types/messages/levelcode-message';
-import type { TextPart, ImagePart, ToolResultOutput } from './types/messages/content-part';
-import type { PrintModeEvent } from './types/print-mode';
-import type { AgentOutput, SessionState, ToolCall } from './types/session-state';
-import type { ProjectFileContext } from './util/file';
-export declare const FileChangeSchema: z.ZodObject<{
-    type: z.ZodEnum<{
-        file: "file";
-        patch: "patch";
-    }>;
-    path: z.ZodString;
-    content: z.ZodString;
-}, z.core.$strip>;
-export type FileChange = z.infer<typeof FileChangeSchema>;
-export declare const CHANGES: z.ZodArray<z.ZodObject<{
-    type: z.ZodEnum<{
-        file: "file";
-        patch: "patch";
-    }>;
-    path: z.ZodString;
-    content: z.ZodString;
-}, z.core.$strip>>;
-export type FileChanges = z.infer<typeof CHANGES>;
-type ClientActionPrompt = {
-    type: 'prompt';
-    promptId: string;
-    prompt: string | undefined;
-    content?: (TextPart | ImagePart)[];
-    promptParams?: Record<string, any>;
-    fingerprintId: string;
-    authToken?: string;
-    costMode?: string;
-    sessionState: SessionState;
-    toolResults: ToolMessage[];
-    model?: string;
-    repoUrl?: string;
-    agentId?: string;
-};
-type ClientActionReadFilesResponse = {
-    type: 'read-files-response';
-    files: Record<string, string | null>;
-    requestId?: string;
-};
-type ClientActionInit = {
-    type: 'init';
-    fingerprintId: string;
-    authToken?: string;
-    fileContext: ProjectFileContext;
-    repoUrl?: string;
-};
-type ClientActionToolCallResponse = {
-    type: 'tool-call-response';
-    requestId: string;
-    output: ToolResultOutput[];
-};
-type ClientActionCancelUserInput = {
-    type: 'cancel-user-input';
-    authToken: string;
-    promptId: string;
-};
-type ClientActionMcpToolData = {
-    type: 'mcp-tool-data';
-    requestId: string;
-    tools: {
-        name: string;
-        description?: string;
-        inputSchema: {
-            type: 'object';
-            [k: string]: unknown;
-        };
-    }[];
-};
-type ClientActionAny = ClientActionPrompt | ClientActionReadFilesResponse | ClientActionInit | ClientActionToolCallResponse | ClientActionCancelUserInput | ClientActionMcpToolData;
-type ClientActionType = ClientActionAny['type'];
-export type ClientAction<T extends ClientActionType = ClientActionType> = {
-    [K in ClientActionType]: Extract<ClientActionAny, {
-        type: K;
-    }>;
-}[T];
-type ServerActionResponseChunk = {
-    type: 'response-chunk';
-    userInputId: string;
-    chunk: string | PrintModeEvent;
-};
-type ServerActionSubagentResponseChunk = {
-    type: 'subagent-response-chunk';
-    userInputId: string;
-    agentId: string;
-    agentType: string;
-    chunk: string;
-    prompt?: string;
-    forwardToPrompt?: boolean;
-};
-type ServerActionHandleStepsLogChunk = {
-    type: 'handlesteps-log-chunk';
-    userInputId: string;
-    agentId: string;
-    level: 'debug' | 'info' | 'warn' | 'error';
-    data: any;
-    message?: string;
-};
-export type PromptResponse = {
-    type: 'prompt-response';
-    promptId: string;
-    sessionState: SessionState;
-    toolCalls?: ToolCall[];
-    toolResults?: ToolMessage[];
-    output?: AgentOutput;
-};
-type ServerActionReadFiles = {
-    type: 'read-files';
-    filePaths: string[];
-    requestId: string;
-};
-type ServerActionToolCallRequest = {
-    type: 'tool-call-request';
-    userInputId: string;
-    requestId: string;
-    toolName: string;
-    input: Record<string, any>;
-    timeout?: number;
-    mcpConfig?: MCPConfig;
-};
-export type InitResponse = {
-    type: 'init-response';
-    message?: string;
-    agentNames?: Record<string, string>;
-} & Omit<UsageResponse, 'type'>;
-export type UsageResponse = {
-    type: 'usage-response';
-    usage: number;
-    remainingBalance: number;
-    balanceBreakdown?: Record<GrantType, number>;
-    next_quota_reset: Date | null;
-    autoTopupAdded?: number;
-    autoTopupEnabled?: boolean;
-};
-export type MessageCostResponse = {
-    type: 'message-cost-response';
-    promptId: string;
-    credits: number;
-    agentId?: string;
-};
-type ServerActionActionError = {
-    type: 'action-error';
-    message: string;
-    error?: string;
-    remainingBalance?: number;
-};
-type ServerActionPromptError = {
-    type: 'prompt-error';
-    userInputId: string;
-    message: string;
-    error?: string;
-    remainingBalance?: number;
-};
-type ServerActionRequestReconnect = {
-    type: 'request-reconnect';
-};
-type ServerActionRequestMcpToolData = {
-    type: 'request-mcp-tool-data';
-    requestId: string;
-    mcpConfig: MCPConfig;
-    toolNames?: string[];
-};
-type ServerActionAny = ServerActionResponseChunk | ServerActionSubagentResponseChunk | ServerActionHandleStepsLogChunk | PromptResponse | ServerActionReadFiles | ServerActionToolCallRequest | InitResponse | UsageResponse | MessageCostResponse | ServerActionActionError | ServerActionPromptError | ServerActionRequestReconnect | ServerActionRequestMcpToolData;
-type ServerActionType = ServerActionAny['type'];
-export type ServerAction<T extends ServerActionType = ServerActionType> = {
-    [K in ServerActionType]: Extract<ServerActionAny, {
-        type: K;
-    }>;
-}[T];
-export {};

package/dist/common/src/analytics-core.d.ts

@@ -1,52 +0,0 @@
-/**
- * Shared analytics core module.
- * Provides common interfaces, types, and utilities used by both
- * server-side (common/src/analytics.ts) and CLI (cli/src/utils/analytics.ts) analytics.
- */
-/** Interface for PostHog client methods used for event capture */
-export interface AnalyticsClient {
-    capture: (params: {
-        distinctId: string;
-        event: string;
-        properties?: Record<string, any>;
-    }) => void;
-    flush: () => Promise<void>;
-}
-/** Extended client interface with identify, alias, and exception capture (used by CLI) */
-export interface AnalyticsClientWithIdentify extends AnalyticsClient {
-    identify: (params: {
-        distinctId: string;
-        properties?: Record<string, any>;
-    }) => void;
-    /** Links an alias (previous anonymous ID) to a distinctId (real user ID) */
-    alias: (data: {
-        distinctId: string;
-        alias: string;
-    }) => void;
-    captureException: (error: any, distinctId: string, properties?: Record<string, any>) => void;
-}
-/** Environment name type */
-export type AnalyticsEnvName = 'dev' | 'test' | 'prod';
-/** Base analytics configuration */
-export interface AnalyticsConfig {
-    envName: AnalyticsEnvName;
-    posthogApiKey: string;
-    posthogHostUrl: string;
-}
-/** Options for creating a PostHog client */
-export interface PostHogClientOptions {
-    host: string;
-    flushAt?: number;
-    flushInterval?: number;
-    enableExceptionAutocapture?: boolean;
-}
-/**
- * Default PostHog client factory.
- * Creates a real PostHog client instance.
- */
-export declare function createPostHogClient(apiKey: string, options: PostHogClientOptions): AnalyticsClientWithIdentify;
-/**
- * Generates a unique anonymous ID for pre-login tracking.
- * Uses crypto.randomUUID() for uniqueness.
- */
-export declare function generateAnonymousId(): string;

package/dist/common/src/analytics.d.ts

@@ -1,9 +0,0 @@
-import { AnalyticsEvent } from './constants/analytics-events';
-import type { Logger } from '@levelcode/common/types/contracts/logger';
-export declare function flushAnalytics(logger?: Logger): Promise<void>;
-export declare function trackEvent({ event, userId, properties, logger, }: {
-    event: AnalyticsEvent;
-    userId: string;
-    properties?: Record<string, any>;
-    logger: Logger;
-}): void;