runtape 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alfredo Izquierdo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,68 @@
+# Runtape CLI
+
+> Flight recorder for AI coding agents. Replay every run, find every bug.
+
+`runtape` is the open-source CLI for [Runtape](https://runtape.dev) — observability and replay for AI coding agents like Claude Code.
+
+## Status
+
+v0.1 — MVP. The CLI captures Claude Code sessions via hooks and streams them to a Runtape backend.
+
+## Install
+
+```bash
+npm install -g runtape
+```
+
+(Requires Node.js ≥ 20.)
+
+## Get started
+
+```bash
+runtape login        # paste the API key from your runtape.dev dashboard
+runtape install      # add hooks to ~/.claude/settings.json
+# …run Claude Code normally…
+runtape runs         # open your dashboard in the browser
+runtape status       # buffer state, server reachability, flusher PID
+runtape uninstall    # remove the hooks when you're done
+```
+
+## How it works
+
+`runtape install` adds entries to `~/.claude/settings.json` so that Claude Code fires `runtape push --event <HookName>` on every relevant hook event. When installed under any `node_modules` tree (npm-global, pnpm-workspace, etc.), the entry uses the bare command name `runtape` so it survives package upgrades; when run from source (e.g. `tsx bin/runtape.ts` during local development) it uses the absolute path from `process.argv[1]`. Override with the `RUNTAPE_CLI_BIN` env var if you need a specific path. Each invocation appends one validated JSON line to `~/.runtape/buffer/<session_id>.ndjson` (sub-10ms) and lazily spawns a detached flusher daemon. The daemon batches events (up to 100 per POST) and ships them to the backend with exponential backoff on transient failures. It exits after 30s of idle.
+
+## State on disk
+
+```
+~/.runtape/
+  config.json                 # api_key (chmod 600), server_url
+  buffer/<session_id>.ndjson  # pending events
+  seq/<session_id>            # monotonic sequence counter
+  flusher.pid                 # daemon PID
+  flusher.log                 # daemon log (append-only)
+```
+
+Override the home dir with `RUNTAPE_HOME` (useful for tests). Override the server with `RUNTAPE_API_URL` or `runtape login --server-url <url>`.
+
+## Subpath exports
+
+Backend services that ingest Runtape events can import the shared Zod schemas:
+
+```ts
+import { RuntapeEvent, IngestionRequest } from "runtape/types";
+```
+
+The schemas live in `src/types.ts`. The package's `exports` map points TypeScript at the source file (no build step required for type consumers) and Node at the compiled `dist/types.js`.
+
+## Open source
+
+MIT licensed. Audit exactly what's captured. The Runtape backend (dashboard, ingestion API) is closed-source SaaS at [runtape.dev](https://runtape.dev).
+
+## Repos
+
+- This repo (`runtape`) — the open-source CLI
+- `runtape-mcp` — MCP server for Runtape (coming v0.2)
+
+## License
+
+[MIT](./LICENSE)

package/bin/runtape.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import('../dist/index.js');

package/dist/chunk-Q4RSBPGN.js

@@ -0,0 +1,81 @@
+// src/types.ts
+import { z } from "zod";
+var ClaudeHookBase = z.object({
+  session_id: z.string().min(1),
+  transcript_path: z.string().min(1),
+  cwd: z.string().min(1),
+  hook_event_name: z.string().min(1),
+  permission_mode: z.string().optional()
+});
+var CliAugment = z.object({
+  wall_ts: z.string().datetime(),
+  sequence: z.number().int().nonnegative()
+});
+var SessionStartEvent = ClaudeHookBase.extend(CliAugment.shape).extend({
+  type: z.literal("session_start"),
+  source: z.string()
+});
+var UserPromptEvent = ClaudeHookBase.extend(CliAugment.shape).extend({
+  type: z.literal("user_prompt"),
+  prompt: z.string()
+});
+var ToolAttemptEvent = ClaudeHookBase.extend(CliAugment.shape).extend({
+  type: z.literal("tool_attempt"),
+  tool_name: z.string().min(1),
+  tool_input: z.unknown(),
+  tool_use_id: z.string().min(1)
+});
+var ToolCallEvent = ClaudeHookBase.extend(CliAugment.shape).extend({
+  type: z.literal("tool_call"),
+  tool_name: z.string().min(1),
+  tool_input: z.unknown(),
+  tool_response: z.unknown(),
+  tool_use_id: z.string().min(1),
+  duration_ms: z.number().nonnegative()
+});
+var SubagentEndEvent = ClaudeHookBase.extend(CliAugment.shape).extend({
+  type: z.literal("subagent_end"),
+  agent_id: z.string().min(1),
+  agent_type: z.string().min(1),
+  agent_transcript_path: z.string().min(1),
+  last_assistant_message: z.string(),
+  stop_hook_active: z.boolean().optional()
+});
+var SessionEndEvent = ClaudeHookBase.extend(CliAugment.shape).extend({
+  type: z.literal("session_end"),
+  last_assistant_message: z.string().optional(),
+  stop_hook_active: z.boolean().optional()
+});
+var RuntapeEvent = z.discriminatedUnion("type", [
+  SessionStartEvent,
+  UserPromptEvent,
+  ToolAttemptEvent,
+  ToolCallEvent,
+  SubagentEndEvent,
+  SessionEndEvent
+]);
+var IngestionRequest = z.object({
+  events: z.array(RuntapeEvent).min(1).max(100)
+});
+var IngestionResponse = z.object({
+  accepted: z.number().int().nonnegative(),
+  errors: z.array(
+    z.object({
+      index: z.number().int().nonnegative(),
+      reason: z.string()
+    })
+  ).default([])
+});
+
+export {
+  SessionStartEvent,
+  UserPromptEvent,
+  ToolAttemptEvent,
+  ToolCallEvent,
+  SubagentEndEvent,
+  SessionEndEvent,
+  RuntapeEvent,
+  IngestionRequest,
+  IngestionResponse
+};
+//# sourceMappingURL=chunk-Q4RSBPGN.js.map

package/dist/chunk-Q4RSBPGN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import { z } from 'zod';\n\n// Every Claude Code hook event carries these envelope fields.\nconst ClaudeHookBase = z.object({\n  session_id: z.string().min(1),\n  transcript_path: z.string().min(1),\n  cwd: z.string().min(1),\n  hook_event_name: z.string().min(1),\n  permission_mode: z.string().optional(),\n});\n\n// CLI-augmented envelope adds monotonic ordering + wall-clock timestamp.\nconst CliAugment = z.object({\n  wall_ts: z.string().datetime(),\n  sequence: z.number().int().nonnegative(),\n});\n\nexport const SessionStartEvent = ClaudeHookBase.extend(CliAugment.shape).extend({\n  type: z.literal('session_start'),\n  source: z.string(),\n});\n\nexport const UserPromptEvent = ClaudeHookBase.extend(CliAugment.shape).extend({\n  type: z.literal('user_prompt'),\n  prompt: z.string(),\n});\n\nexport const ToolAttemptEvent = ClaudeHookBase.extend(CliAugment.shape).extend({\n  type: z.literal('tool_attempt'),\n  tool_name: z.string().min(1),\n  tool_input: z.unknown(),\n  tool_use_id: z.string().min(1),\n});\n\nexport const ToolCallEvent = ClaudeHookBase.extend(CliAugment.shape).extend({\n  type: z.literal('tool_call'),\n  tool_name: z.string().min(1),\n  tool_input: z.unknown(),\n  tool_response: z.unknown(),\n  tool_use_id: z.string().min(1),\n  duration_ms: z.number().nonnegative(),\n});\n\nexport const SubagentEndEvent = ClaudeHookBase.extend(CliAugment.shape).extend({\n  type: z.literal('subagent_end'),\n  agent_id: z.string().min(1),\n  agent_type: z.string().min(1),\n  agent_transcript_path: z.string().min(1),\n  last_assistant_message: z.string(),\n  stop_hook_active: z.boolean().optional(),\n});\n\nexport const SessionEndEvent = ClaudeHookBase.extend(CliAugment.shape).extend({\n  type: z.literal('session_end'),\n  last_assistant_message: z.string().optional(),\n  stop_hook_active: z.boolean().optional(),\n});\n\nexport const RuntapeEvent = z.discriminatedUnion('type', [\n  SessionStartEvent,\n  UserPromptEvent,\n  ToolAttemptEvent,\n  ToolCallEvent,\n  SubagentEndEvent,\n  SessionEndEvent,\n]);\n\nexport type RuntapeEvent = z.infer<typeof RuntapeEvent>;\n\n// POST /v1/events body — a batch of up to 100 events.\nexport const IngestionRequest = z.object({\n  events: z.array(RuntapeEvent).min(1).max(100),\n});\n\nexport type IngestionRequest = z.infer<typeof IngestionRequest>;\n\n// Response shape (server returns 200 on accepted, 400 on Zod failure, 401 on bad auth).\nexport const IngestionResponse = z.object({\n  accepted: z.number().int().nonnegative(),\n  errors: z\n    .array(\n      z.object({\n        index: z.number().int().nonnegative(),\n        reason: z.string(),\n      }),\n    )\n    .default([]),\n});\n\nexport type IngestionResponse = z.infer<typeof IngestionResponse>;\n"],"mappings":";AAAA,SAAS,SAAS;AAGlB,IAAM,iBAAiB,EAAE,OAAO;AAAA,EAC9B,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EAC5B,iBAAiB,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACjC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACrB,iBAAiB,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACjC,iBAAiB,EAAE,OAAO,EAAE,SAAS;AACvC,CAAC;AAGD,IAAM,aAAa,EAAE,OAAO;AAAA,EAC1B,SAAS,EAAE,OAAO,EAAE,SAAS;AAAA,EAC7B,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AACzC,CAAC;AAEM,IAAM,oBAAoB,eAAe,OAAO,WAAW,KAAK,EAAE,OAAO;AAAA,EAC9E,MAAM,EAAE,QAAQ,eAAe;AAAA,EAC/B,QAAQ,EAAE,OAAO;AACnB,CAAC;AAEM,IAAM,kBAAkB,eAAe,OAAO,WAAW,KAAK,EAAE,OAAO;AAAA,EAC5E,MAAM,EAAE,QAAQ,aAAa;AAAA,EAC7B,QAAQ,EAAE,OAAO;AACnB,CAAC;AAEM,IAAM,mBAAmB,eAAe,OAAO,WAAW,KAAK,EAAE,OAAO;AAAA,EAC7E,MAAM,EAAE,QAAQ,cAAc;AAAA,EAC9B,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EAC3B,YAAY,EAAE,QAAQ;AAAA,EACtB,aAAa,EAAE,OAAO,EAAE,IAAI,CAAC;AAC/B,CAAC;AAEM,IAAM,gBAAgB,eAAe,OAAO,WAAW,KAAK,EAAE,OAAO;AAAA,EAC1E,MAAM,EAAE,QAAQ,WAAW;AAAA,EAC3B,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EAC3B,YAAY,EAAE,QAAQ;AAAA,EACtB,eAAe,EAAE,QAAQ;AAAA,EACzB,aAAa,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EAC7B,aAAa,EAAE,OAAO,EAAE,YAAY;AACtC,CAAC;AAEM,IAAM,mBAAmB,eAAe,OAAO,WAAW,KAAK,EAAE,OAAO;AAAA,EAC7E,MAAM,EAAE,QAAQ,cAAc;AAAA,EAC9B,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EAC1B,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EAC5B,uBAAuB,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACvC,wBAAwB,EAAE,OAAO;AAAA,EACjC,kBAAkB,EAAE,QAAQ,EAAE,SAAS;AACzC,CAAC;AAEM,IAAM,kBAAkB,eAAe,OAAO,WAAW,KAAK,EAAE,OAAO;AAAA,EAC5E,MAAM,EAAE,QAAQ,aAAa;AAAA,EAC7B,wBAAwB,EAAE,OAAO,EAAE,SAAS;AAAA,EAC5C,kBAAkB,EAAE,QAAQ,EAAE,SAAS;AACzC,CAAC;AAEM,IAAM,eAAe,EAAE,mBAAmB,QAAQ;AAAA,EACvD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAKM,IAAM,mBAAmB,EAAE,OAAO;AAAA,EACvC,QAAQ,EAAE,MAAM,YAAY,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAC9C,CAAC;AAKM,IAAM,oBAAoB,EAAE,OAAO;AAAA,EACxC,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAAA,EACvC,QAAQ,EACL;AAAA,IACC,EAAE,OAAO;AAAA,MACP,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAAA,MACpC,QAAQ,EAAE,OAAO;AAAA,IACnB,CAAC;AAAA,EACH,EACC,QAAQ,CAAC,CAAC;AACf,CAAC;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }