@xenosystem/agent-sdk 0.9.10 → 0.9.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.
Files changed (138) hide show
  1. package/LICENSE +15 -15
  2. package/README.md +511 -511
  3. package/dist/agents/index.cjs +9 -9
  4. package/dist/agents/index.d.cts +12 -2
  5. package/dist/agents/index.d.ts +12 -2
  6. package/dist/agents/index.js +9 -9
  7. package/dist/agents/metafile-cjs.json +1 -1
  8. package/dist/agents/metafile-esm.json +1 -1
  9. package/dist/artifacts/browser.cjs +1 -1
  10. package/dist/artifacts/browser.d.cts +2 -2
  11. package/dist/artifacts/browser.d.ts +2 -2
  12. package/dist/artifacts/browser.js +1 -1
  13. package/dist/artifacts/{diff-artifact-C2tQZWcs.d.cts → diff-artifact-CmhmeSu5.d.cts} +87 -7
  14. package/dist/artifacts/{diff-artifact-C2tQZWcs.d.ts → diff-artifact-CmhmeSu5.d.ts} +87 -7
  15. package/dist/artifacts/index.cjs +8 -8
  16. package/dist/artifacts/index.d.cts +22 -5
  17. package/dist/artifacts/index.d.ts +22 -5
  18. package/dist/artifacts/index.js +8 -8
  19. package/dist/artifacts/metafile-cjs.json +1 -1
  20. package/dist/artifacts/metafile-esm.json +1 -1
  21. package/dist/automation/index.cjs +2 -2
  22. package/dist/automation/index.d.cts +98 -7
  23. package/dist/automation/index.d.ts +98 -7
  24. package/dist/automation/index.js +2 -2
  25. package/dist/automation/metafile-cjs.json +1 -1
  26. package/dist/automation/metafile-esm.json +1 -1
  27. package/dist/control-plane/index.cjs +7 -7
  28. package/dist/control-plane/index.d.cts +19 -2
  29. package/dist/control-plane/index.d.ts +19 -2
  30. package/dist/control-plane/index.js +7 -7
  31. package/dist/control-plane/metafile-cjs.json +1 -1
  32. package/dist/control-plane/metafile-esm.json +1 -1
  33. package/dist/control-room/metafile-cjs.json +1 -1
  34. package/dist/control-room/metafile-esm.json +1 -1
  35. package/dist/electron/index.cjs +143 -143
  36. package/dist/electron/index.d.cts +25 -4
  37. package/dist/electron/index.d.ts +25 -4
  38. package/dist/electron/index.js +141 -141
  39. package/dist/electron/metafile-cjs.json +1 -1
  40. package/dist/electron/metafile-esm.json +1 -1
  41. package/dist/governance/index.cjs +18 -18
  42. package/dist/governance/index.d.cts +1 -0
  43. package/dist/governance/index.d.ts +1 -0
  44. package/dist/governance/index.js +18 -18
  45. package/dist/governance/metafile-cjs.json +1 -1
  46. package/dist/governance/metafile-esm.json +1 -1
  47. package/dist/hooks/index.d.cts +10 -1
  48. package/dist/hooks/index.d.ts +10 -1
  49. package/dist/hooks/metafile-cjs.json +1 -1
  50. package/dist/hooks/metafile-esm.json +1 -1
  51. package/dist/hosted/index.cjs +1 -1
  52. package/dist/hosted/index.js +1 -1
  53. package/dist/hosted/metafile-cjs.json +1 -1
  54. package/dist/hosted/metafile-esm.json +1 -1
  55. package/dist/index.cjs +332 -332
  56. package/dist/index.d.cts +200 -25
  57. package/dist/index.d.ts +200 -25
  58. package/dist/index.js +333 -333
  59. package/dist/intelligence/metafile-cjs.json +1 -1
  60. package/dist/intelligence/metafile-esm.json +1 -1
  61. package/dist/mcp/index.cjs +17 -17
  62. package/dist/mcp/index.d.cts +1 -0
  63. package/dist/mcp/index.d.ts +1 -0
  64. package/dist/mcp/index.js +17 -17
  65. package/dist/mcp/metafile-cjs.json +1 -1
  66. package/dist/mcp/metafile-esm.json +1 -1
  67. package/dist/metafile-cjs.json +1 -1
  68. package/dist/metafile-esm.json +1 -1
  69. package/dist/oracle/index.cjs +1 -1
  70. package/dist/oracle/index.d.cts +86 -6
  71. package/dist/oracle/index.d.ts +86 -6
  72. package/dist/oracle/index.js +1 -1
  73. package/dist/oracle/metafile-cjs.json +1 -1
  74. package/dist/oracle/metafile-esm.json +1 -1
  75. package/dist/providers/index.cjs +10 -10
  76. package/dist/providers/index.d.cts +1 -0
  77. package/dist/providers/index.d.ts +1 -0
  78. package/dist/providers/index.js +10 -10
  79. package/dist/providers/metafile-cjs.json +1 -1
  80. package/dist/providers/metafile-esm.json +1 -1
  81. package/dist/recipes/index.cjs +2 -2
  82. package/dist/recipes/index.d.cts +10 -1
  83. package/dist/recipes/index.d.ts +10 -1
  84. package/dist/recipes/index.js +2 -2
  85. package/dist/recipes/metafile-cjs.json +1 -1
  86. package/dist/recipes/metafile-esm.json +1 -1
  87. package/dist/research/index.cjs +3 -3
  88. package/dist/research/index.d.cts +86 -6
  89. package/dist/research/index.d.ts +86 -6
  90. package/dist/research/index.js +3 -3
  91. package/dist/research/metafile-cjs.json +1 -1
  92. package/dist/research/metafile-esm.json +1 -1
  93. package/dist/session/index.cjs +20 -20
  94. package/dist/session/index.d.cts +1 -0
  95. package/dist/session/index.d.ts +1 -0
  96. package/dist/session/index.js +21 -21
  97. package/dist/session/metafile-cjs.json +1 -1
  98. package/dist/session/metafile-esm.json +1 -1
  99. package/dist/sharing/metafile-cjs.json +1 -1
  100. package/dist/sharing/metafile-esm.json +1 -1
  101. package/dist/skills/index.d.cts +1 -0
  102. package/dist/skills/index.d.ts +1 -0
  103. package/dist/skills/metafile-cjs.json +1 -1
  104. package/dist/skills/metafile-esm.json +1 -1
  105. package/dist/soul/metafile-cjs.json +1 -1
  106. package/dist/soul/metafile-esm.json +1 -1
  107. package/dist/terminal/metafile-cjs.json +1 -1
  108. package/dist/terminal/metafile-esm.json +1 -1
  109. package/dist/ui/index.d.cts +1 -0
  110. package/dist/ui/index.d.ts +1 -0
  111. package/dist/ui/metafile-cjs.json +1 -1
  112. package/dist/ui/metafile-esm.json +1 -1
  113. package/dist/utils/index.cjs +20 -20
  114. package/dist/utils/index.d.cts +4 -1
  115. package/dist/utils/index.d.ts +4 -1
  116. package/dist/utils/index.js +17 -17
  117. package/dist/utils/metafile-cjs.json +1 -1
  118. package/dist/utils/metafile-esm.json +1 -1
  119. package/native/mxc/LICENSE.microsoft-mxc-sdk.md +20 -20
  120. package/native/mxc/README.md +25 -25
  121. package/native/mxc/package.json +58 -58
  122. package/ownership/CLEAN_ROOM_CONTRIBUTOR_GUIDE.md +63 -63
  123. package/ownership/evidence/PROPRIETARY-COMMAND-1/implementation-record.md +77 -77
  124. package/ownership/evidence/PROPRIETARY-COMMAND-1/provenance-review.md +51 -51
  125. package/ownership/evidence/PROPRIETARY-MEDIA-1/implementation-record.md +131 -131
  126. package/ownership/evidence/PROPRIETARY-MEDIA-1/provenance-review.md +50 -50
  127. package/ownership/evidence/PROPRIETARY-PTY-1/implementation-record.md +86 -86
  128. package/ownership/evidence/PROPRIETARY-PTY-1/provenance-review.md +52 -52
  129. package/ownership/evidence/PROPRIETARY-RUNTIME-1/implementation-record.md +68 -68
  130. package/ownership/evidence/PROPRIETARY-RUNTIME-1/provenance-review.md +32 -32
  131. package/ownership/evidence/PROPRIETARY-TOOLCHAIN-1/implementation-record.md +53 -53
  132. package/ownership/evidence/PROPRIETARY-TOOLCHAIN-1/provenance-review.md +32 -32
  133. package/ownership/evidence/PROPRIETARY-UI-1/implementation-record.md +96 -96
  134. package/ownership/evidence/PROPRIETARY-UI-1/provenance-review.md +46 -46
  135. package/ownership/ownership-policy.schema.json +192 -192
  136. package/ownership/templates/clean-room-implementation-record.md +70 -70
  137. package/ownership/templates/provenance-review.md +51 -51
  138. package/package.json +23 -22
