@levelcode/sdk 0.2.3 → 0.2.5

package/dist/packages/agent-runtime/src/run-programmatic-step.d.ts

@@ -1,40 +0,0 @@
-import type { ExecuteToolCallParams } from './tools/tool-executor';
-import type { AgentTemplate, PublicAgentState } from '@levelcode/common/types/agent-template';
-import type { HandleStepsLogChunkFn, SendActionFn } from '@levelcode/common/types/contracts/client';
-import type { AddAgentStepFn } from '@levelcode/common/types/contracts/database';
-import type { Logger } from '@levelcode/common/types/contracts/logger';
-import type { ParamsExcluding } from '@levelcode/common/types/function-params';
-import type { PrintModeEvent } from '@levelcode/common/types/print-mode';
-import type { AgentState } from '@levelcode/common/types/session-state';
-export declare const runIdToStepAll: Set<string>;
-export declare function clearAgentGeneratorCache(params: {
-    logger: Logger;
-}): void;
-export declare function runProgrammaticStep(params: {
-    addAgentStep: AddAgentStepFn;
-    agentState: AgentState;
-    clientSessionId: string;
-    fingerprintId: string;
-    handleStepsLogChunk: HandleStepsLogChunkFn;
-    localAgentTemplates: Record<string, AgentTemplate>;
-    logger: Logger;
-    nResponses?: string[];
-    onResponseChunk: (chunk: string | PrintModeEvent) => void;
-    prompt: string | undefined;
-    repoId: string | undefined;
-    repoUrl: string | undefined;
-    stepNumber: number;
-    stepsComplete: boolean;
-    template: AgentTemplate;
-    toolCallParams: Record<string, any> | undefined;
-    sendAction: SendActionFn;
-    system: string | undefined;
-    userId: string | undefined;
-    userInputId: string;
-} & Omit<ExecuteToolCallParams, 'toolName' | 'input' | 'autoInsertEndStepParam' | 'excludeToolFromMessageHistory' | 'agentContext' | 'agentStepId' | 'agentTemplate' | 'fullResponse' | 'previousToolCallFinished' | 'fileProcessingState' | 'toolCallId' | 'toolCalls' | 'toolResults' | 'toolResultsToAddAfterStream'> & ParamsExcluding<AddAgentStepFn, 'agentRunId' | 'stepNumber' | 'credits' | 'childRunIds' | 'status' | 'startTime' | 'messageId'>): Promise<{
-    agentState: AgentState;
-    endTurn: boolean;
-    stepNumber: number;
-    generateN?: number;
-}>;
-export declare const getPublicAgentState: (agentState: AgentState & Required<Pick<AgentState, "runId">>) => PublicAgentState;

package/dist/packages/agent-runtime/src/system-prompt/prompts.d.ts

@@ -1,19 +0,0 @@
-import type { Logger } from '@levelcode/common/types/contracts/logger';
-import type { ProjectFileContext } from '@levelcode/common/util/file';
-export declare const knowledgeFilesPrompt: string;
-export declare const additionalSystemPrompts: {
-    readonly '/init': string;
-    readonly init: string;
-    readonly '/export': string;
-    readonly export: string;
-    readonly '/compact': string;
-    readonly compact: string;
-};
-export declare const getProjectFileTreePrompt: (params: {
-    fileContext: ProjectFileContext;
-    fileTreeTokenBudget: number;
-    mode: "search" | "agent";
-    logger: Logger;
-}) => string;
-export declare const getSystemInfoPrompt: (fileContext: ProjectFileContext) => string;
-export declare const getGitChangesPrompt: (fileContext: ProjectFileContext) => string;

package/dist/packages/agent-runtime/src/system-prompt/search-system-prompt.d.ts

@@ -1,14 +0,0 @@
-import type { Logger } from '@levelcode/common/types/contracts/logger';
-import type { ProjectFileContext } from '@levelcode/common/util/file';
-export declare function getSearchSystemPrompt(params: {
-    fileContext: ProjectFileContext;
-    messagesTokens: number;
-    logger: Logger;
-    options: {
-        agentStepId: string;
-        clientSessionId: string;
-        fingerprintId: string;
-        userInputId: string;
-        userId: string | undefined;
-    };
-}): string;

package/dist/packages/agent-runtime/src/system-prompt/team-context-prompt.d.ts

@@ -1,9 +0,0 @@
-import type { DevPhase, TeamRole } from '@levelcode/common/types/team-config';
-export interface TeamContextPromptConfig {
-    teamName: string;
-    agentName: string;
-    role: TeamRole;
-    phase: DevPhase;
-    isLeader: boolean;
-}
-export declare function generateTeamContextPrompt(config: TeamContextPromptConfig): string;

package/dist/packages/agent-runtime/src/system-prompt/team-prompt.d.ts

