joonecli 0.1.0 → 0.2.0

package/src/tracing/types.ts

@@ -1,49 +0,0 @@
-/**
- * Core tracing data types for session instrumentation.
- */
-
-/**
- * A single traced event during agent execution.
- */
-export interface TraceEvent {
-  /** Event category. */
-  type: "llm_call" | "tool_call" | "error" | "compaction";
-  /** Unix timestamp (ms) when the event started. */
-  timestamp: number;
-  /** Duration in milliseconds (if applicable). */
-  duration?: number;
-  /** Event-specific payload. */
-  data: Record<string, any>;
-}
-
-/**
- * Aggregated metrics for a complete session.
- */
-export interface TraceSummary {
-  totalTokens: number;
-  promptTokens: number;
-  completionTokens: number;
-  /** Estimated cost in USD. */
-  totalCost: number;
-  /** Cache hit rate: 0-1 (ratio of cached prompt tokens to total prompt tokens). */
-  cacheHitRate: number;
-  /** Number of tool calls made during the session. */
-  toolCallCount: number;
-  /** Number of errors encountered. */
-  errorCount: number;
-  /** Total session duration in ms. */
-  totalDuration: number;
-  /** Number of LLM turns. */
-  turnCount: number;
-}
-
-/**
- * Full trace for a single agent session, suitable for persistence and analysis.
- */
-export interface SessionTrace {
-  sessionId: string;
-  startedAt: number;
-  endedAt?: number;
-  events: TraceEvent[];
-  summary: TraceSummary;
-}

package/src/types/valyu.d.ts

@@ -1,37 +0,0 @@
-/**
- * Type declaration for @valyu/ai-sdk.
- *
- * This is a minimal stub so TypeScript compiles without requiring the
- * package to be installed. The actual SDK is dynamically imported at runtime.
- */
-declare module "@valyu/ai-sdk" {
-  interface ValyuOptions {
-    apiKey: string;
-  }
-
-  interface SearchParams {
-    query: string;
-    maxResults?: number;
-  }
-
-  interface SearchResult {
-    title?: string;
-    url?: string;
-    snippet?: string;
-    content?: string;
-  }
-
-  interface SearchResponse {
-    results: SearchResult[];
-  }
-
-  export class Valyu {
-    constructor(options: ValyuOptions);
-    search(params: SearchParams): Promise<SearchResponse>;
-    paperSearch(params: SearchParams): Promise<SearchResponse>;
-    financeSearch(params: SearchParams): Promise<SearchResponse>;
-    patentSearch(params: SearchParams): Promise<SearchResponse>;
-    secSearch(params: SearchParams): Promise<SearchResponse>;
-    companyResearch(params: SearchParams): Promise<SearchResponse>;
-  }
-}

package/src/ui/App.tsx

