@levelcode/sdk 0.2.2 → 0.2.4

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

@@ -0,0 +1,49 @@
+import type { TeamConfig, TeamMember, TeamTask, DevPhase, TeamRole } from '@levelcode/common/types/team-config';
+import type { TeamProtocolMessage } from '@levelcode/common/types/team-protocol';
+import type { TeamSummary } from '@levelcode/common/utils/team-discovery';
+import type { PresetConfig } from '@levelcode/common/utils/team-presets';
+import type { RunOptions, LevelCodeClientOptions } from './run';
+export type CreateTeamOptions = {
+    description?: string;
+    phase?: DevPhase;
+    preset?: string;
+    members?: Array<{
+        name: string;
+        role: TeamRole;
+        agentType: string;
+        model: string;
+        cwd?: string;
+    }>;
+    settings?: {
+        maxMembers?: number;
+        autoAssign?: boolean;
+    };
+};
+export type RunWithTeamOptions = RunOptions & LevelCodeClientOptions & {
+    teamName: string;
+    memberName: string;
+    role: TeamRole;
+};
+export type TeamStatus = {
+    config: TeamConfig;
+    tasks: TeamTask[];
+    memberCount: number;
+};
+/**
+ * Creates a new team with the given name and options.
+ * If a preset is specified, uses its member/settings defaults.
+ */
+export declare function sdkCreateTeam(name: string, leadAgentId: string, options?: CreateTeamOptions): TeamConfig;
+/**
+ * Deletes a team by name and removes all associated data.
+ */
+export declare function sdkDeleteTeam(name: string): void;
+/**
+ * Gets the full status of a team including config and tasks.
+ */
+export declare function sdkGetTeamStatus(name: string): TeamStatus;
+/**
+ * Lists all teams with summary information.
+ */
+export declare function sdkListTeams(): TeamSummary[];
+export type { TeamConfig, TeamMember, TeamTask, DevPhase, TeamRole, TeamProtocolMessage, TeamSummary, PresetConfig, };

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

@@ -0,0 +1,5 @@
+import type { SdkEnv } from '../types/env';
+/**
+ * Test-only SDK env builder.
+ */
+export declare const createTestSdkEnv: (overrides?: Partial<SdkEnv>) => SdkEnv;

package/dist/sdk/src/tools/change-file.d.ts

@@ -0,0 +1,7 @@
+import type { LevelCodeToolOutput } from '@levelcode/common/tools/list';
+import type { LevelCodeFileSystem } from '@levelcode/common/types/filesystem';
+export declare function changeFile(params: {
+    parameters: unknown;
+    cwd: string;
+    fs: LevelCodeFileSystem;
+}): Promise<LevelCodeToolOutput<'str_replace'>>;

package/dist/sdk/src/tools/code-search.d.ts

@@ -0,0 +1,13 @@
+import type { LevelCodeToolOutput } from '../../../common/src/tools/list';
+import { Logger } from '@levelcode/common/types/contracts/logger';
+export declare function codeSearch({ projectPath, pattern, flags, cwd, maxResults, globalMaxResults, maxOutputStringLength, timeoutSeconds, logger, }: {
+    projectPath: string;
+    pattern: string;
+    flags?: string;
+    cwd?: string;
+    maxResults?: number;
+    globalMaxResults?: number;
+    maxOutputStringLength?: number;
+    timeoutSeconds?: number;
+    logger?: Logger;
+}): Promise<LevelCodeToolOutput<'code_search'>>;

package/dist/sdk/src/tools/glob.d.ts

@@ -0,0 +1,8 @@
+import type { LevelCodeToolOutput } from '@levelcode/common/tools/list';
+import type { LevelCodeFileSystem } from '@levelcode/common/types/filesystem';
+export declare function glob(params: {
+    pattern: string;
+    projectPath: string;
+    cwd?: string;
+    fs: LevelCodeFileSystem;
+}): Promise<LevelCodeToolOutput<'glob'>>;

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

@@ -0,0 +1,16 @@
+import { changeFile } from './change-file';
+import { codeSearch } from './code-search';
+import { glob } from './glob';
+import { listDirectory } from './list-directory';
+import { getFiles } from './read-files';
+import { runFileChangeHooks } from './run-file-change-hooks';
+import { runTerminalCommand } from './run-terminal-command';
+export declare const ToolHelpers: {
+    runTerminalCommand: typeof runTerminalCommand;
+    codeSearch: typeof codeSearch;
+    glob: typeof glob;
+    listDirectory: typeof listDirectory;
+    getFiles: typeof getFiles;
+    runFileChangeHooks: typeof runFileChangeHooks;
+    changeFile: typeof changeFile;
+};

package/dist/sdk/src/tools/list-directory.d.ts