@@ -1,9 +0,0 @@
-import type { DevPhase, TeamRole } from '@levelcode/common/types/team-config';
-/**
- * Generates a system prompt section explaining the agent's team context.
- * This is the primary entry point for injecting team awareness into agent system prompts.
- *
- * Delegates to generateTeamContextPrompt for role-based guidance, communication
- * protocols, task workflows, idle behavior, and shutdown instructions.
- */
-export declare function generateTeamPromptSection(teamName: string, agentName: string, role: TeamRole, phase: DevPhase): string;

package/dist/packages/agent-runtime/src/system-prompt/truncate-file-tree.d.ts

@@ -1,13 +0,0 @@
-import type { Logger } from '@levelcode/common/types/contracts/logger';
-import type { ProjectFileContext } from '@levelcode/common/util/file';
-type TruncationLevel = 'none' | 'unimportant-files' | 'tokens' | 'depth-based';
-export declare const truncateFileTreeBasedOnTokenBudget: (params: {
-    fileContext: ProjectFileContext;
-    tokenBudget: number;
-    logger: Logger;
-}) => {
-    printedTree: string;
-    tokenCount: number;
-    truncationLevel: TruncationLevel;
-};
-export {};

package/dist/packages/agent-runtime/src/team-context.d.ts

@@ -1,14 +0,0 @@
-import type { TeamConfig } from '@levelcode/common/types/team-config';
-export interface TeamContext {
-    teamName: string;
-    agentName: string;
-    config: TeamConfig;
-}
-/**
- * Discovers the team context for a given agent identifier.
- * Scans all team directories to find which team the agent belongs to.
- * Matches against both the raw agentId and a "lead-" prefixed variant.
- *
- * Returns null if the agent is not part of any team (e.g., standalone mode).
- */
-export declare function findTeamContext(agentIdentifier: string): TeamContext | null;

package/dist/packages/agent-runtime/src/templates/agent-registry.d.ts

@@ -1,35 +0,0 @@
-import type { DynamicAgentValidationError } from '@levelcode/common/templates/agent-validation';
-import type { AgentTemplate } from '@levelcode/common/types/agent-template';
-import type { FetchAgentFromDatabaseFn } from '@levelcode/common/types/contracts/database';
-import type { Logger } from '@levelcode/common/types/contracts/logger';
-import type { ParamsExcluding } from '@levelcode/common/types/function-params';
-import type { ProjectFileContext } from '@levelcode/common/util/file';
-/**
- * Single function to look up an agent template with clear priority order:
- * 1. localAgentTemplates (dynamic agents + static templates)
- * 2. Database cache
- * 3. Database query
- */
-export declare function getAgentTemplate(params: {
-    agentId: string;
-    localAgentTemplates: Record<string, AgentTemplate>;
-    fetchAgentFromDatabase: FetchAgentFromDatabaseFn;
-    databaseAgentCache: Map<string, AgentTemplate | null>;
-    logger: Logger;
-} & ParamsExcluding<FetchAgentFromDatabaseFn, 'parsedAgentId'>): Promise<AgentTemplate | null>;
-/**
- * Assemble local agent templates from fileContext + static templates + team agents
- */
-export declare function assembleLocalAgentTemplates(params: {
-    fileContext: ProjectFileContext;
-    logger: Logger;
-}): {
-    agentTemplates: Record<string, AgentTemplate>;
-    validationErrors: DynamicAgentValidationError[];
-};
-/**
- * Clear the database agent cache (useful for testing)
- */
-export declare function clearDatabaseCache(params: {
-    databaseAgentCache: Map<string, AgentTemplate | null>;
-}): void;

package/dist/packages/agent-runtime/src/templates/prompts.d.ts

@@ -1,35 +0,0 @@
-import { z } from 'zod/v4';
-import { getAgentTemplate } from './agent-registry';
-import type { AgentTemplate } from '@levelcode/common/types/agent-template';
-import type { Logger } from '@levelcode/common/types/contracts/logger';
-import type { ParamsExcluding } from '@levelcode/common/types/function-params';
-import type { AgentTemplateType } from '@levelcode/common/types/session-state';
-import type { ToolSet } from 'ai';
-/**
- * Gets the short agent name from a fully qualified agent ID.
- * E.g., 'levelcode/file-picker@1.0.0' -> 'file-picker'
- */
-export declare function getAgentShortName(agentType: AgentTemplateType): string;
-/**
- * Builds an input schema for an agent tool with prompt and params as top-level fields.
- * This matches the spawn_agents schema structure: { prompt?: string, params?: object }
- */
-export declare function buildAgentToolInputSchema(agentTemplate: AgentTemplate): z.ZodType;
-/**
- * Builds AI SDK tool definitions for spawnable agents.
- * These tools allow the model to call agents directly as tool calls.
- */
-export declare function buildAgentToolSet(params: {
-    spawnableAgents: AgentTemplateType[];
-    agentTemplates: Record<string, AgentTemplate>;
-    logger: Logger;
-} & ParamsExcluding<typeof getAgentTemplate, 'agentId' | 'localAgentTemplates'>): Promise<ToolSet>;
-/**
- * Builds the full spawnable agents specification for subagent instructions.
- * This is used when inheritSystemPrompt is true to tell subagents which agents they can spawn.
- */
-export declare function buildFullSpawnableAgentsSpec(params: {
-    spawnableAgents: AgentTemplateType[];
-    agentTemplates: Record<string, AgentTemplate>;
-    logger: Logger;
-} & ParamsExcluding<typeof getAgentTemplate, 'agentId' | 'localAgentTemplates'>): Promise<string>;

