@skrr-ai/cli 0.1.94 → 0.1.95

package/dist/node_modules/@skrr-ai/auth-core/dist/esm/harnessPermissionControls.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Read-only capability wire for ordinary agent turns. This is NOT a session
+ * authorization request or an effective permission profile. In particular,
+ * an ACP approval callback is not a process sandbox, and access to a loopback
+ * inference broker is not a grant to make arbitrary outbound connections.
+ *
+ * Daemons advertise what their adapters implement; execution still validates
+ * the requested policy independently. Consumers never infer controls from a
+ * provider name, a missing report, or the unified permission-mode vocabulary.
+ */
+export interface HarnessPermissionControls {
+    version: 1;
+    plan: 'harness' | 'reported-actions' | 'unsupported' | 'unknown';
+    approval: 'harness' | 'reported-actions' | 'none' | 'unknown';
+    filesystem: 'harness-sandbox' | 'tool-path-guards' | 'reported-actions' | 'not-restricted-by-daemon' | 'unknown';
+    strictToolPolicy: {
+        modes: readonly ('none' | 'allowlist')[];
+        enforcement: 'harness' | 'negotiated' | 'unsupported' | 'unknown';
+    };
+    organizationToolDenylist: 'unsupported' | 'unknown';
+    networkEgress: 'not-restricted-by-daemon' | 'unknown';
+}
+export interface HarnessPermissionControlReport {
+    controls: HarnessPermissionControls | null;
+    source: 'daemon' | 'daemon_record' | 'unreported';
+}
+/**
+ * Presence/registration metadata is untrusted input. Copy only the v1 enum
+ * vocabulary: unknown future claims and malformed profiles yield no report,
+ * rather than a green badge. Additive fields are stripped for compatibility.
+ */
+export declare function parseHarnessPermissionControls(value: unknown): HarnessPermissionControls | null;

package/dist/node_modules/@skrr-ai/auth-core/dist/esm/harnessPermissionControls.js

@@ -0,0 +1,59 @@
+const PLAN = ['harness', 'reported-actions', 'unsupported', 'unknown'];
+const APPROVAL = ['harness', 'reported-actions', 'none', 'unknown'];
+const FILESYSTEM = [
+    'harness-sandbox',
+    'tool-path-guards',
+    'reported-actions',
+    'not-restricted-by-daemon',
+    'unknown',
+];
+const TOOL_ENFORCEMENT = ['harness', 'negotiated', 'unsupported', 'unknown'];
+/**
+ * Presence/registration metadata is untrusted input. Copy only the v1 enum
+ * vocabulary: unknown future claims and malformed profiles yield no report,
+ * rather than a green badge. Additive fields are stripped for compatibility.
+ */
+export function parseHarnessPermissionControls(value) {
+    try {
+        if (!value || typeof value !== 'object' || Array.isArray(value))
+            return null;
+        const row = value;
+        const { version, plan, approval, filesystem, organizationToolDenylist, networkEgress, strictToolPolicy, } = row;
+        const strict = strictToolPolicy;
+        if (!strict || typeof strict !== 'object' || Array.isArray(strict))
+            return null;
+        const strictModes = strict.modes;
+        const enforcement = strict.enforcement;
+        if (version !== 1 ||
+            !PLAN.includes(plan) ||
+            !APPROVAL.includes(approval) ||
+            !FILESYSTEM.includes(filesystem) ||
+            !['unsupported', 'unknown'].includes(organizationToolDenylist) ||
+            !['not-restricted-by-daemon', 'unknown'].includes(networkEgress) ||
+            !TOOL_ENFORCEMENT.includes(enforcement) ||
+            !Array.isArray(strictModes) ||
+            strictModes.length > 2 ||
+            !strictModes.every((mode) => mode === 'none' || mode === 'allowlist'))
+            return null;
+        const modes = [...new Set(strictModes)];
+        if (((enforcement === 'unsupported' || enforcement === 'unknown') && modes.length > 0) ||
+            ((enforcement === 'harness' || enforcement === 'negotiated') && modes.length === 0))
+            return null;
+        return Object.freeze({
+            version: 1,
+            plan: plan,
+            approval: approval,
+            filesystem: filesystem,
+            strictToolPolicy: Object.freeze({
+                modes: Object.freeze(modes),
+                enforcement: enforcement,
+            }),
+            organizationToolDenylist: organizationToolDenylist,
+            networkEgress: networkEgress,
+        });
+    }
+    catch {
+        // Malicious accessors/proxies must not break a read surface.
+        return null;
+    }
+}

