@letta-ai/letta-code 0.11.0 → 0.11.2-next.1

package/dist/types/protocol.d.ts

@@ -0,0 +1,214 @@
+/**
+ * Protocol Types for Letta Code
+ *
+ * These types define:
+ * 1. The JSON structure emitted by headless.ts in stream-json mode (wire protocol)
+ * 2. Configuration types for session options (used internally and by SDK)
+ *
+ * Design principle: Compose from @letta-ai/letta-client types where possible.
+ */
+import type { MessageCreate } from "@letta-ai/letta-client/resources/agents/agents";
+import type { AssistantMessage as LettaAssistantMessage, ReasoningMessage as LettaReasoningMessage, LettaStreamingResponse, ToolCallMessage as LettaToolCallMessage, ToolCall } from "@letta-ai/letta-client/resources/agents/messages";
+import type { CreateBlock } from "@letta-ai/letta-client/resources/blocks/blocks";
+import type { StopReasonType } from "@letta-ai/letta-client/resources/runs/runs";
+import type { ToolReturnMessage as LettaToolReturnMessage } from "@letta-ai/letta-client/resources/tools";
+export type { LettaStreamingResponse, ToolCall, StopReasonType, MessageCreate, LettaToolReturnMessage, CreateBlock, };
+/**
+ * System prompt preset configuration.
+ * Use this to select a built-in system prompt with optional appended text.
+ *
+ * Available presets (validated at runtime by CLI):
+ * - 'default' - Alias for letta-claude
+ * - 'letta-claude' - Full Letta Code prompt (Claude-optimized)
+ * - 'letta-codex' - Full Letta Code prompt (Codex-optimized)
+ * - 'letta-gemini' - Full Letta Code prompt (Gemini-optimized)
+ * - 'claude' - Basic Claude (no skills/memory instructions)
+ * - 'codex' - Basic Codex (no skills/memory instructions)
+ * - 'gemini' - Basic Gemini (no skills/memory instructions)
+ */
+export interface SystemPromptPresetConfig {
+    type: "preset";
+    /** Preset ID (e.g., 'default', 'letta-codex'). Validated at runtime. */
+    preset: string;
+    /** Additional instructions to append to the preset */
+    append?: string;
+}
+/**
+ * System prompt configuration - either a raw string or preset config.
+ * - string: Use as the complete system prompt
+ * - SystemPromptPresetConfig: Use a preset, optionally with appended text
+ */
+export type SystemPromptConfig = string | SystemPromptPresetConfig;
+export interface MessageEnvelope {
+    session_id: string;
+    uuid: string;
+}
+export interface SystemInitMessage extends MessageEnvelope {
+    type: "system";
+    subtype: "init";
+    agent_id: string;
+    model: string;
+    tools: string[];
+    cwd: string;
+    mcp_servers: Array<{
+        name: string;
+        status: string;
+    }>;
+    permission_mode: string;
+    slash_commands: string[];
+}
+export type SystemMessage = SystemInitMessage;
+/**
+ * Wire format for assistant messages.
+ * Extends LettaAssistantMessage with wire envelope fields.
+ */
+export interface AssistantMessageWire extends LettaAssistantMessage, MessageEnvelope {
+    type: "message";
+}
+/**
+ * Wire format for tool call messages.
+ * Extends LettaToolCallMessage with wire envelope fields.
+ */
+export interface ToolCallMessageWire extends LettaToolCallMessage, MessageEnvelope {
+    type: "message";
+}
+/**
+ * Wire format for reasoning messages.
+ * Extends LettaReasoningMessage with wire envelope fields.
+ */
+export interface ReasoningMessageWire extends LettaReasoningMessage, MessageEnvelope {
+    type: "message";
+}
+/**
+ * Wire format for tool return messages.
+ * Extends LettaToolReturnMessage with wire envelope fields.
+ */
+export interface ToolReturnMessageWire extends LettaToolReturnMessage, MessageEnvelope {
+    type: "message";
+}
+export type ContentMessage = AssistantMessageWire | ToolCallMessageWire | ReasoningMessageWire | ToolReturnMessageWire;
+/**
+ * Generic message wrapper for spreading LettaStreamingResponse chunks.
+ * Used when the exact message type is determined at runtime.
+ */
+export type MessageWire = {
+    type: "message";
+    session_id: string;
+    uuid: string;
+} & LettaStreamingResponse;
+export interface StreamEvent extends MessageEnvelope {
+    type: "stream_event";
+    event: LettaStreamingResponse;
+}
+export interface AutoApprovalMessage extends MessageEnvelope {
+    type: "auto_approval";
+    tool_call: ToolCall;
+    reason: string;
+    matched_rule: string;
+}
+export interface ErrorMessage extends MessageEnvelope {
+    type: "error";
+    /** High-level error message from the CLI */
+    message: string;
+    stop_reason: StopReasonType;
+    run_id?: string;
+    /** Nested API error when the error originated from Letta API */
+    api_error?: LettaStreamingResponse.LettaErrorMessage;
+}
+export interface RetryMessage extends MessageEnvelope {
+    type: "retry";
+    /** The stop reason that triggered the retry. Uses StopReasonType from letta-client. */
+    reason: StopReasonType;
+    attempt: number;
+    max_attempts: number;
+    delay_ms: number;
+    run_id?: string;
+}
+/**
+ * Result subtypes.
+ * For errors, use stop_reason field with StopReasonType from letta-client.
+ */
+export type ResultSubtype = "success" | "interrupted" | "error";
+/**
+ * Usage statistics from letta-client.
+ * Re-exported for convenience.
+ */
+export type UsageStatistics = LettaStreamingResponse.LettaUsageStatistics;
+export interface ResultMessage extends MessageEnvelope {
+    type: "result";
+    subtype: ResultSubtype;
+    agent_id: string;
+    duration_ms: number;
+    duration_api_ms: number;
+    num_turns: number;
+    result: string | null;
+    run_ids: string[];
+    usage: UsageStatistics | null;
+    /**
+     * Present when subtype is "error".
+     * Uses StopReasonType from letta-client (e.g., 'error', 'max_steps', 'llm_api_error').
+     */
+    stop_reason?: StopReasonType;
+}
+export interface ControlRequest {
+    type: "control_request";
+    request_id: string;
+    request: ControlRequestBody;
+}
+export type SdkToCliControlRequest = {
+    subtype: "initialize";
+} | {
+    subtype: "interrupt";
+};
+export interface CanUseToolControlRequest {
+    subtype: "can_use_tool";
+    tool_name: string;
+    input: Record<string, unknown>;
+    tool_call_id: string;
+    /** TODO: Not implemented - suggestions for permission updates */
+    permission_suggestions: unknown[];
+    /** TODO: Not implemented - path that triggered the permission check */
+    blocked_path: string | null;
+}
+export type CliToSdkControlRequest = CanUseToolControlRequest;
+export type ControlRequestBody = SdkToCliControlRequest | CliToSdkControlRequest;
+export interface ControlResponse extends MessageEnvelope {
+    type: "control_response";
+    response: ControlResponseBody;
+}
+export type ControlResponseBody = {
+    subtype: "success";
+    request_id: string;
+    response?: CanUseToolResponse | Record<string, unknown>;
+} | {
+    subtype: "error";
+    request_id: string;
+    error: string;
+};
+export interface CanUseToolResponseAllow {
+    behavior: "allow";
+    /** TODO: Not supported - Letta stores tool calls server-side */
+    updatedInput?: Record<string, unknown> | null;
+    /** TODO: Not implemented - dynamic permission rule updates */
+    updatedPermissions?: unknown[];
+}
+export interface CanUseToolResponseDeny {
+    behavior: "deny";
+    message: string;
+    /** TODO: Not wired up yet - infrastructure exists in TUI */
+    interrupt?: boolean;
+}
+export type CanUseToolResponse = CanUseToolResponseAllow | CanUseToolResponseDeny;
+/**
+ * User input message for bidirectional communication.
+ * Uses MessageCreate from letta-client for multimodal content support.
+ */
+export interface UserInput {
+    type: "user";
+    message: MessageCreate;
+}
+/**
+ * Union of all wire message types that can be emitted by headless.ts
+ */
+export type WireMessage = SystemMessage | ContentMessage | StreamEvent | AutoApprovalMessage | ErrorMessage | RetryMessage | ResultMessage | ControlResponse | ControlRequest;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/types/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/types/protocol.ts"],"names":[],"mappings":"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"}