@kynver-app/runtime 0.1.166 → 0.1.171

package/dist/box-identity.d.ts

@@ -15,5 +15,5 @@ export declare function normalizeWorkerPoolBoxKind(raw: string | null | undefine
  * Never maps AgentOS workspace slug alone to box kind — Forge installs must set
  * `boxKind` in ~/.kynver/config.json or `KYNVER_BOX_KIND`.
  */
-export declare function resolveBoxIdentity(env?: NodeJS.ProcessEnv, config?: Pick<KynverUserConfig, "boxKind">): ResolvedBoxIdentity;
-export declare function resolveBoxKindFromConfig(config?: Pick<KynverUserConfig, "boxKind">, env?: NodeJS.ProcessEnv): WorkerPoolBoxKind;
+export declare function resolveBoxIdentity(env?: NodeJS.ProcessEnv, config?: Pick<KynverUserConfig, "boxKind" | "boxId">): ResolvedBoxIdentity;
+export declare function resolveBoxKindFromConfig(config?: Pick<KynverUserConfig, "boxKind" | "boxId">, env?: NodeJS.ProcessEnv): WorkerPoolBoxKind;

package/dist/box-resource-snapshot-shared.d.ts

@@ -1,4 +1,13 @@
+import type { KynverUserConfig } from "./config.js";
 export { normalizeWorkerPoolBoxKind, resolveBoxIdentity } from "./box-identity.js";
 /** @deprecated Prefer resolveBoxIdentity — kept for callers that only need the kind string. */
 export declare function resolveBoxKindFromEnv(env?: NodeJS.ProcessEnv): string;
 export declare function defaultBoxId(boxKind: string, hostLabel?: string | null): string;
+export declare function normalizeConfiguredBoxId(raw: string, boxKind: string): string;
+export declare function resolveConfiguredBoxId(input: {
+    boxKind: string;
+    hostLabel?: string | null;
+    explicitBoxId?: string | null;
+    config?: Pick<KynverUserConfig, "boxId"> | null;
+    env?: NodeJS.ProcessEnv;
+}): string;

package/dist/byoc/m6-golden-path.d.ts

@@ -22,6 +22,12 @@ export type GoldenPathCheckCode =
  | "missing_codex_auth"
 /** Job's agentOsId does not match the runner's configured workspace. */
  | "wrong_workspace"
+/**
+ * Job envelope is structurally invalid (missing/blank required field or
+ * malformed dates). Indicates a control-plane/serialization problem, not a
+ * runner-config problem — distinct from `wrong_workspace`.
+ */
+ | "malformed_envelope"
 /** Job envelope has expired (expiresAt in the past). */
  | "job_expired"
 /**

package/dist/chat/chat-claim-loop.d.ts

@@ -24,6 +24,7 @@ export declare function executeCommandTurn(target: ChatBridgeTarget, turn: {
     turnId: string;
     payload: {
         argv?: unknown;
+        authProof?: unknown;
     };
 }): Promise<void>;
 /** Execute one claimed turn and stream its events back. Never throws. */

package/dist/chat/command-auth-proof.d.ts

@@ -0,0 +1,57 @@
+/** Default proof lifetime — must cover one gateway command wait + relay latency. */
+export declare const COMMAND_AUTH_PROOF_TTL_SEC = 120;
+export interface CommandAuthorizationProofPayload {
+    v: 1;
+    agentOsId: string;
+    argv: string[];
+    userId: string;
+    /** Unix epoch seconds. */
+    exp: number;
+    /** Single-use replay guard (base64url). */
+    nonce: string;
+}
+export interface SignedCommandAuthorizationProof {
+    payload: CommandAuthorizationProofPayload;
+    /** base64url Ed25519 signature over `canonicalJsonStringify(payload)`. */
+    signature: string;
+    /** Identifies the signing key (`ca-<sha256(publicKey) prefix>`). */
+    publicKeyId: string;
+}
+export type CommandAuthProofVerifyResult = {
+    ok: true;
+    payload: CommandAuthorizationProofPayload;
+} | {
+    ok: false;
+    reason: string;
+};
+export interface CommandAuthSigningKey {
+    seed: Uint8Array;
+    rawPublicKey: Uint8Array;
+    publicKeyId: string;
+    usingDevFallbackKey: boolean;
+}
+/**
+ * Committed DEV fallback public key (`ca-6297fb8e1773`). The matching private
+ * seed is committed below — NOT a production trust root.
+ */
+export declare const PINNED_COMMAND_AUTH_PUBLIC_KEYS: Readonly<Record<string, string>>;
+export declare function deriveCommandAuthKeyId(rawPublicKey: Uint8Array): string;
+export declare function resolveCommandAuthPublicKey(publicKeyId: string, env?: Record<string, string | undefined>): Uint8Array | null;
+export declare function argvMatchesProof(proofArgv: unknown, expectedArgv: readonly string[]): boolean;
+export declare function isSignedCommandAuthProofShape(value: unknown): value is SignedCommandAuthorizationProof;
+/** Verify signature + expiry + workspace/argv binding. */
+export declare function verifyCommandAuthorizationProof(signed: unknown, expected: {
+    agentOsId: string;
+    argv: readonly string[];
+}, env?: Record<string, string | undefined>, nowSec?: number): CommandAuthProofVerifyResult;
+export declare function resolveCommandAuthSigningKey(env?: Record<string, string | undefined>): CommandAuthSigningKey;
+/** Mint a signed proof after the app-side approval gate passes. */
+export declare function issueCommandAuthorizationProof(args: {
+    agentOsId: string;
+    argv: readonly string[];
+    userId: string;
+    ttlSec?: number;
+    nowSec?: number;
+    env?: Record<string, string | undefined>;
+}): SignedCommandAuthorizationProof;
+export declare function commandAuthProofKeyFingerprint(key: CommandAuthSigningKey): string;

package/dist/chat/command-auth-proof.js

@@ -0,0 +1 @@
+import{createHash as c,createPrivateKey as d,createPublicKey as l,randomBytes as p,sign as m,verify as h}from"node:crypto";function f(e){return JSON.stringify(u(e))}function u(e){if(Array.isArray(e))return e.map(u);if(e&&typeof e=="object"){let r={};for(let n of Object.keys(e).sort())r[n]=u(e[n]);return r}return e}function o(e){if(!e)return null;let r=e.trim();if(!r)return null;if(/^[0-9a-fA-F]{64}$/.test(r))return new Uint8Array(r.match(/.{2}/g).map(n=>parseInt(n,16)));try{let n=Buffer.from(r,"base64");if(n.length===32)return new Uint8Array(n)}catch{}return null}var b=120,A=Buffer.from("302a300506032b6570032100","hex"),g=Buffer.from("302e020100300506032b657004220420","hex"),I="c0021e9312b0a479dbd2eb8dec0deedbe0dd6445eff431e372fa49fa21d42ffa",P={"ca-6297fb8e1773":"16ae5cb2a61f8c94cf1b86e8258f9c2f2ff6aba5e6136250a422209b6e866881"};function y(e){return`ca-${c("sha256").update(Buffer.from(e)).digest("hex").slice(0,12)}`}function K(e,r=process.env){let n=o(r.KYNVER_COMMAND_AUTH_PUBLIC_KEY);if(n)return y(n)!==e?null:n;if(r.NODE_ENV==="production")return null;let t=P[e];return t?o(t):null}function B(e){return l({key:Buffer.concat([A,Buffer.from(e)]),format:"der",type:"spki"})}function x(e,r){return!Array.isArray(e)||e.length!==r.length?!1:e.every((n,t)=>typeof n=="string"&&n===r[t])}function C(e){if(!e||typeof e!="object")return!1;let r=e;if(typeof r.signature!="string"||!r.signature||typeof r.publicKeyId!="string"||!r.publicKeyId)return!1;let n=r.payload;return!(!n||typeof n!="object"||n.v!==1||typeof n.agentOsId!="string"||!n.agentOsId||!Array.isArray(n.argv)||n.argv.some(t=>typeof t!="string")||typeof n.userId!="string"||!n.userId||typeof n.exp!="number"||!Number.isFinite(n.exp)||typeof n.nonce!="string"||!n.nonce)}function O(e,r,n=process.env,t=Math.floor(Date.now()/1e3)){if(!C(e))return{ok:!1,reason:"malformed command authorization proof"};if(e.payload.agentOsId!==r.agentOsId)return{ok:!1,reason:"agentOsId mismatch"};if(!x(e.payload.argv,r.argv))return{ok:!1,reason:"argv mismatch"};if(e.payload.exp<=t)return{ok:!1,reason:"proof expired"};let i=K(e.publicKeyId,n);if(!i)return{ok:!1,reason:`no verification key for publicKeyId "${e.publicKeyId}"`};let a;try{a=Buffer.from(e.signature,"base64url")}catch{return{ok:!1,reason:"signature is not base64url"}}if(a.length!==64)return{ok:!1,reason:"signature is not a 64-byte Ed25519 signature"};try{let s=Buffer.from(f(e.payload),"utf8");return h(null,s,B(i),a)?{ok:!0,payload:e.payload}:{ok:!1,reason:"Ed25519 signature mismatch"}}catch(s){return{ok:!1,reason:`signature verification failed: ${s.message}`}}}function k(e){let r=d({key:Buffer.concat([g,Buffer.from(e)]),format:"der",type:"pkcs8"}),n=l(r).export({format:"der",type:"spki"});return new Uint8Array(n.subarray(n.length-32))}function v(e=process.env){let r=o(e.KYNVER_COMMAND_AUTH_KEY);if(!r&&e.NODE_ENV==="production")throw new Error("KYNVER_COMMAND_AUTH_KEY must be set in production; refusing to sign command proofs with the committed dev key.");let n=r??o(I),t=k(n);return{seed:n,rawPublicKey:t,publicKeyId:y(t),usingDevFallbackKey:!r}}function S(e,r){let n=d({key:Buffer.concat([g,Buffer.from(r.seed)]),format:"der",type:"pkcs8"}),t=Buffer.from(f(e),"utf8");return{payload:e,signature:m(null,t,n).toString("base64url"),publicKeyId:r.publicKeyId}}function U(e){let r=e.env??process.env,n=e.nowSec??Math.floor(Date.now()/1e3),t=e.ttlSec??b,i={v:1,agentOsId:e.agentOsId,argv:[...e.argv],userId:e.userId,exp:n+t,nonce:p(16).toString("base64url")};return S(i,v(r))}function D(e){return c("sha256").update(Buffer.from(e.rawPublicKey)).digest("hex").slice(0,16)}export{b as COMMAND_AUTH_PROOF_TTL_SEC,P as PINNED_COMMAND_AUTH_PUBLIC_KEYS,x as argvMatchesProof,D as commandAuthProofKeyFingerprint,y as deriveCommandAuthKeyId,C as isSignedCommandAuthProofShape,U as issueCommandAuthorizationProof,K as resolveCommandAuthPublicKey,v as resolveCommandAuthSigningKey,O as verifyCommandAuthorizationProof};

package/dist/chat/command-executor.d.ts

@@ -1,8 +1,10 @@
+import { type SignedCommandAuthorizationProof } from "./command-auth-proof.js";
 export interface CommandTurnResult {
     exitCode: number | null;
     timedOut: boolean;
     refused?: string;
 }
+export declare function verifyCommandTurnAuthorization(agentOsId: string, argv: readonly string[], authProof: unknown, env?: Record<string, string | undefined>): string | null;
 /**
  * Execute one command turn. `pushDelta` receives batched output text;
  * resolves with the terminal result (never throws).
@@ -10,4 +12,7 @@ export interface CommandTurnResult {
 export declare function executeLocalCommand(argv: string[], pushDelta: (text: string) => void, opts?: {
     cliEntry?: string;
     timeoutMs?: number;
+    agentOsId?: string;
+    authProof?: SignedCommandAuthorizationProof | unknown;
+    env?: Record<string, string | undefined>;
 }): Promise<CommandTurnResult>;