nanocodex 0.1.1 → 0.3.0

package/types.d.mts

@@ -19,11 +19,50 @@ export type AgentEvent = {
 export type AgentOptions = {
   instructions?: string | undefined;
   reasoningMode?: ReasoningMode | undefined;
+  fastMode?: boolean | undefined;
   sessionId?: string | undefined;
   thinking?: Thinking | undefined;
+  workspace?: string | undefined;
+  resume?: SessionSnapshot | undefined;
 };
 
-export type ForkOptions = { at?: Turn | 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;
+  lineage_id: string;
+  prompt_cache_key: string;
+  workspace: string;
+  request_prefix?: readonly Record<string, unknown>[] | undefined;
+  canonical_context: Record<string, unknown>;
+  history: readonly Record<string, unknown>[];
+}>;
+
+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<{
@@ -37,7 +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: {
@@ -54,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;
 
@@ -61,12 +105,19 @@ export type DefaultAgent = Agent<AgentActions>;
 
 export type Turn<agent extends Agent<object> = Agent<object>> = Readonly<{
   readonly agent: agent;
-  result(): Promise<string>;
+  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;
@@ -80,3 +131,17 @@ export type Tool = {
 };
 
 export type ToolMap = Record<string, Tool>;
+
+/** A paid WebSocket session, such as an mppx Tempo session manager. */
+export type MppSession = {
+  ws(endpoint: string | URL): Promise<MppWebSocket>;
+  close?(): unknown | Promise<unknown>;
+};
+
+export type MppWebSocket = {
+  readonly readyState: number;
+  readonly bufferedAmount?: number | undefined;
+  addEventListener(type: string, listener: (event: any) => void, options?: unknown): void;
+  send(message: string): void;
+  close(code?: number, reason?: string): void;
+};

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`);