@ericsanchezok/synergy-sdk 1.2.20 → 1.2.22

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.
@@ -1,5 +1,5 @@
1
1
  import { type Client, type Options as Options2, type TDataShape } from "./client/index.js";
2
- import type { AgendaActivateErrors, AgendaActivateResponses, AgendaCancelErrors, AgendaCancelResponses, AgendaCompleteErrors, AgendaCompleteResponses, AgendaCreateErrors, AgendaCreateInput, AgendaCreateResponses, AgendaGetErrors, AgendaGetResponses, AgendaPatchInput, AgendaPauseErrors, AgendaPauseResponses, AgendaRemoveErrors, AgendaRemoveResponses, AgendaRunsErrors, AgendaRunsResponses, AgendaSessionsErrors, AgendaSessionsResponses, AgendaTriggerErrors, AgendaTriggerResponses, AgendaUpdateErrors, AgendaUpdateResponses, AgendaWebhookErrors, AgendaWebhookResponses, AppAgentsResponses, AppLogErrors, AppLogResponses, AssetGetErrors, AssetGetResponses, AssetUploadErrors, AssetUploadResponses, Auth as Auth2, AuthSetErrors, AuthSetResponses, ChannelAppResetResponses, ChannelAppSessionResponses, ChannelDisconnectResponses, ChannelGenesisResetResponses, ChannelGenesisSessionResponses, ChannelStartOneResponses, ChannelStartResponses, ChannelStatusResponses, ChannelStopOneResponses, ChannelStopResponses, CommandListResponses, Config as Config2, ConfigGetResponses, ConfigGlobalResponses, ConfigProvidersResponses, ConfigSetActivateErrors, ConfigSetActivateResponses, ConfigSetCreateErrors, ConfigSetCreateInput, ConfigSetCreateResponses, ConfigSetDeleteErrors, ConfigSetDeleteResponses, ConfigSetGetErrors, ConfigSetGetResponses, ConfigSetListResponses, ConfigSetName, ConfigSetRawGetErrors, ConfigSetRawGetResponses, ConfigSetRawSaveErrors, ConfigSetRawSaveInput, ConfigSetRawSaveResponses, ConfigSetRawValidateErrors, ConfigSetRawValidateInput, ConfigSetRawValidateResponses, ConfigSetUpdateErrors, ConfigSetUpdateResponses, ConfigUpdateErrors, ConfigUpdateResponses, CortexCancelErrors, CortexCancelResponses, CortexGetErrors, CortexGetResponses, CortexListErrors, CortexListResponses, CortexOutputErrors, CortexOutputResponses, EngramExperienceApplyRewardErrors, EngramExperienceApplyRewardResponses, EngramExperienceGetErrors, EngramExperienceGetResponses, EngramExperienceListResponses, EngramExperiencePageErrors, EngramExperiencePageResponses, EngramExperienceRemoveErrors, EngramExperienceRemoveResponses, EngramExperienceSearchErrors, EngramExperienceSearchResponses, EngramGetErrors, EngramGetResponses, EngramListResponses, EngramRemoveErrors, EngramRemoveResponses, EngramResetErrors, EngramResetResponses, EngramSearchErrors, EngramSearchResponses, EngramStatsResponses, EventSubscribeResponses, ExperienceListFilter, ExperienceListSort, ExperimentalResourceListResponses, FileListResponses, FilePartInput, FilePartSource, FileReadResponses, FileStatusResponses, FindBrowseResponses, FindFilesResponses, FindSymbolsResponses, FindTextResponses, FormatterStatusResponses, GitInitErrors, GitInitResponses, GlobalAgendaListErrors, GlobalAgendaListResponses, GlobalDisposeResponses, GlobalHealthResponses, HolosAgentsGetErrors, HolosAgentsGetResponses, HolosAgentsListResponses, HolosCallbackResponses, HolosContactAddErrors, HolosContactAddResponses, HolosContactGetErrors, HolosContactGetResponses, HolosContactListResponses, HolosContactRemoveResponses, HolosContactSendMessageErrors, HolosContactSendMessageResponses, HolosContactSessionErrors, HolosContactSessionResponses, HolosContactUpdateConfigErrors, HolosContactUpdateConfigResponses, HolosCredentialsErrors, HolosCredentialsResponses, HolosCredentialsStatusResponses, HolosFriendReplyListResponses, HolosFriendRequestCreateErrors, HolosFriendRequestCreateResponses, HolosFriendRequestListResponses, HolosFriendRequestRemoveResponses, HolosFriendRequestRespondErrors, HolosFriendRequestRespondResponses, HolosFriendRequestSendErrors, HolosFriendRequestSendResponses, HolosLoginResponses, HolosLogoutResponses, HolosPresenceResponses, HolosProfileGetResponses, HolosProfileResetResponses, HolosProfileSkipGenesisResponses, HolosProfileUpdateErrors, HolosProfileUpdateResponses, HolosQueueListResponses, HolosReconnectErrors, HolosReconnectResponses, HolosRefreshPresenceResponses, HolosStateResponses, HolosVerifyResponses, InstanceDisposeResponses, LspStatusResponses, McpAddErrors, McpAddResponses, McpAuthAuthenticateErrors, McpAuthAuthenticateResponses, McpAuthCallbackErrors, McpAuthCallbackResponses, McpAuthRemoveErrors, McpAuthRemoveResponses, McpAuthStartErrors, McpAuthStartResponses, McpConnectResponses, McpDisconnectResponses, McpLocalConfig, McpRemoteConfig, McpStatusResponses, MemoryCategory, MemoryRecallMode, NoteCreateErrors, NoteCreateInput, NoteCreateResponses, NoteExportErrors, NoteExportResponses, NoteGetErrors, NoteGetResponses, NoteListAllErrors, NoteListAllResponses, NoteListErrors, NoteListResponses, NotePatchInput, NoteRemoveErrors, NoteRemoveResponses, NoteUpdateErrors, NoteUpdateResponses, Part as Part2, PartDeleteErrors, PartDeleteResponses, PartUpdateErrors, PartUpdateResponses, PathGetResponses, PermissionIsAllowingAllErrors, PermissionIsAllowingAllResponses, PermissionListResponses, PermissionReplyErrors, PermissionReplyResponses, PermissionRespondErrors, PermissionRespondResponses, PermissionSetAllowAllErrors, PermissionSetAllowAllResponses, ProviderAuthResponses, ProviderListResponses, ProviderOauthAuthorizeErrors, ProviderOauthAuthorizeResponses, ProviderOauthCallbackErrors, ProviderOauthCallbackResponses, PtyConnectErrors, PtyConnectResponses, PtyCreateErrors, PtyCreateResponses, PtyGetErrors, PtyGetResponses, PtyListResponses, PtyRemoveErrors, PtyRemoveResponses, PtyUpdateErrors, PtyUpdateResponses, QuestionAnswer, QuestionListResponses, QuestionRejectErrors, QuestionRejectResponses, QuestionReplyErrors, QuestionReplyResponses, RewardsInfo, RuntimeReloadErrors, RuntimeReloadResponses, RuntimeReloadScope, RuntimeReloadTarget, ScopeCurrentResponses, ScopeListResponses, ScopeRemoveResponses, ScopeUpdateErrors, ScopeUpdateResponses, SessionAbortErrors, SessionAbortResponses, SessionChildrenErrors, SessionChildrenResponses, SessionCommandErrors, SessionCommandResponses, SessionCreateErrors, SessionCreateResponses, SessionDagErrors, SessionDagResponses, SessionDeleteErrors, SessionDeleteResponses, SessionDiffErrors, SessionDiffResponses, SessionExportDownloadErrors, SessionExportDownloadResponses, SessionExportEstimateErrors, SessionExportEstimateResponses, SessionExportMode, SessionForkResponses, SessionGetErrors, SessionGetResponses, SessionInitErrors, SessionInitResponses, SessionListResponses, SessionMessageErrors, SessionMessageResponses, SessionMessagesErrors, SessionMessagesResponses, SessionPromptAsyncErrors, SessionPromptAsyncResponses, SessionPromptErrors, SessionPromptResponses, SessionRevertErrors, SessionRevertResponses, SessionShellErrors, SessionShellResponses, SessionStatusErrors, SessionStatusResponses, SessionSummarizeErrors, SessionSummarizeResponses, SessionTodoErrors, SessionTodoResponses, SessionUnrevertErrors, SessionUnrevertResponses, SessionUpdateErrors, SessionUpdateResponses, SkillImportErrors, SkillImportResponses, SkillImportUrlErrors, SkillImportUrlResponses, SkillListResponses, SkillReloadResponses, SkillRemoveErrors, SkillRemoveResponses, TextPartInput, ToolIdsErrors, ToolIdsResponses, ToolListErrors, ToolListResponses, VcsGetResponses, WorktreeCreateErrors, WorktreeCreateInput, WorktreeCreateResponses, WorktreeListResponses } from "./types.gen.js";
2
+ import type { AgendaActivateErrors, AgendaActivateResponses, AgendaActivityErrors, AgendaActivityResponses, AgendaCancelErrors, AgendaCancelResponses, AgendaCompleteErrors, AgendaCompleteResponses, AgendaCreateErrors, AgendaCreateInput, AgendaCreateResponses, AgendaGetErrors, AgendaGetResponses, AgendaPatchInput, AgendaPauseErrors, AgendaPauseResponses, AgendaRemoveErrors, AgendaRemoveResponses, AgendaRunsErrors, AgendaRunsResponses, AgendaSessionsErrors, AgendaSessionsResponses, AgendaTriggerErrors, AgendaTriggerResponses, AgendaUpdateErrors, AgendaUpdateResponses, AgendaWebhookErrors, AgendaWebhookResponses, AppAgentsResponses, AppLogErrors, AppLogResponses, AssetGetErrors, AssetGetResponses, AssetUploadErrors, AssetUploadResponses, Auth as Auth2, AuthSetErrors, AuthSetResponses, ChannelAppResetResponses, ChannelAppSessionResponses, ChannelDisconnectResponses, ChannelGenesisResetResponses, ChannelGenesisSessionResponses, ChannelStartOneResponses, ChannelStartResponses, ChannelStatusResponses, ChannelStopOneResponses, ChannelStopResponses, CommandListResponses, Config as Config2, ConfigGetResponses, ConfigGlobalResponses, ConfigProvidersResponses, ConfigSetActivateErrors, ConfigSetActivateResponses, ConfigSetCreateErrors, ConfigSetCreateInput, ConfigSetCreateResponses, ConfigSetDeleteErrors, ConfigSetDeleteResponses, ConfigSetGetErrors, ConfigSetGetResponses, ConfigSetListResponses, ConfigSetName, ConfigSetRawGetErrors, ConfigSetRawGetResponses, ConfigSetRawSaveErrors, ConfigSetRawSaveInput, ConfigSetRawSaveResponses, ConfigSetRawValidateErrors, ConfigSetRawValidateInput, ConfigSetRawValidateResponses, ConfigSetUpdateErrors, ConfigSetUpdateResponses, ConfigUpdateErrors, ConfigUpdateResponses, CortexCancelErrors, CortexCancelResponses, CortexGetErrors, CortexGetResponses, CortexListErrors, CortexListResponses, CortexOutputErrors, CortexOutputResponses, EngramExperienceApplyRewardErrors, EngramExperienceApplyRewardResponses, EngramExperienceGetErrors, EngramExperienceGetResponses, EngramExperienceListResponses, EngramExperiencePageErrors, EngramExperiencePageResponses, EngramExperienceRemoveErrors, EngramExperienceRemoveResponses, EngramExperienceSearchErrors, EngramExperienceSearchResponses, EngramGetErrors, EngramGetResponses, EngramListResponses, EngramRemoveErrors, EngramRemoveResponses, EngramResetErrors, EngramResetResponses, EngramSearchErrors, EngramSearchResponses, EngramStatsErrors, EngramStatsResponses, EventSubscribeResponses, ExperienceListFilter, ExperienceListSort, ExperimentalResourceListResponses, FileListResponses, FilePartInput, FilePartSource, FileReadResponses, FileStatusResponses, FindBrowseResponses, FindFilesResponses, FindSymbolsResponses, FindTextResponses, FormatterStatusResponses, GitInitErrors, GitInitResponses, GlobalAgendaListErrors, GlobalAgendaListResponses, GlobalDisposeResponses, GlobalHealthResponses, HolosAgentsGetErrors, HolosAgentsGetResponses, HolosAgentsListResponses, HolosCallbackResponses, HolosContactAddErrors, HolosContactAddResponses, HolosContactGetErrors, HolosContactGetResponses, HolosContactListResponses, HolosContactRemoveResponses, HolosContactSendMessageErrors, HolosContactSendMessageResponses, HolosContactSessionErrors, HolosContactSessionResponses, HolosContactUpdateConfigErrors, HolosContactUpdateConfigResponses, HolosCredentialsErrors, HolosCredentialsResponses, HolosCredentialsStatusResponses, HolosFriendReplyListResponses, HolosFriendRequestCreateErrors, HolosFriendRequestCreateResponses, HolosFriendRequestListResponses, HolosFriendRequestRemoveResponses, HolosFriendRequestRespondErrors, HolosFriendRequestRespondResponses, HolosFriendRequestSendErrors, HolosFriendRequestSendResponses, HolosLoginResponses, HolosLogoutResponses, HolosPresenceResponses, HolosProfileGetResponses, HolosProfileResetResponses, HolosProfileSkipGenesisResponses, HolosProfileUpdateErrors, HolosProfileUpdateResponses, HolosQueueListResponses, HolosReconnectErrors, HolosReconnectResponses, HolosRefreshPresenceResponses, HolosStateResponses, HolosVerifyResponses, InstanceDisposeResponses, LspStatusResponses, McpAddErrors, McpAddResponses, McpAuthAuthenticateErrors, McpAuthAuthenticateResponses, McpAuthCallbackErrors, McpAuthCallbackResponses, McpAuthRemoveErrors, McpAuthRemoveResponses, McpAuthStartErrors, McpAuthStartResponses, McpConnectResponses, McpDisconnectResponses, McpLocalConfig, McpRemoteConfig, McpStatusResponses, MemoryCategory, MemoryRecallMode, NoteCreateErrors, NoteCreateInput, NoteCreateResponses, NoteExportErrors, NoteExportResponses, NoteGetErrors, NoteGetResponses, NoteListAllErrors, NoteListAllResponses, NoteListErrors, NoteListResponses, NotePatchInput, NoteRemoveErrors, NoteRemoveResponses, NoteUpdateErrors, NoteUpdateResponses, Part as Part2, PartDeleteErrors, PartDeleteResponses, PartUpdateErrors, PartUpdateResponses, PathGetResponses, PermissionIsAllowingAllErrors, PermissionIsAllowingAllResponses, PermissionListResponses, PermissionReplyErrors, PermissionReplyResponses, PermissionRespondErrors, PermissionRespondResponses, PermissionSetAllowAllErrors, PermissionSetAllowAllResponses, ProviderAuthResponses, ProviderListResponses, ProviderOauthAuthorizeErrors, ProviderOauthAuthorizeResponses, ProviderOauthCallbackErrors, ProviderOauthCallbackResponses, PtyConnectErrors, PtyConnectResponses, PtyCreateErrors, PtyCreateResponses, PtyGetErrors, PtyGetResponses, PtyListResponses, PtyRemoveErrors, PtyRemoveResponses, PtyUpdateErrors, PtyUpdateResponses, QuestionAnswer, QuestionListResponses, QuestionRejectErrors, QuestionRejectResponses, QuestionReplyErrors, QuestionReplyResponses, RewardsInfo, RuntimeReloadErrors, RuntimeReloadResponses, RuntimeReloadScope, RuntimeReloadTarget, ScopeCurrentResponses, ScopeListResponses, ScopeRemoveResponses, ScopeUpdateErrors, ScopeUpdateResponses, SessionAbortErrors, SessionAbortResponses, SessionChildrenErrors, SessionChildrenResponses, SessionCommandErrors, SessionCommandResponses, SessionCreateErrors, SessionCreateResponses, SessionDagErrors, SessionDagResponses, SessionDeleteErrors, SessionDeleteResponses, SessionDiffErrors, SessionDiffResponses, SessionExportDownloadErrors, SessionExportDownloadResponses, SessionExportEstimateErrors, SessionExportEstimateResponses, SessionExportMode, SessionForkResponses, SessionGetErrors, SessionGetResponses, SessionInitErrors, SessionInitResponses, SessionListResponses, SessionMessageErrors, SessionMessageResponses, SessionMessagesErrors, SessionMessagesResponses, SessionPromptAsyncErrors, SessionPromptAsyncResponses, SessionPromptErrors, SessionPromptResponses, SessionRevertErrors, SessionRevertResponses, SessionShellErrors, SessionShellResponses, SessionStatusErrors, SessionStatusResponses, SessionSummarizeErrors, SessionSummarizeResponses, SessionTodoErrors, SessionTodoResponses, SessionUnrevertErrors, SessionUnrevertResponses, SessionUpdateErrors, SessionUpdateResponses, SkillImportErrors, SkillImportResponses, SkillImportUrlErrors, SkillImportUrlResponses, SkillListResponses, SkillReloadResponses, SkillRemoveErrors, SkillRemoveResponses, StatsGetErrors, StatsGetResponses, StatsProgressResponses, TextPartInput, ToolIdsErrors, ToolIdsResponses, ToolListErrors, ToolListResponses, VcsGetResponses, WorktreeCreateErrors, WorktreeCreateInput, WorktreeCreateResponses, WorktreeListResponses } from "./types.gen.js";
3
3
  export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean> = Options2<TData, ThrowOnError> & {
4
4
  /**
5
5
  * You can provide a client instance returned by `createClient()` instead of
@@ -40,6 +40,20 @@ export declare class Agenda extends HeyApiClient {
40
40
  webhook<ThrowOnError extends boolean = false>(parameters: {
41
41
  token: string;
42
42
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<AgendaWebhookResponses, AgendaWebhookErrors, ThrowOnError, "fields">;
43
+ /**
44
+ * Browse agenda activity
45
+ *
46
+ * Browse agenda execution activity with pagination, optional search, and agenda/session metadata.
47
+ */
48
+ activity<ThrowOnError extends boolean = false>(parameters?: {
49
+ directory?: string;
50
+ scopeID?: string;
51
+ itemID?: string;
52
+ query?: string;
53
+ search?: string;
54
+ offset?: number;
55
+ limit?: number;
56
+ }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<AgendaActivityResponses, AgendaActivityErrors, ThrowOnError, "fields">;
43
57
  /**
44
58
  * List sessions for agenda item
45
59
  *
@@ -796,13 +810,17 @@ export declare class Session extends HeyApiClient {
796
810
  /**
797
811
  * List sessions
798
812
  *
799
- * Get a list of all Synergy sessions, sorted by most recently updated.
813
+ * Get a paginated list of Synergy sessions, sorted by most recently updated.
800
814
  */
801
815
  list<ThrowOnError extends boolean = false>(parameters?: {
802
816
  directory?: string;
803
- start?: number;
804
- search?: string;
817
+ offset?: number;
805
818
  limit?: number;
819
+ search?: string;
820
+ since?: number;
821
+ before?: number;
822
+ pinned?: boolean;
823
+ parentOnly?: boolean;
806
824
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<SessionListResponses, unknown, ThrowOnError, "fields">;
807
825
  /**
808
826
  * Create session
@@ -1453,13 +1471,14 @@ export declare class Experience extends HeyApiClient {
1453
1471
  }
1454
1472
  export declare class Engram extends HeyApiClient {
1455
1473
  /**
1456
- * Get memory stats
1474
+ * Get engram stats
1457
1475
  *
1458
- * Get statistics about the memory database including counts and file size.
1476
+ * Get statistics about the engram database. By default returns a summary with counts and DB size. Use ?recompute=true to force a full analytics recompute and return the extended snapshot.
1459
1477
  */
1460
1478
  stats<ThrowOnError extends boolean = false>(parameters?: {
1461
1479
  directory?: string;
1462
- }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<EngramStatsResponses, unknown, ThrowOnError, "fields">;
1480
+ recompute?: "true" | "false";
1481
+ }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<EngramStatsResponses, EngramStatsErrors, ThrowOnError, "fields">;
1463
1482
  /**
1464
1483
  * Search memories
1465
1484
  *
@@ -1598,6 +1617,25 @@ export declare class Asset extends HeyApiClient {
1598
1617
  directory?: string;
1599
1618
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<AssetGetResponses, AssetGetErrors, ThrowOnError, "fields">;
1600
1619
  }
1620
+ export declare class Stats extends HeyApiClient {
1621
+ /**
1622
+ * Get stats snapshot
1623
+ *
1624
+ * Get the full stats snapshot. Returns cached snapshot if available, otherwise computes incrementally. Use ?recompute=true to force a full recompute from scratch.
1625
+ */
1626
+ get<ThrowOnError extends boolean = false>(parameters?: {
1627
+ directory?: string;
1628
+ recompute?: "true" | "false";
1629
+ }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<StatsGetResponses, StatsGetErrors, ThrowOnError, "fields">;
1630
+ /**
1631
+ * Stream stats recompute progress
1632
+ *
1633
+ * Force a stats recompute and stream progress updates over SSE until the final snapshot is ready.
1634
+ */
1635
+ progress<ThrowOnError extends boolean = false>(parameters?: {
1636
+ directory?: string;
1637
+ }, options?: Options<never, ThrowOnError>): Promise<import("./core/serverSentEvents.gen.js").ServerSentEventsResult<StatsProgressResponses, unknown>>;
1638
+ }
1601
1639
  export declare class App extends HeyApiClient {
1602
1640
  /**
1603
1641
  * Write log
@@ -1873,6 +1911,7 @@ export declare class SynergyClient extends HeyApiClient {
1873
1911
  engram: Engram;
1874
1912
  note: Note;
1875
1913
  asset: Asset;
1914
+ stats: Stats;
1876
1915
  app: App;
1877
1916
  mcp: Mcp;
1878
1917
  channel: Channel;
@@ -46,6 +46,31 @@ export class Agenda extends HeyApiClient {
46
46
  ...params,
47
47
  });
48
48
  }
49
+ /**
50
+ * Browse agenda activity
51
+ *
52
+ * Browse agenda execution activity with pagination, optional search, and agenda/session metadata.
53
+ */
54
+ activity(parameters, options) {
55
+ const params = buildClientParams([parameters], [
56
+ {
57
+ args: [
58
+ { in: "query", key: "directory" },
59
+ { in: "query", key: "scopeID" },
60
+ { in: "query", key: "itemID" },
61
+ { in: "query", key: "query" },
62
+ { in: "query", key: "search" },
63
+ { in: "query", key: "offset" },
64
+ { in: "query", key: "limit" },
65
+ ],
66
+ },
67
+ ]);
68
+ return (options?.client ?? this.client).get({
69
+ url: "/agenda/activity",
70
+ ...options,
71
+ ...params,
72
+ });
73
+ }
49
74
  /**
50
75
  * List sessions for agenda item
51
76
  *
@@ -1585,16 +1610,20 @@ export class Session extends HeyApiClient {
1585
1610
  /**
1586
1611
  * List sessions
1587
1612
  *
1588
- * Get a list of all Synergy sessions, sorted by most recently updated.
1613
+ * Get a paginated list of Synergy sessions, sorted by most recently updated.
1589
1614
  */
1590
1615
  list(parameters, options) {
1591
1616
  const params = buildClientParams([parameters], [
1592
1617
  {
1593
1618
  args: [
1594
1619
  { in: "query", key: "directory" },
1595
- { in: "query", key: "start" },
1596
- { in: "query", key: "search" },
1620
+ { in: "query", key: "offset" },
1597
1621
  { in: "query", key: "limit" },
1622
+ { in: "query", key: "search" },
1623
+ { in: "query", key: "since" },
1624
+ { in: "query", key: "before" },
1625
+ { in: "query", key: "pinned" },
1626
+ { in: "query", key: "parentOnly" },
1598
1627
  ],
1599
1628
  },
1600
1629
  ]);
@@ -2909,12 +2938,19 @@ export class Experience extends HeyApiClient {
2909
2938
  }
2910
2939
  export class Engram extends HeyApiClient {
2911
2940
  /**
2912
- * Get memory stats
2941
+ * Get engram stats
2913
2942
  *
2914
- * Get statistics about the memory database including counts and file size.
2943
+ * Get statistics about the engram database. By default returns a summary with counts and DB size. Use ?recompute=true to force a full analytics recompute and return the extended snapshot.
2915
2944
  */
2916
2945
  stats(parameters, options) {
2917
- const params = buildClientParams([parameters], [{ args: [{ in: "query", key: "directory" }] }]);
2946
+ const params = buildClientParams([parameters], [
2947
+ {
2948
+ args: [
2949
+ { in: "query", key: "directory" },
2950
+ { in: "query", key: "recompute" },
2951
+ ],
2952
+ },
2953
+ ]);
2918
2954
  return (options?.client ?? this.client).get({
2919
2955
  url: "/engram/stats",
2920
2956
  ...options,
@@ -3227,6 +3263,41 @@ export class Asset extends HeyApiClient {
3227
3263
  });
3228
3264
  }
3229
3265
  }
3266
+ export class Stats extends HeyApiClient {
3267
+ /**
3268
+ * Get stats snapshot
3269
+ *
3270
+ * Get the full stats snapshot. Returns cached snapshot if available, otherwise computes incrementally. Use ?recompute=true to force a full recompute from scratch.
3271
+ */
3272
+ get(parameters, options) {
3273
+ const params = buildClientParams([parameters], [
3274
+ {
3275
+ args: [
3276
+ { in: "query", key: "directory" },
3277
+ { in: "query", key: "recompute" },
3278
+ ],
3279
+ },
3280
+ ]);
3281
+ return (options?.client ?? this.client).get({
3282
+ url: "/stats",
3283
+ ...options,
3284
+ ...params,
3285
+ });
3286
+ }
3287
+ /**
3288
+ * Stream stats recompute progress
3289
+ *
3290
+ * Force a stats recompute and stream progress updates over SSE until the final snapshot is ready.
3291
+ */
3292
+ progress(parameters, options) {
3293
+ const params = buildClientParams([parameters], [{ args: [{ in: "query", key: "directory" }] }]);
3294
+ return (options?.client ?? this.client).sse.get({
3295
+ url: "/stats/progress",
3296
+ ...options,
3297
+ ...params,
3298
+ });
3299
+ }
3300
+ }
3230
3301
  export class App extends HeyApiClient {
3231
3302
  /**
3232
3303
  * Write log
@@ -3717,6 +3788,7 @@ export class SynergyClient extends HeyApiClient {
3717
3788
  engram = new Engram({ client: this.client });
3718
3789
  note = new Note({ client: this.client });
3719
3790
  asset = new Asset({ client: this.client });
3791
+ stats = new Stats({ client: this.client });
3720
3792
  app = new App({ client: this.client });
3721
3793
  mcp = new Mcp({ client: this.client });
3722
3794
  channel = new Channel({ client: this.client });
@@ -834,7 +834,7 @@ export type ProviderConfig = {
834
834
  */
835
835
  setCacheKey?: boolean;
836
836
  /**
837
- * Timeout in milliseconds for requests to this provider. Default is 300000 (5 minutes). Set to false to disable timeout.
837
+ * Timeout in milliseconds for requests to this provider. Default is 900000 (15 minutes). Set to false to disable timeout.
838
838
  */
839
839
  timeout?: number | false;
840
840
  [key: string]: unknown | string | boolean | number | false | undefined;
@@ -1775,6 +1775,10 @@ export type Session = {
1775
1775
  agenda?: {
1776
1776
  itemID: string;
1777
1777
  };
1778
+ lastExchange?: {
1779
+ user?: string;
1780
+ assistant?: string;
1781
+ };
1778
1782
  revert?: {
1779
1783
  messageID: string;
1780
1784
  partID?: string;
@@ -2020,6 +2024,14 @@ export type ToolStatePending = {
2020
2024
  };
2021
2025
  raw: string;
2022
2026
  };
2027
+ export type ToolStateGenerating = {
2028
+ status: "generating";
2029
+ input: {
2030
+ [key: string]: unknown;
2031
+ };
2032
+ raw: string;
2033
+ charsReceived: number;
2034
+ };
2023
2035
  export type ToolStateRunning = {
2024
2036
  status: "running";
2025
2037
  input: {
@@ -2064,7 +2076,7 @@ export type ToolStateError = {
2064
2076
  end: number;
2065
2077
  };
2066
2078
  };
2067
- export type ToolState = ToolStatePending | ToolStateRunning | ToolStateCompleted | ToolStateError;
2079
+ export type ToolState = ToolStatePending | ToolStateGenerating | ToolStateRunning | ToolStateCompleted | ToolStateError;
2068
2080
  export type ToolPart = {
2069
2081
  id: string;
2070
2082
  sessionID: string;
@@ -2464,10 +2476,6 @@ export type MemoryInfo = {
2464
2476
  createdAt: number;
2465
2477
  updatedAt: number;
2466
2478
  };
2467
- export type AgendaSessionList = Array<{
2468
- sessionID: string;
2469
- scopeID: string;
2470
- }>;
2471
2479
  export type AgendaRunLog = {
2472
2480
  /**
2473
2481
  * Run identifier
@@ -2499,6 +2507,51 @@ export type AgendaRunLog = {
2499
2507
  completed?: number;
2500
2508
  };
2501
2509
  };
2510
+ export type AgendaActivityAgenda = {
2511
+ id: string;
2512
+ /**
2513
+ * Scope that owns the agenda item
2514
+ */
2515
+ scopeID: string;
2516
+ title: string;
2517
+ description?: string;
2518
+ status: "pending" | "active" | "paused" | "done" | "cancelled";
2519
+ tags?: Array<string>;
2520
+ global: boolean;
2521
+ time: {
2522
+ created: number;
2523
+ updated: number;
2524
+ };
2525
+ };
2526
+ export type AgendaActivitySession = {
2527
+ id: string;
2528
+ /**
2529
+ * Scope that owns the session
2530
+ */
2531
+ scopeID: string;
2532
+ title: string;
2533
+ time: {
2534
+ created: number;
2535
+ updated: number;
2536
+ archived?: number;
2537
+ };
2538
+ };
2539
+ export type AgendaActivityEntry = {
2540
+ run: AgendaRunLog;
2541
+ agenda: AgendaActivityAgenda;
2542
+ session?: AgendaActivitySession;
2543
+ };
2544
+ export type AgendaActivityPage = {
2545
+ items: Array<AgendaActivityEntry>;
2546
+ total: number;
2547
+ limit: number;
2548
+ offset: number;
2549
+ hasMore: boolean;
2550
+ };
2551
+ export type AgendaSessionList = Array<{
2552
+ sessionID: string;
2553
+ scopeID: string;
2554
+ }>;
2502
2555
  export type AgendaTriggerResult = {
2503
2556
  triggered: true;
2504
2557
  /**
@@ -2591,6 +2644,143 @@ export type AssetInfo = {
2591
2644
  mime: string;
2592
2645
  size: number;
2593
2646
  };
2647
+ export type StatsSnapshot = {
2648
+ overview: {
2649
+ totalSessions: number;
2650
+ activeSessions: number;
2651
+ archivedSessions: number;
2652
+ totalMessages: number;
2653
+ totalTurns: number;
2654
+ totalDays: number;
2655
+ longestStreak: number;
2656
+ currentStreak: number;
2657
+ projectCount: number;
2658
+ };
2659
+ tokenCost: {
2660
+ tokens: {
2661
+ input: number;
2662
+ output: number;
2663
+ reasoning: number;
2664
+ cache: {
2665
+ read: number;
2666
+ write: number;
2667
+ };
2668
+ };
2669
+ cost: number;
2670
+ cacheHitRate: number;
2671
+ avgCostPerTurn: number;
2672
+ avgTokensPerTurn: number;
2673
+ dailyCost: number;
2674
+ dailyTokens: number;
2675
+ };
2676
+ models: {
2677
+ models: Array<{
2678
+ providerID: string;
2679
+ modelID: string;
2680
+ messages: number;
2681
+ turns: number;
2682
+ tokens: {
2683
+ input: number;
2684
+ output: number;
2685
+ reasoning: number;
2686
+ cache: {
2687
+ read: number;
2688
+ write: number;
2689
+ };
2690
+ };
2691
+ cost: number;
2692
+ avgResponseMs: number;
2693
+ }>;
2694
+ };
2695
+ agents: {
2696
+ agents: Array<{
2697
+ agent: string;
2698
+ messages: number;
2699
+ sessions: number;
2700
+ tokens: {
2701
+ input: number;
2702
+ output: number;
2703
+ reasoning: number;
2704
+ cache: {
2705
+ read: number;
2706
+ write: number;
2707
+ };
2708
+ };
2709
+ cost: number;
2710
+ subagentInvocations: number;
2711
+ }>;
2712
+ totalSubagentCalls: number;
2713
+ };
2714
+ tools: {
2715
+ tools: Array<{
2716
+ tool: string;
2717
+ calls: number;
2718
+ successes: number;
2719
+ errors: number;
2720
+ avgDurationMs: number;
2721
+ }>;
2722
+ };
2723
+ codeChanges: {
2724
+ totalAdditions: number;
2725
+ totalDeletions: number;
2726
+ totalFiles: number;
2727
+ netLines: number;
2728
+ dailyAdditions: number;
2729
+ dailyDeletions: number;
2730
+ };
2731
+ lifecycle: {
2732
+ pinnedCount: number;
2733
+ avgTurnsPerSession: number;
2734
+ medianTurnsPerSession: number;
2735
+ compactionCount: number;
2736
+ retryCount: number;
2737
+ errorCount: number;
2738
+ errorRate: number;
2739
+ durationBuckets: {
2740
+ short: number;
2741
+ medium: number;
2742
+ long: number;
2743
+ };
2744
+ };
2745
+ channels: {
2746
+ channels: Array<{
2747
+ channel: string;
2748
+ sessions: number;
2749
+ messages: number;
2750
+ }>;
2751
+ interactiveSessions: number;
2752
+ unattendedSessions: number;
2753
+ };
2754
+ timeSeries: {
2755
+ days: Array<{
2756
+ day: string;
2757
+ sessions: number;
2758
+ turns: number;
2759
+ tokens: {
2760
+ input: number;
2761
+ output: number;
2762
+ reasoning: number;
2763
+ cache: {
2764
+ read: number;
2765
+ write: number;
2766
+ };
2767
+ };
2768
+ cost: number;
2769
+ additions: number;
2770
+ deletions: number;
2771
+ files: number;
2772
+ toolCalls: number;
2773
+ errors: number;
2774
+ }>;
2775
+ hours: Array<{
2776
+ hour: string;
2777
+ turns: number;
2778
+ }>;
2779
+ hourlyActivity: Array<number>;
2780
+ };
2781
+ computedAt: number;
2782
+ watermark: number;
2783
+ };
2594
2784
  export type HolosCredentialsStatusResponse = {
2595
2785
  exists: boolean;
2596
2786
  agentId?: string;
@@ -4219,25 +4409,46 @@ export type SessionListData = {
4219
4409
  query?: {
4220
4410
  directory?: string;
4221
4411
  /**
4222
- * Filter sessions updated on or after this timestamp (milliseconds since epoch)
4412
+ * Number of sessions to skip
4223
4413
  */
4224
- start?: number;
4414
+ offset?: number;
4415
+ /**
4416
+ * Maximum number of sessions to return
4417
+ */
4418
+ limit?: number;
4225
4419
  /**
4226
4420
  * Filter sessions by title (case-insensitive)
4227
4421
  */
4228
4422
  search?: string;
4229
4423
  /**
4230
- * Maximum number of sessions to return
4424
+ * Filter sessions updated on or after this timestamp (milliseconds since epoch)
4231
4425
  */
4232
- limit?: number;
4426
+ since?: number;
4427
+ /**
4428
+ * Filter sessions updated before this timestamp (milliseconds since epoch)
4429
+ */
4430
+ before?: number;
4431
+ /**
4432
+ * Only include pinned sessions
4433
+ */
4434
+ pinned?: boolean;
4435
+ /**
4436
+ * Only include top-level sessions (exclude subsessions). Default: true
4437
+ */
4438
+ parentOnly?: boolean;
4233
4439
  };
4234
4440
  url: "/session";
4235
4441
  };
4236
4442
  export type SessionListResponses = {
4237
4443
  /**
4238
- * List of sessions
4444
+ * Paginated list of sessions
4239
4445
  */
4240
- 200: Array<Session>;
4446
+ 200: {
4447
+ data: Array<Session>;
4448
+ total: number;
4449
+ offset: number;
4450
+ limit: number;
4451
+ };
4241
4452
  };
4242
4453
  export type SessionListResponse = SessionListResponses[keyof SessionListResponses];
4243
4454
  export type SessionCreateData = {
@@ -6022,12 +6233,23 @@ export type EngramStatsData = {
6022
6233
  path?: never;
6023
6234
  query?: {
6024
6235
  directory?: string;
6236
+ /**
6237
+ * Set to 'true' to force a full analytics recompute
6238
+ */
6239
+ recompute?: "true" | "false";
6025
6240
  };
6026
6241
  url: "/engram/stats";
6027
6242
  };
6243
+ export type EngramStatsErrors = {
6244
+ /**
6245
+ * Bad request
6246
+ */
6247
+ 400: BadRequestError;
6248
+ };
6249
+ export type EngramStatsError = EngramStatsErrors[keyof EngramStatsErrors];
6028
6250
  export type EngramStatsResponses = {
6029
6251
  /**
6030
- * Memory statistics
6252
+ * Engram statistics
6031
6253
  */
6032
6254
  200: MemoryStats;
6033
6255
  };
@@ -6181,6 +6403,52 @@ export type EngramListResponses = {
6181
6403
  200: Array<MemoryInfo>;
6182
6404
  };
6183
6405
  export type EngramListResponse = EngramListResponses[keyof EngramListResponses];
6406
+ export type AgendaActivityData = {
6407
+ body?: never;
6408
+ path?: never;
6409
+ query?: {
6410
+ directory?: string;
6411
+ /**
6412
+ * Limit activity to this scope (includes global items when provided)
6413
+ */
6414
+ scopeID?: string;
6415
+ /**
6416
+ * Limit activity to a specific agenda item
6417
+ */
6418
+ itemID?: string;
6419
+ /**
6420
+ * Optional case-insensitive text search across item, run, and session metadata
6421
+ */
6422
+ query?: string;
6423
+ /**
6424
+ * Alias for query
6425
+ */
6426
+ search?: string;
6427
+ /**
6428
+ * Page offset
6429
+ */
6430
+ offset?: number;
6431
+ /**
6432
+ * Page size
6433
+ */
6434
+ limit?: number;
6435
+ };
6436
+ url: "/agenda/activity";
6437
+ };
6438
+ export type AgendaActivityErrors = {
6439
+ /**
6440
+ * Bad request
6441
+ */
6442
+ 400: BadRequestError;
6443
+ };
6444
+ export type AgendaActivityError = AgendaActivityErrors[keyof AgendaActivityErrors];
6445
+ export type AgendaActivityResponses = {
6446
+ /**
6447
+ * Paginated agenda activity
6448
+ */
6449
+ 200: AgendaActivityPage;
6450
+ };
6451
+ export type AgendaActivityResponse = AgendaActivityResponses[keyof AgendaActivityResponses];
6184
6452
  export type AgendaSessionsData = {
6185
6453
  body?: never;
6186
6454
  path: {
@@ -6744,6 +7012,193 @@ export type AssetGetResponses = {
6744
7012
  */
6745
7013
  200: unknown;
6746
7014
  };
7015
+ export type StatsGetData = {
7016
+ body?: never;
7017
+ path?: never;
7018
+ query?: {
7019
+ directory?: string;
7020
+ /**
7021
+ * Set to 'true' to force a full recompute from scratch
7022
+ */
7023
+ recompute?: "true" | "false";
7024
+ };
7025
+ url: "/stats";
7026
+ };
7027
+ export type StatsGetErrors = {
7028
+ /**
7029
+ * Bad request
7030
+ */
7031
+ 400: BadRequestError;
7032
+ };
7033
+ export type StatsGetError = StatsGetErrors[keyof StatsGetErrors];
7034
+ export type StatsGetResponses = {
7035
+ /**
7036
+ * Stats snapshot
7037
+ */
7038
+ 200: StatsSnapshot;
7039
+ };
7040
+ export type StatsGetResponse = StatsGetResponses[keyof StatsGetResponses];
7041
+ export type StatsProgressData = {
7042
+ body?: never;
7043
+ path?: never;
7044
+ query?: {
7045
+ directory?: string;
7046
+ };
7047
+ url: "/stats/progress";
7048
+ };
7049
+ export type StatsProgressResponses = {
7050
+ /**
7051
+ * Server-sent events containing progress and final snapshot payloads
7052
+ */
7053
+ 200: {
7054
+ type: "progress" | "done" | "error";
7055
+ progress?: {
7056
+ phase: "scan" | "digest" | "bucket" | "snapshot";
7057
+ current: number;
7058
+ total: number;
7059
+ message?: string;
7060
+ };
7061
+ snapshot?: {
7062
+ overview: {
7063
+ totalSessions: number;
7064
+ activeSessions: number;
7065
+ archivedSessions: number;
7066
+ totalMessages: number;
7067
+ totalTurns: number;
7068
+ totalDays: number;
7069
+ longestStreak: number;
7070
+ currentStreak: number;
7071
+ projectCount: number;
7072
+ };
7073
+ tokenCost: {
7074
+ tokens: {
7075
+ input: number;
7076
+ output: number;
7077
+ reasoning: number;
7078
+ cache: {
7079
+ read: number;
7080
+ write: number;
7081
+ };
7082
+ };
7083
+ cost: number;
7084
+ cacheHitRate: number;
7085
+ avgCostPerTurn: number;
7086
+ avgTokensPerTurn: number;
7087
+ dailyCost: number;
7088
+ dailyTokens: number;
7089
+ };
7090
+ models: {
7091
+ models: Array<{
7092
+ providerID: string;
7093
+ modelID: string;
7094
+ messages: number;
7095
+ turns: number;
7096
+ tokens: {
7097
+ input: number;
7098
+ output: number;
7099
+ reasoning: number;
7100
+ cache: {
7101
+ read: number;
7102
+ write: number;
7103
+ };
7104
+ };
7105
+ cost: number;
7106
+ avgResponseMs: number;
7107
+ }>;
7108
+ };
7109
+ agents: {
7110
+ agents: Array<{
7111
+ agent: string;
7112
+ messages: number;
7113
+ sessions: number;
7114
+ tokens: {
7115
+ input: number;
7116
+ output: number;
7117
+ reasoning: number;
7118
+ cache: {
7119
+ read: number;
7120
+ write: number;
7121
+ };
7122
+ };
7123
+ cost: number;
7124
+ subagentInvocations: number;
7125
+ }>;
7126
+ totalSubagentCalls: number;
7127
+ };
7128
+ tools: {
7129
+ tools: Array<{
7130
+ tool: string;
7131
+ calls: number;
7132
+ successes: number;
7133
+ errors: number;
7134
+ avgDurationMs: number;
7135
+ }>;
7136
+ };
7137
+ codeChanges: {
7138
+ totalAdditions: number;
7139
+ totalDeletions: number;
7140
+ totalFiles: number;
7141
+ netLines: number;
7142
+ dailyAdditions: number;
7143
+ dailyDeletions: number;
7144
+ };
7145
+ lifecycle: {
7146
+ pinnedCount: number;
7147
+ avgTurnsPerSession: number;
7148
+ medianTurnsPerSession: number;
7149
+ compactionCount: number;
7150
+ retryCount: number;
7151
+ errorCount: number;
7152
+ errorRate: number;
7153
+ durationBuckets: {
7154
+ short: number;
7155
+ medium: number;
7156
+ long: number;
7157
+ };
7158
+ };
7159
+ channels: {
7160
+ channels: Array<{
7161
+ channel: string;
7162
+ sessions: number;
7163
+ messages: number;
7164
+ }>;
7165
+ interactiveSessions: number;
7166
+ unattendedSessions: number;
7167
+ };
7168
+ timeSeries: {
7169
+ days: Array<{
7170
+ day: string;
7171
+ sessions: number;
7172
+ turns: number;
7173
+ tokens: {
7174
+ input: number;
7175
+ output: number;
7176
+ reasoning: number;
7177
+ cache: {
7178
+ read: number;
7179
+ write: number;
7180
+ };
7181
+ };
7182
+ cost: number;
7183
+ additions: number;
7184
+ deletions: number;
7185
+ files: number;
7186
+ toolCalls: number;
7187
+ errors: number;
7188
+ }>;
7189
+ hours: Array<{
7190
+ hour: string;
7191
+ turns: number;
7192
+ }>;
7193
+ hourlyActivity: Array<number>;
7194
+ };
7195
+ computedAt: number;
7196
+ watermark: number;
7197
+ };
7198
+ message?: string;
7199
+ };
7200
+ };
7201
+ export type StatsProgressResponse = StatsProgressResponses[keyof StatsProgressResponses];
6747
7202
  export type HolosCredentialsStatusData = {
6748
7203
  body?: never;
6749
7204
  path?: never;
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://json.schemastore.org/package.json",
3
3
  "name": "@ericsanchezok/synergy-sdk",
4
- "version": "1.2.20",
4
+ "version": "1.2.22",
5
5
  "type": "module",
6
6
  "license": "MIT",
7
7
  "repository": {