@xenosystem/agent-sdk 0.9.22 → 0.9.24

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 (42) 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 +339 -1
  6. package/dist/automation/index.d.ts +339 -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 +59 -59
  23. package/dist/electron/index.d.cts +6 -1
  24. package/dist/electron/index.d.ts +6 -1
  25. package/dist/electron/index.js +60 -60
  26. package/dist/electron/metafile-cjs.json +1 -1
  27. package/dist/electron/metafile-esm.json +1 -1
  28. package/dist/hosted/metafile-cjs.json +1 -1
  29. package/dist/hosted/metafile-esm.json +1 -1
  30. package/dist/index.cjs +356 -354
  31. package/dist/index.d.cts +1897 -1350
  32. package/dist/index.d.ts +1897 -1350
  33. package/dist/index.js +355 -353
  34. package/dist/metafile-cjs.json +1 -1
  35. package/dist/metafile-esm.json +1 -1
  36. package/dist/session/index.cjs +24 -24
  37. package/dist/session/index.d.cts +7 -1
  38. package/dist/session/index.d.ts +7 -1
  39. package/dist/session/index.js +24 -24
  40. package/dist/session/metafile-cjs.json +1 -1
  41. package/dist/session/metafile-esm.json +1 -1
  42. package/package.json +6 -1
package/dist/index.d.cts CHANGED
@@ -659,6 +659,7 @@ interface ContextCompressedData {
659
659
  messagesRemoved: number;
660
660
  tokensSaved: number;
661
661
  compaction?: CompactionRecord;
662
+ activeContextMessages?: Message[];
662
663
  }
663
664
  interface SessionEndData {
664
665
  reason: "user_exit" | "error" | "completed";
@@ -771,7 +772,7 @@ interface PolicyEnforcerConfig {
771
772
  };
772
773
  }
773
774
  type AgentSandbox = PolicyEnforcerConfig;
774
- declare const SDK_VERSION = "0.9.22";
775
+ declare const SDK_VERSION = "0.9.24";
775
776
  type AuditRiskLevel = "none" | "low" | "medium" | "high" | "critical";
776
777
  type AuditDecision = "allow" | "ask" | "deny";
777
778
  type AuditStatus = "ok" | "error";
@@ -2205,1498 +2206,1645 @@ declare class XenoLoopbackAutomationAdapter implements XenoAutomationAdapter {
2205
2206
  stop(operationId: string, reason: string): Promise<void>;
2206
2207
  private request;
2207
2208
  }
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;
2209
+ declare const XENO_BROWSER_CONTROL_PLANE_OPERATIONS: readonly [
2210
+ "browser.navigate",
2211
+ "browser.back",
2212
+ "browser.forward",
2213
+ "browser.reload",
2214
+ "browser.wait",
2215
+ "browser.snapshot",
2216
+ "browser.screenshot",
2217
+ "browser.locate",
2218
+ "browser.tabs.list",
2219
+ "browser.tabs.open",
2220
+ "browser.console.read",
2221
+ "browser.network.read",
2222
+ "browser.storage.read",
2223
+ "browser.page-errors.read",
2224
+ "browser.click",
2225
+ "browser.type",
2226
+ "browser.key",
2227
+ "browser.select",
2228
+ "browser.scroll",
2229
+ "browser.tabs.close",
2230
+ "browser.upload",
2231
+ "browser.download"
2232
+ ];
2233
+ interface XenoBrowserControlPlaneAdapterOptions {
2234
+ baseUrl: string;
2235
+ token: string;
2236
+ driver: "browser" | "extension";
2237
+ fetch?: typeof globalThis.fetch;
2238
+ timeoutMs?: number;
2222
2239
  }
2223
- interface CreateXenoGovernedAutomationToolsOptions {
2224
- runtime: XenoGovernedAutomationToolRuntime;
2225
- operations?: readonly XenoAutomationOperation[];
2240
+ declare class XenoBrowserControlPlaneAdapter implements XenoAutomationAdapter {
2241
+ private readonly options;
2242
+ private readonly base;
2243
+ private readonly fetchImpl;
2244
+ private readonly timeoutMs;
2245
+ constructor(options: XenoBrowserControlPlaneAdapterOptions);
2246
+ manifest(): Promise<XenoAutomationAdapterManifest>;
2247
+ preflight(request: XenoAutomationRequest, signal: AbortSignal): Promise<XenoAutomationPreflight>;
2248
+ execute(request: XenoAutomationRequest, preflight: XenoAutomationPreflight, _grant: XenoAutomationExecutionGrant, signal: AbortSignal): Promise<XenoAutomationAdapterExecutionResult>;
2249
+ stop(_operationId: string, _reason: string): Promise<void>;
2250
+ private resultEvidence;
2251
+ private snapshotEvidence;
2252
+ private call;
2226
2253
  }
2227
- declare function createXenoGovernedAutomationTools(options: CreateXenoGovernedAutomationToolsOptions): RegisteredTool[];
2228
- interface XenoArtifactValidationIssue {
2254
+ interface MemoryFile {
2255
+ level: MemoryLevel;
2229
2256
  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);
2257
+ content: string;
2258
+ tokenCount: number;
2259
+ lastModified?: Date;
2243
2260
  }
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[]);
2261
+ interface ResolvedMemory {
2262
+ files: MemoryFile[];
2263
+ byLevel: Record<MemoryLevel, string>;
2264
+ totalTokens: number;
2265
+ truncated: boolean;
2257
2266
  }
