@jitsusama/agentic-harness.core 0.2.0 → 0.3.1

package/dist/google/apis/calendar.js

@@ -1,7 +1,7 @@
 /**
  * Google Calendar API client.
  */
-import { google } from "googleapis";
+import { google } from "./client.js";
 /**
  * List calendar events in a date range.
  */

package/dist/google/apis/client.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The googleapis client, loaded on first use.
+ *
+ * googleapis bundles a client for every Google API, about 1,800
+ * modules, and every extension that imports this package would load
+ * all of them at startup. This stands in for its `google` export and
+ * loads the real one the first time any API is asked for.
+ */
+import type { GoogleApis } from "googleapis";
+export declare const google: GoogleApis;

package/dist/google/apis/client.js

@@ -0,0 +1,23 @@
+/**
+ * The googleapis client, loaded on first use.
+ *
+ * googleapis bundles a client for every Google API, about 1,800
+ * modules, and every extension that imports this package would load
+ * all of them at startup. This stands in for its `google` export and
+ * loads the real one the first time any API is asked for.
+ */
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+let loaded;
+function load() {
+    loaded ??= require("googleapis").google;
+    return loaded;
+}
+export const google = new Proxy({}, {
+    get(_, property) {
+        const real = load();
+        const value = Reflect.get(real, property);
+        // The API factories read shared options off `this`.
+        return typeof value === "function" ? value.bind(real) : value;
+    },
+});

package/dist/google/apis/docs.js

@@ -1,7 +1,7 @@
 /**
  * Google Docs API client.
  */
-import { google } from "googleapis";
+import { google } from "./client.js";
 /**
  * Get document content, including all tabs.
  */

package/dist/google/apis/drive.js

@@ -1,7 +1,7 @@
 /**
  * Google Drive API client.
  */
-import { google } from "googleapis";
+import { google } from "./client.js";
 /**
  * List Drive files with optional filtering.
  */

package/dist/google/apis/gmail.js

@@ -1,7 +1,7 @@
 /**
  * Gmail API client.
  */
-import { google } from "googleapis";
+import { google } from "./client.js";
 /**
  * Search emails using Gmail query syntax.
  */

package/dist/google/apis/sheets.js

@@ -1,7 +1,7 @@
 /**
  * Google Sheets API client.
  */
-import { google } from "googleapis";
+import { google } from "./client.js";
 /**
  * Get spreadsheet content.
  */

package/dist/google/apis/slides.js

@@ -1,7 +1,7 @@
 /**
  * Google Slides API client.
  */
-import { google } from "googleapis";
+import { google } from "./client.js";
 /**
  * Get presentation content.
  */

package/dist/observability/index.d.ts

@@ -7,7 +7,15 @@
  * own database file. Rows are queryable on demand, roll up
  * into periodic per-model and per-persona summaries before
  * they age out, and drive a compact status-line figure.
+ *
+ * The ledger beside it covers the other side of the bill: the
+ * main loop's own turns, addressed by content so a total can
+ * be trusted.
+ *
+ * Reading a harness's log format into those turns is that
+ * harness's own business and lives in its package.
  */
+export { type CallScope, type CostDimension, type CostSlice, type DroppedCallRecord, type LedgerTotal, openTurnStore, type PaybackReplay, type RecordOutcome, type Regret, type RegretReport, type RepeatedCall, type SessionRecord, type ToolCallRecord, type TurnKind, type TurnRecord, type TurnStore, type VerifierKind, type VerifierOutcome, } from "./ledger/index.js";
 export { type RunRecorder, type RunRecordInput, recordRunEverywhere, registerRunRecorder, runRecordFrom, } from "./recorder.js";
 export { openRunStore, type RunQuery, type RunStore } from "./store.js";
 export type { RunCost, RunRecord, RunRollup, RunSummary, RunTokens, VerifyOutcome, } from "./types.js";

package/dist/observability/index.js

@@ -7,6 +7,14 @@
  * own database file. Rows are queryable on demand, roll up
  * into periodic per-model and per-persona summaries before
  * they age out, and drive a compact status-line figure.
+ *
+ * The ledger beside it covers the other side of the bill: the
+ * main loop's own turns, addressed by content so a total can
+ * be trusted.
+ *
+ * Reading a harness's log format into those turns is that
+ * harness's own business and lives in its package.
  */
