@teeras/afterhours 0.1.1 → 0.3.1

package/dist/types.d.ts

@@ -2,10 +2,57 @@
 export type SourceId = string;
 export type Fidelity = "activity" | "sessions" | "detected" | "none";
 export interface TokenCounts {
-    input: number;
-    cached: number;
-    output: number;
-    reasoning: number;
+    /** Null means the source did not expose this counter. Zero means observed none. */
+    input: number | null;
+    cached: number | null;
+    output: number | null;
+    reasoning: number | null;
+}
+export type EpisodeConfidence = "high" | "medium" | "low";
+export type EpisodeStatus = "open" | "observed_end";
+/** Nearest-rank percentiles over one episode's measured turns. */
+export interface LatencyStats {
+    samples: number;
+    p50Ms: number;
+    p90Ms: number;
+}
+/**
+ * Content-free speed measurements. Every field is null when the source does
+ * not measure it — explicit missingness, never a guessed zero. `humanWait` is
+ * the estimated gap between a human message and the first observed agent
+ * activity that answers it.
+ */
+export interface EpisodeLatency {
+    timeToFirstToken: LatencyStats | null;
+    turnDuration: LatencyStats | null;
+    humanWait: LatencyStats | null;
+}
+/**
+ * A content-free unit of human supervision. The opaque id is HMAC-derived
+ * locally from the source session and cannot be reversed into a path.
+ */
+export interface DelegationEpisode {
+    id: string;
+    startedAt: string;
+    endedAt: string;
+    localDate: string;
+    localStartHour: number;
+    status: EpisodeStatus;
+    confidence: EpisodeConfidence;
+    metricVersion: "delegation-episode-v1";
+    adapterVersion: string;
+    modelFamily: string | null;
+    agentTurns: number;
+    humanCheckIns: number;
+    humanReEntries: number;
+    agentActiveMinutes: number;
+    humanAttentionMinutes: number;
+    longestAutonomousRunMinutes: number;
+    approvalRequests: number | null;
+    failureEvents: number | null;
+    reworkEvents: number | null;
+    latency: EpisodeLatency;
+    tokens: TokenCounts;
 }
 export interface ActivityBucket {
     /** ISO timestamp at the beginning of a local clock hour. */
@@ -18,6 +65,16 @@ export interface ActivityBucket {
     agentActiveMinutes: number;
     humanAttentionMinutes: number;
 }
+/**
+ * One model's share of a source's observed work. Turns are attributed to the
+ * model that produced them, so a session that switched models mid-way splits
+ * across entries instead of being credited entirely to the last model seen.
+ */
+export interface ModelActivity {
+    model: string;
+    agentTurns: number;
+    agentActiveMinutes: number;
+}
 export interface SourceSnapshot {
     id: SourceId;
     name: string;
@@ -27,7 +84,9 @@ export interface SourceSnapshot {
     agentTurns: number;
     humanCheckIns: number;
     tokens: TokenCounts;
+    models: ModelActivity[];
     buckets: ActivityBucket[];
+    episodes: DelegationEpisode[];
 }
 export interface DataBoundary {
     mode: "local-first";
@@ -37,7 +96,12 @@ export interface DataBoundary {
         "local date and hour",
         "event kinds",
         "session counts",
-        "token counters"
+        "token counters",
+        "content-free delegation episodes",
+        "measurement provenance and missingness",
+        "agent and model family",
+        "approval and lifecycle signals",
+        "reporting timezone"
     ];
     neverRetained: readonly [
         "prompt text",
@@ -49,32 +113,71 @@ export interface DataBoundary {
     ];
 }
 export interface AfterhoursSnapshot {
-    schemaVersion: 2;
+    schemaVersion: 3;
     generatedAt: string;
     since: string;
     until: string;
+    /**
+     * IANA timezone of the collecting machine (e.g. "Asia/Jerusalem"), or null
+     * when the runtime cannot name one. Buckets are already reduced to the local
+     * clock; this names which clock, so the server can keep day boundaries
+     * honest when the person travels or reads their dashboard elsewhere.
+     */
+    tz: string | null;
     sources: SourceSnapshot[];
     boundary: DataBoundary;
 }
 export interface SourceAdapter {
     id: SourceId;
     name: string;
+    version: string;
     collect(input: CollectInput): SourceSnapshot;
 }
 export interface CollectInput {
     home: string;
     sinceMs: number;
     untilMs: number;
+    /** Secret material used only to make source session identifiers opaque. */
+    episodeKeySecret: string;
+}
+/** The daily payoff: today's numbers against the person's own typical day. */
+export interface AfterhoursToday {
+    localDate: string;
+    lifeReturnedMinutes: number;
+    agentActiveMinutes: number;
+    humanAttentionMinutes: number;
+    longestRunMinutes: number;
+    longestRunSource: string | null;
+}
+/**
+ * Today's model responsiveness against the person's own window. Values are
+ * sample-weighted medians of episode medians — an estimate, labeled as one.
+ */
+export interface ModelSpeed {
+    todayHumanWaitP50Ms: number | null;
+    todayTurnDurationP50Ms: number | null;
+    baselineHumanWaitP50Ms: number | null;
+    baselineTurnDurationP50Ms: number | null;
 }
 export interface AfterhoursReport {
+    /** Clock time returned: agent wall-clock coverage minus supervised time. */
     lifeReturnedMinutes: number;
+    /** Total agent work observed. Exceeds the clock when sessions run in parallel. */
     agentActiveMinutes: number;
+    /** Hours of the day that had agent activity, counting each hour once. */
+    agentWallClockMinutes: number;
+    /** Agent work divided by clock time — how many ran at once. Null with no activity. */
+    parallelRatio: number | null;
     humanAttentionMinutes: number;
     afterHoursCheckIns: number;
     protectedNights: number;
     observedNights: number;
     agentTurns: number;
     humanCheckIns: number;
+    today: AfterhoursToday;
+    /** Median of other observed days in the window; null on the first measured day. */
+    baselineLifeReturnedMinutes: number | null;
+    modelSpeed: ModelSpeed;
     nextMove: string;
 }
 export interface DetectedAgent {

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;AAErE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,QAAQ,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,yBAAyB,CAAC;IAChC,QAAQ,EAAE,SAAS;QACjB,mBAAmB;QACnB,qBAAqB;QACrB,aAAa;QACb,gBAAgB;QAChB,gBAAgB;KACjB,CAAC;IACF,aAAa,EAAE,SAAS;QACtB,aAAa;QACb,aAAa;QACb,cAAc;QACd,kBAAkB;QAClB,qBAAqB;QACrB,YAAY;KACb,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,CAAC,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,QAAQ,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,cAAc,CAAC;CAC9C;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,QAAQ,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,WAAW,GAAG,kBAAkB,CAAC;IAC7C,MAAM,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/llms-install.md

@@ -0,0 +1,29 @@
+# Installing Teeras Afterhours (instructions for AI agents)
+
+You are likely a coding agent (Claude Code, Codex, Gemini CLI, or similar)
+installing this package for your user. Follow these steps:
+
+1. Run: `npx @teeras/afterhours setup`
+2. The command prints a short code and a `teeras.com` link. **Relay both to
+   your user verbatim** — they open the link on any device (their phone is
+   ideal), enter the code, and sign in with Google. The command waits and
+   finishes on its own.
+3. If your harness needs structured output, run `npx @teeras/afterhours setup --json`
+   and relay the `userCode` and `verificationUri` fields from the `code` event.
+4. After it completes, tell your user: their AI-life balance report is on
+   https://teeras.com and the Teeras iOS app, and it updates automatically
+   while they work — no further commands needed.
+
+Privacy, for you and your user: this tool retains counts only. Prompts, code,
+model output, repository names, working directories, and file paths are never
+read into the sync payload, never uploaded, and never logged. `npx
+@teeras/afterhours privacy` prints the machine-readable boundary.
+
+Setup is idempotent — re-running it repairs hooks and refreshes the
+connection. It installs lifecycle hooks for Claude Code and Codex when found,
+which record content-free session signals locally.
+
+To undo the install, tell your user to run `npx @teeras/afterhours off` — it
+removes the Teeras hook entries and the local runtime, leaving every other
+hook and their account untouched (`trs logout` separately disconnects the
+account).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teeras/afterhours",
-  "version": "0.1.1",
+  "version": "0.3.1",
   "description": "Private AI-life balance and usage analytics for Codex, Claude Code, Gemini CLI, Cursor, and other coding agents.",
   "homepage": "https://teeras.com",
   "keywords": [
@@ -30,7 +30,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "llms-install.md"
   ],
   "publishConfig": {
     "access": "public"