package/dist/node_modules/@skrr-ai/auth-core/dist/esm/index.d.ts

@@ -46,3 +46,5 @@ export { OVERSKY_RELEASE_PUBLIC_KEYS, type ReleaseKey } from './releaseKeys.js';
 export { MAX_SIGS, TRUSTED_FEED_ORIGINS, buildArtifactMessage, buildManifestMessage, getDeltaFor, isTrustedArtifactOrigin, verifyArtifact, verifyManifest, type DaemonVersionManifest, type DeltaDescriptor, type ManifestSignature, type PlatformArtifact, type VerifyResult, } from './releaseManifest.js';
 export { resolveConfigRoot, configRootPath, isConfigRootOverridden } from './configRoot.js';
 export { PROFILES_SEGMENT, SUPERSEDED_MARKER_SUFFIX, SUPERSEDED_COPY_SUFFIX, profileStateDir, legacyProfileStateDir, resolveProfileStateDir, resolveProfileStateFile, profileStateFileLocations, profileStateFilePathsToClear, consolidateProfileState, type ResolvedProfileStateDir, type ConsolidationSpec, type ConsolidationStatus, type ConsolidationOutcome, } from './profileStateDir.js';
+export * from './harnessPermissionControls.js';
+export { compareReleaseVersions } from './releaseVersions.js';

package/dist/node_modules/@skrr-ai/auth-core/dist/esm/index.js

@@ -182,3 +182,5 @@ export { resolveConfigRoot, configRootPath, isConfigRootOverridden } from './con
 // the migration for a machine that ended up with two. Same lesson, one level
 // down: two modules spelled the rule themselves and the two consumers disagreed.
 export { PROFILES_SEGMENT, SUPERSEDED_MARKER_SUFFIX, SUPERSEDED_COPY_SUFFIX, profileStateDir, legacyProfileStateDir, resolveProfileStateDir, resolveProfileStateFile, profileStateFileLocations, profileStateFilePathsToClear, consolidateProfileState, } from './profileStateDir.js';
+export * from './harnessPermissionControls.js';
+export { compareReleaseVersions } from './releaseVersions.js';

package/dist/node_modules/@skrr-ai/auth-core/dist/esm/machineUuid.js

