@cad0p/pi-timestamps 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cad0p
+
+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,42 @@
+# pi-timestamps
+
+Inline UTC timestamps for every message in [pi](https://pi.dev) coding agent.
+
+```
+user message  2026-06-05T21:44:02Z
+assistant response  2026-06-05T21:44:02Z
+```
+
+## Features
+
+- **Inline** — timestamps appended directly to each message
+- **UTC ISO format** — `2026-06-05T21:44:02Z`
+- **Dim-styled** — uses ANSI dim (`\x1b[2m`) for visual parity with thinking blocks; works with any theme
+- **LLM-safe** — timestamps are stripped at the `context` event, so the model never sees them
+- **Zero config** — install and it works
+- **No dependencies** — pure TypeScript, no runtime deps
+
+## Install
+
+```bash
+pi install npm:@cad0p/pi-timestamps
+```
+
+Or try without installing:
+
+```bash
+pi -e npm:@cad0p/pi-timestamps
+```
+
+## How it works
+
+1. At `message_end`, appends `  2026-06-05T21:44:02Z` (dimmed) to user/assistant messages
+2. At `context` event (before LLM call), strips the timestamp from a deep copy — the session retains timestamps for history/replay; the LLM sees clean messages
+
+## Visual style
+
+Timestamps render with terminal's native "dim" attribute (SGR 2), matching pi's thinking block style. No hardcoded colors — works with light/dark themes automatically.
+
+## License
+
+MIT

package/extensions/message-timestamps/index.ts

@@ -0,0 +1,91 @@
+/**
+ * message-timestamps
+ *
+ * Appends a dim-styled UTC ISO timestamp to every user/assistant message.
+ * Uses ANSI dim escape codes for visual parity with thinking blocks.
+ * Strips at `context` so the LLM never sees them.
+ */
+
+import type {
+  AssistantMessage,
+  Message as PiAiMessage,
+  TextContent,
+  UserMessage,
+} from '@earendil-works/pi-ai';
+import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
+
+const DIM = '\x1b[2m';
+const RESET = '\x1b[0m';
+// Build regex from constants to avoid control chars in regex literal
+const TIMESTAMP_SUFFIX_REGEX = new RegExp(
+  ` ${DIM.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z${RESET.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}$`,
+);
+
+export function fmtUtc(ts: number): string {
+  return new Date(ts).toISOString().replace(/\.\d{3}Z$/, 'Z');
+}
+
+// biome-ignore lint/suspicious/noExplicitAny: content type varies by role
+export function appendTimestamp(content: PiAiMessage['content'], suffix: string): any {
+  const styled = `${DIM}${suffix}${RESET}`;
+  if (typeof content === 'string') {
+    return `${content}  ${styled}`;
+  }
+  return [...content, { type: 'text', text: `  ${styled}` }];
+}
+
+// biome-ignore lint/suspicious/noExplicitAny: content type varies by role
+export function stripTimestamp(content: PiAiMessage['content']): any {
+  if (typeof content === 'string') {
+    return content.replace(TIMESTAMP_SUFFIX_REGEX, '');
+  }
+  const arr = content as TextContent[];
+  if (arr.length > 0 && arr[arr.length - 1].type === 'text') {
+    const text = arr[arr.length - 1].text;
+    if (TIMESTAMP_SUFFIX_REGEX.test(text)) {
+      return arr.slice(0, -1) as PiAiMessage['content'];
+    }
+  }
+  return content;
+}
+
+function getTimestamp(msg: UserMessage | AssistantMessage): number {
+  return msg.timestamp ?? Date.now();
+}
+
+// biome-ignore lint/suspicious/noExplicitAny: pi event types are opaque
+type MessageEndEvent = { message: any };
+
+export { DIM, RESET, TIMESTAMP_SUFFIX_REGEX };
+
+export default function (pi: ExtensionAPI) {
+  // biome-ignore lint/suspicious/noExplicitAny: pi event types are opaque
+  pi.on('message_end' as any, async (event: MessageEndEvent, _ctx: any) => {
+    const msg = event.message;
+
+    if (msg.role !== 'user' && msg.role !== 'assistant') {
+      return;
+    }
+
+    const ts = getTimestamp(msg as UserMessage | AssistantMessage);
+    const suffix = fmtUtc(ts);
+
+    return {
+      message: {
+        ...msg,
+        // biome-ignore lint/suspicious/noExplicitAny: msg content is opaque
+        content: appendTimestamp((msg as any).content, suffix),
+      },
+    };
+  });
+
+  // biome-ignore lint/suspicious/noExplicitAny: pi event types are opaque
+  pi.on('context' as any, async (event: { messages: any[] }, _ctx: any) => {
+    const cleanMessages = event.messages.map((m) => ({
+      ...m,
+      // biome-ignore lint/suspicious/noExplicitAny: message content is opaque
+      content: stripTimestamp((m as any).content),
+    }));
+    return { messages: cleanMessages };
+  });
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@cad0p/pi-timestamps",
+  "version": "0.1.0",
+  "description": "Inline UTC timestamps for every message in pi coding agent — dim-styled, LLM-safe, zero-config",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "keywords": [
+    "pi",
+    "pi-package",
+    "pi-extension",
+    "timestamps",
+    "chat-history",
+    "message-metadata"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cad0p/pi-timestamps.git"
+  },
+  "homepage": "https://github.com/cad0p/pi-timestamps#readme",
+  "bugs": {
+    "url": "https://github.com/cad0p/pi-timestamps/issues"
+  },
+  "files": [
+    "extensions/message-timestamps/index.ts",
+    "README.md",
+    "LICENSE"
+  ],
+  "pi": {
+    "extensions": [
+      "extensions/message-timestamps"
+    ]
+  },
+  "scripts": {
+    "lint": "bunx biome check extensions/",
+    "lint:fix": "bunx biome check --write extensions/",
+    "typecheck": "bunx tsc --noEmit",
+    "test": "bun test"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.16",
+    "@types/bun": "^1.3.0",
+    "typescript": "^5.8.0"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": ">=0.74.0",
+    "@earendil-works/pi-tui": ">=0.74.0"
+  },
+  "license": "MIT"
+}