@ai-matrx/desktop-protocol 0.17.11 → 0.17.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -1,6 +1,6 @@
1
1
  import { z } from 'zod';
2
- import { O as OpName } from './models-dIUgWoHB.cjs';
3
- 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-dIUgWoHB.cjs';
2
+ import { O as OpName } from './models-BOPMXUz-.cjs';
3
+ 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-.cjs';
4
4
  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.cjs';
5
5
 
6
6
  /** @ai-matrx/desktop-protocol — version and primitive schemas. Schema source: lint-enforced rules in scripts/check-schema-source.mjs. */
@@ -25,10 +25,14 @@ declare const PROTOCOL_MAJOR: 1;
25
25
  * the list says when it is a saved copy being re-read (`updating`) and when it is not live.
26
26
  * 1.14 — a chat row carries its original title, where it came from, and the person's rename.
27
27
  * 1.15 — a chat row says when the app archived it (typed), and its title source is a closed set.
28
+ * 1.16 — the `stack` capability: the local AI Matrx servers, their logs, errors and history.
29
+ * 1.17 — what is using the computer: resources.activity (jobs, heaviest processes, strain, the
30
+ * last hour), resources.stop_job (a job's whole tree), resources.incidents (slowdown log);
31
+ * a disk names its volume (ResourcesDisk `name`).
28
32
  */
29
- declare const PROTOCOL_MINOR: 15;
33
+ declare const PROTOCOL_MINOR: 17;
30
34
  /** This package's version as the wire spells it ("major.minor"): hello, welcome, relay status. */
31
- declare const PROTOCOL_VERSION: "1.15";
35
+ declare const PROTOCOL_VERSION: "1.17";
32
36
  /** Internal building blocks — deliberately unnamed in $defs (inlined wherever used). */
33
37
  declare const u32: z.ZodInt;
34
38
  declare const nonNegInt: z.ZodInt;
@@ -3500,19 +3504,263 @@ type PowerPreventSleepResult = z.output<typeof PowerPreventSleepResult>;
3500
3504
 
3501
3505
  /**
3502
3506
  * @ai-matrx/desktop-protocol — cap resources (SPEC §6): how busy the computer is — CPU, memory and
3503
- * disks. The busiest processes are proc.list. Schema source: lint-enforced rules in
3504
- * scripts/check-schema-source.mjs. Added in protocol 1.4.
3507
+ * disks — and (1.17) what is using it, grouped into jobs, with a slowdown log. The busiest single
3508
+ * processes are proc.list. Schema source: lint-enforced rules in scripts/check-schema-source.mjs.
3509
+ * Added in protocol 1.4.
3505
3510
  */
3506
3511
 
3507
3512
  declare const ResourcesSnapshotParams: z.ZodObject<{}, z.core.$strict>;
3513
+ declare const ResourcesActivityParams: z.ZodObject<{}, z.core.$strict>;
3508
3514
  declare const ResourcesDisk: z.ZodObject<{
3509
3515
  mount: z.ZodString;
3516
+ name: z.ZodOptional<z.ZodString>;
3510
3517
  fs: z.ZodString;
3511
3518
  size_bytes: z.ZodInt;
3512
3519
  used_bytes: z.ZodInt;
3513
3520
  available_bytes: z.ZodInt;
3514
3521
  }, z.core.$strict>;
3515
3522
  type ResourcesDisk = z.output<typeof ResourcesDisk>;
3523
+ /** What a job is, from its command line. */
3524
+ declare const ResourcesJobKind: z.ZodEnum<{
3525
+ "type-check": "type-check";
3526
+ tests: "tests";
3527
+ build: "build";
3528
+ lint: "lint";
3529
+ "dev server": "dev server";
3530
+ "language server": "language server";
3531
+ search: "search";
3532
+ }>;
3533
+ type ResourcesJobKind = z.output<typeof ResourcesJobKind>;
3534
+ /** How hard the computer is working right now. */
3535
+ declare const ResourcesStrain: z.ZodEnum<{
3536
+ good: "good";
3537
+ strain: "strain";
3538
+ overloaded: "overloaded";
3539
+ }>;
3540
+ type ResourcesStrain = z.output<typeof ResourcesStrain>;
3541
+ /** The kernel's memory-pressure level (macOS); null where the OS has none. */
3542
+ declare const ResourcesPressure: z.ZodEnum<{
3543
+ normal: "normal";
3544
+ warning: "warning";
3545
+ critical: "critical";
3546
+ }>;
3547
+ type ResourcesPressure = z.output<typeof ResourcesPressure>;
3548
+ /** A job: a type-check, test run, build, lint, dev server, language server or search, with its whole process tree. */
3549
+ declare const ResourcesJob: z.ZodObject<{
3550
+ pid: z.ZodInt;
3551
+ kind: z.ZodEnum<{
3552
+ "type-check": "type-check";
3553
+ tests: "tests";
3554
+ build: "build";
3555
+ lint: "lint";
3556
+ "dev server": "dev server";
3557
+ "language server": "language server";
3558
+ search: "search";
3559
+ }>;
3560
+ command: z.ZodString;
3561
+ started_by: z.ZodNullable<z.ZodString>;
3562
+ orphan: z.ZodBoolean;
3563
+ waiting: z.ZodBoolean;
3564
+ folder: z.ZodNullable<z.ZodString>;
3565
+ duplicates: z.ZodInt;
3566
+ processes: z.ZodInt;
3567
+ cpu_percent: z.ZodNumber;
3568
+ memory_bytes: z.ZodInt;
3569
+ started_at_ms: z.ZodNullable<z.ZodInt>;
3570
+ stoppable: z.ZodBoolean;
3571
+ }, z.core.$strict>;
3572
+ type ResourcesJob = z.output<typeof ResourcesJob>;
3573
+ /** One of the heaviest processes. */
3574
+ declare const ResourcesProcess: z.ZodObject<{
3575
+ pid: z.ZodInt;
3576
+ name: z.ZodString;
3577
+ cpu_percent: z.ZodNumber;
3578
+ memory_bytes: z.ZodInt;
3579
+ started_by: z.ZodNullable<z.ZodString>;
3580
+ job: z.ZodNullable<z.ZodString>;
3581
+ started_at_ms: z.ZodNullable<z.ZodInt>;
3582
+ }, z.core.$strict>;
3583
+ type ResourcesProcess = z.output<typeof ResourcesProcess>;
3584
+ declare const ResourcesVerdict: z.ZodObject<{
3585
+ level: z.ZodEnum<{
3586
+ good: "good";
3587
+ strain: "strain";
3588
+ overloaded: "overloaded";
3589
+ }>;
3590
+ text: z.ZodString;
3591
+ cause: z.ZodNullable<z.ZodString>;
3592
+ }, z.core.$strict>;
3593
+ type ResourcesVerdict = z.output<typeof ResourcesVerdict>;
3594
+ declare const ResourcesSample: z.ZodObject<{
3595
+ at_ms: z.ZodInt;
3596
+ load: z.ZodNumber;
3597
+ memory_used_bytes: z.ZodInt;
3598
+ typechecks: z.ZodInt;
3599
+ }, z.core.$strict>;
3600
+ type ResourcesSample = z.output<typeof ResourcesSample>;
3601
+ declare const ResourcesActivityResult: z.ZodObject<{
3602
+ ready: z.ZodBoolean;
3603
+ sampled_at_ms: z.ZodNullable<z.ZodInt>;
3604
+ cores: z.ZodInt;
3605
+ load: z.ZodArray<z.ZodNumber>;
3606
+ memory: z.ZodObject<{
3607
+ total_bytes: z.ZodInt;
3608
+ used_bytes: z.ZodInt;
3609
+ compressed_bytes: z.ZodInt;
3610
+ compressor_bytes: z.ZodInt;
3611
+ swap_used_bytes: z.ZodInt;
3612
+ pressure: z.ZodNullable<z.ZodEnum<{
3613
+ normal: "normal";
3614
+ warning: "warning";
3615
+ critical: "critical";
3616
+ }>>;
3617
+ }, z.core.$strict>;
3618
+ verdict: z.ZodObject<{
3619
+ level: z.ZodEnum<{
3620
+ good: "good";
3621
+ strain: "strain";
3622
+ overloaded: "overloaded";
3623
+ }>;
3624
+ text: z.ZodString;
3625
+ cause: z.ZodNullable<z.ZodString>;
3626
+ }, z.core.$strict>;
3627
+ typechecks: z.ZodObject<{
3628
+ running: z.ZodInt;
3629
+ waiting: z.ZodInt;
3630
+ comfort: z.ZodInt;
3631
+ }, z.core.$strict>;
3632
+ jobs: z.ZodArray<z.ZodObject<{
3633
+ pid: z.ZodInt;
3634
+ kind: z.ZodEnum<{
3635
+ "type-check": "type-check";
3636
+ tests: "tests";
3637
+ build: "build";
3638
+ lint: "lint";
3639
+ "dev server": "dev server";
3640
+ "language server": "language server";
3641
+ search: "search";
3642
+ }>;
3643
+ command: z.ZodString;
3644
+ started_by: z.ZodNullable<z.ZodString>;
3645
+ orphan: z.ZodBoolean;
3646
+ waiting: z.ZodBoolean;
3647
+ folder: z.ZodNullable<z.ZodString>;
3648
+ duplicates: z.ZodInt;
3649
+ processes: z.ZodInt;
3650
+ cpu_percent: z.ZodNumber;
3651
+ memory_bytes: z.ZodInt;
3652
+ started_at_ms: z.ZodNullable<z.ZodInt>;
3653
+ stoppable: z.ZodBoolean;
3654
+ }, z.core.$strict>>;
3655
+ top: z.ZodArray<z.ZodObject<{
3656
+ pid: z.ZodInt;
3657
+ name: z.ZodString;
3658
+ cpu_percent: z.ZodNumber;
3659
+ memory_bytes: z.ZodInt;
3660
+ started_by: z.ZodNullable<z.ZodString>;
3661
+ job: z.ZodNullable<z.ZodString>;
3662
+ started_at_ms: z.ZodNullable<z.ZodInt>;
3663
+ }, z.core.$strict>>;
3664
+ history: z.ZodArray<z.ZodObject<{
3665
+ at_ms: z.ZodInt;
3666
+ load: z.ZodNumber;
3667
+ memory_used_bytes: z.ZodInt;
3668
+ typechecks: z.ZodInt;
3669
+ }, z.core.$strict>>;
3670
+ }, z.core.$strict>;
3671
+ type ResourcesActivityResult = z.output<typeof ResourcesActivityResult>;
3672
+ declare const ResourcesStopJobParams: z.ZodObject<{
3673
+ pid: z.ZodInt;
3674
+ }, z.core.$strict>;
3675
+ type ResourcesStopJobParams = z.output<typeof ResourcesStopJobParams>;
3676
+ declare const ResourcesStopJobResult: z.ZodObject<{
3677
+ processes: z.ZodInt;
3678
+ already_finished: z.ZodBoolean;
3679
+ }, z.core.$strict>;
3680
+ type ResourcesStopJobResult = z.output<typeof ResourcesStopJobResult>;
3681
+ /** A moment the computer was under strain, and what was using it. */
3682
+ declare const ResourcesIncident: z.ZodObject<{
3683
+ at_ms: z.ZodInt;
3684
+ verdict: z.ZodObject<{
3685
+ level: z.ZodEnum<{
3686
+ good: "good";
3687
+ strain: "strain";
3688
+ overloaded: "overloaded";
3689
+ }>;
3690
+ text: z.ZodString;
3691
+ cause: z.ZodNullable<z.ZodString>;
3692
+ }, z.core.$strict>;
3693
+ load: z.ZodNumber;
3694
+ memory_used_bytes: z.ZodInt;
3695
+ compressed_bytes: z.ZodInt;
3696
+ pressure: z.ZodNullable<z.ZodEnum<{
3697
+ normal: "normal";
3698
+ warning: "warning";
3699
+ critical: "critical";
3700
+ }>>;
3701
+ jobs: z.ZodArray<z.ZodObject<{
3702
+ kind: z.ZodEnum<{
3703
+ "type-check": "type-check";
3704
+ tests: "tests";
3705
+ build: "build";
3706
+ lint: "lint";
3707
+ "dev server": "dev server";
3708
+ "language server": "language server";
3709
+ search: "search";
3710
+ }>;
3711
+ started_by: z.ZodNullable<z.ZodString>;
3712
+ folder: z.ZodNullable<z.ZodString>;
3713
+ command: z.ZodString;
3714
+ cpu_percent: z.ZodNumber;
3715
+ memory_bytes: z.ZodInt;
3716
+ duplicates: z.ZodInt;
3717
+ }, z.core.$strict>>;
3718
+ }, z.core.$strict>;
3719
+ type ResourcesIncident = z.output<typeof ResourcesIncident>;
3720
+ declare const ResourcesIncidentsParams: z.ZodObject<{
3721
+ limit: z.ZodDefault<z.ZodInt>;
3722
+ }, z.core.$strict>;
3723
+ type ResourcesIncidentsParams = z.output<typeof ResourcesIncidentsParams>;
3724
+ declare const ResourcesIncidentsResult: z.ZodObject<{
3725
+ incidents: z.ZodArray<z.ZodObject<{
3726
+ at_ms: z.ZodInt;
3727
+ verdict: z.ZodObject<{
3728
+ level: z.ZodEnum<{
3729
+ good: "good";
3730
+ strain: "strain";
3731
+ overloaded: "overloaded";
3732
+ }>;
3733
+ text: z.ZodString;
3734
+ cause: z.ZodNullable<z.ZodString>;
3735
+ }, z.core.$strict>;
3736
+ load: z.ZodNumber;
3737
+ memory_used_bytes: z.ZodInt;
3738
+ compressed_bytes: z.ZodInt;
3739
+ pressure: z.ZodNullable<z.ZodEnum<{
3740
+ normal: "normal";
3741
+ warning: "warning";
3742
+ critical: "critical";
3743
+ }>>;
3744
+ jobs: z.ZodArray<z.ZodObject<{
3745
+ kind: z.ZodEnum<{
3746
+ "type-check": "type-check";
3747
+ tests: "tests";
3748
+ build: "build";
3749
+ lint: "lint";
3750
+ "dev server": "dev server";
3751
+ "language server": "language server";
3752
+ search: "search";
3753
+ }>;
3754
+ started_by: z.ZodNullable<z.ZodString>;
3755
+ folder: z.ZodNullable<z.ZodString>;
3756
+ command: z.ZodString;
3757
+ cpu_percent: z.ZodNumber;
3758
+ memory_bytes: z.ZodInt;
3759
+ duplicates: z.ZodInt;
3760
+ }, z.core.$strict>>;
3761
+ }, z.core.$strict>>;
3762
+ }, z.core.$strict>;
3763
+ type ResourcesIncidentsResult = z.output<typeof ResourcesIncidentsResult>;
3516
3764
  declare const ResourcesSnapshotResult: z.ZodObject<{
3517
3765
  cpu: z.ZodObject<{
3518
3766
  percent: z.ZodNumber;
@@ -3530,6 +3778,7 @@ declare const ResourcesSnapshotResult: z.ZodObject<{
3530
3778
  }, z.core.$strict>;
3531
3779
  disks: z.ZodArray<z.ZodObject<{
3532
3780
  mount: z.ZodString;
3781
+ name: z.ZodOptional<z.ZodString>;
3533
3782
  fs: z.ZodString;
3534
3783
  size_bytes: z.ZodInt;
3535
3784
  used_bytes: z.ZodInt;
@@ -3539,6 +3788,141 @@ declare const ResourcesSnapshotResult: z.ZodObject<{
3539
3788
  }, z.core.$strict>;
3540
3789
  type ResourcesSnapshotResult = z.output<typeof ResourcesSnapshotResult>;
3541
3790
 
3791
+ /**
3792
+ * @ai-matrx/desktop-protocol — cap stack (SPEC §6): the local AI Matrx servers on this computer
3793
+ * (aidream's process-compose stack): each server's state in plain words, start / stop / restart,
3794
+ * its log read and followed by byte offset, every error of the last hour, and a history of what
3795
+ * happened. Schema source: lint-enforced rules in scripts/check-schema-source.mjs. Added in 1.16.
3796
+ */
3797
+
3798
+ declare const StackStateParams: z.ZodObject<{}, z.core.$strict>;
3799
+ declare const StackStartParams: z.ZodObject<{}, z.core.$strict>;
3800
+ declare const StackStopParams: z.ZodObject<{}, z.core.$strict>;
3801
+ /** The request was accepted; the outcome lands in the history (action-done / action-failed). */
3802
+ declare const StackRunResult: z.ZodObject<{
3803
+ accepted: z.ZodBoolean;
3804
+ }, z.core.$strict>;
3805
+ declare const StackServerActionResult: z.ZodObject<{
3806
+ message: z.ZodString;
3807
+ }, z.core.$strict>;
3808
+ declare const StackErrorsParams: z.ZodObject<{
3809
+ window_minutes: z.ZodDefault<z.ZodInt>;
3810
+ }, z.core.$strict>;
3811
+ /** A server's name as the stack's config declares it ("aidream", "scraper"). */
3812
+ declare const StackServerName: z.ZodString;
3813
+ type StackServerName = z.output<typeof StackServerName>;
3814
+ /** good: healthy · wait: starting, stopping, unhealthy for now · bad: needs attention · off. */
3815
+ declare const StackTone: z.ZodEnum<{
3816
+ good: "good";
3817
+ wait: "wait";
3818
+ bad: "bad";
3819
+ off: "off";
3820
+ }>;
3821
+ type StackTone = z.output<typeof StackTone>;
3822
+ declare const StackServer: z.ZodObject<{
3823
+ name: z.ZodString;
3824
+ label: z.ZodString;
3825
+ tone: z.ZodEnum<{
3826
+ good: "good";
3827
+ wait: "wait";
3828
+ bad: "bad";
3829
+ off: "off";
3830
+ }>;
3831
+ sentence: z.ZodString;
3832
+ description: z.ZodString;
3833
+ open_url: z.ZodNullable<z.ZodString>;
3834
+ log_file: z.ZodString;
3835
+ last_output_at_ms: z.ZodNullable<z.ZodInt>;
3836
+ started_at_ms: z.ZodNullable<z.ZodInt>;
3837
+ restarts: z.ZodInt;
3838
+ exit_code: z.ZodNullable<z.ZodInt>;
3839
+ pid: z.ZodNullable<z.ZodInt>;
3840
+ }, z.core.$strict>;
3841
+ type StackServer = z.output<typeof StackServer>;
3842
+ /** One entry of the stack's history (the same file Local Admin keeps). */
3843
+ declare const StackEvent: z.ZodObject<{
3844
+ at_ms: z.ZodInt;
3845
+ server: z.ZodString;
3846
+ kind: z.ZodString;
3847
+ text: z.ZodString;
3848
+ }, z.core.$strict>;
3849
+ type StackEvent = z.output<typeof StackEvent>;
3850
+ declare const StackStateResult: z.ZodObject<{
3851
+ config_path: z.ZodNullable<z.ZodString>;
3852
+ problem: z.ZodNullable<z.ZodString>;
3853
+ stack_up: z.ZodBoolean;
3854
+ stack_started_at_ms: z.ZodNullable<z.ZodInt>;
3855
+ servers: z.ZodArray<z.ZodObject<{
3856
+ name: z.ZodString;
3857
+ label: z.ZodString;
3858
+ tone: z.ZodEnum<{
3859
+ good: "good";
3860
+ wait: "wait";
3861
+ bad: "bad";
3862
+ off: "off";
3863
+ }>;
3864
+ sentence: z.ZodString;
3865
+ description: z.ZodString;
3866
+ open_url: z.ZodNullable<z.ZodString>;
3867
+ log_file: z.ZodString;
3868
+ last_output_at_ms: z.ZodNullable<z.ZodInt>;
3869
+ started_at_ms: z.ZodNullable<z.ZodInt>;
3870
+ restarts: z.ZodInt;
3871
+ exit_code: z.ZodNullable<z.ZodInt>;
3872
+ pid: z.ZodNullable<z.ZodInt>;
3873
+ }, z.core.$strict>>;
3874
+ setup_note: z.ZodNullable<z.ZodString>;
3875
+ pending: z.ZodNullable<z.ZodObject<{
3876
+ verb: z.ZodEnum<{
3877
+ start: "start";
3878
+ stop: "stop";
3879
+ }>;
3880
+ label: z.ZodString;
3881
+ since_ms: z.ZodInt;
3882
+ }, z.core.$strict>>;
3883
+ events: z.ZodArray<z.ZodObject<{
3884
+ at_ms: z.ZodInt;
3885
+ server: z.ZodString;
3886
+ kind: z.ZodString;
3887
+ text: z.ZodString;
3888
+ }, z.core.$strict>>;
3889
+ }, z.core.$strict>;
3890
+ type StackStateResult = z.output<typeof StackStateResult>;
3891
+ declare const StackServerActionParams: z.ZodObject<{
3892
+ name: z.ZodString;
3893
+ verb: z.ZodEnum<{
3894
+ start: "start";
3895
+ stop: "stop";
3896
+ restart: "restart";
3897
+ }>;
3898
+ }, z.core.$strict>;
3899
+ type StackServerActionParams = z.output<typeof StackServerActionParams>;
3900
+ declare const StackLogsParams: z.ZodObject<{
3901
+ name: z.ZodString;
3902
+ lines: z.ZodDefault<z.ZodInt>;
3903
+ offset: z.ZodOptional<z.ZodInt>;
3904
+ since: z.ZodOptional<z.ZodInt>;
3905
+ wait_ms: z.ZodDefault<z.ZodInt>;
3906
+ }, z.core.$strict>;
3907
+ type StackLogsParams = z.output<typeof StackLogsParams>;
3908
+ declare const StackLogsResult: z.ZodObject<{
3909
+ lines: z.ZodArray<z.ZodString>;
3910
+ offset: z.ZodInt;
3911
+ since_valid: z.ZodBoolean;
3912
+ reset: z.ZodBoolean;
3913
+ log_file: z.ZodString;
3914
+ }, z.core.$strict>;
3915
+ type StackLogsResult = z.output<typeof StackLogsResult>;
3916
+ declare const StackErrorsResult: z.ZodObject<{
3917
+ sections: z.ZodArray<z.ZodObject<{
3918
+ name: z.ZodString;
3919
+ heading: z.ZodString;
3920
+ lines: z.ZodArray<z.ZodString>;
3921
+ }, z.core.$strict>>;
3922
+ window_minutes: z.ZodInt;
3923
+ }, z.core.$strict>;
3924
+ type StackErrorsResult = z.output<typeof StackErrorsResult>;
3925
+
3542
3926
  /**
3543
3927
  * @ai-matrx/desktop-protocol — cap audio (SPEC §6): the person's microphones and speakers; record a
3544
3928
  * clip to a file, play a file. Speech to text is models.transcribe. Schema source: lint-enforced
@@ -3945,6 +4329,9 @@ declare const FIELDS_SINCE: {
3945
4329
  readonly plan: "1.13";
3946
4330
  readonly credits: "1.13";
3947
4331
  };
4332
+ readonly ResourcesDisk: {
4333
+ readonly name: "1.17";
4334
+ };
3948
4335
  };
3949
4336
  type FieldsSincePath = keyof typeof FIELDS_SINCE;
3950
4337
  /**
@@ -3999,7 +4386,7 @@ declare function forPeer(op: OpName | null, part: "error", value: unknown, versi
3999
4386
  declare const VERSIONED_RESULT_OPS: readonly OpName[];
4000
4387
 
4001
4388
  /** SHA-256 of generated/desktop-protocol.schema.json: the contract both sides of a service connection were built from. */
4002
- declare const CONTRACT_SHA256: "91060640a08d25f693f4d90384da7225299ab8fd287b665ca7d36f226d641267";
4389
+ declare const CONTRACT_SHA256: "cdfad283c689005856b4161f28a37892d1c3356db077f685a4a659fc2c8fc657";
4003
4390
 
4004
4391
  /**
4005
4392
  * The local tool catalog (SPEC §10): every tool a platform agent calls on a person's computer, the
@@ -4126,4 +4513,4 @@ declare function buildToolStatus(files: readonly unknown[], opts: {
4126
4513
  /** The committed text form. Columns: per platform, the three levels (P = programmatic, R = protocol, C = chat). */
4127
4514
  declare function renderToolStatusMarkdown(status: ToolStatus): string;
4128
4515
 
4129
- 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, 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 };
4516
+ 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 };