@intentic/sandbox-contract 1.226.0 → 1.226.1

package/dist/contracts/extensions.contract.js

@@ -1,29 +1,138 @@
 import { oc } from "@orpc/contract";
 import { CapabilityIdParamSchema, ExtensionEnabledInputSchema, ExtensionProcessParamSchema, ExtensionProcessStatusSchema, ExtensionSettingsInputSchema, ExtensionSettingsSchema, ExtensionReadinessSchema, ExtensionUpdateActionSchema, ExtensionUpdateAppliedSchema, ExtensionUpdatePolicyInputSchema, ExtensionUpdatePreviewSchema, ExtensionUpdatesCheckedSchema, ExtensionUsageInputSchema, ExtensionsListSchema, OkSchema, WorkspaceExtensionCreatedSchema, WorkspaceExtensionCreateSchema, } from "../schemas.js";
 export const extensionsContract = {
-    list: oc.route({ method: "GET", path: "/extensions" }).output(ExtensionsListSchema),
-    create: oc.route({ method: "POST", path: "/extensions/workspace" }).input(WorkspaceExtensionCreateSchema).output(WorkspaceExtensionCreatedSchema),
-    settings: oc.route({ method: "GET", path: "/extensions/{id}/settings" }).input(CapabilityIdParamSchema).output(ExtensionSettingsSchema),
-    setSettings: oc.route({ method: "POST", path: "/extensions/{id}/settings" }).input(ExtensionSettingsInputSchema).output(OkSchema),
-    setEnabled: oc.route({ method: "POST", path: "/extensions/{id}/enabled" }).input(ExtensionEnabledInputSchema).output(OkSchema),
-    recordUsage: oc.route({ method: "POST", path: "/extensions/{id}/usage" }).input(ExtensionUsageInputSchema).output(OkSchema),
-    readiness: oc.route({ method: "GET", path: "/extensions/{id}/readiness" }).input(CapabilityIdParamSchema).output(ExtensionReadinessSchema),
-    checkUpdates: oc.route({ method: "POST", path: "/extensions/updates/check" }).output(ExtensionUpdatesCheckedSchema),
+    list: oc
+        .route({
+        method: "GET",
+        path: "/extensions",
+        summary: "Installed extensions",
+        description: "Every extension installed here, resolved to the manifest the owner approved, which is what the app boots its extension host from. The code itself is served separately, because raw script bytes are not a JSON answer.",
+    })
+        .output(ExtensionsListSchema),
+    create: oc
+        .route({
+        method: "POST",
+        path: "/extensions/workspace",
+        summary: "Write a new extension in place",
+        description: "Scaffolds a working extension into this workspace and installs it. The only call here that creates one, and it exists because that folder is otherwise reachable only through an agent's file tools, which is a fine way to change an extension and a poor way to meet the idea of one.",
+    })
+        .input(WorkspaceExtensionCreateSchema)
+        .output(WorkspaceExtensionCreatedSchema),
+    settings: oc
+        .route({
+        method: "GET",
+        path: "/extensions/{id}/settings",
+        summary: "An extension's settings",
+        description: "The current values for the settings this extension declared it has.",
+    })
+        .input(CapabilityIdParamSchema)
+        .output(ExtensionSettingsSchema),
+    setSettings: oc
+        .route({
+        method: "POST",
+        path: "/extensions/{id}/settings",
+        summary: "Change an extension's settings",
+        description: "Writes new values. A key the extension never declared is refused rather than quietly stored, the same honesty rule that governs everything else an extension claims.",
+    })
+        .input(ExtensionSettingsInputSchema)
+        .output(OkSchema),
+    setEnabled: oc
+        .route({
+        method: "POST",
+        path: "/extensions/{id}/enabled",
+        summary: "Turn an extension on or off",
+        description: "The owner's switch. Turning one off stops its background processes at once. What it contributes to an agent's tools is rebuilt at the start of the next turn, and anything it adds to the sandbox image only at the next rebuild.",
+    })
+        .input(ExtensionEnabledInputSchema)
+        .output(OkSchema),
+    recordUsage: oc
+        .route({
+        method: "POST",
+        path: "/extensions/{id}/usage",
+        summary: "Record what an extension just used",
+        description: "Written by the app rather than measured by the daemon, because the permission gate runs in the browser: from the sandbox's side an extension's traffic is indistinguishable from anyone else's. This is how the record of which powers an extension actually exercises gets kept.",
+    })
+        .input(ExtensionUsageInputSchema)
+        .output(OkSchema),
+    readiness: oc
+        .route({
+        method: "GET",
+        path: "/extensions/{id}/readiness",
+        summary: "Whether an extension is fit to share",
+        description: "The checks that can be answered from an extension's own files, for an author about to publish. Read on demand rather than carried on the list, because it reads the code off disk each time.",
+    })
+        .input(CapabilityIdParamSchema)
+        .output(ExtensionReadinessSchema),
+    checkUpdates: oc
+        .route({
+        method: "POST",
+        path: "/extensions/updates/check",
+        summary: "Look for extension updates now",
+        description: "Compares every installed extension against its source and reports what is newer, what carries an advisory and what looks unhealthy. This also happens on a schedule; call it to check on demand.",
+    })
+        .output(ExtensionUpdatesCheckedSchema),
     updatePreview: oc
-        .route({ method: "POST", path: "/extensions/{id}/update/preview" })
+        .route({
+        method: "POST",
+        path: "/extensions/{id}/update/preview",
+        summary: "What an update would change",
+        description: "The read before the click: which versions are involved and exactly which powers the new code asks for that the running one does not. Costs one throwaway copy of the source, the same as browsing a registry entry.",
+    })
         .input(ExtensionUpdateActionSchema)
         .output(ExtensionUpdatePreviewSchema),
     applyUpdate: oc
-        .route({ method: "POST", path: "/extensions/{id}/update" })
+        .route({
+        method: "POST",
+        path: "/extensions/{id}/update",
+        summary: "Update an extension",
+        description: "The whole swap as one transaction: fetch, check, quiet the running one, replace it while keeping the outgoing copy one step back, restart and watch it come up. The existing configuration is kept, so a token for a private source survives what removing and re-adding would lose. Owner only, because it changes what code runs.",
+    })
         .input(ExtensionUpdateActionSchema)
         .output(ExtensionUpdateAppliedSchema),
-    revert: oc.route({ method: "POST", path: "/extensions/{id}/revert" }).input(CapabilityIdParamSchema).output(ExtensionUpdateAppliedSchema),
-    setUpdatePolicy: oc.route({ method: "POST", path: "/extensions/{id}/update-policy" }).input(ExtensionUpdatePolicyInputSchema).output(OkSchema),
+    revert: oc
+        .route({
+        method: "POST",
+        path: "/extensions/{id}/revert",
+        summary: "Go back to the previous version",
+        description: "Swaps the copy kept from before the last update back into place. Owner only, for the same reason updating is.",
+    })
+        .input(CapabilityIdParamSchema)
+        .output(ExtensionUpdateAppliedSchema),
+    setUpdatePolicy: oc
+        .route({
+        method: "POST",
+        path: "/extensions/{id}/update-policy",
+        summary: "How an extension should handle its own updates",
+        description: "The owner's standing answer for one extension: tell me, have an agent look at it, or just do it. Security advisories can be opted out of separately.",
+    })
+        .input(ExtensionUpdatePolicyInputSchema)
+        .output(OkSchema),
     processStatus: oc
-        .route({ method: "GET", path: "/extensions/{id}/processes/{name}" })
+        .route({
+        method: "GET",
+        path: "/extensions/{id}/processes/{name}",
+        summary: "Whether an extension's background process is up",
+        description: "The state of one process an extension declared, with the port it was given and its preview address if it has one.",
+    })
         .input(ExtensionProcessParamSchema)
         .output(ExtensionProcessStatusSchema),
-    processStart: oc.route({ method: "POST", path: "/extensions/{id}/processes/{name}/start" }).input(ExtensionProcessParamSchema).output(OkSchema),
-    processStop: oc.route({ method: "POST", path: "/extensions/{id}/processes/{name}/stop" }).input(ExtensionProcessParamSchema).output(OkSchema),
+    processStart: oc
+        .route({
+        method: "POST",
+        path: "/extensions/{id}/processes/{name}/start",
+        summary: "Start an extension's background process",
+        description: "Brings one of an extension's declared processes up in an attachable terminal.",
+    })
+        .input(ExtensionProcessParamSchema)
+        .output(OkSchema),
+    processStop: oc
+        .route({
+        method: "POST",
+        path: "/extensions/{id}/processes/{name}/stop",
+        summary: "Stop an extension's background process",
+        description: "Shuts one of an extension's declared processes down and frees its port.",
+    })
+        .input(ExtensionProcessParamSchema)
+        .output(OkSchema),
 };
 //# sourceMappingURL=extensions.contract.js.map

