@xenosystem/agent-sdk 0.9.22 → 0.9.25

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 (54) hide show
  1. package/README.md +12 -5
  2. package/dist/artifacts/index.cjs +1 -1
  3. package/dist/artifacts/index.js +1 -1
  4. package/dist/automation/index.cjs +16 -3
  5. package/dist/automation/index.d.cts +342 -1
  6. package/dist/automation/index.d.ts +342 -1
  7. package/dist/automation/index.js +16 -3
  8. package/dist/automation/metafile-cjs.json +1 -1
  9. package/dist/automation/metafile-esm.json +1 -1
  10. package/dist/control-plane/index.cjs +1 -1
  11. package/dist/control-plane/index.js +1 -1
  12. package/dist/control-room/index.d.cts +1 -1
  13. package/dist/control-room/index.d.ts +1 -1
  14. package/dist/control-room/metafile-cjs.json +1 -1
  15. package/dist/control-room/metafile-esm.json +1 -1
  16. package/dist/coordination/index.cjs +2 -0
  17. package/dist/coordination/index.d.cts +395 -0
  18. package/dist/coordination/index.d.ts +395 -0
  19. package/dist/coordination/index.js +2 -0
  20. package/dist/coordination/metafile-cjs.json +1 -0
  21. package/dist/coordination/metafile-esm.json +1 -0
  22. package/dist/electron/index.cjs +113 -113
  23. package/dist/electron/index.d.cts +9 -1
  24. package/dist/electron/index.d.ts +9 -1
  25. package/dist/electron/index.js +113 -113
  26. package/dist/electron/metafile-cjs.json +1 -1
  27. package/dist/electron/metafile-esm.json +1 -1
  28. package/dist/governance/index.d.cts +2 -0
  29. package/dist/governance/index.d.ts +2 -0
  30. package/dist/hosted/index.cjs +1 -1
  31. package/dist/hosted/index.js +1 -1
  32. package/dist/hosted/metafile-cjs.json +1 -1
  33. package/dist/hosted/metafile-esm.json +1 -1
  34. package/dist/index.cjs +357 -355
  35. package/dist/index.d.cts +1911 -1355
  36. package/dist/index.d.ts +1911 -1355
  37. package/dist/index.js +357 -355
  38. package/dist/mcp/index.d.cts +3 -0
  39. package/dist/mcp/index.d.ts +3 -0
  40. package/dist/metafile-cjs.json +1 -1
  41. package/dist/metafile-esm.json +1 -1
  42. package/dist/session/index.cjs +24 -24
  43. package/dist/session/index.d.cts +9 -1
  44. package/dist/session/index.d.ts +9 -1
  45. package/dist/session/index.js +24 -24
  46. package/dist/session/metafile-cjs.json +1 -1
  47. package/dist/session/metafile-esm.json +1 -1
  48. package/dist/skills/index.d.cts +3 -0
  49. package/dist/skills/index.d.ts +3 -0
  50. package/dist/ui/index.d.cts +2 -0
  51. package/dist/ui/index.d.ts +2 -0
  52. package/dist/utils/index.d.cts +2 -0
  53. package/dist/utils/index.d.ts +2 -0
  54. package/package.json +15 -1
package/dist/index.d.cts CHANGED
@@ -1,3 +1,5 @@
1
+ import { WebJobProgress, WebJobProgressListener } from "@xenosystem/web-context-client/progress";
2
+ export { WebJobProgress, WebJobProgressListener } from "@xenosystem/web-context-client/progress";
1
3
  import { Readable, Writable } from "node:stream";
2
4
  import { ChildProcess } from "node:child_process";
3
5
  type TokenEstimator = (text: string, model: string) => number;
@@ -136,6 +138,16 @@ interface WebContextToolResult {
136
138
  mediaType: string;
137
139
  bytes: number;
138
140
  };
141
+ jobProgress?: WebJobProgress;
142
+ }
143
+ interface WebContextWaitPortOptions {
144
+ timeoutMs?: number;
145
+ pollMs?: number;
146
+ signal?: AbortSignal;
147
+ onProgress?: WebJobProgressListener;
148
+ cancelOnAbort?: boolean;
149
+ cancelOnTimeout?: boolean;
150
+ cancelConfirmationMs?: number;
139
151
  }
