@nomix-ai/nomix-harness 0.2.5 → 0.2.6

package/dist/kernel/terminal-bash/lib/types/index.js

@@ -5,7 +5,8 @@
  */
 import { TerminalBackendCleanupError } from '../../../terminal/lib/index.js';
 import { effectiveSandboxMode } from '../../../sandbox-policy/lib/index.js';
-import { validateConfig } from "./config.js";
+import { ENCODING_PREAMBLE } from '../../../pwsh-local/lib/index.js';
+import { resolveConfig, validateConfig } from "./config.js";
 import { LocalPtySession } from "./session.js";
 import { CONTROLLED_PROMPT } from "./sanitize.js";
 export { Config } from "./config.js";
@@ -35,24 +36,39 @@ function ensureSandboxModeFence(ctx, owner) {
         throw new Error(`cannot change sandbox mode from "${currentMode}" to "${event.data.mode}" while persistent terminal sessions are open or being created; wait for creation to settle and close them first`);
     }, { global: true });
 }
-function childEnvironment(spec) {
+function childEnvironment(spec, dialect) {
     // The subprocess provider supplies its own scrubbed ambient base; these are
     // deliberate terminal-specific overrides layered after it.
-    return {
+    const common = {
         TERM: 'dumb',
         PAGER: 'cat',
         GIT_PAGER: 'cat',
+        NOMIX_SHELL: '1',
+        NOMIX_SESSION_ID: spec.owner.id,
+        NOMIX_PTY_SESSION_ID: spec.sessionId,
+    };
+    if (dialect === 'pwsh') {
+        // pwsh ignores PS1/PROMPT_COMMAND; its prompt is installed by the startup
+        // bootstrap instead, and NO_COLOR keeps the renderer quiet.
+        return { ...common, NO_COLOR: '1' };
+    }
+    return {
+        ...common,
         PS1: CONTROLLED_PROMPT,
         // Re-asserting PS1 after the marker keeps prompt readiness working when a
         // command overwrote the shell variable: bash runs PROMPT_COMMAND before
         // rendering each prompt, so an override never survives to the next prompt.
         PROMPT_COMMAND: `printf "\\033]133;D;%s\\007" "$?"; PS1='${CONTROLLED_PROMPT}'`,
         BASH_SILENCE_DEPRECATION_WARNING: '1',
-        NOMIX_SHELL: '1',
-        NOMIX_SESSION_ID: spec.owner.id,
-        NOMIX_PTY_SESSION_ID: spec.sessionId,
     };
 }
+/**
+ * The pwsh prompt function that emits the shared OSC `133;D;` + BEL marker
+ * before every prompt, mirroring bash's PROMPT_COMMAND. `[char]27`/`[char]7`
+ * build the control bytes at runtime because raw ESC characters in submitted
+ * input are unreliable under PSReadLine.
+ */
+export const PWSH_PROMPT_SETUP = "function prompt { [Console]::Write([char]27 + ']133;D;' + [int]$LASTEXITCODE + [char]7); '" + CONTROLLED_PROMPT + "' }";
 function spawnArgv(ctx, config, policy) {
     const argv = [config.shellPath, ...config.shellArgs];
     if (policy.mode === 'danger-full-access')
@@ -67,9 +83,44 @@ function spawnArgv(ctx, config, policy) {
 // TODO(pty-initialize-race-home): Fold this outer abort race into
 // LocalPtySession.initialize when the send-state consolidation lands; the
 // session already owns the send lifecycle the race protects.
-async function initializeSession(session, signal) {
+async function startupSession(session, dialect, signal) {
+    const start = async () => {
+        if (dialect === 'bash') {
+            await session.initialize(signal);
+            return;
+        }
+        // pwsh cannot install its prompt from the environment: write the prompt
+        // function through the session and wait for the first marker prompt,
+        // which is also the readiness contract of the bash initialize path. The
+        // first send also pins UTF-8 output (the shared pwsh-local preamble)
+        // before anything runs: the session decode path treats PTY bytes as
+        // UTF-8, and an un-pinned console writes its host code page for
+        // non-ASCII output. The banner-to-prompt gap can outlast the silence
+        // bound, so the wait loops over follow-up sends until the controlled
+        // prompt is actually visible (in the viewport or the retained scrollback
+        // when it landed between sends), bounded by the send deadline.
+        let viewport = '';
+        for (;;) {
+            const first = viewport.length === 0;
+            const operation = session.startSend({
+                text: first ? ENCODING_PREAMBLE + PWSH_PROMPT_SETUP : '',
+                submit: first,
+                ...signal !== undefined ? { signal } : {},
+            });
+            const result = await operation.done;
+            if (result.waitReason === 'session_exit')
+                throw new Error('PTY shell exited during startup');
+            if (result.waitReason === 'timeout')
+                throw new Error('PTY shell did not reach readiness before startup timeout');
+            viewport = result.viewport;
+            const scrollback = session.read({ offset: 0, count: 20 }).text;
+            if (viewport.includes(CONTROLLED_PROMPT) || scrollback.includes(CONTROLLED_PROMPT))
+                break;
+        }
+        session.motd = viewport;
+    };
     if (signal === undefined) {
-        await session.initialize(signal);
+        await start();
         return;
     }
     const aborted = Promise.withResolvers();
@@ -77,7 +128,7 @@ async function initializeSession(session, signal) {
     signal.addEventListener('abort', onAbort, { once: true });
     try {
         signal.throwIfAborted();
-        await Promise.race([session.initialize(signal), aborted.promise]);
+        await Promise.race([start(), aborted.promise]);
     }
     finally {
         signal.removeEventListener('abort', onAbort);
@@ -107,7 +158,7 @@ export class BashTerminalBackend {
         const terminal = await this.spawnTerminal({
             argv,
             cwd: spec.cwd ?? policy.workspaceRoot,
-            env: childEnvironment(spec),
+            env: childEnvironment(spec, this.config.shellDialect),
             rows: this.config.rows,
             cols: this.config.cols,
             graceMs: this.config.disposeGraceMs,
@@ -115,7 +166,7 @@ export class BashTerminalBackend {
         });
         const session = this.createSession(terminal, this.config);
         try {
-            await initializeSession(session, spec.signal);
+            await startupSession(session, this.config.shellDialect, spec.signal);
             return session;
         }
         catch (error) {
@@ -131,7 +182,8 @@ export class BashTerminalBackend {
 }
 /** Register the local PTY backend. */
 export function apply(ctx, config) {
-    validateConfig(config);
-    ctx.terminals.registerBackend(new BashTerminalBackend(ctx, config));
+    const resolved = resolveConfig(config);
+    validateConfig(resolved);
+    ctx.terminals.registerBackend(new BashTerminalBackend(ctx, resolved));
 }
 //# sourceMappingURL=index.js.map

package/dist/kernel/terminal-bash/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-terminal-bash",
   "description": "Persistent shell PTY backend over the Nomix Harness subprocess terminal primitive",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },
@@ -42,6 +42,7 @@
     "@nomix-ai/cordis": "workspace:^"
   },
   "dependencies": {
+    "@nomix-ai/nomix-pwsh-local": "workspace:^",
     "@nomix-ai/schemastery": "workspace:^"
   },
   "devDependencies": {

package/dist/kernel/time-context/lib/index.js

@@ -119,7 +119,7 @@ new RegExp(String.raw`\b(?:input|prompt|request|messages?)\b.{0,40}` + String.ra
 *
 * @module @nomix-ai/nomix-llm/retry-policy
 */
-const DEFAULT_MAX_RETRIES = 2;
+const DEFAULT_MAX_RETRIES = 5;
 const DEFAULT_INITIAL_DELAY_MS = 500;
 const DEFAULT_MAX_DELAY_MS = 1e4;
 const DEFAULT_JITTER_RATIO = .1;

package/dist/kernel/time-context/lib/invariant.js

@@ -29,7 +29,7 @@ new RegExp(String.raw`\b(?:input|prompt|request|messages?)\b.{0,40}` + String.ra
 *
 * @module @nomix-ai/nomix-llm/retry-policy
 */
-const DEFAULT_MAX_RETRIES = 2;
+const DEFAULT_MAX_RETRIES = 5;
 const DEFAULT_INITIAL_DELAY_MS = 500;
 const DEFAULT_MAX_DELAY_MS = 1e4;
 const DEFAULT_JITTER_RATIO = .1;

package/dist/kernel/time-context/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-time-context",
   "description": "Opt-in durable per-step context with the current time and elapsed time",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },

package/dist/kernel/timeout/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-timeout",
   "description": "Zero-dependency timeout/deadline primitive: clampTimeout, deadline, timeoutOf, TimeoutReason (timing + classification only, no termination)",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },

package/dist/kernel/tmux-context/lib/index.js

@@ -119,7 +119,7 @@ new RegExp(String.raw`\b(?:input|prompt|request|messages?)\b.{0,40}` + String.ra
 *
 * @module @nomix-ai/nomix-llm/retry-policy
 */
-const DEFAULT_MAX_RETRIES = 2;
+const DEFAULT_MAX_RETRIES = 5;
 const DEFAULT_INITIAL_DELAY_MS = 500;
 const DEFAULT_MAX_DELAY_MS = 1e4;
 const DEFAULT_JITTER_RATIO = .1;

package/dist/kernel/tmux-context/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-tmux-context",
   "description": "Opt-in durable per-step context with this agent's tmux pane and window location",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },

package/dist/kernel/token-meter/lib/index.js

@@ -142,6 +142,16 @@ function foldSurfaceProjection(claim, event) {
 		claim: void 0
 	};
 }
+//#endregion
+//#region lib/types/breakdown-projection.js
+/**
+* Pure fold for the heuristic context-composition projection: system prompt
+* and tool schemas from the newest request envelope, conversation from the
+* live surface. Prices with the same shared estimator as the meter service,
+* so the three figures match `measure()`'s heuristic vocabulary exactly.
+*/
+/** Non-negative integer token count (the shared figure shape). */
+const tokenCount = z$1.number().int().nonnegative();
 /**
 * Token-meter's context-composition projection unit.
 *
@@ -155,10 +165,16 @@ function foldSurfaceProjection(claim, event) {
 */
 const contextBreakdownProjectionDefinition = {
 	key: "contextBreakdown",
-	schema: z$1.object({
-		systemTokens: z$1.number().int().nonnegative(),
-		toolsTokens: z$1.number().int().nonnegative(),
-		messageTokens: z$1.number().int().nonnegative()
+	stateVersion: 2,
+	stateSchema: z$1.object({
+		systemTokens: tokenCount,
+		toolsTokens: tokenCount,
+		messageTokens: tokenCount,
+		claim: z$1.object({
+			start: tokenCount,
+			end: tokenCount,
+			tokens: tokenCount
+		}).optional()
 	}).strict(),
 	init: () => ({
 		systemTokens: 0,
@@ -182,12 +198,18 @@ const contextBreakdownProjectionDefinition = {
 			...fold.claim === void 0 ? {} : { claim: fold.claim }
 		};
 	},
-	view: ({ systemTokens, toolsTokens, messageTokens }) => ({
-		systemTokens,
-		toolsTokens,
-		messageTokens
-	}),
-	stateVersion: 2
+	wire: {
+		viewSchema: z$1.object({
+			systemTokens: tokenCount,
+			toolsTokens: tokenCount,
+			messageTokens: tokenCount
+		}).strict(),
+		view: ({ systemTokens, toolsTokens, messageTokens }) => ({
+			systemTokens,
+			toolsTokens,
+			messageTokens
+		})
+	}
 };
 //#endregion
 //#region lib/types/usage-projection.js
@@ -219,15 +241,43 @@ const projectionSchema = z$1.object({
 	cacheReadTokens: z$1.number().int().nonnegative(),
 	cacheWriteTokens: z$1.number().int().nonnegative()
 }).strict();
+/**
+* The token-usage unit's state schema — the one definition of the state
+* shape; the state type is inferred from it.
+*/
+const tokenUsageStateSchema = z$1.object({
+	totals: projectionSchema,
+	last: z$1.object({
+		turn: z$1.number().int().nonnegative(),
+		step: z$1.number().int().nonnegative(),
+		buckets: projectionSchema
+	}).nullable()
+}).strict();
 const pressureSchema = z$1.object({
 	pressureTokens: z$1.number().int().nonnegative().optional(),
 	projectedTokens: z$1.number().int().nonnegative().optional(),
 	contextWindow: z$1.number().int().positive().optional()
-}).strict();
+}).strict().transform(({ pressureTokens, projectedTokens, contextWindow }) => ({
+	...pressureTokens === void 0 ? {} : { pressureTokens },
+	...projectedTokens === void 0 ? {} : { projectedTokens },
+	...contextWindow === void 0 ? {} : { contextWindow }
+}));
 /** Prompt-side pressure of one request: input plus cache traffic, no output. */
 const pressureFrom = (usage) => usage.inputTokens + (usage.cacheReadTokens ?? 0) + (usage.cacheWriteTokens ?? 0);
 /** The usage a chunk or finalized message reports for its step, if any. */
 const usageOf = (event) => event.type === "assistant/chunk" && event.data.chunk.type === "usage" ? event.data.chunk.usage : event.type === "assistant/message" ? event.data.usage : void 0;
+/** The context-pressure state schema and source of its inferred type. */
+const contextPressureStateSchema = z$1.object({
+	contextWindow: z$1.number().int().positive().optional(),
+	pressureTokens: z$1.number().int().nonnegative().optional(),
+	surfaceTokens: z$1.number().int().nonnegative(),
+	sampledSurfaceTokens: z$1.number().int().nonnegative().optional(),
+	claim: z$1.object({
+		start: z$1.number().int().nonnegative(),
+		end: z$1.number().int().nonnegative(),
+		tokens: z$1.number().int().nonnegative()
+	}).optional()
+}).strict();
 /**
 * Token-meter's session projection unit.
 *
@@ -240,7 +290,8 @@ const usageOf = (event) => event.type === "assistant/chunk" && event.data.chunk.
 */
 const tokenUsageProjectionDefinition = {
 	key: "tokenUsage",
-	schema: projectionSchema,
+	stateVersion: 1,
+	stateSchema: tokenUsageStateSchema,
 	init: () => ({
 		totals: zeroBuckets(),
 		last: null
@@ -266,8 +317,10 @@ const tokenUsageProjectionDefinition = {
 			}
 		};
 	},
-	view: (state) => state.totals,
-	stateVersion: 1
+	wire: {
+		viewSchema: projectionSchema,
+		view: (state) => state.totals
+	}
 };
 /**
 * Token-meter's context-occupancy projection unit.
@@ -292,7 +345,8 @@ const tokenUsageProjectionDefinition = {
 */
 const contextPressureProjectionDefinition = {
 	key: "contextPressure",
-	schema: pressureSchema,
+	stateVersion: 4,
+	stateSchema: contextPressureStateSchema,
 	init: () => ({ surfaceTokens: 0 }),
 	apply: (state, event) => {
 		const fold = foldSurfaceProjection(state.claim, event);
@@ -328,12 +382,14 @@ const contextPressureProjectionDefinition = {
 			claim: fold.claim
 		};
 	},
-	view: ({ contextWindow, pressureTokens, surfaceTokens, sampledSurfaceTokens }) => ({
-		...contextWindow === void 0 ? {} : { contextWindow },
-		...pressureTokens === void 0 ? {} : { pressureTokens },
-		...pressureTokens === void 0 || sampledSurfaceTokens === void 0 ? {} : { projectedTokens: Math.max(0, pressureTokens + surfaceTokens - sampledSurfaceTokens) }
-	}),
-	stateVersion: 4
+	wire: {
+		viewSchema: pressureSchema,
+		view: ({ contextWindow, pressureTokens, surfaceTokens, sampledSurfaceTokens }) => ({
+			...contextWindow === void 0 ? {} : { contextWindow },
+			...pressureTokens === void 0 ? {} : { pressureTokens },
+			...pressureTokens === void 0 || sampledSurfaceTokens === void 0 ? {} : { projectedTokens: Math.max(0, pressureTokens + surfaceTokens - sampledSurfaceTokens) }
+		})
+	}
 };
 //#endregion
 //#region lib/types/surface-fold.js

package/dist/kernel/token-meter/lib/types/breakdown-projection.d.ts

@@ -4,15 +4,24 @@
  * live surface. Prices with the same shared estimator as the meter service,
  * so the three figures match `measure()`'s heuristic vocabulary exactly.
  */
-import type { ProjectionDefinition } from '../../../session-projection/lib/index.js';
-import type { ShadowPriceClaim } from './surface-projection.ts';
-interface ContextBreakdownState {
-    systemTokens: number;
-    toolsTokens: number;
-    messageTokens: number;
-    /** Shadow price armed by the immediately preceding metering event. */
-    claim?: ShadowPriceClaim;
+import { z } from 'zod';
+declare module '@nomix-ai/nomix-session-projection/types' {
+    interface SessionProjectionStateMap {
+        contextBreakdown: ContextBreakdownState;
+    }
 }
+/** The context-breakdown state schema and source of its inferred type. */
+declare const contextBreakdownStateSchema: z.ZodObject<{
+    systemTokens: z.ZodNumber;
+    toolsTokens: z.ZodNumber;
+    messageTokens: z.ZodNumber;
+    claim: z.ZodOptional<z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+        tokens: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
+type ContextBreakdownState = z.infer<typeof contextBreakdownStateSchema>;
 /**
  * Token-meter's context-composition projection unit.
  *
@@ -24,6 +33,64 @@ interface ContextBreakdownState {
  * state is a fixed handful of numbers, so the persisted checkpoint stays
  * O(1) over the session's life.
  */
-export declare const contextBreakdownProjectionDefinition: ProjectionDefinition<'contextBreakdown', ContextBreakdownState>;
+export declare const contextBreakdownProjectionDefinition: {
+    key: "contextBreakdown";
+    stateVersion: number;
+    stateSchema: z.ZodObject<{
+        systemTokens: z.ZodNumber;
+        toolsTokens: z.ZodNumber;
+        messageTokens: z.ZodNumber;
+        claim: z.ZodOptional<z.ZodObject<{
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+            tokens: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strict>;
+    init: () => {
+        systemTokens: number;
+        toolsTokens: number;
+        messageTokens: number;
+    };
+    apply: (state: NoInfer<{
+        systemTokens: number;
+        toolsTokens: number;
+        messageTokens: number;
+        claim?: {
+            start: number;
+            end: number;
+            tokens: number;
+        } | undefined;
+    }>, event: import("../../../session/lib/index.js").SessionEvent) => {
+        systemTokens: number;
+        toolsTokens: number;
+        messageTokens: number;
+        claim?: {
+            start: number;
+            end: number;
+            tokens: number;
+        } | undefined;
+    };
+    wire: {
+        viewSchema: z.ZodObject<{
+            systemTokens: z.ZodNumber;
+            toolsTokens: z.ZodNumber;
+            messageTokens: z.ZodNumber;
+        }, z.core.$strict>;
+        view: ({ systemTokens, toolsTokens, messageTokens }: NoInfer<{
+            systemTokens: number;
+            toolsTokens: number;
+            messageTokens: number;
+            claim?: {
+                start: number;
+                end: number;
+                tokens: number;
+            } | undefined;
+        }>) => {
+            systemTokens: number;
+            toolsTokens: number;
+            messageTokens: number;
+        };
+    };
+};
 export {};
 //# sourceMappingURL=breakdown-projection.d.ts.map

package/dist/kernel/token-meter/lib/types/breakdown-projection.js

@@ -8,10 +8,23 @@ import { z } from 'zod';
 import { canonicalHeader } from '../../../session/lib/index.js';
 import { estimateSystemTokens, estimateToolsTokens } from "./estimate.js";
 import { foldSurfaceProjection } from "./surface-projection.js";
+/** Non-negative integer token count (the shared figure shape). */
+const tokenCount = z.number().int().nonnegative();
+/** The context-breakdown state schema and source of its inferred type. */
+const contextBreakdownStateSchema = z.object({
+    systemTokens: tokenCount,
+    toolsTokens: tokenCount,
+    messageTokens: tokenCount,
+    claim: z.object({
+        start: tokenCount,
+        end: tokenCount,
+        tokens: tokenCount,
+    }).optional(),
+}).strict();
 const breakdownSchema = z.object({
-    systemTokens: z.number().int().nonnegative(),
-    toolsTokens: z.number().int().nonnegative(),
-    messageTokens: z.number().int().nonnegative(),
+    systemTokens: tokenCount,
+    toolsTokens: tokenCount,
+    messageTokens: tokenCount,
 }).strict();
 /**
  * Token-meter's context-composition projection unit.
@@ -26,7 +39,8 @@ const breakdownSchema = z.object({
  */
 export const contextBreakdownProjectionDefinition = {
     key: 'contextBreakdown',
-    schema: breakdownSchema,
+    stateVersion: 2,
+    stateSchema: contextBreakdownStateSchema,
     init: () => ({ systemTokens: 0, toolsTokens: 0, messageTokens: 0 }),
     apply: (state, event) => {
         const fold = foldSurfaceProjection(state.claim, event);
@@ -50,7 +64,9 @@ export const contextBreakdownProjectionDefinition = {
             ...fold.claim === undefined ? {} : { claim: fold.claim },
         };
     },
-    view: ({ systemTokens, toolsTokens, messageTokens }) => ({ systemTokens, toolsTokens, messageTokens }),
-    stateVersion: 2,
+    wire: {
+        viewSchema: breakdownSchema,
+        view: ({ systemTokens, toolsTokens, messageTokens }) => ({ systemTokens, toolsTokens, messageTokens }),
+    },
 };
 //# sourceMappingURL=breakdown-projection.js.map