@ai-matrx/desktop-protocol 0.17.12 → 0.17.13

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { O as OpName } from './models-A0PWllJz.js';
-export { B as BEARER_PREFIX, g as CLOSE_RULES, h as CancelMsg, j as ClientToCoreMsg, e as ClientType, k as CloseAction, l as CloseCode, m as CloseCodeValue, C as CloseOutcome, n as CloseRule, o as CoreToClientMsg, p as CreditMsg, D as DesktopProtocolError, d as EVENTS, q as EndMsg, E as EndReason, r as ErrorCode, s as ErrorCodeName, t as ErrorData, u as ErrorMsg, v as ErrorReason, w as ErrorReasonName, x as EventMsg, y as EventName, F as FsPatchEditFailure, H as HelloMsg, L as Limits, z as MlInstallPhase, A as MlInstallProgress, f as MlProgress, G as MlRuntimeState, I as MlServiceState, J as MlServiceStatus, K as MlStatusParams, N as MlStatusResult, P as ModelsInstallParams, Q as ModelsInstallResult, R as ModelsProgressEvent, U as ModelsStatusParams, V as ModelsStatusResult, X as ModelsTranscribeParams, M as ModelsTranscribeResult, Y as NAMED_SCHEMAS, Z as NamedSchemaId, c as OPS, _ as OpDescriptor, a as OpParams, b as OpResult, $ as OpSpec, a0 as PING_TEXT, a1 as PONG_TEXT, a2 as ProtocolErrorBody, a3 as RelayMsg, a4 as RequestMsg, a5 as ResponseMsg, a6 as SERVICES, a7 as SUBPROTOCOL, a8 as ServiceId, a9 as ServiceOpName, aa as ServiceOpSpec, ab as ServiceSpec, S as StreamMeta, ac as StreamMsg, ad as TranscriptSegment, T as TranscriptionModelId, ae as TranscriptionModelInfo, W as Welcome, af as closeRule, i as isDesktopProtocolError, ag as isTerminalClose } from './models-A0PWllJz.js';
+import { O as OpName } from './models-BOPMXUz-.js';
+export { B as BEARER_PREFIX, g as CLOSE_RULES, h as CancelMsg, j as ClientToCoreMsg, e as ClientType, k as CloseAction, l as CloseCode, m as CloseCodeValue, C as CloseOutcome, n as CloseRule, o as CoreToClientMsg, p as CreditMsg, D as DesktopProtocolError, d as EVENTS, q as EndMsg, E as EndReason, r as ErrorCode, s as ErrorCodeName, t as ErrorData, u as ErrorMsg, v as ErrorReason, w as ErrorReasonName, x as EventMsg, y as EventName, F as FsPatchEditFailure, H as HelloMsg, L as Limits, z as MlInstallPhase, A as MlInstallProgress, f as MlProgress, G as MlRuntimeState, I as MlServiceState, J as MlServiceStatus, K as MlStatusParams, N as MlStatusResult, P as ModelsInstallParams, Q as ModelsInstallResult, R as ModelsProgressEvent, U as ModelsStatusParams, V as ModelsStatusResult, X as ModelsTranscribeParams, M as ModelsTranscribeResult, Y as NAMED_SCHEMAS, Z as NamedSchemaId, c as OPS, _ as OpDescriptor, a as OpParams, b as OpResult, $ as OpSpec, a0 as PING_TEXT, a1 as PONG_TEXT, a2 as ProtocolErrorBody, a3 as RelayMsg, a4 as RequestMsg, a5 as ResponseMsg, a6 as SERVICES, a7 as SUBPROTOCOL, a8 as ServiceId, a9 as ServiceOpName, aa as ServiceOpSpec, ab as ServiceSpec, S as StreamMeta, ac as StreamMsg, ad as TranscriptSegment, T as TranscriptionModelId, ae as TranscriptionModelInfo, W as Welcome, af as closeRule, i as isDesktopProtocolError, ag as isTerminalClose } from './models-BOPMXUz-.js';
 export { BROADCAST_CID, DecodedFrame, FRAME_HEADER_BYTES, FRAME_STRUCT_FORMAT, FRAME_VERSION, FrameChannel, FrameChannelValue, FrameFlag, assertFrameHeader, connectionEndFrame, decodeFrame, encodeFrame, hasFlag, isConnectionEnd, readCid, stampCid } from './frame.js';
 
 /** @ai-matrx/desktop-protocol — version and primitive schemas. Schema source: lint-enforced rules in scripts/check-schema-source.mjs. */
@@ -26,10 +26,13 @@ declare const PROTOCOL_MAJOR: 1;
  *   1.14 — a chat row carries its original title, where it came from, and the person's rename.
  *   1.15 — a chat row says when the app archived it (typed), and its title source is a closed set.
  *   1.16 — the `stack` capability: the local AI Matrx servers, their logs, errors and history.