140
152
  interface WebContextClientPort {
141
153
  search(request: WebContextRequestBase & {
@@ -157,11 +169,7 @@ interface WebContextClientPort {
157
169
  scrapeAndWait(request: WebContextRequestBase & {
158
170
  url: string;
159
171
  format?: "text" | "markdown";
160
- }, options?: {
161
- timeoutMs?: number;
162
- pollMs?: number;
163
- signal?: AbortSignal;
164
- }): Promise<{
172
+ }, options?: WebContextWaitPortOptions): Promise<{
165
173
  job: {
166
174
  jobId: string;
167
175
  state: string;
@@ -339,6 +347,7 @@ interface ToolProgressUpdate {
339
347
  bytes?: number;
340
348
  outputBytes?: number;
341
349
  nextOffset?: number;
350
+ webContextProgress?: WebJobProgress;
342
351
  }
343
352
  interface ToolAuthorizationReceipt {
344
353
  turnId: string;
@@ -659,6 +668,7 @@ interface ContextCompressedData {
659
668
  messagesRemoved: number;
660
669
  tokensSaved: number;
661
670
  compaction?: CompactionRecord;
671
+ activeContextMessages?: Message[];
662
672
  }
663
673
  interface SessionEndData {
664
674
  reason: "user_exit" | "error" | "completed";
@@ -771,7 +781,7 @@ interface PolicyEnforcerConfig {
771
781
  };
772
782
  }
773
783
  type AgentSandbox = PolicyEnforcerConfig;
774
- declare const SDK_VERSION = "0.9.22";
784
+ declare const SDK_VERSION = "0.9.25";
775
785
  type AuditRiskLevel = "none" | "low" | "medium" | "high" | "critical";
776
786
  type AuditDecision = "allow" | "ask" | "deny";
777
787
  type AuditStatus = "ok" | "error";
@@ -2205,1498 +2215,1645 @@ declare class XenoLoopbackAutomationAdapter implements XenoAutomationAdapter {
2205
2215
  stop(operationId: string, reason: string): Promise<void>;
2206
2216
  private request;
2207
2217
  }
2208
- interface XenoGovernedAutomationToolExecution {
2209
- operation: XenoAutomationOperation;
2210
- governingToolName: string;
2211
- operationId: string;
2212
- idempotencyKey: string;
2213
- parameters: Record<string, unknown>;
2214
- declaredTarget?: XenoAutomationTarget;
2215
- authorization: ToolAuthorizationReceipt;
2216
- signal?: AbortSignal;
2217
- reportProgress?: ToolExecutionContext["reportProgress"];
2218
- }
2219
- interface XenoGovernedAutomationToolRuntime {
2220
- execute(input: XenoGovernedAutomationToolExecution): Promise<XenoAutomationExecutionResult>;
2221
- stop?(operationId: string, reason?: string): Promise<boolean> | boolean;
2218
+ declare const XENO_BROWSER_CONTROL_PLANE_OPERATIONS: readonly [
2219
+ "browser.navigate",
2220
+ "browser.back",
2221
+ "browser.forward",
2222
+ "browser.reload",
2223
+ "browser.wait",
2224
+ "browser.snapshot",
2225
+ "browser.screenshot",
2226
+ "browser.locate",
2227
+ "browser.tabs.list",
2228
+ "browser.tabs.open",
2229
+ "browser.console.read",
2230
+ "browser.network.read",
2231
+ "browser.storage.read",
2232
+ "browser.page-errors.read",
2233
+ "browser.click",
2234
+ "browser.type",
2235
+ "browser.key",
2236
+ "browser.select",
2237
+ "browser.scroll",
2238
+ "browser.tabs.close",
2239
+ "browser.upload",
2240
+ "browser.download"
2241
+ ];
2242
+ interface XenoBrowserControlPlaneAdapterOptions {
2243
+ baseUrl: string;
2244
+ token: string;
2245
+ driver: "browser" | "extension";
2246
+ fetch?: typeof globalThis.fetch;
2247
+ timeoutMs?: number;
2222
2248
  }
2223
- interface CreateXenoGovernedAutomationToolsOptions {
2224
- runtime: XenoGovernedAutomationToolRuntime;
2225
- operations?: readonly XenoAutomationOperation[];
2249
+ declare class XenoBrowserControlPlaneAdapter implements XenoAutomationAdapter {
2250
+ private readonly options;
2251
+ private readonly base;
2252
+ private readonly fetchImpl;
2253
+ private readonly timeoutMs;
2254
+ constructor(options: XenoBrowserControlPlaneAdapterOptions);
2255
+ manifest(): Promise<XenoAutomationAdapterManifest>;
2256
+ preflight(request: XenoAutomationRequest, signal: AbortSignal): Promise<XenoAutomationPreflight>;
2257
+ execute(request: XenoAutomationRequest, preflight: XenoAutomationPreflight, _grant: XenoAutomationExecutionGrant, signal: AbortSignal): Promise<XenoAutomationAdapterExecutionResult>;
2258
+ stop(_operationId: string, _reason: string): Promise<void>;
2259
+ private resultEvidence;
2260
+ private snapshotEvidence;
2261
+ private call;
2226
2262
  }
2227
- declare function createXenoGovernedAutomationTools(options: CreateXenoGovernedAutomationToolsOptions): RegisteredTool[];
2228
- interface XenoArtifactValidationIssue {
2263
+ interface MemoryFile {
2264
+ level: MemoryLevel;
2229
2265
  path: string;
2230
- code: string;
2231
- message: string;
2232
- }
2233
- declare class XenoArtifactValidationError extends Error {
2234
- readonly code = "ARTIFACT_INVALID";
2235
- readonly issues: XenoArtifactValidationIssue[];
2236
- constructor(message: string, issues: XenoArtifactValidationIssue[]);
2237
- }
2238
- declare class XenoArtifactStateTransitionError extends Error {
2239
- readonly fromState: XenoArtifactState;
2240
- readonly toState: XenoArtifactState;
2241
- readonly code = "ARTIFACT_STATE_TRANSITION_INVALID";
2242
- constructor(fromState: XenoArtifactState, toState: XenoArtifactState);
2243
- }
2244
- declare function validateXenoArtifact(artifact: XenoArtifactEnvelope): XenoArtifactValidationIssue[];
2245
- declare function assertValidXenoArtifact(artifact: XenoArtifactEnvelope): void;
2246
- declare function canTransitionXenoArtifactState(fromState: XenoArtifactState, toState: XenoArtifactState): boolean;
2247
- declare function assertXenoArtifactStateTransition(fromState: XenoArtifactState, toState: XenoArtifactState): void;
2248
- declare function validateXenoArtifactReviewEvent(event: XenoArtifactReviewEvent, artifact?: XenoArtifactEnvelope): XenoArtifactValidationIssue[];
2249
- declare function summarizeXenoArtifactReview(events: readonly XenoArtifactReviewEvent[]): XenoArtifactReviewSummary;
2250
- declare function sha256ArtifactBytes(content: Uint8Array | string): XenoContentHash;
2251
- declare function canonicalizeArtifactJson(value: XenoJsonValue): string;
2252
- declare function sha256ArtifactJson(value: XenoJsonValue): XenoContentHash;
2253
- declare class XenoEvidenceGraphValidationError extends Error {
2254
- readonly code = "EVIDENCE_GRAPH_INVALID";
2255
- readonly issues: XenoArtifactValidationIssue[];
2256
- constructor(issues: XenoArtifactValidationIssue[]);
2266
+ content: string;
2267
+ tokenCount: number;
2268
+ lastModified?: Date;
2257
2269
  }
2258
- declare function validateXenoEvidenceGraph(graph: XenoEvidenceGraph): XenoArtifactValidationIssue[];
2259
- declare function assertValidXenoEvidenceGraph(graph: XenoEvidenceGraph): void;
2260
- interface XenoEvidenceGraphBuilderOptions {
2261
- graphId: string;
2262
- now?: () => string;
2270
+ interface ResolvedMemory {
2271
+ files: MemoryFile[];
2272
+ byLevel: Record<MemoryLevel, string>;
2273
+ totalTokens: number;
2274
+ truncated: boolean;
2263
2275
  }
2264
- declare class XenoEvidenceGraphBuilder {
2265
- private readonly now;
2266
- private graph;
2267
- constructor(options: XenoEvidenceGraphBuilderOptions | XenoEvidenceGraph);
2268
- addNode(node: XenoEvidenceNode): this;
2269
- addEdge(edge: XenoEvidenceEdge): this;
2270
- build(): XenoEvidenceGraph;
2271
- private touch;
2276
+ interface ProjectSessionContextEntry {
2277
+ sessionId: string;
2278
+ model: string;
2279
+ lastActivity: string;
2280
+ messageCount: number;
2281
+ excerpt: string;
2272
2282
  }
2273
- declare const XENO_ARTIFACT_FILE_REPOSITORY_SCHEMA_VERSION: 1;
2274
- interface XenoArtifactFileSnapshotPayload {
2275
- schemaVersion: typeof XENO_ARTIFACT_FILE_REPOSITORY_SCHEMA_VERSION;
2276
- generation: number;
2277
- createdAt: string;
2278
- updatedAt: string;
2279
- state: XenoArtifactRepositoryState;
2283
+ interface ProjectSessionContext {
2284
+ entries: ProjectSessionContextEntry[];
2285
+ totalTokens: number;
2286
+ truncated: boolean;
2287
+ content: string;
2280
2288
  }
2281
- interface XenoArtifactFileSnapshot extends XenoArtifactFileSnapshotPayload {
2282
- checksum: {
2283
- algorithm: "sha256";
2284
- value: string;
2289
+ declare const DEFAULT_MEMORY_BUDGETS: MemoryBudget;
2290
+ declare const MEMORY_FILES: Record<MemoryLevel, string>;
2291
+ interface MemoryManagerOptions {
2292
+ cwd: string;
2293
+ globalDir?: string;
2294
+ role?: string;
2295
+ sessionDir?: string;
2296
+ scope?: MemoryAccessScope;
2297
+ budgets?: Partial<MemoryBudget>;
2298
+ projectSessionContext?: {
2299
+ limit?: number;
2300
+ maxTokens?: number;
2301
+ maxCharsPerSession?: number;
2285
2302
  };
2286
2303
  }
2287
- interface XenoArtifactFileRecoveryNotice {
2288
- snapshotPath: string;
2289
- backupPath: string;
2290
- reason: string;
2304
+ type MemoryAccessScope = "none" | "session" | "project" | "user";
2305
+ declare class MemoryManager {
2306
+ private cwd;
2307
+ private globalDir;
2308
+ private role?;
2309
+ private sessionDir?;
2310
+ private scope;
2311
+ private budgets;
2312
+ private projectSessionContextDefaults;
2313
+ constructor(options: MemoryManagerOptions);
2314
+ get accessScope(): MemoryAccessScope;
2315
+ canAccessLevel(level: MemoryLevel): boolean;
2316
+ private assertLevelAccess;
2317
+ getProjectSessionContextDefaults(): {
2318
+ limit: number;
2319
+ maxTokens: number;
2320
+ maxCharsPerSession: number;
2321
+ };
2322
+ getPath(level: MemoryLevel): string;
2323
+ loadForPrompt(): Promise<ResolvedMemory>;
2324
+ loadProjectSessionContext(options?: {
2325
+ excludeSessionId?: string;
2326
+ limit?: number;
2327
+ maxTokens?: number;
2328
+ maxCharsPerSession?: number;
2329
+ }): Promise<ProjectSessionContext>;
2330
+ private filterProjectSessions;
2331
+ private normalizePath;
2332
+ private extractRecentTranscriptExcerpt;
2333
+ private formatProjectSessionEntry;
2334
+ add(level: MemoryLevel, content: string, source: "user" | "auto"): Promise<void>;
2335
+ set(level: MemoryLevel, content: string): Promise<void>;
2336
+ formatForPrompt(memory: ResolvedMemory): string;
2337
+ private truncateContent;
2291
2338
  }
2292
- interface FileXenoArtifactRepositoryOptions {
2293
- directory: string;
2294
- snapshotFileName?: string;
2295
- lockTimeoutMs?: number;
2296
- lockRetryMs?: number;
2297
- maxSnapshotBytes?: number;
2298
- now?: () => string;
2299
- onRecovery?: (notice: XenoArtifactFileRecoveryNotice) => void;
2339
+ interface AutoMemoryContext {
2340
+ error?: string;
2341
+ correction?: string;
2342
+ taskCompleted?: boolean;
2343
+ userPreference?: string;
2300
2344
  }
2301
- declare class FileXenoArtifactRepository implements XenoArtifactRepository {
2302
- readonly directory: string;
2303
- readonly snapshotPath: string;
2304
- readonly backupPath: string;
2305
- readonly lockPath: string;
2306
- private readonly now;
2307
- private readonly lockTimeoutMs;
2308
- private readonly lockRetryMs;
2309
- private readonly maxSnapshotBytes;
2310
- private readonly onRecovery?;
2311
- private mutationTail;
2312
- constructor(options: FileXenoArtifactRepositoryOptions);
2313
- create(artifact: XenoArtifactEnvelope): Promise<XenoArtifactRecord>;
2314
- createRevision(artifact: XenoArtifactEnvelope, options?: XenoArtifactRevisionOptions): Promise<XenoArtifactRecord>;
2315
- get(artifactId: string, revision?: number): Promise<XenoArtifactRecord | undefined>;
2316
- require(artifactId: string, revision?: number): Promise<XenoArtifactRecord>;
2317
- list(query?: XenoArtifactListQuery): Promise<XenoArtifactRecord[]>;
2318
- listRevisions(artifactId: string): Promise<XenoArtifactRecord[]>;
2319
- transition(request: XenoArtifactTransitionRequest): Promise<XenoArtifactRecord>;
2320
- appendReviewEvent(request: XenoArtifactAppendReviewRequest): Promise<XenoArtifactRecord>;
2321
- inspectSnapshot(): Promise<XenoArtifactFileSnapshot | undefined>;
2322
- private mutate;
2323
- private enqueueMutation;
2324
- private acquireLock;
2325
- private load;
2326
- private persist;
2327
- private readSnapshot;
2345
+ declare class AutoMemory {
2346
+ private manager;
2347
+ private recentErrors;
2348
+ constructor(manager: MemoryManager);
2349
+ shouldTrigger(context: AutoMemoryContext): AutoMemoryTrigger | null;
2350
+ extract(trigger: AutoMemoryTrigger, messages: Message[]): Promise<string | null>;
2351
+ private extractErrorCorrection;
2352
+ private extractPattern;
2353
+ private extractPreference;
2354
+ private extractTaskSummary;
2355
+ private messagesToText;
2356
+ private normalizeError;
2328
2357
  }
2329
- type XenoDiffMode = "working-tree" | "staged" | "turn" | "commit" | "preview";
2330
- type XenoDiffFileStatus = "added" | "modified" | "deleted" | "renamed" | "copied" | "binary";
2331
- type XenoDiffLineKind = "context" | "addition" | "deletion" | "no-newline";
2332
- interface XenoDiffLine {
2333
- kind: XenoDiffLineKind;
2334
- text: string;
2335
- oldLine?: number;
2336
- newLine?: number;
2358
+ interface VectorDocument {
2359
+ id: string;
2360
+ content: string;
2361
+ embedding: number[];
2362
+ metadata: Record<string, unknown>;
2337
2363
  }
2338
- interface XenoDiffHunk {
2339
- hunkId: string;
2340
- header: string;
2341
- section?: string;
2342
- oldStart: number;
2343
- oldLines: number;
2344
- newStart: number;
2345
- newLines: number;
2346
- additions: number;
2347
- deletions: number;
2348
- lines: XenoDiffLine[];
2364
+ interface VectorSearchResult {
2365
+ id: string;
2366
+ content: string;
2367
+ score: number;
2368
+ metadata: Record<string, unknown>;
2349
2369
  }
2350
- interface XenoDiffFile {
2351
- oldPath?: string;
2352
- newPath?: string;
2353
- displayPath: string;
2354
- status: XenoDiffFileStatus;
2355
- additions: number;
2356
- deletions: number;
2357
- binary: boolean;
2358
- headerLines: string[];
2359
- hunks: XenoDiffHunk[];
2370
+ interface VectorStoreOptions {
2371
+ maxDocuments?: number;
2372
+ embeddingDimension?: number;
2373
+ embedFn?: (text: string) => Promise<number[]>;
2360
2374
  }
2361
- interface XenoDiffDocument {
2362
- schemaVersion: 1;
2363
- mode: XenoDiffMode;
2364
- repositoryId?: string;
2365
- baseRef?: string;
2366
- headRef?: string;
2367
- files: XenoDiffFile[];
2368
- additions: number;
2369
- deletions: number;
2370
- rawDiff: string;
2371
- }
2372
- interface ParseUnifiedDiffOptions {
2373
- mode?: XenoDiffMode;
2374
- repositoryId?: string;
2375
- baseRef?: string;
2376
- headRef?: string;
2377
- maxBytes?: number;
2378
- maxFiles?: number;
2379
- maxHunks?: number;
2380
- maxLines?: number;
2375
+ interface VectorStoreAdapter {
2376
+ add(id: string, embedding: number[], metadata: Record<string, unknown>): Promise<void>;
2377
+ search(query: number[], topK: number): Promise<Array<{
2378
+ id: string;
2379
+ score: number;
2380
+ }>>;
2381
+ remove(id: string): Promise<void>;
2382
+ readonly size: number;
2381
2383
  }
2382
- interface XenoDiffArtifactContext {
2383
- kind?: "diff" | "patch";
2384
- artifactId?: string;
2385
- revision?: number;
2386
- predecessorRevision?: number;
2387
- createdAt?: string;
2388
- title?: string;
2389
- description?: string;
2390
- producer: XenoArtifactActor;
2391
- identity?: XenoArtifactIdentity;
2392
- sensitivity?: XenoArtifactSensitivity;
2393
- accessPolicyId?: string;
2394
- mode?: XenoDiffMode;
2395
- repositoryId?: string;
2396
- baseRef?: string;
2397
- headRef?: string;
2384
+ declare class VectorMemoryStore {
2385
+ private documents;
2386
+ private insertionOrder;
2387
+ private maxDocuments;
2388
+ private embedder;
2389
+ private customEmbedFn?;
2390
+ constructor(options?: VectorStoreOptions);
2391
+ addDocument(id: string, content: string, metadata?: Record<string, unknown>): Promise<void>;
2392
+ search(query: string, topK?: number, minScore?: number): Promise<VectorSearchResult[]>;
2393
+ removeDocument(id: string): boolean;
2394
+ getDocument(id: string): VectorDocument | undefined;
2395
+ get size(): number;
2396
+ clear(): void;
2397
+ exportDocuments(): VectorDocument[];
2398
+ importDocuments(docs: VectorDocument[]): void;
2398
2399
  }
2399
- declare class XenoDiffParseError extends Error {
2400
- readonly line?: number | undefined;
2401
- readonly code = "XENO_DIFF_INVALID";
2402
- constructor(message: string, line?: number | undefined);
2400
+ interface AskUserRequest {
2401
+ question: string;
2402
+ options?: string[];
2403
+ context?: string;
2403
2404
  }
2404
- declare function parseUnifiedDiff(diff: string, options?: ParseUnifiedDiffOptions): XenoDiffDocument;
2405
- declare function unifiedDiffToXenoArtifact(diff: string, context: XenoDiffArtifactContext): XenoArtifactEnvelope;
2406
- declare function xenoArtifactToDiffDocument(artifact: XenoArtifactEnvelope): XenoDiffDocument;
2407
- interface XenoArtifactReviewServiceOptions {
2408
- repository: XenoArtifactRepository;
2409
- actor: XenoArtifactActor;
2410
- idFactory?: () => string;
2405
+ interface AskUserResponse {
2406
+ answer: string;
2407
+ selectedOption?: string;
2411
2408
  }
2412
- interface XenoArtifactReviewAnchorInput {
2413
- file?: string;
2414
- line?: number;
2415
- hunkId?: string;
2409
+ type AskUserHandler = (request: AskUserRequest) => Promise<AskUserResponse>;
2410
+ interface DispatchAgentRequest {
2411
+ agent?: string;
2412
+ prompt: string;
2413
+ timeoutMs?: number;
2414
+ signal?: AbortSignal;
2416
2415
  }
2417
- interface AddXenoArtifactCommentRequest extends XenoArtifactReviewAnchorInput {
2418
- artifactId: string;
2419
- revision?: number;
2420
- body: string;
2421
- parentCommentId?: string;
2416
+ interface DispatchAgentResponse {
2417
+ output: string;
2422
2418
  }
2423
- interface SetXenoArtifactCommentResolutionRequest {
2424
- artifactId: string;
2425
- revision?: number;
2426
- commentId: string;
2427
- resolved: boolean;
2419
+ type DispatchAgentHandler = (request: DispatchAgentRequest) => Promise<DispatchAgentResponse>;
2420
+ interface FileObservation {
2421
+ path: string;
2422
+ mtimeMs: number;
2423
+ size: number;
2424
+ source: "read" | "write" | "edit" | "notebook" | "shell";
2425
+ requiresRefresh?: boolean;
2428
2426
  reason?: string;
2429
2427
  }
2430
- interface DecideXenoArtifactRequest extends Omit<XenoArtifactReviewAnchorInput, "line"> {
2431
- artifactId: string;
2432
- revision?: number;
2433
- decision: XenoArtifactReviewDecision;
2434
- rationale?: string;
2435
- }
2436
- declare class XenoArtifactReviewService {
2437
- private readonly repository;
2438
- private readonly actor;
2439
- private readonly idFactory;
2440
- constructor(options: XenoArtifactReviewServiceOptions);
2441
- addComment(request: AddXenoArtifactCommentRequest): Promise<XenoArtifactRecord>;
2442
- setCommentResolution(request: SetXenoArtifactCommentResolutionRequest): Promise<XenoArtifactRecord>;
2443
- decide(request: DecideXenoArtifactRequest): Promise<XenoArtifactRecord>;
2444
- }
2445
- declare function buildXenoArtifactReviewAnchor(record: XenoArtifactRecord, input: XenoArtifactReviewAnchorInput): XenoArtifactAnchor | undefined;
2446
- declare function normalizeRepositoryRelativePath(value: string): string;
2447
- declare const XENO_SPEC_SCHEMA_VERSION: "xeno.spec.v1";
2448
- declare const XENO_SPEC_EXECUTION_SCHEMA_VERSION: "xeno.spec-execution.v1";
2449
- type XenoSpecPriority = "must" | "should" | "could";
2450
- type XenoSpecTaskStatus = "pending" | "in_progress" | "completed" | "blocked" | "skipped";
2451
- type XenoSpecExecutionState = "ready" | "running" | "completed" | "failed" | "cancelled";
2452
- interface XenoSpecAcceptanceCriterion {
2453
- id: string;
2454
- text: string;
2455
- requiredEvidenceKinds?: string[];
2456
- }
2457
- interface XenoSpecRequirement {
2458
- id: string;
2459
- text: string;
2460
- priority: XenoSpecPriority;
2461
- acceptanceCriteria: XenoSpecAcceptanceCriterion[];
2462
- sourceReferences?: XenoEvidenceReference[];
2463
- }
2464
- interface XenoSpecDesignDecision {
2465
- id: string;
2466
- decision: string;
2467
- rationale: string;
2468
- alternatives?: string[];
2469
- requirementIds?: string[];
2428
+ interface ToolRuntimeContext {
2429
+ getCwd(): string;
2430
+ setCwd(nextCwd: string): void;
2431
+ getOwnerSessionId(): string | undefined;
2432
+ getMemoryManager(): MemoryManager | undefined;
2433
+ setMemoryManager(memoryManager: MemoryManager | undefined): void;
2434
+ noteFileObservation(filePath: string, observation: Omit<FileObservation, "path">): void;
2435
+ getFileObservation(filePath: string): FileObservation | undefined;
2436
+ invalidateFileObservation(filePath: string, reason: string): void;
2437
+ listFileObservations(): FileObservation[];
2438
+ askUser?(request: AskUserRequest): Promise<AskUserResponse>;
2439
+ dispatchAgent?(request: DispatchAgentRequest): Promise<DispatchAgentResponse>;
2470
2440
  }
2471
- interface XenoSpecRisk {
2441
+ declare function createToolRuntimeContext(initialCwd?: string, options?: {
2442
+ askUser?: AskUserHandler;
2443
+ dispatchAgent?: DispatchAgentHandler;
2444
+ memoryManager?: MemoryManager;
2445
+ ownerSessionId?: string;
2446
+ }): ToolRuntimeContext;
2447
+ declare const defaultToolRuntimeContext: ToolRuntimeContext;
2448
+ type HarnessTaskStatus = "pending" | "in_progress" | "completed";
2449
+ interface HarnessTask {
2472
2450
  id: string;
2451
+ subject: string;
2473
2452
  description: string;
2474
- impact: "low" | "medium" | "high" | "critical";
2475
- mitigation: string;
2453
+ status: HarnessTaskStatus;
2454
+ activeForm?: string;
2476
2455
  owner?: string;
2477
- }
2478
- interface XenoSpecDesign {
2479
- summary: string;
2480
- decisions: XenoSpecDesignDecision[];
2481
- risks: XenoSpecRisk[];
2482
- }
2483
- interface XenoSpecTask {
2484
- id: string;
2485
- title: string;
2486
- description: string;
2487
- dependsOn?: string[];
2488
- requirementIds: string[];
2489
- acceptanceCriterionIds: string[];
2490
- expectedPaths?: string[];
2491
- preferredAgentProfile?: string;
2492
- }
2493
- interface XenoSpecSourceBaseline {
2494
- repositoryId?: string;
2495
- commit?: string;
2496
- workspaceFingerprint?: XenoContentHash;
2497
- }
2498
- interface XenoSpecDocument {
2499
- schemaVersion: typeof XENO_SPEC_SCHEMA_VERSION;
2500
- specId: string;
2501
- revision: number;
2502
- title: string;
2503
- problem: string;
2504
- requirements: XenoSpecRequirement[];
2505
- design: XenoSpecDesign;
2506
- tasks: XenoSpecTask[];
2507
- acceptanceCriteria: XenoSpecAcceptanceCriterion[];
2508
- sourceBaseline?: XenoSpecSourceBaseline;
2456
+ metadata: Record<string, unknown>;
2457
+ blocks: string[];
2458
+ blockedBy: string[];
2509
2459
  createdAt: string;
2510
2460
  updatedAt: string;
2511
- predecessorRevision?: number;
2512
- }
2513
- interface XenoSpecArtifactContext {
2514
- producer: XenoArtifactActor;
2515
- identity?: XenoArtifactIdentity;
2516
- sensitivity?: XenoArtifactSensitivity;
2517
- accessPolicyId?: string;
2518
- createdAt?: string;
2519
2461
  }
2520
- interface XenoSpecArtifactBundle {
2521
- document: XenoSpecDocument;
2522
- plan: XenoArtifactEnvelope;
2523
- requirements: XenoArtifactEnvelope;
2524
- design: XenoArtifactEnvelope;
2525
- taskGraph: XenoArtifactEnvelope;
2462
+ interface HarnessTaskUpdate {
2463
+ subject?: string;
2464
+ description?: string;
2465
+ status?: HarnessTaskStatus | "deleted";
2466
+ activeForm?: string;
2467
+ owner?: string;
2468
+ metadata?: Record<string, unknown>;
2469
+ addBlocks?: string[];
2470
+ addBlockedBy?: string[];
2526
2471
  }
2527
- interface XenoSpecTaskExecution {
2528
- taskId: string;
2529
- status: XenoSpecTaskStatus;
2530
- ownerAgentId?: string;
2531
- startedAt?: string;
2532
- completedAt?: string;
2533
- evidence: XenoEvidenceReference[];
2534
- acceptanceEvidence: Record<string, XenoEvidenceReference[]>;
2535
- note?: string;
2472
+ declare class TaskListManager {
2473
+ private readonly tasks;
2474
+ private nextId;
2475
+ create(input: {
2476
+ subject: string;
2477
+ description: string;
2478
+ activeForm?: string;
2479
+ metadata?: Record<string, unknown>;
2480
+ }): HarnessTask;
2481
+ get(taskId: string): HarnessTask | undefined;
2482
+ list(): HarnessTask[];
2483
+ update(taskId: string, input: HarnessTaskUpdate): HarnessTask | undefined;
2484
+ delete(taskId: string): boolean;
2485
+ private incompleteBlockers;
2486
+ private assertDependencyTargets;
2487
+ private link;
2488
+ private assertAcyclic;
2489
+ private snapshot;
2490
+ private restore;
2536
2491
  }
2537
- interface XenoSpecExecutionRecord {
2538
- schemaVersion: typeof XENO_SPEC_EXECUTION_SCHEMA_VERSION;
2539
- executionId: string;
2540
- specId: string;
2541
- specRevision: number;
2542
- planArtifactId: string;
2543
- planHash: XenoContentHash;
2544
- state: XenoSpecExecutionState;
2545
- createdAt: string;
2546
- updatedAt: string;
2547
- startedAt?: string;
2548
- completedAt?: string;
2549
- observedPaths: string[];
2550
- tasks: XenoSpecTaskExecution[];
2492
+ declare function createTaskListTools(manager?: TaskListManager): RegisteredTool[];
2493
+ interface DefaultToolRegistryOptions {
2494
+ cwd?: string;
2495
+ runtime?: ToolRuntimeContext;
2496
+ ownerSessionId?: string;
2497
+ askUser?: AskUserHandler;
2498
+ dispatchAgent?: DispatchAgentHandler;
2499
+ memoryManager?: MemoryManager;
2500
+ webSearchApiKey?: string;
2501
+ webContext?: WebContextToolOptions;
2502
+ permissionProfile?: PermissionProfile;
2503
+ sandbox?: AgentSandbox;
2504
+ validateInputs?: boolean;
2505
+ toolSchemaMode?: "all" | "demand";
2506
+ taskListManager?: TaskListManager;
2507
+ shellEnvironment?: NodeJS.ProcessEnv;
2508
+ shellSensitiveEnvironmentKeys?: readonly string[];
2551
2509
  }
2552
- interface XenoSpecDriftFinding {
2553
- code: "PLAN_HASH_MISMATCH" | "UNKNOWN_TASK" | "UNKNOWN_PATH" | "MISSING_TASK_EVIDENCE" | "MISSING_ACCEPTANCE_EVIDENCE" | "DEPENDENCY_INCOMPLETE";
2554
- severity: "warning" | "error";
2555
- message: string;
2556
- taskId?: string;
2557
- path?: string;
2558
- criterionId?: string;
2510
+ interface ToolRegistryOptions {
2511
+ validateInputs?: boolean;
2512
+ toolSchemaMode?: "all" | "demand";
2559
2513
  }
2560
- interface XenoSpecDriftReport {
2561
- schemaVersion: "xeno.spec-drift.v1";
2562
- specId: string;
2563
- specRevision: number;
2564
- executionId: string;
2565
- checkedAt: string;
2566
- drifted: boolean;
2567
- findings: XenoSpecDriftFinding[];
2514
+ declare class ToolRegistry {
2515
+ private tools;
2516
+ private compiledSchemas;
2517
+ private changeListeners;
2518
+ private aliasNames;
2519
+ private validateInputs;
2520
+ private readonly toolSchemaMode;
2521
+ private readonly activatedDefinitions;
2522
+ constructor(options?: ToolRegistryOptions);
2523
+ setValidateInputs(enabled: boolean): this;
2524
+ get inputValidationEnabled(): boolean;
2525
+ get schemaLoadingMode(): "all" | "demand";
2526
+ register(tool: RegisteredTool): void;
2527
+ registerAlias(tool: RegisteredTool): void;
2528
+ registerAll(tools: Iterable<RegisteredTool>): void;
2529
+ unregister(name: string): boolean;
2530
+ onChange(listener: () => void): () => void;
2531
+ private emitChange;
2532
+ get(name: string): RegisteredTool | undefined;
2533
+ getDefinitions(): ToolDefinition[];
2534
+ getDefinitionsForRequest(): ToolDefinition[];
2535
+ getCapabilityCatalog(): string;
2536
+ activateMatchingDefinitions(query: string, limit?: number): ToolDefinition[];
2537
+ private static namespaceOf;
2538
+ getDefinitionsByNamespace(namespace: string): ToolDefinition[];
2539
+ listNamespaces(): string[];
2540
+ execute(name: string, input: Record<string, unknown>, context?: ToolExecutionContext): Promise<ToolResult>;
2541
+ listNames(): string[];
2542
+ has(name: string): boolean;
2543
+ projectPolicyInput(name: string, input: Record<string, unknown>): ToolPolicyProjection | {
2544
+ error: ToolResult;
2545
+ };
2546
+ get size(): number;
2547
+ private compileDefinition;
2548
+ private assertDefinitionsExportable;
2568
2549
  }
2569
- interface XenoSpecLifecycleServiceOptions {
2570
- repository: XenoArtifactRepository;
2571
- now?: () => string;
2572
- idFactory?: () => string;
2550
+ declare function createDefaultToolRegistry(options?: DefaultToolRegistryOptions): ToolRegistry;
2551
+ declare const registry: ToolRegistry;
2552
+ interface XenoGovernedAutomationToolExecution {
2553
+ operation: XenoAutomationOperation;
2554
+ governingToolName: string;
2555
+ operationId: string;
2556
+ idempotencyKey: string;
2557
+ parameters: Record<string, unknown>;
2558
+ declaredTarget?: XenoAutomationTarget;
2559
+ authorization: ToolAuthorizationReceipt;
2560
+ signal?: AbortSignal;
2561
+ reportProgress?: ToolExecutionContext["reportProgress"];
2573
2562
  }
2574
- declare class XenoSpecValidationError extends Error {
2575
- readonly issues: string[];
2576
- readonly code = "XENO_SPEC_INVALID";
2577
- constructor(issues: string[]);
2563
+ interface XenoGovernedAutomationToolRuntime {
2564
+ execute(input: XenoGovernedAutomationToolExecution): Promise<XenoAutomationExecutionResult>;
2565
+ stop?(operationId: string, reason?: string): Promise<boolean> | boolean;
2578
2566
  }
2579
- declare class XenoSpecLifecycleService {
2580
- private readonly repository;
2581
- private readonly now;
2582
- private readonly idFactory;
2583
- constructor(options: XenoSpecLifecycleServiceOptions);
2584
- create(document: XenoSpecDocument, context: XenoSpecArtifactContext): Promise<XenoSpecArtifactBundle>;
2585
- revise(document: XenoSpecDocument, context: XenoSpecArtifactContext): Promise<XenoSpecArtifactBundle>;
2586
- approve(specId: string, reviewer: XenoArtifactActor, rationale?: string): Promise<XenoArtifactRecord>;
2587
- reject(specId: string, reviewer: XenoArtifactActor, rationale: string): Promise<XenoArtifactRecord>;
2588
- startExecution(specId: string, actor: XenoArtifactActor): Promise<XenoArtifactRecord>;
2589
- updateExecution(executionArtifactId: string, update: (record: XenoSpecExecutionRecord) => XenoSpecExecutionRecord, actor: XenoArtifactActor): Promise<XenoArtifactRecord>;
2567
+ interface CreateXenoGovernedAutomationToolsOptions {
2568
+ runtime: XenoGovernedAutomationToolRuntime;
2569
+ operations?: readonly XenoAutomationOperation[];
2590
2570
  }
2591
- declare function xenoSpecArtifactIds(specId: string): {
2592
- plan: string;
2593
- requirements: string;
2594
- design: string;
2595
- taskGraph: string;
2596
- };
2597
- declare function validateXenoSpecDocument(document: XenoSpecDocument): string[];
2598
- declare function assertValidXenoSpecDocument(document: XenoSpecDocument): void;
2599
- declare function xenoSpecToArtifactBundle(document: XenoSpecDocument, context: XenoSpecArtifactContext): XenoSpecArtifactBundle;
2600
- declare function xenoArtifactToSpecDocument(artifact: XenoArtifactEnvelope): XenoSpecDocument;
2601
- declare function xenoSpecExecutionToArtifact(execution: XenoSpecExecutionRecord, context: XenoSpecArtifactContext, revision?: number, predecessorRevision?: number): XenoArtifactEnvelope;
2602
- declare function xenoArtifactToSpecExecution(artifact: XenoArtifactEnvelope): XenoSpecExecutionRecord;
2603
- declare function assertValidXenoSpecExecution(execution: XenoSpecExecutionRecord, document: XenoSpecDocument): void;
2604
- declare function detectXenoSpecDrift(document: XenoSpecDocument, planHash: XenoContentHash, execution: XenoSpecExecutionRecord, actualPlanHash: XenoContentHash, checkedAt?: string): XenoSpecDriftReport;
2605
- declare const XENO_REVIEW_REPORT_SCHEMA_VERSION: "xeno.review-report.v1";
2606
- declare const XENO_REVIEW_DIMENSIONS: readonly [
2607
- "correctness",
2608
- "security",
2609
- "performance",
2610
- "api",
2611
- "tests",
2612
- "documentation"
2613
- ];
2614
- type XenoReviewDimension = (typeof XENO_REVIEW_DIMENSIONS)[number] | `custom:${string}`;
2615
- type XenoReviewSeverity = "info" | "low" | "medium" | "high" | "critical";
2616
- type XenoReviewFindingState = "verified" | "unverified" | "rejected";
2617
- type XenoReviewVerificationOutcome = "reproduced" | "rejected" | "inconclusive";
2618
- declare const XENO_REVIEW_EVIDENCE_KINDS: readonly [
2619
- "source",
2620
- "test",
2621
- "trace",
2622
- "artifact",
2623
- "reproduction",
2624
- "benchmark"
2625
- ];
2626
- type XenoReviewEvidenceKind = (typeof XENO_REVIEW_EVIDENCE_KINDS)[number] | `custom:${string}`;
2627
- interface XenoReviewEvidence {
2628
- evidenceId: string;
2629
- kind: XenoReviewEvidenceKind;
2630
- summary: string;
2631
- producerId: string;
2632
- reference?: XenoEvidenceReference;
2633
- anchor?: XenoArtifactAnchor;
2634
- contentHash?: XenoContentHash;
2571
+ declare function createXenoGovernedAutomationTools(options: CreateXenoGovernedAutomationToolsOptions): RegisteredTool[];
2572
+ interface CliAutomationAuditEvent {
2573
+ eventType: "automation_lease_approved" | "automation_completed" | "automation_failed";
2574
+ traceId: string;
2575
+ operation: XenoAutomationOperation;
2576
+ operationId: string;
2577
+ leaseId?: string;
2578
+ contractFingerprint?: string;
2579
+ status?: string;
2580
+ artifactIds?: string[];
2581
+ permissionReason?: string;
2582
+ }
2583
+ interface CliAutomationAuditLoggerPort {
2584
+ append(event: {
2585
+ trace_id: string;
2586
+ event_type: string;
2587
+ actor: "system";
2588
+ risk_level: "low" | "high";
2589
+ decision?: "allow";
2590
+ status: "ok" | "error";
2591
+ reason?: string;
2592
+ metadata: Record<string, unknown>;
2593
+ }): Promise<unknown>;
2635
2594
  }
2636
- interface XenoReviewFindingProposal {
2637
- ruleId?: string;
2638
- dimension: XenoReviewDimension;
2639
- title: string;
2640
- summary: string;
2641
- severity: XenoReviewSeverity;
2642
- confidence: number;
2643
- anchors: XenoArtifactAnchor[];
2644
- evidence: XenoReviewEvidence[];
2645
- remediation?: string;
2595
+ interface CliAutomationEnvironment {
2596
+ browser?: {
2597
+ driver: "browser" | "extension";
2598
+ baseUrl?: string;
2599
+ token?: string;
2600
+ readDomains: string[];
2601
+ actDomains: string[];
2602
+ deniedDomains: string[];
2603
+ ports: number[];
2604
+ allowLoopbackDevelopment: boolean;
2605
+ uploads: "deny" | "prompt" | "allow";
2606
+ downloads: "deny" | "prompt" | "allow";
2607
+ recording: "disabled" | "bounded";
2608
+ };
2609
+ computer?: {
2610
+ baseUrl?: string;
2611
+ token?: string;
2612
+ deviceId?: string;
2613
+ allowedApplications: string[];
2614
+ };
2615
+ }
2616
+ interface CliAutomationSurfaceStatus {
2617
+ surface: "browser" | "computer";
2618
+ configured: boolean;
2619
+ available: boolean;
2620
+ certified: boolean;
2621
+ adapterId?: string;
2622
+ adapterVersion?: string;
2623
+ operations: string[];
2624
+ limitations: string[];
2625
+ error?: string;
2646
2626
  }
2647
- interface XenoReviewAgentResult {
2648
- reviewerAgentId: string;
2649
- dimension: XenoReviewDimension;
2650
- findings: XenoReviewFindingProposal[];
2651
- completedAt: string;
2627
+ interface CliAutomationStatusReport {
2628
+ schemaVersion: 1;
2629
+ protocolVersion: 1;
2630
+ enabled: boolean;
2631
+ surfaces: CliAutomationSurfaceStatus[];
2632
+ docs: string;
2652
2633
  }
2653
- interface XenoReviewVerificationResult {
2654
- verifierAgentId: string;
2655
- outcome: XenoReviewVerificationOutcome;
2656
- rationale: string;
2657
- evidence: XenoReviewEvidence[];
2658
- confidence?: number;
2659
- completedAt: string;
2634
+ interface CreateCliGovernedAutomationRuntimeOptions {
2635
+ cwd: () => string;
2636
+ profile: () => CompiledAgentProfile;
2637
+ runId: string;
2638
+ agentId?: string;
2639
+ sessionId?: string;
2640
+ workspaceId?: string;
2641
+ surface: "cli" | "hub" | "ide" | "api" | "hosted";
2642
+ securityPolicy?: () => PolicyEnforcerConfig | undefined;
2643
+ securityStatus?: ProcessContainmentStatus;
2644
+ safeMode?: boolean;
2645
+ environment?: CliAutomationEnvironment;
2646
+ onAudit?: (event: CliAutomationAuditEvent) => Promise<void> | void;
2647
+ }
2648
+ declare class CliGovernedAutomationRuntime implements XenoGovernedAutomationToolRuntime {
2649
+ private readonly options;
2650
+ private readonly leases;
2651
+ private readonly activeExecutors;
2652
+ private readonly environment;
2653
+ private browserAdapter?;
2654
+ private computerAdapter?;
2655
+ constructor(options: CreateCliGovernedAutomationRuntimeOptions);
2656
+ register(registry: ToolRegistry): number;
2657
+ execute(input: XenoGovernedAutomationToolExecution): Promise<XenoAutomationExecutionResult>;
2658
+ stop(operationId: string, reason?: string): Promise<boolean>;
2659
+ private securityPolicy;
2660
+ private adapterFor;
2661
+ private audit;
2662
+ }
2663
+ declare function createCliGovernedAutomationRuntime(options: CreateCliGovernedAutomationRuntimeOptions): CliGovernedAutomationRuntime;
2664
+ declare function createCliAutomationAuditSink(logger: CliAutomationAuditLoggerPort | undefined): ((event: CliAutomationAuditEvent) => Promise<void>) | undefined;
2665
+ declare function inspectCliAutomationStatus(environment?: CliAutomationEnvironment): Promise<CliAutomationStatusReport>;
2666
+ declare function readCliAutomationEnvironment(env?: NodeJS.ProcessEnv): CliAutomationEnvironment;
2667
+ declare function renderCliAutomationStatus(report: CliAutomationStatusReport): string;
2668
+ type XenoHostAutomationAuditEvent = CliAutomationAuditEvent;
2669
+ type XenoHostAutomationAuditLoggerPort = CliAutomationAuditLoggerPort;
2670
+ type XenoHostAutomationEnvironment = CliAutomationEnvironment;
2671
+ type XenoHostAutomationSurfaceStatus = CliAutomationSurfaceStatus;
2672
+ type XenoHostAutomationStatusReport = CliAutomationStatusReport;
2673
+ type CreateXenoHostGovernedAutomationRuntimeOptions = CreateCliGovernedAutomationRuntimeOptions;
2674
+ interface XenoArtifactValidationIssue {
2675
+ path: string;
2676
+ code: string;
2677
+ message: string;
2660
2678
  }
2661
- interface XenoReviewFinding {
2662
- findingId: string;
2663
- fingerprint: string;
2664
- ruleIds: string[];
2665
- dimensions: XenoReviewDimension[];
2666
- reviewerAgentIds: string[];
2667
- title: string;
2668
- summary: string;
2669
- severity: XenoReviewSeverity;
2670
- confidence: number;
2671
- state: XenoReviewFindingState;
2672
- verificationBasis: "verifier" | "independent-evidence" | "none";
2673
- anchors: XenoArtifactAnchor[];
2674
- evidence: XenoReviewEvidence[];
2675
- verifications: XenoReviewVerificationResult[];
2676
- remediation?: string;
2677
- duplicateProposalCount: number;
2679
+ declare class XenoArtifactValidationError extends Error {
2680
+ readonly code = "ARTIFACT_INVALID";
2681
+ readonly issues: XenoArtifactValidationIssue[];
2682
+ constructor(message: string, issues: XenoArtifactValidationIssue[]);
2678
2683
  }
2679
- interface XenoReviewTarget {
2680
- artifactId: string;
2681
- revision: number;
2682
- contentHash: XenoContentHash;
2683
- title: string;
2684
- repositoryId?: string;
2685
- commit?: string;
2686
- anchors?: XenoArtifactAnchor[];
2684
+ declare class XenoArtifactStateTransitionError extends Error {
2685
+ readonly fromState: XenoArtifactState;
2686
+ readonly toState: XenoArtifactState;
2687
+ readonly code = "ARTIFACT_STATE_TRANSITION_INVALID";
2688
+ constructor(fromState: XenoArtifactState, toState: XenoArtifactState);
2687
2689
  }
2688
- interface XenoReviewPack {
2689
- schemaVersion: "xeno.review-pack.v1";
2690
- packId: string;
2691
- version: string;
2692
- dimensions: XenoReviewDimension[];
2693
- verifierCount: number;
2694
- minimumVerifierReproductions: number;
2695
- allowIndependentEvidenceVerification: boolean;
2696
- minimumIndependentEvidenceProducers: number;
2697
- maxFindings: number;
2690
+ declare function validateXenoArtifact(artifact: XenoArtifactEnvelope): XenoArtifactValidationIssue[];
2691
+ declare function assertValidXenoArtifact(artifact: XenoArtifactEnvelope): void;
2692
+ declare function canTransitionXenoArtifactState(fromState: XenoArtifactState, toState: XenoArtifactState): boolean;
2693
+ declare function assertXenoArtifactStateTransition(fromState: XenoArtifactState, toState: XenoArtifactState): void;
2694
+ declare function validateXenoArtifactReviewEvent(event: XenoArtifactReviewEvent, artifact?: XenoArtifactEnvelope): XenoArtifactValidationIssue[];
2695
+ declare function summarizeXenoArtifactReview(events: readonly XenoArtifactReviewEvent[]): XenoArtifactReviewSummary;
2696
+ declare function sha256ArtifactBytes(content: Uint8Array | string): XenoContentHash;
2697
+ declare function canonicalizeArtifactJson(value: XenoJsonValue): string;
2698
+ declare function sha256ArtifactJson(value: XenoJsonValue): XenoContentHash;
2699
+ declare class XenoEvidenceGraphValidationError extends Error {
2700
+ readonly code = "EVIDENCE_GRAPH_INVALID";
2701
+ readonly issues: XenoArtifactValidationIssue[];
2702
+ constructor(issues: XenoArtifactValidationIssue[]);
2698
2703
  }
2699
- interface XenoReviewReport {
2700
- schemaVersion: typeof XENO_REVIEW_REPORT_SCHEMA_VERSION;
2701
- reportId: string;
2702
- runId: string;
2703
- pack: XenoReviewPack;
2704
- target: XenoReviewTarget;
2705
- startedAt: string;
2706
- completedAt: string;
2707
- reviewers: Array<{
2708
- agentId: string;
2709
- dimension: XenoReviewDimension;
2710
- findingCount: number;
2711
- }>;
2712
- findings: XenoReviewFinding[];
2713
- summary: {
2714
- total: number;
2715
- verified: number;
2716
- unverified: number;
2717
- rejected: number;
2718
- bySeverity: Record<XenoReviewSeverity, number>;
2704
+ declare function validateXenoEvidenceGraph(graph: XenoEvidenceGraph): XenoArtifactValidationIssue[];
2705
+ declare function assertValidXenoEvidenceGraph(graph: XenoEvidenceGraph): void;
2706
+ interface XenoEvidenceGraphBuilderOptions {
2707
+ graphId: string;
2708
+ now?: () => string;
2709
+ }
2710
+ declare class XenoEvidenceGraphBuilder {
2711
+ private readonly now;
2712
+ private graph;
2713
+ constructor(options: XenoEvidenceGraphBuilderOptions | XenoEvidenceGraph);
2714
+ addNode(node: XenoEvidenceNode): this;
2715
+ addEdge(edge: XenoEvidenceEdge): this;
2716
+ build(): XenoEvidenceGraph;
2717
+ private touch;
2718
+ }
2719
+ declare const XENO_ARTIFACT_FILE_REPOSITORY_SCHEMA_VERSION: 1;
2720
+ interface XenoArtifactFileSnapshotPayload {
2721
+ schemaVersion: typeof XENO_ARTIFACT_FILE_REPOSITORY_SCHEMA_VERSION;
2722
+ generation: number;
2723
+ createdAt: string;
2724
+ updatedAt: string;
2725
+ state: XenoArtifactRepositoryState;
2726
+ }
2727
+ interface XenoArtifactFileSnapshot extends XenoArtifactFileSnapshotPayload {
2728
+ checksum: {
2729
+ algorithm: "sha256";
2730
+ value: string;
2719
2731
  };
2720
2732
  }
2721
- interface XenoReviewCoordinatorContext {
2722
- runId: string;
2723
- target: XenoReviewTarget;
2724
- pack: XenoReviewPack;
2733
+ interface XenoArtifactFileRecoveryNotice {
2734
+ snapshotPath: string;
2735
+ backupPath: string;
2736
+ reason: string;
2725
2737
  }
2726
- type XenoReviewAgentExecutor = (request: XenoReviewCoordinatorContext & {
2727
- dimension: XenoReviewDimension;
2728
- reviewerSlot: number;
2729
- }) => Promise<XenoReviewAgentResult>;
2730
- type XenoReviewVerifierExecutor = (request: XenoReviewCoordinatorContext & {
2731
- finding: XenoReviewFinding;
2732
- verifierSlot: number;
2733
- }) => Promise<XenoReviewVerificationResult>;
2734
- interface XenoMultiAgentReviewCoordinatorOptions {
2735
- reviewer: XenoReviewAgentExecutor;
2736
- verifier?: XenoReviewVerifierExecutor;
2738
+ interface FileXenoArtifactRepositoryOptions {
2739
+ directory: string;
2740
+ snapshotFileName?: string;
2741
+ lockTimeoutMs?: number;
2742
+ lockRetryMs?: number;
2743
+ maxSnapshotBytes?: number;
2737
2744
  now?: () => string;
2738
- idFactory?: (prefix: "report" | "finding") => string;
2745
+ onRecovery?: (notice: XenoArtifactFileRecoveryNotice) => void;
2739
2746
  }
2740
- interface XenoReviewArtifactContext {
2747
+ declare class FileXenoArtifactRepository implements XenoArtifactRepository {
2748
+ readonly directory: string;
2749
+ readonly snapshotPath: string;
2750
+ readonly backupPath: string;
2751
+ readonly lockPath: string;
2752
+ private readonly now;
2753
+ private readonly lockTimeoutMs;
2754
+ private readonly lockRetryMs;
2755
+ private readonly maxSnapshotBytes;
2756
+ private readonly onRecovery?;
2757
+ private mutationTail;
2758
+ constructor(options: FileXenoArtifactRepositoryOptions);
2759
+ create(artifact: XenoArtifactEnvelope): Promise<XenoArtifactRecord>;
2760
+ createRevision(artifact: XenoArtifactEnvelope, options?: XenoArtifactRevisionOptions): Promise<XenoArtifactRecord>;
2761
+ get(artifactId: string, revision?: number): Promise<XenoArtifactRecord | undefined>;
2762
+ require(artifactId: string, revision?: number): Promise<XenoArtifactRecord>;
2763
+ list(query?: XenoArtifactListQuery): Promise<XenoArtifactRecord[]>;
2764
+ listRevisions(artifactId: string): Promise<XenoArtifactRecord[]>;
2765
+ transition(request: XenoArtifactTransitionRequest): Promise<XenoArtifactRecord>;
2766
+ appendReviewEvent(request: XenoArtifactAppendReviewRequest): Promise<XenoArtifactRecord>;
2767
+ inspectSnapshot(): Promise<XenoArtifactFileSnapshot | undefined>;
2768
+ private mutate;
2769
+ private enqueueMutation;
2770
+ private acquireLock;
2771
+ private load;
2772
+ private persist;
2773
+ private readSnapshot;
2774
+ }
2775
+ type XenoDiffMode = "working-tree" | "staged" | "turn" | "commit" | "preview";
2776
+ type XenoDiffFileStatus = "added" | "modified" | "deleted" | "renamed" | "copied" | "binary";
2777
+ type XenoDiffLineKind = "context" | "addition" | "deletion" | "no-newline";
2778
+ interface XenoDiffLine {
2779
+ kind: XenoDiffLineKind;
2780
+ text: string;
2781
+ oldLine?: number;
2782
+ newLine?: number;
2783
+ }
2784
+ interface XenoDiffHunk {
2785
+ hunkId: string;
2786
+ header: string;
2787
+ section?: string;
2788
+ oldStart: number;
2789
+ oldLines: number;
2790
+ newStart: number;
2791
+ newLines: number;
2792
+ additions: number;
2793
+ deletions: number;
2794
+ lines: XenoDiffLine[];
2795
+ }
2796
+ interface XenoDiffFile {
2797
+ oldPath?: string;
2798
+ newPath?: string;
2799
+ displayPath: string;
2800
+ status: XenoDiffFileStatus;
2801
+ additions: number;
2802
+ deletions: number;
2803
+ binary: boolean;
2804
+ headerLines: string[];
2805
+ hunks: XenoDiffHunk[];
2806
+ }
2807
+ interface XenoDiffDocument {
2808
+ schemaVersion: 1;
2809
+ mode: XenoDiffMode;
2810
+ repositoryId?: string;
2811
+ baseRef?: string;
2812
+ headRef?: string;
2813
+ files: XenoDiffFile[];
2814
+ additions: number;
2815
+ deletions: number;
2816
+ rawDiff: string;
2817
+ }
2818
+ interface ParseUnifiedDiffOptions {
2819
+ mode?: XenoDiffMode;
2820
+ repositoryId?: string;
2821
+ baseRef?: string;
2822
+ headRef?: string;
2823
+ maxBytes?: number;
2824
+ maxFiles?: number;
2825
+ maxHunks?: number;
2826
+ maxLines?: number;
2827
+ }
2828
+ interface XenoDiffArtifactContext {
2829
+ kind?: "diff" | "patch";
2830
+ artifactId?: string;
2831
+ revision?: number;
2832
+ predecessorRevision?: number;
2833
+ createdAt?: string;
2834
+ title?: string;
2835
+ description?: string;
2741
2836
  producer: XenoArtifactActor;
2742
2837
  identity?: XenoArtifactIdentity;
2743
2838
  sensitivity?: XenoArtifactSensitivity;
2744
2839
  accessPolicyId?: string;
2745
- artifactId?: string;
2746
- createdAt?: string;
2840
+ mode?: XenoDiffMode;
2841
+ repositoryId?: string;
2842
+ baseRef?: string;
2843
+ headRef?: string;
2747
2844
  }
2748
- interface XenoGitHubReviewComment {
2749
- findingId: string;
2750
- path: string;
2845
+ declare class XenoDiffParseError extends Error {
2846
+ readonly line?: number | undefined;
2847
+ readonly code = "XENO_DIFF_INVALID";
2848
+ constructor(message: string, line?: number | undefined);
2849
+ }
2850
+ declare function parseUnifiedDiff(diff: string, options?: ParseUnifiedDiffOptions): XenoDiffDocument;
2851
+ declare function unifiedDiffToXenoArtifact(diff: string, context: XenoDiffArtifactContext): XenoArtifactEnvelope;
2852
+ declare function xenoArtifactToDiffDocument(artifact: XenoArtifactEnvelope): XenoDiffDocument;
2853
+ interface XenoArtifactReviewServiceOptions {
2854
+ repository: XenoArtifactRepository;
2855
+ actor: XenoArtifactActor;
2856
+ idFactory?: () => string;
2857
+ }
2858
+ interface XenoArtifactReviewAnchorInput {
2859
+ file?: string;
2751
2860
  line?: number;
2861
+ hunkId?: string;
2862
+ }
2863
+ interface AddXenoArtifactCommentRequest extends XenoArtifactReviewAnchorInput {
2864
+ artifactId: string;
2865
+ revision?: number;
2752
2866
  body: string;
2753
- severity: XenoReviewSeverity;
2754
- verified: boolean;
2867
+ parentCommentId?: string;
2755
2868
  }
2756
- declare class XenoReviewValidationError extends Error {
2757
- readonly issues: string[];
2758
- readonly code = "XENO_REVIEW_INVALID";
2759
- constructor(issues: string[]);
2869
+ interface SetXenoArtifactCommentResolutionRequest {
2870
+ artifactId: string;
2871
+ revision?: number;
2872
+ commentId: string;
2873
+ resolved: boolean;
2874
+ reason?: string;
2760
2875
  }
2761
- declare class XenoMultiAgentReviewCoordinator {
2762
- private readonly reviewer;
2763
- private readonly verifier?;
2764
- private readonly now;
2876
+ interface DecideXenoArtifactRequest extends Omit<XenoArtifactReviewAnchorInput, "line"> {
2877
+ artifactId: string;
2878
+ revision?: number;
2879
+ decision: XenoArtifactReviewDecision;
2880
+ rationale?: string;
2881
+ }
2882
+ declare class XenoArtifactReviewService {
2883
+ private readonly repository;
2884
+ private readonly actor;
2765
2885
  private readonly idFactory;
2766
- constructor(options: XenoMultiAgentReviewCoordinatorOptions);
2767
- run(context: XenoReviewCoordinatorContext): Promise<XenoReviewReport>;
2886
+ constructor(options: XenoArtifactReviewServiceOptions);
2887
+ addComment(request: AddXenoArtifactCommentRequest): Promise<XenoArtifactRecord>;
2888
+ setCommentResolution(request: SetXenoArtifactCommentResolutionRequest): Promise<XenoArtifactRecord>;
2889
+ decide(request: DecideXenoArtifactRequest): Promise<XenoArtifactRecord>;
2768
2890
  }
2769
- declare function defaultXenoReviewPack(packId?: string): XenoReviewPack;
2770
- declare function assertValidXenoReviewPack(pack: XenoReviewPack): void;
2771
- declare function assertValidXenoReviewTarget(target: XenoReviewTarget): void;
2772
- declare function assertValidXenoReviewReport(report: XenoReviewReport): void;
2773
- declare function xenoReviewReportToArtifact(report: XenoReviewReport, context: XenoReviewArtifactContext): XenoArtifactEnvelope;
2774
- declare function xenoArtifactToReviewReport(artifact: XenoArtifactEnvelope): XenoReviewReport;
2775
- declare function xenoReviewReportToGitHubComments(report: XenoReviewReport, options?: {
2776
- verifiedOnly?: boolean;
2777
- }): XenoGitHubReviewComment[];
2778
- type AgentSelectionStrategy = "first" | "least-loaded" | "round-robin";
2779
- interface AgentCard {
2780
- id: string;
2781
- name: string;
2782
- description?: string;
2783
- capabilities: string[];
2784
- maxConcurrentTasks?: number;
2785
- handler: AgentTaskHandler;
2891
+ declare function buildXenoArtifactReviewAnchor(record: XenoArtifactRecord, input: XenoArtifactReviewAnchorInput): XenoArtifactAnchor | undefined;
2892
+ declare function normalizeRepositoryRelativePath(value: string): string;
2893
+ declare const XENO_SPEC_SCHEMA_VERSION: "xeno.spec.v1";
2894
+ declare const XENO_SPEC_EXECUTION_SCHEMA_VERSION: "xeno.spec-execution.v1";
2895
+ type XenoSpecPriority = "must" | "should" | "could";
2896
+ type XenoSpecTaskStatus = "pending" | "in_progress" | "completed" | "blocked" | "skipped";
2897
+ type XenoSpecExecutionState = "ready" | "running" | "completed" | "failed" | "cancelled";
2898
+ interface XenoSpecAcceptanceCriterion {
2899
+ id: string;
2900
+ text: string;
2901
+ requiredEvidenceKinds?: string[];
2786
2902
  }
2787
- interface AgentTeam {
2903
+ interface XenoSpecRequirement {
2788
2904
  id: string;
2789
- name: string;
2790
- description?: string;
2791
- agentIds: string[];
2792
- strategy?: AgentSelectionStrategy;
2905
+ text: string;
2906
+ priority: XenoSpecPriority;
2907
+ acceptanceCriteria: XenoSpecAcceptanceCriterion[];
2908
+ sourceReferences?: XenoEvidenceReference[];
2793
2909
  }
2794
- interface AgentLoadSnapshot {
2795
- agentId: string;
2796
- agentName: string;
2797
- activeTasks: number;
2798
- maxConcurrentTasks: number;
2799
- availableSlots: number;
2800
- isAvailable: boolean;
2910
+ interface XenoSpecDesignDecision {
2911
+ id: string;
2912
+ decision: string;
2913
+ rationale: string;
2914
+ alternatives?: string[];
2915
+ requirementIds?: string[];
2801
2916
  }
2802
- interface AgentTask {
2917
+ interface XenoSpecRisk {
2803
2918
  id: string;
2804
- type: string;
2805
2919
  description: string;
2806
- input: Record<string, unknown>;
2807
- priority?: "low" | "normal" | "high" | "critical";
2808
- createdAt: string;
2809
- status: AgentTaskStatus;
2810
- assignedTo?: string;
2811
- createdBy?: string;
2812
- parentTaskId?: string;
2813
- timeoutMs?: number;
2814
- }
2815
- type AgentTaskStatus = "pending" | "assigned" | "running" | "completed" | "failed" | "cancelled" | "timeout";
2816
- interface AgentTaskResult {
2817
- taskId: string;
2818
- status: "completed" | "failed" | "cancelled";
2819
- result: unknown;
2820
- error?: string;
2821
- artifacts?: AgentArtifact[];
2822
- durationMs?: number;
2920
+ impact: "low" | "medium" | "high" | "critical";
2921
+ mitigation: string;
2922
+ owner?: string;
2823
2923
  }
2824
- interface AgentArtifact {
2825
- name: string;
2826
- mimeType?: string;
2827
- content: string;
2924
+ interface XenoSpecDesign {
2925
+ summary: string;
2926
+ decisions: XenoSpecDesignDecision[];
2927
+ risks: XenoSpecRisk[];
2828
2928
  }
2829
- type AgentTaskHandler = (task: AgentTask) => Promise<AgentTaskResult>;
2830
- type A2AMessageType = "task-request" | "task-accepted" | "task-rejected" | "task-progress" | "task-completed" | "task-failed" | "capability-query" | "capability-response";
2831
- interface A2AMessage {
2929
+ interface XenoSpecTask {
2832
2930
  id: string;
2833
- type: A2AMessageType;
2834
- from: string;
2835
- to: string;
2836
- payload: Record<string, unknown>;
2837
- timestamp: string;
2838
- correlationId?: string;
2839
- }
2840
- interface AgentDispatchOptions {
2841
- timeoutMs?: number;
2842
- priority?: AgentTask["priority"];
2843
- parentTaskId?: string;
2844
- createdBy?: string;
2845
- waitForCapacity?: boolean;
2846
- maxQueueWaitMs?: number;
2847
- }
2848
- interface AgentCapabilityDispatchOptions extends AgentDispatchOptions {
2849
- strategy?: AgentSelectionStrategy;
2850
- teamId?: string;
2851
- }
2852
- declare class AgentRegistry {
2853
- private agents;
2854
- private teams;
2855
- registerAgent(card: AgentCard): void;
2856
- unregisterAgent(id: string): boolean;
2857
- getAgent(id: string): AgentCard | undefined;
2858
- findByCapability(capability: string): AgentCard[];
2859
- listAgents(): AgentCard[];
2860
- registerTeam(team: AgentTeam): void;
2861
- unregisterTeam(id: string): boolean;
2862
- getTeam(id: string): AgentTeam | undefined;
2863
- listTeams(): AgentTeam[];
2864
- listAgentsForTeam(teamId: string): AgentCard[];
2865
- get size(): number;
2866
- }
2867
- declare class AgentProtocol {
2868
- private registry;
2869
- private messageLog;
2870
- private activeTasks;
2871
- private activeTasksByAgent;
2872
- private capabilityRoundRobinCursor;
2873
- constructor(registry: AgentRegistry);
2874
- private getAgentCapacity;
2875
- private getAgentActiveTaskCount;
2876
- private isAgentAvailable;
2877
- private reserveAgentTask;
2878
- private releaseAgentTask;
2879
- private waitForAgentCapacity;
2880
- private getCapabilityCandidates;
2881
- private compareAgentLoad;
2882
- private selectAgentForCapability;
2883
- getAgentLoad(agentId: string): AgentLoadSnapshot | undefined;
2884
- listAgentLoads(options?: {
2885
- capability?: string;
2886
- teamId?: string;
2887
- }): AgentLoadSnapshot[];
2888
- delegateTask(agentId: string, taskSpec: {
2889
- type: string;
2890
- description: string;
2891
- input: Record<string, unknown>;
2892
- }, options?: AgentDispatchOptions): Promise<AgentTaskResult>;
2893
- delegateByCapability(capability: string, taskSpec: {
2894
- description: string;
2895
- input: Record<string, unknown>;
2896
- }, options?: AgentCapabilityDispatchOptions): Promise<AgentTaskResult>;
2897
- delegateToTeam(teamId: string, taskSpec: {
2898
- type: string;
2899
- description: string;
2900
- input: Record<string, unknown>;
2901
- }, options?: Omit<AgentCapabilityDispatchOptions, "teamId">): Promise<AgentTaskResult>;
2902
- getMessageLog(limit?: number): A2AMessage[];
2903
- getActiveTasks(): AgentTask[];
2904
- private logMessage;
2905
- }
2906
- interface FileSnapshot {
2907
- path: string;
2908
- exists: boolean;
2909
- size: number;
2910
- mtimeMs: number;
2911
- text?: string;
2912
- binary?: boolean;
2913
- truncated?: boolean;
2914
- }
2915
- interface TurnFileDiff {
2916
- path: string;
2917
- status: "created" | "modified" | "deleted" | "unchanged";
2918
- before?: FileSnapshot;
2919
- after?: FileSnapshot;
2920
- patch?: string;
2921
- }
2922
- interface TurnDiffSummary {
2923
- turnId: string;
2924
- startedAt: string;
2925
- completedAt: string;
2926
- files: TurnFileDiff[];
2931
+ title: string;
2932
+ description: string;
2933
+ dependsOn?: string[];
2934
+ requirementIds: string[];
2935
+ acceptanceCriterionIds: string[];
2936
+ expectedPaths?: string[];
2937
+ preferredAgentProfile?: string;
2927
2938
  }
2928
- interface TurnDiffTrackerOptions {
2929
- maxFileBytes?: number;
2930
- cwd?: string;
2939
+ interface XenoSpecSourceBaseline {
2940
+ repositoryId?: string;
2941
+ commit?: string;
2942
+ workspaceFingerprint?: XenoContentHash;
2931
2943
  }
2932
- declare class TurnDiffTracker {
2933
- private active?;
2934
- private readonly maxFileBytes;
2935
- private readonly cwd;
2936
- constructor(options?: TurnDiffTrackerOptions);
2937
- beginTurn(turnId: string): void;
2938
- observeBefore(paths: Iterable<string | null | undefined>): void;
2939
- observeAfter(paths: Iterable<string | null | undefined>): void;
2940
- endTurn(): TurnDiffSummary | undefined;
2941
- inferToolPaths(toolName: string, input: Record<string, unknown>): string[];
2942
- private resolvePath;
2943
- private snapshot;
2944
+ interface XenoSpecDocument {
2945
+ schemaVersion: typeof XENO_SPEC_SCHEMA_VERSION;
2946
+ specId: string;
2947
+ revision: number;
2948
+ title: string;
2949
+ problem: string;
2950
+ requirements: XenoSpecRequirement[];
2951
+ design: XenoSpecDesign;
2952
+ tasks: XenoSpecTask[];
2953
+ acceptanceCriteria: XenoSpecAcceptanceCriterion[];
2954
+ sourceBaseline?: XenoSpecSourceBaseline;
2955
+ createdAt: string;
2956
+ updatedAt: string;
2957
+ predecessorRevision?: number;
2944
2958
  }
2945
- interface XenoLegacyArtifactContext {
2946
- artifactId?: string;
2947
- revision?: number;
2948
- createdAt?: string;
2959
+ interface XenoSpecArtifactContext {
2949
2960
  producer: XenoArtifactActor;
2950
2961
  identity?: XenoArtifactIdentity;
2951
- state?: XenoArtifactState;
2952
2962
  sensitivity?: XenoArtifactSensitivity;
2953
2963
  accessPolicyId?: string;
2964
+ createdAt?: string;
2954
2965
  }
2955
- interface XenoLegacyAgentArtifactContext extends XenoLegacyArtifactContext {
2956
- contentEncoding?: "utf8" | "base64";
2957
- kind?: XenoArtifactKind;
2966
+ interface XenoSpecArtifactBundle {
2967
+ document: XenoSpecDocument;
2968
+ plan: XenoArtifactEnvelope;
2969
+ requirements: XenoArtifactEnvelope;
2970
+ design: XenoArtifactEnvelope;
2971
+ taskGraph: XenoArtifactEnvelope;
2958
2972
  }
2959
- declare function legacyAgentArtifactToXenoArtifact(legacy: AgentArtifact, context: XenoLegacyAgentArtifactContext): XenoArtifactEnvelope;
2960
- declare function xenoArtifactToLegacyAgentArtifact(artifact: XenoArtifactEnvelope): AgentArtifact;
2961
- declare function toolEvidenceToXenoArtifact(evidence: ToolEvidence, context: XenoLegacyArtifactContext): XenoArtifactEnvelope;
2962
- declare function xenoArtifactToToolEvidence(artifact: XenoArtifactEnvelope): ToolEvidence;
2963
- declare function turnDiffSummaryToXenoArtifact(summary: TurnDiffSummary, context: XenoLegacyArtifactContext): XenoArtifactEnvelope;
2964
- declare function xenoArtifactToTurnDiffSummary(artifact: XenoArtifactEnvelope): TurnDiffSummary;
2965
- type HookEventName = "SessionStart" | "UserPromptSubmit" | "PermissionRequest" | "PreToolUse" | "PostToolUse" | "PreCompact" | "PostCompact" | "Stop" | "StopFailure" | "SubagentStart" | "SubagentStop";
2966
- type HookPermissionMode = AgentPermissionMode;
2967
- interface HookInputBase {
2968
- schemaVersion: 1;
2969
- event: HookEventName;
2970
- sessionId: string;
2971
- runId: string;
2972
- rootRunId: string;
2973
- agentId: string;
2974
- agentName?: string;
2975
- agentColor?: string;
2976
- parentAgentId?: string;
2977
- cwd: string;
2978
- transcriptPath?: string;
2979
- permissionMode: HookPermissionMode;
2980
- model: string;
2981
- effort?: string;
2982
- timestamp: string;
2973
+ interface XenoSpecTaskExecution {
2974
+ taskId: string;
2975
+ status: XenoSpecTaskStatus;
2976
+ ownerAgentId?: string;
2977
+ startedAt?: string;
2978
+ completedAt?: string;
2979
+ evidence: XenoEvidenceReference[];
2980
+ acceptanceEvidence: Record<string, XenoEvidenceReference[]>;
2981
+ note?: string;
2983
2982
  }
2984
- interface HookInvocationInput extends HookInputBase {
2985
- prompt?: string;
2986
- toolName?: string;
2987
- toolInput?: Record<string, unknown>;
2988
- toolResult?: unknown;
2989
- finalText?: string;
2990
- metadata?: Record<string, unknown>;
2991
- }
2992
- type HookDecision = {
2993
- decision: "allow";
2994
- systemMessage?: string;
2995
- context?: string;
2996
- } | {
2997
- decision: "block";
2998
- reason: string;
2999
- systemMessage?: string;
3000
- } | {
3001
- decision: "ask";
3002
- reason: string;
3003
- prompt: string;
3004
- } | {
3005
- decision: "modify";
3006
- patch: unknown;
3007
- reason?: string;
3008
- } | {
3009
- decision: "continue";
3010
- context?: string;
3011
- systemMessage?: string;
3012
- };
3013
- interface BaseHookDefinition {
3014
- name?: string;
3015
- events?: HookEventName[];
3016
- timeoutMs?: number;
3017
- maxOutputBytes?: number;
3018
- failClosed?: boolean;
3019
- async?: boolean;
2983
+ interface XenoSpecExecutionRecord {
2984
+ schemaVersion: typeof XENO_SPEC_EXECUTION_SCHEMA_VERSION;
2985
+ executionId: string;
2986
+ specId: string;
2987
+ specRevision: number;
2988
+ planArtifactId: string;
2989
+ planHash: XenoContentHash;
2990
+ state: XenoSpecExecutionState;
2991
+ createdAt: string;
2992
+ updatedAt: string;
2993
+ startedAt?: string;
2994
+ completedAt?: string;
2995
+ observedPaths: string[];
2996
+ tasks: XenoSpecTaskExecution[];
3020
2997
  }
3021
- interface CommandHookDefinition extends BaseHookDefinition {
3022
- type: "command";
3023
- command: string;
3024
- args?: string[];
3025
- cwd?: string;
3026
- shell?: boolean;
3027
- env?: Record<string, string>;
2998
+ interface XenoSpecDriftFinding {
2999
+ code: "PLAN_HASH_MISMATCH" | "UNKNOWN_TASK" | "UNKNOWN_PATH" | "MISSING_TASK_EVIDENCE" | "MISSING_ACCEPTANCE_EVIDENCE" | "DEPENDENCY_INCOMPLETE";
3000
+ severity: "warning" | "error";
3001
+ message: string;
3002
+ taskId?: string;
3003
+ path?: string;
3004
+ criterionId?: string;
3028
3005
  }
3029
- interface HttpHookDefinition extends BaseHookDefinition {
3030
- type: "http";
3031
- url: string;
3032
- method?: "POST";
3033
- headers?: Record<string, string>;
3006
+ interface XenoSpecDriftReport {
3007
+ schemaVersion: "xeno.spec-drift.v1";
3008
+ specId: string;
3009
+ specRevision: number;
3010
+ executionId: string;
3011
+ checkedAt: string;
3012
+ drifted: boolean;
3013
+ findings: XenoSpecDriftFinding[];
3034
3014
  }
3035
- interface PromptHookDefinition extends BaseHookDefinition {
3036
- type: "prompt";
3037
- prompt: string;
3015
+ interface XenoSpecLifecycleServiceOptions {
3016
+ repository: XenoArtifactRepository;
3017
+ now?: () => string;
3018
+ idFactory?: () => string;
3038
3019
  }
3039
- interface AgentHookDefinition extends BaseHookDefinition {
3040
- type: "agent";
3041
- prompt: string;
3042
- agent?: string;
3043
- model?: string;
3020
+ declare class XenoSpecValidationError extends Error {
3021
+ readonly issues: string[];
3022
+ readonly code = "XENO_SPEC_INVALID";
3023
+ constructor(issues: string[]);
3044
3024
  }
3045
- type HookDefinition = CommandHookDefinition | HttpHookDefinition | PromptHookDefinition | AgentHookDefinition;
3046
- type HookInput = HookInvocationInput;
3047
- interface HookConfig {
3048
- hooks?: HookDefinition[];
3049
- events?: Partial<Record<HookEventName, HookDefinition[]>>;
3025
+ declare class XenoSpecLifecycleService {
3026
+ private readonly repository;
3027
+ private readonly now;
3028
+ private readonly idFactory;
3029
+ constructor(options: XenoSpecLifecycleServiceOptions);
3030
+ create(document: XenoSpecDocument, context: XenoSpecArtifactContext): Promise<XenoSpecArtifactBundle>;
3031
+ revise(document: XenoSpecDocument, context: XenoSpecArtifactContext): Promise<XenoSpecArtifactBundle>;
3032
+ approve(specId: string, reviewer: XenoArtifactActor, rationale?: string): Promise<XenoArtifactRecord>;
3033
+ reject(specId: string, reviewer: XenoArtifactActor, rationale: string): Promise<XenoArtifactRecord>;
3034
+ startExecution(specId: string, actor: XenoArtifactActor): Promise<XenoArtifactRecord>;
3035
+ updateExecution(executionArtifactId: string, update: (record: XenoSpecExecutionRecord) => XenoSpecExecutionRecord, actor: XenoArtifactActor): Promise<XenoArtifactRecord>;
3050
3036
  }
3051
- type HookModelExecutor = (definition: PromptHookDefinition | AgentHookDefinition, input: HookInvocationInput) => HookDecision | Promise<HookDecision>;
3052
- type HookExecutionStatus = "allowed" | "blocked" | "asked" | "modified" | "continued" | "errored" | "timed_out";
3053
- interface HookExecutionResult {
3054
- hook: HookDefinition;
3055
- status: HookExecutionStatus;
3056
- decision?: HookDecision;
3057
- exitCode?: number | null;
3058
- signal?: NodeJS.Signals | null;
3059
- stdout: string;
3060
- stderr: string;
3061
- stdoutTruncated: boolean;
3062
- stderrTruncated: boolean;
3063
- timedOut: boolean;
3064
- durationMs: number;
3065
- error?: string;
3037
+ declare function xenoSpecArtifactIds(specId: string): {
3038
+ plan: string;
3039
+ requirements: string;
3040
+ design: string;
3041
+ taskGraph: string;
3042
+ };
3043
+ declare function validateXenoSpecDocument(document: XenoSpecDocument): string[];
3044
+ declare function assertValidXenoSpecDocument(document: XenoSpecDocument): void;
3045
+ declare function xenoSpecToArtifactBundle(document: XenoSpecDocument, context: XenoSpecArtifactContext): XenoSpecArtifactBundle;
3046
+ declare function xenoArtifactToSpecDocument(artifact: XenoArtifactEnvelope): XenoSpecDocument;
3047
+ declare function xenoSpecExecutionToArtifact(execution: XenoSpecExecutionRecord, context: XenoSpecArtifactContext, revision?: number, predecessorRevision?: number): XenoArtifactEnvelope;
3048
+ declare function xenoArtifactToSpecExecution(artifact: XenoArtifactEnvelope): XenoSpecExecutionRecord;
3049
+ declare function assertValidXenoSpecExecution(execution: XenoSpecExecutionRecord, document: XenoSpecDocument): void;
3050
+ declare function detectXenoSpecDrift(document: XenoSpecDocument, planHash: XenoContentHash, execution: XenoSpecExecutionRecord, actualPlanHash: XenoContentHash, checkedAt?: string): XenoSpecDriftReport;
3051
+ declare const XENO_REVIEW_REPORT_SCHEMA_VERSION: "xeno.review-report.v1";
3052
+ declare const XENO_REVIEW_DIMENSIONS: readonly [
3053
+ "correctness",
3054
+ "security",
3055
+ "performance",
3056
+ "api",
3057
+ "tests",
3058
+ "documentation"
3059
+ ];
3060
+ type XenoReviewDimension = (typeof XENO_REVIEW_DIMENSIONS)[number] | `custom:${string}`;
3061
+ type XenoReviewSeverity = "info" | "low" | "medium" | "high" | "critical";
3062
+ type XenoReviewFindingState = "verified" | "unverified" | "rejected";
3063
+ type XenoReviewVerificationOutcome = "reproduced" | "rejected" | "inconclusive";
3064
+ declare const XENO_REVIEW_EVIDENCE_KINDS: readonly [
3065
+ "source",
3066
+ "test",
3067
+ "trace",
3068
+ "artifact",
3069
+ "reproduction",
3070
+ "benchmark"
3071
+ ];
3072
+ type XenoReviewEvidenceKind = (typeof XENO_REVIEW_EVIDENCE_KINDS)[number] | `custom:${string}`;
3073
+ interface XenoReviewEvidence {
3074
+ evidenceId: string;
3075
+ kind: XenoReviewEvidenceKind;
3076
+ summary: string;
3077
+ producerId: string;
3078
+ reference?: XenoEvidenceReference;
3079
+ anchor?: XenoArtifactAnchor;
3080
+ contentHash?: XenoContentHash;
3066
3081
  }
3067
- interface HookRunResult {
3068
- decision: HookDecision;
3069
- results: HookExecutionResult[];
3070
- context: string[];
3071
- systemMessages: string[];
3082
+ interface XenoReviewFindingProposal {
3083
+ ruleId?: string;
3084
+ dimension: XenoReviewDimension;
3085
+ title: string;
3086
+ summary: string;
3087
+ severity: XenoReviewSeverity;
3088
+ confidence: number;
3089
+ anchors: XenoArtifactAnchor[];
3090
+ evidence: XenoReviewEvidence[];
3091
+ remediation?: string;
3072
3092
  }
3073
- interface HookRuntimeOptions {
3074
- defaultTimeoutMs?: number;
3075
- defaultMaxOutputBytes?: number;
3076
- env?: NodeJS.ProcessEnv;
3077
- permissionProfile?: PermissionProfile;
3078
- promptExecutor?: HookModelExecutor;
3079
- agentExecutor?: HookModelExecutor;
3093
+ interface XenoReviewAgentResult {
3094
+ reviewerAgentId: string;
3095
+ dimension: XenoReviewDimension;
3096
+ findings: XenoReviewFindingProposal[];
3097
+ completedAt: string;
3080
3098
  }
3081
- declare function normalizeHookDecision(value: unknown): HookDecision;
3082
- declare function buildHookEnvironment(input: HookInvocationInput, definition: CommandHookDefinition, sourceEnv?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
3083
- declare function hookResultStatus(decision: HookDecision | undefined): HookExecutionResult["status"];
3084
- declare function runCommandHook(definition: CommandHookDefinition, input: HookInvocationInput, options?: HookRuntimeOptions): Promise<HookExecutionResult>;
3085
- declare function runHttpHook(definition: HttpHookDefinition, input: HookInvocationInput, options?: HookRuntimeOptions): Promise<HookExecutionResult>;
3086
- declare function runPromptHook(definition: PromptHookDefinition, input: HookInvocationInput, options?: HookRuntimeOptions): Promise<HookExecutionResult>;
3087
- declare function runAgentHook(definition: AgentHookDefinition, input: HookInvocationInput, options?: HookRuntimeOptions): Promise<HookExecutionResult>;
3088
- declare class PromptHookRunner {
3089
- private readonly executor;
3090
- private readonly options;
3091
- constructor(executor: HookModelExecutor, options?: HookRuntimeOptions);
3092
- run(definition: PromptHookDefinition, input: HookInvocationInput): Promise<HookExecutionResult>;
3099
+ interface XenoReviewVerificationResult {
3100
+ verifierAgentId: string;
3101
+ outcome: XenoReviewVerificationOutcome;
3102
+ rationale: string;
3103
+ evidence: XenoReviewEvidence[];
3104
+ confidence?: number;
3105
+ completedAt: string;
3093
3106
  }
3094
- declare class AgentHookRunner {
3095
- private readonly executor;
3096
- private readonly options;
3097
- constructor(executor: HookModelExecutor, options?: HookRuntimeOptions);
3098
- run(definition: AgentHookDefinition, input: HookInvocationInput): Promise<HookExecutionResult>;
3107
+ interface XenoReviewFinding {
3108
+ findingId: string;
3109
+ fingerprint: string;
3110
+ ruleIds: string[];
3111
+ dimensions: XenoReviewDimension[];
3112
+ reviewerAgentIds: string[];
3113
+ title: string;
3114
+ summary: string;
3115
+ severity: XenoReviewSeverity;
3116
+ confidence: number;
3117
+ state: XenoReviewFindingState;
3118
+ verificationBasis: "verifier" | "independent-evidence" | "none";
3119
+ anchors: XenoArtifactAnchor[];
3120
+ evidence: XenoReviewEvidence[];
3121
+ verifications: XenoReviewVerificationResult[];
3122
+ remediation?: string;
3123
+ duplicateProposalCount: number;
3099
3124
  }
3100
- declare function runHookDefinition(hook: HookDefinition, input: HookInvocationInput, options?: HookRuntimeOptions): Promise<HookExecutionResult>;
3101
- declare function runHooks(hooks: readonly HookDefinition[], input: HookInvocationInput, options?: HookRuntimeOptions): Promise<HookRunResult>;
3102
- declare class HookRunner {
3103
- private readonly hooks;
3104
- private readonly options;
3105
- constructor(hooks: readonly HookDefinition[], options?: HookRuntimeOptions);
3106
- run(input: HookInvocationInput): Promise<HookRunResult>;
3125
+ interface XenoReviewTarget {
3126
+ artifactId: string;
3127
+ revision: number;
3128
+ contentHash: XenoContentHash;
3129
+ title: string;
3130
+ repositoryId?: string;
3131
+ commit?: string;
3132
+ anchors?: XenoArtifactAnchor[];
3107
3133
  }
3108
- declare class HookRuntime {
3109
- private readonly config;
3110
- private readonly options;
3111
- constructor(config: HookConfig, options?: HookRuntimeOptions);
3112
- run(input: HookInvocationInput): Promise<HookRunResult>;
3134
+ interface XenoReviewPack {
3135
+ schemaVersion: "xeno.review-pack.v1";
3136
+ packId: string;
3137
+ version: string;
3138
+ dimensions: XenoReviewDimension[];
3139
+ verifierCount: number;
3140
+ minimumVerifierReproductions: number;
3141
+ allowIndependentEvidenceVerification: boolean;
3142
+ minimumIndependentEvidenceProducers: number;
3143
+ maxFindings: number;
3113
3144
  }
3114
- declare class CommandHookRunner {
3115
- private readonly options;
3116
- constructor(options?: HookRuntimeOptions);
3117
- run(definition: CommandHookDefinition, input: HookInvocationInput): Promise<HookExecutionResult>;
3145
+ interface XenoReviewReport {
3146
+ schemaVersion: typeof XENO_REVIEW_REPORT_SCHEMA_VERSION;
3147
+ reportId: string;
3148
+ runId: string;
3149
+ pack: XenoReviewPack;
3150
+ target: XenoReviewTarget;
3151
+ startedAt: string;
3152
+ completedAt: string;
3153
+ reviewers: Array<{
3154
+ agentId: string;
3155
+ dimension: XenoReviewDimension;
3156
+ findingCount: number;
3157
+ }>;
3158
+ findings: XenoReviewFinding[];
3159
+ summary: {
3160
+ total: number;
3161
+ verified: number;
3162
+ unverified: number;
3163
+ rejected: number;
3164
+ bySeverity: Record<XenoReviewSeverity, number>;
3165
+ };
3118
3166
  }
3119
- declare class HttpHookRunner {
3120
- private readonly options;
3121
- constructor(options?: HookRuntimeOptions);
3122
- run(definition: HttpHookDefinition, input: HookInvocationInput): Promise<HookExecutionResult>;
3167
+ interface XenoReviewCoordinatorContext {
3168
+ runId: string;
3169
+ target: XenoReviewTarget;
3170
+ pack: XenoReviewPack;
3123
3171
  }
3124
- declare const CONFIG_VERSION = 2;
3125
- declare const PROJECT_STATE_VERSION = 3;
3126
- type ProjectMcpApprovalDecision = "approved" | "denied";
3127
- interface ProjectTokenUsageSummary {
3128
- input: number;
3129
- output: number;
3130
- total: number;
3172
+ type XenoReviewAgentExecutor = (request: XenoReviewCoordinatorContext & {
3173
+ dimension: XenoReviewDimension;
3174
+ reviewerSlot: number;
3175
+ }) => Promise<XenoReviewAgentResult>;
3176
+ type XenoReviewVerifierExecutor = (request: XenoReviewCoordinatorContext & {
3177
+ finding: XenoReviewFinding;
3178
+ verifierSlot: number;
3179
+ }) => Promise<XenoReviewVerificationResult>;
3180
+ interface XenoMultiAgentReviewCoordinatorOptions {
3181
+ reviewer: XenoReviewAgentExecutor;
3182
+ verifier?: XenoReviewVerifierExecutor;
3183
+ now?: () => string;
3184
+ idFactory?: (prefix: "report" | "finding") => string;
3131
3185
  }
3132
- interface ProjectSessionSummary {
3133
- sessionId?: string;
3134
- mode?: "chat" | "run" | "save";
3135
- status?: string;
3136
- role?: string;
3137
- model: string;
3138
- startedAt: string;
3139
- endedAt: string;
3140
- durationMs: number;
3141
- messageCount?: number;
3142
- tokenUsage: ProjectTokenUsageSummary;
3143
- estimatedCostUsd: number;
3186
+ interface XenoReviewArtifactContext {
3187
+ producer: XenoArtifactActor;
3188
+ identity?: XenoArtifactIdentity;
3189
+ sensitivity?: XenoArtifactSensitivity;
3190
+ accessPolicyId?: string;
3191
+ artifactId?: string;
3192
+ createdAt?: string;
3144
3193
  }
3145
- interface XenoUserConfig {
3146
- configVersion?: number;
3147
- apiKey?: string;
3148
- model?: string;
3149
- effort?: AgentEffortLevel;
3150
- fallbackModels?: string[];
3151
- worktree?: {
3152
- enabledForBackgroundRuns?: boolean;
3153
- baseRef?: string;
3154
- root?: string;
3155
- cleanupCompletedAfterDays?: number;
3156
- };
3157
- baseURL?: string;
3158
- maxTokens?: number;
3159
- maxIterations?: number;
3160
- permissionMode?: "default" | "acceptEdits" | "bypassPermissions" | "auto";
3161
- permissionProfile?: "default" | "read-only" | "trusted-dev";
3162
- executionMode?: "agent" | "chatOnly";
3163
- uiColor?: string;
3164
- outputStyle?: string;
3165
- memoryContextSessions?: number;
3166
- memoryContextTokens?: number;
3167
- memoryContextChars?: number;
3168
- searchApiKey?: string;
3169
- searchProvider?: "brave" | "google" | "searxng" | "duckduckgo";
3170
- searxngUrl?: string;
3171
- googleCx?: string;
3172
- mcpEnabled?: boolean;
3173
- lastReleaseNotesSeen?: string;
3174
- terminalShiftEnterInstalled?: boolean;
3194
+ interface XenoGitHubReviewComment {
3195
+ findingId: string;
3196
+ path: string;
3197
+ line?: number;
3198
+ body: string;
3199
+ severity: XenoReviewSeverity;
3200
+ verified: boolean;
3175
3201
  }
3176
- interface XenoProjectState {
3177
- configVersion?: number;
3178
- trustedWorkspace?: boolean;
3179
- allowedTools?: string[];
3180
- allowedDirectories?: string[];
3181
- mcpApprovals?: Record<string, ProjectMcpApprovalDecision>;
3182
- lastSessionSummary?: ProjectSessionSummary;
3183
- hasCompletedProjectOnboarding?: boolean;
3202
+ declare class XenoReviewValidationError extends Error {
3203
+ readonly issues: string[];
3204
+ readonly code = "XENO_REVIEW_INVALID";
3205
+ constructor(issues: string[]);
3184
3206
  }
3185
- declare function getConfigDir(): string;
3186
- declare function getAgentHome(): string;
3187
- declare function getManagedConfigPath(): string | undefined;
3188
- declare function getProjectStatePath(cwd?: string): string;
3189
- declare function ensureProjectStateDir(cwd?: string): void;
3190
- declare function loadProjectState(cwd?: string): XenoProjectState;
3191
- declare function saveProjectState(cwd: string, updates: Partial<XenoProjectState>): void;
3192
- declare function updateProjectState(cwd: string, updater: (current: XenoProjectState) => XenoProjectState): XenoProjectState;
3193
- declare function isWorkspaceTrusted(cwd?: string): boolean;
3194
- declare function setWorkspaceTrusted(cwd?: string, trusted?: boolean): void;
3195
- declare function hasProjectOnboardingCompleted(cwd?: string): boolean;
3196
- declare function setProjectOnboardingCompleted(cwd?: string, completed?: boolean): void;
3197
- declare function addProjectAllowedTool(cwd: string, approvalKey: string): XenoProjectState;
3198
- declare function listProjectAllowedTools(cwd: string): string[];
3199
- declare function removeProjectAllowedTool(cwd: string, approvalKey: string): XenoProjectState;
3200
- declare function clearProjectAllowedTools(cwd: string): XenoProjectState;
3201
- declare function addProjectAllowedDirectory(cwd: string, directory: string): XenoProjectState;
3202
- declare function getProjectMcpApproval(cwd: string, approvalKey: string): ProjectMcpApprovalDecision | undefined;
3203
- declare function setProjectMcpApproval(cwd: string, approvalKey: string, decision: ProjectMcpApprovalDecision): XenoProjectState;
3204
- declare function clearProjectMcpApproval(cwd: string, approvalKey: string): XenoProjectState;
3205
- declare function listProjectMcpApprovals(cwd: string, scope?: string): Record<string, ProjectMcpApprovalDecision>;
3206
- declare function clearProjectMcpApprovals(cwd: string, scope?: string): XenoProjectState;
3207
- declare function getProjectLastSessionSummary(cwd?: string): ProjectSessionSummary | undefined;
3208
- declare function setProjectLastSessionSummary(cwd: string, summary: ProjectSessionSummary): XenoProjectState;
3209
- declare function clearProjectLastSessionSummary(cwd: string): XenoProjectState;
3210
- declare function ensureConfigDir(): void;
3211
- declare function loadConfig(): XenoUserConfig;
3212
- declare function loadUserConfig(): XenoUserConfig;
3213
- declare function saveConfig(updates: Partial<XenoUserConfig>): void;
3214
- type XenoCredentialType = "api-key" | "jwt" | "empty";
3215
- type XenoCredentialSource = "explicit" | "env" | "default" | "none";
3216
- type XenoAuthErrorCode = "token_expired" | "token_not_active" | "token_malformed";
3217
- interface XenoJwtPayload {
3218
- exp?: number;
3219
- iat?: number;
3220
- nbf?: number;
3221
- sub?: string;
3222
- userId?: string;
3223
- email?: string;
3224
- username?: string;
3225
- [key: string]: unknown;
3207
+ declare class XenoMultiAgentReviewCoordinator {
3208
+ private readonly reviewer;
3209
+ private readonly verifier?;
3210
+ private readonly now;
3211
+ private readonly idFactory;
3212
+ constructor(options: XenoMultiAgentReviewCoordinatorOptions);
3213
+ run(context: XenoReviewCoordinatorContext): Promise<XenoReviewReport>;
3214
+ }
3215
+ declare function defaultXenoReviewPack(packId?: string): XenoReviewPack;
3216
+ declare function assertValidXenoReviewPack(pack: XenoReviewPack): void;
3217
+ declare function assertValidXenoReviewTarget(target: XenoReviewTarget): void;
3218
+ declare function assertValidXenoReviewReport(report: XenoReviewReport): void;
3219
+ declare function xenoReviewReportToArtifact(report: XenoReviewReport, context: XenoReviewArtifactContext): XenoArtifactEnvelope;
3220
+ declare function xenoArtifactToReviewReport(artifact: XenoArtifactEnvelope): XenoReviewReport;
3221
+ declare function xenoReviewReportToGitHubComments(report: XenoReviewReport, options?: {
3222
+ verifiedOnly?: boolean;
3223
+ }): XenoGitHubReviewComment[];
3224
+ type AgentSelectionStrategy = "first" | "least-loaded" | "round-robin";
3225
+ interface AgentCard {
3226
+ id: string;
3227
+ name: string;
3228
+ description?: string;
3229
+ capabilities: string[];
3230
+ maxConcurrentTasks?: number;
3231
+ handler: AgentTaskHandler;
3232
+ }
3233
+ interface AgentTeam {
3234
+ id: string;
3235
+ name: string;
3236
+ description?: string;
3237
+ agentIds: string[];
3238
+ strategy?: AgentSelectionStrategy;
3239
+ }
3240
+ interface AgentLoadSnapshot {
3241
+ agentId: string;
3242
+ agentName: string;
3243
+ activeTasks: number;
3244
+ maxConcurrentTasks: number;
3245
+ availableSlots: number;
3246
+ isAvailable: boolean;
3247
+ }
3248
+ interface AgentTask {
3249
+ id: string;
3250
+ type: string;
3251
+ description: string;
3252
+ input: Record<string, unknown>;
3253
+ priority?: "low" | "normal" | "high" | "critical";
3254
+ createdAt: string;
3255
+ status: AgentTaskStatus;
3256
+ assignedTo?: string;
3257
+ createdBy?: string;
3258
+ parentTaskId?: string;
3259
+ timeoutMs?: number;
3260
+ }
3261
+ type AgentTaskStatus = "pending" | "assigned" | "running" | "completed" | "failed" | "cancelled" | "timeout";
3262
+ interface AgentTaskResult {
3263
+ taskId: string;
3264
+ status: "completed" | "failed" | "cancelled";
3265
+ result: unknown;
3266
+ error?: string;
3267
+ artifacts?: AgentArtifact[];
3268
+ durationMs?: number;
3269
+ }
3270
+ interface AgentArtifact {
3271
+ name: string;
3272
+ mimeType?: string;
3273
+ content: string;
3274
+ }
3275
+ type AgentTaskHandler = (task: AgentTask) => Promise<AgentTaskResult>;
3276
+ type A2AMessageType = "task-request" | "task-accepted" | "task-rejected" | "task-progress" | "task-completed" | "task-failed" | "capability-query" | "capability-response";
3277
+ interface A2AMessage {
3278
+ id: string;
3279
+ type: A2AMessageType;
3280
+ from: string;
3281
+ to: string;
3282
+ payload: Record<string, unknown>;
3283
+ timestamp: string;
3284
+ correlationId?: string;
3285
+ }
3286
+ interface AgentDispatchOptions {
3287
+ timeoutMs?: number;
3288
+ priority?: AgentTask["priority"];
3289
+ parentTaskId?: string;
3290
+ createdBy?: string;
3291
+ waitForCapacity?: boolean;
3292
+ maxQueueWaitMs?: number;
3293
+ }
3294
+ interface AgentCapabilityDispatchOptions extends AgentDispatchOptions {
3295
+ strategy?: AgentSelectionStrategy;
3296
+ teamId?: string;
3297
+ }
3298
+ declare class AgentRegistry {
3299
+ private agents;
3300
+ private teams;
3301
+ registerAgent(card: AgentCard): void;
3302
+ unregisterAgent(id: string): boolean;
3303
+ getAgent(id: string): AgentCard | undefined;
3304
+ findByCapability(capability: string): AgentCard[];
3305
+ listAgents(): AgentCard[];
3306
+ registerTeam(team: AgentTeam): void;
3307
+ unregisterTeam(id: string): boolean;
3308
+ getTeam(id: string): AgentTeam | undefined;
3309
+ listTeams(): AgentTeam[];
3310
+ listAgentsForTeam(teamId: string): AgentCard[];
3311
+ get size(): number;
3312
+ }
3313
+ declare class AgentProtocol {
3314
+ private registry;
3315
+ private messageLog;
3316
+ private activeTasks;
3317
+ private activeTasksByAgent;
3318
+ private capabilityRoundRobinCursor;
3319
+ constructor(registry: AgentRegistry);
3320
+ private getAgentCapacity;
3321
+ private getAgentActiveTaskCount;
3322
+ private isAgentAvailable;
3323
+ private reserveAgentTask;
3324
+ private releaseAgentTask;
3325
+ private waitForAgentCapacity;
3326
+ private getCapabilityCandidates;
3327
+ private compareAgentLoad;
3328
+ private selectAgentForCapability;
3329
+ getAgentLoad(agentId: string): AgentLoadSnapshot | undefined;
3330
+ listAgentLoads(options?: {
3331
+ capability?: string;
3332
+ teamId?: string;
3333
+ }): AgentLoadSnapshot[];
3334
+ delegateTask(agentId: string, taskSpec: {
3335
+ type: string;
3336
+ description: string;
3337
+ input: Record<string, unknown>;
3338
+ }, options?: AgentDispatchOptions): Promise<AgentTaskResult>;
3339
+ delegateByCapability(capability: string, taskSpec: {
3340
+ description: string;
3341
+ input: Record<string, unknown>;
3342
+ }, options?: AgentCapabilityDispatchOptions): Promise<AgentTaskResult>;
3343
+ delegateToTeam(teamId: string, taskSpec: {
3344
+ type: string;
3345
+ description: string;
3346
+ input: Record<string, unknown>;
3347
+ }, options?: Omit<AgentCapabilityDispatchOptions, "teamId">): Promise<AgentTaskResult>;
3348
+ getMessageLog(limit?: number): A2AMessage[];
3349
+ getActiveTasks(): AgentTask[];
3350
+ private logMessage;
3226
3351
  }
3227
- interface XenoResolvedApiKey {
3228
- apiKey: string;
3229
- source: XenoCredentialSource;
3230
- credentialType: XenoCredentialType;
3231
- expiresAt?: string;
3232
- expiresInMs?: number;
3352
+ interface FileSnapshot {
3353
+ path: string;
3354
+ exists: boolean;
3355
+ size: number;
3356
+ mtimeMs: number;
3357
+ text?: string;
3358
+ binary?: boolean;
3359
+ truncated?: boolean;
3233
3360
  }
3234
- interface ResolveXenoSdkApiKeyOptions {
3235
- explicitApiKey?: string;
3236
- env?: Record<string, string | undefined>;
3237
- envVar?: string;
3238
- defaultApiKey?: string;
3239
- nowMs?: number;
3240
- skewMs?: number;
3241
- allowExpired?: boolean;
3361
+ interface TurnFileDiff {
3362
+ path: string;
3363
+ status: "created" | "modified" | "deleted" | "unchanged";
3364
+ before?: FileSnapshot;
3365
+ after?: FileSnapshot;
3366
+ patch?: string;
3242
3367
  }
3243
- interface ValidateXenoSdkApiKeyOptions {
3244
- apiKey: string;
3245
- apiBaseURL: string;
3246
- fetchImpl?: typeof fetch;
3368
+ interface TurnDiffSummary {
3369
+ turnId: string;
3370
+ startedAt: string;
3371
+ completedAt: string;
3372
+ files: TurnFileDiff[];
3247
3373
  }
3248
- declare class XenoAuthError extends Error {
3249
- readonly code: XenoAuthErrorCode;
3250
- readonly expiresAt?: string;
3251
- constructor(message: string, code: XenoAuthErrorCode, context?: {
3252
- expiresAt?: string;
3253
- });
3374
+ interface TurnDiffTrackerOptions {
3375
+ maxFileBytes?: number;
3376
+ cwd?: string;
3254
3377
  }
3255
- declare function isJwt(value: string | undefined): value is string;
3256
- declare function decodeJwtPayload(token: string | undefined): XenoJwtPayload | undefined;
3257
- declare function getJwtExpiry(token: string | undefined): Date | undefined;
3258
- declare function isExpiredJwt(token: string | undefined, nowMs?: number, skewMs?: number): boolean;
3259
- declare function isNotBeforeJwt(token: string | undefined, nowMs?: number, skewMs?: number): boolean;
3260
- declare function assertUsableXenoApiKey(apiKey: string | undefined, options?: {
3261
- nowMs?: number;
3262
- skewMs?: number;
3263
- allowExpired?: boolean;
3264
- }): string;
3265
- declare function resolveXenoSdkApiKey(options?: ResolveXenoSdkApiKeyOptions): XenoResolvedApiKey;
3266
- declare function validateXenoSdkApiKey(options: ValidateXenoSdkApiKeyOptions): Promise<{
3267
- valid: boolean;
3268
- error?: string;
3269
- }>;
3270
- declare const DEFAULT_API_KEY: string;
3271
- declare const XENO_API_BASE: string;
3272
- declare const XENO_RT_DEFAULT_URL: string;
3273
- declare const DEFAULT_MODEL: string;
3274
- declare const FALLBACK_MODELS: readonly string[];
3275
- interface ModelInfo {
3276
- id: string;
3277
- name: string;
3278
- owned_by: string;
3279
- source: "xeno" | "local";
3280
- type?: string;
3281
- output_modalities?: string[];
3282
- available?: boolean;
3283
- contextWindow?: number;
3284
- maxCompletionTokens?: number;
3378
+ declare class TurnDiffTracker {
3379
+ private active?;
3380
+ private readonly maxFileBytes;
3381
+ private readonly cwd;
3382
+ constructor(options?: TurnDiffTrackerOptions);
3383
+ beginTurn(turnId: string): void;
3384
+ observeBefore(paths: Iterable<string | null | undefined>): void;
3385
+ observeAfter(paths: Iterable<string | null | undefined>): void;
3386
+ endTurn(): TurnDiffSummary | undefined;
3387
+ inferToolPaths(toolName: string, input: Record<string, unknown>): string[];
3388
+ private resolvePath;
3389
+ private snapshot;
3285
3390
  }
3286
- interface LocalRuntimePreflightResult {
3287
- ok: boolean;
3391
+ interface XenoLegacyArtifactContext {
3392
+ artifactId?: string;
3393
+ revision?: number;
3394
+ createdAt?: string;
3395
+ producer: XenoArtifactActor;
3396
+ identity?: XenoArtifactIdentity;
3397
+ state?: XenoArtifactState;
3398
+ sensitivity?: XenoArtifactSensitivity;
3399
+ accessPolicyId?: string;
3400
+ }
3401
+ interface XenoLegacyAgentArtifactContext extends XenoLegacyArtifactContext {
3402
+ contentEncoding?: "utf8" | "base64";
3403
+ kind?: XenoArtifactKind;
3404
+ }
3405
+ declare function legacyAgentArtifactToXenoArtifact(legacy: AgentArtifact, context: XenoLegacyAgentArtifactContext): XenoArtifactEnvelope;
3406
+ declare function xenoArtifactToLegacyAgentArtifact(artifact: XenoArtifactEnvelope): AgentArtifact;
3407
+ declare function toolEvidenceToXenoArtifact(evidence: ToolEvidence, context: XenoLegacyArtifactContext): XenoArtifactEnvelope;
3408
+ declare function xenoArtifactToToolEvidence(artifact: XenoArtifactEnvelope): ToolEvidence;
3409
+ declare function turnDiffSummaryToXenoArtifact(summary: TurnDiffSummary, context: XenoLegacyArtifactContext): XenoArtifactEnvelope;
3410
+ declare function xenoArtifactToTurnDiffSummary(artifact: XenoArtifactEnvelope): TurnDiffSummary;
3411
+ type HookEventName = "SessionStart" | "UserPromptSubmit" | "PermissionRequest" | "PreToolUse" | "PostToolUse" | "PreCompact" | "PostCompact" | "Stop" | "StopFailure" | "SubagentStart" | "SubagentStop";
3412
+ type HookPermissionMode = AgentPermissionMode;
3413
+ interface HookInputBase {
3414
+ schemaVersion: 1;
3415
+ event: HookEventName;
3416
+ sessionId: string;
3417
+ runId: string;
3418
+ rootRunId: string;
3419
+ agentId: string;
3420
+ agentName?: string;
3421
+ agentColor?: string;
3422
+ parentAgentId?: string;
3423
+ cwd: string;
3424
+ transcriptPath?: string;
3425
+ permissionMode: HookPermissionMode;
3288
3426
  model: string;
3289
- baseUrl: string;
3290
- endpoint?: "openai" | "native";
3291
- warning?: string;
3292
- error?: string;
3427
+ effort?: string;
3428
+ timestamp: string;
3293
3429
  }
3294
- declare function cachedModelContextWindow(modelId: string): number | undefined;
3295
- declare function getAvailableModels(options?: {
3296
- apiKey?: string;
3297
- localRuntimeUrl?: string;
3298
- forceRefresh?: boolean;
3299
- }): Promise<ModelInfo[]>;
3300
- declare function isLocalModel(model: string): boolean;
3301
- declare function getModelName(model: string): string;
3302
- declare function preflightLocalModel(model: string, options?: {
3303
- localRuntimeUrl?: string;
3430
+ interface HookInvocationInput extends HookInputBase {
3431
+ prompt?: string;
3432
+ toolName?: string;
3433
+ toolInput?: Record<string, unknown>;
3434
+ toolResult?: unknown;
3435
+ finalText?: string;
3436
+ metadata?: Record<string, unknown>;
3437
+ }
3438
+ type HookDecision = {
3439
+ decision: "allow";
3440
+ systemMessage?: string;
3441
+ context?: string;
3442
+ } | {
3443
+ decision: "block";
3444
+ reason: string;
3445
+ systemMessage?: string;
3446
+ } | {
3447
+ decision: "ask";
3448
+ reason: string;
3449
+ prompt: string;
3450
+ } | {
3451
+ decision: "modify";
3452
+ patch: unknown;
3453
+ reason?: string;
3454
+ } | {
3455
+ decision: "continue";
3456
+ context?: string;
3457
+ systemMessage?: string;
3458
+ };
3459
+ interface BaseHookDefinition {
3460
+ name?: string;
3461
+ events?: HookEventName[];
3304
3462
  timeoutMs?: number;
3305
- }): Promise<LocalRuntimePreflightResult>;
3306
- declare function isValidModel(model: string, apiKey?: string, forceRefresh?: boolean): Promise<boolean>;
3307
- declare function isChatModel(model: ModelInfo): boolean;
3308
- declare function getChatModels(apiKey?: string, forceRefresh?: boolean): Promise<ModelInfo[]>;
3309
- declare function formatModelList(apiKey?: string, showAll?: boolean, forceRefresh?: boolean): Promise<string>;
3310
- interface ProfileMCPServerConfig {
3311
- name: string;
3463
+ maxOutputBytes?: number;
3464
+ failClosed?: boolean;
3465
+ async?: boolean;
3466
+ }
3467
+ interface CommandHookDefinition extends BaseHookDefinition {
3468
+ type: "command";
3312
3469
  command: string;
3313
3470
  args?: string[];
3314
- env?: Record<string, string>;
3315
3471
  cwd?: string;
3472
+ shell?: boolean;
3473
+ env?: Record<string, string>;
3316
3474
  }
3317
- interface ConfigProfile {
3318
- name: string;
3319
- apiKey?: string;
3320
- baseURL?: string;
3321
- model?: string;
3322
- maxTokens?: number;
3323
- permissionMode?: "default" | "acceptEdits" | "bypassPermissions" | "auto";
3324
- plugins?: string[];
3325
- mcpServers?: ProfileMCPServerConfig[];
3475
+ interface HttpHookDefinition extends BaseHookDefinition {
3476
+ type: "http";
3477
+ url: string;
3478
+ method?: "POST";
3479
+ headers?: Record<string, string>;
3326
3480
  }
3327
- declare class ProfileManager {
3328
- private data;
3329
- private filePath;
3330
- constructor();
3331
- listProfiles(): ConfigProfile[];
3332
- getActiveProfile(): ConfigProfile;
3333
- getActiveProfileName(): string;
3334
- switchProfile(name: string): void;
3335
- createProfile(profile: ConfigProfile): void;
3336
- deleteProfile(name: string): void;
3337
- updateProfile(name: string, updates: Partial<ConfigProfile>): void;
3338
- getProfile(name: string): ConfigProfile | undefined;
3339
- reload(): void;
3340
- private load;
3341
- private save;
3481
+ interface PromptHookDefinition extends BaseHookDefinition {
3482
+ type: "prompt";
3483
+ prompt: string;
3342
3484
  }
3343
- interface ProjectConfig {
3485
+ interface AgentHookDefinition extends BaseHookDefinition {
3486
+ type: "agent";
3487
+ prompt: string;
3488
+ agent?: string;
3344
3489
  model?: string;
3345
- systemPrompt?: string;
3346
- permissions?: {
3347
- allowedCommands?: string[];
3348
- deniedCommands?: string[];
3349
- };
3350
- ignorePatterns?: string[];
3351
3490
  }
3352
- declare function loadProjectConfig(cwd?: string): ProjectConfig | null;
3353
- declare function mergeConfigs(base: ProjectConfig, override: ProjectConfig): ProjectConfig;
3354
- interface SessionData {
3355
- id: string;
3356
- model: string;
3357
- workingDirectory: string;
3358
- createdAt: string;
3359
- updatedAt: string;
3360
- messages: Message[];
3361
- totalTokensUsed: number;
3491
+ type HookDefinition = CommandHookDefinition | HttpHookDefinition | PromptHookDefinition | AgentHookDefinition;
3492
+ type HookInput = HookInvocationInput;
3493
+ interface HookConfig {
3494
+ hooks?: HookDefinition[];
3495
+ events?: Partial<Record<HookEventName, HookDefinition[]>>;
3496
+ }
3497
+ type HookModelExecutor = (definition: PromptHookDefinition | AgentHookDefinition, input: HookInvocationInput) => HookDecision | Promise<HookDecision>;
3498
+ type HookExecutionStatus = "allowed" | "blocked" | "asked" | "modified" | "continued" | "errored" | "timed_out";
3499
+ interface HookExecutionResult {
3500
+ hook: HookDefinition;
3501
+ status: HookExecutionStatus;
3502
+ decision?: HookDecision;
3503
+ exitCode?: number | null;
3504
+ signal?: NodeJS.Signals | null;
3505
+ stdout: string;
3506
+ stderr: string;
3507
+ stdoutTruncated: boolean;
3508
+ stderrTruncated: boolean;
3509
+ timedOut: boolean;
3510
+ durationMs: number;
3511
+ error?: string;
3512
+ }
3513
+ interface HookRunResult {
3514
+ decision: HookDecision;
3515
+ results: HookExecutionResult[];
3516
+ context: string[];
3517
+ systemMessages: string[];
3362
3518
  }
3363
- interface SessionSummary {
3364
- id: string;
3365
- createdAt: string;
3366
- updatedAt: string;
3367
- model: string;
3368
- workingDirectory: string;
3369
- preview: string;
3370
- messageCount: number;
3519
+ interface HookRuntimeOptions {
3520
+ defaultTimeoutMs?: number;
3521
+ defaultMaxOutputBytes?: number;
3522
+ env?: NodeJS.ProcessEnv;
3523
+ permissionProfile?: PermissionProfile;
3524
+ promptExecutor?: HookModelExecutor;
3525
+ agentExecutor?: HookModelExecutor;
3371
3526
  }
3372
- declare function saveSession(id: string | null, messages: Message[], model: string, totalTokensUsed: number): string;
3373
- declare function loadSession(id: string): SessionData | null;
3374
- declare function listSessions(limit?: number): SessionSummary[];
3375
- declare function deleteSession(id: string): boolean;
3376
- interface ModelProvider {
3377
- id: string;
3378
- name: string;
3379
- baseURL: string;
3380
- apiKeyEnvVar: string;
3381
- defaultApiKey?: string;
3382
- modelPrefixes: string[];
3383
- models: string[];
3384
- supportsStreaming: boolean;
3385
- supportsToolUse: boolean;
3386
- maxContextTokens?: number;
3387
- headers?: Record<string, string>;
3388
- requestFormat?: "openai" | "google";
3527
+ declare function normalizeHookDecision(value: unknown): HookDecision;
3528
+ declare function buildHookEnvironment(input: HookInvocationInput, definition: CommandHookDefinition, sourceEnv?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
3529
+ declare function hookResultStatus(decision: HookDecision | undefined): HookExecutionResult["status"];
3530
+ declare function runCommandHook(definition: CommandHookDefinition, input: HookInvocationInput, options?: HookRuntimeOptions): Promise<HookExecutionResult>;
3531
+ declare function runHttpHook(definition: HttpHookDefinition, input: HookInvocationInput, options?: HookRuntimeOptions): Promise<HookExecutionResult>;
3532
+ declare function runPromptHook(definition: PromptHookDefinition, input: HookInvocationInput, options?: HookRuntimeOptions): Promise<HookExecutionResult>;
3533
+ declare function runAgentHook(definition: AgentHookDefinition, input: HookInvocationInput, options?: HookRuntimeOptions): Promise<HookExecutionResult>;
3534
+ declare class PromptHookRunner {
3535
+ private readonly executor;
3536
+ private readonly options;
3537
+ constructor(executor: HookModelExecutor, options?: HookRuntimeOptions);
3538
+ run(definition: PromptHookDefinition, input: HookInvocationInput): Promise<HookExecutionResult>;
3389
3539
  }
3390
- interface ResolvedProvider {
3391
- provider: ModelProvider;
3392
- model: string;
3393
- baseURL: string;
3394
- apiKey: string;
3395
- headers: Record<string, string>;
3540
+ declare class AgentHookRunner {
3541
+ private readonly executor;
3542
+ private readonly options;
3543
+ constructor(executor: HookModelExecutor, options?: HookRuntimeOptions);
3544
+ run(definition: AgentHookDefinition, input: HookInvocationInput): Promise<HookExecutionResult>;
3396
3545
  }
3397
- declare function resolveModelContextTokens(model: string): number | undefined;
3398
- declare class ModelProviderRegistry {
3399
- private providers;
3400
- constructor();
3401
- addProvider(provider: ModelProvider): void;
3402
- removeProvider(id: string): boolean;
3403
- getProvider(id: string): ModelProvider | undefined;
3404
- listProviders(): ModelProvider[];
3405
- resolveProvider(model: string, overrides?: {
3406
- apiKey?: string;
3407
- baseURL?: string;
3408
- }): ResolvedProvider;
3546
+ declare function runHookDefinition(hook: HookDefinition, input: HookInvocationInput, options?: HookRuntimeOptions): Promise<HookExecutionResult>;
3547
+ declare function runHooks(hooks: readonly HookDefinition[], input: HookInvocationInput, options?: HookRuntimeOptions): Promise<HookRunResult>;
3548
+ declare class HookRunner {
3549
+ private readonly hooks;
3550
+ private readonly options;
3551
+ constructor(hooks: readonly HookDefinition[], options?: HookRuntimeOptions);
3552
+ run(input: HookInvocationInput): Promise<HookRunResult>;
3409
3553
  }
3410
- declare function getDefaultProviderRegistry(): ModelProviderRegistry;
3411
- interface MemoryFile {
3412
- level: MemoryLevel;
3413
- path: string;
3414
- content: string;
3415
- tokenCount: number;
3416
- lastModified?: Date;
3554
+ declare class HookRuntime {
3555
+ private readonly config;
3556
+ private readonly options;
3557
+ constructor(config: HookConfig, options?: HookRuntimeOptions);
3558
+ run(input: HookInvocationInput): Promise<HookRunResult>;
3417
3559
  }
3418
- interface ResolvedMemory {
3419
- files: MemoryFile[];
3420
- byLevel: Record<MemoryLevel, string>;
3421
- totalTokens: number;
3422
- truncated: boolean;
3560
+ declare class CommandHookRunner {
3561
+ private readonly options;
3562
+ constructor(options?: HookRuntimeOptions);
3563
+ run(definition: CommandHookDefinition, input: HookInvocationInput): Promise<HookExecutionResult>;
3423
3564
  }
3424
- interface ProjectSessionContextEntry {
3425
- sessionId: string;
3426
- model: string;
3427
- lastActivity: string;
3428
- messageCount: number;
3429
- excerpt: string;
3565
+ declare class HttpHookRunner {
3566
+ private readonly options;
3567
+ constructor(options?: HookRuntimeOptions);
3568
+ run(definition: HttpHookDefinition, input: HookInvocationInput): Promise<HookExecutionResult>;
3430
3569
  }
3431
- interface ProjectSessionContext {
3432
- entries: ProjectSessionContextEntry[];
3433
- totalTokens: number;
3434
- truncated: boolean;
3435
- content: string;
3570
+ declare const CONFIG_VERSION = 2;
3571
+ declare const PROJECT_STATE_VERSION = 3;
3572
+ type ProjectMcpApprovalDecision = "approved" | "denied";
3573
+ interface ProjectTokenUsageSummary {
3574
+ input: number;
3575
+ output: number;
3576
+ total: number;
3436
3577
  }
3437
- declare const DEFAULT_MEMORY_BUDGETS: MemoryBudget;
3438
- declare const MEMORY_FILES: Record<MemoryLevel, string>;
3439
- interface MemoryManagerOptions {
3440
- cwd: string;
3441
- globalDir?: string;
3578
+ interface ProjectSessionSummary {
3579
+ sessionId?: string;
3580
+ mode?: "chat" | "run" | "save";
3581
+ status?: string;
3442
3582
  role?: string;
3443
- sessionDir?: string;
3444
- scope?: MemoryAccessScope;
3445
- budgets?: Partial<MemoryBudget>;
3446
- projectSessionContext?: {
3447
- limit?: number;
3448
- maxTokens?: number;
3449
- maxCharsPerSession?: number;
3450
- };
3583
+ model: string;
3584
+ startedAt: string;
3585
+ endedAt: string;
3586
+ durationMs: number;
3587
+ messageCount?: number;
3588
+ tokenUsage: ProjectTokenUsageSummary;
3589
+ estimatedCostUsd: number;
3451
3590
  }
3452
- type MemoryAccessScope = "none" | "session" | "project" | "user";
3453
- declare class MemoryManager {
3454
- private cwd;
3455
- private globalDir;
3456
- private role?;
3457
- private sessionDir?;
3458
- private scope;
3459
- private budgets;
3460
- private projectSessionContextDefaults;
3461
- constructor(options: MemoryManagerOptions);
3462
- get accessScope(): MemoryAccessScope;
3463
- canAccessLevel(level: MemoryLevel): boolean;
3464
- private assertLevelAccess;
3465
- getProjectSessionContextDefaults(): {
3466
- limit: number;
3467
- maxTokens: number;
3468
- maxCharsPerSession: number;
3591
+ interface XenoUserConfig {
3592
+ configVersion?: number;
3593
+ apiKey?: string;
3594
+ model?: string;
3595
+ effort?: AgentEffortLevel;
3596
+ fallbackModels?: string[];
3597
+ worktree?: {
3598
+ enabledForBackgroundRuns?: boolean;
3599
+ baseRef?: string;
3600
+ root?: string;
3601
+ cleanupCompletedAfterDays?: number;
3469
3602
  };
3470
- getPath(level: MemoryLevel): string;
3471
- loadForPrompt(): Promise<ResolvedMemory>;
3472
- loadProjectSessionContext(options?: {
3473
- excludeSessionId?: string;
3474
- limit?: number;
3475
- maxTokens?: number;
3476
- maxCharsPerSession?: number;
3477
- }): Promise<ProjectSessionContext>;
3478
- private filterProjectSessions;
3479
- private normalizePath;
3480
- private extractRecentTranscriptExcerpt;
3481
- private formatProjectSessionEntry;
3482
- add(level: MemoryLevel, content: string, source: "user" | "auto"): Promise<void>;
3483
- set(level: MemoryLevel, content: string): Promise<void>;
3484
- formatForPrompt(memory: ResolvedMemory): string;
3485
- private truncateContent;
3486
- }
3487
- interface AutoMemoryContext {
3488
- error?: string;
3489
- correction?: string;
3490
- taskCompleted?: boolean;
3491
- userPreference?: string;
3492
- }
3493
- declare class AutoMemory {
3494
- private manager;
3495
- private recentErrors;
3496
- constructor(manager: MemoryManager);
3497
- shouldTrigger(context: AutoMemoryContext): AutoMemoryTrigger | null;
3498
- extract(trigger: AutoMemoryTrigger, messages: Message[]): Promise<string | null>;
3499
- private extractErrorCorrection;
3500
- private extractPattern;
3501
- private extractPreference;
3502
- private extractTaskSummary;
3503
- private messagesToText;
3504
- private normalizeError;
3603
+ baseURL?: string;
3604
+ maxTokens?: number;
3605
+ maxIterations?: number;
3606
+ permissionMode?: "default" | "acceptEdits" | "bypassPermissions" | "auto";
3607
+ permissionProfile?: "default" | "read-only" | "trusted-dev";
3608
+ executionMode?: "agent" | "chatOnly";
3609
+ uiColor?: string;
3610
+ outputStyle?: string;
3611
+ memoryContextSessions?: number;
3612
+ memoryContextTokens?: number;
3613
+ memoryContextChars?: number;
3614
+ searchApiKey?: string;
3615
+ searchProvider?: "brave" | "google" | "searxng" | "duckduckgo";
3616
+ searxngUrl?: string;
3617
+ googleCx?: string;
3618
+ mcpEnabled?: boolean;
3619
+ lastReleaseNotesSeen?: string;
3620
+ terminalShiftEnterInstalled?: boolean;
3505
3621
  }
3506
- interface VectorDocument {
3507
- id: string;
3508
- content: string;
3509
- embedding: number[];
3510
- metadata: Record<string, unknown>;
3622
+ interface XenoProjectState {
3623
+ configVersion?: number;
3624
+ trustedWorkspace?: boolean;
3625
+ allowedTools?: string[];
3626
+ allowedDirectories?: string[];
3627
+ mcpApprovals?: Record<string, ProjectMcpApprovalDecision>;
3628
+ lastSessionSummary?: ProjectSessionSummary;
3629
+ hasCompletedProjectOnboarding?: boolean;
3511
3630
  }
3512
- interface VectorSearchResult {
3513
- id: string;
3514
- content: string;
3515
- score: number;
3516
- metadata: Record<string, unknown>;
3631
+ declare function getConfigDir(): string;
3632
+ declare function getAgentHome(): string;
3633
+ declare function getManagedConfigPath(): string | undefined;
3634
+ declare function getProjectStatePath(cwd?: string): string;
3635
+ declare function ensureProjectStateDir(cwd?: string): void;
3636
+ declare function loadProjectState(cwd?: string): XenoProjectState;
3637
+ declare function saveProjectState(cwd: string, updates: Partial<XenoProjectState>): void;
3638
+ declare function updateProjectState(cwd: string, updater: (current: XenoProjectState) => XenoProjectState): XenoProjectState;
3639
+ declare function isWorkspaceTrusted(cwd?: string): boolean;
3640
+ declare function setWorkspaceTrusted(cwd?: string, trusted?: boolean): void;
3641
+ declare function hasProjectOnboardingCompleted(cwd?: string): boolean;
3642
+ declare function setProjectOnboardingCompleted(cwd?: string, completed?: boolean): void;
3643
+ declare function addProjectAllowedTool(cwd: string, approvalKey: string): XenoProjectState;
3644
+ declare function listProjectAllowedTools(cwd: string): string[];
3645
+ declare function removeProjectAllowedTool(cwd: string, approvalKey: string): XenoProjectState;
3646
+ declare function clearProjectAllowedTools(cwd: string): XenoProjectState;
3647
+ declare function addProjectAllowedDirectory(cwd: string, directory: string): XenoProjectState;
3648
+ declare function getProjectMcpApproval(cwd: string, approvalKey: string): ProjectMcpApprovalDecision | undefined;
3649
+ declare function setProjectMcpApproval(cwd: string, approvalKey: string, decision: ProjectMcpApprovalDecision): XenoProjectState;
3650
+ declare function clearProjectMcpApproval(cwd: string, approvalKey: string): XenoProjectState;
3651
+ declare function listProjectMcpApprovals(cwd: string, scope?: string): Record<string, ProjectMcpApprovalDecision>;
3652
+ declare function clearProjectMcpApprovals(cwd: string, scope?: string): XenoProjectState;
3653
+ declare function getProjectLastSessionSummary(cwd?: string): ProjectSessionSummary | undefined;
3654
+ declare function setProjectLastSessionSummary(cwd: string, summary: ProjectSessionSummary): XenoProjectState;
3655
+ declare function clearProjectLastSessionSummary(cwd: string): XenoProjectState;
3656
+ declare function ensureConfigDir(): void;
3657
+ declare function loadConfig(): XenoUserConfig;
3658
+ declare function loadUserConfig(): XenoUserConfig;
3659
+ declare function saveConfig(updates: Partial<XenoUserConfig>): void;
3660
+ type XenoCredentialType = "api-key" | "jwt" | "empty";
3661
+ type XenoCredentialSource = "explicit" | "env" | "default" | "none";
3662
+ type XenoAuthErrorCode = "token_expired" | "token_not_active" | "token_malformed";
3663
+ interface XenoJwtPayload {
3664
+ exp?: number;
3665
+ iat?: number;
3666
+ nbf?: number;
3667
+ sub?: string;
3668
+ userId?: string;
3669
+ email?: string;
3670
+ username?: string;
3671
+ [key: string]: unknown;
3517
3672
  }
3518
- interface VectorStoreOptions {
3519
- maxDocuments?: number;
3520
- embeddingDimension?: number;
3521
- embedFn?: (text: string) => Promise<number[]>;
3673
+ interface XenoResolvedApiKey {
3674
+ apiKey: string;
3675
+ source: XenoCredentialSource;
3676
+ credentialType: XenoCredentialType;
3677
+ expiresAt?: string;
3678
+ expiresInMs?: number;
3522
3679
  }
3523
- interface VectorStoreAdapter {
3524
- add(id: string, embedding: number[], metadata: Record<string, unknown>): Promise<void>;
3525
- search(query: number[], topK: number): Promise<Array<{
3526
- id: string;
3527
- score: number;
3528
- }>>;
3529
- remove(id: string): Promise<void>;
3530
- readonly size: number;
3680
+ interface ResolveXenoSdkApiKeyOptions {
3681
+ explicitApiKey?: string;
3682
+ env?: Record<string, string | undefined>;
3683
+ envVar?: string;
3684
+ defaultApiKey?: string;
3685
+ nowMs?: number;
3686
+ skewMs?: number;
3687
+ allowExpired?: boolean;
3531
3688
  }
3532
- declare class VectorMemoryStore {
3533
- private documents;
3534
- private insertionOrder;
3535
- private maxDocuments;
3536
- private embedder;
3537
- private customEmbedFn?;
3538
- constructor(options?: VectorStoreOptions);
3539
- addDocument(id: string, content: string, metadata?: Record<string, unknown>): Promise<void>;
3540
- search(query: string, topK?: number, minScore?: number): Promise<VectorSearchResult[]>;
3541
- removeDocument(id: string): boolean;
3542
- getDocument(id: string): VectorDocument | undefined;
3543
- get size(): number;
3544
- clear(): void;
3545
- exportDocuments(): VectorDocument[];
3546
- importDocuments(docs: VectorDocument[]): void;
3689
+ interface ValidateXenoSdkApiKeyOptions {
3690
+ apiKey: string;
3691
+ apiBaseURL: string;
3692
+ fetchImpl?: typeof fetch;
3547
3693
  }
3548
- interface AskUserRequest {
3549
- question: string;
3550
- options?: string[];
3551
- context?: string;
3694
+ declare class XenoAuthError extends Error {
3695
+ readonly code: XenoAuthErrorCode;
3696
+ readonly expiresAt?: string;
3697
+ constructor(message: string, code: XenoAuthErrorCode, context?: {
3698
+ expiresAt?: string;
3699
+ });
3552
3700
  }
3553
- interface AskUserResponse {
3554
- answer: string;
3555
- selectedOption?: string;
3701
+ declare function isJwt(value: string | undefined): value is string;
3702
+ declare function decodeJwtPayload(token: string | undefined): XenoJwtPayload | undefined;
3703
+ declare function getJwtExpiry(token: string | undefined): Date | undefined;
3704
+ declare function isExpiredJwt(token: string | undefined, nowMs?: number, skewMs?: number): boolean;
3705
+ declare function isNotBeforeJwt(token: string | undefined, nowMs?: number, skewMs?: number): boolean;
3706
+ declare function assertUsableXenoApiKey(apiKey: string | undefined, options?: {
3707
+ nowMs?: number;
3708
+ skewMs?: number;
3709
+ allowExpired?: boolean;
3710
+ }): string;
3711
+ declare function resolveXenoSdkApiKey(options?: ResolveXenoSdkApiKeyOptions): XenoResolvedApiKey;
3712
+ declare function validateXenoSdkApiKey(options: ValidateXenoSdkApiKeyOptions): Promise<{
3713
+ valid: boolean;
3714
+ error?: string;
3715
+ }>;
3716
+ declare const DEFAULT_API_KEY: string;
3717
+ declare const XENO_API_BASE: string;
3718
+ declare const XENO_RT_DEFAULT_URL: string;
3719
+ declare const DEFAULT_MODEL: string;
3720
+ declare const FALLBACK_MODELS: readonly string[];
3721
+ interface ModelInfo {
3722
+ id: string;
3723
+ name: string;
3724
+ owned_by: string;
3725
+ source: "xeno" | "local";
3726
+ type?: string;
3727
+ output_modalities?: string[];
3728
+ available?: boolean;
3729
+ contextWindow?: number;
3730
+ maxCompletionTokens?: number;
3556
3731
  }
3557
- type AskUserHandler = (request: AskUserRequest) => Promise<AskUserResponse>;
3558
- interface DispatchAgentRequest {
3559
- agent?: string;
3560
- prompt: string;
3732
+ interface LocalRuntimePreflightResult {
3733
+ ok: boolean;
3734
+ model: string;
3735
+ baseUrl: string;
3736
+ endpoint?: "openai" | "native";
3737
+ warning?: string;
3738
+ error?: string;
3739
+ }
3740
+ declare function cachedModelContextWindow(modelId: string): number | undefined;
3741
+ declare function getAvailableModels(options?: {
3742
+ apiKey?: string;
3743
+ localRuntimeUrl?: string;
3744
+ forceRefresh?: boolean;
3745
+ }): Promise<ModelInfo[]>;
3746
+ declare function isLocalModel(model: string): boolean;
3747
+ declare function getModelName(model: string): string;
3748
+ declare function preflightLocalModel(model: string, options?: {
3749
+ localRuntimeUrl?: string;
3561
3750
  timeoutMs?: number;
3562
- signal?: AbortSignal;
3751
+ }): Promise<LocalRuntimePreflightResult>;
3752
+ declare function isValidModel(model: string, apiKey?: string, forceRefresh?: boolean): Promise<boolean>;
3753
+ declare function isChatModel(model: ModelInfo): boolean;
3754
+ declare function getChatModels(apiKey?: string, forceRefresh?: boolean): Promise<ModelInfo[]>;
3755
+ declare function formatModelList(apiKey?: string, showAll?: boolean, forceRefresh?: boolean): Promise<string>;
3756
+ interface ProfileMCPServerConfig {
3757
+ name: string;
3758
+ command: string;
3759
+ args?: string[];
3760
+ env?: Record<string, string>;
3761
+ cwd?: string;
3563
3762
  }
3564
- interface DispatchAgentResponse {
3565
- output: string;
3763
+ interface ConfigProfile {
3764
+ name: string;
3765
+ apiKey?: string;
3766
+ baseURL?: string;
3767
+ model?: string;
3768
+ maxTokens?: number;
3769
+ permissionMode?: "default" | "acceptEdits" | "bypassPermissions" | "auto";
3770
+ plugins?: string[];
3771
+ mcpServers?: ProfileMCPServerConfig[];
3566
3772
  }
3567
- type DispatchAgentHandler = (request: DispatchAgentRequest) => Promise<DispatchAgentResponse>;
3568
- interface FileObservation {
3569
- path: string;
3570
- mtimeMs: number;
3571
- size: number;
3572
- source: "read" | "write" | "edit" | "notebook" | "shell";
3573
- requiresRefresh?: boolean;
3574
- reason?: string;
3773
+ declare class ProfileManager {
3774
+ private data;
3775
+ private filePath;
3776
+ constructor();
3777
+ listProfiles(): ConfigProfile[];
3778
+ getActiveProfile(): ConfigProfile;
3779
+ getActiveProfileName(): string;
3780
+ switchProfile(name: string): void;
3781
+ createProfile(profile: ConfigProfile): void;
3782
+ deleteProfile(name: string): void;
3783
+ updateProfile(name: string, updates: Partial<ConfigProfile>): void;
3784
+ getProfile(name: string): ConfigProfile | undefined;
3785
+ reload(): void;
3786
+ private load;
3787
+ private save;
3575
3788
  }
3576
- interface ToolRuntimeContext {
3577
- getCwd(): string;
3578
- setCwd(nextCwd: string): void;
3579
- getOwnerSessionId(): string | undefined;
3580
- getMemoryManager(): MemoryManager | undefined;
3581
- setMemoryManager(memoryManager: MemoryManager | undefined): void;
3582
- noteFileObservation(filePath: string, observation: Omit<FileObservation, "path">): void;
3583
- getFileObservation(filePath: string): FileObservation | undefined;
3584
- invalidateFileObservation(filePath: string, reason: string): void;
3585
- listFileObservations(): FileObservation[];
3586
- askUser?(request: AskUserRequest): Promise<AskUserResponse>;
3587
- dispatchAgent?(request: DispatchAgentRequest): Promise<DispatchAgentResponse>;
3789
+ interface ProjectConfig {
3790
+ model?: string;
3791
+ systemPrompt?: string;
3792
+ permissions?: {
3793
+ allowedCommands?: string[];
3794
+ deniedCommands?: string[];
3795
+ };
3796
+ ignorePatterns?: string[];
3588
3797
  }
3589
- declare function createToolRuntimeContext(initialCwd?: string, options?: {
3590
- askUser?: AskUserHandler;
3591
- dispatchAgent?: DispatchAgentHandler;
3592
- memoryManager?: MemoryManager;
3593
- ownerSessionId?: string;
3594
- }): ToolRuntimeContext;
3595
- declare const defaultToolRuntimeContext: ToolRuntimeContext;
3596
- type HarnessTaskStatus = "pending" | "in_progress" | "completed";
3597
- interface HarnessTask {
3798
+ declare function loadProjectConfig(cwd?: string): ProjectConfig | null;
3799
+ declare function mergeConfigs(base: ProjectConfig, override: ProjectConfig): ProjectConfig;
3800
+ interface SessionData {
3598
3801
  id: string;
3599
- subject: string;
3600
- description: string;
3601
- status: HarnessTaskStatus;
3602
- activeForm?: string;
3603
- owner?: string;
3604
- metadata: Record<string, unknown>;
3605
- blocks: string[];
3606
- blockedBy: string[];
3607
- createdAt: string;
3608
- updatedAt: string;
3609
- }
3610
- interface HarnessTaskUpdate {
3611
- subject?: string;
3612
- description?: string;
3613
- status?: HarnessTaskStatus | "deleted";
3614
- activeForm?: string;
3615
- owner?: string;
3616
- metadata?: Record<string, unknown>;
3617
- addBlocks?: string[];
3618
- addBlockedBy?: string[];
3802
+ model: string;
3803
+ workingDirectory: string;
3804
+ createdAt: string;
3805
+ updatedAt: string;
3806
+ messages: Message[];
3807
+ totalTokensUsed: number;
3619
3808
  }
3620
- declare class TaskListManager {
3621
- private readonly tasks;
3622
- private nextId;
3623
- create(input: {
3624
- subject: string;
3625
- description: string;
3626
- activeForm?: string;
3627
- metadata?: Record<string, unknown>;
3628
- }): HarnessTask;
3629
- get(taskId: string): HarnessTask | undefined;
3630
- list(): HarnessTask[];
3631
- update(taskId: string, input: HarnessTaskUpdate): HarnessTask | undefined;
3632
- delete(taskId: string): boolean;
3633
- private incompleteBlockers;
3634
- private assertDependencyTargets;
3635
- private link;
3636
- private assertAcyclic;
3637
- private snapshot;
3638
- private restore;
3809
+ interface SessionSummary {
3810
+ id: string;
3811
+ createdAt: string;
3812
+ updatedAt: string;
3813
+ model: string;
3814
+ workingDirectory: string;
3815
+ preview: string;
3816
+ messageCount: number;
3639
3817
  }
3640
- declare function createTaskListTools(manager?: TaskListManager): RegisteredTool[];
3641
- interface DefaultToolRegistryOptions {
3642
- cwd?: string;
3643
- runtime?: ToolRuntimeContext;
3644
- ownerSessionId?: string;
3645
- askUser?: AskUserHandler;
3646
- dispatchAgent?: DispatchAgentHandler;
3647
- memoryManager?: MemoryManager;
3648
- webSearchApiKey?: string;
3649
- webContext?: WebContextToolOptions;
3650
- permissionProfile?: PermissionProfile;
3651
- sandbox?: AgentSandbox;
3652
- validateInputs?: boolean;
3653
- toolSchemaMode?: "all" | "demand";
3654
- taskListManager?: TaskListManager;
3655
- shellEnvironment?: NodeJS.ProcessEnv;
3656
- shellSensitiveEnvironmentKeys?: readonly string[];
3818
+ declare function saveSession(id: string | null, messages: Message[], model: string, totalTokensUsed: number): string;
3819
+ declare function loadSession(id: string): SessionData | null;
3820
+ declare function listSessions(limit?: number): SessionSummary[];
3821
+ declare function deleteSession(id: string): boolean;
3822
+ interface ModelProvider {
3823
+ id: string;
3824
+ name: string;
3825
+ baseURL: string;
3826
+ apiKeyEnvVar: string;
3827
+ defaultApiKey?: string;
3828
+ modelPrefixes: string[];
3829
+ models: string[];
3830
+ supportsStreaming: boolean;
3831
+ supportsToolUse: boolean;
3832
+ maxContextTokens?: number;
3833
+ headers?: Record<string, string>;
3834
+ requestFormat?: "openai" | "google";
3657
3835
  }
3658
- interface ToolRegistryOptions {
3659
- validateInputs?: boolean;
3660
- toolSchemaMode?: "all" | "demand";
3836
+ interface ResolvedProvider {
3837
+ provider: ModelProvider;
3838
+ model: string;
3839
+ baseURL: string;
3840
+ apiKey: string;
3841
+ headers: Record<string, string>;
3661
3842
  }
3662
- declare class ToolRegistry {
3663
- private tools;
3664
- private compiledSchemas;
3665
- private changeListeners;
3666
- private aliasNames;
3667
- private validateInputs;
3668
- private readonly toolSchemaMode;
3669
- private readonly activatedDefinitions;
3670
- constructor(options?: ToolRegistryOptions);
3671
- setValidateInputs(enabled: boolean): this;
3672
- get inputValidationEnabled(): boolean;
3673
- get schemaLoadingMode(): "all" | "demand";
3674
- register(tool: RegisteredTool): void;
3675
- registerAlias(tool: RegisteredTool): void;
3676
- registerAll(tools: Iterable<RegisteredTool>): void;
3677
- unregister(name: string): boolean;
3678
- onChange(listener: () => void): () => void;
3679
- private emitChange;
3680
- get(name: string): RegisteredTool | undefined;
3681
- getDefinitions(): ToolDefinition[];
3682
- getDefinitionsForRequest(): ToolDefinition[];
3683
- getCapabilityCatalog(): string;
3684
- activateMatchingDefinitions(query: string, limit?: number): ToolDefinition[];
3685
- private static namespaceOf;
3686
- getDefinitionsByNamespace(namespace: string): ToolDefinition[];
3687
- listNamespaces(): string[];
3688
- execute(name: string, input: Record<string, unknown>, context?: ToolExecutionContext): Promise<ToolResult>;
3689
- listNames(): string[];
3690
- has(name: string): boolean;
3691
- projectPolicyInput(name: string, input: Record<string, unknown>): ToolPolicyProjection | {
3692
- error: ToolResult;
3693
- };
3694
- get size(): number;
3695
- private compileDefinition;
3696
- private assertDefinitionsExportable;
3843
+ declare function resolveModelContextTokens(model: string): number | undefined;
3844
+ declare class ModelProviderRegistry {
3845
+ private providers;
3846
+ constructor();
3847
+ addProvider(provider: ModelProvider): void;
3848
+ removeProvider(id: string): boolean;
3849
+ getProvider(id: string): ModelProvider | undefined;
3850
+ listProviders(): ModelProvider[];
3851
+ resolveProvider(model: string, overrides?: {
3852
+ apiKey?: string;
3853
+ baseURL?: string;
3854
+ }): ResolvedProvider;
3697
3855
  }
3698
- declare function createDefaultToolRegistry(options?: DefaultToolRegistryOptions): ToolRegistry;
3699
- declare const registry: ToolRegistry;
3856
+ declare function getDefaultProviderRegistry(): ModelProviderRegistry;
3700
3857
  interface PermissionDecisionEvent {
3701
3858
  traceId?: string;
3702
3859
  toolName: string;
@@ -4753,11 +4910,12 @@ interface SessionResumeOptions {
4753
4910
  }
4754
4911
  type SessionRecoverySource = "transcript" | "checkpoint" | "empty";
4755
4912
  interface SessionRecoveryIssue {
4756
- code: "torn_transcript_tail" | "invalid_transcript_event" | "non_monotonic_sequence" | "interrupted_tool_call" | "checkpoint_fallback" | "divergent_checkpoint" | "stale_metadata";
4913
+ code: "torn_transcript_tail" | "invalid_transcript_event" | "non_monotonic_sequence" | "interrupted_tool_call" | "checkpoint_fallback" | "divergent_checkpoint" | "stale_metadata" | "invalid_compaction_snapshot";
4757
4914
  detail: string;
4758
4915
  }
4759
4916
  interface SessionRecoveryResult {
4760
4917
  messages: Message[];
4918
+ transcriptMessages: Message[];
4761
4919
  source: SessionRecoverySource;
4762
4920
  sourceId?: string;
4763
4921
  issues: SessionRecoveryIssue[];
@@ -4780,6 +4938,7 @@ declare class SessionManager {
4780
4938
  private _checkpoints;
4781
4939
  private _lock;
4782
4940
  private _recovery;
4941
+ private _detachedForHandoff;
4783
4942
  private constructor();
4784
4943
  static create(options: SessionCreateOptions): Promise<SessionManager>;
4785
4944
  static resume(options: SessionResumeOptions): Promise<SessionManager>;
@@ -4787,6 +4946,8 @@ declare class SessionManager {
4787
4946
  get transcript(): TranscriptWriter;
4788
4947
  get checkpoints(): CheckpointManager;
4789
4948
  get recovery(): SessionRecoveryResult;
4949
+ detachForHandoff(): Promise<void>;
4950
+ get detachedForHandoff(): boolean;
4790
4951
  updateMeta(partial: Partial<SessionMeta>): Promise<void>;
4791
4952
  end(status?: "completed" | "abandoned"): Promise<void>;
4792
4953
  recordUserMessage(content: string): Promise<void>;
@@ -5171,7 +5332,7 @@ interface MessageFlowDeps {
5171
5332
  readonly tokenAccountingAdapter?: TokenAccountingAdapter;
5172
5333
  readonly historyMarkdownPath?: string;
5173
5334
  buildRuntimeSystemPrompt(): string;
5174
- onContextCompressed(messagesRemoved: number, tokensSaved: number, record: CompactionRecord): Promise<void>;
5335
+ onContextCompressed(messagesRemoved: number, tokensSaved: number, record: CompactionRecord, activeContextMessages: Message[]): Promise<void>;
5175
5336
  onToolHistoryRepaired?(diagnostic: ToolHistoryRepairDiagnostic): void;
5176
5337
  }
5177
5338
  declare class MessageFlow {
@@ -7326,7 +7487,7 @@ interface XenoControlRoomMonitorInput {
7326
7487
  }
7327
7488
  interface XenoControlRoomGoalInput {
7328
7489
  goalId: string;
7329
- status: "active" | "complete" | "blocked" | "cancelled" | "expired";
7490
+ status: "active" | "complete" | "blocked" | "cancelled" | "failed" | "expired";
7330
7491
  condition: string;
7331
7492
  runId?: string;
7332
7493
  updatedAt: string;
@@ -8140,6 +8301,400 @@ declare class FileXenoShareRegistry {
8140
8301
  load(): Promise<XenoShareRegistrySnapshot>;
8141
8302
  private mutate;
8142
8303
  }
8304
+ declare const XENO_COORDINATION_SCHEMA_VERSION: 1;
8305
+ type XenoGoalStatus = "active" | "paused" | "waiting" | "blocked" | "completed" | "failed" | "cancelled";
8306
+ type XenoGoalTaskStatus = "pending" | "ready" | "running" | "blocked" | "failed" | "completed" | "cancelled" | "interrupted";
8307
+ interface XenoGoalCriterion {
8308
+ id: string;
8309
+ description: string;
8310
+ required: boolean;
8311
+ }
8312
+ interface XenoGoalCriterionResult {
8313
+ criterionId: string;
8314
+ satisfied: boolean;
8315
+ evidence: string[];
8316
+ reason: string;
8317
+ evaluatedAt: string;
8318
+ }
8319
+ interface XenoGoalVerification {
8320
+ status: "pending" | "running" | "passed" | "failed";
8321
+ criteria: XenoGoalCriterionResult[];
8322
+ evidence: string[];
8323
+ summary?: string;
8324
+ verifiedAt?: string;
8325
+ verifiedBy?: string;
8326
+ }
8327
+ interface XenoGoalTask {
8328
+ id: string;
8329
+ milestoneId: string;
8330
+ parentTaskId?: string;
8331
+ title: string;
8332
+ description?: string;
8333
+ status: XenoGoalTaskStatus;
8334
+ assignedAgentId?: string;
8335
+ dependsOn?: string[];
8336
+ progress?: string;
8337
+ resultEventId?: string;
8338
+ createdAt: string;
8339
+ updatedAt: string;
8340
+ completedAt?: string;
8341
+ }
8342
+ interface XenoGoalMilestone {
8343
+ id: string;
8344
+ title: string;
8345
+ description?: string;
8346
+ status: "pending" | "active" | "blocked" | "completed" | "cancelled";
8347
+ taskIds: string[];
8348
+ createdAt: string;
8349
+ updatedAt: string;
8350
+ completedAt?: string;
8351
+ }
8352
+ interface XenoGoalProgress {
8353
+ summary: string;
8354
+ currentMilestoneId?: string;
8355
+ currentTaskId?: string;
8356
+ completedTaskCount: number;
8357
+ totalTaskCount: number;
8358
+ percent?: number;
8359
+ outstanding: string[];
8360
+ decisions: string[];
8361
+ updatedAt: string;
8362
+ }
8363
+ interface XenoGoalRecord {
8364
+ schemaVersion: typeof XENO_COORDINATION_SCHEMA_VERSION;
8365
+ id: string;
8366
+ version: number;
8367
+ sessionId: string;
8368
+ objective: string;
8369
+ why?: string;
8370
+ successCriteria: XenoGoalCriterion[];
8371
+ constraints: string[];
8372
+ limits?: {
8373
+ maxIterations?: number;
8374
+ maxTokens?: number;
8375
+ maxWallClockMs?: number;
8376
+ };
8377
+ metadata: Record<string, string | number | boolean>;
8378
+ status: XenoGoalStatus;
8379
+ milestones: XenoGoalMilestone[];
8380
+ tasks: XenoGoalTask[];
8381
+ progress: XenoGoalProgress;
8382
+ verification: XenoGoalVerification;
8383
+ steering: Array<{
8384
+ id: string;
8385
+ instruction: string;
8386
+ createdAt: string;
8387
+ consumedAt?: string;
8388
+ }>;
8389
+ createdAt: string;
8390
+ updatedAt: string;
8391
+ completedAt?: string;
8392
+ }
8393
+ type XenoLoopKind = "agentic-development" | "goal-continuation" | "scheduled";
8394
+ type XenoLoopStatus = "running" | "paused" | "waiting" | "stopped" | "completed" | "failed";
8395
+ interface XenoLoopSchedule {
8396
+ kind: "fixed-interval" | "dynamic";
8397
+ intervalMs?: number;
8398
+ nextRunAt?: string;
8399
+ expiresAt?: string;
8400
+ }
8401
+ interface XenoLoopIteration {
8402
+ number: number;
8403
+ startedAt: string;
8404
+ completedAt?: string;
8405
+ status: "running" | "completed" | "failed" | "interrupted";
8406
+ activity: string;
8407
+ taskId?: string;
8408
+ verificationEventId?: string;
8409
+ error?: string;
8410
+ }
8411
+ interface XenoLoopRecord {
8412
+ schemaVersion: typeof XENO_COORDINATION_SCHEMA_VERSION;
8413
+ id: string;
8414
+ version: number;
8415
+ sessionId: string;
8416
+ goalId?: string;
8417
+ kind: XenoLoopKind;
8418
+ status: XenoLoopStatus;
8419
+ currentActivity?: string;
8420
+ iterations: XenoLoopIteration[];
8421
+ schedule?: XenoLoopSchedule;
8422
+ stopReason?: string;
8423
+ createdAt: string;
8424
+ updatedAt: string;
8425
+ stoppedAt?: string;
8426
+ }
8427
+ type XenoHandoffStatus = "prepared" | "available" | "claimed" | "completed" | "failed" | "cancelled";
8428
+ interface XenoHandoffOperation {
8429
+ operationId: string;
8430
+ kind: "tool" | "command" | "build" | "subagent" | "other";
8431
+ status: "running" | "completed" | "interrupted";
8432
+ sideEffecting: boolean;
8433
+ recovery: "waited" | "resume" | "retry" | "manual";
8434
+ }
8435
+ interface XenoHandoffRecord {
8436
+ schemaVersion: typeof XENO_COORDINATION_SCHEMA_VERSION;
8437
+ id: string;
8438
+ version: number;
8439
+ sessionId: string;
8440
+ goalId?: string;
8441
+ loopId?: string;
8442
+ status: XenoHandoffStatus;
8443
+ sourceOwnerId: string;
8444
+ targetOwnerId?: string;
8445
+ claimedBy?: string;
8446
+ sourceLeaseEpoch: number;
8447
+ targetLeaseEpoch?: number;
8448
+ workspace?: string;
8449
+ branch?: string;
8450
+ currentMilestoneId?: string;
8451
+ currentTaskId?: string;
8452
+ agentIds: string[];
8453
+ operations: XenoHandoffOperation[];
8454
+ contextDigest?: string;
8455
+ createdAt: string;
8456
+ updatedAt: string;
8457
+ claimedAt?: string;
8458
+ completedAt?: string;
8459
+ failedAt?: string;
8460
+ failureReason?: string;
8461
+ }
8462
+ interface XenoExecutionOwner {
8463
+ ownerId: string;
8464
+ leaseId: string;
8465
+ epoch: number;
8466
+ acquiredAt: string;
8467
+ heartbeatAt: string;
8468
+ expiresAt: string;
8469
+ processId?: number;
8470
+ host?: string;
8471
+ }
8472
+ type XenoCoordinationEventType = "goal.created" | "goal.updated" | "goal.steered" | "goal.completed" | "goal.cancelled" | "loop.started" | "loop.iteration" | "loop.paused" | "loop.waiting" | "loop.resumed" | "loop.stopped" | "loop.completed" | "loop.failed" | "handoff.created" | "handoff.claimed" | "handoff.completed" | "handoff.failed" | "ownership.acquired" | "ownership.renewed" | "ownership.released";
8473
+ interface XenoCoordinationEvent {
8474
+ schemaVersion: typeof XENO_COORDINATION_SCHEMA_VERSION;
8475
+ id: string;
8476
+ sequence: number;
8477
+ type: XenoCoordinationEventType;
8478
+ sessionId: string;
8479
+ goalId?: string;
8480
+ loopId?: string;
8481
+ handoffId?: string;
8482
+ ownerId?: string;
8483
+ timestamp: string;
8484
+ data: Record<string, unknown>;
8485
+ }
8486
+ interface XenoCoordinationSessionState {
8487
+ schemaVersion: typeof XENO_COORDINATION_SCHEMA_VERSION;
8488
+ sessionId: string;
8489
+ version: number;
8490
+ ownershipEpoch: number;
8491
+ owner?: XenoExecutionOwner;
8492
+ goals: XenoGoalRecord[];
8493
+ loops: XenoLoopRecord[];
8494
+ handoffs: XenoHandoffRecord[];
8495
+ events: XenoCoordinationEvent[];
8496
+ createdAt: string;
8497
+ updatedAt: string;
8498
+ }
8499
+ interface XenoCoordinationStoreOptions {
8500
+ rootDirectory?: string;
8501
+ now?: () => string;
8502
+ idFactory?: (prefix: string) => string;
8503
+ ownerLeaseMs?: number;
8504
+ lockTimeoutMs?: number;
8505
+ lockStaleMs?: number;
8506
+ maximumEventsPerSession?: number;
8507
+ }
8508
+ interface CreateXenoGoalInput {
8509
+ sessionId: string;
8510
+ objective: string;
8511
+ why?: string;
8512
+ successCriteria?: Array<string | Omit<XenoGoalCriterion, "id"> & {
8513
+ id?: string;
8514
+ }>;
8515
+ constraints?: string[];
8516
+ limits?: XenoGoalRecord["limits"];
8517
+ metadata?: Record<string, string | number | boolean>;
8518
+ }
8519
+ interface CreateXenoHandoffInput {
8520
+ sessionId: string;
8521
+ sourceOwnerId: string;
8522
+ sourceLeaseId: string;
8523
+ goalId?: string;
8524
+ loopId?: string;
8525
+ targetOwnerId?: string;
8526
+ workspace?: string;
8527
+ branch?: string;
8528
+ currentMilestoneId?: string;
8529
+ currentTaskId?: string;
8530
+ agentIds?: string[];
8531
+ operations?: XenoHandoffOperation[];
8532
+ contextDigest?: string;
8533
+ }
8534
+ declare class XenoCoordinationError extends Error {
8535
+ readonly code: "INVALID" | "NOT_FOUND" | "CONFLICT" | "NOT_OWNER" | "LEASE_EXPIRED" | "UNSAFE_HANDOFF" | "VERIFICATION_REQUIRED";
8536
+ readonly details: Record<string, unknown>;
8537
+ constructor(code: "INVALID" | "NOT_FOUND" | "CONFLICT" | "NOT_OWNER" | "LEASE_EXPIRED" | "UNSAFE_HANDOFF" | "VERIFICATION_REQUIRED", message: string, details?: Record<string, unknown>);
8538
+ }
8539
+ interface UpdateXenoGoalInput {
8540
+ objective?: string;
8541
+ why?: string;
8542
+ constraints?: string[];
8543
+ successCriteria?: XenoGoalCriterion[];
8544
+ status?: Exclude<XenoGoalStatus, "completed">;
8545
+ progress?: Partial<Omit<XenoGoalProgress, "updatedAt">>;
8546
+ verification?: XenoGoalVerification;
8547
+ metadata?: Record<string, string | number | boolean>;
8548
+ }
8549
+ interface StartXenoLoopInput {
8550
+ sessionId: string;
8551
+ goalId?: string;
8552
+ kind: XenoLoopKind;
8553
+ activity?: string;
8554
+ schedule?: XenoLoopSchedule;
8555
+ }
8556
+ interface ClaimXenoHandoffInput {
8557
+ sessionId: string;
8558
+ handoffId: string;
8559
+ targetOwnerId: string;
8560
+ processId?: number;
8561
+ host?: string;
8562
+ }
8563
+ declare class DurableXenoCoordinationStore {
8564
+ private readonly rootDirectory;
8565
+ private readonly now;
8566
+ private readonly idFactory;
8567
+ private readonly ownerLeaseMs;
8568
+ private readonly lockTimeoutMs;
8569
+ private readonly lockStaleMs;
8570
+ private readonly maximumEventsPerSession;
8571
+ constructor(options?: XenoCoordinationStoreOptions);
8572
+ getSessionState(sessionId: string): Promise<XenoCoordinationSessionState>;
8573
+ listSessionStates(): Promise<XenoCoordinationSessionState[]>;
8574
+ createGoal(input: CreateXenoGoalInput): Promise<XenoGoalRecord>;
8575
+ getGoal(sessionId: string, goalId?: string): Promise<XenoGoalRecord | undefined>;
8576
+ updateGoal(sessionId: string, goalId: string, expectedVersion: number, update: UpdateXenoGoalInput): Promise<XenoGoalRecord>;
8577
+ addMilestone(sessionId: string, goalId: string, expectedVersion: number, input: {
8578
+ title: string;
8579
+ description?: string;
8580
+ }): Promise<XenoGoalRecord>;
8581
+ addTask(sessionId: string, goalId: string, expectedVersion: number, input: {
8582
+ milestoneId: string;
8583
+ parentTaskId?: string;
8584
+ title: string;
8585
+ description?: string;
8586
+ assignedAgentId?: string;
8587
+ dependsOn?: string[];
8588
+ }): Promise<XenoGoalRecord>;
8589
+ updateTask(sessionId: string, goalId: string, taskId: string, expectedVersion: number, update: Pick<XenoGoalTask, "status"> & Partial<Pick<XenoGoalTask, "progress" | "resultEventId" | "assignedAgentId">>): Promise<XenoGoalRecord>;
8590
+ steerGoal(sessionId: string, goalId: string, expectedVersion: number, instruction: string): Promise<XenoGoalRecord>;
8591
+ consumeGoalSteering(sessionId: string, goalId: string, expectedVersion: number): Promise<{
8592
+ goal: XenoGoalRecord;
8593
+ instructions: Array<{
8594
+ id: string;
8595
+ instruction: string;
8596
+ createdAt: string;
8597
+ }>;
8598
+ }>;
8599
+ completeGoal(sessionId: string, goalId: string, expectedVersion: number, verification: XenoGoalVerification): Promise<XenoGoalRecord>;
8600
+ cancelGoal(sessionId: string, goalId: string, expectedVersion: number, reason: string): Promise<XenoGoalRecord>;
8601
+ startLoop(input: StartXenoLoopInput): Promise<XenoLoopRecord>;
8602
+ getLoop(sessionId: string, loopId?: string): Promise<XenoLoopRecord | undefined>;
8603
+ beginLoopIteration(sessionId: string, loopId: string, expectedVersion: number, activity: string, taskId?: string): Promise<XenoLoopRecord>;
8604
+ finishLoopIteration(sessionId: string, loopId: string, expectedVersion: number, result: {
8605
+ status: "completed" | "failed" | "interrupted";
8606
+ verificationEventId?: string;
8607
+ error?: string;
8608
+ nextStatus?: Extract<XenoLoopStatus, "running" | "waiting" | "failed">;
8609
+ }): Promise<XenoLoopRecord>;
8610
+ setLoopStatus(sessionId: string, loopId: string, expectedVersion: number, status: Extract<XenoLoopStatus, "paused" | "running" | "waiting" | "stopped" | "completed" | "failed">, reason?: string): Promise<XenoLoopRecord>;
8611
+ acquireOwnership(sessionId: string, ownerId: string, options?: {
8612
+ processId?: number;
8613
+ host?: string;
8614
+ leaseMs?: number;
8615
+ }): Promise<XenoExecutionOwner>;
8616
+ renewOwnership(sessionId: string, ownerId: string, leaseId: string, leaseMs?: number): Promise<XenoExecutionOwner>;
8617
+ releaseOwnership(sessionId: string, ownerId: string, leaseId: string): Promise<XenoExecutionOwner>;
8618
+ createHandoff(input: CreateXenoHandoffInput): Promise<XenoHandoffRecord>;
8619
+ claimHandoff(input: ClaimXenoHandoffInput): Promise<{
8620
+ handoff: XenoHandoffRecord;
8621
+ owner: XenoExecutionOwner;
8622
+ }>;
8623
+ completeHandoff(sessionId: string, handoffId: string, ownerId: string, leaseId: string): Promise<XenoHandoffRecord>;
8624
+ failHandoff(sessionId: string, handoffId: string, reason: string): Promise<XenoHandoffRecord>;
8625
+ private mutateGoal;
8626
+ private mutateLoop;
8627
+ private recalculateProgress;
8628
+ private requireGoal;
8629
+ private requireOwner;
8630
+ private assertVersion;
8631
+ private newOwner;
8632
+ private ownerExpired;
8633
+ private appendEvent;
8634
+ private mutate;
8635
+ private statePath;
8636
+ private lockPath;
8637
+ private readState;
8638
+ private writeState;
8639
+ private renameReplacing;
8640
+ private withSessionLock;
8641
+ private staleLockOwner;
8642
+ private quarantineLock;
8643
+ }
8644
+ type XenoCoordinationAction = "state.get" | "goal.create" | "goal.update" | "goal.complete" | "goal.cancel" | "goal.steer" | "loop.start" | "loop.get" | "loop.begin" | "loop.finish" | "loop.set_status" | "ownership.acquire" | "ownership.renew" | "ownership.release" | "handoff.create" | "handoff.claim" | "handoff.complete" | "handoff.fail";
8645
+ interface ExecuteXenoCoordinationActionInput {
8646
+ action: XenoCoordinationAction;
8647
+ sessionId: string;
8648
+ payload?: Record<string, unknown>;
8649
+ }
8650
+ interface ExecuteXenoCoordinationActionResult {
8651
+ action: XenoCoordinationAction;
8652
+ sessionId: string;
8653
+ result: unknown;
8654
+ state: XenoCoordinationSessionState;
8655
+ event?: XenoCoordinationEvent;
8656
+ }
8657
+ declare function executeXenoCoordinationAction(store: DurableXenoCoordinationStore, input: ExecuteXenoCoordinationActionInput): Promise<ExecuteXenoCoordinationActionResult>;
8658
+ interface XenoExecutionLeaseSessionOptions {
8659
+ store?: DurableXenoCoordinationStore;
8660
+ sessionId: string;
8661
+ ownerId?: string;
8662
+ processId?: number;
8663
+ host?: string;
8664
+ leaseMs?: number;
8665
+ heartbeatMs?: number;
8666
+ claimHandoffId?: string;
8667
+ onOwnershipLost?: (error: unknown) => void;
8668
+ }
8669
+ declare class XenoExecutionLeaseSession {
8670
+ readonly sessionId: string;
8671
+ readonly ownerId: string;
8672
+ private readonly store;
8673
+ private readonly processId;
8674
+ private readonly host;
8675
+ private readonly leaseMs;
8676
+ private readonly heartbeatMs;
8677
+ private readonly claimHandoffId?;
8678
+ private readonly onOwnershipLost?;
8679
+ private timer?;
8680
+ private heartbeatInFlight;
8681
+ private owner?;
8682
+ private stopped;
8683
+ private lostError?;
8684
+ private preparedHandoffId?;
8685
+ constructor(options: XenoExecutionLeaseSessionOptions);
8686
+ get currentOwner(): XenoExecutionOwner | undefined;
8687
+ get active(): boolean;
8688
+ start(): Promise<XenoExecutionOwner>;
8689
+ assertOwned(): Promise<XenoExecutionOwner>;
8690
+ private renewHeldLease;
8691
+ prepareHandoff(input?: Omit<CreateXenoHandoffInput, "sessionId" | "sourceOwnerId" | "sourceLeaseId">): Promise<XenoHandoffRecord>;
8692
+ stop(options?: {
8693
+ release?: boolean;
8694
+ }): Promise<void>;
8695
+ private heartbeat;
8696
+ private markLost;
8697
+ }
8143
8698
  declare const XENO_HOSTED_ENVIRONMENT_SCHEMA_VERSION: 1;
8144
8699
  declare const XENO_HOSTED_RUN_SCHEMA_VERSION: 1;
8145
8700
  declare const XENO_HOSTED_EVENT_SCHEMA_VERSION: 1;
@@ -9537,6 +10092,7 @@ declare class SessionLock {
9537
10092
  private legacyLockPath;
9538
10093
  private sessionId;
9539
10094
  private heartbeatTimer?;
10095
+ private acquiredOwner?;
9540
10096
  constructor(sessionDir: string);
9541
10097
  acquire(): Promise<void>;
9542
10098
  release(): Promise<void>;
@@ -12757,4 +13313,4 @@ declare class AgentEvaluator {
12757
13313
  clearResults(): void;
12758
13314
  get resultCount(): number;
12759
13315
  }
12760
- export { type A2AMessage, type A2AMessageType, AGENT_DAEMON_PROTOCOL_VERSION, AGENT_EFFORT_LEVELS, AGENT_PERMISSION_MODES, AGENT_PROFILE_EXTERNAL_ACTIONS, ARCHITECT_CAPABILITIES, ARCHITECT_TOOL_NAMES, type ActiveLayerInfo, type AddXenoArtifactCommentRequest, type AgentArtifact, type AgentCapabilities, type AgentCard, AgentDaemonClient, type AgentDaemonError, type AgentDaemonHandler, type AgentDaemonRequest, type AgentDaemonResponse, AgentDaemonServer, type AgentDaemonTransport, AgentDebugger, type AgentDefinition, type AgentDefinitionIsolation, type AgentDefinitionIssue, AgentDefinitionLoader, type AgentDefinitionLoaderOptions, type AgentDefinitionMetadata, AgentDefinitionResolver, type AgentDefinitionScanResult, type AgentDefinitionScope, type AgentDefinitionShadowRef, type AgentEffortLevel, AgentEvaluator, AgentEventStore, type AgentHookDefinition, AgentHookRunner, AgentInterruptedError, type AgentIpcChannel, type AgentLoadSnapshot, AgentLoop, type AgentLoopConfig, type AgentLoopOptions, type AgentPermissionMode, type AgentProfileActionDecision, type AgentProfileCapabilities, type AgentProfileCapabilityBoundary, type AgentProfileCollaborationMode, type AgentProfileCompletionPolicy, type AgentProfileEvidenceKind, type AgentProfileExecutionPolicy, type AgentProfileExternalAction, type AgentProfileExternalActionPolicy, type AgentProfileIsolation, type AgentProfileKind, type AgentProfileMemoryPolicy, type AgentProfileMemoryScope, type AgentProfilePresentation, type AgentProfileSkillPolicy, type AgentProfileSoulMode, type AgentProfileV2, AgentProfileValidationError, AgentProtocol, AgentRegistry, type AgentRunAgentDefinitionRef, AgentRunController, type AgentRunControllerOptions, type AgentRunCreateInput, AgentRunError, type AgentRunEvent, type AgentRunListOptions, type AgentRunOptions, type AgentRunRecord, type AgentRunSpawnResult, type AgentRunStatus, AgentRunStore, type AgentRunTermination, type AgentRunTerminationReason, type AgentRunTerminationStatus, type AgentRunUsage, type AgentSandbox, type AgentSelectionStrategy, type AgentSessionHostBindingV1, type AgentStreamCallbacks, type AgentTask, type AgentTaskHandler, type AgentTaskResult, type AgentTaskStatus, type AgentTeam, type AgentToAppChannel, type AgentToAppMessages, type AgentToolPolicy, type AnalysisResult, type ApiMessage, type AppAgentBaseOptions, AppAgentFactory, type AppAgentResult, type AppContext, AppContextInjector, AppContextManager, type AppContextProvider, type AppId, type AppServerEventV2, type AppServerInitializeParamsV2, type AppServerInitializeResultV2, type AppServerIntegrationMetadataV2, type AppServerPermissionRequestV2, type AppServerPrincipalV2, AppServerProtocolError, type AppServerProtocolErrorData, AppServerRemoteError, type AppServerRequestContext, type AppServerSubscriptionSnapshotV2, type AppServerThreadStatusV2, type AppServerThreadV2, type AppServerTurnRunnerContextV2, type AppServerTurnRunnerV2, type AppServerTurnStatusV2, type AppServerTurnV2, type AppServerV2ClientTransport, type AppServerV2MethodMap, type AppServerV2Options, type AppToAgentChannel, type AppToAgentMessages, type AppType, type ArchitectAgentOptions, type ArchitectToolAdapter, type AskUserHandler, type AskUserRequest, type AskUserResponse, type AtomicMessageGroup, type AudioProjectInfo, type AudioStemSeparationResult, type AudioToolAdapter, type AudioTrackType, type AudioTranscriptionResult, type AudioTranscriptionSegment, type AuditDecision, type AuditEvent, AuditLogger, type AuditReplayReport, type AuditReplayStep, type AuditRiskLevel, type AuditStatus, type AuditTraceGapEntry, type AuditTraceReport, type AuditTraceSummary, type AuditTraceTimelineEntry, type AuditTraceToolSummary, type AugmentContextOptions, type AuthorizedShellExecution, AutoCheckpointHandler, AutoMemory, type AutoMemoryContext, type AutoMemoryTrigger, AutoPermissionClassifier, type AutoPermissionDecision, BUILT_IN_XENO_PROVIDER_PRESETS, BackgroundProcessManager, type BackgroundTask, type BaseHookDefinition, type BenchBashMiddlewareOptions, type BlockContent, type BlockType, type BoundedShellOutput, type BreakpointCallback, type BuildResult, type BuildXenoSecureExecutionContractOptions, COMPAT_TOOL_ALIASES, CONFIG_VERSION, type CanonicalSecurityPath, type CanvasSize, type CellRangeData, type ChartConfig, type ChatCompletionChunk, type ChatCompletionRequest, type ChatCompletionResponse, type ChatMessage, type ChatParams, type ChatResponse, type CheckpointData, type CheckpointInfo, CheckpointManager, type CheckpointTrigger, type ClashResult, type ClipContext, type CodeApplyOptions, type CodeApplyResult, type CodeValidationIssue, type CodeValidationResult, CodeValidator, type CodingBenchmarkAssessment, type CodingBenchmarkMeasurement, type CodingBenchmarkOptions, type CodingBenchmarkReport, type CodingBenchmarkThreshold, type CommandBackedProtectedStateOptions, type CommandHookDefinition, CommandHookRunner, type CompactionRecord, type CompileAgentProfileOptions, type CompiledAgentProfile, type CompiledJsonSchema, type CompletionDecision, type CompletionGuard, type CompletionGuardContext, type CompletionGuardDecision, type CompletionGuardEvaluationContext, CompletionGuardRegistry, type CompletionGuardResult, type CompletionGuardResultObject, type CompletionGuardStopReason, type CompletionGuardToolPolicy, type CompletionGuardToolPolicyMode, type CompletionGuardTurnStats, type CompletionGuardVeto, type ComponentData, type CompressionLLMFn, type CompressionStats, type ConfigProfile, type ConnectConfiguredMCPServersOptions, type ConnectConfiguredMCPServersResult, type ContainedProcessSpec, type ContainmentAdapterIdentity, ContainmentApprovalError, type ContainmentCertificationBinding, ContainmentCertificationError, type ContainmentConformanceCheck, type ContentBlock, type ContextCompressedData, ContextManager, type ContextManagerConfig, type ContextSection, type ContextSource, type ControlPlaneLockHandle, type ControlPlaneLockRecord, ConversationStore, type CreateAuditBackedPermissionEngineOptions, type CreateDelegatedBranchAgent, type CreateDelegatedBranchAgentOptions, type CreateDelegatedXenoAgentOptions, type CreateXenoAgentOptions, type CreateXenoAgentResult, type CreateXenoGovernedAutomationToolsOptions, type CreateXenoHandoffOptions, type CreateXenoShareOptions, type CreateXenoSkillToolOptions, type CreateXenoSourceResearchReportInput, type CrossAppHandler, type CrossAppMessage, CrossAppRouter, CrossAppRouterError, type CrossAppRouterOptions, DEFAULT_API_KEY, DEFAULT_IMAGE_MODEL, DEFAULT_MEMORY_BUDGETS, DEFAULT_MODEL, DEFAULT_PROMPT_SECTIONS_TOKEN_BUDGET, DEFAULT_PROTECTED_STATE_KEY_NAME, DEFAULT_PROTECTED_STATE_SERVICE, DEFAULT_SUBAGENT_BRANCH_POLICY, DEFAULT_SUBAGENT_REMOTE_MCP_BY_ROLE, DEFAULT_SUBAGENT_ROLES, DEFAULT_SUBAGENT_ROLE_PRECEDENCE, DEFAULT_SUBAGENT_TEAM_PRESET, DIRECT_SHELL_CONTEXT_WARNING, DOCS_CAPABILITIES, DOCS_TOOL_NAMES, type DebugBreakpoint, type DebugSnapshot, type DebugStep, type DebugStepCallback, type DecideXenoArtifactRequest, type DefaultToolRegistryOptions, type DefaultWebContextRequestFactoryOptions, type DelegatedBranchAdmission, type DelegatedBranchAdmissionSettlement, type DelegatedBranchAgent, type DelegatedBranchAgentCallbacks, type DelegatedXenoTurnResult, type DelegationBudget, type DelegationLimits, type DelegationSummaryData, type DependencyEdge, type DescendantInstructionHint, type DirectEndpointPolicy, type DirectEndpointProfile, type DirectProviderCapabilityProfile, type DirectProviderConfig, type DirectProviderKind, type DirectShellMessageMetadata, type DirectShellResultRecord, type DispatchAgentHandler, type DispatchAgentRequest, type DispatchAgentResponse, type DocComment, type DocsAgentOptions, type DocsToolAdapter, type DocumentContext, type DualLLMMode, DualLLMProvider, type DualLLMProviderConfig, type DualLLMProviderLike, type DualLLMStatus, ENGINE_CAPABILITIES, ENGINE_TOOL_NAMES, ElectronAgentBridge, type ElectronAgentConfig, type EngineAgentOptions, type EngineToolAdapter, type EntityInfo, type Episode, type EpisodeOutcome, EpisodicStore, type EpisodicStoreOptions, type ErrorData, type EvalReport, type EvalResult, type EvalRunOptions, type EvalTask, type ExchangeMCPOAuthCodeOptions, type ExecuteToolRequest, type ExecuteToolResult, ExecutionGovernance, type ExecutionGovernanceOptions, type ExecutionGovernanceSummary, type ExecutionMode, type ExecutionSecurityCapabilities, ExecutionSecurityError, type ExecutionSecurityErrorCode, type ExecutionSecurityLevel, type ExecutionTrustMode, type ExpectedOutputContract, type ExportableSoulSigner, type ExtendedAppType, FALLBACK_MODELS, type FailureCluster, type FileEntry, type FileSnapshot, FileXenoArtifactRepository, type FileXenoArtifactRepositoryOptions, FileXenoProviderConnectionStore, type FileXenoProviderConnectionStoreOptions, FileXenoShareRegistry, type FileXenoShareRegistryOptions, type FilterConfig, type GovernanceExtensions, type GovernanceExtensionsOptions, HIGH_RISK_PERMISSIONS, type HarnessTask, type HarnessTaskStatus, type HarnessTaskUpdate, type HookConfig, type HookDecision, type HookDefinition, type HookEventName, type HookExecutionResult, type HookExecutionStatus, type HookInput, type HookInputBase, type HookInvocationInput, type HookModelExecutor, type HookPermissionMode, type HookRunResult, HookRunner, HookRuntime, type HookRuntimeOptions, type HttpHookDefinition, HttpHookRunner, IDENTITY_PATHS, type IdentityFrontmatter, type IdentityLayer, type IdentityLoadResult, IdentityLoader, type IdentityLoaderOptions, type IdentityPaths, IdentityResolver, type IdentitySource, type ImageContentBlock, type ImageDocumentInfo, type ImageGenerationConfig, type ImageLayerInfo, type ImageLayerType, type ImageToolAdapter, type ImageUrlBlock, InMemoryXenoArtifactRepository, type InMemoryXenoArtifactRepositoryOptions, InMemoryXenoCapabilityLeaseRegistry, type InMemoryXenoCapabilityLeaseRegistryOptions, InMemoryXenoTelemetryCollector, type InitializeSessionRuntimeOptions, type InspectSystemPromptOptions, type InstallSignalHandlersOptions, InteractiveChatTurnGovernance, InteractiveTurnGovernance, type InteractiveTurnGovernanceOptions, type IpcHandler, type JsonRpcErrorResponse, type JsonRpcMessage$1 as JsonRpcMessage, type JsonRpcNotification, type JsonRpcRequest$1 as JsonRpcRequest, type JsonRpcResponse, type JsonRpcSuccessResponse, type JsonSchema, JsonSchemaCompilationError, type JsonSchemaCompilationIssue, type JsonSchemaCompileOptions, type JsonSchemaSubset, type JsonSchemaType, type JsonSchemaValidationError, type JsonSchemaValidationResult, type LLMCompletionResult, type LLMProvider, type LLMProviderCapabilities, type LLMProviderMessage, type LLMProviderRequestContext, type ToolDefinition as LLMProviderToolDefinition, type LLMToolDefinition, type LayerContext, type LegacyXenoSkillInput, type LinuxBubblewrapCapability, type LinuxBubblewrapProcessSpec, LlmClient, type LlmClientDeps, LocalLLMProvider, type LocalLLMProviderConfig, type LocalRuntimePreflightResult, LogLevel, type LspDefinitionReport, type LspDiagnosticsReport, type LspDoctorReport, type LspDoctorServer, type LspHoverReport, type LspReferencesReport, MANIFEST_FILENAME, MAX_CONTAINMENT_APPROVAL_AGE_MS, MAX_CONTAINMENT_CERTIFICATION_BYTES, MAX_CONTAINMENT_CERTIFICATION_LIFETIME_MS, MAX_DIRECT_SHELL_OUTPUT_CHARS, type MCPAppCapabilities, type MCPAppContentSecurityPolicy, type MCPAppExtensionMetadata, type MCPAppMetadata, type MCPAppPermissions, type MCPAppResourceDescriptor, type MCPAppValidationResult, type MCPAppVisibility, type MCPApprovalDecision, type MCPBearerTokenRefreshHandler, type MCPBearerTokenResolver, type MCPConfigFile, type MCPConfiguredServer, type MCPElicitationAction, type MCPElicitationHandler, type MCPElicitationRequest, type MCPElicitationResponse, type MCPHttpAuthChallenge, MCPHttpTransportError, type MCPHttpUrlPhase, type MCPInitializeParams, type MCPInitializeResult, MCPManager, type MCPManagerOptions, type MCPOAuthAuthorizationServerMetadata, type MCPOAuthAuthorizationSession, MCPOAuthClient, type MCPOAuthClientOptions, type MCPOAuthClientRegistration, type MCPOAuthClientRegistrationSource, type MCPOAuthConfig, type MCPOAuthDiscoveryResult, type MCPOAuthProtectedResourceMetadata, type MCPOAuthTokenSet, type MCPOAuthTokenStore, type MCPOAuthUrlPhase, type MCPPrompt, type MCPPromptGetParams, type MCPPromptGetResult, type MCPPromptsListResult, type MCPRegistryAccessPolicy, type MCPRegistryEntryDescriptor, type MCPRegistryEntryKind, type MCPRegistryFilter, type MCPResource, type MCPResourceReadParams, type MCPResourceReadResult, type MCPResourceSubscribeParams, type MCPResourceUnsubscribeParams, type MCPResourcesListResult, MCPServer, type MCPServerConfig, type MCPServerModeOptions, type MCPServerPromptRegistration, type MCPServerResourceRegistration, type MCPServerScope, type MCPServerState, type MCPTool, type MCPToolCallParams, type MCPToolCallResult, type MCPToolsListResult, type MCPTransport, type MCPTransportConnection, MCP_APPS_EXTENSION_ID, MCP_APP_MIME_TYPE, MCP_APP_RESOURCE_SCHEME, MCP_PROTOCOL_VERSION, MCP_SUPPORTED_PROTOCOL_VERSIONS, MEMORY_FILES, MOTION_CAPABILITIES, MOTION_SYSTEM_PROMPT, MOTION_TOOL_NAMES, type ManifestValidationResult, type MaterialConfig, type MaterializeXenoAutomationEvidenceOptions, type MemoryAccessScope, type MemoryBudget, type MemoryEntry, type MemoryFile, type MemoryLevel, MemoryManager, type MemoryManagerOptions, type MeshInfo, type Message, MessageFlow, type MessageFlowDeps, type ModeSwitchRequest, type ModelInfo, type ModelProvider, ModelProviderRegistry, type MonitorEvent, MonitorManager, type MonitorSnapshot, type MonitorSource, MonitorStopTool, MonitorTool, type MotionAgentOptions, type MotionPromptParams, type MxcContainmentProbe, type MxcNativeAssetDescriptor, type MxcWindowsHostPreparationReport, NOTES_CAPABILITIES, NOTES_TOOL_NAMES, type NormalizedLspDiagnostic, type NormalizedLspHover, type NormalizedLspLocation, type NormalizedLspRange, type NotePageInfo, type NoteSearchResult, type NotesAgentOptions, type NotesToolAdapter, type OnChunkCallback, type OnTaskCompleteInput, type OnTaskCompleteResult, type OpenTelemetryMetricAdapter, type OperationTaskSource, type OsProtectedStateStoreOptions, OtelExporter, type OtelUsageAdapter, PIXEL_CAPABILITIES, PIXEL_SYSTEM_PROMPT, PIXEL_TOOL_NAMES, PROCESS_TREE_ADAPTERS, PROJECT_STATE_VERSION, type ParameterizedPermissionRule, type ParseUnifiedDiffOptions, type PermissionConfig, type PermissionDecision, type PermissionDecisionEvent, type PermissionDecisionHook, PermissionEngine, type PermissionInfo, type PermissionProfile, type PermissionProfileDecision, type PermissionProfileMode, type PermissionProfileName, type PermissionProfileNetworkDecision, type PermissionProfileResolution, type PermissionPromptFn, type PermissionPromptInfo, type PermissionPromptOperation, type PermissionPromptPreview, type PermissionPromptPreviewLine, type PermissionRequestContext, type PermissionRequestInfo, type PermissionRequestResult, type PermissionRule, type PersistentPermissionState, type PixelAgentOptions, type PixelPromptParams, type PlatformInfo, type PluginActivationEvent, type PluginAuthor, type PluginCapability, type PluginCommandContribution, type PluginCommandHandler, type PluginContext, type PluginContributions, type PluginDetachedSignature, type PluginEngineConstraint, type PluginEvent, PluginEventBus, type PluginEventListener, type PluginEventType, type PluginHook, PluginHost, type PluginHostInfo, type PluginHostOptions, type PluginInfo, type PluginListing, type PluginLogger, PluginManager, type PluginManagerOptions, type PluginManifest, PluginMarketplace, type PluginMarketplaceOptions, type PluginOutputStyleContribution, type PluginPermission, type PluginPromptContribution, type PluginPublishOptions, type PluginRelevanceCandidate, type PluginRelevanceHints, type PluginRelevanceSuggestion, type PluginRepositorySignal, PluginSandbox, type PluginSandboxOptions, type PluginScaffoldOptions, type PluginSearchOptions, type PluginSettingContribution, PluginSettingsManager, type PluginSignatureStatus, type PluginStatus, type PluginStorage, type PluginSupplyChainLockfile, type PluginSupplyChainRecord, type PluginTestCase, type PluginTestResult, PluginToolBuilder, type PluginToolContribution, type PluginTrustBadge, type PluginUIPanel, type PolicyCheckResult, type PolicyEnforcerConfig, type PrepareMCPOAuthAuthorizationOptions, type ProbeXenoProviderOptions, type ProcessContainmentStatus, type ProcessTreeAdapter, type ProfileMCPServerConfig, ProfileManager, type ProjectConfig, type ProjectDomainProfile, type ProjectExecutionPhase, type ProjectExecutionProfile, type ProjectInfo, type ProjectMcpApprovalDecision, type ProjectSessionContext, type ProjectSessionContextEntry, type ProjectSessionSummary, type ProjectTokenUsageSummary, type PromotionRequestResult, type PromptContext, type PromptFn, type PromptHookDefinition, PromptHookRunner, type PromptMemoryContextInfo, type PromptSectionContext, type PromptSectionProvider, PromptSectionRegistry, type ProtectedStateCipher, type ProtectedStateEnvelopeCipher, type ProtectedStateEnvelopeCipherOptions, type ProtectedStateEnvelopeV1, type ProtectedStateStore, ProviderError, type ProviderErrorCategory, type ProviderErrorCode, type ProviderErrorOptions, type ProviderStatus, type ProviderStreamEvent, type ProviderTransportLimits, QueryLifecycle, type QueryLifecycleOptions, type QueryState, type QueryTransition, type QueryWatchdogReason, REQUIRED_CONTAINMENT_CONFORMANCE_CHECKS, type RecalledEpisode, type RecalledSkill, type RecentSessionEntry, type RecentSessionsIndex, type ReducedResult, type ReducerOptions, type RegisterToolOperationInput, type RegisteredTool, type RenderConfig, type RequestBudgetBreakdown, type ResolveXenoSdkApiKeyOptions, type ResolvedIdentity, type ResolvedMemory, type ResolvedProvider, type ResolvedSubagentWorkflowAnswer, type ResourceContentBlock, type RoomInfo, type RunContainmentConformanceOptions, type RunDelegatedXenoTurnOptions, type RunStreamOptions, type RuntimeManifestFileEntry, type RuntimeManifestInspectionResult, type RuntimePluginManifestEntry, SDK_DEFAULT_MAX_ITERATIONS, SDK_DEFAULT_MAX_TOKENS, SDK_VERSION, SESSION_FORMAT_VERSION, SHEETS_CAPABILITIES, SHEETS_TOOL_NAMES, SLIDES_CAPABILITIES, SLIDES_TOOL_NAMES, SOUND_CAPABILITIES, SOUND_SYSTEM_PROMPT, SOUND_TOOL_NAMES, SSETransport, SUBAGENT_ROLE_ALIASES, SUBAGENT_TEAM_PRESETS, type SandboxCheckResult, type ScoredMemory, ScreenCapture, type ScreenCaptureConfig, type ScreenCaptureOptions, type SearchConfig, type SearchProvider, type SecuredProcessSpec, type SecurityPathIssue, type SecurityPathIssueCode, type Session, type SessionCreateOptions, type SessionData, type SessionEndData, type SessionIntegrationConfig, SessionLock, SessionLock as SessionLockManager, SessionManager, type SessionMeta, type SessionRecoveryIssue, type SessionRecoveryResult, type SessionRecoverySource, SessionRegistry, type SessionResumeOptions, type SessionRuntimeBaseOptions, type SessionRuntimeState, type SessionStartData, type SessionStatus, type SessionSummary, type SetXenoArtifactCommentResolutionRequest, type SetupAIHandlersOptions, type ShapeConfig, type SheetsAgentOptions, type SheetsToolAdapter, type ShellExecutionAuthorization, type ShellExecutionAuthorizationRequest, type ShellPathReference, type ShutdownCleanup, type Skill, SkillStore, type SkillStoreOptions, type SlideInfo, type SlidesAgentOptions, type SlidesToolAdapter, type SortConfig, type SoulCompletion, SoulEngine, type SoulEngineOptions, type SoulMessage, type SoulSigner, type SoundAgentOptions, type SoundPromptParams, type SpeechRecognizer, type SpeechRecognizerCallbacks, type SpeechRecognizerConfig, StdioTransport, type StemSeparationResult, type StopReason, type StoredConversation, type StoredMessage, type StoredToolCall, type StreamResult, StreamableHTTPTransport, type StreamableHTTPTransportOptions, type StreamableHTTPTransportSnapshot, type SubagentBranchPolicy, type SubagentBriefContext, type SubagentExecuteFn, type SubagentExecutionRequest, type SubagentExecutionResponse, type SubagentRemoteMcpAccess, type SubagentResult, type SubagentRole, type SubagentTask, type SubagentTeamPreset, type SubagentTeamPresetDefinition, type SubagentWorkflowMode, type SubagentWorkflowOptions, type SubagentWorkflowResult, type SynthesizeSkillInput, type SystemPromptInspectionResult, THREE_D_CAPABILITIES, THREE_D_TOOL_NAMES, TOOL_OPERATION_SCHEMA_VERSION, type TaskCompletionCallback, TaskListManager, type TestResult, type TextBlock, type ThreeDAgentOptions, type ThreeDToolAdapter, type TimelineInfo, type TokenUsageTotals, type ToolAssistantContentBlock, type ToolAuthorizationReceipt, type ToolCallData, type ToolCompletionPolicy, type ToolContinuationCheckpoint, type ToolContinuationNotification, type ToolDefinition, type ToolEvidence, type ToolExchangeRepairResult, type ToolExecutionContext, type ToolExecutor, type ToolFailureCategory, type ToolFailureGuardTrip, ToolFailureLoopGuard, type ToolHistoryRepairDiagnostic, type ToolManifestEntry, type ToolMiddleware, type ToolMiddlewareContext, ToolMiddlewareRegistry, type ToolOperationEvent, ToolOperationManager, type ToolOperationRuntimeEventType, type ToolOperationSnapshot, type ToolOperationState, ToolOrchestrator, type ToolOrchestratorCallbacks, type ToolOrchestratorConfig, type ToolPolicyProjection, type ToolProgressUpdate, ToolRegistry, type ToolRegistryOptions, type ToolResult, type ToolResultBlock, type ToolResultContent, type ToolResultData, type ToolRiskLevel, type ToolRuntimeContext, type ToolSchemaProjectionChange, ToolSchemaProjectionError, type ToolSchemaProjectionResult, type ToolSchemaProviderDialect, type ToolUseBlock, type TraceGraph, type TraceGraphEdge, type TraceGraphNode, type TrackContext, type TranscriptEvent, type TranscriptEventData, type TranscriptEventType, TranscriptWriter, type TranscriptionResult, type TranscriptionSegment, type TransitionConfig, type TurnDiffSummary, TurnDiffTracker, type TurnDiffTrackerOptions, type TurnFileDiff, type TurnRestoreAvailability, type TurnRestoreFilePreview, TurnRestoreManager, type TurnRestorePoint, type TurnRestoreResult, UNBOUNDED_OPERATION_CONTINUATION_LIMIT, type UnifiedExecCompletionReason, UnifiedExecError, type UnifiedExecEvent, type UnifiedExecEventListener, type UnifiedExecEventType, type UnifiedExecInputSource, UnifiedExecManager, type UnifiedExecManagerOptions, type UnifiedExecMode, type UnifiedExecOrigin, type UnifiedExecOutput, type UnifiedExecOutputChunk, type UnifiedExecOutputDelta, type UnifiedExecPresentation, type UnifiedExecProcess, type UnifiedExecReadDeltaOptions, type UnifiedExecStartOptions, type UnifiedExecStatus, type UnifiedExecStream, UsageAccumulator, type UsageAttribution, type UsageEvent, UsageLedger, type UsageQuery, type UsageTotals, type ValidateXenoSdkApiKeyOptions, type ValidatedContainmentCertification, type ValidationSignal, type VectorDocument, VectorMemoryStore, type VectorSearchResult, type VectorStoreAdapter, type VectorStoreOptions, type VerifyContainmentApprovalExpected, type VerifyPluginSupplyChainOptions, type VerifyPluginSupplyChainResult, type VerifyXenoHostedWebhookOptions, type VerifyXenoShareOptions, type VideoToolAdapter, WEB_CONTEXT_CONTRACT_VERSION, WEB_CONTEXT_TOOL_RESULT_SCHEMA, WORKFLOW_CAPABILITIES, WORKFLOW_TOOL_NAMES, type WebContextClientPort, type WebContextEvidenceProjection, type WebContextRequestBase, type WebContextRequestFactory, type WebContextToolOptions, type WebContextToolResult, type WebSearchResult, type WindowsDpapiCredentialFile, type WindowsDpapiProtectedFileOptions, type WindowsDpapiProtectedStateOptions, type WorkflowAgentOptions, type WorkflowDefinition, type WorkflowEvent, type WorkflowExecutionResult, type WorkflowInfo, type WorkflowNodeConfig, type WorkflowNodeDefinition, type WorkflowNodeExecutor, type WorkflowNodeStatus, type WorkflowPlan, WorkflowPlanner, type WorkflowRunNodeRecord, type WorkflowRunRecord, type WorkflowRunStatus, WorkflowRuntime, WorkflowStore, type WorkflowToolAdapter, WorkspaceIndex, type WorkspaceScanOptions, XENO_AGENT_PROFILE_SCHEMA_VERSION, XENO_API_BASE, XENO_APP_PROTOCOL_V2_METHODS, XENO_APP_PROTOCOL_VERSIONS, XENO_ARTIFACT_ACTOR_KINDS, XENO_ARTIFACT_FILE_REPOSITORY_SCHEMA_VERSION, XENO_ARTIFACT_SCHEMA_VERSION, XENO_ARTIFACT_SENSITIVITIES, XENO_ARTIFACT_STATES, XENO_AUTOMATION_OPERATIONS, XENO_AUTOMATION_PROTOCOL_VERSION, XENO_BUILTIN_ARTIFACT_KINDS, XENO_CAPABILITY_LEASE_SCHEMA_VERSION, XENO_CONTAINMENT_APPROVAL_SCHEMA, XENO_CONTAINMENT_CERTIFICATION_SCHEMA, XENO_CONTAINMENT_CONFORMANCE_SCHEMA, XENO_CONTAINMENT_REVIEWER_TRUST_STORE_SCHEMA, XENO_CONTROL_ROOM_SCHEMA_VERSION, XENO_DEFLATE_CODEC_NAME, XENO_DEFLATE_CODEC_VERSION, XENO_EVIDENCE_EDGE_TYPES, XENO_EVIDENCE_GRAPH_SCHEMA_VERSION, XENO_EVIDENCE_NODE_TYPES, XENO_GIF_ANIMATION_POLICY, XENO_GIF_CODEC_NAME, XENO_GIF_CODEC_VERSION, XENO_HANDOFF_SCHEMA_VERSION, XENO_HOSTED_CONTROL_SCHEMA_VERSION, XENO_HOSTED_ENVIRONMENT_SCHEMA_VERSION, XENO_HOSTED_EVENT_SCHEMA_VERSION, XENO_HOSTED_EXECUTION_ADAPTER_CERTIFICATION_SCHEMA, XENO_HOSTED_EXECUTION_ADAPTER_MAX_CERTIFICATE_LIFETIME_MS, XENO_HOSTED_EXECUTION_ADAPTER_PROTOCOL_VERSION, XENO_HOSTED_EXECUTION_PROTOCOL_VERSION, XENO_HOSTED_EXECUTION_TOOL_NAMES, XENO_HOSTED_RESULT_SCHEMA_VERSION, XENO_HOSTED_RUN_SCHEMA_VERSION, XENO_HOSTED_TRIGGER_SCHEMA_VERSION, XENO_JPEG_CODEC_NAME, XENO_JPEG_CODEC_VERSION, XENO_MXC_ADAPTER_NAME, XENO_MXC_POLICY_VERSION, XENO_MXC_VERSION, XENO_ORACLE_REPORT_SCHEMA_VERSION, XENO_PLUGIN_LOCK_FILENAME, XENO_PLUGIN_LOCK_SCHEMA_VERSION, XENO_PLUGIN_SIGNATURE_FILENAME, XENO_PLUGIN_SIGNATURE_SCHEMA_VERSION, XENO_PROVIDER_CATALOG_SCHEMA_VERSION, XENO_PROVIDER_CONNECTION_STORE_SCHEMA_VERSION, XENO_RASTER_CODEC_NAME, XENO_RASTER_CODEC_VERSION, XENO_RASTER_PREVIEW_FORMATS, XENO_RECIPE_SCHEMA_VERSION, XENO_REPOSITORY_INDEX_SCHEMA_VERSION, XENO_REVIEW_DIMENSIONS, XENO_REVIEW_EVIDENCE_KINDS, XENO_REVIEW_REPORT_SCHEMA_VERSION, XENO_RT_DEFAULT_URL, XENO_SECURE_EXECUTION_CONTRACT_SCHEMA_VERSION, XENO_SHARE_REGISTRY_SCHEMA_VERSION, XENO_SHARE_SCHEMA_VERSION, XENO_SKILL_SCHEMA_VERSION, XENO_SOURCE_RESEARCH_SCHEMA_VERSION, XENO_SPEC_EXECUTION_SCHEMA_VERSION, XENO_SPEC_SCHEMA_VERSION, XENO_SVG_RENDERER_NAME, XENO_SVG_RENDERER_VERSION, XENO_TELEMETRY_SCHEMA_VERSION, XENO_VP8_CODEC_NAME, XENO_VP8_CODEC_VERSION, XENO_WEBP_ANIMATION_POLICY, XENO_WEBP_CODEC_NAME, XENO_WEBP_CODEC_VERSION, type XenoAnsiEscapeFamily, type XenoAnsiFormatter, type XenoAnsiPolicy, type XenoAnsiStyle, type XenoAnsiToken, type XenoAnsiWrapOptions, type XenoAppProtocolVersion, XenoAppServer, type XenoAppServerOptions, XenoAppServerV2Client, type XenoArtifactActor, type XenoArtifactActorKind, type XenoArtifactAnchor, type XenoArtifactAppendReviewRequest, type XenoArtifactContent, type XenoArtifactEnvelope, type XenoArtifactFileRecoveryNotice, type XenoArtifactFileSnapshot, type XenoArtifactIdentity, type XenoArtifactKind, type XenoArtifactLifecycleEvent, type XenoArtifactListQuery, type XenoArtifactMutationOptions, type XenoArtifactPersistedRecord, type XenoArtifactProvenance, type XenoArtifactRecord, type XenoArtifactRelationship, type XenoArtifactRepository, XenoArtifactRepositoryError, type XenoArtifactRepositoryErrorCode, type XenoArtifactRepositoryState, type XenoArtifactRetention, type XenoArtifactReviewAnchorInput, type XenoArtifactReviewDecision, type XenoArtifactReviewEvent, type XenoArtifactReviewEventInput, XenoArtifactReviewService, type XenoArtifactReviewServiceOptions, type XenoArtifactReviewSummary, type XenoArtifactRevisionOptions, type XenoArtifactSensitivity, type XenoArtifactState, XenoArtifactStateTransitionError, type XenoArtifactStorageReference, type XenoArtifactTransitionRequest, XenoArtifactValidationError, type XenoArtifactValidationIssue, XenoAuthError, type XenoAuthErrorCode, type XenoAutomationAdapter, type XenoAutomationAdapterExecutionResult, type XenoAutomationAdapterManifest, type XenoAutomationConformanceCheck, type XenoAutomationConformanceReport, type XenoAutomationEffect, XenoAutomationError, type XenoAutomationErrorCode, type XenoAutomationEvidenceContent, type XenoAutomationEvidenceInput, type XenoAutomationEvidencePhase, type XenoAutomationEvidencePolicy, type XenoAutomationExecutionGrant, type XenoAutomationExecutionResult, type XenoAutomationIdentity, type XenoAutomationLeaseAuthority, type XenoAutomationOperation, type XenoAutomationOperationDescriptor, type XenoAutomationPreflight, type XenoAutomationRequest, type XenoAutomationSurface, type XenoAutomationTarget, type XenoBasicRasterImage, type XenoBrowserAutomationOperation, type XenoBrowserExecutionPolicy, type XenoCapabilityEffect, type XenoCapabilityEligibility, type XenoCapabilityKind, type XenoCapabilityLease, type XenoCapabilityLeaseApprovalContext, type XenoCapabilityLeaseApprovalRequest, type XenoCapabilityLeaseDenialRequest, XenoCapabilityLeaseError, type XenoCapabilityLeaseErrorCode, type XenoCapabilityLeaseRequest, type XenoCapabilityLeaseRevocationRequest, type XenoCapabilityLeaseState, type XenoCapabilityScope, type XenoCapabilitySubject, type XenoCapabilityUse, type XenoColorDepth, type XenoColorPolicy, type XenoCompiledRecipe, type XenoCompiledRecipeStep, type XenoComputerAutomationOperation, type XenoComputerExecutionPolicy, type XenoConfig, type XenoContainmentApprovalReport, type XenoContainmentCertificationApproval, type XenoContainmentCertificationManifest, type XenoContainmentConformanceReport, type XenoContainmentReviewerTrustStore, type XenoContentHash, type XenoControlRoomActionKind, type XenoControlRoomActionPlan, type XenoControlRoomActionRequest, type XenoControlRoomAgent, type XenoControlRoomAgentInput, type XenoControlRoomAgentStatus, type XenoControlRoomApprovalInput, type XenoControlRoomApprovalKind, type XenoControlRoomArtifactInput, type XenoControlRoomAttentionItem, type XenoControlRoomAttentionKind, type XenoControlRoomGoalInput, type XenoControlRoomInput, type XenoControlRoomMonitorInput, type XenoControlRoomNotificationInput, type XenoControlRoomProjectionOptions, type XenoControlRoomSnapshot, type XenoControlRoomStatusCategory, type XenoControlRoomSummary, type XenoControlRoomTask, type XenoControlRoomTaskInput, type XenoControlRoomUsage, XenoControlRoomValidationError, type XenoCreatedShare, type XenoCredentialSource, type XenoCredentialType, type XenoDesktopCaptureSource, type XenoDesktopCapturer, type XenoDiffArtifactContext, type XenoDiffDocument, type XenoDiffFile, type XenoDiffFileStatus, type XenoDiffHunk, type XenoDiffLine, type XenoDiffLineKind, type XenoDiffMode, XenoDiffParseError, type XenoEd25519Signature, type XenoEnvironmentExecutionPolicy, type XenoEvidenceEdge, type XenoEvidenceEdgeType, type XenoEvidenceGraph, XenoEvidenceGraphBuilder, type XenoEvidenceGraphBuilderOptions, XenoEvidenceGraphValidationError, type XenoEvidenceNode, type XenoEvidenceNodeType, type XenoEvidenceReference, type XenoExecutionAdapterIdentity, type XenoExecutionEnforcement, type XenoExecutionIdentity, type XenoExternalActionExecutionPolicy, type XenoFilesystemExecutionPolicy, type XenoGifAnimation, type XenoGifDisposal, type XenoGifFrame, type XenoGitHubReviewComment, XenoGovernedAutomationExecutor, type XenoGovernedAutomationExecutorOptions, type XenoGovernedAutomationToolExecution, type XenoGovernedAutomationToolRuntime, type XenoHandoffAuthority, type XenoHandoffPayload, type XenoHandoffResumePoint, type XenoHandoffTarget, type XenoHostedArchitecture, type XenoHostedAuthority, type XenoHostedBudget, type XenoHostedCacheMount, type XenoHostedControlAcknowledgement, type XenoHostedControlAction, type XenoHostedControlCommand, type XenoHostedControlCommandPayload, type XenoHostedEnvironmentManifest, type XenoHostedEnvironmentManifestPayload, type XenoHostedEventRecord, type XenoHostedExecutionAdapterCertification, type XenoHostedExecutionAdapterVerificationOptions, type XenoHostedExecutionBoundaryReceipt, type XenoHostedExecutionJob, type XenoHostedExecutionSecretValue, type XenoHostedImageReference, type XenoHostedNetworkDestination, type XenoHostedNetworkPolicy, type XenoHostedOs, type XenoHostedQuotaLease, type XenoHostedReplayCursor, type XenoHostedReplayPage, type XenoHostedRepositorySource, type XenoHostedResourceLimits, type XenoHostedRetentionPolicy, type XenoHostedRunRecord, type XenoHostedRunRequest, type XenoHostedRunResult, type XenoHostedRunResultPayload, type XenoHostedRunStatus, type XenoHostedSecretProjection, type XenoHostedSetupStep, type XenoHostedTriggerDefinition, type XenoHostedTriggerDelivery, type XenoHostedTriggerKind, type XenoHostedWebhookSource, type XenoHostedWebhookVerification, type XenoJsonObject, type XenoJsonPrimitive, type XenoJsonValue, type XenoJwtPayload, type XenoLegacyAgentArtifactContext, type XenoLegacyArtifactContext, type XenoLoadedSkill, XenoLoopbackAutomationAdapter, type XenoLoopbackAutomationAdapterOptions, XenoMultiAgentReviewCoordinator, type XenoMultiAgentReviewCoordinatorOptions, type XenoNetworkDestination, type XenoNetworkExecutionPolicy, type XenoOracleAdjudication, type XenoOracleAdjudicationDraft, type XenoOracleAdjudicationRequest, type XenoOracleAdjudicationResult, type XenoOracleArtifactContext, type XenoOracleCitation, type XenoOracleClaim, XenoOracleCoordinator, type XenoOracleCoordinatorOptions, type XenoOracleDisagreement, type XenoOracleExecutionRequest, type XenoOracleExecutionResult, type XenoOracleModelIdentity, type XenoOracleOpinion, type XenoOracleOpinionDraft, type XenoOracleReport, type XenoOracleRole, type XenoOracleRunOptions, XenoOracleValidationError, type XenoOracleVerdict, type XenoProcessExecutionPolicy, type XenoProjectState, type XenoProviderAdapterKind, type XenoProviderAuthPreset, type XenoProviderCapabilities, XenoProviderCatalog, type XenoProviderConnection, type XenoProviderConnectionSnapshot, type XenoProviderConnectionView, type XenoProviderCredentialMode, type XenoProviderModelDescriptor, type XenoProviderPreset, type XenoProviderProbeResult, type XenoProviderReadiness, type XenoProviderRouteCandidate, type XenoProviderRoutingPolicy, type XenoPtyAdapter, type XenoPtyProcess, type XenoPtySpawnOptions, type XenoRasterImage, type XenoRasterPreview, type XenoRecipeDefinition, type XenoRecipeInputDefinition, type XenoRecipeMode, type XenoRecipePermissionMode, type XenoRecipeStepDefinition, XenoRecipeValidationError, type XenoRedactionCategory, type XenoRedactionEvent, type XenoRedactionOptions, type XenoRedactionReport, type XenoRedactionResult, type XenoRemoteRepositoryIdentity, type XenoRemoteSourceFile, type XenoRemoteSourceProvider, type XenoRepositoryChunk, type XenoRepositoryDocumentKind, type XenoRepositoryEmbedding, type XenoRepositoryEmbeddingProvider, type XenoRepositoryEmbeddingRequest, type XenoRepositoryFileRecord, type XenoRepositoryFreshnessInput, type XenoRepositoryFreshnessReport, type XenoRepositoryGitProvenance, type XenoRepositoryIndexBuildOptions, XenoRepositoryIndexFileStore, type XenoRepositoryIndexSnapshot, type XenoRepositoryIndexStats, type XenoRepositoryRelationship, type XenoRepositoryRelationshipKind, type XenoRepositorySearchMode, type XenoRepositorySearchQuery, type XenoRepositorySearchResponse, type XenoRepositorySearchResult, type XenoRepositorySourceDocument, type XenoRepositorySymbol, type XenoRepositorySymbolGraph, type XenoRepositorySymbolKind, type XenoResolvedApiKey, type XenoReviewAgentExecutor, type XenoReviewAgentResult, type XenoReviewArtifactContext, type XenoReviewCoordinatorContext, type XenoReviewDimension, type XenoReviewEvidence, type XenoReviewEvidenceKind, type XenoReviewFinding, type XenoReviewFindingProposal, type XenoReviewFindingState, type XenoReviewPack, type XenoReviewReport, type XenoReviewSeverity, type XenoReviewTarget, XenoReviewValidationError, type XenoReviewVerificationOutcome, type XenoReviewVerificationResult, type XenoReviewVerifierExecutor, type XenoRuntimeEvent, type XenoRuntimeEventBase, XenoRuntimeEventBus, type XenoRuntimeEventDraft, type XenoRuntimeEventSink, type XenoRuntimeEventType, type XenoSecretProjection, type XenoSecureExecutionContract, XenoSecureExecutionContractError, type XenoSecureExecutionContractErrorCode, type XenoShareAccessPolicy, type XenoShareContent, type XenoShareGitContext, type XenoShareIssuer, type XenoSharePayload, type XenoSharePrincipal, type XenoShareReference, type XenoShareRegistryRecord, type XenoShareRegistrySnapshot, type XenoShareSessionIdentity, type XenoShareSigningIdentity, type XenoShareStatus, type XenoShareSurface, type XenoShareVerificationResult, type XenoShareVisibility, type XenoSignedHandoffEnvelope, type XenoSignedShareEnvelope, type XenoSkillActivation, type XenoSkillAuditEvent, type XenoSkillCatalog, type XenoSkillDescriptor, type XenoSkillDiagnostic, type XenoSkillDiscoveryOptions, type XenoSkillDiscoveryRoot, type XenoSkillExternalActionPolicy, type XenoSkillInvocationDecision, type XenoSkillInvocationPolicy, type XenoSkillResourceDescriptor, type XenoSkillShadowRecord, type XenoSkillSource, type XenoSkillTool, type XenoSkillToolPolicy, type XenoSourceResearchArtifactContext, type XenoSourceResearchExcerpt, type XenoSourceResearchFinding, type XenoSourceResearchModelIdentity, type XenoSourceResearchReport, type XenoSourceResearchSeverity, XenoSourceResearchValidationError, type XenoSpecAcceptanceCriterion, type XenoSpecArtifactBundle, type XenoSpecArtifactContext, type XenoSpecDesign, type XenoSpecDesignDecision, type XenoSpecDocument, type XenoSpecDriftFinding, type XenoSpecDriftReport, type XenoSpecExecutionRecord, type XenoSpecExecutionState, XenoSpecLifecycleService, type XenoSpecLifecycleServiceOptions, type XenoSpecPriority, type XenoSpecRequirement, type XenoSpecRisk, type XenoSpecSourceBaseline, type XenoSpecTask, type XenoSpecTaskExecution, type XenoSpecTaskStatus, XenoSpecValidationError, type XenoTelemetryAttributeValue, type XenoTelemetryRecord, type XenoTelemetrySignalKind, type XenoTelemetrySubscriber, type XenoThreadRunOptions, type XenoThreadRunResult, XenoTraceGraphRecorder, type XenoUserConfig, type XenoVerifiedHostedExecutionAdapterCertification, type XenoVp8Image, acquireControlPlaneLock, activateSessionRuntime, addProjectAllowedDirectory, addProjectAllowedTool, agentDefinitionFromProfile, agentProfileFromDefinition, appendBoundedShellOutput, appendGuidanceToResult, approveMcpServer, areSignalHandlersInstalled, artifactCompareTool, askUserTool, assertDirectEndpointResolution, assertRequiredXenoAutomationEvidence, assertSupportedMcpProtocolVersion, assertUsableXenoApiKey, assertValidMcpAppResource, assertValidXenoArtifact, assertValidXenoAutomationAdapterManifest, assertValidXenoAutomationRequest, assertValidXenoEvidenceGraph, assertValidXenoHostedExecutionJob, assertValidXenoOracleReport, assertValidXenoRecipeDefinition, assertValidXenoReviewPack, assertValidXenoReviewReport, assertValidXenoReviewTarget, assertValidXenoSecureExecutionContract, assertValidXenoSourceResearchReport, assertValidXenoSpecDocument, assertValidXenoSpecExecution, assertXenoArtifactStateTransition, assertXenoAutomationAdapterConformant, assertXenoAutomationAuthority, auditRiskLevelForTool, authorizeShellExecution, backgroundProcessManager, bashTool, benchmarkCodingTools, bridgeXenoTelemetryToOpenTelemetry, buildAtomicMessageGroups, buildAuditReplayReport, buildAuditTraceReport, buildContainedProcessSpec, buildContractLedgerGuidance, buildDefaultSubagentTasks, buildDelegatedRoleSystemPrompt, buildHookEnvironment, buildLinuxBubblewrapProcessSpec, buildLspDefinitionReport, buildLspDiagnosticsReport, buildLspDoctorReport, buildLspHoverReport, buildLspReferencesReport, buildMotionSystemPrompt, buildPixelSystemPrompt, buildProcessHardenedProcessSpec, buildProjectBudgetFinalizationGuidance, buildProjectExecutionGuidance, buildProjectExecutionProfile, buildPromptMemoryContext, buildSecuredProcessSpec, buildSoundSystemPrompt, buildSystemPrompt, buildToolFailureGuardResult, buildXenoArtifactReviewAnchor, buildXenoAutomationCapabilityUse, buildXenoRepositoryIndex, buildXenoRepositoryIndexWithEmbeddings, buildXenoSecureExecutionContract, cachedModelContextWindow, calculateCost, canTransitionXenoArtifactState, canXenoRasterPreview, canonicalPayload, canonicalizeArtifactJson, canonicalizeMcpResourceUri, canonicalizeSecurityPath, canonicalizeToolName, checkSandbox, classifyProviderHttpError, cleanupReadImagePreviews, cleanupSessionRuntime, clearMcpServerApproval, clearProjectAllowedTools, clearProjectLastSessionSummary, clearProjectMcpApproval, clearProjectMcpApprovals, clipXenoAnsi, coerceSubagentRole, coerceSubagentTeamPreset, compileAgentProfile, compileJsonSchema, compileToolInputSchema, compileXenoRecipe, compileXenoSkillActivation, configureImageGeneration, configureSearch, configureSearchPermissionProfile, configureXenoAnsi, containmentApprovalSigningPayload, containmentCertificationSigningPayload, copyTextToClipboard, create3DTools, createAgentDefinitionFile, createAgentDefinitionPromptSection, createAgentRunId, createAppServerV2HttpTransport, createArchitectTools, createArtifactCompareTool, createAskUserTool, createAudioTools, createAuditBackedPermissionEngine, createBashTool, createBenchBashMiddleware, createCommandBackedProtectedStateStore, createDefaultToolRegistry, createDelegatedXenoAgent, createDirectProvider, createDirectShellMessage, createDispatchAgentTool, createDocsTools, createEd25519Signer, createEditTool, createElfAnalyzeTool, createEngineTools, createGcodeAnalyzeTool, createGenerateImageTool, createGlobTool, createGovernanceExtensions, createGrepTool, createHtmlSanitizerAuditTool, createImageTools, createLsTool, createLspDefinitionTool, createLspDiagnosticsTool, createLspHoverTool, createLspReferencesTool, createMcpAppCapabilities, createMcpAppExtensionCapabilities, createMcpPkcePair, createMcpPromptRegisteredTool, createMcpRegisteredTool, createMcpResourceRegisteredTool, createMemoryProtectedStateStore, createMemoryReadTool, createMemoryWriteTool, createNotebookEditTool, createNotebookReadTool, createNotesTools, createOsProtectedStateStore, createProtectedStateEnvelopeCipher, createReadImageTool, createReadTool, createSheetsTools, createSlidesTools, createSpeechRecognizer, createSqliteAnalyzeTool, createTaskInputTool, createTaskListTools, createTaskOutputTool, createTaskStopTool, createThinkTool, createToolAlias, createToolRuntimeContext, createUnavailableProtectedStateStore, createVideoTools, createWebContextFetchTool, createWebContextRequestFactory, createWebContextSearchTool, createWebSearchTool, createWindowsDpapiProtectedCipher, createWindowsDpapiProtectedFileStore, createWorkflowTools, createWriteTool, createXenoAgent, createXenoAutomationConformanceReport, createXenoGovernedAutomationTools, createXenoHostedControlCommand, createXenoHostedEnvironmentManifest, createXenoHostedEvent, createXenoHostedExecutionBoundaryReceipt, createXenoHostedRunResult, createXenoRasterPreview, createXenoSecureShare, createXenoSessionHandoff, createXenoShareSigningIdentity, createXenoSkillTool, createXenoSourceResearchExcerpt, createXenoSourceResearchReport, currentExecutionAdapterStatus, decodeJwtPayload, decodeXenoBmp, decodeXenoGif, decodeXenoGifAnimation, decodeXenoJpeg, decodeXenoNetpbm, decodeXenoPng, decodeXenoSvg, decodeXenoVp8, decodeXenoWebp, defaultToolRuntimeContext, defaultXenoReviewPack, deflateXenoZlib, deleteSession, denyMcpServer, deriveHostedIdempotencyKey, describeXenoAutomationOperation, detectLanguage, detectPluginRepositorySignals, detectRepositoryDocumentKind, detectRepositoryLanguage, detectXenoSpecDrift, deterministicReduce, digestMessages, directProviderConfigFromConnection, discoverXenoSkills, dispatchAgentTool, editTool, elfAnalyzeTool, emitXenoTelemetry, encodeXenoPngRgb, enforceShellCommandPolicy, enforceToolPolicy, ensureConfigDir, ensureDurableMessageIds, ensureProjectStateDir, estimateFullRequestBudget, evaluateContainmentUiRestrictions, evaluatePermissionProfileNetworkUrl, evaluateXenoCapabilityEligibility, extractJsonObject, extractToolPath, findXenoSkill, fingerprintXenoSecureExecutionContract, forgetRecentSession, forgetRecentSessionById, formatBoundedShellOutput, formatCost, formatDirectShellContext, formatJsonSchemaErrors, formatModelList, formatPromptContextBreakdown, gcodeAnalyzeTool, generateImageTool, generateSessionId, getAgentHome, getAgentRunDir, getAgentRunStoreDir, getAvailableModels, getBenchmarkComputeBudgetHintForCommand, getBenchmarkForegroundTimeoutForCommand, getBestExecutionSecurityStatus, getChatModels, getConfigDir, getDefaultProviderRegistry, getExecutionSecurityCapabilityReport, getExecutionSecurityStatus, getGlobIgnores, getGrepIgnores, getHighRiskPermissions, getImageGenerationConfig, getJwtExpiry, getLinuxBubblewrapCapability, getLogLevel, getManagedConfigPath, getMcpAppMetadata, getMcpAppResourceUri, getMcpApprovalDecision, getMcpAuthorizationServerMetadataUrls, getMcpPromptToolName, getMcpProtectedResourceMetadataUrls, getMcpResourceToolName, getMcpToolName, getModelName, getMxcContainmentProbe, getMxcNativeAssetDescriptor, getMxcWindowsHostPreparationDescriptor, getMxcWindowsHostPreparationHelperArchitecture, getPermissionProfile, getPersistentShellSession, getPersistentShellSpawnSpec, getProcessContainmentStatus, getProjectAgentDefinitionDirs, getProjectAgentDefinitionsDir, getProjectLastSessionSummary, getProjectMcpApproval, getProjectStatePath, getReadImagePreviewCapability, getRecentSessionsIndexPath, getSubagentTeamPresetDefinition, getToolRiskLevel, getUserAgentDefinitionsDir, gitBranchTool, gitCommitTool, gitDiffTool, gitLogTool, gitStatusTool, globTool, grepTool, gzipXeno, hasProjectOnboardingCompleted, hasXenoTelemetrySubscribers, hashContainmentConformanceReport, hashPluginManifest, hashPluginTree, hookResultStatus, hostedEnvironmentIdentity, htmlSanitizerAuditTool, importLegacyXenoSkill, inflateXenoZlib, initializeSessionRuntime, inspectRuntimeManifests, inspectSecurityPath, inspectSystemPrompt, inspectXenoRepositoryFreshness, inspectXenoRepositorySymbol, installSignalHandlers, invalidateAllObservedFiles, invokeXenoSkill, isChatModel, isDangerousCommand, isDirectShellMessage, isExpiredJwt, isExplicitResearchPrompt, isJwt, isLocalModel, isMcpAppResourceUri, isMcpOAuthTokenExpired, isMcpToolVisibleToApp, isMcpToolVisibleToModel, isNotBeforeJwt, isPathWithinAllowed, isScreenCaptureAvailable, isSensitiveEnvironmentKey, isSimpleInformationalPrompt, isSpeechRecognitionAvailable, isSupportedMcpProtocolVersion, isToolAllowedByXenoSkillActivation, isUncOrDevicePath, isValidAgentDefinitionName, isValidModel, isValidSessionId, isWorkspaceTrusted, isXenoAutomationOperation, legacyAgentArtifactToXenoArtifact, listBuiltInAgentProfiles, listPermissionProfiles, listProjectAllowedTools, listProjectMcpApprovals, listSessions, loadConfig, loadConfiguredMcpServers, loadMcpConfigFile, loadProjectConfig, loadProjectState, loadRecentSessionsIndex, loadSession, loadUserConfig, loadXenoSkill, lookupRecentSession, lsTool, lspDefinitionTool, lspDiagnosticsTool, lspHoverTool, lspReferencesTool, matchPermissionRule, matchesMcpRegistryEntryPolicy, materializeXenoAutomationEvidence, memoryReadTool, memoryWriteTool, mergeConfigs, mxcWarningsRequireWindowsHostPreparation, normalizeDirectShellResultRecord, normalizeHookDecision, normalizeMcpAppVisibility, normalizePermissionProfileName, normalizeRepositoryRelativePath, normalizeSourceText, normalizeSubagentBranchPolicy, normalizeWorkingDirectory, normalizeXenoHostedControlAcknowledgement, notebookEditTool, notebookReadTool, parseContainmentReviewerTrustStore, parseMcpWwwAuthenticate, parsePermissionRule, parseRetryAfter, parseSessionId, parseShellPathReferences, parseSubagentRemoteMcpPolicy, parseSubagentRoleList, parseUnifiedDiff, parseXenoAnsi, parseXenoRecipeDefinition, persistXenoAutomationEvidence, planXenoControlRoomAction, pluginInfoRelevanceCandidate, pluginListingRelevanceCandidate, pluginSignaturePayload, preflightLocalModel, prepareMxcWindowsHost, probeXenoProvider, projectToolDefinitionsForProvider, projectToolSchemaForProvider, projectXenoControlRoom, providerCapabilityError, providerProtocolError, publicKeyFingerprint, publishPlugin, rankPluginRelevance, readImageTool, readManifestFromDisk, readPluginDetachedSignature, readPluginSupplyChainLockfile, readSessionFormatVersion, readTool, readXenoApiKey, recordRecentSession, recordXenoCounter, recordXenoEvent, recordXenoHistogram, recoverSessionMessages, redactXenoShareValue, registerShutdownCleanup, registry, removeMcpServerConfig, removeProjectAllowedTool, renderAgentDefinition, renderAgentDefinitions, renderAuditReplayMarkdown, renderAuditReplayReport, renderAuditTraceMarkdown, renderAuditTraceReport, renderAuditTraceSummaries, renderCodingBenchmarkMarkdown, renderCodingBenchmarkReport, renderContinuationIncompleteStatus, renderLspDefinitionReport, renderLspDiagnosticsReport, renderLspDoctorReport, renderLspHoverReport, renderLspReferencesReport, renderToolContinuationInput, renderXenoSkillCatalog, repairInterruptedToolCalls, repairToolExchangeHistory, requestBackground, requiresSecuredProcessLaunch, resetAllPersistentShellSessions, resetBashBenchmarkGuards, resetImageGenerationConfig, resetMcpServerApprovals, resetMxcContainmentProbe, resetPersistentShellSession, resetXenoAnsiPolicy, resetXenoTelemetryCardinalityForTests, resizeXenoRaster, resolveAgentDefinition, resolveAgentProfile, resolveAgentToolPolicy, resolveBuiltInAgentProfile, resolveCommandOnPath, resolveContainmentConformanceTemporaryRoot, resolveDelegatedExecutionMode, resolveExecutionSecurityLevel, resolveExecutionTrustMode, resolveInteractiveTurnMaxIterations, resolveModelContextTokens, resolvePermissionProfile, resolveShellInvocation, resolveSubagentRemoteMcpAccess, resolveSubagentWorkflowAnswer, resolveXenoAutomationEvidencePolicy, resolveXenoSdkApiKey, runAgentHook, runCommandHook, runContainmentConformanceSuite, runDelegatedXenoTurn, runDelegationPlan, runHookDefinition, runHooks, runHttpHook, runPromptHook, runSubagentWorkflow, runXenoThread, runXenoThreadStreamed, sanitizeEnvironment, sanitizeXenoTelemetryAttributes, saveConfig, saveMcpConfigFile, saveProjectState, saveSession, scaffoldPlugin, scanAgentDefinitions, scoreMemories, scorePluginRelevance, searchXenoRepositoryIndex, selectXenoProviderRoute, serializeXenoRecipe, setLogLevel, setProjectLastSessionSummary, setProjectMcpApproval, setProjectOnboardingCompleted, setWorkspaceTrusted, setupAIHandlers, sha256ArtifactBytes, sha256ArtifactJson, shouldEnableExecutionGovernance, shouldSourceShellProfile, shouldUseIsolatedStdinForCommand, signSharePayload, sqliteAnalyzeTool, stripXenoAnsi, subscribeXenoTelemetry, summarizeAuditInputRecord, summarizeAuditTraces, summarizeRuntimeInput, summarizeSubagentResults, summarizeXenoArtifactReview, syncMcpToolsToRegistry, synthesizeSkill, taskInputTool, taskOutputTool, taskStopTool, testPlugin, thinkTool, toAgentDefinitionMetadata, toLLMProvider, toolEvidenceToXenoArtifact, toolOperationManager, toolRiskLevel, turnDiffSummaryToXenoArtifact, unifiedDiffToXenoArtifact, unifiedExecManager, updateProjectState, upsertMcpServerConfig, validateAgentDefinition, validateCapabilityLeaseRequest, validateDelegationPlan, validateDirectEndpoint, validateExecutionSecurityPolicy, validateJsonSchema, validateManifest, validateMcpAppResource, validateXenoArtifact, validateXenoArtifactReviewEvent, validateXenoControlRoomSnapshot, validateXenoEvidenceGraph, validateXenoRepositoryIndex, validateXenoSdkApiKey, validateXenoSecureExecutionContract, validateXenoSpecDocument, verifyContainmentCertification, verifyContainmentCertificationApproval, verifyPluginSupplyChain, verifySignature, verifySoulRecord, verifyXenoHostedControlCommand, verifyXenoHostedEnvironmentManifest, verifyXenoHostedEventChain, verifyXenoHostedExecutionAdapterCertification, verifyXenoHostedExecutionJob, verifyXenoHostedRunResult, verifyXenoHostedWebhook, verifyXenoSecureShare, verifyXenoSessionHandoff, webFetchTool, webSearchTool, windowsDpapiProtect, windowsDpapiUnprotect, withXenoTelemetrySpan, wrapXenoAnsi, writePluginSupplyChainLockfile, writeTool, xenoAnsi, xenoAnsiVisibleWidth, xenoArtifactToDiffDocument, xenoArtifactToLegacyAgentArtifact, xenoArtifactToOracleReport, xenoArtifactToReviewReport, xenoArtifactToSourceResearchReport, xenoArtifactToSpecDocument, xenoArtifactToSpecExecution, xenoArtifactToToolEvidence, xenoArtifactToTurnDiffSummary, xenoHostedExecutionAdapterSigningPayload, xenoOracleReportToArtifact, xenoRecipeFingerprint, xenoReviewReportToArtifact, xenoReviewReportToGitHubComments, xenoSourceResearchReportToArtifact, xenoSpecArtifactIds, xenoSpecExecutionToArtifact, xenoSpecToArtifactBundle };
13316
+ export { type A2AMessage, type A2AMessageType, AGENT_DAEMON_PROTOCOL_VERSION, AGENT_EFFORT_LEVELS, AGENT_PERMISSION_MODES, AGENT_PROFILE_EXTERNAL_ACTIONS, ARCHITECT_CAPABILITIES, ARCHITECT_TOOL_NAMES, type ActiveLayerInfo, type AddXenoArtifactCommentRequest, type AgentArtifact, type AgentCapabilities, type AgentCard, AgentDaemonClient, type AgentDaemonError, type AgentDaemonHandler, type AgentDaemonRequest, type AgentDaemonResponse, AgentDaemonServer, type AgentDaemonTransport, AgentDebugger, type AgentDefinition, type AgentDefinitionIsolation, type AgentDefinitionIssue, AgentDefinitionLoader, type AgentDefinitionLoaderOptions, type AgentDefinitionMetadata, AgentDefinitionResolver, type AgentDefinitionScanResult, type AgentDefinitionScope, type AgentDefinitionShadowRef, type AgentEffortLevel, AgentEvaluator, AgentEventStore, type AgentHookDefinition, AgentHookRunner, AgentInterruptedError, type AgentIpcChannel, type AgentLoadSnapshot, AgentLoop, type AgentLoopConfig, type AgentLoopOptions, type AgentPermissionMode, type AgentProfileActionDecision, type AgentProfileCapabilities, type AgentProfileCapabilityBoundary, type AgentProfileCollaborationMode, type AgentProfileCompletionPolicy, type AgentProfileEvidenceKind, type AgentProfileExecutionPolicy, type AgentProfileExternalAction, type AgentProfileExternalActionPolicy, type AgentProfileIsolation, type AgentProfileKind, type AgentProfileMemoryPolicy, type AgentProfileMemoryScope, type AgentProfilePresentation, type AgentProfileSkillPolicy, type AgentProfileSoulMode, type AgentProfileV2, AgentProfileValidationError, AgentProtocol, AgentRegistry, type AgentRunAgentDefinitionRef, AgentRunController, type AgentRunControllerOptions, type AgentRunCreateInput, AgentRunError, type AgentRunEvent, type AgentRunListOptions, type AgentRunOptions, type AgentRunRecord, type AgentRunSpawnResult, type AgentRunStatus, AgentRunStore, type AgentRunTermination, type AgentRunTerminationReason, type AgentRunTerminationStatus, type AgentRunUsage, type AgentSandbox, type AgentSelectionStrategy, type AgentSessionHostBindingV1, type AgentStreamCallbacks, type AgentTask, type AgentTaskHandler, type AgentTaskResult, type AgentTaskStatus, type AgentTeam, type AgentToAppChannel, type AgentToAppMessages, type AgentToolPolicy, type AnalysisResult, type ApiMessage, type AppAgentBaseOptions, AppAgentFactory, type AppAgentResult, type AppContext, AppContextInjector, AppContextManager, type AppContextProvider, type AppId, type AppServerEventV2, type AppServerInitializeParamsV2, type AppServerInitializeResultV2, type AppServerIntegrationMetadataV2, type AppServerPermissionRequestV2, type AppServerPrincipalV2, AppServerProtocolError, type AppServerProtocolErrorData, AppServerRemoteError, type AppServerRequestContext, type AppServerSubscriptionSnapshotV2, type AppServerThreadStatusV2, type AppServerThreadV2, type AppServerTurnRunnerContextV2, type AppServerTurnRunnerV2, type AppServerTurnStatusV2, type AppServerTurnV2, type AppServerV2ClientTransport, type AppServerV2MethodMap, type AppServerV2Options, type AppToAgentChannel, type AppToAgentMessages, type AppType, type ArchitectAgentOptions, type ArchitectToolAdapter, type AskUserHandler, type AskUserRequest, type AskUserResponse, type AtomicMessageGroup, type AudioProjectInfo, type AudioStemSeparationResult, type AudioToolAdapter, type AudioTrackType, type AudioTranscriptionResult, type AudioTranscriptionSegment, type AuditDecision, type AuditEvent, AuditLogger, type AuditReplayReport, type AuditReplayStep, type AuditRiskLevel, type AuditStatus, type AuditTraceGapEntry, type AuditTraceReport, type AuditTraceSummary, type AuditTraceTimelineEntry, type AuditTraceToolSummary, type AugmentContextOptions, type AuthorizedShellExecution, AutoCheckpointHandler, AutoMemory, type AutoMemoryContext, type AutoMemoryTrigger, AutoPermissionClassifier, type AutoPermissionDecision, BUILT_IN_XENO_PROVIDER_PRESETS, BackgroundProcessManager, type BackgroundTask, type BaseHookDefinition, type BenchBashMiddlewareOptions, type BlockContent, type BlockType, type BoundedShellOutput, type BreakpointCallback, type BuildResult, type BuildXenoSecureExecutionContractOptions, COMPAT_TOOL_ALIASES, CONFIG_VERSION, type CanonicalSecurityPath, type CanvasSize, type CellRangeData, type ChartConfig, type ChatCompletionChunk, type ChatCompletionRequest, type ChatCompletionResponse, type ChatMessage, type ChatParams, type ChatResponse, type CheckpointData, type CheckpointInfo, CheckpointManager, type CheckpointTrigger, type ClaimXenoHandoffInput, type ClashResult, type CliAutomationAuditEvent, type CliAutomationAuditLoggerPort, type CliAutomationEnvironment, type CliAutomationStatusReport, type CliAutomationSurfaceStatus, CliGovernedAutomationRuntime, type ClipContext, type CodeApplyOptions, type CodeApplyResult, type CodeValidationIssue, type CodeValidationResult, CodeValidator, type CodingBenchmarkAssessment, type CodingBenchmarkMeasurement, type CodingBenchmarkOptions, type CodingBenchmarkReport, type CodingBenchmarkThreshold, type CommandBackedProtectedStateOptions, type CommandHookDefinition, CommandHookRunner, type CompactionRecord, type CompileAgentProfileOptions, type CompiledAgentProfile, type CompiledJsonSchema, type CompletionDecision, type CompletionGuard, type CompletionGuardContext, type CompletionGuardDecision, type CompletionGuardEvaluationContext, CompletionGuardRegistry, type CompletionGuardResult, type CompletionGuardResultObject, type CompletionGuardStopReason, type CompletionGuardToolPolicy, type CompletionGuardToolPolicyMode, type CompletionGuardTurnStats, type CompletionGuardVeto, type ComponentData, type CompressionLLMFn, type CompressionStats, type ConfigProfile, type ConnectConfiguredMCPServersOptions, type ConnectConfiguredMCPServersResult, type ContainedProcessSpec, type ContainmentAdapterIdentity, ContainmentApprovalError, type ContainmentCertificationBinding, ContainmentCertificationError, type ContainmentConformanceCheck, type ContentBlock, type ContextCompressedData, ContextManager, type ContextManagerConfig, type ContextSection, type ContextSource, type ControlPlaneLockHandle, type ControlPlaneLockRecord, ConversationStore, type CreateAuditBackedPermissionEngineOptions, type CreateCliGovernedAutomationRuntimeOptions, type CreateDelegatedBranchAgent, type CreateDelegatedBranchAgentOptions, type CreateDelegatedXenoAgentOptions, type CreateXenoAgentOptions, type CreateXenoAgentResult, type CreateXenoGoalInput, type CreateXenoGovernedAutomationToolsOptions, type CreateXenoHandoffInput, type CreateXenoHandoffOptions, type CreateXenoHostGovernedAutomationRuntimeOptions, type CreateXenoShareOptions, type CreateXenoSkillToolOptions, type CreateXenoSourceResearchReportInput, type CrossAppHandler, type CrossAppMessage, CrossAppRouter, CrossAppRouterError, type CrossAppRouterOptions, DEFAULT_API_KEY, DEFAULT_IMAGE_MODEL, DEFAULT_MEMORY_BUDGETS, DEFAULT_MODEL, DEFAULT_PROMPT_SECTIONS_TOKEN_BUDGET, DEFAULT_PROTECTED_STATE_KEY_NAME, DEFAULT_PROTECTED_STATE_SERVICE, DEFAULT_SUBAGENT_BRANCH_POLICY, DEFAULT_SUBAGENT_REMOTE_MCP_BY_ROLE, DEFAULT_SUBAGENT_ROLES, DEFAULT_SUBAGENT_ROLE_PRECEDENCE, DEFAULT_SUBAGENT_TEAM_PRESET, DIRECT_SHELL_CONTEXT_WARNING, DOCS_CAPABILITIES, DOCS_TOOL_NAMES, type DebugBreakpoint, type DebugSnapshot, type DebugStep, type DebugStepCallback, type DecideXenoArtifactRequest, type DefaultToolRegistryOptions, type DefaultWebContextRequestFactoryOptions, type DelegatedBranchAdmission, type DelegatedBranchAdmissionSettlement, type DelegatedBranchAgent, type DelegatedBranchAgentCallbacks, type DelegatedXenoTurnResult, type DelegationBudget, type DelegationLimits, type DelegationSummaryData, type DependencyEdge, type DescendantInstructionHint, type DirectEndpointPolicy, type DirectEndpointProfile, type DirectProviderCapabilityProfile, type DirectProviderConfig, type DirectProviderKind, type DirectShellMessageMetadata, type DirectShellResultRecord, type DispatchAgentHandler, type DispatchAgentRequest, type DispatchAgentResponse, type DocComment, type DocsAgentOptions, type DocsToolAdapter, type DocumentContext, type DualLLMMode, DualLLMProvider, type DualLLMProviderConfig, type DualLLMProviderLike, type DualLLMStatus, DurableXenoCoordinationStore, ENGINE_CAPABILITIES, ENGINE_TOOL_NAMES, ElectronAgentBridge, type ElectronAgentConfig, type EngineAgentOptions, type EngineToolAdapter, type EntityInfo, type Episode, type EpisodeOutcome, EpisodicStore, type EpisodicStoreOptions, type ErrorData, type EvalReport, type EvalResult, type EvalRunOptions, type EvalTask, type ExchangeMCPOAuthCodeOptions, type ExecuteToolRequest, type ExecuteToolResult, type ExecuteXenoCoordinationActionInput, type ExecuteXenoCoordinationActionResult, ExecutionGovernance, type ExecutionGovernanceOptions, type ExecutionGovernanceSummary, type ExecutionMode, type ExecutionSecurityCapabilities, ExecutionSecurityError, type ExecutionSecurityErrorCode, type ExecutionSecurityLevel, type ExecutionTrustMode, type ExpectedOutputContract, type ExportableSoulSigner, type ExtendedAppType, FALLBACK_MODELS, type FailureCluster, type FileEntry, type FileSnapshot, FileXenoArtifactRepository, type FileXenoArtifactRepositoryOptions, FileXenoProviderConnectionStore, type FileXenoProviderConnectionStoreOptions, FileXenoShareRegistry, type FileXenoShareRegistryOptions, type FilterConfig, type GovernanceExtensions, type GovernanceExtensionsOptions, HIGH_RISK_PERMISSIONS, type HarnessTask, type HarnessTaskStatus, type HarnessTaskUpdate, type HookConfig, type HookDecision, type HookDefinition, type HookEventName, type HookExecutionResult, type HookExecutionStatus, type HookInput, type HookInputBase, type HookInvocationInput, type HookModelExecutor, type HookPermissionMode, type HookRunResult, HookRunner, HookRuntime, type HookRuntimeOptions, type HttpHookDefinition, HttpHookRunner, IDENTITY_PATHS, type IdentityFrontmatter, type IdentityLayer, type IdentityLoadResult, IdentityLoader, type IdentityLoaderOptions, type IdentityPaths, IdentityResolver, type IdentitySource, type ImageContentBlock, type ImageDocumentInfo, type ImageGenerationConfig, type ImageLayerInfo, type ImageLayerType, type ImageToolAdapter, type ImageUrlBlock, InMemoryXenoArtifactRepository, type InMemoryXenoArtifactRepositoryOptions, InMemoryXenoCapabilityLeaseRegistry, type InMemoryXenoCapabilityLeaseRegistryOptions, InMemoryXenoTelemetryCollector, type InitializeSessionRuntimeOptions, type InspectSystemPromptOptions, type InstallSignalHandlersOptions, InteractiveChatTurnGovernance, InteractiveTurnGovernance, type InteractiveTurnGovernanceOptions, type IpcHandler, type JsonRpcErrorResponse, type JsonRpcMessage$1 as JsonRpcMessage, type JsonRpcNotification, type JsonRpcRequest$1 as JsonRpcRequest, type JsonRpcResponse, type JsonRpcSuccessResponse, type JsonSchema, JsonSchemaCompilationError, type JsonSchemaCompilationIssue, type JsonSchemaCompileOptions, type JsonSchemaSubset, type JsonSchemaType, type JsonSchemaValidationError, type JsonSchemaValidationResult, type LLMCompletionResult, type LLMProvider, type LLMProviderCapabilities, type LLMProviderMessage, type LLMProviderRequestContext, type ToolDefinition as LLMProviderToolDefinition, type LLMToolDefinition, type LayerContext, type LegacyXenoSkillInput, type LinuxBubblewrapCapability, type LinuxBubblewrapProcessSpec, LlmClient, type LlmClientDeps, LocalLLMProvider, type LocalLLMProviderConfig, type LocalRuntimePreflightResult, LogLevel, type LspDefinitionReport, type LspDiagnosticsReport, type LspDoctorReport, type LspDoctorServer, type LspHoverReport, type LspReferencesReport, MANIFEST_FILENAME, MAX_CONTAINMENT_APPROVAL_AGE_MS, MAX_CONTAINMENT_CERTIFICATION_BYTES, MAX_CONTAINMENT_CERTIFICATION_LIFETIME_MS, MAX_DIRECT_SHELL_OUTPUT_CHARS, type MCPAppCapabilities, type MCPAppContentSecurityPolicy, type MCPAppExtensionMetadata, type MCPAppMetadata, type MCPAppPermissions, type MCPAppResourceDescriptor, type MCPAppValidationResult, type MCPAppVisibility, type MCPApprovalDecision, type MCPBearerTokenRefreshHandler, type MCPBearerTokenResolver, type MCPConfigFile, type MCPConfiguredServer, type MCPElicitationAction, type MCPElicitationHandler, type MCPElicitationRequest, type MCPElicitationResponse, type MCPHttpAuthChallenge, MCPHttpTransportError, type MCPHttpUrlPhase, type MCPInitializeParams, type MCPInitializeResult, MCPManager, type MCPManagerOptions, type MCPOAuthAuthorizationServerMetadata, type MCPOAuthAuthorizationSession, MCPOAuthClient, type MCPOAuthClientOptions, type MCPOAuthClientRegistration, type MCPOAuthClientRegistrationSource, type MCPOAuthConfig, type MCPOAuthDiscoveryResult, type MCPOAuthProtectedResourceMetadata, type MCPOAuthTokenSet, type MCPOAuthTokenStore, type MCPOAuthUrlPhase, type MCPPrompt, type MCPPromptGetParams, type MCPPromptGetResult, type MCPPromptsListResult, type MCPRegistryAccessPolicy, type MCPRegistryEntryDescriptor, type MCPRegistryEntryKind, type MCPRegistryFilter, type MCPResource, type MCPResourceReadParams, type MCPResourceReadResult, type MCPResourceSubscribeParams, type MCPResourceUnsubscribeParams, type MCPResourcesListResult, MCPServer, type MCPServerConfig, type MCPServerModeOptions, type MCPServerPromptRegistration, type MCPServerResourceRegistration, type MCPServerScope, type MCPServerState, type MCPTool, type MCPToolCallParams, type MCPToolCallResult, type MCPToolsListResult, type MCPTransport, type MCPTransportConnection, MCP_APPS_EXTENSION_ID, MCP_APP_MIME_TYPE, MCP_APP_RESOURCE_SCHEME, MCP_PROTOCOL_VERSION, MCP_SUPPORTED_PROTOCOL_VERSIONS, MEMORY_FILES, MOTION_CAPABILITIES, MOTION_SYSTEM_PROMPT, MOTION_TOOL_NAMES, type ManifestValidationResult, type MaterialConfig, type MaterializeXenoAutomationEvidenceOptions, type MemoryAccessScope, type MemoryBudget, type MemoryEntry, type MemoryFile, type MemoryLevel, MemoryManager, type MemoryManagerOptions, type MeshInfo, type Message, MessageFlow, type MessageFlowDeps, type ModeSwitchRequest, type ModelInfo, type ModelProvider, ModelProviderRegistry, type MonitorEvent, MonitorManager, type MonitorSnapshot, type MonitorSource, MonitorStopTool, MonitorTool, type MotionAgentOptions, type MotionPromptParams, type MxcContainmentProbe, type MxcNativeAssetDescriptor, type MxcWindowsHostPreparationReport, NOTES_CAPABILITIES, NOTES_TOOL_NAMES, type NormalizedLspDiagnostic, type NormalizedLspHover, type NormalizedLspLocation, type NormalizedLspRange, type NotePageInfo, type NoteSearchResult, type NotesAgentOptions, type NotesToolAdapter, type OnChunkCallback, type OnTaskCompleteInput, type OnTaskCompleteResult, type OpenTelemetryMetricAdapter, type OperationTaskSource, type OsProtectedStateStoreOptions, OtelExporter, type OtelUsageAdapter, PIXEL_CAPABILITIES, PIXEL_SYSTEM_PROMPT, PIXEL_TOOL_NAMES, PROCESS_TREE_ADAPTERS, PROJECT_STATE_VERSION, type ParameterizedPermissionRule, type ParseUnifiedDiffOptions, type PermissionConfig, type PermissionDecision, type PermissionDecisionEvent, type PermissionDecisionHook, PermissionEngine, type PermissionInfo, type PermissionProfile, type PermissionProfileDecision, type PermissionProfileMode, type PermissionProfileName, type PermissionProfileNetworkDecision, type PermissionProfileResolution, type PermissionPromptFn, type PermissionPromptInfo, type PermissionPromptOperation, type PermissionPromptPreview, type PermissionPromptPreviewLine, type PermissionRequestContext, type PermissionRequestInfo, type PermissionRequestResult, type PermissionRule, type PersistentPermissionState, type PixelAgentOptions, type PixelPromptParams, type PlatformInfo, type PluginActivationEvent, type PluginAuthor, type PluginCapability, type PluginCommandContribution, type PluginCommandHandler, type PluginContext, type PluginContributions, type PluginDetachedSignature, type PluginEngineConstraint, type PluginEvent, PluginEventBus, type PluginEventListener, type PluginEventType, type PluginHook, PluginHost, type PluginHostInfo, type PluginHostOptions, type PluginInfo, type PluginListing, type PluginLogger, PluginManager, type PluginManagerOptions, type PluginManifest, PluginMarketplace, type PluginMarketplaceOptions, type PluginOutputStyleContribution, type PluginPermission, type PluginPromptContribution, type PluginPublishOptions, type PluginRelevanceCandidate, type PluginRelevanceHints, type PluginRelevanceSuggestion, type PluginRepositorySignal, PluginSandbox, type PluginSandboxOptions, type PluginScaffoldOptions, type PluginSearchOptions, type PluginSettingContribution, PluginSettingsManager, type PluginSignatureStatus, type PluginStatus, type PluginStorage, type PluginSupplyChainLockfile, type PluginSupplyChainRecord, type PluginTestCase, type PluginTestResult, PluginToolBuilder, type PluginToolContribution, type PluginTrustBadge, type PluginUIPanel, type PolicyCheckResult, type PolicyEnforcerConfig, type PrepareMCPOAuthAuthorizationOptions, type ProbeXenoProviderOptions, type ProcessContainmentStatus, type ProcessTreeAdapter, type ProfileMCPServerConfig, ProfileManager, type ProjectConfig, type ProjectDomainProfile, type ProjectExecutionPhase, type ProjectExecutionProfile, type ProjectInfo, type ProjectMcpApprovalDecision, type ProjectSessionContext, type ProjectSessionContextEntry, type ProjectSessionSummary, type ProjectTokenUsageSummary, type PromotionRequestResult, type PromptContext, type PromptFn, type PromptHookDefinition, PromptHookRunner, type PromptMemoryContextInfo, type PromptSectionContext, type PromptSectionProvider, PromptSectionRegistry, type ProtectedStateCipher, type ProtectedStateEnvelopeCipher, type ProtectedStateEnvelopeCipherOptions, type ProtectedStateEnvelopeV1, type ProtectedStateStore, ProviderError, type ProviderErrorCategory, type ProviderErrorCode, type ProviderErrorOptions, type ProviderStatus, type ProviderStreamEvent, type ProviderTransportLimits, QueryLifecycle, type QueryLifecycleOptions, type QueryState, type QueryTransition, type QueryWatchdogReason, REQUIRED_CONTAINMENT_CONFORMANCE_CHECKS, type RecalledEpisode, type RecalledSkill, type RecentSessionEntry, type RecentSessionsIndex, type ReducedResult, type ReducerOptions, type RegisterToolOperationInput, type RegisteredTool, type RenderConfig, type RequestBudgetBreakdown, type ResolveXenoSdkApiKeyOptions, type ResolvedIdentity, type ResolvedMemory, type ResolvedProvider, type ResolvedSubagentWorkflowAnswer, type ResourceContentBlock, type RoomInfo, type RunContainmentConformanceOptions, type RunDelegatedXenoTurnOptions, type RunStreamOptions, type RuntimeManifestFileEntry, type RuntimeManifestInspectionResult, type RuntimePluginManifestEntry, SDK_DEFAULT_MAX_ITERATIONS, SDK_DEFAULT_MAX_TOKENS, SDK_VERSION, SESSION_FORMAT_VERSION, SHEETS_CAPABILITIES, SHEETS_TOOL_NAMES, SLIDES_CAPABILITIES, SLIDES_TOOL_NAMES, SOUND_CAPABILITIES, SOUND_SYSTEM_PROMPT, SOUND_TOOL_NAMES, SSETransport, SUBAGENT_ROLE_ALIASES, SUBAGENT_TEAM_PRESETS, type SandboxCheckResult, type ScoredMemory, ScreenCapture, type ScreenCaptureConfig, type ScreenCaptureOptions, type SearchConfig, type SearchProvider, type SecuredProcessSpec, type SecurityPathIssue, type SecurityPathIssueCode, type Session, type SessionCreateOptions, type SessionData, type SessionEndData, type SessionIntegrationConfig, SessionLock, SessionLock as SessionLockManager, SessionManager, type SessionMeta, type SessionRecoveryIssue, type SessionRecoveryResult, type SessionRecoverySource, SessionRegistry, type SessionResumeOptions, type SessionRuntimeBaseOptions, type SessionRuntimeState, type SessionStartData, type SessionStatus, type SessionSummary, type SetXenoArtifactCommentResolutionRequest, type SetupAIHandlersOptions, type ShapeConfig, type SheetsAgentOptions, type SheetsToolAdapter, type ShellExecutionAuthorization, type ShellExecutionAuthorizationRequest, type ShellPathReference, type ShutdownCleanup, type Skill, SkillStore, type SkillStoreOptions, type SlideInfo, type SlidesAgentOptions, type SlidesToolAdapter, type SortConfig, type SoulCompletion, SoulEngine, type SoulEngineOptions, type SoulMessage, type SoulSigner, type SoundAgentOptions, type SoundPromptParams, type SpeechRecognizer, type SpeechRecognizerCallbacks, type SpeechRecognizerConfig, type StartXenoLoopInput, StdioTransport, type StemSeparationResult, type StopReason, type StoredConversation, type StoredMessage, type StoredToolCall, type StreamResult, StreamableHTTPTransport, type StreamableHTTPTransportOptions, type StreamableHTTPTransportSnapshot, type SubagentBranchPolicy, type SubagentBriefContext, type SubagentExecuteFn, type SubagentExecutionRequest, type SubagentExecutionResponse, type SubagentRemoteMcpAccess, type SubagentResult, type SubagentRole, type SubagentTask, type SubagentTeamPreset, type SubagentTeamPresetDefinition, type SubagentWorkflowMode, type SubagentWorkflowOptions, type SubagentWorkflowResult, type SynthesizeSkillInput, type SystemPromptInspectionResult, THREE_D_CAPABILITIES, THREE_D_TOOL_NAMES, TOOL_OPERATION_SCHEMA_VERSION, type TaskCompletionCallback, TaskListManager, type TestResult, type TextBlock, type ThreeDAgentOptions, type ThreeDToolAdapter, type TimelineInfo, type TokenUsageTotals, type ToolAssistantContentBlock, type ToolAuthorizationReceipt, type ToolCallData, type ToolCompletionPolicy, type ToolContinuationCheckpoint, type ToolContinuationNotification, type ToolDefinition, type ToolEvidence, type ToolExchangeRepairResult, type ToolExecutionContext, type ToolExecutor, type ToolFailureCategory, type ToolFailureGuardTrip, ToolFailureLoopGuard, type ToolHistoryRepairDiagnostic, type ToolManifestEntry, type ToolMiddleware, type ToolMiddlewareContext, ToolMiddlewareRegistry, type ToolOperationEvent, ToolOperationManager, type ToolOperationRuntimeEventType, type ToolOperationSnapshot, type ToolOperationState, ToolOrchestrator, type ToolOrchestratorCallbacks, type ToolOrchestratorConfig, type ToolPolicyProjection, type ToolProgressUpdate, ToolRegistry, type ToolRegistryOptions, type ToolResult, type ToolResultBlock, type ToolResultContent, type ToolResultData, type ToolRiskLevel, type ToolRuntimeContext, type ToolSchemaProjectionChange, ToolSchemaProjectionError, type ToolSchemaProjectionResult, type ToolSchemaProviderDialect, type ToolUseBlock, type TraceGraph, type TraceGraphEdge, type TraceGraphNode, type TrackContext, type TranscriptEvent, type TranscriptEventData, type TranscriptEventType, TranscriptWriter, type TranscriptionResult, type TranscriptionSegment, type TransitionConfig, type TurnDiffSummary, TurnDiffTracker, type TurnDiffTrackerOptions, type TurnFileDiff, type TurnRestoreAvailability, type TurnRestoreFilePreview, TurnRestoreManager, type TurnRestorePoint, type TurnRestoreResult, UNBOUNDED_OPERATION_CONTINUATION_LIMIT, type UnifiedExecCompletionReason, UnifiedExecError, type UnifiedExecEvent, type UnifiedExecEventListener, type UnifiedExecEventType, type UnifiedExecInputSource, UnifiedExecManager, type UnifiedExecManagerOptions, type UnifiedExecMode, type UnifiedExecOrigin, type UnifiedExecOutput, type UnifiedExecOutputChunk, type UnifiedExecOutputDelta, type UnifiedExecPresentation, type UnifiedExecProcess, type UnifiedExecReadDeltaOptions, type UnifiedExecStartOptions, type UnifiedExecStatus, type UnifiedExecStream, type UpdateXenoGoalInput, UsageAccumulator, type UsageAttribution, type UsageEvent, UsageLedger, type UsageQuery, type UsageTotals, type ValidateXenoSdkApiKeyOptions, type ValidatedContainmentCertification, type ValidationSignal, type VectorDocument, VectorMemoryStore, type VectorSearchResult, type VectorStoreAdapter, type VectorStoreOptions, type VerifyContainmentApprovalExpected, type VerifyPluginSupplyChainOptions, type VerifyPluginSupplyChainResult, type VerifyXenoHostedWebhookOptions, type VerifyXenoShareOptions, type VideoToolAdapter, WEB_CONTEXT_CONTRACT_VERSION, WEB_CONTEXT_TOOL_RESULT_SCHEMA, WORKFLOW_CAPABILITIES, WORKFLOW_TOOL_NAMES, type WebContextClientPort, type WebContextEvidenceProjection, type WebContextRequestBase, type WebContextRequestFactory, type WebContextToolOptions, type WebContextToolResult, type WebContextWaitPortOptions, type WebSearchResult, type WindowsDpapiCredentialFile, type WindowsDpapiProtectedFileOptions, type WindowsDpapiProtectedStateOptions, type WorkflowAgentOptions, type WorkflowDefinition, type WorkflowEvent, type WorkflowExecutionResult, type WorkflowInfo, type WorkflowNodeConfig, type WorkflowNodeDefinition, type WorkflowNodeExecutor, type WorkflowNodeStatus, type WorkflowPlan, WorkflowPlanner, type WorkflowRunNodeRecord, type WorkflowRunRecord, type WorkflowRunStatus, WorkflowRuntime, WorkflowStore, type WorkflowToolAdapter, WorkspaceIndex, type WorkspaceScanOptions, XENO_AGENT_PROFILE_SCHEMA_VERSION, XENO_API_BASE, XENO_APP_PROTOCOL_V2_METHODS, XENO_APP_PROTOCOL_VERSIONS, XENO_ARTIFACT_ACTOR_KINDS, XENO_ARTIFACT_FILE_REPOSITORY_SCHEMA_VERSION, XENO_ARTIFACT_SCHEMA_VERSION, XENO_ARTIFACT_SENSITIVITIES, XENO_ARTIFACT_STATES, XENO_AUTOMATION_OPERATIONS, XENO_AUTOMATION_PROTOCOL_VERSION, XENO_BROWSER_CONTROL_PLANE_OPERATIONS, XENO_BUILTIN_ARTIFACT_KINDS, XENO_CAPABILITY_LEASE_SCHEMA_VERSION, XENO_CONTAINMENT_APPROVAL_SCHEMA, XENO_CONTAINMENT_CERTIFICATION_SCHEMA, XENO_CONTAINMENT_CONFORMANCE_SCHEMA, XENO_CONTAINMENT_REVIEWER_TRUST_STORE_SCHEMA, XENO_CONTROL_ROOM_SCHEMA_VERSION, XENO_COORDINATION_SCHEMA_VERSION, XENO_DEFLATE_CODEC_NAME, XENO_DEFLATE_CODEC_VERSION, XENO_EVIDENCE_EDGE_TYPES, XENO_EVIDENCE_GRAPH_SCHEMA_VERSION, XENO_EVIDENCE_NODE_TYPES, XENO_GIF_ANIMATION_POLICY, XENO_GIF_CODEC_NAME, XENO_GIF_CODEC_VERSION, XENO_HANDOFF_SCHEMA_VERSION, XENO_HOSTED_CONTROL_SCHEMA_VERSION, XENO_HOSTED_ENVIRONMENT_SCHEMA_VERSION, XENO_HOSTED_EVENT_SCHEMA_VERSION, XENO_HOSTED_EXECUTION_ADAPTER_CERTIFICATION_SCHEMA, XENO_HOSTED_EXECUTION_ADAPTER_MAX_CERTIFICATE_LIFETIME_MS, XENO_HOSTED_EXECUTION_ADAPTER_PROTOCOL_VERSION, XENO_HOSTED_EXECUTION_PROTOCOL_VERSION, XENO_HOSTED_EXECUTION_TOOL_NAMES, XENO_HOSTED_RESULT_SCHEMA_VERSION, XENO_HOSTED_RUN_SCHEMA_VERSION, XENO_HOSTED_TRIGGER_SCHEMA_VERSION, XENO_JPEG_CODEC_NAME, XENO_JPEG_CODEC_VERSION, XENO_MXC_ADAPTER_NAME, XENO_MXC_POLICY_VERSION, XENO_MXC_VERSION, XENO_ORACLE_REPORT_SCHEMA_VERSION, XENO_PLUGIN_LOCK_FILENAME, XENO_PLUGIN_LOCK_SCHEMA_VERSION, XENO_PLUGIN_SIGNATURE_FILENAME, XENO_PLUGIN_SIGNATURE_SCHEMA_VERSION, XENO_PROVIDER_CATALOG_SCHEMA_VERSION, XENO_PROVIDER_CONNECTION_STORE_SCHEMA_VERSION, XENO_RASTER_CODEC_NAME, XENO_RASTER_CODEC_VERSION, XENO_RASTER_PREVIEW_FORMATS, XENO_RECIPE_SCHEMA_VERSION, XENO_REPOSITORY_INDEX_SCHEMA_VERSION, XENO_REVIEW_DIMENSIONS, XENO_REVIEW_EVIDENCE_KINDS, XENO_REVIEW_REPORT_SCHEMA_VERSION, XENO_RT_DEFAULT_URL, XENO_SECURE_EXECUTION_CONTRACT_SCHEMA_VERSION, XENO_SHARE_REGISTRY_SCHEMA_VERSION, XENO_SHARE_SCHEMA_VERSION, XENO_SKILL_SCHEMA_VERSION, XENO_SOURCE_RESEARCH_SCHEMA_VERSION, XENO_SPEC_EXECUTION_SCHEMA_VERSION, XENO_SPEC_SCHEMA_VERSION, XENO_SVG_RENDERER_NAME, XENO_SVG_RENDERER_VERSION, XENO_TELEMETRY_SCHEMA_VERSION, XENO_VP8_CODEC_NAME, XENO_VP8_CODEC_VERSION, XENO_WEBP_ANIMATION_POLICY, XENO_WEBP_CODEC_NAME, XENO_WEBP_CODEC_VERSION, type XenoAnsiEscapeFamily, type XenoAnsiFormatter, type XenoAnsiPolicy, type XenoAnsiStyle, type XenoAnsiToken, type XenoAnsiWrapOptions, type XenoAppProtocolVersion, XenoAppServer, type XenoAppServerOptions, XenoAppServerV2Client, type XenoArtifactActor, type XenoArtifactActorKind, type XenoArtifactAnchor, type XenoArtifactAppendReviewRequest, type XenoArtifactContent, type XenoArtifactEnvelope, type XenoArtifactFileRecoveryNotice, type XenoArtifactFileSnapshot, type XenoArtifactIdentity, type XenoArtifactKind, type XenoArtifactLifecycleEvent, type XenoArtifactListQuery, type XenoArtifactMutationOptions, type XenoArtifactPersistedRecord, type XenoArtifactProvenance, type XenoArtifactRecord, type XenoArtifactRelationship, type XenoArtifactRepository, XenoArtifactRepositoryError, type XenoArtifactRepositoryErrorCode, type XenoArtifactRepositoryState, type XenoArtifactRetention, type XenoArtifactReviewAnchorInput, type XenoArtifactReviewDecision, type XenoArtifactReviewEvent, type XenoArtifactReviewEventInput, XenoArtifactReviewService, type XenoArtifactReviewServiceOptions, type XenoArtifactReviewSummary, type XenoArtifactRevisionOptions, type XenoArtifactSensitivity, type XenoArtifactState, XenoArtifactStateTransitionError, type XenoArtifactStorageReference, type XenoArtifactTransitionRequest, XenoArtifactValidationError, type XenoArtifactValidationIssue, XenoAuthError, type XenoAuthErrorCode, type XenoAutomationAdapter, type XenoAutomationAdapterExecutionResult, type XenoAutomationAdapterManifest, type XenoAutomationConformanceCheck, type XenoAutomationConformanceReport, type XenoAutomationEffect, XenoAutomationError, type XenoAutomationErrorCode, type XenoAutomationEvidenceContent, type XenoAutomationEvidenceInput, type XenoAutomationEvidencePhase, type XenoAutomationEvidencePolicy, type XenoAutomationExecutionGrant, type XenoAutomationExecutionResult, type XenoAutomationIdentity, type XenoAutomationLeaseAuthority, type XenoAutomationOperation, type XenoAutomationOperationDescriptor, type XenoAutomationPreflight, type XenoAutomationRequest, type XenoAutomationSurface, type XenoAutomationTarget, type XenoBasicRasterImage, type XenoBrowserAutomationOperation, XenoBrowserControlPlaneAdapter, type XenoBrowserControlPlaneAdapterOptions, type XenoBrowserExecutionPolicy, type XenoCapabilityEffect, type XenoCapabilityEligibility, type XenoCapabilityKind, type XenoCapabilityLease, type XenoCapabilityLeaseApprovalContext, type XenoCapabilityLeaseApprovalRequest, type XenoCapabilityLeaseDenialRequest, XenoCapabilityLeaseError, type XenoCapabilityLeaseErrorCode, type XenoCapabilityLeaseRequest, type XenoCapabilityLeaseRevocationRequest, type XenoCapabilityLeaseState, type XenoCapabilityScope, type XenoCapabilitySubject, type XenoCapabilityUse, type XenoColorDepth, type XenoColorPolicy, type XenoCompiledRecipe, type XenoCompiledRecipeStep, type XenoComputerAutomationOperation, type XenoComputerExecutionPolicy, type XenoConfig, type XenoContainmentApprovalReport, type XenoContainmentCertificationApproval, type XenoContainmentCertificationManifest, type XenoContainmentConformanceReport, type XenoContainmentReviewerTrustStore, type XenoContentHash, type XenoControlRoomActionKind, type XenoControlRoomActionPlan, type XenoControlRoomActionRequest, type XenoControlRoomAgent, type XenoControlRoomAgentInput, type XenoControlRoomAgentStatus, type XenoControlRoomApprovalInput, type XenoControlRoomApprovalKind, type XenoControlRoomArtifactInput, type XenoControlRoomAttentionItem, type XenoControlRoomAttentionKind, type XenoControlRoomGoalInput, type XenoControlRoomInput, type XenoControlRoomMonitorInput, type XenoControlRoomNotificationInput, type XenoControlRoomProjectionOptions, type XenoControlRoomSnapshot, type XenoControlRoomStatusCategory, type XenoControlRoomSummary, type XenoControlRoomTask, type XenoControlRoomTaskInput, type XenoControlRoomUsage, XenoControlRoomValidationError, type XenoCoordinationAction, XenoCoordinationError, type XenoCoordinationEvent, type XenoCoordinationEventType, type XenoCoordinationSessionState, type XenoCoordinationStoreOptions, type XenoCreatedShare, type XenoCredentialSource, type XenoCredentialType, type XenoDesktopCaptureSource, type XenoDesktopCapturer, type XenoDiffArtifactContext, type XenoDiffDocument, type XenoDiffFile, type XenoDiffFileStatus, type XenoDiffHunk, type XenoDiffLine, type XenoDiffLineKind, type XenoDiffMode, XenoDiffParseError, type XenoEd25519Signature, type XenoEnvironmentExecutionPolicy, type XenoEvidenceEdge, type XenoEvidenceEdgeType, type XenoEvidenceGraph, XenoEvidenceGraphBuilder, type XenoEvidenceGraphBuilderOptions, XenoEvidenceGraphValidationError, type XenoEvidenceNode, type XenoEvidenceNodeType, type XenoEvidenceReference, type XenoExecutionAdapterIdentity, type XenoExecutionEnforcement, type XenoExecutionIdentity, XenoExecutionLeaseSession, type XenoExecutionLeaseSessionOptions, type XenoExecutionOwner, type XenoExternalActionExecutionPolicy, type XenoFilesystemExecutionPolicy, type XenoGifAnimation, type XenoGifDisposal, type XenoGifFrame, type XenoGitHubReviewComment, type XenoGoalCriterion, type XenoGoalCriterionResult, type XenoGoalMilestone, type XenoGoalProgress, type XenoGoalRecord, type XenoGoalStatus, type XenoGoalTask, type XenoGoalTaskStatus, type XenoGoalVerification, XenoGovernedAutomationExecutor, type XenoGovernedAutomationExecutorOptions, type XenoGovernedAutomationToolExecution, type XenoGovernedAutomationToolRuntime, type XenoHandoffAuthority, type XenoHandoffOperation, type XenoHandoffPayload, type XenoHandoffRecord, type XenoHandoffResumePoint, type XenoHandoffStatus, type XenoHandoffTarget, type XenoHostAutomationAuditEvent, type XenoHostAutomationAuditLoggerPort, type XenoHostAutomationEnvironment, type XenoHostAutomationStatusReport, type XenoHostAutomationSurfaceStatus, CliGovernedAutomationRuntime as XenoHostGovernedAutomationRuntime, type XenoHostedArchitecture, type XenoHostedAuthority, type XenoHostedBudget, type XenoHostedCacheMount, type XenoHostedControlAcknowledgement, type XenoHostedControlAction, type XenoHostedControlCommand, type XenoHostedControlCommandPayload, type XenoHostedEnvironmentManifest, type XenoHostedEnvironmentManifestPayload, type XenoHostedEventRecord, type XenoHostedExecutionAdapterCertification, type XenoHostedExecutionAdapterVerificationOptions, type XenoHostedExecutionBoundaryReceipt, type XenoHostedExecutionJob, type XenoHostedExecutionSecretValue, type XenoHostedImageReference, type XenoHostedNetworkDestination, type XenoHostedNetworkPolicy, type XenoHostedOs, type XenoHostedQuotaLease, type XenoHostedReplayCursor, type XenoHostedReplayPage, type XenoHostedRepositorySource, type XenoHostedResourceLimits, type XenoHostedRetentionPolicy, type XenoHostedRunRecord, type XenoHostedRunRequest, type XenoHostedRunResult, type XenoHostedRunResultPayload, type XenoHostedRunStatus, type XenoHostedSecretProjection, type XenoHostedSetupStep, type XenoHostedTriggerDefinition, type XenoHostedTriggerDelivery, type XenoHostedTriggerKind, type XenoHostedWebhookSource, type XenoHostedWebhookVerification, type XenoJsonObject, type XenoJsonPrimitive, type XenoJsonValue, type XenoJwtPayload, type XenoLegacyAgentArtifactContext, type XenoLegacyArtifactContext, type XenoLoadedSkill, type XenoLoopIteration, type XenoLoopKind, type XenoLoopRecord, type XenoLoopSchedule, type XenoLoopStatus, XenoLoopbackAutomationAdapter, type XenoLoopbackAutomationAdapterOptions, XenoMultiAgentReviewCoordinator, type XenoMultiAgentReviewCoordinatorOptions, type XenoNetworkDestination, type XenoNetworkExecutionPolicy, type XenoOracleAdjudication, type XenoOracleAdjudicationDraft, type XenoOracleAdjudicationRequest, type XenoOracleAdjudicationResult, type XenoOracleArtifactContext, type XenoOracleCitation, type XenoOracleClaim, XenoOracleCoordinator, type XenoOracleCoordinatorOptions, type XenoOracleDisagreement, type XenoOracleExecutionRequest, type XenoOracleExecutionResult, type XenoOracleModelIdentity, type XenoOracleOpinion, type XenoOracleOpinionDraft, type XenoOracleReport, type XenoOracleRole, type XenoOracleRunOptions, XenoOracleValidationError, type XenoOracleVerdict, type XenoProcessExecutionPolicy, type XenoProjectState, type XenoProviderAdapterKind, type XenoProviderAuthPreset, type XenoProviderCapabilities, XenoProviderCatalog, type XenoProviderConnection, type XenoProviderConnectionSnapshot, type XenoProviderConnectionView, type XenoProviderCredentialMode, type XenoProviderModelDescriptor, type XenoProviderPreset, type XenoProviderProbeResult, type XenoProviderReadiness, type XenoProviderRouteCandidate, type XenoProviderRoutingPolicy, type XenoPtyAdapter, type XenoPtyProcess, type XenoPtySpawnOptions, type XenoRasterImage, type XenoRasterPreview, type XenoRecipeDefinition, type XenoRecipeInputDefinition, type XenoRecipeMode, type XenoRecipePermissionMode, type XenoRecipeStepDefinition, XenoRecipeValidationError, type XenoRedactionCategory, type XenoRedactionEvent, type XenoRedactionOptions, type XenoRedactionReport, type XenoRedactionResult, type XenoRemoteRepositoryIdentity, type XenoRemoteSourceFile, type XenoRemoteSourceProvider, type XenoRepositoryChunk, type XenoRepositoryDocumentKind, type XenoRepositoryEmbedding, type XenoRepositoryEmbeddingProvider, type XenoRepositoryEmbeddingRequest, type XenoRepositoryFileRecord, type XenoRepositoryFreshnessInput, type XenoRepositoryFreshnessReport, type XenoRepositoryGitProvenance, type XenoRepositoryIndexBuildOptions, XenoRepositoryIndexFileStore, type XenoRepositoryIndexSnapshot, type XenoRepositoryIndexStats, type XenoRepositoryRelationship, type XenoRepositoryRelationshipKind, type XenoRepositorySearchMode, type XenoRepositorySearchQuery, type XenoRepositorySearchResponse, type XenoRepositorySearchResult, type XenoRepositorySourceDocument, type XenoRepositorySymbol, type XenoRepositorySymbolGraph, type XenoRepositorySymbolKind, type XenoResolvedApiKey, type XenoReviewAgentExecutor, type XenoReviewAgentResult, type XenoReviewArtifactContext, type XenoReviewCoordinatorContext, type XenoReviewDimension, type XenoReviewEvidence, type XenoReviewEvidenceKind, type XenoReviewFinding, type XenoReviewFindingProposal, type XenoReviewFindingState, type XenoReviewPack, type XenoReviewReport, type XenoReviewSeverity, type XenoReviewTarget, XenoReviewValidationError, type XenoReviewVerificationOutcome, type XenoReviewVerificationResult, type XenoReviewVerifierExecutor, type XenoRuntimeEvent, type XenoRuntimeEventBase, XenoRuntimeEventBus, type XenoRuntimeEventDraft, type XenoRuntimeEventSink, type XenoRuntimeEventType, type XenoSecretProjection, type XenoSecureExecutionContract, XenoSecureExecutionContractError, type XenoSecureExecutionContractErrorCode, type XenoShareAccessPolicy, type XenoShareContent, type XenoShareGitContext, type XenoShareIssuer, type XenoSharePayload, type XenoSharePrincipal, type XenoShareReference, type XenoShareRegistryRecord, type XenoShareRegistrySnapshot, type XenoShareSessionIdentity, type XenoShareSigningIdentity, type XenoShareStatus, type XenoShareSurface, type XenoShareVerificationResult, type XenoShareVisibility, type XenoSignedHandoffEnvelope, type XenoSignedShareEnvelope, type XenoSkillActivation, type XenoSkillAuditEvent, type XenoSkillCatalog, type XenoSkillDescriptor, type XenoSkillDiagnostic, type XenoSkillDiscoveryOptions, type XenoSkillDiscoveryRoot, type XenoSkillExternalActionPolicy, type XenoSkillInvocationDecision, type XenoSkillInvocationPolicy, type XenoSkillResourceDescriptor, type XenoSkillShadowRecord, type XenoSkillSource, type XenoSkillTool, type XenoSkillToolPolicy, type XenoSourceResearchArtifactContext, type XenoSourceResearchExcerpt, type XenoSourceResearchFinding, type XenoSourceResearchModelIdentity, type XenoSourceResearchReport, type XenoSourceResearchSeverity, XenoSourceResearchValidationError, type XenoSpecAcceptanceCriterion, type XenoSpecArtifactBundle, type XenoSpecArtifactContext, type XenoSpecDesign, type XenoSpecDesignDecision, type XenoSpecDocument, type XenoSpecDriftFinding, type XenoSpecDriftReport, type XenoSpecExecutionRecord, type XenoSpecExecutionState, XenoSpecLifecycleService, type XenoSpecLifecycleServiceOptions, type XenoSpecPriority, type XenoSpecRequirement, type XenoSpecRisk, type XenoSpecSourceBaseline, type XenoSpecTask, type XenoSpecTaskExecution, type XenoSpecTaskStatus, XenoSpecValidationError, type XenoTelemetryAttributeValue, type XenoTelemetryRecord, type XenoTelemetrySignalKind, type XenoTelemetrySubscriber, type XenoThreadRunOptions, type XenoThreadRunResult, XenoTraceGraphRecorder, type XenoUserConfig, type XenoVerifiedHostedExecutionAdapterCertification, type XenoVp8Image, acquireControlPlaneLock, activateSessionRuntime, addProjectAllowedDirectory, addProjectAllowedTool, agentDefinitionFromProfile, agentProfileFromDefinition, appendBoundedShellOutput, appendGuidanceToResult, approveMcpServer, areSignalHandlersInstalled, artifactCompareTool, askUserTool, assertDirectEndpointResolution, assertRequiredXenoAutomationEvidence, assertSupportedMcpProtocolVersion, assertUsableXenoApiKey, assertValidMcpAppResource, assertValidXenoArtifact, assertValidXenoAutomationAdapterManifest, assertValidXenoAutomationRequest, assertValidXenoEvidenceGraph, assertValidXenoHostedExecutionJob, assertValidXenoOracleReport, assertValidXenoRecipeDefinition, assertValidXenoReviewPack, assertValidXenoReviewReport, assertValidXenoReviewTarget, assertValidXenoSecureExecutionContract, assertValidXenoSourceResearchReport, assertValidXenoSpecDocument, assertValidXenoSpecExecution, assertXenoArtifactStateTransition, assertXenoAutomationAdapterConformant, assertXenoAutomationAuthority, auditRiskLevelForTool, authorizeShellExecution, backgroundProcessManager, bashTool, benchmarkCodingTools, bridgeXenoTelemetryToOpenTelemetry, buildAtomicMessageGroups, buildAuditReplayReport, buildAuditTraceReport, buildContainedProcessSpec, buildContractLedgerGuidance, buildDefaultSubagentTasks, buildDelegatedRoleSystemPrompt, buildHookEnvironment, buildLinuxBubblewrapProcessSpec, buildLspDefinitionReport, buildLspDiagnosticsReport, buildLspDoctorReport, buildLspHoverReport, buildLspReferencesReport, buildMotionSystemPrompt, buildPixelSystemPrompt, buildProcessHardenedProcessSpec, buildProjectBudgetFinalizationGuidance, buildProjectExecutionGuidance, buildProjectExecutionProfile, buildPromptMemoryContext, buildSecuredProcessSpec, buildSoundSystemPrompt, buildSystemPrompt, buildToolFailureGuardResult, buildXenoArtifactReviewAnchor, buildXenoAutomationCapabilityUse, buildXenoRepositoryIndex, buildXenoRepositoryIndexWithEmbeddings, buildXenoSecureExecutionContract, cachedModelContextWindow, calculateCost, canTransitionXenoArtifactState, canXenoRasterPreview, canonicalPayload, canonicalizeArtifactJson, canonicalizeMcpResourceUri, canonicalizeSecurityPath, canonicalizeToolName, checkSandbox, classifyProviderHttpError, cleanupReadImagePreviews, cleanupSessionRuntime, clearMcpServerApproval, clearProjectAllowedTools, clearProjectLastSessionSummary, clearProjectMcpApproval, clearProjectMcpApprovals, clipXenoAnsi, coerceSubagentRole, coerceSubagentTeamPreset, compileAgentProfile, compileJsonSchema, compileToolInputSchema, compileXenoRecipe, compileXenoSkillActivation, configureImageGeneration, configureSearch, configureSearchPermissionProfile, configureXenoAnsi, containmentApprovalSigningPayload, containmentCertificationSigningPayload, copyTextToClipboard, create3DTools, createAgentDefinitionFile, createAgentDefinitionPromptSection, createAgentRunId, createAppServerV2HttpTransport, createArchitectTools, createArtifactCompareTool, createAskUserTool, createAudioTools, createAuditBackedPermissionEngine, createBashTool, createBenchBashMiddleware, createCliAutomationAuditSink, createCliGovernedAutomationRuntime, createCommandBackedProtectedStateStore, createDefaultToolRegistry, createDelegatedXenoAgent, createDirectProvider, createDirectShellMessage, createDispatchAgentTool, createDocsTools, createEd25519Signer, createEditTool, createElfAnalyzeTool, createEngineTools, createGcodeAnalyzeTool, createGenerateImageTool, createGlobTool, createGovernanceExtensions, createGrepTool, createHtmlSanitizerAuditTool, createImageTools, createLsTool, createLspDefinitionTool, createLspDiagnosticsTool, createLspHoverTool, createLspReferencesTool, createMcpAppCapabilities, createMcpAppExtensionCapabilities, createMcpPkcePair, createMcpPromptRegisteredTool, createMcpRegisteredTool, createMcpResourceRegisteredTool, createMemoryProtectedStateStore, createMemoryReadTool, createMemoryWriteTool, createNotebookEditTool, createNotebookReadTool, createNotesTools, createOsProtectedStateStore, createProtectedStateEnvelopeCipher, createReadImageTool, createReadTool, createSheetsTools, createSlidesTools, createSpeechRecognizer, createSqliteAnalyzeTool, createTaskInputTool, createTaskListTools, createTaskOutputTool, createTaskStopTool, createThinkTool, createToolAlias, createToolRuntimeContext, createUnavailableProtectedStateStore, createVideoTools, createWebContextFetchTool, createWebContextRequestFactory, createWebContextSearchTool, createWebSearchTool, createWindowsDpapiProtectedCipher, createWindowsDpapiProtectedFileStore, createWorkflowTools, createWriteTool, createXenoAgent, createXenoAutomationConformanceReport, createXenoGovernedAutomationTools, createCliAutomationAuditSink as createXenoHostAutomationAuditSink, createCliGovernedAutomationRuntime as createXenoHostGovernedAutomationRuntime, createXenoHostedControlCommand, createXenoHostedEnvironmentManifest, createXenoHostedEvent, createXenoHostedExecutionBoundaryReceipt, createXenoHostedRunResult, createXenoRasterPreview, createXenoSecureShare, createXenoSessionHandoff, createXenoShareSigningIdentity, createXenoSkillTool, createXenoSourceResearchExcerpt, createXenoSourceResearchReport, currentExecutionAdapterStatus, decodeJwtPayload, decodeXenoBmp, decodeXenoGif, decodeXenoGifAnimation, decodeXenoJpeg, decodeXenoNetpbm, decodeXenoPng, decodeXenoSvg, decodeXenoVp8, decodeXenoWebp, defaultToolRuntimeContext, defaultXenoReviewPack, deflateXenoZlib, deleteSession, denyMcpServer, deriveHostedIdempotencyKey, describeXenoAutomationOperation, detectLanguage, detectPluginRepositorySignals, detectRepositoryDocumentKind, detectRepositoryLanguage, detectXenoSpecDrift, deterministicReduce, digestMessages, directProviderConfigFromConnection, discoverXenoSkills, dispatchAgentTool, editTool, elfAnalyzeTool, emitXenoTelemetry, encodeXenoPngRgb, enforceShellCommandPolicy, enforceToolPolicy, ensureConfigDir, ensureDurableMessageIds, ensureProjectStateDir, estimateFullRequestBudget, evaluateContainmentUiRestrictions, evaluatePermissionProfileNetworkUrl, evaluateXenoCapabilityEligibility, executeXenoCoordinationAction, extractJsonObject, extractToolPath, findXenoSkill, fingerprintXenoSecureExecutionContract, forgetRecentSession, forgetRecentSessionById, formatBoundedShellOutput, formatCost, formatDirectShellContext, formatJsonSchemaErrors, formatModelList, formatPromptContextBreakdown, gcodeAnalyzeTool, generateImageTool, generateSessionId, getAgentHome, getAgentRunDir, getAgentRunStoreDir, getAvailableModels, getBenchmarkComputeBudgetHintForCommand, getBenchmarkForegroundTimeoutForCommand, getBestExecutionSecurityStatus, getChatModels, getConfigDir, getDefaultProviderRegistry, getExecutionSecurityCapabilityReport, getExecutionSecurityStatus, getGlobIgnores, getGrepIgnores, getHighRiskPermissions, getImageGenerationConfig, getJwtExpiry, getLinuxBubblewrapCapability, getLogLevel, getManagedConfigPath, getMcpAppMetadata, getMcpAppResourceUri, getMcpApprovalDecision, getMcpAuthorizationServerMetadataUrls, getMcpPromptToolName, getMcpProtectedResourceMetadataUrls, getMcpResourceToolName, getMcpToolName, getModelName, getMxcContainmentProbe, getMxcNativeAssetDescriptor, getMxcWindowsHostPreparationDescriptor, getMxcWindowsHostPreparationHelperArchitecture, getPermissionProfile, getPersistentShellSession, getPersistentShellSpawnSpec, getProcessContainmentStatus, getProjectAgentDefinitionDirs, getProjectAgentDefinitionsDir, getProjectLastSessionSummary, getProjectMcpApproval, getProjectStatePath, getReadImagePreviewCapability, getRecentSessionsIndexPath, getSubagentTeamPresetDefinition, getToolRiskLevel, getUserAgentDefinitionsDir, gitBranchTool, gitCommitTool, gitDiffTool, gitLogTool, gitStatusTool, globTool, grepTool, gzipXeno, hasProjectOnboardingCompleted, hasXenoTelemetrySubscribers, hashContainmentConformanceReport, hashPluginManifest, hashPluginTree, hookResultStatus, hostedEnvironmentIdentity, htmlSanitizerAuditTool, importLegacyXenoSkill, inflateXenoZlib, initializeSessionRuntime, inspectCliAutomationStatus, inspectRuntimeManifests, inspectSecurityPath, inspectSystemPrompt, inspectCliAutomationStatus as inspectXenoHostAutomationStatus, inspectXenoRepositoryFreshness, inspectXenoRepositorySymbol, installSignalHandlers, invalidateAllObservedFiles, invokeXenoSkill, isChatModel, isDangerousCommand, isDirectShellMessage, isExpiredJwt, isExplicitResearchPrompt, isJwt, isLocalModel, isMcpAppResourceUri, isMcpOAuthTokenExpired, isMcpToolVisibleToApp, isMcpToolVisibleToModel, isNotBeforeJwt, isPathWithinAllowed, isScreenCaptureAvailable, isSensitiveEnvironmentKey, isSimpleInformationalPrompt, isSpeechRecognitionAvailable, isSupportedMcpProtocolVersion, isToolAllowedByXenoSkillActivation, isUncOrDevicePath, isValidAgentDefinitionName, isValidModel, isValidSessionId, isWorkspaceTrusted, isXenoAutomationOperation, legacyAgentArtifactToXenoArtifact, listBuiltInAgentProfiles, listPermissionProfiles, listProjectAllowedTools, listProjectMcpApprovals, listSessions, loadConfig, loadConfiguredMcpServers, loadMcpConfigFile, loadProjectConfig, loadProjectState, loadRecentSessionsIndex, loadSession, loadUserConfig, loadXenoSkill, lookupRecentSession, lsTool, lspDefinitionTool, lspDiagnosticsTool, lspHoverTool, lspReferencesTool, matchPermissionRule, matchesMcpRegistryEntryPolicy, materializeXenoAutomationEvidence, memoryReadTool, memoryWriteTool, mergeConfigs, mxcWarningsRequireWindowsHostPreparation, normalizeDirectShellResultRecord, normalizeHookDecision, normalizeMcpAppVisibility, normalizePermissionProfileName, normalizeRepositoryRelativePath, normalizeSourceText, normalizeSubagentBranchPolicy, normalizeWorkingDirectory, normalizeXenoHostedControlAcknowledgement, notebookEditTool, notebookReadTool, parseContainmentReviewerTrustStore, parseMcpWwwAuthenticate, parsePermissionRule, parseRetryAfter, parseSessionId, parseShellPathReferences, parseSubagentRemoteMcpPolicy, parseSubagentRoleList, parseUnifiedDiff, parseXenoAnsi, parseXenoRecipeDefinition, persistXenoAutomationEvidence, planXenoControlRoomAction, pluginInfoRelevanceCandidate, pluginListingRelevanceCandidate, pluginSignaturePayload, preflightLocalModel, prepareMxcWindowsHost, probeXenoProvider, projectToolDefinitionsForProvider, projectToolSchemaForProvider, projectXenoControlRoom, providerCapabilityError, providerProtocolError, publicKeyFingerprint, publishPlugin, rankPluginRelevance, readCliAutomationEnvironment, readImageTool, readManifestFromDisk, readPluginDetachedSignature, readPluginSupplyChainLockfile, readSessionFormatVersion, readTool, readXenoApiKey, readCliAutomationEnvironment as readXenoHostAutomationEnvironment, recordRecentSession, recordXenoCounter, recordXenoEvent, recordXenoHistogram, recoverSessionMessages, redactXenoShareValue, registerShutdownCleanup, registry, removeMcpServerConfig, removeProjectAllowedTool, renderAgentDefinition, renderAgentDefinitions, renderAuditReplayMarkdown, renderAuditReplayReport, renderAuditTraceMarkdown, renderAuditTraceReport, renderAuditTraceSummaries, renderCliAutomationStatus, renderCodingBenchmarkMarkdown, renderCodingBenchmarkReport, renderContinuationIncompleteStatus, renderLspDefinitionReport, renderLspDiagnosticsReport, renderLspDoctorReport, renderLspHoverReport, renderLspReferencesReport, renderToolContinuationInput, renderCliAutomationStatus as renderXenoHostAutomationStatus, renderXenoSkillCatalog, repairInterruptedToolCalls, repairToolExchangeHistory, requestBackground, requiresSecuredProcessLaunch, resetAllPersistentShellSessions, resetBashBenchmarkGuards, resetImageGenerationConfig, resetMcpServerApprovals, resetMxcContainmentProbe, resetPersistentShellSession, resetXenoAnsiPolicy, resetXenoTelemetryCardinalityForTests, resizeXenoRaster, resolveAgentDefinition, resolveAgentProfile, resolveAgentToolPolicy, resolveBuiltInAgentProfile, resolveCommandOnPath, resolveContainmentConformanceTemporaryRoot, resolveDelegatedExecutionMode, resolveExecutionSecurityLevel, resolveExecutionTrustMode, resolveInteractiveTurnMaxIterations, resolveModelContextTokens, resolvePermissionProfile, resolveShellInvocation, resolveSubagentRemoteMcpAccess, resolveSubagentWorkflowAnswer, resolveXenoAutomationEvidencePolicy, resolveXenoSdkApiKey, runAgentHook, runCommandHook, runContainmentConformanceSuite, runDelegatedXenoTurn, runDelegationPlan, runHookDefinition, runHooks, runHttpHook, runPromptHook, runSubagentWorkflow, runXenoThread, runXenoThreadStreamed, sanitizeEnvironment, sanitizeXenoTelemetryAttributes, saveConfig, saveMcpConfigFile, saveProjectState, saveSession, scaffoldPlugin, scanAgentDefinitions, scoreMemories, scorePluginRelevance, searchXenoRepositoryIndex, selectXenoProviderRoute, serializeXenoRecipe, setLogLevel, setProjectLastSessionSummary, setProjectMcpApproval, setProjectOnboardingCompleted, setWorkspaceTrusted, setupAIHandlers, sha256ArtifactBytes, sha256ArtifactJson, shouldEnableExecutionGovernance, shouldSourceShellProfile, shouldUseIsolatedStdinForCommand, signSharePayload, sqliteAnalyzeTool, stripXenoAnsi, subscribeXenoTelemetry, summarizeAuditInputRecord, summarizeAuditTraces, summarizeRuntimeInput, summarizeSubagentResults, summarizeXenoArtifactReview, syncMcpToolsToRegistry, synthesizeSkill, taskInputTool, taskOutputTool, taskStopTool, testPlugin, thinkTool, toAgentDefinitionMetadata, toLLMProvider, toolEvidenceToXenoArtifact, toolOperationManager, toolRiskLevel, turnDiffSummaryToXenoArtifact, unifiedDiffToXenoArtifact, unifiedExecManager, updateProjectState, upsertMcpServerConfig, validateAgentDefinition, validateCapabilityLeaseRequest, validateDelegationPlan, validateDirectEndpoint, validateExecutionSecurityPolicy, validateJsonSchema, validateManifest, validateMcpAppResource, validateXenoArtifact, validateXenoArtifactReviewEvent, validateXenoControlRoomSnapshot, validateXenoEvidenceGraph, validateXenoRepositoryIndex, validateXenoSdkApiKey, validateXenoSecureExecutionContract, validateXenoSpecDocument, verifyContainmentCertification, verifyContainmentCertificationApproval, verifyPluginSupplyChain, verifySignature, verifySoulRecord, verifyXenoHostedControlCommand, verifyXenoHostedEnvironmentManifest, verifyXenoHostedEventChain, verifyXenoHostedExecutionAdapterCertification, verifyXenoHostedExecutionJob, verifyXenoHostedRunResult, verifyXenoHostedWebhook, verifyXenoSecureShare, verifyXenoSessionHandoff, webFetchTool, webSearchTool, windowsDpapiProtect, windowsDpapiUnprotect, withXenoTelemetrySpan, wrapXenoAnsi, writePluginSupplyChainLockfile, writeTool, xenoAnsi, xenoAnsiVisibleWidth, xenoArtifactToDiffDocument, xenoArtifactToLegacyAgentArtifact, xenoArtifactToOracleReport, xenoArtifactToReviewReport, xenoArtifactToSourceResearchReport, xenoArtifactToSpecDocument, xenoArtifactToSpecExecution, xenoArtifactToToolEvidence, xenoArtifactToTurnDiffSummary, xenoHostedExecutionAdapterSigningPayload, xenoOracleReportToArtifact, xenoRecipeFingerprint, xenoReviewReportToArtifact, xenoReviewReportToGitHubComments, xenoSourceResearchReportToArtifact, xenoSpecArtifactIds, xenoSpecExecutionToArtifact, xenoSpecToArtifactBundle };