2258
- declare function validateXenoEvidenceGraph(graph: XenoEvidenceGraph): XenoArtifactValidationIssue[];
2259
- declare function assertValidXenoEvidenceGraph(graph: XenoEvidenceGraph): void;
2260
- interface XenoEvidenceGraphBuilderOptions {
2261
- graphId: string;
2262
- now?: () => string;
2267
+ interface ProjectSessionContextEntry {
2268
+ sessionId: string;
2269
+ model: string;
2270
+ lastActivity: string;
2271
+ messageCount: number;
2272
+ excerpt: string;
2263
2273
  }
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;
2274
+ interface ProjectSessionContext {
2275
+ entries: ProjectSessionContextEntry[];
2276
+ totalTokens: number;
2277
+ truncated: boolean;
2278
+ content: string;
2272
2279
  }
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;
2280
+ declare const DEFAULT_MEMORY_BUDGETS: MemoryBudget;
2281
+ declare const MEMORY_FILES: Record<MemoryLevel, string>;
2282
+ interface MemoryManagerOptions {
2283
+ cwd: string;
2284
+ globalDir?: string;
2285
+ role?: string;
2286
+ sessionDir?: string;
2287
+ scope?: MemoryAccessScope;
2288
+ budgets?: Partial<MemoryBudget>;
2289
+ projectSessionContext?: {
2290
+ limit?: number;
2291
+ maxTokens?: number;
2292
+ maxCharsPerSession?: number;
2293
+ };
2280
2294
  }
2281
- interface XenoArtifactFileSnapshot extends XenoArtifactFileSnapshotPayload {
2282
- checksum: {
2283
- algorithm: "sha256";
2284
- value: string;
2295
+ type MemoryAccessScope = "none" | "session" | "project" | "user";
2296
+ declare class MemoryManager {
2297
+ private cwd;
2298
+ private globalDir;
2299
+ private role?;
2300
+ private sessionDir?;
2301
+ private scope;
2302
+ private budgets;
2303
+ private projectSessionContextDefaults;
2304
+ constructor(options: MemoryManagerOptions);
2305
+ get accessScope(): MemoryAccessScope;
2306
+ canAccessLevel(level: MemoryLevel): boolean;
2307
+ private assertLevelAccess;
2308
+ getProjectSessionContextDefaults(): {
2309
+ limit: number;
2310
+ maxTokens: number;
2311
+ maxCharsPerSession: number;
2285
2312
  };
2313
+ getPath(level: MemoryLevel): string;
2314
+ loadForPrompt(): Promise<ResolvedMemory>;
2315
+ loadProjectSessionContext(options?: {
2316
+ excludeSessionId?: string;
2317
+ limit?: number;
2318
+ maxTokens?: number;
2319
+ maxCharsPerSession?: number;
2320
+ }): Promise<ProjectSessionContext>;
2321
+ private filterProjectSessions;
2322
+ private normalizePath;
2323
+ private extractRecentTranscriptExcerpt;
2324
+ private formatProjectSessionEntry;
2325
+ add(level: MemoryLevel, content: string, source: "user" | "auto"): Promise<void>;
2326
+ set(level: MemoryLevel, content: string): Promise<void>;
2327
+ formatForPrompt(memory: ResolvedMemory): string;
2328
+ private truncateContent;
2286
2329
  }
2287
- interface XenoArtifactFileRecoveryNotice {
2288
- snapshotPath: string;
2289
- backupPath: string;
2290
- reason: string;
2330
+ interface AutoMemoryContext {
2331
+ error?: string;
2332
+ correction?: string;
2333
+ taskCompleted?: boolean;
2334
+ userPreference?: string;
2291
2335
  }
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;
2336
+ declare class AutoMemory {
2337
+ private manager;
2338
+ private recentErrors;
2339
+ constructor(manager: MemoryManager);
2340
+ shouldTrigger(context: AutoMemoryContext): AutoMemoryTrigger | null;
2341
+ extract(trigger: AutoMemoryTrigger, messages: Message[]): Promise<string | null>;
2342
+ private extractErrorCorrection;
2343
+ private extractPattern;
2344
+ private extractPreference;
2345
+ private extractTaskSummary;
2346
+ private messagesToText;
2347
+ private normalizeError;
2300
2348
  }
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;
2349
+ interface VectorDocument {
2350
+ id: string;
2351
+ content: string;
2352
+ embedding: number[];
2353
+ metadata: Record<string, unknown>;
2328
2354
  }
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;
2355
+ interface VectorSearchResult {
2356
+ id: string;
2357
+ content: string;
2358
+ score: number;
2359
+ metadata: Record<string, unknown>;
2337
2360
  }
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[];
2361
+ interface VectorStoreOptions {
2362
+ maxDocuments?: number;
2363
+ embeddingDimension?: number;
2364
+ embedFn?: (text: string) => Promise<number[]>;
2349
2365
  }
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[];
2366
+ interface VectorStoreAdapter {
2367
+ add(id: string, embedding: number[], metadata: Record<string, unknown>): Promise<void>;
2368
+ search(query: number[], topK: number): Promise<Array<{
2369
+ id: string;
2370
+ score: number;
2371
+ }>>;
2372
+ remove(id: string): Promise<void>;
2373
+ readonly size: 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;
2381
- }
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;
2375
+ declare class VectorMemoryStore {
2376
+ private documents;
2377
+ private insertionOrder;
2378
+ private maxDocuments;
2379
+ private embedder;
2380
+ private customEmbedFn?;
2381
+ constructor(options?: VectorStoreOptions);
2382
+ addDocument(id: string, content: string, metadata?: Record<string, unknown>): Promise<void>;
2383
+ search(query: string, topK?: number, minScore?: number): Promise<VectorSearchResult[]>;
2384
+ removeDocument(id: string): boolean;
2385
+ getDocument(id: string): VectorDocument | undefined;
2386
+ get size(): number;
2387
+ clear(): void;
2388
+ exportDocuments(): VectorDocument[];
2389
+ importDocuments(docs: VectorDocument[]): void;
2398
2390
  }
2399
- declare class XenoDiffParseError extends Error {
2400
- readonly line?: number | undefined;
2401
- readonly code = "XENO_DIFF_INVALID";
2402
- constructor(message: string, line?: number | undefined);
2391
+ interface AskUserRequest {
2392
+ question: string;
2393
+ options?: string[];
2394
+ context?: string;
2403
2395
  }
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;
2396
+ interface AskUserResponse {
2397
+ answer: string;
2398
+ selectedOption?: string;
2411
2399
  }
2412
- interface XenoArtifactReviewAnchorInput {
2413
- file?: string;
2414
- line?: number;
2415
- hunkId?: string;
2400
+ type AskUserHandler = (request: AskUserRequest) => Promise<AskUserResponse>;
2401
+ interface DispatchAgentRequest {
2402
+ agent?: string;
2403
+ prompt: string;
2404
+ timeoutMs?: number;
2405
+ signal?: AbortSignal;
2416
2406
  }
2417
- interface AddXenoArtifactCommentRequest extends XenoArtifactReviewAnchorInput {
2418
- artifactId: string;
2419
- revision?: number;
2420
- body: string;
2421
- parentCommentId?: string;
2407
+ interface DispatchAgentResponse {
2408
+ output: string;
2422
2409
  }
2423
- interface SetXenoArtifactCommentResolutionRequest {
2424
- artifactId: string;
2425
- revision?: number;
2426
- commentId: string;
2427
- resolved: boolean;
2410
+ type DispatchAgentHandler = (request: DispatchAgentRequest) => Promise<DispatchAgentResponse>;
2411
+ interface FileObservation {
2412
+ path: string;
2413
+ mtimeMs: number;
2414
+ size: number;
2415
+ source: "read" | "write" | "edit" | "notebook" | "shell";
2416
+ requiresRefresh?: boolean;
2428
2417
  reason?: string;
2429
2418
  }
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[];
2419
+ interface ToolRuntimeContext {
2420
+ getCwd(): string;
2421
+ setCwd(nextCwd: string): void;
2422
+ getOwnerSessionId(): string | undefined;
2423
+ getMemoryManager(): MemoryManager | undefined;
2424
+ setMemoryManager(memoryManager: MemoryManager | undefined): void;
2425
+ noteFileObservation(filePath: string, observation: Omit<FileObservation, "path">): void;
2426
+ getFileObservation(filePath: string): FileObservation | undefined;
2427
+ invalidateFileObservation(filePath: string, reason: string): void;
2428
+ listFileObservations(): FileObservation[];
2429
+ askUser?(request: AskUserRequest): Promise<AskUserResponse>;
2430
+ dispatchAgent?(request: DispatchAgentRequest): Promise<DispatchAgentResponse>;
2470
2431
  }
2471
- interface XenoSpecRisk {
2432
+ declare function createToolRuntimeContext(initialCwd?: string, options?: {
2433
+ askUser?: AskUserHandler;
2434
+ dispatchAgent?: DispatchAgentHandler;
2435
+ memoryManager?: MemoryManager;
2436
+ ownerSessionId?: string;
2437
+ }): ToolRuntimeContext;
2438
+ declare const defaultToolRuntimeContext: ToolRuntimeContext;
2439
+ type HarnessTaskStatus = "pending" | "in_progress" | "completed";
2440
+ interface HarnessTask {
2472
2441
  id: string;
2442
+ subject: string;
2473
2443
  description: string;
2474
- impact: "low" | "medium" | "high" | "critical";
2475
- mitigation: string;
2444
+ status: HarnessTaskStatus;
2445
+ activeForm?: string;
2476
2446
  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;
2447
+ metadata: Record<string, unknown>;
2448
+ blocks: string[];
2449
+ blockedBy: string[];
2509
2450
  createdAt: string;
2510
2451
  updatedAt: string;
2511
- predecessorRevision?: number;
2512
2452
  }
2513
- interface XenoSpecArtifactContext {
2514
- producer: XenoArtifactActor;
2515
- identity?: XenoArtifactIdentity;
2516
- sensitivity?: XenoArtifactSensitivity;
2517
- accessPolicyId?: string;
2518
- createdAt?: string;
2519
- }
2520
- interface XenoSpecArtifactBundle {
2521
- document: XenoSpecDocument;
2522
- plan: XenoArtifactEnvelope;
2523
- requirements: XenoArtifactEnvelope;
2524
- design: XenoArtifactEnvelope;
2525
- taskGraph: XenoArtifactEnvelope;
2453
+ interface HarnessTaskUpdate {
2454
+ subject?: string;
2455
+ description?: string;
2456
+ status?: HarnessTaskStatus | "deleted";
2457
+ activeForm?: string;
2458
+ owner?: string;
2459
+ metadata?: Record<string, unknown>;
2460
+ addBlocks?: string[];
2461
+ addBlockedBy?: string[];
2526
2462
  }
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;
2463
+ declare class TaskListManager {
2464
+ private readonly tasks;
2465
+ private nextId;
2466
+ create(input: {
2467
+ subject: string;
2468
+ description: string;
2469
+ activeForm?: string;
2470
+ metadata?: Record<string, unknown>;
2471
+ }): HarnessTask;
2472
+ get(taskId: string): HarnessTask | undefined;
2473
+ list(): HarnessTask[];
2474
+ update(taskId: string, input: HarnessTaskUpdate): HarnessTask | undefined;
2475
+ delete(taskId: string): boolean;
2476
+ private incompleteBlockers;
2477
+ private assertDependencyTargets;
2478
+ private link;
2479
+ private assertAcyclic;
2480
+ private snapshot;
2481
+ private restore;
2536
2482
  }
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[];
2551
- }
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;
2483
+ declare function createTaskListTools(manager?: TaskListManager): RegisteredTool[];
2484
+ interface DefaultToolRegistryOptions {
2485
+ cwd?: string;
2486
+ runtime?: ToolRuntimeContext;
2487
+ ownerSessionId?: string;
2488
+ askUser?: AskUserHandler;
2489
+ dispatchAgent?: DispatchAgentHandler;
2490
+ memoryManager?: MemoryManager;
2491
+ webSearchApiKey?: string;
2492
+ webContext?: WebContextToolOptions;
2493
+ permissionProfile?: PermissionProfile;
2494
+ sandbox?: AgentSandbox;
2495
+ validateInputs?: boolean;
2496
+ toolSchemaMode?: "all" | "demand";
2497
+ taskListManager?: TaskListManager;
2498
+ shellEnvironment?: NodeJS.ProcessEnv;
2499
+ shellSensitiveEnvironmentKeys?: readonly string[];
2559
2500
  }
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[];
2501
+ interface ToolRegistryOptions {
2502
+ validateInputs?: boolean;
2503
+ toolSchemaMode?: "all" | "demand";
2568
2504
  }
2569
- interface XenoSpecLifecycleServiceOptions {
2570
- repository: XenoArtifactRepository;
2571
- now?: () => string;
2572
- idFactory?: () => string;
2505
+ declare class ToolRegistry {
2506
+ private tools;
2507
+ private compiledSchemas;
2508
+ private changeListeners;
2509
+ private aliasNames;
2510
+ private validateInputs;
2511
+ private readonly toolSchemaMode;
2512
+ private readonly activatedDefinitions;
2513
+ constructor(options?: ToolRegistryOptions);
2514
+ setValidateInputs(enabled: boolean): this;
2515
+ get inputValidationEnabled(): boolean;
2516
+ get schemaLoadingMode(): "all" | "demand";
2517
+ register(tool: RegisteredTool): void;
2518
+ registerAlias(tool: RegisteredTool): void;
2519
+ registerAll(tools: Iterable<RegisteredTool>): void;
2520
+ unregister(name: string): boolean;
2521
+ onChange(listener: () => void): () => void;
2522
+ private emitChange;
2523
+ get(name: string): RegisteredTool | undefined;
2524
+ getDefinitions(): ToolDefinition[];
2525
+ getDefinitionsForRequest(): ToolDefinition[];
2526
+ getCapabilityCatalog(): string;
2527
+ activateMatchingDefinitions(query: string, limit?: number): ToolDefinition[];
2528
+ private static namespaceOf;
2529
+ getDefinitionsByNamespace(namespace: string): ToolDefinition[];
2530
+ listNamespaces(): string[];
2531
+ execute(name: string, input: Record<string, unknown>, context?: ToolExecutionContext): Promise<ToolResult>;
2532
+ listNames(): string[];
2533
+ has(name: string): boolean;
2534
+ projectPolicyInput(name: string, input: Record<string, unknown>): ToolPolicyProjection | {
2535
+ error: ToolResult;
2536
+ };
2537
+ get size(): number;
2538
+ private compileDefinition;
2539
+ private assertDefinitionsExportable;
2573
2540
  }
2574
- declare class XenoSpecValidationError extends Error {
2575
- readonly issues: string[];
2576
- readonly code = "XENO_SPEC_INVALID";
2577
- constructor(issues: string[]);
2541
+ declare function createDefaultToolRegistry(options?: DefaultToolRegistryOptions): ToolRegistry;
2542
+ declare const registry: ToolRegistry;
2543
+ interface XenoGovernedAutomationToolExecution {
2544
+ operation: XenoAutomationOperation;
2545
+ governingToolName: string;
2546
+ operationId: string;
2547
+ idempotencyKey: string;
2548
+ parameters: Record<string, unknown>;
2549
+ declaredTarget?: XenoAutomationTarget;
2550
+ authorization: ToolAuthorizationReceipt;
2551
+ signal?: AbortSignal;
2552
+ reportProgress?: ToolExecutionContext["reportProgress"];
2578
2553
  }
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>;
2554
+ interface XenoGovernedAutomationToolRuntime {
2555
+ execute(input: XenoGovernedAutomationToolExecution): Promise<XenoAutomationExecutionResult>;
2556
+ stop?(operationId: string, reason?: string): Promise<boolean> | boolean;
2590
2557
  }
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;
2558
+ interface CreateXenoGovernedAutomationToolsOptions {
2559
+ runtime: XenoGovernedAutomationToolRuntime;
2560
+ operations?: readonly XenoAutomationOperation[];
2635
2561
  }
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;
2562
+ declare function createXenoGovernedAutomationTools(options: CreateXenoGovernedAutomationToolsOptions): RegisteredTool[];
2563
+ interface CliAutomationAuditEvent {
2564
+ eventType: "automation_lease_approved" | "automation_completed" | "automation_failed";
2565
+ traceId: string;
2566
+ operation: XenoAutomationOperation;
2567
+ operationId: string;
2568
+ leaseId?: string;
2569
+ contractFingerprint?: string;
2570
+ status?: string;
2571
+ artifactIds?: string[];
2572
+ permissionReason?: string;
2573
+ }
2574
+ interface CliAutomationAuditLoggerPort {
2575
+ append(event: {
2576
+ trace_id: string;
2577
+ event_type: string;
2578
+ actor: "system";
2579
+ risk_level: "low" | "high";
2580
+ decision?: "allow";
2581
+ status: "ok" | "error";
2582
+ reason?: string;
2583
+ metadata: Record<string, unknown>;
2584
+ }): Promise<unknown>;
2646
2585
  }
2647
- interface XenoReviewAgentResult {
2648
- reviewerAgentId: string;
2649
- dimension: XenoReviewDimension;
2650
- findings: XenoReviewFindingProposal[];
2651
- completedAt: string;
2586
+ interface CliAutomationEnvironment {
2587
+ browser?: {
2588
+ driver: "browser" | "extension";
2589
+ baseUrl?: string;
2590
+ token?: string;
2591
+ readDomains: string[];
2592
+ actDomains: string[];
2593
+ deniedDomains: string[];
2594
+ ports: number[];
2595
+ allowLoopbackDevelopment: boolean;
2596
+ uploads: "deny" | "prompt" | "allow";
2597
+ downloads: "deny" | "prompt" | "allow";
2598
+ recording: "disabled" | "bounded";
2599
+ };
2600
+ computer?: {
2601
+ baseUrl?: string;
2602
+ token?: string;
2603
+ deviceId?: string;
2604
+ allowedApplications: string[];
2605
+ };
2606
+ }
2607
+ interface CliAutomationSurfaceStatus {
2608
+ surface: "browser" | "computer";
2609
+ configured: boolean;
2610
+ available: boolean;
2611
+ certified: boolean;
2612
+ adapterId?: string;
2613
+ adapterVersion?: string;
2614
+ operations: string[];
2615
+ limitations: string[];
2616
+ error?: string;
2652
2617
  }
2653
- interface XenoReviewVerificationResult {
2654
- verifierAgentId: string;
2655
- outcome: XenoReviewVerificationOutcome;
2656
- rationale: string;
2657
- evidence: XenoReviewEvidence[];
2658
- confidence?: number;
2659
- completedAt: string;
2618
+ interface CliAutomationStatusReport {
2619
+ schemaVersion: 1;
2620
+ protocolVersion: 1;
2621
+ enabled: boolean;
2622
+ surfaces: CliAutomationSurfaceStatus[];
2623
+ docs: string;
2660
2624
  }
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;
2625
+ interface CreateCliGovernedAutomationRuntimeOptions {
2626
+ cwd: () => string;
2627
+ profile: () => CompiledAgentProfile;
2628
+ runId: string;
2629
+ agentId?: string;
2630
+ sessionId?: string;
2631
+ workspaceId?: string;
2632
+ surface: "cli" | "hub" | "ide" | "api" | "hosted";
2633
+ securityPolicy?: () => PolicyEnforcerConfig | undefined;
2634
+ securityStatus?: ProcessContainmentStatus;
2635
+ safeMode?: boolean;
2636
+ environment?: CliAutomationEnvironment;
2637
+ onAudit?: (event: CliAutomationAuditEvent) => Promise<void> | void;
2638
+ }
2639
+ declare class CliGovernedAutomationRuntime implements XenoGovernedAutomationToolRuntime {
2640
+ private readonly options;
2641
+ private readonly leases;
2642
+ private readonly activeExecutors;
2643
+ private readonly environment;
2644
+ private browserAdapter?;
2645
+ private computerAdapter?;
2646
+ constructor(options: CreateCliGovernedAutomationRuntimeOptions);
2647
+ register(registry: ToolRegistry): number;
2648
+ execute(input: XenoGovernedAutomationToolExecution): Promise<XenoAutomationExecutionResult>;
2649
+ stop(operationId: string, reason?: string): Promise<boolean>;
2650
+ private securityPolicy;
2651
+ private adapterFor;
2652
+ private audit;
2653
+ }
2654
+ declare function createCliGovernedAutomationRuntime(options: CreateCliGovernedAutomationRuntimeOptions): CliGovernedAutomationRuntime;
2655
+ declare function createCliAutomationAuditSink(logger: CliAutomationAuditLoggerPort | undefined): ((event: CliAutomationAuditEvent) => Promise<void>) | undefined;
2656
+ declare function inspectCliAutomationStatus(environment?: CliAutomationEnvironment): Promise<CliAutomationStatusReport>;
2657
+ declare function readCliAutomationEnvironment(env?: NodeJS.ProcessEnv): CliAutomationEnvironment;
2658
+ declare function renderCliAutomationStatus(report: CliAutomationStatusReport): string;
2659
+ type XenoHostAutomationAuditEvent = CliAutomationAuditEvent;
2660
+ type XenoHostAutomationAuditLoggerPort = CliAutomationAuditLoggerPort;
2661
+ type XenoHostAutomationEnvironment = CliAutomationEnvironment;
2662
+ type XenoHostAutomationSurfaceStatus = CliAutomationSurfaceStatus;
2663
+ type XenoHostAutomationStatusReport = CliAutomationStatusReport;
2664
+ type CreateXenoHostGovernedAutomationRuntimeOptions = CreateCliGovernedAutomationRuntimeOptions;
2665
+ interface XenoArtifactValidationIssue {
2666
+ path: string;
2667
+ code: string;
2668
+ message: string;
2678
2669
  }
2679
- interface XenoReviewTarget {
2680
- artifactId: string;
2681
- revision: number;
2682
- contentHash: XenoContentHash;
2683
- title: string;
2684
- repositoryId?: string;
2685
- commit?: string;
2686
- anchors?: XenoArtifactAnchor[];
2670
+ declare class XenoArtifactValidationError extends Error {
2671
+ readonly code = "ARTIFACT_INVALID";
2672
+ readonly issues: XenoArtifactValidationIssue[];
2673
+ constructor(message: string, issues: XenoArtifactValidationIssue[]);
2687
2674
  }
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;
2675
+ declare class XenoArtifactStateTransitionError extends Error {
2676
+ readonly fromState: XenoArtifactState;
2677
+ readonly toState: XenoArtifactState;
2678
+ readonly code = "ARTIFACT_STATE_TRANSITION_INVALID";
2679
+ constructor(fromState: XenoArtifactState, toState: XenoArtifactState);
2698
2680
  }
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>;
2681
+ declare function validateXenoArtifact(artifact: XenoArtifactEnvelope): XenoArtifactValidationIssue[];
2682
+ declare function assertValidXenoArtifact(artifact: XenoArtifactEnvelope): void;
2683
+ declare function canTransitionXenoArtifactState(fromState: XenoArtifactState, toState: XenoArtifactState): boolean;
2684
+ declare function assertXenoArtifactStateTransition(fromState: XenoArtifactState, toState: XenoArtifactState): void;
2685
+ declare function validateXenoArtifactReviewEvent(event: XenoArtifactReviewEvent, artifact?: XenoArtifactEnvelope): XenoArtifactValidationIssue[];
2686
+ declare function summarizeXenoArtifactReview(events: readonly XenoArtifactReviewEvent[]): XenoArtifactReviewSummary;
2687
+ declare function sha256ArtifactBytes(content: Uint8Array | string): XenoContentHash;
2688
+ declare function canonicalizeArtifactJson(value: XenoJsonValue): string;
2689
+ declare function sha256ArtifactJson(value: XenoJsonValue): XenoContentHash;
2690
+ declare class XenoEvidenceGraphValidationError extends Error {
2691
+ readonly code = "EVIDENCE_GRAPH_INVALID";
2692
+ readonly issues: XenoArtifactValidationIssue[];
2693
+ constructor(issues: XenoArtifactValidationIssue[]);
2694
+ }
2695
+ declare function validateXenoEvidenceGraph(graph: XenoEvidenceGraph): XenoArtifactValidationIssue[];
2696
+ declare function assertValidXenoEvidenceGraph(graph: XenoEvidenceGraph): void;
2697
+ interface XenoEvidenceGraphBuilderOptions {
2698
+ graphId: string;
2699
+ now?: () => string;
2700
+ }
2701
+ declare class XenoEvidenceGraphBuilder {
2702
+ private readonly now;
2703
+ private graph;
2704
+ constructor(options: XenoEvidenceGraphBuilderOptions | XenoEvidenceGraph);
2705
+ addNode(node: XenoEvidenceNode): this;
2706
+ addEdge(edge: XenoEvidenceEdge): this;
2707
+ build(): XenoEvidenceGraph;
2708
+ private touch;
2709
+ }
2710
+ declare const XENO_ARTIFACT_FILE_REPOSITORY_SCHEMA_VERSION: 1;
2711
+ interface XenoArtifactFileSnapshotPayload {
2712
+ schemaVersion: typeof XENO_ARTIFACT_FILE_REPOSITORY_SCHEMA_VERSION;
2713
+ generation: number;
2714
+ createdAt: string;
2715
+ updatedAt: string;
2716
+ state: XenoArtifactRepositoryState;
2717
+ }
2718
+ interface XenoArtifactFileSnapshot extends XenoArtifactFileSnapshotPayload {
2719
+ checksum: {
2720
+ algorithm: "sha256";
2721
+ value: string;
2719
2722
  };
2720
2723
  }
2721
- interface XenoReviewCoordinatorContext {
2722
- runId: string;
2723
- target: XenoReviewTarget;
2724
- pack: XenoReviewPack;
2724
+ interface XenoArtifactFileRecoveryNotice {
2725
+ snapshotPath: string;
2726
+ backupPath: string;
2727
+ reason: string;
2725
2728
  }
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;
2729
+ interface FileXenoArtifactRepositoryOptions {
2730
+ directory: string;
2731
+ snapshotFileName?: string;
2732
+ lockTimeoutMs?: number;
2733
+ lockRetryMs?: number;
2734
+ maxSnapshotBytes?: number;
2737
2735
  now?: () => string;
2738
- idFactory?: (prefix: "report" | "finding") => string;
2736
+ onRecovery?: (notice: XenoArtifactFileRecoveryNotice) => void;
2739
2737
  }
2740
- interface XenoReviewArtifactContext {
2738
+ declare class FileXenoArtifactRepository implements XenoArtifactRepository {
2739
+ readonly directory: string;
2740
+ readonly snapshotPath: string;
2741
+ readonly backupPath: string;
2742
+ readonly lockPath: string;
2743
+ private readonly now;
2744
+ private readonly lockTimeoutMs;
2745
+ private readonly lockRetryMs;
2746
+ private readonly maxSnapshotBytes;
2747
+ private readonly onRecovery?;
2748
+ private mutationTail;
2749
+ constructor(options: FileXenoArtifactRepositoryOptions);
2750
+ create(artifact: XenoArtifactEnvelope): Promise<XenoArtifactRecord>;
2751
+ createRevision(artifact: XenoArtifactEnvelope, options?: XenoArtifactRevisionOptions): Promise<XenoArtifactRecord>;
2752
+ get(artifactId: string, revision?: number): Promise<XenoArtifactRecord | undefined>;
2753
+ require(artifactId: string, revision?: number): Promise<XenoArtifactRecord>;
2754
+ list(query?: XenoArtifactListQuery): Promise<XenoArtifactRecord[]>;
2755
+ listRevisions(artifactId: string): Promise<XenoArtifactRecord[]>;
2756
+ transition(request: XenoArtifactTransitionRequest): Promise<XenoArtifactRecord>;
2757
+ appendReviewEvent(request: XenoArtifactAppendReviewRequest): Promise<XenoArtifactRecord>;
2758
+ inspectSnapshot(): Promise<XenoArtifactFileSnapshot | undefined>;
2759
+ private mutate;
2760
+ private enqueueMutation;
2761
+ private acquireLock;
2762
+ private load;
2763
+ private persist;
2764
+ private readSnapshot;
2765
+ }
2766
+ type XenoDiffMode = "working-tree" | "staged" | "turn" | "commit" | "preview";
2767
+ type XenoDiffFileStatus = "added" | "modified" | "deleted" | "renamed" | "copied" | "binary";
2768
+ type XenoDiffLineKind = "context" | "addition" | "deletion" | "no-newline";
2769
+ interface XenoDiffLine {
2770
+ kind: XenoDiffLineKind;
2771
+ text: string;
2772
+ oldLine?: number;
2773
+ newLine?: number;
2774
+ }
2775
+ interface XenoDiffHunk {
2776
+ hunkId: string;
2777
+ header: string;
2778
+ section?: string;
2779
+ oldStart: number;
2780
+ oldLines: number;
2781
+ newStart: number;
2782
+ newLines: number;
2783
+ additions: number;
2784
+ deletions: number;
2785
+ lines: XenoDiffLine[];
2786
+ }
2787
+ interface XenoDiffFile {
2788
+ oldPath?: string;
2789
+ newPath?: string;
2790
+ displayPath: string;
2791
+ status: XenoDiffFileStatus;
2792
+ additions: number;
2793
+ deletions: number;
2794
+ binary: boolean;
2795
+ headerLines: string[];
2796
+ hunks: XenoDiffHunk[];
2797
+ }
2798
+ interface XenoDiffDocument {
2799
+ schemaVersion: 1;
2800
+ mode: XenoDiffMode;
2801
+ repositoryId?: string;
2802
+ baseRef?: string;
2803
+ headRef?: string;
2804
+ files: XenoDiffFile[];
2805
+ additions: number;
2806
+ deletions: number;
2807
+ rawDiff: string;
2808
+ }
2809
+ interface ParseUnifiedDiffOptions {
2810
+ mode?: XenoDiffMode;
2811
+ repositoryId?: string;
2812
+ baseRef?: string;
2813
+ headRef?: string;
2814
+ maxBytes?: number;
2815
+ maxFiles?: number;
2816
+ maxHunks?: number;
2817
+ maxLines?: number;
2818
+ }
2819
+ interface XenoDiffArtifactContext {
2820
+ kind?: "diff" | "patch";
2821
+ artifactId?: string;
2822
+ revision?: number;
2823
+ predecessorRevision?: number;
2824
+ createdAt?: string;
2825
+ title?: string;
2826
+ description?: string;
2741
2827
  producer: XenoArtifactActor;
2742
2828
  identity?: XenoArtifactIdentity;
2743
2829
  sensitivity?: XenoArtifactSensitivity;
2744
2830
  accessPolicyId?: string;
2745
- artifactId?: string;
2746
- createdAt?: string;
2831
+ mode?: XenoDiffMode;
2832
+ repositoryId?: string;
2833
+ baseRef?: string;
2834
+ headRef?: string;
2747
2835
  }
2748
- interface XenoGitHubReviewComment {
2749
- findingId: string;
2750
- path: string;
2836
+ declare class XenoDiffParseError extends Error {
2837
+ readonly line?: number | undefined;
2838
+ readonly code = "XENO_DIFF_INVALID";
2839
+ constructor(message: string, line?: number | undefined);
2840
+ }
2841
+ declare function parseUnifiedDiff(diff: string, options?: ParseUnifiedDiffOptions): XenoDiffDocument;
2842
+ declare function unifiedDiffToXenoArtifact(diff: string, context: XenoDiffArtifactContext): XenoArtifactEnvelope;
2843
+ declare function xenoArtifactToDiffDocument(artifact: XenoArtifactEnvelope): XenoDiffDocument;
2844
+ interface XenoArtifactReviewServiceOptions {
2845
+ repository: XenoArtifactRepository;
2846
+ actor: XenoArtifactActor;
2847
+ idFactory?: () => string;
2848
+ }
2849
+ interface XenoArtifactReviewAnchorInput {
2850
+ file?: string;
2751
2851
  line?: number;
2852
+ hunkId?: string;
2853
+ }
2854
+ interface AddXenoArtifactCommentRequest extends XenoArtifactReviewAnchorInput {
2855
+ artifactId: string;
2856
+ revision?: number;
2752
2857
  body: string;
2753
- severity: XenoReviewSeverity;
2754
- verified: boolean;
2858
+ parentCommentId?: string;
2755
2859
  }
2756
- declare class XenoReviewValidationError extends Error {
2757
- readonly issues: string[];
2758
- readonly code = "XENO_REVIEW_INVALID";
2759
- constructor(issues: string[]);
2860
+ interface SetXenoArtifactCommentResolutionRequest {
2861
+ artifactId: string;
2862
+ revision?: number;
2863
+ commentId: string;
2864
+ resolved: boolean;
2865
+ reason?: string;
2760
2866
  }
2761
- declare class XenoMultiAgentReviewCoordinator {
2762
- private readonly reviewer;
2763
- private readonly verifier?;
2764
- private readonly now;
2867
+ interface DecideXenoArtifactRequest extends Omit<XenoArtifactReviewAnchorInput, "line"> {
2868
+ artifactId: string;
2869
+ revision?: number;
2870
+ decision: XenoArtifactReviewDecision;
2871
+ rationale?: string;
2872
+ }
2873
+ declare class XenoArtifactReviewService {
2874
+ private readonly repository;
2875
+ private readonly actor;
2765
2876
  private readonly idFactory;
2766
- constructor(options: XenoMultiAgentReviewCoordinatorOptions);
2767
- run(context: XenoReviewCoordinatorContext): Promise<XenoReviewReport>;
2877
+ constructor(options: XenoArtifactReviewServiceOptions);
2878
+ addComment(request: AddXenoArtifactCommentRequest): Promise<XenoArtifactRecord>;
2879
+ setCommentResolution(request: SetXenoArtifactCommentResolutionRequest): Promise<XenoArtifactRecord>;
2880
+ decide(request: DecideXenoArtifactRequest): Promise<XenoArtifactRecord>;
2768
2881
  }
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;
2882
+ declare function buildXenoArtifactReviewAnchor(record: XenoArtifactRecord, input: XenoArtifactReviewAnchorInput): XenoArtifactAnchor | undefined;
2883
+ declare function normalizeRepositoryRelativePath(value: string): string;
2884
+ declare const XENO_SPEC_SCHEMA_VERSION: "xeno.spec.v1";
2885
+ declare const XENO_SPEC_EXECUTION_SCHEMA_VERSION: "xeno.spec-execution.v1";
2886
+ type XenoSpecPriority = "must" | "should" | "could";
2887
+ type XenoSpecTaskStatus = "pending" | "in_progress" | "completed" | "blocked" | "skipped";
2888
+ type XenoSpecExecutionState = "ready" | "running" | "completed" | "failed" | "cancelled";
2889
+ interface XenoSpecAcceptanceCriterion {
2890
+ id: string;
2891
+ text: string;
2892
+ requiredEvidenceKinds?: string[];
2786
2893
  }
2787
- interface AgentTeam {
2894
+ interface XenoSpecRequirement {
2788
2895
  id: string;
2789
- name: string;
2790
- description?: string;
2791
- agentIds: string[];
2792
- strategy?: AgentSelectionStrategy;
2896
+ text: string;
2897
+ priority: XenoSpecPriority;
2898
+ acceptanceCriteria: XenoSpecAcceptanceCriterion[];
2899
+ sourceReferences?: XenoEvidenceReference[];
2793
2900
  }
2794
- interface AgentLoadSnapshot {
2795
- agentId: string;
2796
- agentName: string;
2797
- activeTasks: number;
2798
- maxConcurrentTasks: number;
2799
- availableSlots: number;
2800
- isAvailable: boolean;
2901
+ interface XenoSpecDesignDecision {
2902
+ id: string;
2903
+ decision: string;
2904
+ rationale: string;
2905
+ alternatives?: string[];
2906
+ requirementIds?: string[];
2801
2907
  }
2802
- interface AgentTask {
2908
+ interface XenoSpecRisk {
2803
2909
  id: string;
2804
- type: string;
2805
2910
  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;
2911
+ impact: "low" | "medium" | "high" | "critical";
2912
+ mitigation: string;
2913
+ owner?: string;
2823
2914
  }
2824
- interface AgentArtifact {
2825
- name: string;
2826
- mimeType?: string;
2827
- content: string;
2915
+ interface XenoSpecDesign {
2916
+ summary: string;
2917
+ decisions: XenoSpecDesignDecision[];
2918
+ risks: XenoSpecRisk[];
2828
2919
  }
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 {
2920
+ interface XenoSpecTask {
2832
2921
  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[];
2922
+ title: string;
2923
+ description: string;
2924
+ dependsOn?: string[];
2925
+ requirementIds: string[];
2926
+ acceptanceCriterionIds: string[];
2927
+ expectedPaths?: string[];
2928
+ preferredAgentProfile?: string;
2927
2929
  }
2928
- interface TurnDiffTrackerOptions {
2929
- maxFileBytes?: number;
2930
- cwd?: string;
2930
+ interface XenoSpecSourceBaseline {
2931
+ repositoryId?: string;
2932
+ commit?: string;
2933
+ workspaceFingerprint?: XenoContentHash;
2931
2934
  }
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;
2935
+ interface XenoSpecDocument {
2936
+ schemaVersion: typeof XENO_SPEC_SCHEMA_VERSION;
2937
+ specId: string;
2938
+ revision: number;
2939
+ title: string;
2940
+ problem: string;
2941
+ requirements: XenoSpecRequirement[];
2942
+ design: XenoSpecDesign;
2943
+ tasks: XenoSpecTask[];
2944
+ acceptanceCriteria: XenoSpecAcceptanceCriterion[];
2945
+ sourceBaseline?: XenoSpecSourceBaseline;
2946
+ createdAt: string;
2947
+ updatedAt: string;
2948
+ predecessorRevision?: number;
2944
2949
  }
2945
- interface XenoLegacyArtifactContext {
2946
- artifactId?: string;
2947
- revision?: number;
2948
- createdAt?: string;
2950
+ interface XenoSpecArtifactContext {
2949
2951
  producer: XenoArtifactActor;
2950
2952
  identity?: XenoArtifactIdentity;
2951
- state?: XenoArtifactState;
2952
2953
  sensitivity?: XenoArtifactSensitivity;
2953
2954
  accessPolicyId?: string;
2955
+ createdAt?: string;
2954
2956
  }
2955
- interface XenoLegacyAgentArtifactContext extends XenoLegacyArtifactContext {
2956
- contentEncoding?: "utf8" | "base64";
2957
- kind?: XenoArtifactKind;
2957
+ interface XenoSpecArtifactBundle {
2958
+ document: XenoSpecDocument;
2959
+ plan: XenoArtifactEnvelope;
2960
+ requirements: XenoArtifactEnvelope;
2961
+ design: XenoArtifactEnvelope;
2962
+ taskGraph: XenoArtifactEnvelope;
2958
2963
  }
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;
2964
+ interface XenoSpecTaskExecution {
2965
+ taskId: string;
2966
+ status: XenoSpecTaskStatus;
2967
+ ownerAgentId?: string;
2968
+ startedAt?: string;
2969
+ completedAt?: string;
2970
+ evidence: XenoEvidenceReference[];
2971
+ acceptanceEvidence: Record<string, XenoEvidenceReference[]>;
2972
+ note?: string;
2983
2973
  }
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>;
2974
+ interface XenoSpecExecutionRecord {
2975
+ schemaVersion: typeof XENO_SPEC_EXECUTION_SCHEMA_VERSION;
2976
+ executionId: string;
2977
+ specId: string;
2978
+ specRevision: number;
2979
+ planArtifactId: string;
2980
+ planHash: XenoContentHash;
2981
+ state: XenoSpecExecutionState;
2982
+ createdAt: string;
2983
+ updatedAt: string;
2984
+ startedAt?: string;
2985
+ completedAt?: string;
2986
+ observedPaths: string[];
2987
+ tasks: XenoSpecTaskExecution[];
2991
2988
  }
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;
2989
+ interface XenoSpecDriftFinding {
2990
+ code: "PLAN_HASH_MISMATCH" | "UNKNOWN_TASK" | "UNKNOWN_PATH" | "MISSING_TASK_EVIDENCE" | "MISSING_ACCEPTANCE_EVIDENCE" | "DEPENDENCY_INCOMPLETE";
2991
+ severity: "warning" | "error";
2992
+ message: string;
2993
+ taskId?: string;
2994
+ path?: string;
2995
+ criterionId?: string;
3020
2996
  }
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>;
2997
+ interface XenoSpecDriftReport {
2998
+ schemaVersion: "xeno.spec-drift.v1";
2999
+ specId: string;
3000
+ specRevision: number;
3001
+ executionId: string;
3002
+ checkedAt: string;
3003
+ drifted: boolean;
3004
+ findings: XenoSpecDriftFinding[];
3028
3005
  }
3029
- interface HttpHookDefinition extends BaseHookDefinition {
3030
- type: "http";
3031
- url: string;
3032
- method?: "POST";
3033
- headers?: Record<string, string>;
3006
+ interface XenoSpecLifecycleServiceOptions {
3007
+ repository: XenoArtifactRepository;
3008
+ now?: () => string;
3009
+ idFactory?: () => string;
3034
3010
  }
3035
- interface PromptHookDefinition extends BaseHookDefinition {
3036
- type: "prompt";
3037
- prompt: string;
3011
+ declare class XenoSpecValidationError extends Error {
3012
+ readonly issues: string[];
3013
+ readonly code = "XENO_SPEC_INVALID";
3014
+ constructor(issues: string[]);
3038
3015
  }
3039
- interface AgentHookDefinition extends BaseHookDefinition {
3040
- type: "agent";
3041
- prompt: string;
3042
- agent?: string;
3043
- model?: string;
3016
+ declare class XenoSpecLifecycleService {
3017
+ private readonly repository;
3018
+ private readonly now;
3019
+ private readonly idFactory;
3020
+ constructor(options: XenoSpecLifecycleServiceOptions);
3021
+ create(document: XenoSpecDocument, context: XenoSpecArtifactContext): Promise<XenoSpecArtifactBundle>;
3022
+ revise(document: XenoSpecDocument, context: XenoSpecArtifactContext): Promise<XenoSpecArtifactBundle>;
3023
+ approve(specId: string, reviewer: XenoArtifactActor, rationale?: string): Promise<XenoArtifactRecord>;
3024
+ reject(specId: string, reviewer: XenoArtifactActor, rationale: string): Promise<XenoArtifactRecord>;
3025
+ startExecution(specId: string, actor: XenoArtifactActor): Promise<XenoArtifactRecord>;
3026
+ updateExecution(executionArtifactId: string, update: (record: XenoSpecExecutionRecord) => XenoSpecExecutionRecord, actor: XenoArtifactActor): Promise<XenoArtifactRecord>;
3044
3027
  }
3045
- type HookDefinition = CommandHookDefinition | HttpHookDefinition | PromptHookDefinition | AgentHookDefinition;
3046
- type HookInput = HookInvocationInput;
3047
- interface HookConfig {
3048
- hooks?: HookDefinition[];
3049
- events?: Partial<Record<HookEventName, HookDefinition[]>>;
3028
+ declare function xenoSpecArtifactIds(specId: string): {
3029
+ plan: string;
3030
+ requirements: string;
3031
+ design: string;
3032
+ taskGraph: string;
3033
+ };
3034
+ declare function validateXenoSpecDocument(document: XenoSpecDocument): string[];
3035
+ declare function assertValidXenoSpecDocument(document: XenoSpecDocument): void;
3036
+ declare function xenoSpecToArtifactBundle(document: XenoSpecDocument, context: XenoSpecArtifactContext): XenoSpecArtifactBundle;
3037
+ declare function xenoArtifactToSpecDocument(artifact: XenoArtifactEnvelope): XenoSpecDocument;
3038
+ declare function xenoSpecExecutionToArtifact(execution: XenoSpecExecutionRecord, context: XenoSpecArtifactContext, revision?: number, predecessorRevision?: number): XenoArtifactEnvelope;
3039
+ declare function xenoArtifactToSpecExecution(artifact: XenoArtifactEnvelope): XenoSpecExecutionRecord;
3040
+ declare function assertValidXenoSpecExecution(execution: XenoSpecExecutionRecord, document: XenoSpecDocument): void;
3041
+ declare function detectXenoSpecDrift(document: XenoSpecDocument, planHash: XenoContentHash, execution: XenoSpecExecutionRecord, actualPlanHash: XenoContentHash, checkedAt?: string): XenoSpecDriftReport;
3042
+ declare const XENO_REVIEW_REPORT_SCHEMA_VERSION: "xeno.review-report.v1";
3043
+ declare const XENO_REVIEW_DIMENSIONS: readonly [
3044
+ "correctness",
3045
+ "security",
3046
+ "performance",
3047
+ "api",
3048
+ "tests",
3049
+ "documentation"
3050
+ ];
3051
+ type XenoReviewDimension = (typeof XENO_REVIEW_DIMENSIONS)[number] | `custom:${string}`;
3052
+ type XenoReviewSeverity = "info" | "low" | "medium" | "high" | "critical";
3053
+ type XenoReviewFindingState = "verified" | "unverified" | "rejected";
3054
+ type XenoReviewVerificationOutcome = "reproduced" | "rejected" | "inconclusive";
3055
+ declare const XENO_REVIEW_EVIDENCE_KINDS: readonly [
3056
+ "source",
3057
+ "test",
3058
+ "trace",
3059
+ "artifact",
3060
+ "reproduction",
3061
+ "benchmark"
3062
+ ];
3063
+ type XenoReviewEvidenceKind = (typeof XENO_REVIEW_EVIDENCE_KINDS)[number] | `custom:${string}`;
3064
+ interface XenoReviewEvidence {
3065
+ evidenceId: string;
3066
+ kind: XenoReviewEvidenceKind;
3067
+ summary: string;
3068
+ producerId: string;
3069
+ reference?: XenoEvidenceReference;
3070
+ anchor?: XenoArtifactAnchor;
3071
+ contentHash?: XenoContentHash;
3050
3072
  }
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;
3073
+ interface XenoReviewFindingProposal {
3074
+ ruleId?: string;
3075
+ dimension: XenoReviewDimension;
3076
+ title: string;
3077
+ summary: string;
3078
+ severity: XenoReviewSeverity;
3079
+ confidence: number;
3080
+ anchors: XenoArtifactAnchor[];
3081
+ evidence: XenoReviewEvidence[];
3082
+ remediation?: string;
3066
3083
  }
3067
- interface HookRunResult {
3068
- decision: HookDecision;
3069
- results: HookExecutionResult[];
3070
- context: string[];
3071
- systemMessages: string[];
3084
+ interface XenoReviewAgentResult {
3085
+ reviewerAgentId: string;
3086
+ dimension: XenoReviewDimension;
3087
+ findings: XenoReviewFindingProposal[];
3088
+ completedAt: string;
3072
3089
  }
3073
- interface HookRuntimeOptions {
3074
- defaultTimeoutMs?: number;
3075
- defaultMaxOutputBytes?: number;
3076
- env?: NodeJS.ProcessEnv;
3077
- permissionProfile?: PermissionProfile;
3078
- promptExecutor?: HookModelExecutor;
3079
- agentExecutor?: HookModelExecutor;
3090
+ interface XenoReviewVerificationResult {
3091
+ verifierAgentId: string;
3092
+ outcome: XenoReviewVerificationOutcome;
3093
+ rationale: string;
3094
+ evidence: XenoReviewEvidence[];
3095
+ confidence?: number;
3096
+ completedAt: string;
3080
3097
  }
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>;
3098
+ interface XenoReviewFinding {
3099
+ findingId: string;
3100
+ fingerprint: string;
3101
+ ruleIds: string[];
3102
+ dimensions: XenoReviewDimension[];
3103
+ reviewerAgentIds: string[];
3104
+ title: string;
3105
+ summary: string;
3106
+ severity: XenoReviewSeverity;
3107
+ confidence: number;
3108
+ state: XenoReviewFindingState;
3109
+ verificationBasis: "verifier" | "independent-evidence" | "none";
3110
+ anchors: XenoArtifactAnchor[];
3111
+ evidence: XenoReviewEvidence[];
3112
+ verifications: XenoReviewVerificationResult[];
3113
+ remediation?: string;
3114
+ duplicateProposalCount: number;
3093
3115
  }
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>;
3116
+ interface XenoReviewTarget {
3117
+ artifactId: string;
3118
+ revision: number;
3119
+ contentHash: XenoContentHash;
3120
+ title: string;
3121
+ repositoryId?: string;
3122
+ commit?: string;
3123
+ anchors?: XenoArtifactAnchor[];
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 XenoReviewPack {
3126
+ schemaVersion: "xeno.review-pack.v1";
3127
+ packId: string;
3128
+ version: string;
3129
+ dimensions: XenoReviewDimension[];
3130
+ verifierCount: number;
3131
+ minimumVerifierReproductions: number;
3132
+ allowIndependentEvidenceVerification: boolean;
3133
+ minimumIndependentEvidenceProducers: number;
3134
+ maxFindings: number;
3107
3135
  }
3108
- declare class HookRuntime {
3109
- private readonly config;
3110
- private readonly options;
3111
- constructor(config: HookConfig, options?: HookRuntimeOptions);
3112
- run(input: HookInvocationInput): Promise<HookRunResult>;
3136
+ interface XenoReviewReport {
3137
+ schemaVersion: typeof XENO_REVIEW_REPORT_SCHEMA_VERSION;
3138
+ reportId: string;
3139
+ runId: string;
3140
+ pack: XenoReviewPack;
3141
+ target: XenoReviewTarget;
3142
+ startedAt: string;
3143
+ completedAt: string;
3144
+ reviewers: Array<{
3145
+ agentId: string;
3146
+ dimension: XenoReviewDimension;
3147
+ findingCount: number;
3148
+ }>;
3149
+ findings: XenoReviewFinding[];
3150
+ summary: {
3151
+ total: number;
3152
+ verified: number;
3153
+ unverified: number;
3154
+ rejected: number;
3155
+ bySeverity: Record<XenoReviewSeverity, number>;
3156
+ };
3113
3157
  }
3114
- declare class CommandHookRunner {
3115
- private readonly options;
3116
- constructor(options?: HookRuntimeOptions);
3117
- run(definition: CommandHookDefinition, input: HookInvocationInput): Promise<HookExecutionResult>;
3158
+ interface XenoReviewCoordinatorContext {
3159
+ runId: string;
3160
+ target: XenoReviewTarget;
3161
+ pack: XenoReviewPack;
3118
3162
  }
3119
- declare class HttpHookRunner {
3120
- private readonly options;
3121
- constructor(options?: HookRuntimeOptions);
3122
- run(definition: HttpHookDefinition, input: HookInvocationInput): Promise<HookExecutionResult>;
3163
+ type XenoReviewAgentExecutor = (request: XenoReviewCoordinatorContext & {
3164
+ dimension: XenoReviewDimension;
3165
+ reviewerSlot: number;
3166
+ }) => Promise<XenoReviewAgentResult>;
3167
+ type XenoReviewVerifierExecutor = (request: XenoReviewCoordinatorContext & {
3168
+ finding: XenoReviewFinding;
3169
+ verifierSlot: number;
3170
+ }) => Promise<XenoReviewVerificationResult>;
3171
+ interface XenoMultiAgentReviewCoordinatorOptions {
3172
+ reviewer: XenoReviewAgentExecutor;
3173
+ verifier?: XenoReviewVerifierExecutor;
3174
+ now?: () => string;
3175
+ idFactory?: (prefix: "report" | "finding") => string;
3123
3176
  }
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;
3177
+ interface XenoReviewArtifactContext {
3178
+ producer: XenoArtifactActor;
3179
+ identity?: XenoArtifactIdentity;
3180
+ sensitivity?: XenoArtifactSensitivity;
3181
+ accessPolicyId?: string;
3182
+ artifactId?: string;
3183
+ createdAt?: string;
3131
3184
  }
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;
3185
+ interface XenoGitHubReviewComment {
3186
+ findingId: string;
3187
+ path: string;
3188
+ line?: number;
3189
+ body: string;
3190
+ severity: XenoReviewSeverity;
3191
+ verified: boolean;
3144
3192
  }
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;
3193
+ declare class XenoReviewValidationError extends Error {
3194
+ readonly issues: string[];
3195
+ readonly code = "XENO_REVIEW_INVALID";
3196
+ constructor(issues: string[]);
3175
3197
  }
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;
3198
+ declare class XenoMultiAgentReviewCoordinator {
3199
+ private readonly reviewer;
3200
+ private readonly verifier?;
3201
+ private readonly now;
3202
+ private readonly idFactory;
3203
+ constructor(options: XenoMultiAgentReviewCoordinatorOptions);
3204
+ run(context: XenoReviewCoordinatorContext): Promise<XenoReviewReport>;
3184
3205
  }
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;
3206
+ declare function defaultXenoReviewPack(packId?: string): XenoReviewPack;
3207
+ declare function assertValidXenoReviewPack(pack: XenoReviewPack): void;
3208
+ declare function assertValidXenoReviewTarget(target: XenoReviewTarget): void;
3209
+ declare function assertValidXenoReviewReport(report: XenoReviewReport): void;
3210
+ declare function xenoReviewReportToArtifact(report: XenoReviewReport, context: XenoReviewArtifactContext): XenoArtifactEnvelope;
3211
+ declare function xenoArtifactToReviewReport(artifact: XenoArtifactEnvelope): XenoReviewReport;
3212
+ declare function xenoReviewReportToGitHubComments(report: XenoReviewReport, options?: {
3213
+ verifiedOnly?: boolean;
3214
+ }): XenoGitHubReviewComment[];
3215
+ type AgentSelectionStrategy = "first" | "least-loaded" | "round-robin";
3216
+ interface AgentCard {
3217
+ id: string;
3218
+ name: string;
3219
+ description?: string;
3220
+ capabilities: string[];
3221
+ maxConcurrentTasks?: number;
3222
+ handler: AgentTaskHandler;
3223
+ }
3224
+ interface AgentTeam {
3225
+ id: string;
3226
+ name: string;
3227
+ description?: string;
3228
+ agentIds: string[];
3229
+ strategy?: AgentSelectionStrategy;
3230
+ }
3231
+ interface AgentLoadSnapshot {
3232
+ agentId: string;
3233
+ agentName: string;
3234
+ activeTasks: number;
3235
+ maxConcurrentTasks: number;
3236
+ availableSlots: number;
3237
+ isAvailable: boolean;
3238
+ }
3239
+ interface AgentTask {
3240
+ id: string;
3241
+ type: string;
3242
+ description: string;
3243
+ input: Record<string, unknown>;
3244
+ priority?: "low" | "normal" | "high" | "critical";
3245
+ createdAt: string;
3246
+ status: AgentTaskStatus;
3247
+ assignedTo?: string;
3248
+ createdBy?: string;
3249
+ parentTaskId?: string;
3250
+ timeoutMs?: number;
3251
+ }
3252
+ type AgentTaskStatus = "pending" | "assigned" | "running" | "completed" | "failed" | "cancelled" | "timeout";
3253
+ interface AgentTaskResult {
3254
+ taskId: string;
3255
+ status: "completed" | "failed" | "cancelled";
3256
+ result: unknown;
3257
+ error?: string;
3258
+ artifacts?: AgentArtifact[];
3259
+ durationMs?: number;
3260
+ }
3261
+ interface AgentArtifact {
3262
+ name: string;
3263
+ mimeType?: string;
3264
+ content: string;
3265
+ }
3266
+ type AgentTaskHandler = (task: AgentTask) => Promise<AgentTaskResult>;
3267
+ type A2AMessageType = "task-request" | "task-accepted" | "task-rejected" | "task-progress" | "task-completed" | "task-failed" | "capability-query" | "capability-response";
3268
+ interface A2AMessage {
3269
+ id: string;
3270
+ type: A2AMessageType;
3271
+ from: string;
3272
+ to: string;
3273
+ payload: Record<string, unknown>;
3274
+ timestamp: string;
3275
+ correlationId?: string;
3276
+ }
3277
+ interface AgentDispatchOptions {
3278
+ timeoutMs?: number;
3279
+ priority?: AgentTask["priority"];
3280
+ parentTaskId?: string;
3281
+ createdBy?: string;
3282
+ waitForCapacity?: boolean;
3283
+ maxQueueWaitMs?: number;
3284
+ }
3285
+ interface AgentCapabilityDispatchOptions extends AgentDispatchOptions {
3286
+ strategy?: AgentSelectionStrategy;
3287
+ teamId?: string;
3288
+ }
3289
+ declare class AgentRegistry {
3290
+ private agents;
3291
+ private teams;
3292
+ registerAgent(card: AgentCard): void;
3293
+ unregisterAgent(id: string): boolean;
3294
+ getAgent(id: string): AgentCard | undefined;
3295
+ findByCapability(capability: string): AgentCard[];
3296
+ listAgents(): AgentCard[];
3297
+ registerTeam(team: AgentTeam): void;
3298
+ unregisterTeam(id: string): boolean;
3299
+ getTeam(id: string): AgentTeam | undefined;
3300
+ listTeams(): AgentTeam[];
3301
+ listAgentsForTeam(teamId: string): AgentCard[];
3302
+ get size(): number;
3303
+ }
3304
+ declare class AgentProtocol {
3305
+ private registry;
3306
+ private messageLog;
3307
+ private activeTasks;
3308
+ private activeTasksByAgent;
3309
+ private capabilityRoundRobinCursor;
3310
+ constructor(registry: AgentRegistry);
3311
+ private getAgentCapacity;
3312
+ private getAgentActiveTaskCount;
3313
+ private isAgentAvailable;
3314
+ private reserveAgentTask;
3315
+ private releaseAgentTask;
3316
+ private waitForAgentCapacity;
3317
+ private getCapabilityCandidates;
3318
+ private compareAgentLoad;
3319
+ private selectAgentForCapability;
3320
+ getAgentLoad(agentId: string): AgentLoadSnapshot | undefined;
3321
+ listAgentLoads(options?: {
3322
+ capability?: string;
3323
+ teamId?: string;
3324
+ }): AgentLoadSnapshot[];
3325
+ delegateTask(agentId: string, taskSpec: {
3326
+ type: string;
3327
+ description: string;
3328
+ input: Record<string, unknown>;
3329
+ }, options?: AgentDispatchOptions): Promise<AgentTaskResult>;
3330
+ delegateByCapability(capability: string, taskSpec: {
3331
+ description: string;
3332
+ input: Record<string, unknown>;
3333
+ }, options?: AgentCapabilityDispatchOptions): Promise<AgentTaskResult>;
3334
+ delegateToTeam(teamId: string, taskSpec: {
3335
+ type: string;
3336
+ description: string;
3337
+ input: Record<string, unknown>;
3338
+ }, options?: Omit<AgentCapabilityDispatchOptions, "teamId">): Promise<AgentTaskResult>;
3339
+ getMessageLog(limit?: number): A2AMessage[];
3340
+ getActiveTasks(): AgentTask[];
3341
+ private logMessage;
3226
3342
  }
3227
- interface XenoResolvedApiKey {
3228
- apiKey: string;
3229
- source: XenoCredentialSource;
3230
- credentialType: XenoCredentialType;
3231
- expiresAt?: string;
3232
- expiresInMs?: number;
3343
+ interface FileSnapshot {
3344
+ path: string;
3345
+ exists: boolean;
3346
+ size: number;
3347
+ mtimeMs: number;
3348
+ text?: string;
3349
+ binary?: boolean;
3350
+ truncated?: boolean;
3233
3351
  }
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;
3352
+ interface TurnFileDiff {
3353
+ path: string;
3354
+ status: "created" | "modified" | "deleted" | "unchanged";
3355
+ before?: FileSnapshot;
3356
+ after?: FileSnapshot;
3357
+ patch?: string;
3242
3358
  }
3243
- interface ValidateXenoSdkApiKeyOptions {
3244
- apiKey: string;
3245
- apiBaseURL: string;
3246
- fetchImpl?: typeof fetch;
3359
+ interface TurnDiffSummary {
3360
+ turnId: string;
3361
+ startedAt: string;
3362
+ completedAt: string;
3363
+ files: TurnFileDiff[];
3247
3364
  }
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
- });
3365
+ interface TurnDiffTrackerOptions {
3366
+ maxFileBytes?: number;
3367
+ cwd?: string;
3254
3368
  }
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;
3369
+ declare class TurnDiffTracker {
3370
+ private active?;
3371
+ private readonly maxFileBytes;
3372
+ private readonly cwd;
3373
+ constructor(options?: TurnDiffTrackerOptions);
3374
+ beginTurn(turnId: string): void;
3375
+ observeBefore(paths: Iterable<string | null | undefined>): void;
3376
+ observeAfter(paths: Iterable<string | null | undefined>): void;
3377
+ endTurn(): TurnDiffSummary | undefined;
3378
+ inferToolPaths(toolName: string, input: Record<string, unknown>): string[];
3379
+ private resolvePath;
3380
+ private snapshot;
3285
3381
  }
3286
- interface LocalRuntimePreflightResult {
3287
- ok: boolean;
3382
+ interface XenoLegacyArtifactContext {
3383
+ artifactId?: string;
3384
+ revision?: number;
3385
+ createdAt?: string;
3386
+ producer: XenoArtifactActor;
3387
+ identity?: XenoArtifactIdentity;
3388
+ state?: XenoArtifactState;
3389
+ sensitivity?: XenoArtifactSensitivity;
3390
+ accessPolicyId?: string;
3391
+ }
3392
+ interface XenoLegacyAgentArtifactContext extends XenoLegacyArtifactContext {
3393
+ contentEncoding?: "utf8" | "base64";
3394
+ kind?: XenoArtifactKind;
3395
+ }
3396
+ declare function legacyAgentArtifactToXenoArtifact(legacy: AgentArtifact, context: XenoLegacyAgentArtifactContext): XenoArtifactEnvelope;
3397
+ declare function xenoArtifactToLegacyAgentArtifact(artifact: XenoArtifactEnvelope): AgentArtifact;
3398
+ declare function toolEvidenceToXenoArtifact(evidence: ToolEvidence, context: XenoLegacyArtifactContext): XenoArtifactEnvelope;
3399
+ declare function xenoArtifactToToolEvidence(artifact: XenoArtifactEnvelope): ToolEvidence;
3400
+ declare function turnDiffSummaryToXenoArtifact(summary: TurnDiffSummary, context: XenoLegacyArtifactContext): XenoArtifactEnvelope;
3401
+ declare function xenoArtifactToTurnDiffSummary(artifact: XenoArtifactEnvelope): TurnDiffSummary;
3402
+ type HookEventName = "SessionStart" | "UserPromptSubmit" | "PermissionRequest" | "PreToolUse" | "PostToolUse" | "PreCompact" | "PostCompact" | "Stop" | "StopFailure" | "SubagentStart" | "SubagentStop";
3403
+ type HookPermissionMode = AgentPermissionMode;
3404
+ interface HookInputBase {
3405
+ schemaVersion: 1;
3406
+ event: HookEventName;
3407
+ sessionId: string;
3408
+ runId: string;
3409
+ rootRunId: string;
3410
+ agentId: string;
3411
+ agentName?: string;
3412
+ agentColor?: string;
3413
+ parentAgentId?: string;
3414
+ cwd: string;
3415
+ transcriptPath?: string;
3416
+ permissionMode: HookPermissionMode;
3288
3417
  model: string;
3289
- baseUrl: string;
3290
- endpoint?: "openai" | "native";
3291
- warning?: string;
3292
- error?: string;
3418
+ effort?: string;
3419
+ timestamp: string;
3293
3420
  }
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;
3421
+ interface HookInvocationInput extends HookInputBase {
3422
+ prompt?: string;
3423
+ toolName?: string;
3424
+ toolInput?: Record<string, unknown>;
3425
+ toolResult?: unknown;
3426
+ finalText?: string;
3427
+ metadata?: Record<string, unknown>;
3428
+ }
3429
+ type HookDecision = {
3430
+ decision: "allow";
3431
+ systemMessage?: string;
3432
+ context?: string;
3433
+ } | {
3434
+ decision: "block";
3435
+ reason: string;
3436
+ systemMessage?: string;
3437
+ } | {
3438
+ decision: "ask";
3439
+ reason: string;
3440
+ prompt: string;
3441
+ } | {
3442
+ decision: "modify";
3443
+ patch: unknown;
3444
+ reason?: string;
3445
+ } | {
3446
+ decision: "continue";
3447
+ context?: string;
3448
+ systemMessage?: string;
3449
+ };
3450
+ interface BaseHookDefinition {
3451
+ name?: string;
3452
+ events?: HookEventName[];
3304
3453
  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;
3454
+ maxOutputBytes?: number;
3455
+ failClosed?: boolean;
3456
+ async?: boolean;
3457
+ }
3458
+ interface CommandHookDefinition extends BaseHookDefinition {
3459
+ type: "command";
3312
3460
  command: string;
3313
3461
  args?: string[];
3314
- env?: Record<string, string>;
3315
3462
  cwd?: string;
3463
+ shell?: boolean;
3464
+ env?: Record<string, string>;
3316
3465
  }
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[];
3466
+ interface HttpHookDefinition extends BaseHookDefinition {
3467
+ type: "http";
3468
+ url: string;
3469
+ method?: "POST";
3470
+ headers?: Record<string, string>;
3326
3471
  }
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;
3472
+ interface PromptHookDefinition extends BaseHookDefinition {
3473
+ type: "prompt";
3474
+ prompt: string;
3342
3475
  }
3343
- interface ProjectConfig {
3476
+ interface AgentHookDefinition extends BaseHookDefinition {
3477
+ type: "agent";
3478
+ prompt: string;
3479
+ agent?: string;
3344
3480
  model?: string;
3345
- systemPrompt?: string;
3346
- permissions?: {
3347
- allowedCommands?: string[];
3348
- deniedCommands?: string[];
3349
- };
3350
- ignorePatterns?: string[];
3351
3481
  }
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;
3482
+ type HookDefinition = CommandHookDefinition | HttpHookDefinition | PromptHookDefinition | AgentHookDefinition;
3483
+ type HookInput = HookInvocationInput;
3484
+ interface HookConfig {
3485
+ hooks?: HookDefinition[];
3486
+ events?: Partial<Record<HookEventName, HookDefinition[]>>;
3487
+ }
3488
+ type HookModelExecutor = (definition: PromptHookDefinition | AgentHookDefinition, input: HookInvocationInput) => HookDecision | Promise<HookDecision>;
3489
+ type HookExecutionStatus = "allowed" | "blocked" | "asked" | "modified" | "continued" | "errored" | "timed_out";
3490
+ interface HookExecutionResult {
3491
+ hook: HookDefinition;
3492
+ status: HookExecutionStatus;
3493
+ decision?: HookDecision;
3494
+ exitCode?: number | null;
3495
+ signal?: NodeJS.Signals | null;
3496
+ stdout: string;
3497
+ stderr: string;
3498
+ stdoutTruncated: boolean;
3499
+ stderrTruncated: boolean;
3500
+ timedOut: boolean;
3501
+ durationMs: number;
3502
+ error?: string;
3503
+ }
3504
+ interface HookRunResult {
3505
+ decision: HookDecision;
3506
+ results: HookExecutionResult[];
3507
+ context: string[];
3508
+ systemMessages: string[];
3362
3509
  }
3363
- interface SessionSummary {
3364
- id: string;
3365
- createdAt: string;
3366
- updatedAt: string;
3367
- model: string;
3368
- workingDirectory: string;
3369
- preview: string;
3370
- messageCount: number;
3510
+ interface HookRuntimeOptions {
3511
+ defaultTimeoutMs?: number;
3512
+ defaultMaxOutputBytes?: number;
3513
+ env?: NodeJS.ProcessEnv;
3514
+ permissionProfile?: PermissionProfile;
3515
+ promptExecutor?: HookModelExecutor;
3516
+ agentExecutor?: HookModelExecutor;
3371
3517
  }
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";
3518
+ declare function normalizeHookDecision(value: unknown): HookDecision;
3519
+ declare function buildHookEnvironment(input: HookInvocationInput, definition: CommandHookDefinition, sourceEnv?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
3520
+ declare function hookResultStatus(decision: HookDecision | undefined): HookExecutionResult["status"];
3521
+ declare function runCommandHook(definition: CommandHookDefinition, input: HookInvocationInput, options?: HookRuntimeOptions): Promise<HookExecutionResult>;
3522
+ declare function runHttpHook(definition: HttpHookDefinition, input: HookInvocationInput, options?: HookRuntimeOptions): Promise<HookExecutionResult>;
3523
+ declare function runPromptHook(definition: PromptHookDefinition, input: HookInvocationInput, options?: HookRuntimeOptions): Promise<HookExecutionResult>;
3524
+ declare function runAgentHook(definition: AgentHookDefinition, input: HookInvocationInput, options?: HookRuntimeOptions): Promise<HookExecutionResult>;
3525
+ declare class PromptHookRunner {
3526
+ private readonly executor;
3527
+ private readonly options;
3528
+ constructor(executor: HookModelExecutor, options?: HookRuntimeOptions);
3529
+ run(definition: PromptHookDefinition, input: HookInvocationInput): Promise<HookExecutionResult>;
3389
3530
  }
3390
- interface ResolvedProvider {
3391
- provider: ModelProvider;
3392
- model: string;
3393
- baseURL: string;
3394
- apiKey: string;
3395
- headers: Record<string, string>;
3531
+ declare class AgentHookRunner {
3532
+ private readonly executor;
3533
+ private readonly options;
3534
+ constructor(executor: HookModelExecutor, options?: HookRuntimeOptions);
3535
+ run(definition: AgentHookDefinition, input: HookInvocationInput): Promise<HookExecutionResult>;
3396
3536
  }
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;
3537
+ declare function runHookDefinition(hook: HookDefinition, input: HookInvocationInput, options?: HookRuntimeOptions): Promise<HookExecutionResult>;
3538
+ declare function runHooks(hooks: readonly HookDefinition[], input: HookInvocationInput, options?: HookRuntimeOptions): Promise<HookRunResult>;
3539
+ declare class HookRunner {
3540
+ private readonly hooks;
3541
+ private readonly options;
3542
+ constructor(hooks: readonly HookDefinition[], options?: HookRuntimeOptions);
3543
+ run(input: HookInvocationInput): Promise<HookRunResult>;
3409
3544
  }
3410
- declare function getDefaultProviderRegistry(): ModelProviderRegistry;
3411
- interface MemoryFile {
3412
- level: MemoryLevel;
3413
- path: string;
3414
- content: string;
3415
- tokenCount: number;
3416
- lastModified?: Date;
3545
+ declare class HookRuntime {
3546
+ private readonly config;
3547
+ private readonly options;
3548
+ constructor(config: HookConfig, options?: HookRuntimeOptions);
3549
+ run(input: HookInvocationInput): Promise<HookRunResult>;
3417
3550
  }
3418
- interface ResolvedMemory {
3419
- files: MemoryFile[];
3420
- byLevel: Record<MemoryLevel, string>;
3421
- totalTokens: number;
3422
- truncated: boolean;
3551
+ declare class CommandHookRunner {
3552
+ private readonly options;
3553
+ constructor(options?: HookRuntimeOptions);
3554
+ run(definition: CommandHookDefinition, input: HookInvocationInput): Promise<HookExecutionResult>;
3423
3555
  }
3424
- interface ProjectSessionContextEntry {
3425
- sessionId: string;
3426
- model: string;
3427
- lastActivity: string;
3428
- messageCount: number;
3429
- excerpt: string;
3556
+ declare class HttpHookRunner {
3557
+ private readonly options;
3558
+ constructor(options?: HookRuntimeOptions);
3559
+ run(definition: HttpHookDefinition, input: HookInvocationInput): Promise<HookExecutionResult>;
3430
3560
  }
3431
- interface ProjectSessionContext {
3432
- entries: ProjectSessionContextEntry[];
3433
- totalTokens: number;
3434
- truncated: boolean;
3435
- content: string;
3561
+ declare const CONFIG_VERSION = 2;
3562
+ declare const PROJECT_STATE_VERSION = 3;
3563
+ type ProjectMcpApprovalDecision = "approved" | "denied";
3564
+ interface ProjectTokenUsageSummary {
3565
+ input: number;
3566
+ output: number;
3567
+ total: number;
3436
3568
  }
3437
- declare const DEFAULT_MEMORY_BUDGETS: MemoryBudget;
3438
- declare const MEMORY_FILES: Record<MemoryLevel, string>;
3439
- interface MemoryManagerOptions {
3440
- cwd: string;
3441
- globalDir?: string;
3569
+ interface ProjectSessionSummary {
3570
+ sessionId?: string;
3571
+ mode?: "chat" | "run" | "save";
3572
+ status?: string;
3442
3573
  role?: string;
3443
- sessionDir?: string;
3444
- scope?: MemoryAccessScope;
3445
- budgets?: Partial<MemoryBudget>;
3446
- projectSessionContext?: {
3447
- limit?: number;
3448
- maxTokens?: number;
3449
- maxCharsPerSession?: number;
3450
- };
3574
+ model: string;
3575
+ startedAt: string;
3576
+ endedAt: string;
3577
+ durationMs: number;
3578
+ messageCount?: number;
3579
+ tokenUsage: ProjectTokenUsageSummary;
3580
+ estimatedCostUsd: number;
3451
3581
  }
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;
3582
+ interface XenoUserConfig {
3583
+ configVersion?: number;
3584
+ apiKey?: string;
3585
+ model?: string;
3586
+ effort?: AgentEffortLevel;
3587
+ fallbackModels?: string[];
3588
+ worktree?: {
3589
+ enabledForBackgroundRuns?: boolean;
3590
+ baseRef?: string;
3591
+ root?: string;
3592
+ cleanupCompletedAfterDays?: number;
3469
3593
  };
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;
3594
+ baseURL?: string;
3595
+ maxTokens?: number;
3596
+ maxIterations?: number;
3597
+ permissionMode?: "default" | "acceptEdits" | "bypassPermissions" | "auto";
3598
+ permissionProfile?: "default" | "read-only" | "trusted-dev";
3599
+ executionMode?: "agent" | "chatOnly";
3600
+ uiColor?: string;
3601
+ outputStyle?: string;
3602
+ memoryContextSessions?: number;
3603
+ memoryContextTokens?: number;
3604
+ memoryContextChars?: number;
3605
+ searchApiKey?: string;
3606
+ searchProvider?: "brave" | "google" | "searxng" | "duckduckgo";
3607
+ searxngUrl?: string;
3608
+ googleCx?: string;
3609
+ mcpEnabled?: boolean;
3610
+ lastReleaseNotesSeen?: string;
3611
+ terminalShiftEnterInstalled?: boolean;
3505
3612
  }
3506
- interface VectorDocument {
3507
- id: string;
3508
- content: string;
3509
- embedding: number[];
3510
- metadata: Record<string, unknown>;
3613
+ interface XenoProjectState {
3614
+ configVersion?: number;
3615
+ trustedWorkspace?: boolean;
3616
+ allowedTools?: string[];
3617
+ allowedDirectories?: string[];
3618
+ mcpApprovals?: Record<string, ProjectMcpApprovalDecision>;
3619
+ lastSessionSummary?: ProjectSessionSummary;
3620
+ hasCompletedProjectOnboarding?: boolean;
3511
3621
  }
3512
- interface VectorSearchResult {
3513
- id: string;
3514
- content: string;
3515
- score: number;
3516
- metadata: Record<string, unknown>;
3622
+ declare function getConfigDir(): string;
3623
+ declare function getAgentHome(): string;
3624
+ declare function getManagedConfigPath(): string | undefined;
3625
+ declare function getProjectStatePath(cwd?: string): string;
3626
+ declare function ensureProjectStateDir(cwd?: string): void;
3627
+ declare function loadProjectState(cwd?: string): XenoProjectState;
3628
+ declare function saveProjectState(cwd: string, updates: Partial<XenoProjectState>): void;
3629
+ declare function updateProjectState(cwd: string, updater: (current: XenoProjectState) => XenoProjectState): XenoProjectState;
3630
+ declare function isWorkspaceTrusted(cwd?: string): boolean;
3631
+ declare function setWorkspaceTrusted(cwd?: string, trusted?: boolean): void;
3632
+ declare function hasProjectOnboardingCompleted(cwd?: string): boolean;
3633
+ declare function setProjectOnboardingCompleted(cwd?: string, completed?: boolean): void;
3634
+ declare function addProjectAllowedTool(cwd: string, approvalKey: string): XenoProjectState;
3635
+ declare function listProjectAllowedTools(cwd: string): string[];
3636
+ declare function removeProjectAllowedTool(cwd: string, approvalKey: string): XenoProjectState;
3637
+ declare function clearProjectAllowedTools(cwd: string): XenoProjectState;
3638
+ declare function addProjectAllowedDirectory(cwd: string, directory: string): XenoProjectState;
3639
+ declare function getProjectMcpApproval(cwd: string, approvalKey: string): ProjectMcpApprovalDecision | undefined;
3640
+ declare function setProjectMcpApproval(cwd: string, approvalKey: string, decision: ProjectMcpApprovalDecision): XenoProjectState;
3641
+ declare function clearProjectMcpApproval(cwd: string, approvalKey: string): XenoProjectState;
3642
+ declare function listProjectMcpApprovals(cwd: string, scope?: string): Record<string, ProjectMcpApprovalDecision>;
3643
+ declare function clearProjectMcpApprovals(cwd: string, scope?: string): XenoProjectState;
3644
+ declare function getProjectLastSessionSummary(cwd?: string): ProjectSessionSummary | undefined;
3645
+ declare function setProjectLastSessionSummary(cwd: string, summary: ProjectSessionSummary): XenoProjectState;
3646
+ declare function clearProjectLastSessionSummary(cwd: string): XenoProjectState;
3647
+ declare function ensureConfigDir(): void;
3648
+ declare function loadConfig(): XenoUserConfig;
3649
+ declare function loadUserConfig(): XenoUserConfig;
3650
+ declare function saveConfig(updates: Partial<XenoUserConfig>): void;
3651
+ type XenoCredentialType = "api-key" | "jwt" | "empty";
3652
+ type XenoCredentialSource = "explicit" | "env" | "default" | "none";
3653
+ type XenoAuthErrorCode = "token_expired" | "token_not_active" | "token_malformed";
3654
+ interface XenoJwtPayload {
3655
+ exp?: number;
3656
+ iat?: number;
3657
+ nbf?: number;
3658
+ sub?: string;
3659
+ userId?: string;
3660
+ email?: string;
3661
+ username?: string;
3662
+ [key: string]: unknown;
3517
3663
  }
3518
- interface VectorStoreOptions {
3519
- maxDocuments?: number;
3520
- embeddingDimension?: number;
3521
- embedFn?: (text: string) => Promise<number[]>;
3664
+ interface XenoResolvedApiKey {
3665
+ apiKey: string;
3666
+ source: XenoCredentialSource;
3667
+ credentialType: XenoCredentialType;
3668
+ expiresAt?: string;
3669
+ expiresInMs?: number;
3522
3670
  }
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;
3671
+ interface ResolveXenoSdkApiKeyOptions {
3672
+ explicitApiKey?: string;
3673
+ env?: Record<string, string | undefined>;
3674
+ envVar?: string;
3675
+ defaultApiKey?: string;
3676
+ nowMs?: number;
3677
+ skewMs?: number;
3678
+ allowExpired?: boolean;
3531
3679
  }
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;
3680
+ interface ValidateXenoSdkApiKeyOptions {
3681
+ apiKey: string;
3682
+ apiBaseURL: string;
3683
+ fetchImpl?: typeof fetch;
3547
3684
  }
3548
- interface AskUserRequest {
3549
- question: string;
3550
- options?: string[];
3551
- context?: string;
3685
+ declare class XenoAuthError extends Error {
3686
+ readonly code: XenoAuthErrorCode;
3687
+ readonly expiresAt?: string;
3688
+ constructor(message: string, code: XenoAuthErrorCode, context?: {
3689
+ expiresAt?: string;
3690
+ });
3552
3691
  }
3553
- interface AskUserResponse {
3554
- answer: string;
3555
- selectedOption?: string;
3692
+ declare function isJwt(value: string | undefined): value is string;
3693
+ declare function decodeJwtPayload(token: string | undefined): XenoJwtPayload | undefined;
3694
+ declare function getJwtExpiry(token: string | undefined): Date | undefined;
3695
+ declare function isExpiredJwt(token: string | undefined, nowMs?: number, skewMs?: number): boolean;
3696
+ declare function isNotBeforeJwt(token: string | undefined, nowMs?: number, skewMs?: number): boolean;
3697
+ declare function assertUsableXenoApiKey(apiKey: string | undefined, options?: {
3698
+ nowMs?: number;
3699
+ skewMs?: number;
3700
+ allowExpired?: boolean;
3701
+ }): string;
3702
+ declare function resolveXenoSdkApiKey(options?: ResolveXenoSdkApiKeyOptions): XenoResolvedApiKey;
3703
+ declare function validateXenoSdkApiKey(options: ValidateXenoSdkApiKeyOptions): Promise<{
3704
+ valid: boolean;
3705
+ error?: string;
3706
+ }>;
3707
+ declare const DEFAULT_API_KEY: string;
3708
+ declare const XENO_API_BASE: string;
3709
+ declare const XENO_RT_DEFAULT_URL: string;
3710
+ declare const DEFAULT_MODEL: string;
3711
+ declare const FALLBACK_MODELS: readonly string[];
3712
+ interface ModelInfo {
3713
+ id: string;
3714
+ name: string;
3715
+ owned_by: string;
3716
+ source: "xeno" | "local";
3717
+ type?: string;
3718
+ output_modalities?: string[];
3719
+ available?: boolean;
3720
+ contextWindow?: number;
3721
+ maxCompletionTokens?: number;
3556
3722
  }
3557
- type AskUserHandler = (request: AskUserRequest) => Promise<AskUserResponse>;
3558
- interface DispatchAgentRequest {
3559
- agent?: string;
3560
- prompt: string;
3723
+ interface LocalRuntimePreflightResult {
3724
+ ok: boolean;
3725
+ model: string;
3726
+ baseUrl: string;
3727
+ endpoint?: "openai" | "native";
3728
+ warning?: string;
3729
+ error?: string;
3730
+ }
3731
+ declare function cachedModelContextWindow(modelId: string): number | undefined;
3732
+ declare function getAvailableModels(options?: {
3733
+ apiKey?: string;
3734
+ localRuntimeUrl?: string;
3735
+ forceRefresh?: boolean;
3736
+ }): Promise<ModelInfo[]>;
3737
+ declare function isLocalModel(model: string): boolean;
3738
+ declare function getModelName(model: string): string;
3739
+ declare function preflightLocalModel(model: string, options?: {
3740
+ localRuntimeUrl?: string;
3561
3741
  timeoutMs?: number;
3562
- signal?: AbortSignal;
3742
+ }): Promise<LocalRuntimePreflightResult>;
3743
+ declare function isValidModel(model: string, apiKey?: string, forceRefresh?: boolean): Promise<boolean>;
3744
+ declare function isChatModel(model: ModelInfo): boolean;
3745
+ declare function getChatModels(apiKey?: string, forceRefresh?: boolean): Promise<ModelInfo[]>;
3746
+ declare function formatModelList(apiKey?: string, showAll?: boolean, forceRefresh?: boolean): Promise<string>;
3747
+ interface ProfileMCPServerConfig {
3748
+ name: string;
3749
+ command: string;
3750
+ args?: string[];
3751
+ env?: Record<string, string>;
3752
+ cwd?: string;
3563
3753
  }
3564
- interface DispatchAgentResponse {
3565
- output: string;
3754
+ interface ConfigProfile {
3755
+ name: string;
3756
+ apiKey?: string;
3757
+ baseURL?: string;
3758
+ model?: string;
3759
+ maxTokens?: number;
3760
+ permissionMode?: "default" | "acceptEdits" | "bypassPermissions" | "auto";
3761
+ plugins?: string[];
3762
+ mcpServers?: ProfileMCPServerConfig[];
3566
3763
  }
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;
3764
+ declare class ProfileManager {
3765
+ private data;
3766
+ private filePath;
3767
+ constructor();
3768
+ listProfiles(): ConfigProfile[];
3769
+ getActiveProfile(): ConfigProfile;
3770
+ getActiveProfileName(): string;
3771
+ switchProfile(name: string): void;
3772
+ createProfile(profile: ConfigProfile): void;
3773
+ deleteProfile(name: string): void;
3774
+ updateProfile(name: string, updates: Partial<ConfigProfile>): void;
3775
+ getProfile(name: string): ConfigProfile | undefined;
3776
+ reload(): void;
3777
+ private load;
3778
+ private save;
3575
3779
  }
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>;
3780
+ interface ProjectConfig {
3781
+ model?: string;
3782
+ systemPrompt?: string;
3783
+ permissions?: {
3784
+ allowedCommands?: string[];
3785
+ deniedCommands?: string[];
3786
+ };
3787
+ ignorePatterns?: string[];
3588
3788
  }
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 {
3789
+ declare function loadProjectConfig(cwd?: string): ProjectConfig | null;
3790
+ declare function mergeConfigs(base: ProjectConfig, override: ProjectConfig): ProjectConfig;
3791
+ interface SessionData {
3598
3792
  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[];
3793
+ model: string;
3794
+ workingDirectory: string;
3795
+ createdAt: string;
3796
+ updatedAt: string;
3797
+ messages: Message[];
3798
+ totalTokensUsed: number;
3619
3799
  }
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;
3800
+ interface SessionSummary {
3801
+ id: string;
3802
+ createdAt: string;
3803
+ updatedAt: string;
3804
+ model: string;
3805
+ workingDirectory: string;
3806
+ preview: string;
3807
+ messageCount: number;
3639
3808
  }
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[];
3809
+ declare function saveSession(id: string | null, messages: Message[], model: string, totalTokensUsed: number): string;
3810
+ declare function loadSession(id: string): SessionData | null;
3811
+ declare function listSessions(limit?: number): SessionSummary[];
3812
+ declare function deleteSession(id: string): boolean;
3813
+ interface ModelProvider {
3814
+ id: string;
3815
+ name: string;
3816
+ baseURL: string;
3817
+ apiKeyEnvVar: string;
3818
+ defaultApiKey?: string;
3819
+ modelPrefixes: string[];
3820
+ models: string[];
3821
+ supportsStreaming: boolean;
3822
+ supportsToolUse: boolean;
3823
+ maxContextTokens?: number;
3824
+ headers?: Record<string, string>;
3825
+ requestFormat?: "openai" | "google";
3657
3826
  }
3658
- interface ToolRegistryOptions {
3659
- validateInputs?: boolean;
3660
- toolSchemaMode?: "all" | "demand";
3827
+ interface ResolvedProvider {
3828
+ provider: ModelProvider;
3829
+ model: string;
3830
+ baseURL: string;
3831
+ apiKey: string;
3832
+ headers: Record<string, string>;
3661
3833
  }
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;
3834
+ declare function resolveModelContextTokens(model: string): number | undefined;
3835
+ declare class ModelProviderRegistry {
3836
+ private providers;
3837
+ constructor();
3838
+ addProvider(provider: ModelProvider): void;
3839
+ removeProvider(id: string): boolean;
3840
+ getProvider(id: string): ModelProvider | undefined;
3841
+ listProviders(): ModelProvider[];
3842
+ resolveProvider(model: string, overrides?: {
3843
+ apiKey?: string;
3844
+ baseURL?: string;
3845
+ }): ResolvedProvider;
3697
3846
  }
3698
- declare function createDefaultToolRegistry(options?: DefaultToolRegistryOptions): ToolRegistry;
3699
- declare const registry: ToolRegistry;
3847
+ declare function getDefaultProviderRegistry(): ModelProviderRegistry;
3700
3848
  interface PermissionDecisionEvent {
3701
3849
  traceId?: string;
3702
3850
  toolName: string;
@@ -4753,11 +4901,12 @@ interface SessionResumeOptions {
4753
4901
  }
4754
4902
  type SessionRecoverySource = "transcript" | "checkpoint" | "empty";
4755
4903
  interface SessionRecoveryIssue {
4756
- code: "torn_transcript_tail" | "invalid_transcript_event" | "non_monotonic_sequence" | "interrupted_tool_call" | "checkpoint_fallback" | "divergent_checkpoint" | "stale_metadata";
4904
+ code: "torn_transcript_tail" | "invalid_transcript_event" | "non_monotonic_sequence" | "interrupted_tool_call" | "checkpoint_fallback" | "divergent_checkpoint" | "stale_metadata" | "invalid_compaction_snapshot";
4757
4905
  detail: string;
4758
4906
  }
4759
4907
  interface SessionRecoveryResult {
4760
4908
  messages: Message[];
4909
+ transcriptMessages: Message[];
4761
4910
  source: SessionRecoverySource;
4762
4911
  sourceId?: string;
4763
4912
  issues: SessionRecoveryIssue[];
@@ -4780,6 +4929,7 @@ declare class SessionManager {
4780
4929
  private _checkpoints;
4781
4930
  private _lock;
4782
4931
  private _recovery;
4932
+ private _detachedForHandoff;
4783
4933
  private constructor();
4784
4934
  static create(options: SessionCreateOptions): Promise<SessionManager>;
4785
4935
  static resume(options: SessionResumeOptions): Promise<SessionManager>;
@@ -4787,6 +4937,8 @@ declare class SessionManager {
4787
4937
  get transcript(): TranscriptWriter;
4788
4938
  get checkpoints(): CheckpointManager;
4789
4939
  get recovery(): SessionRecoveryResult;
4940
+ detachForHandoff(): Promise<void>;
4941
+ get detachedForHandoff(): boolean;
4790
4942
  updateMeta(partial: Partial<SessionMeta>): Promise<void>;
4791
4943
  end(status?: "completed" | "abandoned"): Promise<void>;
4792
4944
  recordUserMessage(content: string): Promise<void>;
@@ -5171,7 +5323,7 @@ interface MessageFlowDeps {
5171
5323
  readonly tokenAccountingAdapter?: TokenAccountingAdapter;
5172
5324
  readonly historyMarkdownPath?: string;
5173
5325
  buildRuntimeSystemPrompt(): string;
5174
- onContextCompressed(messagesRemoved: number, tokensSaved: number, record: CompactionRecord): Promise<void>;
5326
+ onContextCompressed(messagesRemoved: number, tokensSaved: number, record: CompactionRecord, activeContextMessages: Message[]): Promise<void>;
5175
5327
  onToolHistoryRepaired?(diagnostic: ToolHistoryRepairDiagnostic): void;
5176
5328
  }
5177
5329
  declare class MessageFlow {
@@ -7326,7 +7478,7 @@ interface XenoControlRoomMonitorInput {
7326
7478
  }
7327
7479
  interface XenoControlRoomGoalInput {
7328
7480
  goalId: string;
7329
- status: "active" | "complete" | "blocked" | "cancelled" | "expired";
7481
+ status: "active" | "complete" | "blocked" | "cancelled" | "failed" | "expired";
7330
7482
  condition: string;
7331
7483
  runId?: string;
7332
7484
  updatedAt: string;
@@ -8140,6 +8292,400 @@ declare class FileXenoShareRegistry {
8140
8292
  load(): Promise<XenoShareRegistrySnapshot>;
8141
8293
  private mutate;
8142
8294
  }
8295
+ declare const XENO_COORDINATION_SCHEMA_VERSION: 1;
8296
+ type XenoGoalStatus = "active" | "paused" | "waiting" | "blocked" | "completed" | "failed" | "cancelled";
8297
+ type XenoGoalTaskStatus = "pending" | "ready" | "running" | "blocked" | "failed" | "completed" | "cancelled" | "interrupted";
8298
+ interface XenoGoalCriterion {
8299
+ id: string;
8300
+ description: string;
8301
+ required: boolean;
8302
+ }
8303
+ interface XenoGoalCriterionResult {
8304
+ criterionId: string;
8305
+ satisfied: boolean;
8306
+ evidence: string[];
8307
+ reason: string;
8308
+ evaluatedAt: string;
8309
+ }
8310
+ interface XenoGoalVerification {
8311
+ status: "pending" | "running" | "passed" | "failed";
8312
+ criteria: XenoGoalCriterionResult[];
8313
+ evidence: string[];
8314
+ summary?: string;
8315
+ verifiedAt?: string;
8316
+ verifiedBy?: string;
8317
+ }
8318
+ interface XenoGoalTask {
8319
+ id: string;
8320
+ milestoneId: string;
8321
+ parentTaskId?: string;
8322
+ title: string;
8323
+ description?: string;
8324
+ status: XenoGoalTaskStatus;
8325
+ assignedAgentId?: string;
8326
+ dependsOn?: string[];
8327
+ progress?: string;
8328
+ resultEventId?: string;
8329
+ createdAt: string;
8330
+ updatedAt: string;
8331
+ completedAt?: string;
8332
+ }
8333
+ interface XenoGoalMilestone {
8334
+ id: string;
8335
+ title: string;
8336
+ description?: string;
8337
+ status: "pending" | "active" | "blocked" | "completed" | "cancelled";
8338
+ taskIds: string[];
8339
+ createdAt: string;
8340
+ updatedAt: string;
8341
+ completedAt?: string;
8342
+ }
8343
+ interface XenoGoalProgress {
8344
+ summary: string;
8345
+ currentMilestoneId?: string;
8346
+ currentTaskId?: string;
8347
+ completedTaskCount: number;
8348
+ totalTaskCount: number;
8349
+ percent?: number;
8350
+ outstanding: string[];
8351
+ decisions: string[];
8352
+ updatedAt: string;
8353
+ }
8354
+ interface XenoGoalRecord {
8355
+ schemaVersion: typeof XENO_COORDINATION_SCHEMA_VERSION;
8356
+ id: string;
8357
+ version: number;
8358
+ sessionId: string;
8359
+ objective: string;
8360
+ why?: string;
8361
+ successCriteria: XenoGoalCriterion[];
8362
+ constraints: string[];
8363
+ limits?: {
8364
+ maxIterations?: number;
8365
+ maxTokens?: number;
8366
+ maxWallClockMs?: number;
8367
+ };
8368
+ metadata: Record<string, string | number | boolean>;
8369
+ status: XenoGoalStatus;
8370
+ milestones: XenoGoalMilestone[];
8371
+ tasks: XenoGoalTask[];
8372
+ progress: XenoGoalProgress;
8373
+ verification: XenoGoalVerification;
8374
+ steering: Array<{
8375
+ id: string;
8376
+ instruction: string;
8377
+ createdAt: string;
8378
+ consumedAt?: string;
8379
+ }>;
8380
+ createdAt: string;
8381
+ updatedAt: string;
8382
+ completedAt?: string;
8383
+ }
8384
+ type XenoLoopKind = "agentic-development" | "goal-continuation" | "scheduled";
8385
+ type XenoLoopStatus = "running" | "paused" | "waiting" | "stopped" | "completed" | "failed";
8386
+ interface XenoLoopSchedule {
8387
+ kind: "fixed-interval" | "dynamic";
8388
+ intervalMs?: number;
8389
+ nextRunAt?: string;
8390
+ expiresAt?: string;
8391
+ }
8392
+ interface XenoLoopIteration {
8393
+ number: number;
8394
+ startedAt: string;
8395
+ completedAt?: string;
8396
+ status: "running" | "completed" | "failed" | "interrupted";
8397
+ activity: string;
8398
+ taskId?: string;
8399
+ verificationEventId?: string;
8400
+ error?: string;
8401
+ }
8402
+ interface XenoLoopRecord {
8403
+ schemaVersion: typeof XENO_COORDINATION_SCHEMA_VERSION;
8404
+ id: string;
8405
+ version: number;
8406
+ sessionId: string;
8407
+ goalId?: string;
8408
+ kind: XenoLoopKind;
8409
+ status: XenoLoopStatus;
8410
+ currentActivity?: string;
8411
+ iterations: XenoLoopIteration[];
8412
+ schedule?: XenoLoopSchedule;
8413
+ stopReason?: string;
8414
+ createdAt: string;
8415
+ updatedAt: string;
8416
+ stoppedAt?: string;
8417
+ }
8418
+ type XenoHandoffStatus = "prepared" | "available" | "claimed" | "completed" | "failed" | "cancelled";
8419
+ interface XenoHandoffOperation {
8420
+ operationId: string;
8421
+ kind: "tool" | "command" | "build" | "subagent" | "other";
8422
+ status: "running" | "completed" | "interrupted";
8423
+ sideEffecting: boolean;
8424
+ recovery: "waited" | "resume" | "retry" | "manual";
8425
+ }
8426
+ interface XenoHandoffRecord {
8427
+ schemaVersion: typeof XENO_COORDINATION_SCHEMA_VERSION;
8428
+ id: string;
8429
+ version: number;
8430
+ sessionId: string;
8431
+ goalId?: string;
8432
+ loopId?: string;
8433
+ status: XenoHandoffStatus;
8434
+ sourceOwnerId: string;
8435
+ targetOwnerId?: string;
8436
+ claimedBy?: string;
8437
+ sourceLeaseEpoch: number;
8438
+ targetLeaseEpoch?: number;
8439
+ workspace?: string;
8440
+ branch?: string;
8441
+ currentMilestoneId?: string;
8442
+ currentTaskId?: string;
8443
+ agentIds: string[];
8444
+ operations: XenoHandoffOperation[];
8445
+ contextDigest?: string;
8446
+ createdAt: string;
8447
+ updatedAt: string;
8448
+ claimedAt?: string;
8449
+ completedAt?: string;
8450
+ failedAt?: string;
8451
+ failureReason?: string;
8452
+ }
8453
+ interface XenoExecutionOwner {
8454
+ ownerId: string;
8455
+ leaseId: string;
8456
+ epoch: number;
8457
+ acquiredAt: string;
8458
+ heartbeatAt: string;
8459
+ expiresAt: string;
8460
+ processId?: number;
8461
+ host?: string;
8462
+ }
8463
+ 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";
8464
+ interface XenoCoordinationEvent {
8465
+ schemaVersion: typeof XENO_COORDINATION_SCHEMA_VERSION;
8466
+ id: string;
8467
+ sequence: number;
8468
+ type: XenoCoordinationEventType;
8469
+ sessionId: string;
8470
+ goalId?: string;
8471
+ loopId?: string;
8472
+ handoffId?: string;
8473
+ ownerId?: string;
8474
+ timestamp: string;
8475
+ data: Record<string, unknown>;
8476
+ }
8477
+ interface XenoCoordinationSessionState {
8478
+ schemaVersion: typeof XENO_COORDINATION_SCHEMA_VERSION;
8479
+ sessionId: string;
8480
+ version: number;
8481
+ ownershipEpoch: number;
8482
+ owner?: XenoExecutionOwner;
8483
+ goals: XenoGoalRecord[];
8484
+ loops: XenoLoopRecord[];
8485
+ handoffs: XenoHandoffRecord[];
8486
+ events: XenoCoordinationEvent[];
8487
+ createdAt: string;
8488
+ updatedAt: string;
8489
+ }
8490
+ interface XenoCoordinationStoreOptions {
8491
+ rootDirectory?: string;
8492
+ now?: () => string;
8493
+ idFactory?: (prefix: string) => string;
8494
+ ownerLeaseMs?: number;
8495
+ lockTimeoutMs?: number;
8496
+ lockStaleMs?: number;
8497
+ maximumEventsPerSession?: number;
8498
+ }
8499
+ interface CreateXenoGoalInput {
8500
+ sessionId: string;
8501
+ objective: string;
8502
+ why?: string;
8503
+ successCriteria?: Array<string | Omit<XenoGoalCriterion, "id"> & {
8504
+ id?: string;
8505
+ }>;
8506
+ constraints?: string[];
8507
+ limits?: XenoGoalRecord["limits"];
8508
+ metadata?: Record<string, string | number | boolean>;
8509
+ }
8510
+ interface CreateXenoHandoffInput {
8511
+ sessionId: string;
8512
+ sourceOwnerId: string;
8513
+ sourceLeaseId: string;
8514
+ goalId?: string;
8515
+ loopId?: string;
8516
+ targetOwnerId?: string;
8517
+ workspace?: string;
8518
+ branch?: string;
8519
+ currentMilestoneId?: string;
8520
+ currentTaskId?: string;
8521
+ agentIds?: string[];
8522
+ operations?: XenoHandoffOperation[];
8523
+ contextDigest?: string;
8524
+ }
8525
+ declare class XenoCoordinationError extends Error {
8526
+ readonly code: "INVALID" | "NOT_FOUND" | "CONFLICT" | "NOT_OWNER" | "LEASE_EXPIRED" | "UNSAFE_HANDOFF" | "VERIFICATION_REQUIRED";
8527
+ readonly details: Record<string, unknown>;
8528
+ constructor(code: "INVALID" | "NOT_FOUND" | "CONFLICT" | "NOT_OWNER" | "LEASE_EXPIRED" | "UNSAFE_HANDOFF" | "VERIFICATION_REQUIRED", message: string, details?: Record<string, unknown>);
8529
+ }
8530
+ interface UpdateXenoGoalInput {
8531
+ objective?: string;
8532
+ why?: string;
8533
+ constraints?: string[];
8534
+ successCriteria?: XenoGoalCriterion[];
8535
+ status?: Exclude<XenoGoalStatus, "completed">;
8536
+ progress?: Partial<Omit<XenoGoalProgress, "updatedAt">>;
8537
+ verification?: XenoGoalVerification;
8538
+ metadata?: Record<string, string | number | boolean>;
8539
+ }
8540
+ interface StartXenoLoopInput {
8541
+ sessionId: string;
8542
+ goalId?: string;
8543
+ kind: XenoLoopKind;
8544
+ activity?: string;
8545
+ schedule?: XenoLoopSchedule;
8546
+ }
8547
+ interface ClaimXenoHandoffInput {
8548
+ sessionId: string;
8549
+ handoffId: string;
8550
+ targetOwnerId: string;
8551
+ processId?: number;
8552
+ host?: string;
8553
+ }
8554
+ declare class DurableXenoCoordinationStore {
8555
+ private readonly rootDirectory;
8556
+ private readonly now;
8557
+ private readonly idFactory;
8558
+ private readonly ownerLeaseMs;
8559
+ private readonly lockTimeoutMs;
8560
+ private readonly lockStaleMs;
8561
+ private readonly maximumEventsPerSession;
8562
+ constructor(options?: XenoCoordinationStoreOptions);
8563
+ getSessionState(sessionId: string): Promise<XenoCoordinationSessionState>;
8564
+ listSessionStates(): Promise<XenoCoordinationSessionState[]>;
8565
+ createGoal(input: CreateXenoGoalInput): Promise<XenoGoalRecord>;
8566
+ getGoal(sessionId: string, goalId?: string): Promise<XenoGoalRecord | undefined>;
8567
+ updateGoal(sessionId: string, goalId: string, expectedVersion: number, update: UpdateXenoGoalInput): Promise<XenoGoalRecord>;
8568
+ addMilestone(sessionId: string, goalId: string, expectedVersion: number, input: {
8569
+ title: string;
8570
+ description?: string;
8571
+ }): Promise<XenoGoalRecord>;
8572
+ addTask(sessionId: string, goalId: string, expectedVersion: number, input: {
8573
+ milestoneId: string;
8574
+ parentTaskId?: string;
8575
+ title: string;
8576
+ description?: string;
8577
+ assignedAgentId?: string;
8578
+ dependsOn?: string[];
8579
+ }): Promise<XenoGoalRecord>;
8580
+ updateTask(sessionId: string, goalId: string, taskId: string, expectedVersion: number, update: Pick<XenoGoalTask, "status"> & Partial<Pick<XenoGoalTask, "progress" | "resultEventId" | "assignedAgentId">>): Promise<XenoGoalRecord>;
8581
+ steerGoal(sessionId: string, goalId: string, expectedVersion: number, instruction: string): Promise<XenoGoalRecord>;
8582
+ consumeGoalSteering(sessionId: string, goalId: string, expectedVersion: number): Promise<{
8583
+ goal: XenoGoalRecord;
8584
+ instructions: Array<{
8585
+ id: string;
8586
+ instruction: string;
8587
+ createdAt: string;
8588
+ }>;
8589
+ }>;
8590
+ completeGoal(sessionId: string, goalId: string, expectedVersion: number, verification: XenoGoalVerification): Promise<XenoGoalRecord>;
8591
+ cancelGoal(sessionId: string, goalId: string, expectedVersion: number, reason: string): Promise<XenoGoalRecord>;
8592
+ startLoop(input: StartXenoLoopInput): Promise<XenoLoopRecord>;
8593
+ getLoop(sessionId: string, loopId?: string): Promise<XenoLoopRecord | undefined>;
8594
+ beginLoopIteration(sessionId: string, loopId: string, expectedVersion: number, activity: string, taskId?: string): Promise<XenoLoopRecord>;
8595
+ finishLoopIteration(sessionId: string, loopId: string, expectedVersion: number, result: {
8596
+ status: "completed" | "failed" | "interrupted";
8597
+ verificationEventId?: string;
8598
+ error?: string;
8599
+ nextStatus?: Extract<XenoLoopStatus, "running" | "waiting" | "failed">;
8600
+ }): Promise<XenoLoopRecord>;
8601
+ setLoopStatus(sessionId: string, loopId: string, expectedVersion: number, status: Extract<XenoLoopStatus, "paused" | "running" | "waiting" | "stopped" | "completed" | "failed">, reason?: string): Promise<XenoLoopRecord>;
8602
+ acquireOwnership(sessionId: string, ownerId: string, options?: {
8603
+ processId?: number;
8604
+ host?: string;
8605
+ leaseMs?: number;
8606
+ }): Promise<XenoExecutionOwner>;
8607
+ renewOwnership(sessionId: string, ownerId: string, leaseId: string, leaseMs?: number): Promise<XenoExecutionOwner>;
8608
+ releaseOwnership(sessionId: string, ownerId: string, leaseId: string): Promise<XenoExecutionOwner>;
8609
+ createHandoff(input: CreateXenoHandoffInput): Promise<XenoHandoffRecord>;
8610
+ claimHandoff(input: ClaimXenoHandoffInput): Promise<{
8611
+ handoff: XenoHandoffRecord;
8612
+ owner: XenoExecutionOwner;
8613
+ }>;
8614
+ completeHandoff(sessionId: string, handoffId: string, ownerId: string, leaseId: string): Promise<XenoHandoffRecord>;
8615
+ failHandoff(sessionId: string, handoffId: string, reason: string): Promise<XenoHandoffRecord>;
8616
+ private mutateGoal;
8617
+ private mutateLoop;
8618
+ private recalculateProgress;
8619
+ private requireGoal;
8620
+ private requireOwner;
8621
+ private assertVersion;
8622
+ private newOwner;
8623
+ private ownerExpired;
8624
+ private appendEvent;
8625
+ private mutate;
8626
+ private statePath;
8627
+ private lockPath;
8628
+ private readState;
8629
+ private writeState;
8630
+ private renameReplacing;
8631
+ private withSessionLock;
8632
+ private staleLockOwner;
8633
+ private quarantineLock;
8634
+ }
8635
+ 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";
8636
+ interface ExecuteXenoCoordinationActionInput {
8637
+ action: XenoCoordinationAction;
8638
+ sessionId: string;
8639
+ payload?: Record<string, unknown>;
8640
+ }
8641
+ interface ExecuteXenoCoordinationActionResult {
8642
+ action: XenoCoordinationAction;
8643
+ sessionId: string;
8644
+ result: unknown;
8645
+ state: XenoCoordinationSessionState;
8646
+ event?: XenoCoordinationEvent;
8647
+ }
8648
+ declare function executeXenoCoordinationAction(store: DurableXenoCoordinationStore, input: ExecuteXenoCoordinationActionInput): Promise<ExecuteXenoCoordinationActionResult>;
8649
+ interface XenoExecutionLeaseSessionOptions {
8650
+ store?: DurableXenoCoordinationStore;
8651
+ sessionId: string;
8652
+ ownerId?: string;
8653
+ processId?: number;
8654
+ host?: string;
8655
+ leaseMs?: number;
8656
+ heartbeatMs?: number;
8657
+ claimHandoffId?: string;
8658
+ onOwnershipLost?: (error: unknown) => void;
8659
+ }
8660
+ declare class XenoExecutionLeaseSession {
8661
+ readonly sessionId: string;
8662
+ readonly ownerId: string;
8663
+ private readonly store;
8664
+ private readonly processId;
8665
+ private readonly host;
8666
+ private readonly leaseMs;
8667
+ private readonly heartbeatMs;
8668
+ private readonly claimHandoffId?;
8669
+ private readonly onOwnershipLost?;
8670
+ private timer?;
8671
+ private heartbeatInFlight;
8672
+ private owner?;
8673
+ private stopped;
8674
+ private lostError?;
8675
+ private preparedHandoffId?;
8676
+ constructor(options: XenoExecutionLeaseSessionOptions);
8677
+ get currentOwner(): XenoExecutionOwner | undefined;
8678
+ get active(): boolean;
8679
+ start(): Promise<XenoExecutionOwner>;
8680
+ assertOwned(): Promise<XenoExecutionOwner>;
8681
+ private renewHeldLease;
8682
+ prepareHandoff(input?: Omit<CreateXenoHandoffInput, "sessionId" | "sourceOwnerId" | "sourceLeaseId">): Promise<XenoHandoffRecord>;
8683
+ stop(options?: {
8684
+ release?: boolean;
8685
+ }): Promise<void>;
8686
+ private heartbeat;
8687
+ private markLost;
8688
+ }
8143
8689
  declare const XENO_HOSTED_ENVIRONMENT_SCHEMA_VERSION: 1;
8144
8690
  declare const XENO_HOSTED_RUN_SCHEMA_VERSION: 1;
8145
8691
  declare const XENO_HOSTED_EVENT_SCHEMA_VERSION: 1;
@@ -9537,6 +10083,7 @@ declare class SessionLock {
9537
10083
  private legacyLockPath;
9538
10084
  private sessionId;
9539
10085
  private heartbeatTimer?;
10086
+ private acquiredOwner?;
9540
10087
  constructor(sessionDir: string);
9541
10088
  acquire(): Promise<void>;
9542
10089
  release(): Promise<void>;
@@ -12757,4 +13304,4 @@ declare class AgentEvaluator {
12757
13304
  clearResults(): void;
12758
13305
  get resultCount(): number;
12759
13306
  }
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 };
13307
+ 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 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 };