@levelcode/sdk 0.0.5 → 0.1.0

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

@@ -0,0 +1,176 @@
+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

@@ -0,0 +1,52 @@
+/**
+ * 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

@@ -0,0 +1,9 @@
+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;