echospace 0.0.1 → 0.1.0-alpha.1

package/dist/core/smart-paste/index.js

@@ -0,0 +1,405 @@
+import {
+  parseEcho
+} from "../chunk-U4VEJP3N.js";
+
+// src/core/smart-paste/detector.ts
+function detectFormat(input) {
+  const trimmed = input.trim();
+  try {
+    const parsed = JSON.parse(trimmed);
+    if (parsed.request?.prompt && Array.isArray(parsed.request.prompt)) {
+      return "vercel";
+    }
+    if (parsed.request?.messages && Array.isArray(parsed.request.messages)) {
+      return "openai";
+    }
+    if (Array.isArray(parsed)) {
+      if (parsed.length > 0 && parsed[0].role && "content" in parsed[0]) {
+        return "openai";
+      }
+    }
+    if (parsed.messages && Array.isArray(parsed.messages)) {
+      return "openai";
+    }
+    if (parsed.content && Array.isArray(parsed.content)) {
+      if (parsed.content[0]?.type === "text") {
+        return "anthropic";
+      }
+    }
+    if (Array.isArray(parsed) && parsed[0]?.content?.[0]?.type === "text") {
+      return "anthropic";
+    }
+    if (parsed.contents && Array.isArray(parsed.contents)) {
+      if (parsed.contents[0]?.parts) {
+        return "google";
+      }
+    }
+    return "unknown";
+  } catch {
+  }
+  const firstLine = trimmed.split("\n")[0]?.trim() ?? "";
+  try {
+    const first = JSON.parse(firstLine);
+    if (first.kind === "meta" || first.kind === "message") {
+      return "echo";
+    }
+  } catch {
+  }
+  if (/^(User|Human|System|Assistant):/im.test(trimmed) || /^(###\s*)?(User|Human|System|Assistant)/im.test(trimmed)) {
+    return "raw";
+  }
+  return "unknown";
+}
+
+// src/core/smart-paste/parsers.ts
+import { nanoid } from "nanoid";
+function parseOpenAI(input) {
+  const parsed = JSON.parse(input);
+  const source = parsed.request?.messages ? parsed.request : parsed;
+  const requestMessages = Array.isArray(source) ? source : source.messages ?? [];
+  const messages = [...requestMessages];
+  const respMessages = parsed.response?.messages ?? parsed.response?.choices;
+  if (Array.isArray(respMessages)) {
+    for (const item of respMessages) {
+      messages.push(item.message ?? item);
+    }
+  }
+  return messages.map((msg) => {
+    const parts = [];
+    const role = msg.role ?? "user";
+    if (typeof msg.content === "string") {
+      parts.push({ type: "text", text: msg.content });
+    } else if (Array.isArray(msg.content)) {
+      for (const block of msg.content) {
+        if (block.type === "text") {
+          parts.push({ type: "text", text: block.text });
+        } else if (block.type === "image_url") {
+          parts.push({ type: "image", url: block.image_url?.url });
+        }
+      }
+    }
+    if (typeof msg.reasoning_content === "string" && msg.reasoning_content) {
+      parts.unshift({ type: "thinking", text: msg.reasoning_content });
+    }
+    if (Array.isArray(msg.tool_calls)) {
+      for (const tc of msg.tool_calls) {
+        parts.push({
+          type: "tool_call",
+          id: tc.id ?? nanoid(8),
+          name: tc.function?.name ?? "",
+          input: tc.function?.arguments ?? ""
+        });
+      }
+    }
+    if (role === "tool" && typeof msg.tool_call_id === "string") {
+      parts.length = 0;
+      parts.push({
+        type: "tool_result",
+        id: msg.tool_call_id,
+        output: msg.content ?? ""
+      });
+    }
+    return {
+      kind: "message",
+      id: msg.id ?? nanoid(8),
+      role,
+      created_at: (/* @__PURE__ */ new Date()).toISOString(),
+      parts
+    };
+  });
+}
+function parseAnthropic(input) {
+  const parsed = JSON.parse(input);
+  const messages = Array.isArray(parsed) ? parsed : [parsed];
+  const result = [];
+  if (!Array.isArray(parsed) && parsed.system) {
+    result.push({
+      kind: "message",
+      id: nanoid(8),
+      role: "system",
+      created_at: (/* @__PURE__ */ new Date()).toISOString(),
+      parts: [
+        {
+          type: "text",
+          text: typeof parsed.system === "string" ? parsed.system : parsed.system.filter((b) => b.type === "text").map((b) => b.text).join("\n")
+        }
+      ]
+    });
+  }
+  const msgList = !Array.isArray(parsed) && parsed.messages ? parsed.messages : messages;
+  for (const msg of msgList) {
+    const parts = [];
+    const role = msg.role ?? "user";
+    if (typeof msg.content === "string") {
+      parts.push({ type: "text", text: msg.content });
+    } else if (Array.isArray(msg.content)) {
+      for (const block of msg.content) {
+        switch (block.type) {
+          case "text":
+            parts.push({ type: "text", text: block.text });
+            break;
+          case "thinking":
+            parts.push({
+              type: "thinking",
+              text: block.thinking ?? ""
+            });
+            break;
+          case "tool_use":
+            parts.push({
+              type: "tool_call",
+              id: block.id ?? nanoid(8),
+              name: block.name ?? "",
+              input: block.input ?? {}
+            });
+            break;
+          case "tool_result":
+            parts.push({
+              type: "tool_result",
+              id: block.tool_use_id ?? "",
+              output: block.content ?? "",
+              is_error: block.is_error
+            });
+            break;
+          case "image":
+            if (block.source?.type === "base64") {
+              const source = block.source;
+              parts.push({
+                type: "image",
+                base64: source.data,
+                media_type: source.media_type
+              });
+            }
+            break;
+        }
+      }
+    }
+    result.push({
+      kind: "message",
+      id: msg.id ?? nanoid(8),
+      role,
+      created_at: (/* @__PURE__ */ new Date()).toISOString(),
+      parts
+    });
+  }
+  return result;
+}
+function parseGoogle(input) {
+  const parsed = JSON.parse(input);
+  const contents = parsed.contents ?? [];
+  const result = [];
+  if (parsed.systemInstruction?.parts) {
+    result.push({
+      kind: "message",
+      id: nanoid(8),
+      role: "system",
+      created_at: (/* @__PURE__ */ new Date()).toISOString(),
+      parts: parsed.systemInstruction.parts.map((p) => ({
+        type: "text",
+        text: p.text ?? ""
+      }))
+    });
+  }
+  for (const content of contents) {
+    const role = content.role === "model" ? "assistant" : "user";
+    const geminiParts = content.parts ?? [];
+    const echoParts = [];
+    for (const p of geminiParts) {
+      if (p.text) {
+        echoParts.push({ type: "text", text: p.text });
+      }
+      if (p.functionCall) {
+        const fc = p.functionCall;
+        echoParts.push({
+          type: "tool_call",
+          id: fc.name ?? nanoid(8),
+          name: fc.name ?? "",
+          input: fc.args ?? {}
+        });
+      }
+      if (p.functionResponse) {
+        const fr = p.functionResponse;
+        echoParts.push({
+          type: "tool_result",
+          id: fr.name ?? "",
+          output: fr.response ?? ""
+        });
+      }
+    }
+    result.push({
+      kind: "message",
+      id: nanoid(8),
+      role,
+      created_at: (/* @__PURE__ */ new Date()).toISOString(),
+      parts: echoParts
+    });
+  }
+  return result;
+}
+function parseVercel(input) {
+  const parsed = JSON.parse(input);
+  const prompt = parsed.request?.prompt ?? [];
+  const response = parsed.response;
+  const result = [];
+  for (const msg of prompt) {
+    const role = msg.role ?? "user";
+    const parts = convertVercelParts(msg.content);
+    result.push({
+      kind: "message",
+      id: nanoid(8),
+      role,
+      created_at: (/* @__PURE__ */ new Date()).toISOString(),
+      parts
+    });
+  }
+  if (response?.choices && Array.isArray(response.choices)) {
+    const choice = response.choices[0];
+    const respMsg = choice?.message;
+    if (respMsg) {
+      const parts = convertVercelParts(respMsg.content);
+      if (parts.length > 0) {
+        result.push({
+          kind: "message",
+          id: nanoid(8),
+          role: "assistant",
+          created_at: (/* @__PURE__ */ new Date()).toISOString(),
+          parts,
+          meta: {
+            model: response.model,
+            usage: response.usage ? {
+              input_tokens: response.usage.promptTokens,
+              output_tokens: response.usage.completionTokens
+            } : void 0
+          }
+        });
+      }
+    }
+  }
+  return result;
+}
+function convertVercelParts(content) {
+  const parts = [];
+  if (typeof content === "string") {
+    parts.push({ type: "text", text: content });
+    return parts;
+  }
+  if (!Array.isArray(content)) return parts;
+  for (const block of content) {
+    switch (block.type) {
+      case "text":
+        parts.push({ type: "text", text: block.text });
+        break;
+      case "tool-call":
+        parts.push({
+          type: "tool_call",
+          id: block.toolCallId ?? nanoid(8),
+          name: block.toolName ?? "",
+          input: block.input ?? block.args ?? {}
+        });
+        break;
+      case "tool-result": {
+        let output = block.output ?? block.result ?? "";
+        if (output && typeof output === "object" && output.type === "json") {
+          output = output.value ?? output;
+        }
+        parts.push({
+          type: "tool_result",
+          id: block.toolCallId ?? "",
+          output
+        });
+        break;
+      }
+      case "image":
+        parts.push({
+          type: "image",
+          url: block.url,
+          base64: block.base64,
+          media_type: block.mediaType
+        });
+        break;
+      case "reasoning":
+        parts.push({
+          type: "thinking",
+          text: block.text ?? ""
+        });
+        break;
+    }
+  }
+  return parts;
+}
+function parseRaw(input) {
+  const lines = input.split("\n");
+  const messages = [];
+  let currentRole = "user";
+  let currentContent = "";
+  const rolePatterns = [
+    [/^(System|system)\s*:/i, "system"],
+    [/^(User|Human|human|user)\s*:/i, "user"],
+    [/^(Assistant|AI|Bot|assistant|ai|bot)\s*:/i, "assistant"]
+  ];
+  function flush() {
+    const text = currentContent.trim();
+    if (text) {
+      messages.push({
+        kind: "message",
+        id: nanoid(8),
+        role: currentRole,
+        created_at: (/* @__PURE__ */ new Date()).toISOString(),
+        parts: [{ type: "text", text }]
+      });
+    }
+    currentContent = "";
+  }
+  for (const line of lines) {
+    let matched = false;
+    for (const [pattern, role] of rolePatterns) {
+      const match = line.match(pattern);
+      if (match) {
+        flush();
+        currentRole = role;
+        currentContent = line.slice(match[0].length).trim() + "\n";
+        matched = true;
+        break;
+      }
+    }
+    if (!matched) {
+      currentContent += line + "\n";
+    }
+  }
+  flush();
+  return messages;
+}
+
+// src/core/smart-paste/index.ts
+function smartParse(input) {
+  const format = detectFormat(input);
+  switch (format) {
+    case "openai":
+      return parseOpenAI(input);
+    case "anthropic":
+      return parseAnthropic(input);
+    case "google":
+      return parseGoogle(input);
+    case "vercel":
+      return parseVercel(input);
+    case "echo": {
+      const conversation = parseEcho(input);
+      return conversation.messages;
+    }
+    case "raw":
+      return parseRaw(input);
+    case "unknown":
+      return [
+        {
+          kind: "message",
+          id: crypto.randomUUID().slice(0, 8),
+          role: "user",
+          created_at: (/* @__PURE__ */ new Date()).toISOString(),
+          parts: [{ type: "text", text: input.trim() }]
+        }
+      ];
+  }
+}
+export {
+  detectFormat,
+  smartParse
+};

package/dist/core/types-CYpEmXbp.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Echo format types — the universal .echo message protocol.
+ *
+ * An .echo file is NDJSON (newline-delimited JSON).
+ * Line 1 is always an EchoMeta record.
+ * Subsequent lines are EchoMessage records.
+ */
+interface TextPart {
+    type: "text";
+    text: string;
+}
+interface ThinkingPart {
+    type: "thinking";
+    text: string;
+}
+interface ToolCallPart {
+    type: "tool_call";
+    id: string;
+    name: string;
+    input: unknown;
+}
+interface ToolResultPart {
+    type: "tool_result";
+    id: string;
+    output: unknown;
+    is_error?: boolean;
+}
+interface ImagePart {
+    type: "image";
+    url?: string;
+    base64?: string;
+    media_type?: string;
+}
+type EchoPart = TextPart | ThinkingPart | ToolCallPart | ToolResultPart | ImagePart;
+interface EchoToolDefinition {
+    name: string;
+    description?: string;
+    parameters: Record<string, unknown>;
+    strict?: boolean;
+}
+interface EchoSettings {
+    provider?: string;
+    model?: string;
+    temperature?: number;
+    max_tokens?: number;
+    top_p?: number;
+    response_format?: "text" | "json_object" | "json_schema";
+    json_schema?: {
+        name: string;
+        schema: Record<string, unknown>;
+        strict?: boolean;
+    };
+    tools?: EchoToolDefinition[];
+}
+type EchoRole = "system" | "user" | "assistant" | "tool";
+interface EchoMeta {
+    kind: "meta";
+    v: 1;
+    id: string;
+    title?: string;
+    created_at: string;
+    settings?: EchoSettings;
+}
+interface EchoMessage {
+    kind: "message";
+    id: string;
+    role: EchoRole;
+    created_at: string;
+    parts: EchoPart[];
+    meta?: {
+        provider?: string;
+        model?: string;
+        usage?: {
+            input_tokens?: number;
+            output_tokens?: number;
+        };
+        latency?: {
+            duration?: number;
+            ttft?: number;
+        };
+    };
+}
+type EchoRecord = EchoMeta | EchoMessage;
+interface EchoConversation {
+    meta: EchoMeta;
+    messages: EchoMessage[];
+}
+
+export type { EchoConversation as E, ImagePart as I, TextPart as T, EchoMessage as a, EchoMeta as b, EchoPart as c, EchoRecord as d, EchoRole as e, EchoSettings as f, EchoToolDefinition as g, ThinkingPart as h, ToolCallPart as i, ToolResultPart as j };

package/package.json

@@ -1,8 +1,97 @@
 {
   "name": "echospace",
-  "version": "0.0.1",
-  "description": "Local-first prompt debugging workspace for LLM developers",
-  "main": "index.js",
-  "keywords": ["llm", "prompt", "debugging", "workspace", "echo"],
-  "license": "MIT"
+  "version": "0.1.0-alpha.1",
+  "type": "module",
+  "description": "Open-source, local-first prompt debugging workspace for LLM developers",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/stonexer/echospace.git"
+  },
+  "homepage": "https://github.com/stonexer/echospace",
+  "bugs": "https://github.com/stonexer/echospace/issues",
+  "keywords": [
+    "llm",
+    "prompt",
+    "debugging",
+    "openai",
+    "anthropic",
+    "gemini",
+    "chatgpt",
+    "claude",
+    "ai",
+    "developer-tools"
+  ],
+  "bin": {
+    "echospace": "./dist/cli/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    "./core/echo": {
+      "import": "./dist/core/echo/index.js",
+      "types": "./dist/core/echo/index.d.ts"
+    },
+    "./core/smart-paste": {
+      "import": "./dist/core/smart-paste/index.js",
+      "types": "./dist/core/smart-paste/index.d.ts"
+    },
+    "./core/providers": {
+      "import": "./dist/core/providers/index.js",
+      "types": "./dist/core/providers/index.d.ts"
+    }
+  },
+  "scripts": {
+    "dev": "tsx watch src/cli/index.ts . -p 3240 --no-open & vite --clearScreen false; kill $!",
+    "dev:client": "vite",
+    "dev:server": "tsx watch src/cli/index.ts . -p 3240 --no-open",
+    "build": "vite build && tsup",
+    "preview": "vite preview",
+    "start": "node dist/cli/index.js",
+    "prepublishOnly": "pnpm run build",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "format": "prettier --write ."
+  },
+  "dependencies": {
+    "@hono/node-server": "^1.13.8",
+    "commander": "^13.1.0",
+    "get-port": "^7.1.0",
+    "hono": "^4.7.4",
+    "js-yaml": "^4.1.0",
+    "nanoid": "^5.1.2",
+    "open": "^10.1.2"
+  },
+  "devDependencies": {
+    "@codemirror/lang-json": "^6.0.1",
+    "@codemirror/lang-markdown": "^6.3.3",
+    "@codemirror/language-data": "^6.5.1",
+    "@hello-pangea/dnd": "^18.0.1",
+    "@tailwindcss/vite": "^4.1.3",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.13.10",
+    "@types/react": "^19.0.10",
+    "@types/react-dom": "^19.0.4",
+    "@uiw/react-codemirror": "^4.23.7",
+    "@vitejs/plugin-react-swc": "^4.0.0",
+    "autoprefixer": "^10.4.20",
+    "clsx": "^2.1.1",
+    "eslint": "^9.22.0",
+    "prettier": "^3.5.3",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "react-resizable-panels": "^2.1.7",
+    "sonner": "^1.7.4",
+    "tailwind-merge": "^3.0.2",
+    "tailwindcss": "^4.1.3",
+    "tiktoken": "^1.0.18",
+    "tsup": "^8.5.1",
+    "tsx": "^4.19.3",
+    "typescript": "^5.8.2",
+    "vite": "^6.2.4",
+    "vitest": "^4.0.18",
+    "zustand": "^5.0.3"
+  }
 }

package/index.js

@@ -1 +0,0 @@
-// coming soon