@nextclaw/kernel 0.1.1 → 0.1.2-beta.0

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { a as getUnsignedUpdateManifest, c as UpdateBlockReason, d as UpdateSnapshot, f as UpdateStatus, i as UpdateManifestReader, l as UpdatePreferences, n as UpdateHostKind, o as serializeUnsignedUpdateManifest, r as UpdateManifest, s as InstallationKind, t as UnsignedUpdateManifest, u as UpdateProgress } from "./update-manifest.types-BAJqcsP5.js";
 import { NcpMessage } from "@nextclaw/ncp";
 
 //#region src/types/entity-ids.types.d.ts
@@ -283,4 +284,4 @@ declare class NextclawKernel<TGatewayInput = unknown, TUiInput = unknown, TStart
   readonly run: (input: NextclawKernelRunInput) => NextclawKernelRun;
 }
 //#endregion
-export { AgentId, AgentManager, AgentRecord, AutomationId, AutomationManager, AutomationRecord, AutomationTrigger, ChannelDirection, ChannelId, ChannelManager, ChannelRecord, ContextBuilder, ContextRecord, LlmProviderId, LlmProviderManager, LlmProviderRecord, NextclawKernel, NextclawKernelRun, NextclawKernelRunInput, NextclawKernelRunMetadata, SessionId, SessionManager, SessionMessage, SessionRecord, SkillId, SkillManager, SkillRecord, TaskId, TaskManager, TaskRecord, TaskStatus, ToolId, ToolManager, ToolRecord };
+export { AgentId, AgentManager, AgentRecord, AutomationId, AutomationManager, AutomationRecord, AutomationTrigger, ChannelDirection, ChannelId, ChannelManager, ChannelRecord, ContextBuilder, ContextRecord, InstallationKind, LlmProviderId, LlmProviderManager, LlmProviderRecord, NextclawKernel, NextclawKernelRun, NextclawKernelRunInput, NextclawKernelRunMetadata, SessionId, SessionManager, SessionMessage, SessionRecord, SkillId, SkillManager, SkillRecord, TaskId, TaskManager, TaskRecord, TaskStatus, ToolId, ToolManager, ToolRecord, UnsignedUpdateManifest, UpdateBlockReason, UpdateHostKind, UpdateManifest, UpdateManifestReader, UpdatePreferences, UpdateProgress, UpdateSnapshot, UpdateStatus, getUnsignedUpdateManifest, serializeUnsignedUpdateManifest };

package/dist/index.js