@@ -1,404 +0,0 @@
-import React, { useState, useEffect, useMemo } from "react";
-import { Box, Text, useInput, useApp } from "ink";
-import TextInput from "ink-text-input";
-import { Header } from "./components/Header.js";
-import { StatusBar } from "./components/StatusBar.js";
-import { MessageBubble } from "./components/MessageBubble.js";
-import { StreamingText } from "./components/StreamingText.js";
-import { ToolCallPanel, ToolCallStatus } from "./components/ToolCallPanel.js";
-import { HITLPrompt } from "./components/HITLPrompt.js";
-import { ExecutionHarness } from "../core/agentLoop.js";
-import { ContextState } from "../core/promptBuilder.js";
-import { countMessageTokens } from "../core/tokenCounter.js";
-import { HumanMessage, AIMessage, BaseMessage } from "@langchain/core/messages";
-import {
-  HITLBridge,
-  HITLQuestion,
-  HITLPermissionRequest,
-} from "../hitl/bridge.js";
-import { createDefaultRegistry } from "../commands/builtinCommands.js";
-import { CommandRegistry } from "../commands/commandRegistry.js";
-
-export interface Message {
-  role: "user" | "agent" | "system";
-  content: string;
-}
-
-export interface ActiveToolCall {
-  name: string;
-  args: Record<string, unknown>;
-  status: ToolCallStatus;
-  result?: string;
-}
-
-interface AppProps {
-  provider: string;
-  model: string;
-  streaming: boolean;
-  harness: ExecutionHarness;
-  initialState: ContextState;
-  maxTokens: number;
-}
-
-export const App: React.FC<AppProps> = ({
-  provider,
-  model,
-  streaming,
-  harness,
-  initialState,
-  maxTokens,
-}) => {
-  const { exit } = useApp();
-
-  // Slash Command Registry — initialized once, stable across renders
-  const commandRegistry = useMemo(() => createDefaultRegistry(), []);
-
-  // UI State
-  const [messages, setMessages] = useState<Message[]>([
-    { role: "system", content: "Session started. Type your request below." },
-  ]);
-  const [inputValue, setInputValue] = useState("");
-  const [isProcessing, setIsProcessing] = useState(false);
-
-  // Streaming & Tool State
-  const [streamingTokens, setStreamingTokens] = useState<string[]>([]);
-  const [isStreaming, setIsStreaming] = useState(false);
-  const [activeToolCall, setActiveToolCall] = useState<ActiveToolCall | null>(
-    null,
-  );
-
-  // Core Engine State
-  const [contextState, setContextState] = useState<ContextState>(initialState);
-
-  // HITL State
-  const [hitlQuestion, setHitlQuestion] = useState<HITLQuestion | undefined>(
-    undefined,
-  );
-  const [hitlPermission, setHitlPermission] = useState<
-    HITLPermissionRequest | undefined
-  >(undefined);
-
-  // Listen for HITL events from the bridge
-  useEffect(() => {
-    const bridge = HITLBridge.getInstance();
-
-    const onQuestion = (q: HITLQuestion) => setHitlQuestion(q);
-    const onPermission = (p: HITLPermissionRequest) => setHitlPermission(p);
-
-    bridge.on("question", onQuestion);
-    bridge.on("permission", onPermission);
-
-    // Clear prompts when resolved
-    const origResolve = bridge.resolveAnswer.bind(bridge);
-    bridge.resolveAnswer = (id: string, answer: string) => {
-      origResolve(id, answer);
-      setHitlQuestion(undefined);
-      setHitlPermission(undefined);
-    };
-
-    return () => {
-      bridge.off("question", onQuestion);
-      bridge.off("permission", onPermission);
-    };
-  }, []);
-
-  // StatusBar Metrics
-  const [startTime] = useState(Date.now());
-  const [elapsed, setElapsed] = useState("0s");
-
-  // Update elapsed time
-  useEffect(() => {
-    const interval = setInterval(() => {
-      const seconds = Math.floor((Date.now() - startTime) / 1000);
-      if (seconds < 60) {
-        setElapsed(`${seconds}s`);
-      } else {
-        const mins = Math.floor(seconds / 60);
-        const secs = seconds % 60;
-        setElapsed(`${mins}m ${secs}s`);
-      }
-    }, 1000);
-    return () => clearInterval(interval);
-  }, [startTime]);
-
-  // Hold the latest state in a ref for the unmount/signal handlers
-  const stateRef = React.useRef(contextState);
-  useEffect(() => {
-    stateRef.current = contextState;
-  }, [contextState]);
-
-  const performGracefulExit = async () => {
-    try {
-      await harness.autoSave.forceSave({
-        config: { provider, model },
-        state: stateRef.current,
-      });
-    } catch (e) {
-      // Ignore errors during exit
-    } finally {
-      exit();
-      process.exit(0);
-    }
-  };
-
-  useEffect(() => {
-    const handleSignal = () => {
-      performGracefulExit();
-    };
-
-    process.on("SIGINT", handleSignal);
-    process.on("SIGTERM", handleSignal);
-
-    return () => {
-      process.off("SIGINT", handleSignal);
-      process.off("SIGTERM", handleSignal);
-    };
-  }, [provider, model, harness, exit]);
-
-  // Handle Ctrl+C (Keyboard)
-  useInput((input, key) => {
-    if (key.ctrl && input === "c") {
-      performGracefulExit();
-    }
-  });
-
-  const runAgentLoop = async (currentState: ContextState) => {
-    try {
-      setIsStreaming(true);
-      setStreamingTokens([]);
-
-      let aiResponse: AIMessage;
-
-      if (streaming) {
-        aiResponse = await harness.streamStep(currentState, {
-          onToken: (token) => {
-            setStreamingTokens((prev) => [...prev, token]);
-          },
-        });
-      } else {
-        aiResponse = await harness.step(currentState);
-      }
-
-      setIsStreaming(false);
-
-      // Add AI text to UI if any
-      if (
-        aiResponse.content &&
-        typeof aiResponse.content === "string" &&
-        aiResponse.content.trim() !== ""
-      ) {
-        setMessages((prev) => [
-          ...prev,
-          { role: "agent", content: aiResponse.content as string },
-        ]);
-      }
-
-      // Add AI message to memory for following tools
-      let nextHistory = [...currentState.conversationHistory, aiResponse];
-
-      // Handle Tools
-      if (aiResponse.tool_calls && aiResponse.tool_calls.length > 0) {
-        // Execute all tool calls once
-        const toolMessages = await harness.executeToolCalls(
-          aiResponse,
-          currentState,
-        );
-
-        // Update UI sequentially for each tool call
-        for (const call of aiResponse.tool_calls) {
-          setActiveToolCall({
-            name: call.name,
-            args: call.args,
-            status: "running",
-          });
-
-          // Brief delay to show running state
-          await new Promise((resolve) => setTimeout(resolve, 300));
-
-          setActiveToolCall({
-            name: call.name,
-            args: call.args,
-            status: "success",
-            result:
-              toolMessages.length > 0
-                ? "Tool execution completed."
-                : "No output.",
-          });
-        }
-
-        // Add tool results to history once
-        nextHistory = [...nextHistory, ...toolMessages];
-
-        // Wait a sec so user sees the success state
-        await new Promise((resolve) => setTimeout(resolve, 800));
-        setActiveToolCall(null);
-
-        // Recurse: Agent needs to react to the tool output
-        const nextState = { ...currentState, conversationHistory: nextHistory };
-        setContextState(nextState);
-        await runAgentLoop(nextState);
-      } else {
-        // Turn complete
-        setContextState({ ...currentState, conversationHistory: nextHistory });
-        setIsProcessing(false);
-      }
-    } catch (error: any) {
-      setIsStreaming(false);
-      setActiveToolCall(null);
-      setIsProcessing(false);
-      setMessages((prev) => [
-        ...prev,
-        { role: "system", content: `Error: ${error.message}` },
-      ]);
-    }
-  };
-
-  const handleSubmit = async (query: string) => {
-    if (!query.trim() || isProcessing) return;
-
-    const userText = query.trim();
-    setInputValue("");
-
-    // ── Slash Command Interception ──
-    // Commands starting with "/" are handled locally at zero LLM cost.
-    if (commandRegistry.isCommand(userText)) {
-      setMessages((prev) => [...prev, { role: "user", content: userText }]);
-
-      const commandContext = {
-        config: {
-          provider,
-          model,
-          maxTokens,
-          streaming,
-          temperature: 0,
-        } as any,
-        configPath: "",
-        harness,
-        contextState,
-        setContextState,
-        addSystemMessage: (content: string) => {
-          setMessages((prev) => [...prev, { role: "system", content }]);
-        },
-        provider,
-        model,
-        maxTokens,
-      };
-
-      try {
-        const result = await commandRegistry.execute(userText, commandContext);
-
-        // Handle /exit signal
-        if (result === "__EXIT__") {
-          setMessages((prev) => [
-            ...prev,
-            { role: "system", content: "Goodbye! 👋" },
-          ]);
-          setTimeout(() => {
-            exit();
-            process.exit(0);
-          }, 500);
-          return;
-        }
-
-        if (result) {
-          setMessages((prev) => [...prev, { role: "system", content: result }]);
-        }
-      } catch (err: any) {
-        setMessages((prev) => [
-          ...prev,
-          { role: "system", content: `Command error: ${err.message}` },
-        ]);
-      }
-      return;
-    }
-
-    // ── Normal Agent Message ──
-    setIsProcessing(true);
-
-    // 1. Update UI
-    setMessages((prev) => [...prev, { role: "user", content: userText }]);
-
-    // 2. Update Engine State
-    const humanMsg = new HumanMessage(userText);
-    const updatedState = {
-      ...contextState,
-      conversationHistory: [...contextState.conversationHistory, humanMsg],
-    };
-    setContextState(updatedState);
-
-    // 3. Start Turn
-    runAgentLoop(updatedState);
-  };
-
-  const summary = harness.tracer.getSummary();
-  const contextTokens = countMessageTokens(contextState.conversationHistory);
-
-  return (
-    <Box flexDirection="column" minHeight={15}>
-      <Header provider={provider} model={model} streaming={streaming} />
-
-      <Box flexDirection="column" paddingY={1}>
-        {messages.map((msg, i) => (
-          <MessageBubble key={i} role={msg.role} content={msg.content} />
-        ))}
-      </Box>
-
-      {isStreaming && (
-        <Box paddingX={1} marginBottom={1}>
-          <Box marginLeft={2}>
-            <StreamingText tokens={streamingTokens} isStreaming={isStreaming} />
-          </Box>
-        </Box>
-      )}
-
-      {activeToolCall && (
-        <Box paddingX={1} marginBottom={1}>
-          <ToolCallPanel
-            toolName={activeToolCall.name}
-            args={activeToolCall.args}
-            status={activeToolCall.status}
-            result={activeToolCall.result}
-          />
-        </Box>
-      )}
-
-      {/* Interactive Prompt Area */}
-      {(hitlQuestion || hitlPermission) && (
-        <HITLPrompt question={hitlQuestion} permission={hitlPermission} />
-      )}
-
-      {!isProcessing && !hitlQuestion && !hitlPermission && (
-        <Box paddingX={1} marginBottom={1}>
-          <Box marginRight={1}>
-            <Text color="green" bold>
-              ❯
-            </Text>
-          </Box>
-          <TextInput
-            value={inputValue}
-            onChange={setInputValue}
-            onSubmit={handleSubmit}
-            placeholder="What should we build today?"
-          />
-        </Box>
-      )}
-
-      {isProcessing && !isStreaming && !activeToolCall && (
-        <Box paddingX={1} marginBottom={1}>
-          <Text dimColor>Thinking...</Text>
-        </Box>
-      )}
-
-      <StatusBar
-        contextTokens={contextTokens}
-        maxContextTokens={maxTokens}
-        totalTokens={summary.totalTokens}
-        cacheHitRate={summary.cacheHitRate}
-        toolCalls={summary.toolCallCount}
-        turns={summary.turnCount}
-        cost={summary.totalCost}
-        elapsed={elapsed}
-      />
-    </Box>
-  );
-};

