@ai-matrx/desktop-protocol 0.15.0 → 0.16.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.16.0 (protocol 1.5)
+
+- `coding.history.import_missing`: every Claude Code session on the device that AI Matrx lacks
+  (missing) or is behind on (changed after the last turn AI Matrx received), imported by Matrx 2's
+  `coding` Python service through the shared importer (matrx-local `packages/matrx-coding-history`).
+  Result: counts, up to 20 failures, and one honest `summary` line; `state` is `done`, `blocked`
+  (with a `CodingHistoryBlocked` reason) or `cancelled`. Progress: `coding.history.progress`.
+- The `coding` Python service (`ServiceName`): `coding.plan_missing` / `coding.import_next`, each a
+  bounded step carrying `CodingServiceCredentials` that the core fills from its own sign-in.
+
+Consumer action: none (new ops only; an older app answers UNKNOWN_OPERATION). Matrx 2 regenerates
+its Python contract (`node scripts/python-contract.mjs`).
+
 ## 0.15.0 (protocol 1.4)
 
 - Computer control: `system.open_url` / `system.open_path` / `system.notify`; `screen.list` /

package/dist/client.cjs

@@ -126,7 +126,7 @@ var import_zod2 = require("zod");
 // src/schema/primitives.ts
 var import_zod = require("zod");
 var PROTOCOL_MAJOR = 1;
-var PROTOCOL_MINOR = 4;
+var PROTOCOL_MINOR = 5;
 var PROTOCOL_VERSION = `${PROTOCOL_MAJOR}.${PROTOCOL_MINOR}`;
 var ProtocolVersion = import_zod.z.string().regex(/^[1-9][0-9]{0,2}\.[0-9]{1,3}$/);
 var RequestId = import_zod.z.string().min(1).max(64).regex(/^[A-Za-z0-9_-]+$/);