@@ -0,0 +1,7 @@
+import type { LevelCodeToolOutput } from '@levelcode/common/tools/list';
+import type { LevelCodeFileSystem } from '@levelcode/common/types/filesystem';
+export declare function listDirectory(params: {
+    directoryPath: string;
+    projectPath: string;
+    fs: LevelCodeFileSystem;
+}): Promise<LevelCodeToolOutput<'list_directory'>>;

package/dist/sdk/src/tools/read-files.d.ts

@@ -0,0 +1,16 @@
+import type { LevelCodeFileSystem } from '@levelcode/common/types/filesystem';
+export type FileFilterResult = {
+    status: 'blocked' | 'allow-example' | 'allow';
+};
+export type FileFilter = (filePath: string) => FileFilterResult;
+export declare function getFiles(params: {
+    filePaths: string[];
+    cwd: string;
+    fs: LevelCodeFileSystem;
+    /**
+     * Filter to classify files before reading.
+     * If provided, the caller takes full control of filtering (no gitignore check).
+     * If not provided, the SDK applies gitignore checking automatically.
+     */
+    fileFilter?: FileFilter;
+}): Promise<Record<string, string | null>>;

package/dist/sdk/src/tools/run-file-change-hooks.d.ts

@@ -0,0 +1,4 @@
+import type { LevelCodeToolOutput } from '../../../common/src/tools/list';
+export declare function runFileChangeHooks({ files, }: {
+    files: string[];
+}): Promise<LevelCodeToolOutput<'run_file_change_hooks'>>;

package/dist/sdk/src/tools/run-terminal-command.d.ts

@@ -0,0 +1,8 @@
+import type { LevelCodeToolOutput } from '../../../common/src/tools/list';
+export declare function runTerminalCommand({ command, process_type, cwd, timeout_seconds, env, }: {
+    command: string;
+    process_type: 'SYNC' | 'BACKGROUND';
+    cwd: string;
+    timeout_seconds: number;
+    env?: NodeJS.ProcessEnv;
+}): Promise<LevelCodeToolOutput<'run_terminal_command'>>;

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

@@ -0,0 +1,30 @@
+/**
+ * SDK-specific environment variable types.
+ *
+ * Extends base types from common with SDK-specific vars for:
+ * - Ripgrep binary path configuration
+ * - WASM module directory
+ */
+import type { BaseEnv, ClientEnv } from '@levelcode/common/types/contracts/env';
+/**
+ * SDK-specific env vars for binary paths and WASM.
+ */
+export type SdkEnv = BaseEnv & {
+    LEVELCODE_RG_PATH?: string;
+    LEVELCODE_WASM_DIR?: string;
+    VERBOSE?: string;
+    OVERRIDE_TARGET?: string;
+    OVERRIDE_PLATFORM?: string;
+    OVERRIDE_ARCH?: string;
+};
+/**
+ * Full SDK env deps combining client env and SDK env.
+ */
+export type SdkEnvDeps = {
+    clientEnv: ClientEnv;
+    env: SdkEnv;
+};
+/**
+ * Function type for getting SDK env values.
+ */
+export type GetSdkEnvFn = () => SdkEnv;

package/dist/sdk/src/validate-agents.d.ts

@@ -0,0 +1,45 @@
+import type { AgentDefinition } from '@levelcode/common/templates/initial-agents-dir/types/agent-definition';
+export interface ValidationResult {
+    success: boolean;
+    validationErrors: Array<{
+        id: string;
+        message: string;
+    }>;
+    errorCount: number;
+}
+export interface ValidateAgentsOptions {
+    /**
+     * Whether to perform remote validation via the web API.
+     * Remote validation checks spawnable agents against the database.
+     */
+    remote?: boolean;
+    /**
+     * The base URL of the LevelCode website API.
+     * Optional - defaults to NEXT_PUBLIC_LEVELCODE_APP_URL or environment-based URL.
+     * Example: 'https://levelcode.vercel.app'
+     */
+    websiteUrl?: string;
+}
+/**
+ * Validates an array of agent definitions.
+ *
+ * By default, performs local Zod schema validation.
+ * When `options.remote` is true, additionally validates spawnable agents via the web API.
+ *
+ * @param definitions - Array of agent definitions to validate
+ * @param options - Optional configuration for validation
+ * @returns Promise<ValidationResult> - Validation results with any errors
+ *
+ * @example
+ * ```typescript
+ * // Local validation only
+ * const result = await validateAgents(definitions)
+ *
+ * // Remote validation
+ * const result = await validateAgents(definitions, {
+ *   remote: true,
+ *   websiteUrl: 'https://levelcode.vercel.app'
+ * })
+ * ```
+ */
+export declare function validateAgents(definitions: AgentDefinition[], options?: ValidateAgentsOptions): Promise<ValidationResult>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@levelcode/sdk",
   "private": false,
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Official SDK for LevelCode — AI coding agent & framework",
   "license": "Apache-2.0",
   "type": "module",