@xenosystem/agent-interface-contract 0.1.0

package/LICENSE

@@ -0,0 +1,67 @@
+XENO Agent — Proprietary Software License
+Copyright © 2026 XENO Corporation. All rights reserved.
+
+This software, including its source code, compiled binaries, published packages,
+assets, and accompanying documentation (collectively, the "Software"), is the
+proprietary and confidential property of XENO Corporation ("XENO"). The Software
+is licensed for use, not sold, and no title to or ownership of the Software is
+transferred to any user.
+
+1. GRANT OF USE
+   Subject to a separate written agreement and/or the terms of service published
+   at https://xenostudio.ai, XENO grants the end user a limited, non-exclusive,
+   non-transferable, revocable license to install and use the Software for its
+   intended purpose. The standalone desktop application ("the Agent") may be used
+   locally at no charge; connected platform features — hosted agent runs, model
+   inference, credits, and account services — are governed by the applicable
+   subscription and the XENO terms of service.
+
+2. PACKAGE DISTRIBUTION
+   The `@xeno-corporation/xeno-agent-interface-*` and
+   `@xeno-corporation/xeno-agents-client` packages are published to a PRIVATE
+   registry and are licensed for use solely by XENO products and by parties
+   holding a separate written agreement with XENO. Access credentials to that
+   registry do not grant redistribution rights. Publication of any package in
+   this repository to a public registry is prohibited without written
+   authorization from XENO.
+
+3. RESTRICTIONS
+   Except to the extent expressly permitted by applicable law or by a separate
+   written agreement with XENO, you may NOT: (a) copy, redistribute, sell, rent,
+   lease, sublicense, or otherwise transfer the Software; (b) modify, adapt,
+   translate, or create derivative works of the Software; (c) reverse-engineer,
+   decompile, or disassemble the Software, or attempt to derive its source code;
+   (d) remove, obscure, or alter any proprietary notices; or (e) use the Software
+   to build a competing product.
+
+4. RESERVATION OF RIGHTS
+   All rights not expressly granted are reserved by XENO Corporation. The Software
+   is protected by copyright and other intellectual-property laws and treaties.
+
+5. DISCLAIMER OF WARRANTY
+   THE SOFTWARE IS PROVIDED "AS IS" AND "AS AVAILABLE", WITHOUT WARRANTY OF ANY
+   KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+   MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. THE
+   SOFTWARE EXECUTES AGENT-DIRECTED OPERATIONS AGAINST A USER-SELECTED WORKSPACE,
+   INCLUDING FILE AND PROCESS ACTIONS; THE USER IS RESPONSIBLE FOR THE WORKSPACES
+   AND PERMISSIONS THEY GRANT IT.
+
+6. LIMITATION OF LIABILITY
+   TO THE MAXIMUM EXTENT PERMITTED BY LAW, IN NO EVENT SHALL XENO CORPORATION BE
+   LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, OR PUNITIVE
+   DAMAGES, OR ANY LOSS OF PROFITS OR DATA, ARISING FROM OR RELATED TO THE USE OF
+   OR INABILITY TO USE THE SOFTWARE.
+
+7. THIRD-PARTY COMPONENTS
+   The Software includes third-party open-source components, each licensed under
+   its own terms; those terms govern those components and are not superseded by
+   this license. It also composes third-party agent providers over the Agent
+   Client Protocol and hosted APIs; use of those providers is governed by their
+   own terms.
+
+For licensing inquiries, contact: legal@xenostudio.ai
+
+NOTE TO OPERATOR: confirm the exact legal entity name and notice/contact details
+with counsel before public distribution and code-signing (the code-signing
+publisher name must match the registered entity). No public distribution of this
+product is authorized by this file — see docs/PRODUCT_STATUS.md.