package/dist/packages/agent-runtime/src/templates/strings.d.ts

@@ -1,32 +0,0 @@
-import { getAgentTemplate } from './agent-registry';
-import { buildFullSpawnableAgentsSpec } from './prompts';
-import type { AgentTemplate } from './types';
-import type { Logger } from '@levelcode/common/types/contracts/logger';
-import type { ParamsExcluding } from '@levelcode/common/types/function-params';
-import type { AgentState, AgentTemplateType } from '@levelcode/common/types/session-state';
-import type { CustomToolDefinitions, ProjectFileContext } from '@levelcode/common/util/file';
-export declare function formatPrompt(params: {
-    prompt: string;
-    fileContext: ProjectFileContext;
-    agentState: AgentState;
-    tools: readonly string[];
-    spawnableAgents: AgentTemplateType[];
-    agentTemplates: Record<string, AgentTemplate>;
-    intitialAgentPrompt?: string;
-    additionalToolDefinitions: () => Promise<ProjectFileContext['customToolDefinitions']>;
-    logger: Logger;
-} & ParamsExcluding<typeof getAgentTemplate, 'agentId' | 'localAgentTemplates'>): Promise<string>;
-type StringField = 'systemPrompt' | 'instructionsPrompt' | 'stepPrompt';
-export declare function getAgentPrompt<T extends StringField>(params: {
-    agentTemplate: AgentTemplate;
-    promptType: {
-        type: T;
-    };
-    fileContext: ProjectFileContext;
-    agentState: AgentState;
-    agentTemplates: Record<string, AgentTemplate>;
-    additionalToolDefinitions: () => Promise<CustomToolDefinitions>;
-    logger: Logger;
-    useParentTools?: boolean;
-} & ParamsExcluding<typeof formatPrompt, 'prompt' | 'tools' | 'spawnableAgents'> & ParamsExcluding<typeof buildFullSpawnableAgentsSpec, 'spawnableAgents' | 'agentTemplates'>): Promise<string | undefined>;
-export {};

package/dist/packages/agent-runtime/src/templates/types.d.ts

@@ -1,13 +0,0 @@
-import type { ToolName } from '@levelcode/common/tools/constants';
-import type { AgentTemplate, StepGenerator, StepHandler } from '@levelcode/common/types/agent-template';
-import type { AgentTemplateType } from '@levelcode/common/types/session-state';
-export type { AgentTemplate, StepGenerator, StepHandler };
-declare const placeholderNames: readonly ["AGENT_NAME", "FILE_TREE_PROMPT_SMALL", "FILE_TREE_PROMPT", "FILE_TREE_PROMPT_LARGE", "GIT_CHANGES_PROMPT", "INITIAL_AGENT_PROMPT", "KNOWLEDGE_FILES_CONTENTS", "PROJECT_ROOT", "REMAINING_STEPS", "SYSTEM_INFO_PROMPT", "USER_CWD", "USER_INPUT_PROMPT"];
-type PlaceholderType<T extends typeof placeholderNames> = {
-    [K in T[number]]: `{LEVELCODE_${K}}`;
-};
-export declare const PLACEHOLDER: PlaceholderType<typeof placeholderNames>;
-export type PlaceholderValue = (typeof PLACEHOLDER)[keyof typeof PLACEHOLDER];
-export declare const placeholderValues: ("{LEVELCODE_AGENT_NAME}" | "{LEVELCODE_FILE_TREE_PROMPT_SMALL}" | "{LEVELCODE_FILE_TREE_PROMPT}" | "{LEVELCODE_FILE_TREE_PROMPT_LARGE}" | "{LEVELCODE_GIT_CHANGES_PROMPT}" | "{LEVELCODE_INITIAL_AGENT_PROMPT}" | "{LEVELCODE_KNOWLEDGE_FILES_CONTENTS}" | "{LEVELCODE_PROJECT_ROOT}" | "{LEVELCODE_REMAINING_STEPS}" | "{LEVELCODE_SYSTEM_INFO_PROMPT}" | "{LEVELCODE_USER_CWD}" | "{LEVELCODE_USER_INPUT_PROMPT}")[];
-export declare const baseAgentToolNames: ToolName[];
-export declare const baseAgentSubagents: AgentTemplateType[];