package/dist/contracts/extensions.contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"extensions.contract.js","sourceRoot":"","sources":["../../src/contracts/extensions.contract.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"extensions.contract.js","sourceRoot":"","sources":["../../src/contracts/extensions.contract.ts"],"names":[],"mappings":"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"}

package/dist/contracts/git.contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/git.contract.ts"],"names":[],"mappings":"AAoDA,eAAO,MAAM,WAAW;IACpB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAIP,KAAK;;;IAGL,WAAW;;;;;;;IACX,GAAG;;;;;;;;;;;;;;;;;;;;;IACH,UAAU;;;;;;;;;;;;;;;;;;;IACV,cAAc;;;;;;;;;;IAQd,SAAS;;;;;;;;;;;IACT,KAAK;;;;;;IAKL,QAAQ;;;;;;;;;;;;;;;;;;;;;;;IACR,IAAI;;;;;;;;IAIJ,OAAO;;;;;;;;;;;;;;IACP,SAAS;;;;;;;;;;;;;;;;;;;IACT,SAAS;;;;;;;;IACT,UAAU;;;;;;;;IACV,SAAS;;;;;;IACT,YAAY;;;;;;;IACZ,SAAS;;;;;;;IAET,SAAS;;;;;;;IACT,OAAO;;;;;;;;IACP,QAAQ;;;;;;;IACR,UAAU;;;;;;;IACV,MAAM;;;;;;;IACN,IAAI;;;;;;;IACJ,KAAK;;;;;;;IACL,MAAM;;;;;;;IACN,KAAK;;;;;;;;;;;;IACL,QAAQ;;;;;;;;;;;;;;IACR,MAAM;;;;;;;IACN,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACN,OAAO;;;;;;IAGP,KAAK;;;;;;IACL,OAAO;;;;;;IAIP,QAAQ;;;;;;;;;;;;;;;;;;;IACR,cAAc;;;;;;;;IACd,YAAY;;;;;;;IAIZ,MAAM;;;;;;;;;IACN,KAAK;;;;;;IACL,IAAI;;;;;;IACJ,IAAI;;;;;;;IACJ,KAAK;;;;;IACL,QAAQ;;;;;;;IACR,SAAS;;;;;;;IAIT,WAAW;;;;;;;;;;;;;;CACd,CAAC"}
+{"version":3,"file":"git.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/git.contract.ts"],"names":[],"mappings":"AAoDA,eAAO,MAAM,WAAW;IACpB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAYP,KAAK;;;IAWL,WAAW;;;;;;;IASX,GAAG;;;;;;;;;;;;;;;;;;;;;IAUH,UAAU;;;;;;;;;;;;;;;;;;;IAUV,cAAc;;;;;;;;;;IAiBd,SAAS;;;;;;;;;;;IAUT,KAAK;;;;;;IAcL,QAAQ;;;;;;;;;;;;;;;;;;;;;;;IAUR,IAAI;;;;;;;;IAaJ,OAAO;;;;;;;;;;;;;;IAUP,SAAS;;;;;;;;;;;;;;;;;;;IAUT,SAAS;;;;;;;;IAUT,UAAU;;;;;;;;IAUV,SAAS;;;;;;IAUT,YAAY;;;;;;;IASZ,SAAS;;;;;;;IAUT,SAAS;;;;;;;IAST,OAAO;;;;;;;;IAUP,QAAQ;;;;;;;IAUR,UAAU;;;;;;;IAUV,MAAM;;;;;;;IAUN,IAAI;;;;;;;IAUJ,KAAK;;;;;;;IAUL,MAAM;;;;;;;IAUN,KAAK;;;;;;;;;;;;IAUL,QAAQ;;;;;;;;;;;;;;IAUR,MAAM;;;;;;;IAUN,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUN,OAAO;;;;;;IAYP,KAAK;;;;;;IASL,OAAO;;;;;;IAYP,QAAQ;;;;;;;;;;;;;;;;;;;IAUR,cAAc;;;;;;;;IAUd,YAAY;;;;;;;IAaZ,MAAM;;;;;;;;;IAUN,KAAK;;;;;;IAUL,IAAI;;;;;;IAUJ,IAAI;;;;;;;IAUJ,KAAK;;;;;IAUL,QAAQ;;;;;;;IASR,SAAS;;;;;;;IAaT,WAAW;;;;;;;;;;;;;;CAUd,CAAC"}