@@ -1,3 +1,4 @@
+import { n as getUnsignedUpdateManifest, r as serializeUnsignedUpdateManifest, t as UpdateManifestReader } from "./update-manifest.types-C0qPrjGQ.js";
 //#region src/managers/agent.manager.ts
 var AgentManager = class {
 	listAgents = () => {
@@ -248,4 +249,4 @@ var NextclawKernel = class {
 	};
 };
 //#endregion
-export { AgentManager, AutomationManager, ChannelManager, ContextBuilder, LlmProviderManager, NextclawKernel, SessionManager, SkillManager, TaskManager, ToolManager };
+export { AgentManager, AutomationManager, ChannelManager, ContextBuilder, LlmProviderManager, NextclawKernel, SessionManager, SkillManager, TaskManager, ToolManager, UpdateManifestReader, getUnsignedUpdateManifest, serializeUnsignedUpdateManifest };

package/dist/types/update-contract.types.d.ts

@@ -0,0 +1,2 @@
+import { a as getUnsignedUpdateManifest, c as UpdateBlockReason, d as UpdateSnapshot, f as UpdateStatus, i as UpdateManifestReader, l as UpdatePreferences, n as UpdateHostKind, o as serializeUnsignedUpdateManifest, r as UpdateManifest, s as InstallationKind, t as UnsignedUpdateManifest, u as UpdateProgress } from "../update-manifest.types-BAJqcsP5.js";
+export { InstallationKind, UnsignedUpdateManifest, UpdateBlockReason, UpdateHostKind, UpdateManifest, UpdateManifestReader, UpdatePreferences, UpdateProgress, UpdateSnapshot, UpdateStatus, getUnsignedUpdateManifest, serializeUnsignedUpdateManifest };

package/dist/types/update-contract.types.js

@@ -0,0 +1,2 @@
+import { n as getUnsignedUpdateManifest, r as serializeUnsignedUpdateManifest, t as UpdateManifestReader } from "../update-manifest.types-C0qPrjGQ.js";
+export { UpdateManifestReader, getUnsignedUpdateManifest, serializeUnsignedUpdateManifest };

package/dist/update-manifest.types-BAJqcsP5.d.ts

@@ -0,0 +1,59 @@
+//#region src/types/update.types.d.ts
+type UpdateStatus = "idle" | "checking" | "update-available" | "downloading" | "downloaded" | "applying" | "restart-required" | "up-to-date" | "blocked" | "failed";
+type InstallationKind = "desktop-bundle" | "npm-runtime-bundle" | "npm-global" | "unknown";
+type UpdateBlockReason = "host-too-old" | "unsupported-installation" | "signature-verification-unavailable";
+type UpdateProgress = {
+  downloadedBytes: number;
+  totalBytes: number | null;
+  percent: number | null;
+};
+type UpdatePreferences = {
+  automaticChecks: boolean;
+  autoDownload: boolean;
+};
+type UpdateSnapshot = {
+  status: UpdateStatus;
+  installationKind: InstallationKind;
+  channel: "stable" | "beta";
+  hostVersion: string | null;
+  currentVersion: string | null;
+  availableVersion: string | null;
+  downloadedVersion: string | null;
+  minimumHostVersion: string | null;
+  releaseNotesUrl: string | null;
+  lastCheckedAt: string | null;
+  progress: UpdateProgress | null;
+  canAutoDownload: boolean;
+  canApplyInApp: boolean;
+  requiresRestart: boolean;
+  blockReason: UpdateBlockReason | null;
+  recoveryCommand: string | null;
+  errorMessage: string | null;
+  preferences: UpdatePreferences;
+};
+//#endregion
+//#region src/types/update-manifest.types.d.ts
+type UpdateHostKind = "desktop-bundle" | "npm-runtime-bundle";
+type UnsignedUpdateManifest = {
+  channel: string;
+  platform: string;
+  arch: string;
+  hostKind?: UpdateHostKind;
+  latestVersion: string;
+  minimumLauncherVersion: string;
+  bundleUrl: string;
+  bundleSha256: string;
+  bundleSignature: string;
+  releaseNotesUrl: string | null;
+};
+type UpdateManifest = UnsignedUpdateManifest & {
+  manifestSignature: string;
+};
+declare function getUnsignedUpdateManifest(manifest: UpdateManifest | UnsignedUpdateManifest): UnsignedUpdateManifest;
+declare function serializeUnsignedUpdateManifest(manifest: UpdateManifest | UnsignedUpdateManifest): string;
+declare class UpdateManifestReader {
+  parse: (input: unknown, context?: string) => UpdateManifest;
+  private readHostKind;
+}
+//#endregion
+export { getUnsignedUpdateManifest as a, UpdateBlockReason as c, UpdateSnapshot as d, UpdateStatus as f, UpdateManifestReader as i, UpdatePreferences as l, UpdateHostKind as n, serializeUnsignedUpdateManifest as o, UpdateManifest as r, InstallationKind as s, UnsignedUpdateManifest as t, UpdateProgress as u };

package/dist/update-manifest.types-C0qPrjGQ.js

@@ -0,0 +1,50 @@
+//#region src/types/update-manifest.types.ts
+function readRequiredString(record, key, context) {
+	const value = record[key];
+	if (typeof value !== "string" || !value.trim()) throw new Error(`${context} missing required string field: ${key}`);
+	return value.trim();
+}
+function getUnsignedUpdateManifest(manifest) {
+	return {
+		channel: manifest.channel,
+		platform: manifest.platform,
+		arch: manifest.arch,
+		hostKind: manifest.hostKind,
+		latestVersion: manifest.latestVersion,
+		minimumLauncherVersion: manifest.minimumLauncherVersion,
+		bundleUrl: manifest.bundleUrl,
+		bundleSha256: manifest.bundleSha256,
+		bundleSignature: manifest.bundleSignature,
+		releaseNotesUrl: manifest.releaseNotesUrl
+	};
+}
+function serializeUnsignedUpdateManifest(manifest) {
+	return JSON.stringify(getUnsignedUpdateManifest(manifest));
+}
+var UpdateManifestReader = class {
+	parse = (input, context = "update manifest") => {
+		if (!input || typeof input !== "object" || Array.isArray(input)) throw new Error(`${context} must be an object`);
+		const record = input;
+		const hostKind = typeof record.hostKind === "string" && record.hostKind.trim() ? this.readHostKind(record.hostKind.trim(), context) : void 0;
+		const releaseNotesUrl = typeof record.releaseNotesUrl === "string" && record.releaseNotesUrl.trim() ? record.releaseNotesUrl.trim() : null;
+		return {
+			channel: readRequiredString(record, "channel", context),
+			platform: readRequiredString(record, "platform", context),
+			arch: readRequiredString(record, "arch", context),
+			hostKind,
+			latestVersion: readRequiredString(record, "latestVersion", context),
+			minimumLauncherVersion: readRequiredString(record, "minimumLauncherVersion", context),
+			bundleUrl: readRequiredString(record, "bundleUrl", context),
+			bundleSha256: readRequiredString(record, "bundleSha256", context).toLowerCase(),
+			bundleSignature: readRequiredString(record, "bundleSignature", context),
+			releaseNotesUrl,
+			manifestSignature: readRequiredString(record, "manifestSignature", context)
+		};
+	};
+	readHostKind = (value, context) => {
+		if (value === "desktop-bundle" || value === "npm-runtime-bundle") return value;
+		throw new Error(`${context} has unsupported hostKind: ${value}`);
+	};
+};
+//#endregion
+export { getUnsignedUpdateManifest as n, serializeUnsignedUpdateManifest as r, UpdateManifestReader as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/kernel",
-  "version": "0.1.1",
+  "version": "0.1.2-beta.0",
   "private": false,
   "description": "NextClaw product kernel skeleton for agents, tasks, sessions, context, tools, skills, providers, automation, and channels.",
   "type": "module",
@@ -9,6 +9,11 @@
       "development": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./update-contract": {
+      "development": "./src/types/update-contract.types.ts",
+      "types": "./dist/types/update-contract.types.d.ts",
+      "default": "./dist/types/update-contract.types.js"
     }
   },
   "files": [
@@ -23,7 +28,7 @@
     "typescript": "^5.6.3"
   },
   "scripts": {
-    "build": "tsdown src/index.ts --dts --clean --target es2022 --no-fixedExtension",
+    "build": "tsdown src/index.ts src/types/update-contract.types.ts --dts --clean --target es2022 --no-fixedExtension",
     "lint": "eslint .",
     "tsc": "tsc -p tsconfig.json"
   }