package/src/ui/components/HITLPrompt.tsx

@@ -1,119 +0,0 @@
-import React, { useState } from "react";
-import { Box, Text } from "ink";
-import TextInput from "ink-text-input";
-import {
-  HITLQuestion,
-  HITLPermissionRequest,
-  HITLBridge,
-} from "../../hitl/bridge.js";
-
-interface HITLPromptProps {
-  /** The active HITL question or permission request. */
-  question?: HITLQuestion;
-  permission?: HITLPermissionRequest;
-}
-
-/**
- * HITLPrompt — renders a blocking question/permission prompt in the TUI.
- *
- * When a tool calls `ask_user_question` or the PermissionMiddleware fires,
- * this component takes over the input area to capture the user's response.
- */
-export const HITLPrompt: React.FC<HITLPromptProps> = ({
-  question,
-  permission,
-}) => {
-  const [inputValue, setInputValue] = useState("");
-
-  const handleSubmit = (value: string) => {
-    const bridge = HITLBridge.getInstance();
-    if (question) {
-      bridge.resolveAnswer(question.id, value);
-    } else if (permission) {
-      bridge.resolveAnswer(permission.id, value);
-    }
-    setInputValue("");
-  };
-
-  if (question) {
-    return (
-      <Box flexDirection="column" paddingX={1} marginBottom={1}>
-        <Box marginBottom={1}>
-          <Text color="yellow" bold>
-            ❓ Agent is asking:
-          </Text>
-        </Box>
-        <Box marginLeft={2} marginBottom={1}>
-          <Text>{question.question}</Text>
-        </Box>
-        {question.options && question.options.length > 0 && (
-          <Box flexDirection="column" marginLeft={2} marginBottom={1}>
-            {question.options.map((opt, i) => (
-              <Text key={i} dimColor>
-                {`  ${i + 1}. ${opt}`}
-              </Text>
-            ))}
-          </Box>
-        )}
-        <Box>
-          <Box marginRight={1}>
-            <Text color="yellow" bold>
-              →
-            </Text>
-          </Box>
-          <TextInput
-            value={inputValue}
-            onChange={setInputValue}
-            onSubmit={handleSubmit}
-            placeholder="Type your answer..."
-          />
-        </Box>
-      </Box>
-    );
-  }
-
-  if (permission) {
-    const argsSummary = Object.entries(permission.args)
-      .map(
-        ([k, v]) =>
-          `${k}: ${typeof v === "string" ? v.substring(0, 60) : JSON.stringify(v)}`,
-      )
-      .join(", ");
-
-    return (
-      <Box flexDirection="column" paddingX={1} marginBottom={1}>
-        <Box marginBottom={1}>
-          <Text color="red" bold>
-            ⚠ Permission Required:
-          </Text>
-        </Box>
-        <Box marginLeft={2} marginBottom={1}>
-          <Text>
-            The agent wants to execute{" "}
-            <Text bold color="white">
-              {permission.toolName}
-            </Text>
-          </Text>
-        </Box>
-        <Box marginLeft={2} marginBottom={1}>
-          <Text dimColor>{argsSummary}</Text>
-        </Box>
-        <Box>
-          <Box marginRight={1}>
-            <Text color="red" bold>
-              Allow? (y/n):
-            </Text>
-          </Box>
-          <TextInput
-            value={inputValue}
-            onChange={setInputValue}
-            onSubmit={handleSubmit}
-            placeholder="y or n"
-          />
-        </Box>
-      </Box>
-    );
-  }
-
-  return null;
-};

