@taylorsatula/pi-timestamp 0.1.0

package/README.md

@@ -0,0 +1,62 @@
+# @taylorsatula/pi-timestamp
+
+Timestamp injection extension for [Pi](https://pi.dev) — the model always knows what time it is.
+
+## What it does
+
+Hooks `before_provider_request` and appends a synthetic tool-call pair to the outgoing message list, carrying the current local wall-clock time:
+
+```jsonc
+[
+  {
+    "role": "assistant",
+    "tool_calls": [
+      {
+        "id": "ts_1756220400000",
+        "type": "function",
+        "function": { "name": "__timestamp", "arguments": "{\"timestamp\":\"[3:00pm - 8/26/25]\"}" }
+      }
+    ]
+  },
+  { "role": "tool", "tool_call_id": "ts_1756220400000", "content": "ok" }
+]
+```
+
+Injection happens only at **turn boundaries**, not on every provider call:
+
+- Last message is a **user message** → inject.
+- Last message is an **assistant message with text content** (a vocalization between tool steps) → inject.
+- Last message is an assistant message with only `tool_calls`, or a tool result (mid-turn churn) → skip.
+
+This keeps the timestamp fresh each time control returns to the user-facing side of the loop, without spamming intermediate tool-loop requests.
+
+## Installation
+
+```bash
+pi install npm:@taylorsatula/pi-timestamp
+```
+
+Or add to `~/.pi/agent/settings.json` under `packages`:
+
+```json
+{
+  "packages": ["npm:@taylorsatula/pi-timestamp"]
+}
+```
+
+## Notes
+
+- Timestamps use the machine's **local time**, formatted `h:mmam/pm - M/D/YY` (e.g. `[3:07pm - 8/26/25]`).
+- No tools, commands, shortcuts, or settings are registered — the extension is invisible except for the injected messages.
+- The injected pair is added to the outgoing payload only; it is not persisted to the session transcript.
+
+## Development
+
+```bash
+npm install
+npm run check   # tsc --noEmit
+```
+
+## License
+
+MIT

package/extensions/timestamp.ts

@@ -0,0 +1,65 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+function formatTimestamp(): string {
+  const now = new Date();
+  let hours = now.getHours();
+  const minutes = now.getMinutes();
+  const ampm = hours >= 12 ? "pm" : "am";
+  hours = hours % 12;
+  if (hours === 0) hours = 12;
+  const month = now.getMonth() + 1;
+  const day = now.getDate();
+  const year = String(now.getFullYear()).slice(-2);
+  return `[${hours}:${String(minutes).padStart(2, "0")}${ampm} - ${month}/${day}/${year}]`;
+}
+
+function shouldInject(msgs: Array<Record<string, unknown>>): boolean {
+  const last = msgs[msgs.length - 1];
+  if (!last) return false;
+
+  // User message → inject
+  if (last.role === "user") return true;
+
+  // Assistant with text content (vocalization) → inject
+  // Assistant with only tool_calls (intermediate) → skip
+  if (last.role === "assistant") {
+    const hasToolCalls = Array.isArray(last.tool_calls) && last.tool_calls.length > 0;
+    const hasContent = last.content != null && last.content !== "";
+    return !hasToolCalls && hasContent;
+  }
+
+  // Tool results → skip (intermediate)
+  return false;
+}
+
+export default function (pi: ExtensionAPI) {
+  pi.on("before_provider_request", (event) => {
+    const payload = event.payload as Record<string, unknown>;
+    const msgs = payload.messages as Array<Record<string, unknown>>;
+
+    if (!shouldInject(msgs)) return;
+
+    const timestamp = formatTimestamp();
+    const callId = `ts_${Date.now()}`;
+
+    msgs.push(
+      {
+        role: "assistant",
+        tool_calls: [
+          {
+            id: callId,
+            type: "function",
+            function: { name: "__timestamp", arguments: JSON.stringify({ timestamp }) },
+          },
+        ],
+      },
+      {
+        role: "tool",
+        tool_call_id: callId,
+        content: "ok",
+      },
+    );
+
+    return event.payload;
+  });
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@taylorsatula/pi-timestamp",
+  "version": "0.1.0",
+  "description": "Timestamp injection extension for Pi — appends the current wall-clock time as a synthetic tool-call pair to every provider request at turn boundaries, so the model always knows what time it is.",
+  "keywords": [
+    "pi-package"
+  ],
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/taylorsatula/pi-timestamp"
+  },
+  "files": [
+    "extensions",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "@earendil-works/pi-agent-core": "*",
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.3",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "check": "tsc --noEmit"
+  },
+  "pi": {
+    "extensions": [
+      "./extensions/timestamp.ts"
+    ]
+  }
+}