+export { openTurnStore, } from "./ledger/index.js";
 export { recordRunEverywhere, registerRunRecorder, runRecordFrom, } from "./recorder.js";
 export { openRunStore } from "./store.js";

package/dist/observability/ledger/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The ledger: a store of billable turns, and what one is.
+ *
+ * Cost is derived from the logs a harness already writes rather than
+ * recorded a second time, so there is exactly one writer of the truth
+ * and the ledger can be rebuilt from scratch whenever its shape
+ * changes.
+ *
+ * Reading those logs is not here. A turn is a portable idea; the format
+ * it was written in is not, so each harness parses its own and hands
+ * over records. This module knows what a turn is and where to keep it.
+ */
+export { type CostDimension, type CostSlice, type LedgerTotal, openTurnStore, type RecordOutcome, type TurnStore, } from "./store.js";
+export type { CallScope, DroppedCallRecord, PaybackReplay, Regret, RegretReport, RepeatedCall, SessionRecord, ToolCallRecord, TurnKind, TurnRecord, VerifierKind, VerifierOutcome, } from "./types.js";

package/dist/observability/ledger/index.js

@@ -0,0 +1,13 @@
+/**
+ * The ledger: a store of billable turns, and what one is.
+ *
+ * Cost is derived from the logs a harness already writes rather than
+ * recorded a second time, so there is exactly one writer of the truth
+ * and the ledger can be rebuilt from scratch whenever its shape
+ * changes.
+ *
+ * Reading those logs is not here. A turn is a portable idea; the format
+ * it was written in is not, so each harness parses its own and hands
+ * over records. This module knows what a turn is and where to keep it.
+ */
+export { openTurnStore, } from "./store.js";

package/dist/observability/ledger/store.d.ts

@@ -0,0 +1,50 @@
+import type { CallScope, DroppedCallRecord, PaybackReplay, RegretReport, RepeatedCall, SessionRecord, ToolCallRecord, TurnRecord, VerifierOutcome } from "./types.js";
+/** What a dimension's slice of spend came to. */
+export interface CostSlice {
+    readonly key: string;
+    readonly cost: number;
+    readonly turns: number;
+}
+/** Everything the ledger holds, with its own blind spots stated. */
+export interface LedgerTotal {
+    readonly cost: number;
+    readonly turns: number;
+    /** Turns held with no cost, so a total can say what it is missing. */
+    readonly unmetered: number;
+    readonly cacheWriteTokens: number;
+    /** Of those, the ones billed at the one-hour rate. */
+    readonly cacheWrite1hTokens: number;
+}
+/** How many turns a write added, and how many it had already seen. */
+export interface RecordOutcome {
+    readonly inserted: number;
+    readonly duplicates: number;
+}
+/** What a total or a slice may be narrowed to. */
+export type CostDimension = "model" | "session" | "kind" | "day" | "repo" | "quest";
+/** A content-addressed store of billable turns. */
+export interface TurnStore {
+    recordTurns(turns: readonly TurnRecord[]): Promise<RecordOutcome>;
+    recordSession(session: SessionRecord): Promise<void>;
+    recordCalls(calls: readonly ToolCallRecord[]): Promise<RecordOutcome>;
+    queryCalls(): Promise<ToolCallRecord[]>;
+    /** Arguments asked more than once in one session, heaviest first. */
+    repeatedCalls(scope?: CallScope): Promise<RepeatedCall[]>;
+    recordDropped(dropped: readonly DroppedCallRecord[]): Promise<RecordOutcome>;
+    queryDropped(): Promise<DroppedCallRecord[]>;
+    /** Dropped calls asked again after the drop, with how many could have been. */
+    regret(scope?: CallScope): Promise<RegretReport>;
+    /** Pass, fail and unknown counts per verifier kind that ran at all. */
+    verifierOutcomes(): Promise<VerifierOutcome[]>;
+    /** How real compactions compare against the payback test. */
+    paybackReplay(): Promise<PaybackReplay>;
+    total(): Promise<LedgerTotal>;
+    costBy(dimension: CostDimension): Promise<CostSlice[]>;
+    close(): Promise<void>;
+}
+/**
+ * Open (creating if needed) a turn ledger at the given path. Safe to
+ * point at the same file as the run store: the tables are disjoint and
+ * WAL keeps readers clear of the single writer.
+ */
+export declare function openTurnStore(dbPath: string): Promise<TurnStore>;