@@ -1211,23 +1211,98 @@ var ExecJobInfo = import_zod20.z.strictObject({
 var ExecJobListParams = import_zod20.z.strictObject({});
 var ExecJobListResult = import_zod20.z.strictObject({ jobs: import_zod20.z.array(ExecJobInfo).max(64) });
 
-// src/schema/apps.ts
+// src/schema/coding.ts
 var import_zod21 = require("zod");
-var AppKey = import_zod21.z.string().regex(/^[a-z][a-z0-9_-]{0,39}$/);
-var AppProfileId = import_zod21.z.string().regex(/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/);
-var AppProfileLocator = import_zod21.z.string().min(1).max(512).regex(/^[A-Za-z0-9 _()+@,-][A-Za-z0-9 ._()+@,-]{0,127}(\/[A-Za-z0-9 _()+@,-][A-Za-z0-9 ._()+@,-]{0,127}){0,7}$/);
-var AppSupport = import_zod21.z.enum(["supported", "partial", "unsupported"]);
-var AppFeatureStatus = import_zod21.z.strictObject({
+var CodingServiceCredentials = import_zod21.z.strictObject({
+  access_token: import_zod21.z.string().min(16).max(16384),
+  user_id: import_zod21.z.string().regex(/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/),
+  /** The AI Matrx server this app talks to (production, or a local server on the nightly copy). */
+  server_url: import_zod21.z.string().min(1).max(2048).regex(/^https?:\/\/[^\s/?#]+(\/[^\s?#]*)?$/)
+});
+var CodingHistoryBlocked = import_zod21.z.enum([
+  "signed_out",
+  "offline",
+  "organization_required",
+  "claude_unavailable",
+  "cloud_list_unavailable",
+  "history_too_large"
+]);
+var CodingHistoryFailure = import_zod21.z.strictObject({
+  session_id: import_zod21.z.string().max(64),
+  reason: import_zod21.z.string().max(300)
+});
+var CodingHistoryRun = import_zod21.z.strictObject({
+  /** Claude Code sessions found on this computer. */
+  local_sessions: nonNegInt,
+  /** Of those, already complete in AI Matrx. */
+  in_cloud: nonNegInt,
+  /** In AI Matrx under neither of its identities. */
+  missing: nonNegInt,
+  /** In AI Matrx, but changed here after the last turn AI Matrx received (turns the hook lost). */
+  behind: nonNegInt,
+  /** Over the importer's size cap; never imported. */
+  too_large: nonNegInt,
+  imported: nonNegInt,
+  /** Changed while being read; a later run takes them. */
+  changed: nonNegInt,
+  failed: nonNegInt,
+  failures: import_zod21.z.array(CodingHistoryFailure).max(20),
+  /** Candidates not reached yet. */
+  remaining: nonNegInt,
+  /** The one line a person reads, e.g. "Imported 12 of 14 sessions. 140 already in AI Matrx." */
+  summary: import_zod21.z.string().max(400)
+});
+var CodingHistoryStep = import_zod21.z.strictObject({
+  /** Null when the run could not start (blocked before a plan existed). */
+  plan_id: import_zod21.z.string().regex(/^[0-9a-f]{32}$/).nullable(),
+  finished: import_zod21.z.boolean(),
+  blocked: CodingHistoryBlocked.nullable(),
+  run: CodingHistoryRun
+});
+var CodingPlanMissingParams = import_zod21.z.strictObject({ credentials: CodingServiceCredentials });
+var CodingImportNextParams = import_zod21.z.strictObject({
+  plan_id: import_zod21.z.string().regex(/^[0-9a-f]{32}$/),
+  credentials: CodingServiceCredentials
+});
+var CodingServiceProgress = import_zod21.z.strictObject({
+  phase: import_zod21.z.enum(["checking", "importing"]),
+  done: nonNegInt,
+  total: nonNegInt
+});
+var CodingHistoryImportMissingParams = import_zod21.z.strictObject({});
+var CodingHistoryImportMissingResult = import_zod21.z.strictObject({
+  state: import_zod21.z.enum(["done", "blocked", "cancelled"]),
+  blocked: CodingHistoryBlocked.nullable(),
+  run: CodingHistoryRun,
+  elapsed_ms: nonNegInt
+});
+var CodingHistoryProgressEvent = import_zod21.z.strictObject({
+  request_id: RequestId,
+  phase: import_zod21.z.enum(["checking", "importing"]),
+  /** Sessions settled so far, of `total` candidates (0 of 0 while checking). */
+  done: nonNegInt,
+  total: nonNegInt,
+  imported: nonNegInt,
+  failed: nonNegInt
+});
+
+// src/schema/apps.ts
+var import_zod22 = require("zod");
+var AppKey = import_zod22.z.string().regex(/^[a-z][a-z0-9_-]{0,39}$/);
+var AppProfileId = import_zod22.z.string().regex(/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/);
+var AppProfileLocator = import_zod22.z.string().min(1).max(512).regex(/^[A-Za-z0-9 _()+@,-][A-Za-z0-9 ._()+@,-]{0,127}(\/[A-Za-z0-9 _()+@,-][A-Za-z0-9 ._()+@,-]{0,127}){0,7}$/);
+var AppSupport = import_zod22.z.enum(["supported", "partial", "unsupported"]);
+var AppFeatureStatus = import_zod22.z.strictObject({
   status: AppSupport,
   /** One line, set whenever status is not "supported". */
-  reason: import_zod21.z.string().max(140).nullable()
+  reason: import_zod22.z.string().max(140).nullable()
 });
-var AppInfo = import_zod21.z.strictObject({
+var AppInfo = import_zod22.z.strictObject({
   app_key: AppKey,
-  name: import_zod21.z.string().max(64),
-  installed: import_zod21.z.boolean(),
+  name: import_zod22.z.string().max(64),
+  installed: import_zod22.z.boolean(),
   /** The app's own version string, or null when it is not installed or does not say. */
-  version: import_zod21.z.string().max(64).nullable(),
+  version: import_zod22.z.string().max(64).nullable(),
   /** The install found (an .app bundle, an .exe, a binary), or null. */
   location: AbsPath.nullable(),
   /** Open the app at all on this OS. */
@@ -1237,69 +1312,69 @@ var AppInfo = import_zod21.z.strictObject({
   /** Plan usage read from the app's own files on this OS. */
   usage: AppFeatureStatus
 });
-var AppUsageReading = import_zod21.z.strictObject({
-  window: import_zod21.z.enum(["five_hour", "weekly", "extra"]),
+var AppUsageReading = import_zod22.z.strictObject({
+  window: import_zod22.z.enum(["five_hour", "weekly", "extra"]),
   /** 0–100 for five_hour and weekly; extra-usage spend as a percent of its cap (may pass 100). */
-  percent: import_zod21.z.number().min(0).max(1e4),
+  percent: import_zod22.z.number().min(0).max(1e4),
   /** When the app recorded it. */
   sampled_at_ms: epochMs,
   /** True when the window has rolled over since the sample, so the figure has reset. */
-  reset_since: import_zod21.z.boolean()
+  reset_since: import_zod22.z.boolean()
 });
-var AppProfile = import_zod21.z.strictObject({
+var AppProfile = import_zod22.z.strictObject({
   /** The row's id; null for a folder found on disk that no row names yet. */
   id: AppProfileId.nullable(),
   app_key: AppKey,
-  display_name: import_zod21.z.string().min(1).max(120),
+  display_name: import_zod22.z.string().min(1).max(120),
   /** The account the person means to be signed in here; null when not stated (never guessed). */
-  account_identity: import_zod21.z.string().min(3).max(320).nullable(),
+  account_identity: import_zod22.z.string().min(3).max(320).nullable(),
   profile_locator: AppProfileLocator.nullable(),
   /** The device the row is tied to; null when the row names none. */
   device_id: DeviceId.nullable(),
   /** The folder this profile resolves to on this device; null for a row tied to another device. */
   folder: AbsPath.nullable(),
   /** The folder exists on this device. */
-  on_disk: import_zod21.z.boolean(),
+  on_disk: import_zod22.z.boolean(),
   /** An instance with this profile is running; null when it could not be determined. */
-  running: import_zod21.z.boolean().nullable(),
+  running: import_zod22.z.boolean().nullable(),
   /** Usage the app recorded for this profile; null when the app exposes none here. */
-  usage: import_zod21.z.array(AppUsageReading).nullable(),
+  usage: import_zod22.z.array(AppUsageReading).nullable(),
   last_opened_ms: epochMs.nullable()
 });
-var AppsListParams = import_zod21.z.strictObject({});
-var AppsListResult = import_zod21.z.strictObject({ apps: import_zod21.z.array(AppInfo) });
-var AppsProfilesListParams = import_zod21.z.strictObject({
+var AppsListParams = import_zod22.z.strictObject({});
+var AppsListResult = import_zod22.z.strictObject({ apps: import_zod22.z.array(AppInfo) });
+var AppsProfilesListParams = import_zod22.z.strictObject({
   /** Only this app's profiles; every app's when absent. */
   app_key: AppKey.optional()
 });
-var AppsProfilesListResult = import_zod21.z.strictObject({
-  profiles: import_zod21.z.array(AppProfile),
+var AppsProfilesListResult = import_zod22.z.strictObject({
+  profiles: import_zod22.z.array(AppProfile),
   /**
    * Whether the saved rows could be read: false while signed out or offline, when only folders
    * found on disk are listed.
    */
-  registry: import_zod21.z.enum(["ok", "signed_out", "unavailable"])
+  registry: import_zod22.z.enum(["ok", "signed_out", "unavailable"])
 });
-var AppsProfilesSaveParams = import_zod21.z.strictObject({
+var AppsProfilesSaveParams = import_zod22.z.strictObject({
   id: AppProfileId.optional(),
   app_key: AppKey,
-  display_name: import_zod21.z.string().min(1).max(120),
-  account_identity: import_zod21.z.string().min(3).max(320).nullable(),
+  display_name: import_zod22.z.string().min(1).max(120),
+  account_identity: import_zod22.z.string().min(3).max(320).nullable(),
   /** On create: the folder to use (one found on disk), or null for the app's default profile. Ignored on update. */
   profile_locator: AppProfileLocator.nullable(),
   /** On create with profile_locator null: make a new folder named after display_name instead. */
-  new_folder: import_zod21.z.boolean().default(false)
+  new_folder: import_zod22.z.boolean().default(false)
 });
 var AppsProfilesSaveResult = AppProfile;
-var AppsProfilesRemoveParams = import_zod21.z.strictObject({ id: AppProfileId });
-var AppsProfilesRemoveResult = import_zod21.z.strictObject({ removed: import_zod21.z.boolean() });
-var AppsOpenParams = import_zod21.z.strictObject({
+var AppsProfilesRemoveParams = import_zod22.z.strictObject({ id: AppProfileId });
+var AppsProfilesRemoveResult = import_zod22.z.strictObject({ removed: import_zod22.z.boolean() });
+var AppsOpenParams = import_zod22.z.strictObject({
   app_key: AppKey,
   profile_id: AppProfileId.optional()
 });
-var AppsOpenResult = import_zod21.z.strictObject({
+var AppsOpenResult = import_zod22.z.strictObject({
   /** True when an instance with this profile was already running; it is brought forward. */
-  already_running: import_zod21.z.boolean(),
+  already_running: import_zod22.z.boolean(),
   folder: AbsPath.nullable()
 });
 
@@ -1367,7 +1442,9 @@ var OPS = {
   "input.mouse_click": { params: InputMouseClickParams, result: InputMouseClickResult, kind: "unary", since: "1.4", errors: ["INVALID_PARAMS", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "power.status": { params: PowerStatusParams, result: PowerStatusResult, kind: "unary", since: "1.4", errors: ["INTERNAL"] },
   "power.prevent_sleep": { params: PowerPreventSleepParams, result: PowerPreventSleepResult, kind: "unary", since: "1.4", errors: ["PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
-  "resources.snapshot": { params: ResourcesSnapshotParams, result: ResourcesSnapshotResult, kind: "unary", since: "1.4", errors: ["INTERNAL"] }
+  "resources.snapshot": { params: ResourcesSnapshotParams, result: ResourcesSnapshotResult, kind: "unary", since: "1.4", errors: ["INTERNAL"] },
+  // Claude Code history (SPEC §6 coding): served by the `coding` Python service through SERVICES below.
+  "coding.history.import_missing": { params: CodingHistoryImportMissingParams, result: CodingHistoryImportMissingResult, kind: "unary", since: "1.5", errors: ["RESOURCE_BUSY", "RESOURCE_GONE", "CANCELLED", "INTERNAL"] }
 };
 var EVENTS = {
   "fs.changed": FsChangedEvent,
@@ -1376,6 +1453,7 @@ var EVENTS = {
   "exec.cwd": ExecCwdEvent,
   "session.control_changed": SessionControlChangedEvent,
   "models.progress": ModelsProgressEvent,
+  "coding.history.progress": CodingHistoryProgressEvent,
   "relay.device_status": RelayDeviceStatusEvent,
   "relay.auth_expiring": RelayAuthExpiringEvent
 };