package/dist/cloudRuns.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Type-only projection of the hosted XENO Agents API run contract used by
+ * presentation bridges. Execution and network authority remain in the host.
+ *
+ * These declarations are copied from XENO Hub's canonical portable
+ * `shared/xeno-agents-client.ts` contract; the renderer receives only the
+ * public records, never the authenticated client implementation.
+ */
+export declare const XENO_AGENTS_SCHEMA_VERSION: 1;
+export type AgentCloudRunStatus = 'queued' | 'starting' | 'running' | 'blocked' | 'waiting_for_user' | 'waiting_for_tool' | 'waiting_for_hook' | 'waiting_for_permission' | 'paused' | 'completed' | 'failed' | 'skipped' | 'cancelled' | 'interrupted' | 'detached';
+export type AgentCloudPermissionMode = 'default' | 'plan' | 'acceptEdits' | 'auto' | 'dontAsk' | 'bypassPermissions';
+export type AgentCloudEffort = 'low' | 'medium' | 'high' | 'xhigh' | 'max';
+export interface AgentCloudRunUsage {
+    input: number;
+    output: number;
+    total: number;
+    estimatedCostUsd?: number;
+}
+export interface AgentCloudRunGit {
+    branch?: string;
+    baseRef?: string;
+    commit?: string;
+}
+export interface AgentCloudAgentRef {
+    name?: string;
+    scope?: string;
+    path?: string;
+    description?: string;
+    model?: string;
+}
+export interface AgentRunRecord {
+    schemaVersion: typeof XENO_AGENTS_SCHEMA_VERSION;
+    runId: string;
+    sessionId: string;
+    rootRunId: string;
+    parentRunId?: string;
+    workspaceId: string;
+    prompt: string;
+    title?: string;
+    status: AgentCloudRunStatus;
+    statusReason?: string;
+    blockedReason?: string;
+    model: string;
+    effort?: AgentCloudEffort;
+    agent?: AgentCloudAgentRef;
+    permissionMode: AgentCloudPermissionMode;
+    createdAt: string;
+    updatedAt: string;
+    startedAt?: string;
+    endedAt?: string;
+    lastActivityAt?: string;
+    exitCode?: number;
+    git?: AgentCloudRunGit;
+    usage: AgentCloudRunUsage;
+    children: string[];
+    tags: string[];
+    creditsHeld?: number;
+    creditsSettled?: number;
+    url: string;
+}
+export interface RunListItem {
+    runId: string;
+    status: AgentCloudRunStatus;
+    url: string;
+    createdAt: string;
+    model: string;
+    promptPreview: string;
+}
+//# sourceMappingURL=cloudRuns.d.ts.map

package/dist/cloudRuns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudRuns.d.ts","sourceRoot":"","sources":["../src/cloudRuns.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,0BAA0B,EAAG,CAAU,CAAA;AAEpD,MAAM,MAAM,mBAAmB,GAC3B,QAAQ,GACR,UAAU,GACV,SAAS,GACT,SAAS,GACT,kBAAkB,GAClB,kBAAkB,GAClB,kBAAkB,GAClB,wBAAwB,GACxB,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,SAAS,GACT,WAAW,GACX,aAAa,GACb,UAAU,CAAA;AAEd,MAAM,MAAM,wBAAwB,GAChC,SAAS,GACT,MAAM,GACN,aAAa,GACb,MAAM,GACN,SAAS,GACT,mBAAmB,CAAA;AAEvB,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAA;AAE1E,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,OAAO,0BAA0B,CAAA;IAChD,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,mBAAmB,CAAA;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,gBAAgB,CAAA;IACzB,KAAK,CAAC,EAAE,kBAAkB,CAAA;IAC1B,cAAc,EAAE,wBAAwB,CAAA;IACxC,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,gBAAgB,CAAA;IACtB,KAAK,EAAE,kBAAkB,CAAA;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,mBAAmB,CAAA;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,EAAE,MAAM,CAAA;CACtB"}

package/dist/cloudRuns.js

@@ -0,0 +1,10 @@
+/**
+ * Type-only projection of the hosted XENO Agents API run contract used by
+ * presentation bridges. Execution and network authority remain in the host.
+ *
+ * These declarations are copied from XENO Hub's canonical portable
+ * `shared/xeno-agents-client.ts` contract; the renderer receives only the
+ * public records, never the authenticated client implementation.
+ */
+export const XENO_AGENTS_SCHEMA_VERSION = 1;
+//# sourceMappingURL=cloudRuns.js.map

package/dist/cloudRuns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudRuns.js","sourceRoot":"","sources":["../src/cloudRuns.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAU,CAAA"}

package/dist/engineering.d.ts