package/dist/electron/index.d.cts CHANGED
@@ -170,6 +170,7 @@ interface ToolOperationSnapshot {
170
170
  promotable: boolean;
171
171
  processId?: string;
172
172
  taskId?: string;
173
+ displayName?: string;
173
174
  pid?: number;
174
175
  commandFingerprint?: string;
175
176
  outputPath?: string;
@@ -294,7 +295,14 @@ interface Message {
294
295
  }
295
296
  type PermissionDecision = "allow" | "ask" | "deny";
296
297
  type ExecutionMode = "agent" | "chatOnly";
297
- type AgentEffortLevel = "low" | "medium" | "high" | "xhigh" | "max";
298
+ declare const AGENT_EFFORT_LEVELS: readonly [
299
+ "low",
300
+ "medium",
301
+ "high",
302
+ "xhigh",
303
+ "max"
304
+ ];
305
+ type AgentEffortLevel = (typeof AGENT_EFFORT_LEVELS)[number];
298
306
  interface PermissionRule {
299
307
  tool: string;
300
308
  pattern?: string;
@@ -680,6 +688,7 @@ interface StreamResult {
680
688
  stopReason: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
681
689
  inputTokens: number;
682
690
  outputTokens: number;
691
+ usageReported: boolean;
683
692
  }
684
693
  interface ApiRequestFailureDiagnostics {
685
694
  model: string;
@@ -834,7 +843,7 @@ interface LLMProvider {
834
843
  type QueryState = "idle" | "preparing" | "building_context" | "requesting_model" | "retrying" | "executing_tools" | "waiting_for_tool" | "evaluating_completion" | "finalizing" | "suspended" | "completed" | "failed" | "interrupted";
835
844
  type QueryWatchdogReason = "idle" | "lease" | "hard";
836
845
  type ToolOperationRuntimeEventType = "tool.operation.started" | "tool.operation.progress" | "tool.operation.promotion_requested" | "tool.operation.promoted" | "tool.operation.stalled" | "tool.operation.verifying" | "tool.operation.completed" | "tool.operation.failed" | "tool.operation.timed_out" | "tool.operation.cancelled";
837
- type XenoRuntimeEventType = "thread.started" | "turn.started" | "turn.completed" | "turn.failed" | "turn.interrupted" | "query.state" | "query.watchdog" | "provider.event" | "model.text.delta" | "context.pressure" | "context.injected" | "tool.started" | "tool.permission" | "tool.completed" | "tool.history.repaired" | "tool.failure_guard.tripped" | ToolOperationRuntimeEventType | "turn.suspended" | "turn.continuation_enqueued" | "turn.continuation_resumed" | "turn.continuation_exhausted" | "diff.completed";
846
+ type XenoRuntimeEventType = "thread.started" | "turn.started" | "turn.completed" | "turn.failed" | "turn.interrupted" | "query.state" | "query.watchdog" | "provider.event" | "model.text.delta" | "context.pressure" | "context.injected" | "context.history.compacted" | "tool.started" | "tool.permission" | "tool.completed" | "tool.history.repaired" | "tool.failure_guard.tripped" | ToolOperationRuntimeEventType | "turn.suspended" | "turn.continuation_enqueued" | "turn.continuation_resumed" | "turn.continuation_exhausted" | "diff.completed";
838
847
  interface XenoRuntimeEventBase {
839
848
  id: string;
840
849
  sequence: number;
@@ -854,7 +863,7 @@ type XenoRuntimeEvent = (XenoRuntimeEventBase & {
854
863
  effort?: string;
855
864
  promptPreview: string;
856
865
  contextBudgetTokens?: number;
857
- contextBudgetSource?: "config" | "provider" | "fallback";
866
+ contextBudgetSource?: "config" | "model" | "provider" | "fallback";
858
867
  }) | (XenoRuntimeEventBase & {
859
868
  type: "turn.completed";
860
869
  outputPreview: string;
@@ -870,7 +879,7 @@ type XenoRuntimeEvent = (XenoRuntimeEventBase & {
870
879
  iteration: number;
871
880
  contextTokens: number;
872
881
  budgetTokens: number;
873
- budgetSource: "config" | "provider" | "fallback";
882
+ budgetSource: "config" | "model" | "provider" | "fallback";
874
883
  }) | (XenoRuntimeEventBase & {
875
884
  type: "context.injected";
876
885
  messageId: string;
@@ -879,6 +888,18 @@ type XenoRuntimeEvent = (XenoRuntimeEventBase & {
879
888
  deferred: boolean;
880
889
  turnId?: string;
881
890
  iteration?: number;
891
+ }) | (XenoRuntimeEventBase & {
892
+ type: "context.history.compacted";
893
+ turnId?: string;
894
+ messagesRemoved: number;
895
+ tokensSaved: number;
896
+ beforeTokens: number;
897
+ afterTokens: number;
898
+ accounting: TokenAccountingSource;
899
+ summaryMessageId: string;
900
+ firstMessageId: string;
901
+ lastMessageId: string;
902
+ removedMessageIds: string[];
882
903
  }) | (XenoRuntimeEventBase & {
883
904
  type: "turn.failed" | "turn.interrupted";
884
905
  error: string;
package/dist/electron/index.d.ts CHANGED
@@ -170,6 +170,7 @@ interface ToolOperationSnapshot {
170
170
  promotable: boolean;
171
171
  processId?: string;
172
172
  taskId?: string;
173
+ displayName?: string;
173
174
  pid?: number;
174
175
  commandFingerprint?: string;
175
176
  outputPath?: string;
@@ -294,7 +295,14 @@ interface Message {
294
295
  }
295
296
  type PermissionDecision = "allow" | "ask" | "deny";
296
297
  type ExecutionMode = "agent" | "chatOnly";
297
- type AgentEffortLevel = "low" | "medium" | "high" | "xhigh" | "max";
298
+ declare const AGENT_EFFORT_LEVELS: readonly [
299
+ "low",
300
+ "medium",
301
+ "high",
302
+ "xhigh",
303
+ "max"
304
+ ];
305
+ type AgentEffortLevel = (typeof AGENT_EFFORT_LEVELS)[number];
298
306
  interface PermissionRule {
299
307
  tool: string;
300
308
  pattern?: string;
@@ -680,6 +688,7 @@ interface StreamResult {
680
688
  stopReason: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
681
689
  inputTokens: number;
682
690
  outputTokens: number;
691
+ usageReported: boolean;
683
692
  }
684
693
  interface ApiRequestFailureDiagnostics {
685
694
  model: string;
@@ -834,7 +843,7 @@ interface LLMProvider {
834
843
  type QueryState = "idle" | "preparing" | "building_context" | "requesting_model" | "retrying" | "executing_tools" | "waiting_for_tool" | "evaluating_completion" | "finalizing" | "suspended" | "completed" | "failed" | "interrupted";
835
844
  type QueryWatchdogReason = "idle" | "lease" | "hard";
836
845
  type ToolOperationRuntimeEventType = "tool.operation.started" | "tool.operation.progress" | "tool.operation.promotion_requested" | "tool.operation.promoted" | "tool.operation.stalled" | "tool.operation.verifying" | "tool.operation.completed" | "tool.operation.failed" | "tool.operation.timed_out" | "tool.operation.cancelled";
837
- type XenoRuntimeEventType = "thread.started" | "turn.started" | "turn.completed" | "turn.failed" | "turn.interrupted" | "query.state" | "query.watchdog" | "provider.event" | "model.text.delta" | "context.pressure" | "context.injected" | "tool.started" | "tool.permission" | "tool.completed" | "tool.history.repaired" | "tool.failure_guard.tripped" | ToolOperationRuntimeEventType | "turn.suspended" | "turn.continuation_enqueued" | "turn.continuation_resumed" | "turn.continuation_exhausted" | "diff.completed";
846
+ type XenoRuntimeEventType = "thread.started" | "turn.started" | "turn.completed" | "turn.failed" | "turn.interrupted" | "query.state" | "query.watchdog" | "provider.event" | "model.text.delta" | "context.pressure" | "context.injected" | "context.history.compacted" | "tool.started" | "tool.permission" | "tool.completed" | "tool.history.repaired" | "tool.failure_guard.tripped" | ToolOperationRuntimeEventType | "turn.suspended" | "turn.continuation_enqueued" | "turn.continuation_resumed" | "turn.continuation_exhausted" | "diff.completed";
838
847
  interface XenoRuntimeEventBase {
839
848
  id: string;
840
849
  sequence: number;
@@ -854,7 +863,7 @@ type XenoRuntimeEvent = (XenoRuntimeEventBase & {
854
863
  effort?: string;
855
864
  promptPreview: string;
856
865
  contextBudgetTokens?: number;
857
- contextBudgetSource?: "config" | "provider" | "fallback";
866
+ contextBudgetSource?: "config" | "model" | "provider" | "fallback";
858
867
  }) | (XenoRuntimeEventBase & {
859
868
  type: "turn.completed";
860
869
  outputPreview: string;
@@ -870,7 +879,7 @@ type XenoRuntimeEvent = (XenoRuntimeEventBase & {
870
879
  iteration: number;
871
880
  contextTokens: number;
872
881
  budgetTokens: number;
873
- budgetSource: "config" | "provider" | "fallback";
882
+ budgetSource: "config" | "model" | "provider" | "fallback";
874
883
  }) | (XenoRuntimeEventBase & {
875
884
  type: "context.injected";
876
885
  messageId: string;
@@ -879,6 +888,18 @@ type XenoRuntimeEvent = (XenoRuntimeEventBase & {
879
888
  deferred: boolean;
880
889
  turnId?: string;
881
890
  iteration?: number;
891
+ }) | (XenoRuntimeEventBase & {
892
+ type: "context.history.compacted";
893
+ turnId?: string;
894
+ messagesRemoved: number;
895
+ tokensSaved: number;
896
+ beforeTokens: number;
897
+ afterTokens: number;
898
+ accounting: TokenAccountingSource;
899
+ summaryMessageId: string;
900
+ firstMessageId: string;
901
+ lastMessageId: string;
902
+ removedMessageIds: string[];
882
903
  }) | (XenoRuntimeEventBase & {
883
904
  type: "turn.failed" | "turn.interrupted";
884
905
  error: string;