package/src/ui/components/Header.tsx

@@ -1,51 +0,0 @@
-import React from "react";
-import { Box, Text } from "ink";
-import chalk from "chalk";
-
-interface HeaderProps {
-  provider: string;
-  model: string;
-  streaming: boolean;
-}
-
-export const Header: React.FC<HeaderProps> = ({
-  provider,
-  model,
-  streaming,
-}) => {
-  return (
-    <Box
-      flexDirection="column"
-      paddingX={1}
-      borderStyle="round"
-      borderColor="cyan"
-    >
-      <Box justifyContent="space-between">
-        <Text bold color="cyan">
-          ◆ joone
-        </Text>
-        <Text dimColor>v0.1.0</Text>
-      </Box>
-      <Box marginTop={0} gap={2}>
-        <Text>
-          <Text dimColor>provider</Text>{" "}
-          <Text color="white" bold>
-            {provider}
-          </Text>
-        </Text>
-        <Text>
-          <Text dimColor>model</Text>{" "}
-          <Text color="white" bold>
-            {model}
-          </Text>
-        </Text>
-        <Text>
-          <Text dimColor>stream</Text>{" "}
-          <Text color={streaming ? "green" : "yellow"}>
-            {streaming ? "on" : "off"}
-          </Text>
-        </Text>
-      </Box>
-    </Box>
-  );
-};

