nanocodex 0.2.0 → 0.3.0

package/types.d.mts

@@ -22,9 +22,24 @@ export type AgentOptions = {
   fastMode?: boolean | undefined;
   sessionId?: string | undefined;
   thinking?: Thinking | undefined;
+  workspace?: string | undefined;
   resume?: SessionSnapshot | undefined;
 };
 
+export type EstimatedUsdCost = Readonly<{
+  usd: string;
+  input_usd: string;
+  cached_input_usd: string;
+  cache_write_input_usd: string;
+  output_usd: string;
+  service_tier: "standard" | "priority";
+}>;
+
+export type CostStatus =
+  | "estimated_from_usage"
+  | "usage_not_reported"
+  | "other";
+
 export type SessionSnapshot = Readonly<{
   version: number;
   model: string;
@@ -36,7 +51,18 @@ export type SessionSnapshot = Readonly<{
   history: readonly Record<string, unknown>[];
 }>;
 
-export type ForkOptions = { at?: Turn | undefined };
+export type TurnUsage = Readonly<{
+  input_tokens: number;
+  cached_input_tokens: number;
+  cache_write_input_tokens: number;
+  output_tokens: number;
+  reasoning_output_tokens: number;
+  total_tokens: number;
+  estimated_cost: EstimatedUsdCost | null;
+  cost_status: CostStatus;
+}>;
+
+export type ForkOptions = { at?: TurnResult | undefined };
 export type WatchEventsOptions = { includeAllSessions?: boolean | undefined };
 
 export type EventWatcher = Readonly<{
@@ -50,9 +76,11 @@ export type AgentActions = {
     watch(options?: WatchEventsOptions): EventWatcher;
   };
   session: {
+    compact(): Promise<void>;
     fork(options?: ForkOptions): Promise<DefaultAgent>;
     setFastMode(enabled: boolean): Promise<void>;
     setThinking(thinking: Thinking): Promise<void>;
+    shutdown(): Promise<void>;
     spawn(): Promise<DefaultAgent>;
   };
   turn: {
@@ -69,6 +97,7 @@ export type Agent<extended extends object = {}> = {
   extend<const extension extends object>(
     decorator: (agent: Agent<extended>) => extension,
   ): Agent<extended & extension>;
+  /** Releases this JavaScript/WASM handle without joining unfinished turns. */
   dispose(): void;
 } & extended;
 
@@ -76,13 +105,19 @@ export type DefaultAgent = Agent<AgentActions>;
 
 export type Turn<agent extends Agent<object> = Agent<object>> = Readonly<{
   readonly agent: agent;
-  result(): Promise<string>;
-  snapshot(): SessionSnapshot;
+  result(): Promise<TurnResult>;
   steer(options: { input: PromptInput }): Promise<void>;
   cancel(): Promise<void>;
+  /** Releases this handle without cancelling its accepted turn. */
   dispose(): void;
 }>;
 
+export type TurnResult = Readonly<{
+  finalMessage: string;
+  snapshot: SessionSnapshot;
+  usage: TurnUsage;
+}>;
+
 export type ToolContext = {
   callId: string;
   parentCallId: string;

package/scripts/check-package.mjs

@@ -1,38 +0,0 @@
-import assert from "node:assert/strict";
-import { readFile, stat } from "node:fs/promises";
-
-const root = new URL("../", import.meta.url);
-const packageJson = JSON.parse(await readFile(new URL("package.json", root), "utf8"));
-
-assert.equal(packageJson.name, "nanocodex");
-assert.equal(packageJson.type, "module");
-assert.equal(packageJson.publishConfig?.access, "public");
-assert.equal(packageJson.exports?.["./browser"]?.import, "./browser/index.mjs");
-assert.equal(packageJson.exports?.["./node"]?.import, "./node/index.mjs");
-
-const requiredFiles = [
-  "browser/index.mjs",
-  "browser/index.d.mts",
-  "node/index.mjs",
-  "node/index.d.mts",
-  "pkg-web/nanocodex.js",
-  "pkg-web/nanocodex.d.ts",
-  "pkg-web/nanocodex_bg.wasm",
-  "pkg-node/nanocodex.js",
-  "pkg-node/nanocodex.d.ts",
-  "pkg-node/nanocodex_bg.wasm",
-];
-
-for (const file of requiredFiles) {
-  const metadata = await stat(new URL(file, root));
-  assert(metadata.isFile(), `${file} must be a file`);
-  assert(metadata.size > 0, `${file} must not be empty`);
-}
-
-for (const target of ["web", "node"]) {
-  const wasm = await readFile(new URL(`pkg-${target}/nanocodex_bg.wasm`, root));
-  assert(wasm.byteLength > 100_000, `pkg-${target} WASM is unexpectedly small`);
-  assert.deepEqual([...wasm.subarray(0, 4)], [0x00, 0x61, 0x73, 0x6d]);
-}
-
-console.log(`nanocodex@${packageJson.version} package artifacts are complete`);