@@ -198,11 +198,14 @@ export function setMachineUuidProfile(profile) {
 export function getMachineUuidProfile() {
     return activeMachineProfile;
 }
-function readPersistedChoice(file, hardware, profile) {
+function readPersistedChoice(file, hardware, profile, requireProfile = false) {
     try {
         const parsed = JSON.parse(fs.readFileSync(file, 'utf-8'));
         // A file from another machine (a restored backup, a synced home) is absent.
-        if (parsed?.version !== 1 || parsed.hardware !== hardware)
+        if (parsed?.version !== 1 ||
+            parsed.hardware !== hardware ||
+            (parsed.profile !== undefined && parsed.profile !== profile) ||
+            (requireProfile && parsed.profile !== profile))
             return null;
         // Only the two values this module can produce are accepted: a hand-edited or
         // foreign string must never become an identity.
@@ -215,11 +218,18 @@ function readPersistedChoice(file, hardware, profile) {
         return null;
     }
 }
-function persistChoice(dir, file, hardware, machineUuid, reason) {
+function persistChoice(dir, file, hardware, machineUuid, reason, profile) {
     try {
         fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
         const tmp = `${file}.${process.pid}.${Date.now()}.tmp`;
-        const body = { version: 1, hardware, machineUuid, reason, decidedAt: new Date().toISOString() };
+        const body = {
+            version: 1,
+            hardware,
+            machineUuid,
+            profile,
+            reason,
+            decidedAt: new Date().toISOString(),
+        };
         fs.writeFileSync(tmp, `${JSON.stringify(body)}\n`, { mode: 0o600 });
         fs.renameSync(tmp, file);
     }
@@ -228,6 +238,20 @@ function persistChoice(dir, file, hardware, machineUuid, reason) {
         // next process decides again from the same evidence.
     }
 }
+/** A nonsecret recovery copy survives product uninstall. Each profile has its
+ * own file, so concurrent profiles never overwrite a shared identity map. A
+ * copied home cannot adopt another machine's value: the hardware is verified
+ * and only this module's hardware/qualified values are admitted. */
+function recoveryChoicePath(profile) {
+    const name = crypto.createHash('sha256').update(profile).digest('hex');
+    return path.join(os.homedir(), '.local', 'state', 'skrr', 'machine-identities', `${name}.json`);
+}
+function preserveRecoveryChoice(profile, hardware, machineUuid) {
+    const file = recoveryChoicePath(profile);
+    if (readPersistedChoice(file, hardware, profile, true) === machineUuid)
+        return;
+    persistChoice(path.dirname(file), file, hardware, machineUuid, 'restored_profile', profile);
+}
 /** The identity a NON-default profile registers under. Never throws. */
 function resolveProfileMachineUuid(profile, hardware) {
     const cacheKey = `${hardware}\u0000${profile}`;
@@ -237,6 +261,11 @@ function resolveProfileMachineUuid(profile, hardware) {
     const dir = path.join(resolveConfigRoot(), 'profiles', profile);
     const file = path.join(dir, MACHINE_IDENTITY_FILENAME);
     let chosen = readPersistedChoice(file, hardware, profile);
+    if (!chosen) {
+        chosen = readPersistedChoice(recoveryChoicePath(profile), hardware, profile, true);
+        if (chosen)
+            persistChoice(dir, file, hardware, chosen, 'restored_profile', profile);
+    }
     if (!chosen) {
         const preExisting = PRE_EXISTING_PROFILE_EVIDENCE.some((name) => {
             try {
@@ -247,8 +276,9 @@ function resolveProfileMachineUuid(profile, hardware) {
             }
         });
         chosen = preExisting ? hardware : qualifyMachineUuid(hardware, profile);
-        persistChoice(dir, file, hardware, chosen, preExisting ? 'pre_existing_profile' : 'new_profile');
+        persistChoice(dir, file, hardware, chosen, preExisting ? 'pre_existing_profile' : 'new_profile', profile);
     }
+    preserveRecoveryChoice(profile, hardware, chosen);
     profileChoiceCache.set(cacheKey, chosen);
     return chosen;
 }

package/dist/node_modules/@skrr-ai/auth-core/dist/esm/releasePolicy.d.ts

@@ -0,0 +1,63 @@
+import { type ReleaseKey } from './releaseKeys.js';
+export type ReleaseChannel = 'stable' | 'canary' | 'beta' | 'internal';
+export interface ContractRange {
+    minimum: number;
+    maximum: number;
+}
+export interface ComponentReleasePolicy {
+    version: string;
+    minimumVersion?: string;
+    contracts?: Record<string, ContractRange>;
+}
+export interface ReleasePolicySignature {
+    keyId: string;
+    sig: string;
+}
+export interface SignedReleasePolicy {
+    schemaVersion: 1;
+    releaseId: string;
+    issuedAt: string;
+    expiresAt: string;
+    channel: ReleaseChannel;
+    /** Percentage in basis points (0–10000), avoiding floating-point policy. */
+    rolloutBasisPoints: number;
+    cohortSeed: string;
+    components: Record<string, ComponentReleasePolicy>;
+    keyId: string;
+    sig: string;
+    sigs?: ReleasePolicySignature[];
+}
+export type PolicyVerifyResult = {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+} | {
+    disabled: true;
+};
+export interface ReleasePolicyAssessment {
+    valid: boolean;
+    eligible: boolean;
+    reason?: string;
+}
+/** Canonical, versioned signature message. Never sign JSON.stringify directly. */
+export declare function buildReleasePolicyMessage(policy: Omit<SignedReleasePolicy, 'sig' | 'sigs'>): string;
+export declare function verifyReleasePolicy(policy: SignedReleasePolicy, keys?: readonly ReleaseKey[]): PolicyVerifyResult;
+export declare function isReleasePolicyCohortEligible(policy: SignedReleasePolicy, subject: string): boolean;
+/**
+ * Verify expiry, daemon target binding, contract ranges, channel, and cohort.
+ * `autonomous=false` intentionally bypasses cohort gating: an operator who
+ * explicitly runs an update may recover a machine outside the staged cohort,
+ * but cannot bypass invalid signatures, an expired policy, or incompatibility.
+ */
+export declare function assessReleasePolicy(args: {
+    policy: SignedReleasePolicy;
+    targetDaemonVersion: string;
+    /** Defaults to daemon for backwards-compatible daemon policy assessment. */
+    targetComponent?: string;
+    channel: ReleaseChannel;
+    contracts: Record<string, number>;
+    cohortSubject: string;
+    autonomous: boolean;
+    now?: Date;
+}): ReleasePolicyAssessment;

package/dist/node_modules/@skrr-ai/auth-core/dist/esm/releasePolicy.js

@@ -0,0 +1,163 @@
+/**
+ * Signed multi-component release policy.
+ *
+ * The daemon artifact manifest authenticates a daemon binary. This envelope
+ * authenticates the *decision* to offer that binary to a cohort, and records
+ * the component contract that makes a CLI/daemon/desktop combination safe.
+ * It is separately signed so it can be added to a v1 artifact manifest without
+ * changing the legacy manifest signature bytes or blocking old daemons.
+ */
+import { createHash, createPublicKey, verify as verifyEd25519 } from 'node:crypto';
+import { OVERSKY_RELEASE_PUBLIC_KEYS } from './releaseKeys.js';
+const MAX_SIGS = 8;
+function stableJson(value) {
+    if (value === null ||
+        typeof value === 'boolean' ||
+        typeof value === 'number' ||
+        typeof value === 'string') {
+        return JSON.stringify(value);
+    }
+    if (Array.isArray(value))
+        return `[${value.map(stableJson).join(',')}]`;
+    if (!value || typeof value !== 'object')
+        throw new Error('policy contains an unsupported value');
+    const record = value;
+    return `{${Object.keys(record)
+        .sort()
+        .map((key) => `${JSON.stringify(key)}:${stableJson(record[key])}`)
+        .join(',')}}`;
+}
+/** Canonical, versioned signature message. Never sign JSON.stringify directly. */
+export function buildReleasePolicyMessage(policy) {
+    return ['oversky-release-policy', 'v1', stableJson(policy)].join('\n');
+}
+function verifyOne(message, signature, keys) {
+    if (keys.length === 0)
+        return { disabled: true };
+    if (!signature)
+        return { ok: false, reason: 'missing signature' };
+    const messageBytes = Buffer.from(message, 'utf8');
+    const signatureBytes = Buffer.from(signature, 'base64');
+    for (const keySpec of keys) {
+        try {
+            const key = createPublicKey({
+                key: Buffer.from(keySpec.publicKeySpkiB64, 'base64'),
+                format: 'der',
+                type: 'spki',
+            });
+            if (verifyEd25519(null, messageBytes, key, signatureBytes))
+                return { ok: true };
+        }
+        catch {
+            /* malformed signatures and keys are a verification failure */
+        }
+    }
+    return { ok: false, reason: 'signature did not verify against any pinned key' };
+}
+function policyShapeIsValid(policy) {
+    if (!policy ||
+        typeof policy !== 'object' ||
+        policy.schemaVersion !== 1 ||
+        !/^[0-9A-Za-z._:-]+$/.test(policy.releaseId) ||
+        !['stable', 'canary', 'beta', 'internal'].includes(policy.channel) ||
+        !Number.isInteger(policy.rolloutBasisPoints) ||
+        policy.rolloutBasisPoints < 0 ||
+        policy.rolloutBasisPoints > 10_000 ||
+        typeof policy.cohortSeed !== 'string' ||
+        policy.cohortSeed.length < 8 ||
+        !policy.components ||
+        typeof policy.components !== 'object' ||
+        Array.isArray(policy.components)) {
+        return false;
+    }
+    const issued = Date.parse(policy.issuedAt);
+    const expires = Date.parse(policy.expiresAt);
+    if (!Number.isFinite(issued) || !Number.isFinite(expires) || expires <= issued)
+        return false;
+    return Object.values(policy.components).every((component) => component &&
+        typeof component === 'object' &&
+        !Array.isArray(component) &&
+        (!component.contracts ||
+            (typeof component.contracts === 'object' && !Array.isArray(component.contracts))) &&
+        typeof component.version === 'string' &&
+        component.version.length > 0 &&
+        Object.values(component.contracts ?? {}).every((range) => range &&
+            typeof range === 'object' &&
+            !Array.isArray(range) &&
+            Number.isInteger(range.minimum) &&
+            Number.isInteger(range.maximum) &&
+            range.minimum >= 0 &&
+            range.maximum >= range.minimum));
+}
+export function verifyReleasePolicy(policy, keys = OVERSKY_RELEASE_PUBLIC_KEYS) {
+    if (!policyShapeIsValid(policy))
+        return { ok: false, reason: 'invalid release-policy shape' };
+    const { sig, sigs, ...unsigned } = policy;
+    const message = buildReleasePolicyMessage(unsigned);
+    if (Array.isArray(sigs) && sigs.length > 0) {
+        if (keys.length === 0)
+            return { disabled: true };
+        for (const entry of sigs.slice(0, MAX_SIGS)) {
+            if (!entry || typeof entry.sig !== 'string')
+                continue;
+            const verdict = verifyOne(message, entry.sig, keys);
+            if ('ok' in verdict && verdict.ok)
+                return verdict;
+        }
+        return { ok: false, reason: 'no policy multi-signature verified against a pinned key' };
+    }
+    return verifyOne(message, sig, keys);
+}
+export function isReleasePolicyCohortEligible(policy, subject) {
+    if (!subject || policy.rolloutBasisPoints === 0)
+        return false;
+    if (policy.rolloutBasisPoints === 10_000)
+        return true;
+    const bucket = createHash('sha256')
+        .update(`${policy.releaseId}\n${policy.cohortSeed}\n${subject}`, 'utf8')
+        .digest()
+        .readUInt32BE(0) % 10_000;
+    return bucket < policy.rolloutBasisPoints;
+}
+/**
+ * Verify expiry, daemon target binding, contract ranges, channel, and cohort.
+ * `autonomous=false` intentionally bypasses cohort gating: an operator who
+ * explicitly runs an update may recover a machine outside the staged cohort,
+ * but cannot bypass invalid signatures, an expired policy, or incompatibility.
+ */
+export function assessReleasePolicy(args) {
+    const now = args.now ?? new Date();
+    if (Date.parse(args.policy.expiresAt) <= now.getTime()) {
+        return { valid: false, eligible: false, reason: `policy expired at ${args.policy.expiresAt}` };
+    }
+    if (args.policy.channel !== args.channel) {
+        return {
+            valid: false,
+            eligible: false,
+            reason: `policy channel ${args.policy.channel} does not match ${args.channel}`,
+        };
+    }
+    const componentName = args.targetComponent ?? 'daemon';
+    const daemon = args.policy.components[componentName];
+    if (!daemon || daemon.version !== args.targetDaemonVersion) {
+        return {
+            valid: false,
+            eligible: false,
+            reason: `policy ${componentName} component does not bind the target artifact version`,
+        };
+    }
+    for (const [name, range] of Object.entries(daemon.contracts ?? {})) {
+        const actual = args.contracts[name];
+        if (!Number.isInteger(actual) || actual < range.minimum || actual > range.maximum) {
+            return {
+                valid: false,
+                eligible: false,
+                reason: `local contract ${name}=${String(actual)} is outside policy range ${range.minimum}..${range.maximum}`,
+            };
+        }
+    }
+    const eligible = !args.autonomous || isReleasePolicyCohortEligible(args.policy, args.cohortSubject);
+    return eligible
+        ? { valid: true, eligible: true }
+        : { valid: true, eligible: false, reason: 'machine is outside rollout cohort' };
+}

package/dist/node_modules/@skrr-ai/auth-core/dist/esm/releaseVersions.d.ts

@@ -0,0 +1,2 @@
+/** SemVer precedence shared by every local release consumer. Invalid inputs are never ordered. */
+export declare function compareReleaseVersions(a: string, b: string): -1 | 0 | 1 | null;

package/dist/node_modules/@skrr-ai/auth-core/dist/esm/releaseVersions.js

@@ -0,0 +1,41 @@
+/** SemVer precedence shared by every local release consumer. Invalid inputs are never ordered. */
+export function compareReleaseVersions(a, b) {
+    const parse = (value) => {
+        if (typeof value !== 'string')
+            return null;
+        const match = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/.exec(value.trim());
+        if (!match)
+            return null;
+        const prerelease = match[4]?.split('.') ?? [];
+        if (prerelease.some((part) => /^\d+$/.test(part) && part.length > 1 && part[0] === '0'))
+            return null;
+        return { core: match.slice(1, 4).map(BigInt), prerelease };
+    };
+    const left = parse(a);
+    const right = parse(b);
+    if (!left || !right)
+        return null;
+    for (let i = 0; i < 3; i++) {
+        if (left.core[i] !== right.core[i])
+            return left.core[i] < right.core[i] ? -1 : 1;
+    }
+    if (!left.prerelease.length || !right.prerelease.length) {
+        return left.prerelease.length === right.prerelease.length ? 0 : left.prerelease.length ? -1 : 1;
+    }
+    for (let i = 0; i < Math.max(left.prerelease.length, right.prerelease.length); i++) {
+        const l = left.prerelease[i];
+        const r = right.prerelease[i];
+        if (l === undefined || r === undefined)
+            return l === r ? 0 : l === undefined ? -1 : 1;
+        if (l === r)
+            continue;
+        const ln = /^\d+$/.test(l);
+        const rn = /^\d+$/.test(r);
+        if (ln && rn)
+            return BigInt(l) < BigInt(r) ? -1 : 1;
+        if (ln !== rn)
+            return ln ? -1 : 1;
+        return l < r ? -1 : 1;
+    }
+    return 0;
+}

package/dist/node_modules/@skrr-ai/auth-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skrr-ai/auth-core",
-  "version": "0.4.18",
+  "version": "0.4.20",
   "main": "dist/cjs/index.js",
   "types": "dist/esm/index.d.ts",
   "exports": {
@@ -143,6 +143,36 @@
         "types": "./dist/cjs/commitmentExecutionContract.d.ts",
         "default": "./dist/cjs/commitmentExecutionContract.js"
       }
+    },
+    "./harness-permission-controls": {
+      "import": {
+        "types": "./dist/esm/harnessPermissionControls.d.ts",
+        "default": "./dist/esm/harnessPermissionControls.js"
+      },
+      "require": {
+        "types": "./dist/cjs/harnessPermissionControls.d.ts",
+        "default": "./dist/cjs/harnessPermissionControls.js"
+      }
+    },
+    "./first-party-harness-updater": {
+      "import": {
+        "types": "./dist/esm/firstPartyHarnessUpdater.d.ts",
+        "default": "./dist/esm/firstPartyHarnessUpdater.js"
+      },
+      "require": {
+        "types": "./dist/cjs/firstPartyHarnessUpdater.d.ts",
+        "default": "./dist/cjs/firstPartyHarnessUpdater.js"
+      }
+    },
+    "./release-policy": {
+      "import": {
+        "types": "./dist/esm/releasePolicy.d.ts",
+        "default": "./dist/esm/releasePolicy.js"
+      },
+      "require": {
+        "types": "./dist/cjs/releasePolicy.d.ts",
+        "default": "./dist/cjs/releasePolicy.js"
+      }
     }
   },
   "dependencies": {