instar 1.3.326 → 1.3.328

package/dist/utils/localTime.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Local-timezone timestamp rendering for agent-facing context blocks.
+ *
+ * Why this exists (2026-06-05 time-incoherency incident): every injected
+ * thread-history surface rendered timestamps as unlabeled UTC
+ * (`toISOString().slice(11, 19)`). An agent read `[21:23:10]` as local
+ * wall-clock and told the user "you heard nothing between 9:23pm and now"
+ * about an event that happened at 2:23pm the user's time — while the
+ * session-start hook injects CURRENT TIME in local time. Two clocks, one
+ * labeled, one not.
+ *
+ * Structure > Willpower: agents cannot be trusted to remember that history
+ * timestamps are UTC while wall-clock is local. Every timestamp an agent
+ * sees MUST be rendered in the host's local timezone with an explicit
+ * timezone label, so no conversion discipline is required.
+ *
+ * All thread-history / topic-context / compaction-resume renderers MUST use
+ * this helper instead of hand-rolling `toISOString()` slices.
+ */
+/**
+ * The host's short timezone label for a given instant (e.g. "PDT", "GMT+2").
+ * Empty string if Intl can't resolve one — callers render without a label
+ * rather than failing.
+ */
+export declare function localTzAbbreviation(d?: Date): string;
+/**
+ * Format a timestamp in the HOST's local timezone with an explicit tz label.
+ *
+ * Default shape: `2026-06-05 14:23 PDT` (date + minutes + label) — history
+ * lines spanning midnight stay unambiguous, and minute granularity matches
+ * how users talk about time. Options:
+ *   - `date: false`   → `14:23 PDT` (for compact status lines)
+ *   - `seconds: true` → include `:SS`
+ *
+ * Invalid / missing input renders as `??:??` (the existing sentinel the
+ * history formats already used).
+ */
+export declare function formatLocalTimestamp(input: string | number | Date | null | undefined, opts?: {
+    date?: boolean;
+    seconds?: boolean;
+}): string;
+//# sourceMappingURL=localTime.d.ts.map

package/dist/utils/localTime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localTime.d.ts","sourceRoot":"","sources":["../../src/utils/localTime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,GAAE,IAAiB,GAAG,MAAM,CAShE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,EAChD,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/C,MAAM,CAUR"}

package/dist/utils/localTime.js

@@ -0,0 +1,60 @@
+/**
+ * Local-timezone timestamp rendering for agent-facing context blocks.
+ *
+ * Why this exists (2026-06-05 time-incoherency incident): every injected
+ * thread-history surface rendered timestamps as unlabeled UTC
+ * (`toISOString().slice(11, 19)`). An agent read `[21:23:10]` as local
+ * wall-clock and told the user "you heard nothing between 9:23pm and now"
+ * about an event that happened at 2:23pm the user's time — while the
+ * session-start hook injects CURRENT TIME in local time. Two clocks, one
+ * labeled, one not.
+ *
+ * Structure > Willpower: agents cannot be trusted to remember that history
+ * timestamps are UTC while wall-clock is local. Every timestamp an agent
+ * sees MUST be rendered in the host's local timezone with an explicit
+ * timezone label, so no conversion discipline is required.
+ *
+ * All thread-history / topic-context / compaction-resume renderers MUST use
+ * this helper instead of hand-rolling `toISOString()` slices.
+ */
+/**
+ * The host's short timezone label for a given instant (e.g. "PDT", "GMT+2").
+ * Empty string if Intl can't resolve one — callers render without a label
+ * rather than failing.
+ */
+export function localTzAbbreviation(d = new Date()) {
+    try {
+        const part = new Intl.DateTimeFormat('en-US', { timeZoneName: 'short' })
+            .formatToParts(d)
+            .find((p) => p.type === 'timeZoneName');
+        return part?.value ?? '';
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Format a timestamp in the HOST's local timezone with an explicit tz label.
+ *
+ * Default shape: `2026-06-05 14:23 PDT` (date + minutes + label) — history
+ * lines spanning midnight stay unambiguous, and minute granularity matches
+ * how users talk about time. Options:
+ *   - `date: false`   → `14:23 PDT` (for compact status lines)
+ *   - `seconds: true` → include `:SS`
+ *
+ * Invalid / missing input renders as `??:??` (the existing sentinel the
+ * history formats already used).
+ */
+export function formatLocalTimestamp(input, opts = {}) {
+    if (input == null || input === '')
+        return '??:??';
+    const d = input instanceof Date ? input : new Date(input);
+    if (Number.isNaN(d.getTime()))
+        return '??:??';
+    const pad = (n) => String(n).padStart(2, '0');
+    const datePart = opts.date === false ? '' : `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} `;
+    const time = `${pad(d.getHours())}:${pad(d.getMinutes())}${opts.seconds ? `:${pad(d.getSeconds())}` : ''}`;
+    const tz = localTzAbbreviation(d);
+    return `${datePart}${time}${tz ? ` ${tz}` : ''}`;
+}
+//# sourceMappingURL=localTime.js.map

package/dist/utils/localTime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localTime.js","sourceRoot":"","sources":["../../src/utils/localTime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAU,IAAI,IAAI,EAAE;IACtD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;aACrE,aAAa,CAAC,CAAC,CAAC;aAChB,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC;QAC1C,OAAO,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAgD,EAChD,OAA8C,EAAE;IAEhD,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,OAAO,CAAC;IAClD,MAAM,CAAC,GAAG,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1D,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,OAAO,CAAC;IAC9C,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtD,MAAM,QAAQ,GACZ,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC;IAChG,MAAM,IAAI,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC3G,MAAM,EAAE,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC;IAClC,OAAO,GAAG,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACnD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instar",
-  "version": "1.3.326",
+  "version": "1.3.328",
   "description": "Coherence infrastructure for self-evolving AI agents — on the Claude Code or Codex subscription you already have.",
   "type": "module",
   "main": "dist/index.js",