package/dist/contracts/git.contract.js

@@ -1,48 +1,389 @@
 import { oc } from "@orpc/contract";
 import { CommitResultSchema, CommitSchema, DiscardSchema, FileDiffSchema, GitActionResultSchema, GitBranchCreateAtSchema, GitBranchCreateSchema, GitBranchDeleteSchema, GitBranchesSchema, GitChangesSchema, GitCheckoutSchema, GitCommitActionSchema, GitCommitDiffQuerySchema, GitCommitDiffSchema, GitCommitFileDiffQuerySchema, GitFileDiffQuerySchema, GitFileQuerySchema, GitFileSchema, GitFilesSchema, GitFileWriteSchema, GitLogQuerySchema, GitLogSchema, GitOperationStateSchema, GitPublishFileResultSchema, GitPublishFileSchema, GitUndoSchema, GitUndoStateSchema, GitRemoteReposSchema, GitRemoteStateSchema, GitReposSchema, GitResetSchema, GitStageSchema, GitStatusSchema, GitTagCreateSchema, GitTagDeleteSchema, GitTagPushSchema, OkSchema, PushSchema, RepoParamSchema, StashApplySchema, StashDiffQuerySchema, StashListSchema, StashPushSchema, StashRefParamSchema, } from "../schemas.js";
 export const gitContract = {
-    changes: oc.route({ method: "GET", path: "/git/changes" }).output(GitChangesSchema),
-    repos: oc.route({ method: "GET", path: "/git/repos" }).output(GitReposSchema),
-    remoteRepos: oc.route({ method: "GET", path: "/git/remote-repos" }).output(GitRemoteReposSchema),
-    log: oc.route({ method: "GET", path: "/git/{repo}/log" }).input(GitLogQuerySchema).output(GitLogSchema),
-    commitDiff: oc.route({ method: "GET", path: "/git/{repo}/commit-diff" }).input(GitCommitDiffQuerySchema).output(GitCommitDiffSchema),
-    commitFileDiff: oc.route({ method: "GET", path: "/git/{repo}/commit-file-diff" }).input(GitCommitFileDiffQuerySchema).output(FileDiffSchema),
-    operation: oc.route({ method: "GET", path: "/git/{repo}/operation" }).input(RepoParamSchema).output(GitOperationStateSchema),
-    abort: oc.route({ method: "POST", path: "/git/{repo}/abort" }).input(RepoParamSchema).output(GitActionResultSchema),
-    undoable: oc.route({ method: "GET", path: "/git/{repo}/undo" }).input(RepoParamSchema).output(GitUndoStateSchema),
-    undo: oc.route({ method: "POST", path: "/git/{repo}/undo" }).input(GitUndoSchema).output(GitActionResultSchema),
-    stashes: oc.route({ method: "GET", path: "/git/{repo}/stashes" }).input(RepoParamSchema).output(StashListSchema),
-    stashDiff: oc.route({ method: "GET", path: "/git/{repo}/stash-diff" }).input(StashDiffQuerySchema).output(GitCommitDiffSchema),
-    stashPush: oc.route({ method: "POST", path: "/git/{repo}/stash" }).input(StashPushSchema).output(GitActionResultSchema),
-    stashApply: oc.route({ method: "POST", path: "/git/{repo}/stash/apply" }).input(StashApplySchema).output(GitActionResultSchema),
-    stashDrop: oc.route({ method: "POST", path: "/git/{repo}/stash/drop" }).input(StashRefParamSchema).output(OkSchema),
-    createBranch: oc.route({ method: "POST", path: "/git/{repo}/branch" }).input(GitBranchCreateSchema).output(OkSchema),
-    createTag: oc.route({ method: "POST", path: "/git/{repo}/tag" }).input(GitTagCreateSchema).output(OkSchema),
-    deleteTag: oc.route({ method: "POST", path: "/git/{repo}/tag/delete" }).input(GitTagDeleteSchema).output(OkSchema),
-    pushTag: oc.route({ method: "POST", path: "/git/{repo}/tag/push" }).input(GitTagPushSchema).output(GitActionResultSchema),
-    checkout: oc.route({ method: "POST", path: "/git/{repo}/checkout" }).input(GitCheckoutSchema).output(GitActionResultSchema),
-    cherryPick: oc.route({ method: "POST", path: "/git/{repo}/cherry-pick" }).input(GitCommitActionSchema).output(GitActionResultSchema),
-    revert: oc.route({ method: "POST", path: "/git/{repo}/revert" }).input(GitCommitActionSchema).output(GitActionResultSchema),
-    drop: oc.route({ method: "POST", path: "/git/{repo}/drop" }).input(GitCommitActionSchema).output(GitActionResultSchema),
-    merge: oc.route({ method: "POST", path: "/git/{repo}/merge" }).input(GitCommitActionSchema).output(GitActionResultSchema),
-    rebase: oc.route({ method: "POST", path: "/git/{repo}/rebase" }).input(GitCommitActionSchema).output(GitActionResultSchema),
-    reset: oc.route({ method: "POST", path: "/git/{repo}/reset" }).input(GitResetSchema).output(GitActionResultSchema),
-    fileDiff: oc.route({ method: "GET", path: "/git/{repo}/file-diff" }).input(GitFileDiffQuerySchema).output(FileDiffSchema),
-    status: oc.route({ method: "GET", path: "/git/{repo}/status" }).input(RepoParamSchema).output(GitStatusSchema),
-    commit: oc.route({ method: "POST", path: "/git/{repo}/commit" }).input(CommitSchema).output(CommitResultSchema),
-    discard: oc.route({ method: "POST", path: "/git/{repo}/discard" }).input(DiscardSchema).output(OkSchema),
-    stage: oc.route({ method: "POST", path: "/git/{repo}/stage" }).input(GitStageSchema).output(OkSchema),
-    unstage: oc.route({ method: "POST", path: "/git/{repo}/unstage" }).input(GitStageSchema).output(OkSchema),
-    branches: oc.route({ method: "GET", path: "/git/{repo}/branches" }).input(RepoParamSchema).output(GitBranchesSchema),
-    createBranchAt: oc.route({ method: "POST", path: "/git/{repo}/branches" }).input(GitBranchCreateAtSchema).output(OkSchema),
-    deleteBranch: oc.route({ method: "POST", path: "/git/{repo}/branches/delete" }).input(GitBranchDeleteSchema).output(OkSchema),
-    remote: oc.route({ method: "GET", path: "/git/{repo}/remote" }).input(RepoParamSchema).output(GitRemoteStateSchema),
-    fetch: oc.route({ method: "POST", path: "/git/{repo}/fetch" }).input(RepoParamSchema).output(GitActionResultSchema),
-    pull: oc.route({ method: "POST", path: "/git/{repo}/pull" }).input(RepoParamSchema).output(GitActionResultSchema),
-    push: oc.route({ method: "POST", path: "/git/{repo}/push" }).input(PushSchema).output(GitActionResultSchema),
-    files: oc.route({ method: "GET", path: "/git/{repo}/files" }).input(RepoParamSchema).output(GitFilesSchema),
-    readFile: oc.route({ method: "GET", path: "/git/{repo}/file" }).input(GitFileQuerySchema).output(GitFileSchema),
-    writeFile: oc.route({ method: "PUT", path: "/git/{repo}/file" }).input(GitFileWriteSchema).output(OkSchema),
-    publishFile: oc.route({ method: "POST", path: "/git/{repo}/publish-file" }).input(GitPublishFileSchema).output(GitPublishFileResultSchema),
+    changes: oc
+        .route({
+        method: "GET",
+        path: "/git/changes",
+        summary: "Uncommitted work across every repo",
+        description: "The workspace's whole review set in one answer: every repo that has something uncommitted, and within it every changed file with its status and line counts. This is what the Changes panel draws, and it is the call to make when you want to know whether a workspace is clean without walking the repos yourself.",
+    })
+        .output(GitChangesSchema),
+    repos: oc
+        .route({
+        method: "GET",
+        path: "/git/repos",
+        summary: "Every git repo in the workspace",
+        description: "The repos the daemon found under the workspace root, each with the id every other call in this group expects as its `{repo}` segment. The workspace root itself is always present as `root`.",
+    })
+        .output(GitReposSchema),
+    remoteRepos: oc
+        .route({
+        method: "GET",
+        path: "/git/remote-repos",
+        summary: "Repos matched to their remotes",
+        description: "The same repo list, but with the forge host and `owner/name` each one's remote points at. Use it to recognise a workspace repo in a list of names that came from somewhere else, such as a set of pull requests. Costs a remote lookup per repo, which is why it is separate from the plain repo list.",
+    })
+        .output(GitRemoteReposSchema),
+    log: oc
+        .route({
+        method: "GET",
+        path: "/git/{repo}/log",
+        summary: "Commit history for one repo",
+        description: "A page of commits on the current branch, newest first, each with its author, subject, timestamp and the refs pointing at it. Paginate with the cursor the answer hands back rather than by offset, so a commit landing mid-scroll does not shift the page under you.",
+    })
+        .input(GitLogQuerySchema)
+        .output(GitLogSchema),
+    commitDiff: oc
+        .route({
+        method: "GET",
+        path: "/git/{repo}/commit-diff",
+        summary: "What one commit changed",
+        description: "The list of files a single commit touched, with per-file status and line counts but not the content. Fetch the content of any one of them with the commit file diff call, so a commit with a thousand files stays one cheap answer.",
+    })
+        .input(GitCommitDiffQuerySchema)
+        .output(GitCommitDiffSchema),
+    commitFileDiff: oc
+        .route({
+        method: "GET",
+        path: "/git/{repo}/commit-file-diff",
+        summary: "One file's before and after at a commit",
+        description: "Both sides of a single file as of one commit: the content its parent had and the content that commit left. The daemon returns whole sides rather than a patch, so a caller can render the comparison however it likes.",
+    })
+        .input(GitCommitFileDiffQuerySchema)
+        .output(FileDiffSchema),
+    operation: oc
+        .route({
+        method: "GET",
+        path: "/git/{repo}/operation",
+        summary: "Whether a merge or rebase is halted mid-flight",
+        description: "Names the git operation the worktree is stuck inside, if any: a conflicted merge, an interrupted rebase, a half-applied cherry-pick. Check this first when another call refuses, because a halted worktree is the usual reason and the abort call is the way out.",
+    })
+        .input(RepoParamSchema)
+        .output(GitOperationStateSchema),
+    abort: oc
+        .route({
+        method: "POST",
+        path: "/git/{repo}/abort",
+        summary: "Abandon a halted merge or rebase",
+        description: "Runs git's own abort for whichever operation has the worktree halted, putting the repo back where it stood before the operation started. Nothing else clears that state.",
+    })
+        .input(RepoParamSchema)
+        .output(GitActionResultSchema),
+    undoable: oc
+        .route({
+        method: "GET",
+        path: "/git/{repo}/undo",
+        summary: "What undoing the last action would do",
+        description: "Reads the branch's reflog to describe the move that undo would reverse, and hands back the commit it would land on. Pass that commit to the undo call as proof you looked, and an undo prepared against a view that has since moved is refused rather than landing somewhere unexamined.",
+    })
+        .input(RepoParamSchema)
+        .output(GitUndoStateSchema),
+    undo: oc
+        .route({
+        method: "POST",
+        path: "/git/{repo}/undo",
+        summary: "Move the branch back one step",
+        description: "Walks the current branch back to where it pointed before its last action. This moves the branch ref and leaves the working tree alone, which is the opposite of restoring a checkpoint. Requires the commit the matching read handed you.",
+    })
+        .input(GitUndoSchema)
+        .output(GitActionResultSchema),
+    stashes: oc
+        .route({
+        method: "GET",
+        path: "/git/{repo}/stashes",
+        summary: "Everything set aside in the stash",
+        description: "The repo's stash entries, newest first, each with the message and the commit behind it. A stash entry is a commit, so it reads the same way a log entry does and its contents come back from the stash diff call.",
+    })
+        .input(RepoParamSchema)
+        .output(StashListSchema),
+    stashDiff: oc
+        .route({
+        method: "GET",
+        path: "/git/{repo}/stash-diff",
+        summary: "What one stash entry holds",
+        description: "The files a single stash entry would bring back, with per-file status and line counts. The same shape a commit diff has, because a stash entry is a commit.",
+    })
+        .input(StashDiffQuerySchema)
+        .output(GitCommitDiffSchema),
+    stashPush: oc
+        .route({
+        method: "POST",
+        path: "/git/{repo}/stash",
+        summary: "Set the current changes aside",
+        description: "Moves the working tree's changes onto the stash and leaves a clean tree behind. Nothing is lost: the entry is a commit you can inspect, apply or drop afterwards.",
+    })
+        .input(StashPushSchema)
+        .output(GitActionResultSchema),
+    stashApply: oc
+        .route({
+        method: "POST",
+        path: "/git/{repo}/stash/apply",
+        summary: "Bring a stash entry back",
+        description: "Replays one stash entry onto the working tree. A conflict is reported in the answer rather than raised as a failure, because a conflicting apply is an ordinary outcome a screen has to render.",
+    })
+        .input(StashApplySchema)
+        .output(GitActionResultSchema),
+    stashDrop: oc
+        .route({
+        method: "POST",
+        path: "/git/{repo}/stash/drop",
+        summary: "Discard a stash entry",
+        description: "Deletes one stash entry. This is the only unrecoverable call in the stash set, so the daemon takes a checkpoint of the workspace first.",
+    })
+        .input(StashRefParamSchema)
+        .output(OkSchema),
+    createBranch: oc
+        .route({
+        method: "POST",
+        path: "/git/{repo}/branch",
+        summary: "Start a branch at a commit",
+        description: "Points a new branch name at any commit, without moving HEAD. Use the checkout call if you also want to switch to it.",
+    })
+        .input(GitBranchCreateSchema)
+        .output(OkSchema),
+    createTag: oc
+        .route({
+        method: "POST",
+        path: "/git/{repo}/tag",
+        summary: "Tag a commit",
+        description: "Puts a tag on any commit. Local only: pushing it to the remote is a separate call.",
+    })
+        .input(GitTagCreateSchema)
+        .output(OkSchema),
+    deleteTag: oc
+        .route({
+        method: "POST",
+        path: "/git/{repo}/tag/delete",
+        summary: "Remove a tag",
+        description: "Deletes a tag locally. A tag already pushed stays on the remote until it is deleted there too.",
+    })
+        .input(GitTagDeleteSchema)
+        .output(OkSchema),
+    pushTag: oc
+        .route({
+        method: "POST",
+        path: "/git/{repo}/tag/push",
+        summary: "Send a tag to the remote",
+        description: "Pushes one tag to the repo's remote. Reports the outcome rather than failing, since a missing remote or missing credentials are ordinary answers here.",
+    })
+        .input(GitTagPushSchema)
+        .output(GitActionResultSchema),
+    checkout: oc
+        .route({
+        method: "POST",
+        path: "/git/{repo}/checkout",
+        summary: "Switch to a branch or commit",
+        description: "Moves HEAD to a branch, tag or commit and reshapes the working tree to match. The daemon takes a checkpoint first, so an unexpected result is recoverable. Uncommitted work that would be overwritten is reported instead of being trampled.",
+    })
+        .input(GitCheckoutSchema)
+        .output(GitActionResultSchema),
+    cherryPick: oc
+        .route({
+        method: "POST",
+        path: "/git/{repo}/cherry-pick",
+        summary: "Replay one commit onto this branch",
+        description: "Applies a single commit's changes on top of the current branch as a new commit. A conflict comes back in the answer, with the halted state readable from the operation call.",
+    })
+        .input(GitCommitActionSchema)
+        .output(GitActionResultSchema),
+    revert: oc
+        .route({
+        method: "POST",
+        path: "/git/{repo}/revert",
+        summary: "Undo a commit with a new commit",
+        description: "Adds a commit that reverses an earlier one, leaving the history intact. This is the safe way to take something back on a branch other people have pulled.",
+    })
+        .input(GitCommitActionSchema)
+        .output(GitActionResultSchema),
+    drop: oc
+        .route({
+        method: "POST",
+        path: "/git/{repo}/drop",
+        summary: "Remove a commit from history",
+        description: "Rewrites the branch so one commit is no longer in it. History changes, so this is for branches nobody else has pulled. A checkpoint is taken first.",
+    })
+        .input(GitCommitActionSchema)
+        .output(GitActionResultSchema),
+    merge: oc
+        .route({
+        method: "POST",
+        path: "/git/{repo}/merge",
+        summary: "Merge another branch in",
+        description: "Merges a branch or commit into the current one. Conflicts are reported in the answer and leave the worktree halted, which the operation call explains and the abort call clears.",
+    })
+        .input(GitCommitActionSchema)
+        .output(GitActionResultSchema),
+    rebase: oc
+        .route({
+        method: "POST",
+        path: "/git/{repo}/rebase",
+        summary: "Replay this branch onto another",
+        description: "Moves the current branch's commits on top of a different base. History changes. Conflicts halt the rebase and are reported rather than raised, so the operation and abort calls are the way through.",
+    })
+        .input(GitCommitActionSchema)
+        .output(GitActionResultSchema),
+    reset: oc
+        .route({
+        method: "POST",
+        path: "/git/{repo}/reset",
+        summary: "Move the branch to a commit",
+        description: "Repoints the current branch at another commit, optionally reshaping the working tree to match. The destructive modes take a checkpoint first.",
+    })
+        .input(GitResetSchema)
+        .output(GitActionResultSchema),
+    fileDiff: oc
+        .route({
+        method: "GET",
+        path: "/git/{repo}/file-diff",
+        summary: "One file's committed and working copies",
+        description: "Both sides of a file as it stands right now: what the last commit holds and what is on disk. This is what a review pane shows for an uncommitted change.",
+    })
+        .input(GitFileDiffQuerySchema)
+        .output(FileDiffSchema),
+    status: oc
+        .route({
+        method: "GET",
+        path: "/git/{repo}/status",
+        summary: "One repo's branch and pending changes",
+        description: "The current branch, its sync position against the remote, and every staged, unstaged and untracked path. The single-repo counterpart to the workspace-wide changes call.",
+    })
+        .input(RepoParamSchema)
+        .output(GitStatusSchema),
+    commit: oc
+        .route({
+        method: "POST",
+        path: "/git/{repo}/commit",
+        summary: "Commit the pending changes",
+        description: "Records a commit with your message. Give it a list of paths to commit only those, or leave it out to commit everything pending. The answer carries the commit it created.",
+    })
+        .input(CommitSchema)
+        .output(CommitResultSchema),
+    discard: oc
+        .route({
+        method: "POST",
+        path: "/git/{repo}/discard",
+        summary: "Throw away pending changes",
+        description: "Restores files to their committed state and deletes untracked ones. Give it paths to discard only those. The daemon checkpoints the workspace first, so this is recoverable from the timeline.",
+    })
+        .input(DiscardSchema)
+        .output(OkSchema),
+    stage: oc
+        .route({
+        method: "POST",
+        path: "/git/{repo}/stage",
+        summary: "Mark paths for the next commit",
+        description: "Adds paths to the index. Nothing on disk changes, so this is always safe and always reversible with the unstage call.",
+    })
+        .input(GitStageSchema)
+        .output(OkSchema),
+    unstage: oc
+        .route({
+        method: "POST",
+        path: "/git/{repo}/unstage",
+        summary: "Take paths back out of the next commit",
+        description: "Removes paths from the index and leaves the file itself untouched. The exact reverse of staging.",
+    })
+        .input(GitStageSchema)
+        .output(OkSchema),
+    branches: oc
+        .route({
+        method: "GET",
+        path: "/git/{repo}/branches",
+        summary: "Local branches and how far each has drifted",
+        description: "Every local branch with how many commits it sits ahead of and behind its remote counterpart, so a branch switcher can show sync state without a call per branch.",
+    })
+        .input(RepoParamSchema)
+        .output(GitBranchesSchema),
+    createBranchAt: oc
+        .route({
+        method: "POST",
+        path: "/git/{repo}/branches",
+        summary: "Create a branch from a starting point",
+        description: "Makes a branch at a named start point and optionally switches to it. The branch-switcher counterpart to creating a branch at a specific commit.",
+    })
+        .input(GitBranchCreateAtSchema)
+        .output(OkSchema),
+    deleteBranch: oc
+        .route({
+        method: "POST",
+        path: "/git/{repo}/branches/delete",
+        summary: "Delete a local branch",
+        description: "Removes a branch from the repo. Unmerged work is refused unless you ask for it to be forced, and the remote branch is untouched either way.",
+    })
+        .input(GitBranchDeleteSchema)
+        .output(OkSchema),
+    remote: oc
+        .route({
+        method: "GET",
+        path: "/git/{repo}/remote",
+        summary: "Sync position against the remote",
+        description: "How far the current branch sits ahead of and behind its remote, as of the last fetch, plus whether a remote and working credentials exist at all. This is a read of what the daemon already knows, not a network call, which is why fetching is a separate button.",
+    })
+        .input(RepoParamSchema)
+        .output(GitRemoteStateSchema),
+    fetch: oc
+        .route({
+        method: "POST",
+        path: "/git/{repo}/fetch",
+        summary: "Refresh what the remote holds",
+        description: "Contacts the remote and updates the daemon's picture of it without touching your branch. Run this before trusting the sync position.",
+    })
+        .input(RepoParamSchema)
+        .output(GitActionResultSchema),
+    pull: oc
+        .route({
+        method: "POST",
+        path: "/git/{repo}/pull",
+        summary: "Bring remote commits down",
+        description: "Fetches and integrates the remote's commits into the current branch. A pull that cannot fast-forward is reported in the answer rather than raised, because that is an ordinary thing to be told.",
+    })
+        .input(RepoParamSchema)
+        .output(GitActionResultSchema),
+    push: oc
+        .route({
+        method: "POST",
+        path: "/git/{repo}/push",
+        summary: "Send commits to the remote",
+        description: "Pushes the current branch, setting its upstream on first push. A rejected push, a missing remote and missing credentials all come back as reported outcomes rather than failures.",
+    })
+        .input(PushSchema)
+        .output(GitActionResultSchema),
+    files: oc
+        .route({
+        method: "GET",
+        path: "/git/{repo}/files",
+        summary: "Every tracked path in the repo",
+        description: "The flat list of files git tracks, which is what a file picker or a search box wants. Ignored and untracked files are not in it.",
+    })
+        .input(RepoParamSchema)
+        .output(GitFilesSchema),
+    readFile: oc
+        .route({
+        method: "GET",
+        path: "/git/{repo}/file",
+        summary: "Read a file from the repo",
+        description: "The contents of one file as it stands on disk. A path that climbs out of the repo is refused.",
+    })
+        .input(GitFileQuerySchema)
+        .output(GitFileSchema),
+    writeFile: oc
+        .route({
+        method: "PUT",
+        path: "/git/{repo}/file",
+        summary: "Write a file into the repo",
+        description: "Replaces one file's contents, creating it and its parent folders if they are missing. Nothing is committed: the change shows up as pending work.",
+    })
+        .input(GitFileWriteSchema)
+        .output(OkSchema),
+    publishFile: oc
+        .route({
+        method: "POST",
+        path: "/git/{repo}/publish-file",
+        summary: "Write, commit and push one file",
+        description: "The three steps as a single call with a single answer, committing only the path you named and leaving any other pending work alone. Being on a side branch, having no remote and having no credentials are all reported rather than raised.",
+    })
+        .input(GitPublishFileSchema)
+        .output(GitPublishFileResultSchema),
 };
 //# sourceMappingURL=git.contract.js.map