package/src/ui/components/MessageBubble.tsx

@@ -1,46 +0,0 @@
-import React from "react";
-import { Box, Text } from "ink";
-
-type MessageRole = "user" | "agent" | "system";
-
-interface MessageBubbleProps {
-  role: MessageRole;
-  content: string;
-}
-
-/**
- * Renders a single conversation message with role-based styling.
- * - User messages: cyan accent, labeled "you"
- * - Agent messages: green accent, labeled "joone"
- * - System messages: centered, dim yellow
- */ export const MessageBubble: React.FC<MessageBubbleProps> = ({
-  role,
-  content,
-}) => {
-  if (role === "system") {
-    return (
-      <Box paddingX={1} justifyContent="center">
-        <Text dimColor italic color="yellow">
-          ⚙ {content}
-        </Text>
-      </Box>
-    );
-  }
-
-  const isUser = role === "user";
-  const accentColor = isUser ? "cyan" : "green";
-  const label = isUser ? "you" : "joone";
-
-  return (
-    <Box flexDirection="column" paddingX={1}>
-      <Text bold color={accentColor}>
-        {label}
-      </Text>
-      <Box marginLeft={2}>
-        <Text color="white" wrap="wrap">
-          {content}
-        </Text>
-      </Box>
-    </Box>
-  );
-};