+ *   1.17 — what is using the computer: resources.activity (jobs, heaviest processes, strain, the
+ *          last hour), resources.stop_job (a job's whole tree), resources.incidents (slowdown log);
+ *          a disk names its volume (ResourcesDisk `name`).
  */
-declare const PROTOCOL_MINOR: 16;
+declare const PROTOCOL_MINOR: 17;
 /** This package's version as the wire spells it ("major.minor"): hello, welcome, relay status. */
-declare const PROTOCOL_VERSION: "1.16";
+declare const PROTOCOL_VERSION: "1.17";
 /** Internal building blocks — deliberately unnamed in $defs (inlined wherever used). */
 declare const u32: z.ZodInt;
 declare const nonNegInt: z.ZodInt;
@@ -3501,19 +3504,263 @@ type PowerPreventSleepResult = z.output<typeof PowerPreventSleepResult>;
 
 /**
  * @ai-matrx/desktop-protocol — cap resources (SPEC §6): how busy the computer is — CPU, memory and
- * disks. The busiest processes are proc.list. Schema source: lint-enforced rules in
- * scripts/check-schema-source.mjs. Added in protocol 1.4.
+ * disks — and (1.17) what is using it, grouped into jobs, with a slowdown log. The busiest single
+ * processes are proc.list. Schema source: lint-enforced rules in scripts/check-schema-source.mjs.
+ * Added in protocol 1.4.
  */
 
 declare const ResourcesSnapshotParams: z.ZodObject<{}, z.core.$strict>;
+declare const ResourcesActivityParams: z.ZodObject<{}, z.core.$strict>;
 declare const ResourcesDisk: z.ZodObject<{
     mount: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
     fs: z.ZodString;
     size_bytes: z.ZodInt;
     used_bytes: z.ZodInt;
     available_bytes: z.ZodInt;
 }, z.core.$strict>;
 type ResourcesDisk = z.output<typeof ResourcesDisk>;
+/** What a job is, from its command line. */
+declare const ResourcesJobKind: z.ZodEnum<{
+    "type-check": "type-check";
+    tests: "tests";
+    build: "build";
+    lint: "lint";
+    "dev server": "dev server";
+    "language server": "language server";
+    search: "search";
+}>;
+type ResourcesJobKind = z.output<typeof ResourcesJobKind>;
+/** How hard the computer is working right now. */
+declare const ResourcesStrain: z.ZodEnum<{
+    good: "good";
+    strain: "strain";
+    overloaded: "overloaded";
+}>;
+type ResourcesStrain = z.output<typeof ResourcesStrain>;
+/** The kernel's memory-pressure level (macOS); null where the OS has none. */
+declare const ResourcesPressure: z.ZodEnum<{
+    normal: "normal";
+    warning: "warning";
+    critical: "critical";
+}>;
+type ResourcesPressure = z.output<typeof ResourcesPressure>;
+/** A job: a type-check, test run, build, lint, dev server, language server or search, with its whole process tree. */
+declare const ResourcesJob: z.ZodObject<{
+    pid: z.ZodInt;
+    kind: z.ZodEnum<{
+        "type-check": "type-check";
+        tests: "tests";
+        build: "build";
+        lint: "lint";
+        "dev server": "dev server";
+        "language server": "language server";
+        search: "search";
+    }>;
+    command: z.ZodString;
+    started_by: z.ZodNullable<z.ZodString>;
+    orphan: z.ZodBoolean;
+    waiting: z.ZodBoolean;
+    folder: z.ZodNullable<z.ZodString>;
+    duplicates: z.ZodInt;
+    processes: z.ZodInt;
+    cpu_percent: z.ZodNumber;
+    memory_bytes: z.ZodInt;
+    started_at_ms: z.ZodNullable<z.ZodInt>;
+    stoppable: z.ZodBoolean;
+}, z.core.$strict>;
+type ResourcesJob = z.output<typeof ResourcesJob>;
+/** One of the heaviest processes. */
+declare const ResourcesProcess: z.ZodObject<{
+    pid: z.ZodInt;
+    name: z.ZodString;
+    cpu_percent: z.ZodNumber;
+    memory_bytes: z.ZodInt;
+    started_by: z.ZodNullable<z.ZodString>;
+    job: z.ZodNullable<z.ZodString>;
+    started_at_ms: z.ZodNullable<z.ZodInt>;
+}, z.core.$strict>;
+type ResourcesProcess = z.output<typeof ResourcesProcess>;
+declare const ResourcesVerdict: z.ZodObject<{
+    level: z.ZodEnum<{
+        good: "good";
+        strain: "strain";
+        overloaded: "overloaded";
+    }>;
+    text: z.ZodString;
+    cause: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+type ResourcesVerdict = z.output<typeof ResourcesVerdict>;
+declare const ResourcesSample: z.ZodObject<{
+    at_ms: z.ZodInt;
+    load: z.ZodNumber;
+    memory_used_bytes: z.ZodInt;
+    typechecks: z.ZodInt;
+}, z.core.$strict>;
+type ResourcesSample = z.output<typeof ResourcesSample>;
+declare const ResourcesActivityResult: z.ZodObject<{
+    ready: z.ZodBoolean;
+    sampled_at_ms: z.ZodNullable<z.ZodInt>;
+    cores: z.ZodInt;
+    load: z.ZodArray<z.ZodNumber>;
+    memory: z.ZodObject<{
+        total_bytes: z.ZodInt;
+        used_bytes: z.ZodInt;
+        compressed_bytes: z.ZodInt;
+        compressor_bytes: z.ZodInt;
+        swap_used_bytes: z.ZodInt;
+        pressure: z.ZodNullable<z.ZodEnum<{
+            normal: "normal";
+            warning: "warning";
+            critical: "critical";
+        }>>;
+    }, z.core.$strict>;
+    verdict: z.ZodObject<{
+        level: z.ZodEnum<{
+            good: "good";
+            strain: "strain";
+            overloaded: "overloaded";
+        }>;
+        text: z.ZodString;
+        cause: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+    typechecks: z.ZodObject<{
+        running: z.ZodInt;
+        waiting: z.ZodInt;
+        comfort: z.ZodInt;
+    }, z.core.$strict>;
+    jobs: z.ZodArray<z.ZodObject<{
+        pid: z.ZodInt;
+        kind: z.ZodEnum<{
+            "type-check": "type-check";
+            tests: "tests";
+            build: "build";
+            lint: "lint";
+            "dev server": "dev server";
+            "language server": "language server";
+            search: "search";
+        }>;
+        command: z.ZodString;
+        started_by: z.ZodNullable<z.ZodString>;
+        orphan: z.ZodBoolean;
+        waiting: z.ZodBoolean;
+        folder: z.ZodNullable<z.ZodString>;
+        duplicates: z.ZodInt;
+        processes: z.ZodInt;
+        cpu_percent: z.ZodNumber;
+        memory_bytes: z.ZodInt;
+        started_at_ms: z.ZodNullable<z.ZodInt>;
+        stoppable: z.ZodBoolean;
+    }, z.core.$strict>>;
+    top: z.ZodArray<z.ZodObject<{
+        pid: z.ZodInt;
+        name: z.ZodString;
+        cpu_percent: z.ZodNumber;
+        memory_bytes: z.ZodInt;
+        started_by: z.ZodNullable<z.ZodString>;
+        job: z.ZodNullable<z.ZodString>;
+        started_at_ms: z.ZodNullable<z.ZodInt>;
+    }, z.core.$strict>>;
+    history: z.ZodArray<z.ZodObject<{
+        at_ms: z.ZodInt;
+        load: z.ZodNumber;
+        memory_used_bytes: z.ZodInt;
+        typechecks: z.ZodInt;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type ResourcesActivityResult = z.output<typeof ResourcesActivityResult>;
+declare const ResourcesStopJobParams: z.ZodObject<{
+    pid: z.ZodInt;
+}, z.core.$strict>;
+type ResourcesStopJobParams = z.output<typeof ResourcesStopJobParams>;
+declare const ResourcesStopJobResult: z.ZodObject<{
+    processes: z.ZodInt;
+    already_finished: z.ZodBoolean;
+}, z.core.$strict>;
+type ResourcesStopJobResult = z.output<typeof ResourcesStopJobResult>;
+/** A moment the computer was under strain, and what was using it. */
+declare const ResourcesIncident: z.ZodObject<{
+    at_ms: z.ZodInt;
+    verdict: z.ZodObject<{
+        level: z.ZodEnum<{
+            good: "good";
+            strain: "strain";
+            overloaded: "overloaded";
+        }>;
+        text: z.ZodString;
+        cause: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+    load: z.ZodNumber;
+    memory_used_bytes: z.ZodInt;
+    compressed_bytes: z.ZodInt;
+    pressure: z.ZodNullable<z.ZodEnum<{
+        normal: "normal";
+        warning: "warning";
+        critical: "critical";
+    }>>;
+    jobs: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            "type-check": "type-check";
+            tests: "tests";
+            build: "build";
+            lint: "lint";
+            "dev server": "dev server";
+            "language server": "language server";
+            search: "search";
+        }>;
+        started_by: z.ZodNullable<z.ZodString>;
+        folder: z.ZodNullable<z.ZodString>;
+        command: z.ZodString;
+        cpu_percent: z.ZodNumber;
+        memory_bytes: z.ZodInt;
+        duplicates: z.ZodInt;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type ResourcesIncident = z.output<typeof ResourcesIncident>;
+declare const ResourcesIncidentsParams: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodInt>;
+}, z.core.$strict>;
+type ResourcesIncidentsParams = z.output<typeof ResourcesIncidentsParams>;
+declare const ResourcesIncidentsResult: z.ZodObject<{
+    incidents: z.ZodArray<z.ZodObject<{
+        at_ms: z.ZodInt;
+        verdict: z.ZodObject<{
+            level: z.ZodEnum<{
+                good: "good";
+                strain: "strain";
+                overloaded: "overloaded";
+            }>;
+            text: z.ZodString;
+            cause: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>;
+        load: z.ZodNumber;
+        memory_used_bytes: z.ZodInt;
+        compressed_bytes: z.ZodInt;
+        pressure: z.ZodNullable<z.ZodEnum<{
+            normal: "normal";
+            warning: "warning";
+            critical: "critical";
+        }>>;
+        jobs: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                "type-check": "type-check";
+                tests: "tests";
+                build: "build";
+                lint: "lint";
+                "dev server": "dev server";
+                "language server": "language server";
+                search: "search";
+            }>;
+            started_by: z.ZodNullable<z.ZodString>;
+            folder: z.ZodNullable<z.ZodString>;
+            command: z.ZodString;
+            cpu_percent: z.ZodNumber;
+            memory_bytes: z.ZodInt;
+            duplicates: z.ZodInt;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type ResourcesIncidentsResult = z.output<typeof ResourcesIncidentsResult>;
 declare const ResourcesSnapshotResult: z.ZodObject<{
     cpu: z.ZodObject<{
         percent: z.ZodNumber;
@@ -3531,6 +3778,7 @@ declare const ResourcesSnapshotResult: z.ZodObject<{
     }, z.core.$strict>;
     disks: z.ZodArray<z.ZodObject<{
         mount: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
         fs: z.ZodString;
         size_bytes: z.ZodInt;
         used_bytes: z.ZodInt;
@@ -4081,6 +4329,9 @@ declare const FIELDS_SINCE: {
         readonly plan: "1.13";
         readonly credits: "1.13";
     };
+    readonly ResourcesDisk: {
+        readonly name: "1.17";
+    };
 };
 type FieldsSincePath = keyof typeof FIELDS_SINCE;
 /**
@@ -4135,7 +4386,7 @@ declare function forPeer(op: OpName | null, part: "error", value: unknown, versi
 declare const VERSIONED_RESULT_OPS: readonly OpName[];
 
 /** SHA-256 of generated/desktop-protocol.schema.json: the contract both sides of a service connection were built from. */
-declare const CONTRACT_SHA256: "ee6873cbbdcba3960248ff0c5c71fe47c663b54c6e657d62d1ed5e04e51f17e2";
+declare const CONTRACT_SHA256: "cdfad283c689005856b4161f28a37892d1c3356db077f685a4a659fc2c8fc657";
 
 /**
  * The local tool catalog (SPEC §10): every tool a platform agent calls on a person's computer, the
@@ -4262,4 +4513,4 @@ declare function buildToolStatus(files: readonly unknown[], opts: {
 /** The committed text form. Columns: per platform, the three levels (P = programmatic, R = protocol, C = chat). */
 declare function renderToolStatusMarkdown(status: ToolStatus): string;
 
-export { AbsPath, AccountReset, AccountUsage, AppFeatureStatus, AppInfo, AppKey, AppProfile, AppProfileId, AppProfileLocator, AppSupport, AppUsageReading, AppWindowInfo, AppsAccountsResetsParams, AppsAccountsResetsResult, AppsAccountsUsageParams, AppsAccountsUsageResult, AppsChatsChangedEvent, AppsChatsColdParams, AppsChatsColdResult, AppsChatsListParams, AppsChatsListResult, AppsChatsOpenParams, AppsChatsPlaceParams, AppsChatsPlaceResult, AppsChatsStarParams, AppsChatsStarResult, AppsChatsWatchParams, AppsChatsWatchResult, AppsChatsWatchStateEvent, AppsListParams, AppsListResult, AppsOpenParams, AppsOpenResult, AppsProfilesListParams, AppsProfilesListResult, AppsProfilesRemoveParams, AppsProfilesRemoveResult, AppsProfilesSaveParams, AppsProfilesSaveResult, AppsProjectsCopyParams, AppsProjectsCopyResult, AppsProjectsCreateParams, AppsProjectsCreateResult, AppsProjectsFileManyParams, AppsProjectsFileManyResult, AppsProjectsFileParams, AppsProjectsFileResult, AppsProjectsImportPinsParams, AppsProjectsImportPinsResult, AppsProjectsMoveParams, AppsProjectsMoveResult, AppsProjectsUnfileParams, AppsProjectsUnfileResult, AppsProjectsUpdateParams, AppsProjectsUpdateResult, AppsSpendParams, AppsSpendResult, AppsSyncRunParams, AppsSyncStatusParams, AppsSyncStatusResult, AppsWindowActionResult, AppsWindowsAddParams, AppsWindowsListParams, AppsWindowsListResult, AppsWindowsOpenParams, AppsWindowsProcessesParams, AppsWindowsProcessesResult, AppsWindowsRefreshUsageParams, AppsWindowsReloadParams, AppsWindowsRestartParams, AppsWindowsSaveNamesParams, AudioDevice, AudioDevicesParams, AudioDevicesResult, AudioPlayParams, AudioPlayResult, AudioRecordParams, AudioRecordResult, CONTRACT_SHA256, type CatalogTool, type CellState, ChatAppProject, ChatFamily, ChatHidden, ChatId, ChatLastUse, ChatPin, ChatPlace, ChatProject, ChatProjectId, ChatRow, ChatRunning, ChatWindow, ClipboardReadParams, ClipboardReadResult, ClipboardWriteParams, ClipboardWriteResult, CodingHistoryBlocked, CodingHistoryFailure, CodingHistoryImportMissingParams, CodingHistoryImportMissingResult, CodingHistoryProgressEvent, CodingHistoryRun, CodingHistoryStep, CodingImportNextParams, CodingPlanMissingParams, CodingServiceCredentials, CodingServiceProgress, ColdChat, ContractHash, CoreToServiceMsg, DEFAULT_MAX_FRAME_PAYLOAD_BYTES, DEFAULT_MAX_MESSAGE_BYTES, DEFAULT_WINDOW_BYTES, DeviceId, EXCLUDED_TOOLS, ExecCwdEvent, ExecExitedEvent, ExecJobId, ExecJobInfo, ExecJobListParams, ExecJobListResult, ExecJobOutputParams, ExecJobOutputResult, ExecJobStartParams, ExecJobStartResult, ExecJobStopParams, ExecJobStopResult, ExecListParams, ExecListResult, ExecPtyKillParams, ExecPtyKillResult, ExecPtyResizeParams, ExecPtyResizeResult, ExecPtySignalParams, ExecPtySignalResult, ExecPtyStartParams, ExecPtyStartResult, ExecPtyWriteParams, ExecPtyWriteResult, ExecRunParams, ExecRunResult, ExecTitleEvent, FIELDS_SINCE, type FieldsSincePath, FrameHeader, FsChange, FsChangedEvent, FsDeleteParams, FsDeleteResult, FsEncoding, FsEntry, FsKind, FsListParams, FsListResult, FsMkdirParams, FsMkdirResult, FsMoveParams, FsMoveResult, FsPatchEditApplied, FsPatchParams, FsPatchResult, FsReadParams, FsReadResult, FsReadStreamParams, FsReadStreamResult, FsSearchContentParams, FsSearchContentResult, FsSearchPathsParams, FsSearchPathsResult, FsStatParams, FsStatResult, FsWatchEventsParams, FsWatchEventsResult, FsWatchId, FsWatchParams, FsWatchResult, FsWatchStartParams, FsWatchStartResult, FsWatchStopParams, FsWatchStopResult, FsWriteParams, FsWriteResult, InputHotkeyParams, InputHotkeyResult, InputKey, InputMouseClickParams, InputMouseClickResult, InputMouseMoveParams, InputMouseMoveResult, InputPoint, InputTypeTextParams, InputTypeTextResult, LEGACY_ACTIONS, LEGACY_DISPATCHERS, type LegacyDisposition, NULL_SINCE, OpName, OsPermissionName, PROTOCOL_MAJOR, PROTOCOL_MINOR, PROTOCOL_VERSION, PowerPreventSleepParams, PowerPreventSleepResult, PowerStatusParams, PowerStatusResult, ProcInfo, ProcKillParams, ProcKillResult, ProcListParams, ProcListResult, ProcPort, ProcPortsParams, ProcPortsResult, ProcSort, ProtocolVersion, PtyInfo, REASONS_SINCE, RELAY_CALL_HELLO_ID, RELAY_CALL_REQUEST_ID, RELAY_CALL_VERSION_HEADER, RelayAuthExpiringEvent, RelayCallEnvelope, RelayCallHello, RelayCallRequest, RelayCallResponse, RelayDeviceStatusEvent, RelayHopConnectionEnd, RelayHopEnvelopeHeader, RelayStatusResponse, RequestId, ResourceId, ResourceInfo, ResourcesDisk, ResourcesSnapshotParams, ResourcesSnapshotResult, SERVICE_MAX_FRAME_BYTES, ScreenCaptureParams, ScreenCaptureResult, ScreenDisplay, ScreenListParams, ScreenListResult, ServiceCancel, ServiceErrorMsg, ServiceHello, ServiceName, ServicePing, ServicePong, ServiceProgressMsg, ServiceRequest, ServiceResponse, ServiceShutdown, ServiceToCoreMsg, ServiceToken, ServiceWelcome, SessionAttachParams, SessionAttachResult, SessionControlChangedEvent, SessionDetachParams, SessionDetachResult, SessionListParams, SessionListResult, SessionReleaseParams, SessionReleaseResult, Signal, SpendAccount, SpendChat, SpendHelper, SpendIdle, SpendIdleScope, SpendLive, SpendModel, SpendScopes, SpendSplit, SpendStart, StackErrorsParams, StackErrorsResult, StackEvent, StackLogsParams, StackLogsResult, StackRunResult, StackServer, StackServerActionParams, StackServerActionResult, StackServerName, StackStartParams, StackStateParams, StackStateResult, StackStopParams, StackTone, type StatusCell, type StatusEvidence, type StatusRow, SysinfoGetParams, SysinfoGetResult, SystemNotifyParams, SystemNotifyResult, SystemOpenPathParams, SystemOpenPathResult, SystemOpenUrlParams, SystemOpenUrlResult, TOOL_CATALOG, TOOL_GROUPS, TOOL_LEVELS, TOOL_PLATFORMS, type ToolGroup, type ToolGroupId, ToolLevel, ToolLevelResult, ToolName, ToolOutcome, type ToolPath, ToolPlatform, ToolResultsFile, type ToolState, type ToolStatus, ToolTransport, VERSIONED_RESULT_OPS, WindowFocusParams, WindowFocusResult, WindowInfo, WindowListParams, WindowListResult, WindowMinimizeParams, WindowMinimizeResult, WindowMoveParams, WindowMoveResult, announcedVersion, buildToolStatus, builtOps, compareVersions, epochMs, forPeer, knows, negotiate, nonNegInt, renderToolStatusMarkdown, statusForPeer, u32, versionSubprotocol };
+export { AbsPath, AccountReset, AccountUsage, AppFeatureStatus, AppInfo, AppKey, AppProfile, AppProfileId, AppProfileLocator, AppSupport, AppUsageReading, AppWindowInfo, AppsAccountsResetsParams, AppsAccountsResetsResult, AppsAccountsUsageParams, AppsAccountsUsageResult, AppsChatsChangedEvent, AppsChatsColdParams, AppsChatsColdResult, AppsChatsListParams, AppsChatsListResult, AppsChatsOpenParams, AppsChatsPlaceParams, AppsChatsPlaceResult, AppsChatsStarParams, AppsChatsStarResult, AppsChatsWatchParams, AppsChatsWatchResult, AppsChatsWatchStateEvent, AppsListParams, AppsListResult, AppsOpenParams, AppsOpenResult, AppsProfilesListParams, AppsProfilesListResult, AppsProfilesRemoveParams, AppsProfilesRemoveResult, AppsProfilesSaveParams, AppsProfilesSaveResult, AppsProjectsCopyParams, AppsProjectsCopyResult, AppsProjectsCreateParams, AppsProjectsCreateResult, AppsProjectsFileManyParams, AppsProjectsFileManyResult, AppsProjectsFileParams, AppsProjectsFileResult, AppsProjectsImportPinsParams, AppsProjectsImportPinsResult, AppsProjectsMoveParams, AppsProjectsMoveResult, AppsProjectsUnfileParams, AppsProjectsUnfileResult, AppsProjectsUpdateParams, AppsProjectsUpdateResult, AppsSpendParams, AppsSpendResult, AppsSyncRunParams, AppsSyncStatusParams, AppsSyncStatusResult, AppsWindowActionResult, AppsWindowsAddParams, AppsWindowsListParams, AppsWindowsListResult, AppsWindowsOpenParams, AppsWindowsProcessesParams, AppsWindowsProcessesResult, AppsWindowsRefreshUsageParams, AppsWindowsReloadParams, AppsWindowsRestartParams, AppsWindowsSaveNamesParams, AudioDevice, AudioDevicesParams, AudioDevicesResult, AudioPlayParams, AudioPlayResult, AudioRecordParams, AudioRecordResult, CONTRACT_SHA256, type CatalogTool, type CellState, ChatAppProject, ChatFamily, ChatHidden, ChatId, ChatLastUse, ChatPin, ChatPlace, ChatProject, ChatProjectId, ChatRow, ChatRunning, ChatWindow, ClipboardReadParams, ClipboardReadResult, ClipboardWriteParams, ClipboardWriteResult, CodingHistoryBlocked, CodingHistoryFailure, CodingHistoryImportMissingParams, CodingHistoryImportMissingResult, CodingHistoryProgressEvent, CodingHistoryRun, CodingHistoryStep, CodingImportNextParams, CodingPlanMissingParams, CodingServiceCredentials, CodingServiceProgress, ColdChat, ContractHash, CoreToServiceMsg, DEFAULT_MAX_FRAME_PAYLOAD_BYTES, DEFAULT_MAX_MESSAGE_BYTES, DEFAULT_WINDOW_BYTES, DeviceId, EXCLUDED_TOOLS, ExecCwdEvent, ExecExitedEvent, ExecJobId, ExecJobInfo, ExecJobListParams, ExecJobListResult, ExecJobOutputParams, ExecJobOutputResult, ExecJobStartParams, ExecJobStartResult, ExecJobStopParams, ExecJobStopResult, ExecListParams, ExecListResult, ExecPtyKillParams, ExecPtyKillResult, ExecPtyResizeParams, ExecPtyResizeResult, ExecPtySignalParams, ExecPtySignalResult, ExecPtyStartParams, ExecPtyStartResult, ExecPtyWriteParams, ExecPtyWriteResult, ExecRunParams, ExecRunResult, ExecTitleEvent, FIELDS_SINCE, type FieldsSincePath, FrameHeader, FsChange, FsChangedEvent, FsDeleteParams, FsDeleteResult, FsEncoding, FsEntry, FsKind, FsListParams, FsListResult, FsMkdirParams, FsMkdirResult, FsMoveParams, FsMoveResult, FsPatchEditApplied, FsPatchParams, FsPatchResult, FsReadParams, FsReadResult, FsReadStreamParams, FsReadStreamResult, FsSearchContentParams, FsSearchContentResult, FsSearchPathsParams, FsSearchPathsResult, FsStatParams, FsStatResult, FsWatchEventsParams, FsWatchEventsResult, FsWatchId, FsWatchParams, FsWatchResult, FsWatchStartParams, FsWatchStartResult, FsWatchStopParams, FsWatchStopResult, FsWriteParams, FsWriteResult, InputHotkeyParams, InputHotkeyResult, InputKey, InputMouseClickParams, InputMouseClickResult, InputMouseMoveParams, InputMouseMoveResult, InputPoint, InputTypeTextParams, InputTypeTextResult, LEGACY_ACTIONS, LEGACY_DISPATCHERS, type LegacyDisposition, NULL_SINCE, OpName, OsPermissionName, PROTOCOL_MAJOR, PROTOCOL_MINOR, PROTOCOL_VERSION, PowerPreventSleepParams, PowerPreventSleepResult, PowerStatusParams, PowerStatusResult, ProcInfo, ProcKillParams, ProcKillResult, ProcListParams, ProcListResult, ProcPort, ProcPortsParams, ProcPortsResult, ProcSort, ProtocolVersion, PtyInfo, REASONS_SINCE, RELAY_CALL_HELLO_ID, RELAY_CALL_REQUEST_ID, RELAY_CALL_VERSION_HEADER, RelayAuthExpiringEvent, RelayCallEnvelope, RelayCallHello, RelayCallRequest, RelayCallResponse, RelayDeviceStatusEvent, RelayHopConnectionEnd, RelayHopEnvelopeHeader, RelayStatusResponse, RequestId, ResourceId, ResourceInfo, ResourcesActivityParams, ResourcesActivityResult, ResourcesDisk, ResourcesIncident, ResourcesIncidentsParams, ResourcesIncidentsResult, ResourcesJob, ResourcesJobKind, ResourcesPressure, ResourcesProcess, ResourcesSample, ResourcesSnapshotParams, ResourcesSnapshotResult, ResourcesStopJobParams, ResourcesStopJobResult, ResourcesStrain, ResourcesVerdict, SERVICE_MAX_FRAME_BYTES, ScreenCaptureParams, ScreenCaptureResult, ScreenDisplay, ScreenListParams, ScreenListResult, ServiceCancel, ServiceErrorMsg, ServiceHello, ServiceName, ServicePing, ServicePong, ServiceProgressMsg, ServiceRequest, ServiceResponse, ServiceShutdown, ServiceToCoreMsg, ServiceToken, ServiceWelcome, SessionAttachParams, SessionAttachResult, SessionControlChangedEvent, SessionDetachParams, SessionDetachResult, SessionListParams, SessionListResult, SessionReleaseParams, SessionReleaseResult, Signal, SpendAccount, SpendChat, SpendHelper, SpendIdle, SpendIdleScope, SpendLive, SpendModel, SpendScopes, SpendSplit, SpendStart, StackErrorsParams, StackErrorsResult, StackEvent, StackLogsParams, StackLogsResult, StackRunResult, StackServer, StackServerActionParams, StackServerActionResult, StackServerName, StackStartParams, StackStateParams, StackStateResult, StackStopParams, StackTone, type StatusCell, type StatusEvidence, type StatusRow, SysinfoGetParams, SysinfoGetResult, SystemNotifyParams, SystemNotifyResult, SystemOpenPathParams, SystemOpenPathResult, SystemOpenUrlParams, SystemOpenUrlResult, TOOL_CATALOG, TOOL_GROUPS, TOOL_LEVELS, TOOL_PLATFORMS, type ToolGroup, type ToolGroupId, ToolLevel, ToolLevelResult, ToolName, ToolOutcome, type ToolPath, ToolPlatform, ToolResultsFile, type ToolState, type ToolStatus, ToolTransport, VERSIONED_RESULT_OPS, WindowFocusParams, WindowFocusResult, WindowInfo, WindowListParams, WindowListResult, WindowMinimizeParams, WindowMinimizeResult, WindowMoveParams, WindowMoveResult, announcedVersion, buildToolStatus, builtOps, compareVersions, epochMs, forPeer, knows, negotiate, nonNegInt, renderToolStatusMarkdown, statusForPeer, u32, versionSubprotocol };

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/schema/primitives.ts
 import { z } from "zod";
 var PROTOCOL_MAJOR = 1;
-var PROTOCOL_MINOR = 16;
+var PROTOCOL_MINOR = 17;
 var PROTOCOL_VERSION = `${PROTOCOL_MAJOR}.${PROTOCOL_MINOR}`;
 var ProtocolVersion = z.string().regex(/^[1-9][0-9]{0,2}\.[0-9]{1,3}$/);
 var RequestId = z.string().min(1).max(64).regex(/^[A-Za-z0-9_-]+$/);
@@ -1640,6 +1640,8 @@ import { z as z23 } from "zod";
 var ResourcesDisk = z23.strictObject({
   /** Where it is mounted ("/", "C:"). */
   mount: z23.string().max(512),
+  /** The volume's name as the file manager shows it ("Macintosh HD", "Local Disk (C:)"). Since 1.17. */
+  name: z23.string().max(256).optional(),
   /** The file system ("apfs", "NTFS", "ext4"). */
   fs: z23.string().max(64),
   size_bytes: nonNegInt,
@@ -1660,6 +1662,117 @@ var ResourcesSnapshotResult = z23.strictObject({
   disks: z23.array(ResourcesDisk).max(64),
   uptime_seconds: nonNegInt
 });
+var ResourcesJobKind = z23.enum(["type-check", "tests", "build", "lint", "dev server", "language server", "search"]);
+var ResourcesStrain = z23.enum(["good", "strain", "overloaded"]);
+var ResourcesPressure = z23.enum(["normal", "warning", "critical"]);
+var ResourcesJob = z23.strictObject({
+  /** The job's root process (Stop takes its whole tree). */
+  pid: z23.int().min(0),
+  kind: ResourcesJobKind,
+  /** Its heaviest process's command line, shortened ("…/lib/tsc --noEmit -p tsconfig.json"). */
+  command: z23.string().max(256),
+  /** Who started it: "Claude Code", "Codex", "Cursor", "VS Code", "Terminal", "local stack", "detached"; null when unknown. */
+  started_by: z23.string().max(64).nullable(),
+  /** Whatever started it is gone and nothing waits for it. */
+  orphan: z23.boolean(),
+  /** A type-check queued for its turn (no compiler running yet). */
+  waiting: z23.boolean(),
+  /** The project folder it runs in ("matrx-frontend"); null when not in one. */
+  folder: z23.string().max(256).nullable(),
+  /** The same command in the same folder, running this many times (1 = no duplicate). */
+  duplicates: z23.int().min(1),
+  processes: z23.int().min(1),
+  /** Sum over the tree, as `ps` reports it: 100 = one full core. */
+  cpu_percent: z23.number().min(0),
+  /** Real memory (macOS: the physical footprint Activity Monitor shows, compressed included). */
+  memory_bytes: nonNegInt,
+  started_at_ms: epochMs.nullable(),
+  /** False for an app, an agent session, a terminal, a system process, the local stack or Matrx 2 itself. */
+  stoppable: z23.boolean()
+});
+var ResourcesProcess = z23.strictObject({
+  pid: z23.int().min(0),
+  /** The command line, shortened. */
+  name: z23.string().max(256),
+  cpu_percent: z23.number().min(0),
+  memory_bytes: nonNegInt,
+  started_by: z23.string().max(64).nullable(),
+  /** The job it belongs to ("type-check in aidream"); null when none. */
+  job: z23.string().max(256).nullable(),
+  started_at_ms: epochMs.nullable()
+});
+var ResourcesVerdict = z23.strictObject({
+  level: ResourcesStrain,
+  /** One sentence ("Your Mac is under strain. 3 type-checks are running at once."). */
+  text: z23.string().max(256),
+  /** The biggest jobs behind it; null when all is well. */
+  cause: z23.string().max(1024).nullable()
+});
+var ResourcesSample = z23.strictObject({
+  at_ms: epochMs,
+  /** The 1-minute load average. */
+  load: z23.number().min(0),
+  memory_used_bytes: nonNegInt,
+  typechecks: nonNegInt
+});
+var ResourcesActivityParams = z23.strictObject({});
+var ResourcesActivityResult = z23.strictObject({
+  /** False until the first reading (a second or two after start). */
+  ready: z23.boolean(),
+  sampled_at_ms: epochMs.nullable(),
+  cores: z23.int().min(1),
+  /** 1, 5 and 15 minute load averages. */
+  load: z23.array(z23.number().min(0)).length(3),
+  memory: z23.strictObject({
+    total_bytes: nonNegInt,
+    /** Activity Monitor's Memory Used: app memory + wired + compressed. */
+    used_bytes: nonNegInt,
+    /** Data held compressed, and the memory the compressor takes to hold it. */
+    compressed_bytes: nonNegInt,
+    compressor_bytes: nonNegInt,
+    swap_used_bytes: nonNegInt,
+    pressure: ResourcesPressure.nullable()
+  }),
+  verdict: ResourcesVerdict,
+  typechecks: z23.strictObject({ running: nonNegInt, waiting: nonNegInt, comfort: nonNegInt }),
+  /** Heaviest first (1 GB weighs as much as 16 % of a core). */
+  jobs: z23.array(ResourcesJob).max(200),
+  /** The 15 heaviest by memory and the 15 busiest by CPU, together. */
+  top: z23.array(ResourcesProcess).max(30),
+  /** The last hour, oldest first. */
+  history: z23.array(ResourcesSample).max(1200)
+});
+var ResourcesStopJobParams = z23.strictObject({ pid: z23.int().min(1) });
+var ResourcesStopJobResult = z23.strictObject({
+  /** Processes signalled; whatever is still running 5 seconds later is force-stopped. */
+  processes: nonNegInt,
+  /** It had finished before the request arrived. */
+  already_finished: z23.boolean()
+});
+var ResourcesIncident = z23.strictObject({
+  at_ms: epochMs,
+  verdict: ResourcesVerdict,
+  load: z23.number().min(0),
+  memory_used_bytes: nonNegInt,
+  compressed_bytes: nonNegInt,
+  pressure: ResourcesPressure.nullable(),
+  jobs: z23.array(
+    z23.strictObject({
+      kind: ResourcesJobKind,
+      started_by: z23.string().max(64).nullable(),
+      folder: z23.string().max(256).nullable(),
+      command: z23.string().max(256),
+      cpu_percent: z23.number().min(0),
+      memory_bytes: nonNegInt,
+      duplicates: z23.int().min(1)
+    })
+  ).max(8)
+});
+var ResourcesIncidentsParams = z23.strictObject({ limit: z23.int().min(1).max(200).default(50) });
+var ResourcesIncidentsResult = z23.strictObject({
+  /** Newest first; at most one a minute is written. */
+  incidents: z23.array(ResourcesIncident).max(200)
+});
 
 // src/schema/stack.ts
 import { z as z24 } from "zod";
@@ -2022,6 +2135,9 @@ var OPS = {
   "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.activity": { params: ResourcesActivityParams, result: ResourcesActivityResult, kind: "unary", since: "1.17", errors: ["PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "resources.stop_job": { params: ResourcesStopJobParams, result: ResourcesStopJobResult, kind: "unary", since: "1.17", errors: ["NOT_FOUND", "CONFLICT", "AUTH_FORBIDDEN", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "resources.incidents": { params: ResourcesIncidentsParams, result: ResourcesIncidentsResult, kind: "unary", since: "1.17", errors: ["INTERNAL"] },
   "audio.devices": { params: AudioDevicesParams, result: AudioDevicesResult, kind: "unary", since: "1.6", errors: ["PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "audio.record": { params: AudioRecordParams, result: AudioRecordResult, kind: "unary", since: "1.6", errors: ["NOT_FOUND", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "RESOURCE_BUSY", "INTERNAL"] },
   "audio.play": { params: AudioPlayParams, result: AudioPlayResult, kind: "unary", since: "1.6", errors: ["NOT_FOUND", "INVALID_PARAMS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
@@ -2256,6 +2372,20 @@ var NAMED_SCHEMAS = {
   ResourcesDisk,
   ResourcesSnapshotParams,
   ResourcesSnapshotResult,
+  ResourcesJobKind,
+  ResourcesStrain,
+  ResourcesPressure,
+  ResourcesVerdict,
+  ResourcesSample,
+  ResourcesJob,
+  ResourcesProcess,
+  ResourcesActivityParams,
+  ResourcesActivityResult,
+  ResourcesStopJobParams,
+  ResourcesStopJobResult,
+  ResourcesIncident,
+  ResourcesIncidentsParams,
+  ResourcesIncidentsResult,
   AudioDevice,
   AudioDevicesParams,
   AudioDevicesResult,
@@ -2407,7 +2537,8 @@ var FIELDS_SINCE = {
   AppsAccountsUsageResult: { problem: "1.12" },
   AppsAccountsResetsResult: { problem: "1.12" },
   ChatRow: { app_project: "1.13", tokens: "1.13", original_title: "1.14", title_source: "1.14", title_override: "1.14", archived: "1.15" },
-  AccountUsage: { plan: "1.13", credits: "1.13" }
+  AccountUsage: { plan: "1.13", credits: "1.13" },
+  ResourcesDisk: { name: "1.17" }
 };
 var NULL_SINCE = {
   "RelayDeviceStatusEvent.since_ms": { since: "1.1", olderPeersGet: 0 }
@@ -2474,7 +2605,8 @@ var NESTED_RESULTS = /* @__PURE__ */ new Map([
   ["apps.projects.move", [["chat", "ChatRow"]]],
   ["apps.chats.star", [["chat", "ChatRow"]]],
   ["apps.chats.place", [["chat", "ChatRow"]]],
-  ["apps.accounts.usage", [["accounts", "AccountUsage"]]]
+  ["apps.accounts.usage", [["accounts", "AccountUsage"]]],
+  ["resources.snapshot", [["disks", "ResourcesDisk"]]]
 ]);
 function stripNested(value, nested, version) {
   if (value === null || typeof value !== "object" || Array.isArray(value)) return value;
@@ -2535,7 +2667,7 @@ function forPeer(op, part, value, version) {
 var VERSIONED_RESULT_OPS = [.../* @__PURE__ */ new Set([...RESULT_PATH.keys(), ...WINDOW_RESULTS.keys(), ...NESTED_RESULTS.keys()])];
 
 // src/contract.ts
-var CONTRACT_SHA256 = "ee6873cbbdcba3960248ff0c5c71fe47c663b54c6e657d62d1ed5e04e51f17e2";
+var CONTRACT_SHA256 = "cdfad283c689005856b4161f28a37892d1c3356db077f685a4a659fc2c8fc657";
 
 // src/close-policy.ts
 var CLOSE_RULES = {
@@ -2595,7 +2727,7 @@ var TOOL_CATALOG = [
   { name: "desktop_input", group: "os_control", state: "built", path: "device_op", ops: ["input.type_text", "input.hotkey", "input.mouse_click", "input.mouse_move"], platforms: ALL, summary: "Keyboard and mouse" },
   { name: "desktop_audio", group: "os_control", state: "built", path: "device_op", ops: ["audio.devices", "audio.record", "audio.play"], platforms: ALL, summary: "Audio devices, record, play" },
   { name: "desktop_power", group: "os_control", state: "built", path: "device_op", ops: ["power.status", "power.prevent_sleep"], platforms: ALL, summary: "Battery and keep awake" },
-  { name: "desktop_resources", group: "os_control", state: "built", path: "device_op", ops: ["resources.snapshot"], platforms: ALL, summary: "CPU, memory and disk use" },
+  { name: "desktop_resources", group: "os_control", state: "built", path: "device_op", ops: ["resources.snapshot", "resources.activity", "resources.stop_job", "resources.incidents"], platforms: ALL, summary: "CPU, memory and disk use; what is using them, grouped into jobs; stop a job; the slowdown log" },
   { name: "fs_watch", group: "os_control", state: "built", path: "device_op", ops: ["fs.watch.start", "fs.watch.events", "fs.watch.stop"], platforms: ALL, summary: "Watch a folder; read what changed" },
   // ── 3. Personal apps and automation ──────────────────────────────────────────────────────────
   { name: "desktop_automation", group: "personal_automation", state: "planned", path: "device_op", ops: ["automation.script"], platforms: ["darwin", "win32"], summary: "AppleScript on a Mac, PowerShell on Windows" },
@@ -3153,9 +3285,23 @@ export {
   RequestMsg,
   ResourceId,
   ResourceInfo,
+  ResourcesActivityParams,
+  ResourcesActivityResult,
   ResourcesDisk,
+  ResourcesIncident,
+  ResourcesIncidentsParams,
+  ResourcesIncidentsResult,
+  ResourcesJob,
+  ResourcesJobKind,
+  ResourcesPressure,
+  ResourcesProcess,
+  ResourcesSample,
   ResourcesSnapshotParams,
   ResourcesSnapshotResult,
+  ResourcesStopJobParams,
+  ResourcesStopJobResult,
+  ResourcesStrain,
+  ResourcesVerdict,
   ResponseMsg,
   SERVICES,
   SERVICE_MAX_FRAME_BYTES,