package/dist/packages/agent-runtime/src/tool-stream-parser.d.ts

@@ -1,31 +0,0 @@
-import type { Model } from '@levelcode/common/old-constants';
-import type { TrackEventFn } from '@levelcode/common/types/contracts/analytics';
-import type { StreamChunk } from '@levelcode/common/types/contracts/llm';
-import type { Logger } from '@levelcode/common/types/contracts/logger';
-import type { PrintModeError, PrintModeText } from '@levelcode/common/types/print-mode';
-import type { PromptResult } from '@levelcode/common/util/error';
-export declare function processStreamWithTools(params: {
-    stream: AsyncGenerator<StreamChunk, PromptResult<string | null>>;
-    processors: Record<string, {
-        onTagStart: (tagName: string, attributes: Record<string, string>) => void;
-        onTagEnd: (tagName: string, params: Record<string, any>) => void;
-    }>;
-    defaultProcessor: (toolName: string) => {
-        onTagStart: (tagName: string, attributes: Record<string, string>) => void;
-        onTagEnd: (tagName: string, params: Record<string, any>) => void;
-    };
-    onError: (tagName: string, errorMessage: string) => void;
-    onResponseChunk: (chunk: PrintModeText | PrintModeError) => void;
-    logger: Logger;
-    loggerOptions?: {
-        userId?: string;
-        model?: Model;
-        agentName?: string;
-    };
-    trackEvent: TrackEventFn;
-    executeXmlToolCall: (params: {
-        toolCallId: string;
-        toolName: string;
-        input: Record<string, unknown>;
-    }) => Promise<void>;
-}): AsyncGenerator<StreamChunk, PromptResult<string | null>>;

package/dist/packages/agent-runtime/src/tools/handlers/handler-function-type.d.ts

@@ -1,51 +0,0 @@
-import type { FileProcessingState } from './tool/write-file';
-import type { ToolName } from '@levelcode/common/tools/constants';
-import type { ClientToolCall, ClientToolName, LevelCodeToolCall, LevelCodeToolMessage, LevelCodeToolOutput } from '@levelcode/common/tools/list';
-import type { AgentTemplate } from '@levelcode/common/types/agent-template';
-import type { AgentRuntimeDeps, AgentRuntimeScopedDeps } from '@levelcode/common/types/contracts/agent-runtime';
-import type { TrackEventFn } from '@levelcode/common/types/contracts/analytics';
-import type { SendSubagentChunkFn } from '@levelcode/common/types/contracts/client';
-import type { Logger } from '@levelcode/common/types/contracts/logger';
-import type { PrintModeEvent } from '@levelcode/common/types/print-mode';
-import type { AgentState, Subgoal } from '@levelcode/common/types/session-state';
-import type { ProjectFileContext } from '@levelcode/common/util/file';
-import type { ToolSet } from 'ai';
-type PresentOrAbsent<K extends PropertyKey, V> = {
-    [P in K]: V;
-} | {
-    [P in K]: never;
-};
-export type LevelCodeToolHandlerFunction<T extends ToolName = ToolName> = (params: {
-    previousToolCallFinished: Promise<void>;
-    toolCall: LevelCodeToolCall<T>;
-    agentContext: Record<string, Subgoal>;
-    agentState: AgentState;
-    agentStepId: string;
-    agentTemplate: AgentTemplate;
-    ancestorRunIds: string[];
-    apiKey: string;
-    clientSessionId: string;
-    fetch: typeof globalThis.fetch;
-    fileContext: ProjectFileContext;
-    fileProcessingState: FileProcessingState;
-    fingerprintId: string;
-    fullResponse: string;
-    localAgentTemplates: Record<string, AgentTemplate>;
-    logger: Logger;
-    prompt: string | undefined;
-    repoId: string | undefined;
-    repoUrl: string | undefined;
-    runId: string;
-    sendSubagentChunk: SendSubagentChunkFn;
-    signal: AbortSignal;
-    system: string;
-    tools: ToolSet;
-    trackEvent: TrackEventFn;
-    userId: string | undefined;
-    userInputId: string;
-    writeToClient: (chunk: string | PrintModeEvent) => void;
-} & PresentOrAbsent<'requestClientToolCall', (toolCall: ClientToolCall<T extends ClientToolName ? T : never>) => Promise<LevelCodeToolOutput<T extends ClientToolName ? T : never>>> & AgentRuntimeDeps & AgentRuntimeScopedDeps) => Promise<{
-    output: LevelCodeToolMessage<T>['content'];
-    creditsUsed?: number;
-}>;
-export {};