@@ -0,0 +1,513 @@
+export interface EngineeringRequestBase {
+    rootDirectory: string;
+    allowedDirectories?: string[] | undefined;
+}
+export interface GitFileStatus {
+    path: string;
+    relativePath: string;
+    status: string;
+    indexStatus: string;
+    workTreeStatus: string;
+    renamedFrom?: string | undefined;
+    additions?: number | undefined;
+    deletions?: number | undefined;
+}
+export interface GitStatusResponse {
+    success: boolean;
+    isGitRepo: boolean;
+    rootDirectory: string;
+    branch?: string | undefined;
+    upstream?: string | undefined;
+    ahead?: number | undefined;
+    behind?: number | undefined;
+    clean: boolean;
+    files: GitFileStatus[];
+    raw?: string | undefined;
+    error?: string | undefined;
+}
+export interface GitDiffRequest extends EngineeringRequestBase {
+    paths?: string[] | undefined;
+    staged?: boolean | undefined;
+    maxBytes?: number | undefined;
+}
+export interface GitDiffResponse {
+    success: boolean;
+    isGitRepo: boolean;
+    rootDirectory: string;
+    diff: string;
+    truncated: boolean;
+    error?: string | undefined;
+}
+export interface GitStageRequest extends EngineeringRequestBase {
+    paths: string[];
+}
+export interface GitCommitRequest extends EngineeringRequestBase {
+    message: string;
+}
+/**
+ * Create or switch to a branch — §5.7's git surface.
+ *
+ * Local and reversible, unlike everything else added alongside it, which is why
+ * it needs no confirmation of its own.
+ */
+export interface GitBranchRequest extends EngineeringRequestBase {
+    name: string;
+    /** Create it if absent. False switches to an existing branch and fails if it
+     *  does not exist, rather than quietly creating one with a mistyped name. */
+    create?: boolean | undefined;
+    /** What to branch FROM. Absent means the current HEAD. */
+    startPoint?: string | undefined;
+}
+/**
+ * Push a branch to a remote.
+ *
+ * 🔴 **Outward-facing.** This is the first verb in the engineering surface whose
+ * effect leaves the machine, so it carries `confirmed`. That flag is not a UI
+ * concern smuggled into the protocol: the host cannot otherwise distinguish an
+ * agent deciding to publish from a human asking it to, and those are different
+ * acts. Absent or false, the host refuses and says so.
+ *
+ * There is deliberately no `force`. A force-push destroys history that other
+ * people may already have, it is unrecoverable, and every XENO repo rule already
+ * forbids it — so the safest implementation is one that cannot express it.
+ */
+export interface GitPushRequest extends EngineeringRequestBase {
+    remote?: string | undefined;
+    /** Absent means the current branch. */
+    branch?: string | undefined;
+    /** Set the upstream while pushing, for a branch that has none yet. */
+    setUpstream?: boolean | undefined;
+    confirmed?: boolean | undefined;
+}
+export interface GitPushResponse extends GitStatusResponse {
+    pushed: boolean;
+    remote?: string | undefined;
+    pushedBranch?: string | undefined;
+}
+/**
+ * Open a pull request.
+ *
+ * Outward-facing for the same reason as a push, and confirmed the same way.
+ * `draft` defaults to TRUE: a review request notifies people, and the default
+ * for an action taken on a human's behalf should be the quieter one.
+ */
+export interface GitPullRequestCreateRequest extends EngineeringRequestBase {
+    title: string;
+    body?: string | undefined;
+    /** Absent means the repository's default branch, resolved by the host. */
+    base?: string | undefined;
+    head?: string | undefined;
+    draft?: boolean | undefined;
+    confirmed?: boolean | undefined;
+}
+export interface GitPullRequestCreateResponse {
+    success: boolean;
+    created: boolean;
+    url?: string | undefined;
+    number?: number | undefined;
+    error?: string | undefined;
+}
+/** Where a run stands on its way to trunk. Mirrors `core`'s `LandingState`. */
+export type LandingEntryState = 'queued' | 'landing' | 'landed' | 'refused' | 'failed';
+export interface LandingQueueEntry {
+    runId: string;
+    revision: string;
+    state: LandingEntryState;
+    position?: number | undefined;
+    reason?: string | undefined;
+    enqueuedAt: number;
+    updatedAt: number;
+}
+export interface LandingQueueResponse {
+    success: boolean;
+    entries: LandingQueueEntry[];
+    /** The run currently landing. At most one — see `core`'s `LandingQueue`. */
+    landing?: string | undefined;
+    /** Identity of the set that would land next, content-sensitive. */
+    fingerprint: string;
+    error?: string | undefined;
+}
+export interface LandingEnqueueRequest extends EngineeringRequestBase {
+    runId: string;
+    /**
+     * A token that changes when the run's content changes.
+     *
+     * Not optional and not defaulted. A caller that cannot say what revision it is
+     * landing cannot be given a stale-detection guarantee, and inventing one here
+     * would hand out that guarantee without the fact behind it.
+     */
+    revision: string;
+}
+export interface LandingRemoveRequest extends EngineeringRequestBase {
+    runId: string;
+}
+/**
+ * Attempt the next landing.
+ *
+ * 🔴 **There is deliberately no `engineering.git.merge`.** A free-standing merge
+ * verb would sit beside the gate rather than behind it, and a gate that can be
+ * walked around is documentation. Merging happens here, after the queue has
+ * admitted a run — which it does only when overlaps are clear and the exact
+ * combination has been verified.
+ *
+ * Outward-facing, so confirmed like a push.
+ */
+export interface LandingLandRequest extends EngineeringRequestBase {
+    /** Branch to merge INTO. Absent means the repository's default branch. */
+    base?: string | undefined;
+    confirmed?: boolean | undefined;
+}
+/**
+ * Run the checks against the COMBINED result — §5.7's combination verification.
+ *
+ * The result is stamped with the fingerprint of the set that was in flight when
+ * it ran, which is what lets a later landing tell a green that describes it from
+ * a green that describes something else. That stamp is applied here rather than
+ * accepted from the caller: a caller that could name its own fingerprint could
+ * name the one that would make its result look current.
+ */
+export interface LandingVerifyRequest extends EngineeringRequestBase {
+    /** Which discovered check to run. Absent runs the workspace's default. */
+    checkId?: string | undefined;
+}
+export interface LandingVerifyResponse extends LandingQueueResponse {
+    /** True only when the check passed AND the set is unchanged since it started. */
+    verified: boolean;
+    checks: string[];
+    /** Present when the check ran and failed, or could not run at all. */
+    problem?: string | undefined;
+}
+export interface LandingLandResponse extends LandingQueueResponse {
+    /** The run this call acted on, when the queue admitted one. */
+    runId?: string | undefined;
+    landed: boolean;
+    /** Why it was refused or how it failed, in terms a human can act on. */
+    verdict?: string | undefined;
+}
+export type EngineeringCheckKind = 'test' | 'typecheck' | 'build' | 'lint' | 'script';
+export interface EngineeringCheck {
+    id: string;
+    kind: EngineeringCheckKind;
+    name: string;
+    command: string;
+    args: string[];
+    packageScript?: string | undefined;
+}
+export interface EngineeringCheckDiscoveryResponse {
+    success: boolean;
+    rootDirectory: string;
+    checks: EngineeringCheck[];
+    packageManager?: 'npm' | undefined;
+    error?: string | undefined;
+}
+export interface EngineeringRunRequest extends EngineeringRequestBase {
+    checkId: string;
+    timeoutMs?: number | undefined;
+    maxOutputBytes?: number | undefined;
+}
+export interface EngineeringRunResult {
+    id: string;
+    rootDirectory: string;
+    check: EngineeringCheck;
+    startedAt: number;
+    endedAt: number;
+    durationMs: number;
+    success: boolean;
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+    truncated: boolean;
+    error?: string | undefined;
+}
+export interface EngineeringRunResponse {
+    success: boolean;
+    run?: EngineeringRunResult | undefined;
+    error?: string | undefined;
+}
+export interface EngineeringRunListResponse {
+    success: boolean;
+    rootDirectory: string;
+    runs: EngineeringRunResult[];
+    error?: string | undefined;
+}
+export type EngineeringBackgroundRunStatus = 'running' | 'completed' | 'failed' | 'stopped';
+export interface EngineeringBackgroundRun {
+    id: string;
+    rootDirectory: string;
+    check: EngineeringCheck;
+    status: EngineeringBackgroundRunStatus;
+    startedAt: number;
+    updatedAt: number;
+    endedAt?: number | undefined;
+    durationMs?: number | undefined;
+    exitCode?: number | null | undefined;
+    stdout: string;
+    stderr: string;
+    truncated: boolean;
+    error?: string | undefined;
+}
+export interface EngineeringBackgroundRunRequest extends EngineeringRunRequest {
+}
+export interface EngineeringBackgroundRunLookupRequest extends EngineeringRequestBase {
+    runId: string;
+}
+export interface EngineeringBackgroundRunResponse {
+    success: boolean;
+    rootDirectory?: string | undefined;
+    run?: EngineeringBackgroundRun | undefined;
+    error?: string | undefined;
+}
+export interface EngineeringBackgroundRunListResponse {
+    success: boolean;
+    rootDirectory: string;
+    runs: EngineeringBackgroundRun[];
+    error?: string | undefined;
+}
+export interface EngineeringDiagnosticIssue {
+    id: string;
+    rootDirectory: string;
+    filePath?: string | undefined;
+    relativePath?: string | undefined;
+    line?: number | undefined;
+    column?: number | undefined;
+    severity: 'error' | 'warning' | 'info';
+    source: string;
+    code?: string | undefined;
+    message: string;
+    runId?: string | undefined;
+}
+export interface EngineeringDiagnosticsResponse {
+    success: boolean;
+    rootDirectory: string;
+    summary: string;
+    git?: GitStatusResponse | undefined;
+    checks: EngineeringCheck[];
+    recentRuns: EngineeringRunResult[];
+    backgroundRuns?: EngineeringBackgroundRun[] | undefined;
+    issues: EngineeringDiagnosticIssue[];
+    error?: string | undefined;
+}
+export type PatchReviewStatus = 'open' | 'approved' | 'changes-requested' | 'applied' | 'dismissed';
+export interface EngineeringPatchFileSnapshot {
+    path: string;
+    relativePath: string;
+    originalContent: string;
+    modifiedContent: string;
+    originalExists?: boolean | undefined;
+    modifiedExists?: boolean | undefined;
+    originalSha256?: string | undefined;
+    modifiedSha256?: string | undefined;
+    originalBlobId?: string | undefined;
+    modifiedBlobId?: string | undefined;
+    language?: string | undefined;
+    addedLines?: number | undefined;
+    removedLines?: number | undefined;
+}
+export interface EngineeringPatchHunk {
+    id: string;
+    relativePath: string;
+    originalStart: number;
+    originalLines: number;
+    modifiedStart: number;
+    modifiedLines: number;
+    originalText: string;
+    modifiedText: string;
+}
+export type PatchReviewDecisionAction = 'accept' | 'reject' | 'comment';
+export type PatchReviewDecisionState = 'pending' | 'applied' | 'failed' | 'conflict';
+export interface PatchReviewDecision {
+    id: string;
+    relativePath: string;
+    hunkId?: string | undefined;
+    action: PatchReviewDecisionAction;
+    comment?: string | undefined;
+    state: PatchReviewDecisionState;
+    expectedBeforeExists?: boolean | undefined;
+    expectedBeforeSha256?: string | undefined;
+    resultingExists?: boolean | undefined;
+    resultingSha256?: string | undefined;
+    transactionId?: string | undefined;
+    error?: string | undefined;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface PatchReviewItem {
+    id: string;
+    rootDirectory: string;
+    title: string;
+    description?: string | undefined;
+    diff: string;
+    files: string[];
+    filesChanged: string[];
+    summary: string;
+    timestamp: number;
+    conversationId?: string | undefined;
+    requestId?: string | undefined;
+    checkpointId?: string | undefined;
+    testsRun?: string[] | undefined;
+    finalSummary?: string | undefined;
+    fileSnapshots?: EngineeringPatchFileSnapshot[] | undefined;
+    hunks?: EngineeringPatchHunk[] | undefined;
+    decisions?: PatchReviewDecision[] | undefined;
+    status: PatchReviewStatus;
+    notes?: string | undefined;
+    source?: 'manual' | 'agent' | 'git-diff' | undefined;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface PatchReviewListResponse {
+    success: boolean;
+    rootDirectory: string;
+    items: PatchReviewItem[];
+    error?: string | undefined;
+}
+export interface PatchReviewUpsertRequest extends EngineeringRequestBase {
+    id?: string | undefined;
+    title?: string | undefined;
+    description?: string | undefined;
+    diff?: string | undefined;
+    files?: string[] | undefined;
+    filesChanged?: string[] | undefined;
+    source?: PatchReviewItem['source'] | undefined;
+    conversationId?: string | undefined;
+    requestId?: string | undefined;
+    checkpointId?: string | undefined;
+    summary?: string | undefined;
+    timestamp?: number | undefined;
+    testsRun?: string[] | undefined;
+    finalSummary?: string | undefined;
+    fileSnapshots?: EngineeringPatchFileSnapshot[] | undefined;
+}
+export interface PatchReviewUpdateRequest extends EngineeringRequestBase {
+    id: string;
+    status?: PatchReviewStatus | undefined;
+    notes?: string | undefined;
+}
+export interface PatchReviewMutationResponse {
+    success: boolean;
+    rootDirectory: string;
+    item?: PatchReviewItem | undefined;
+    items?: PatchReviewItem[] | undefined;
+    error?: string | undefined;
+}
+export interface PatchReviewSelectionRequest extends EngineeringRequestBase {
+    id: string;
+    relativePath: string;
+    hunkId?: string | undefined;
+    action: PatchReviewDecisionAction;
+    comment?: string | undefined;
+    confirmed?: boolean | undefined;
+    previewToken?: string | undefined;
+}
+export interface PatchReviewSelectionConflict {
+    relativePath: string;
+    reason: 'legacy_snapshot_ambiguous' | 'selection_not_found' | 'already_decided' | 'current_state_changed' | 'unsafe_path' | 'unsupported_file_type';
+    expectedExists?: boolean | undefined;
+    actualExists?: boolean | undefined;
+    expectedSha256?: string | undefined;
+    actualSha256?: string | undefined;
+    detail?: string | undefined;
+}
+export interface PatchReviewSelectionResponse {
+    success: boolean;
+    rootDirectory: string;
+    item?: PatchReviewItem | undefined;
+    selectedHunkIds: string[];
+    wouldChangeFiles: string[];
+    previewToken?: string | undefined;
+    conflicts?: PatchReviewSelectionConflict[] | undefined;
+    applied?: boolean | undefined;
+    transactionId?: string | undefined;
+    error?: string | undefined;
+}
+export interface EngineeringCheckpointSummary {
+    id: string;
+    checkpointId: string;
+    rootDirectory: string;
+    createdAt: number;
+    conversationId?: string | undefined;
+    requestId?: string | undefined;
+    summary: string;
+    filesChanged: string[];
+    patchIds: string[];
+    patchCount: number;
+}
+export interface EngineeringCheckpointListResponse {
+    success: boolean;
+    rootDirectory: string;
+    checkpoints: EngineeringCheckpointSummary[];
+    error?: string | undefined;
+}
+export interface EngineeringCheckpointCompareRequest extends EngineeringRequestBase {
+    fromCheckpointId: string;
+    toCheckpointId: string;
+}
+export interface EngineeringCheckpointCompareResponse {
+    success: boolean;
+    rootDirectory: string;
+    from?: EngineeringCheckpointSummary | undefined;
+    to?: EngineeringCheckpointSummary | undefined;
+    filesChanged: string[];
+    diff: string;
+    patches: PatchReviewItem[];
+    error?: string | undefined;
+}
+export interface EngineeringCheckpointRestoreRequest extends EngineeringRequestBase {
+    checkpointId: string;
+    conversationId?: string | undefined;
+    requestId?: string | undefined;
+    confirmed?: boolean | undefined;
+    previewToken?: string | undefined;
+    conflictStrategy?: 'abort' | 'overwrite' | undefined;
+}
+export interface EngineeringCheckpointConflict {
+    relativePath: string;
+    reason: 'legacy_snapshot_ambiguous' | 'missing_snapshot_data' | 'snapshot_chain_broken' | 'current_state_changed' | 'unsafe_path' | 'unsupported_file_type';
+    expectedExists?: boolean | undefined;
+    actualExists?: boolean | undefined;
+    expectedSha256?: string | undefined;
+    actualSha256?: string | undefined;
+    detail?: string | undefined;
+}
+export interface EngineeringCheckpointRestoreResponse {
+    success: boolean;
+    rootDirectory: string;
+    checkpoint?: EngineeringCheckpointSummary | undefined;
+    previewDiff: string;
+    wouldRestoreFiles: string[];
+    previewToken?: string | undefined;
+    conflicts?: EngineeringCheckpointConflict[] | undefined;
+    restored?: boolean | undefined;
+    restoredFiles?: string[] | undefined;
+    transactionId?: string | undefined;
+    runtimeEvent?: Record<string, unknown> | undefined;
+    error?: string | undefined;
+}
+export interface EngineeringSession {
+    id: string;
+    rootDirectory: string;
+    conversationId: string;
+    startedAt: number;
+    endedAt: number;
+    patches: PatchReviewItem[];
+    checkpoints: EngineeringCheckpointSummary[];
+    testsRun: EngineeringRunResult[];
+    finalSummary: string;
+}
+export interface EngineeringSessionListResponse {
+    success: boolean;
+    rootDirectory: string;
+    sessions: EngineeringSession[];
+    error?: string | undefined;
+}
+export interface EngineeringRuntimeTimelineRequest extends EngineeringRequestBase {
+    conversationId: string;
+}
+export interface EngineeringRuntimeTimelineResponse {
+    success: boolean;
+    rootDirectory: string;
+    conversationId?: string | undefined;
+    timeline?: unknown | undefined;
+    error?: string | undefined;
+}
+//# sourceMappingURL=engineering.d.ts.map