@agimon-ai/po-git 0.0.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vuong Ngo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,83 @@
+# @agimon-ai/po-git
+
+Git worktree sessions for Po: spawn an isolated worktree with its own session and manage it from the parent
+
+This package is a composable [Po](https://www.npmjs.com/package/@agimon-ai/po) subsystem. Select it through the native distribution configuration.
+
+## Requirements
+
+- Node.js 24 or newer
+- A Po native server host
+
+## Install
+
+Add `@agimon-ai/po-git` to a selected layer in `.po/modes.yaml`, then run `po sync`. Native metadata selects its server and browser facets; there is no standalone Pi entry.
+
+## Use
+
+Use the browser worktree controls or the native worktree tool.
+
+### New-session dialog
+
+In the web cockpit, po-git replaces the new-session dialog for a git workspace. It offers three choices:
+
+- **Existing branch**: a worktree session on a local branch, or on a remote-only branch (a local tracking branch is created). Branches already checked out elsewhere are disabled.
+- **New branch**: a worktree session on a new branch from a base, preselected to the repository's default branch.
+- **No branch**: a plain session in the workspace folder.
+
+Worktree sessions opened here start at the top level of the session rail, with no parent. A workspace that is not a git checkout offers the plain session only. For remote devices, creating a worktree session needs the same passkey step-up as any new session.
+
+## Package behavior
+
+### Review this session's changes
+
+The `# git` group in the activity dock shows the focused checkout's branch and `+added -removed`, followed by its worktrees. Regular and worktree sessions use the same diff row, even when they have no child worktrees. The row opens review (`g d`); the group heading opens worktrees (`g w`). The counts measure this session's checkout against its base, the way a pull request counts it: every commit since the branch left its base, plus staged, unstaged and untracked work. The base is the worktree's recorded base when the session owns one, then the remote's default branch (`origin/HEAD`, `origin/main`, `origin/master`), then the branch's upstream; with none of those only uncommitted work counts. The count refreshes after every tool call and settled turn; nothing polls.
+
+The lane opens the review tab: changed files grouped by folder on the left, every diff stacked on the right. Select lines, or click a line number, to write a comment under that line; a comment on a removed line points at the old file. Comments queue on the tab, and **send review** hands them to the agent as one message, queued behind a running turn rather than dropped.
+
+### Pull, push and rebase
+
+The review tab's header runs them by hand, one at a time per session:
+
+- **pull** fetches, then rebases local commits onto the upstream.
+- **rebase** fetches the base's remote, then rebases onto the base.
+- **push** sets the upstream on a first push. A push the remote rejects after a rebase asks first, then forces with `--force-with-lease --force-if-includes`, which git refuses if the remote holds commits this branch never fetched and integrated.
+
+Pull and rebase refuse uncommitted changes. A rebase that stops on conflicts stays paused and lists the files, with **ask agent to resolve** and **abort rebase**.
+
+### Remote auth, per workspace
+
+Settings, then repository, then **git remote**, sets how one workspace's sessions reach the remote when you pull, push or rebase from the cockpit: this machine's own git (the default), an SSH key path (blank uses your ssh config and ssh-agent), or an HTTPS username and token for one host. Worktree sessions use their workspace's setup.
+
+The setup lives outside every repository in `~/.po/git/credentials.json` (folder `0700`, file `0600`). The token is write-only: the page shows only that one is saved. It goes into the environment of one `git fetch` or `git push` at a time, only for the host it was entered for, with git's credential helper list emptied first so the macOS keychain never stores it. The agent's own git commands never see these credentials. Saving from a remote device needs passkey step-up. An unknown SSH host is refused: trust it once with `ssh -T git@<host>` in a terminal.
+
+## Help
+
+The native server root registers `po-use-git` as a skill resource and the package index as Help-gated context. Guidance stays published under `src/prompts` and is not exported or copied into `dist`.
+
+## Public API
+
+```ts
+import { DefaultGitExtensionService } from '@agimon-ai/po-git';
+```
+
+The service layer is host-neutral. The native session server root owns worktree operations, resources, hooks, and message-inbox disposal. Browser routes own presentation. Public symbols are forwarded through flat `src/exports` files.
+
+## Development
+
+```bash
+pnpm build
+pnpm typecheck
+pnpm test
+pnpm lint
+pnpm exec vibe-lint check .
+npm pack --dry-run
+```
+
+Maintained by [Agimon](https://agimon.ai/about).
+
+## License
+
+MIT
+
+Native routed declarations own commands, APIs, resources, hooks, and tools. Services own worktree operations and filesystem persistence. Session delivery is consumed through the fixed Session service; no terminal compatibility entry is published.

package/dist/apiContracts.cjs

@@ -0,0 +1,387 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+let _agimon_ai_po_core_apiContracts = require("@agimon-ai/po-core/apiContracts");
+let typebox = require("typebox");
+//#region src/schemas/apiContracts.ts
+const S = typebox.Type.String();
+const B = typebox.Type.Boolean();
+const O = typebox.Type.Optional;
+const literals = (values) => typebox.Type.Union(values.map((value) => typebox.Type.Literal(value)));
+const RecordSchema = typebox.Type.Object({
+	version: typebox.Type.Literal(1),
+	id: S,
+	branch: S,
+	baseRef: S,
+	path: S,
+	repositoryRoot: S,
+	sessionId: S,
+	parentSessionId: typebox.Type.Optional(S),
+	status: literals([
+		"spawning",
+		"running",
+		"closing",
+		"orphaned"
+	]),
+	createdAt: S
+});
+const ErrorTargetSchema = typebox.Type.Union([typebox.Type.Object({ action: typebox.Type.Literal("create") }), typebox.Type.Object({
+	action: typebox.Type.Literal("close"),
+	id: S
+})]);
+const WorktreesPayloadSchema = typebox.Type.Object({
+	worktrees: typebox.Type.Array(typebox.Type.Object({
+		id: S,
+		branch: S,
+		path: S,
+		sessionId: typebox.Type.Union([S, typebox.Type.Null()]),
+		orphaned: B,
+		unowned: B
+	})),
+	pending: O(S),
+	error: O(S),
+	errorTarget: O(ErrorTargetSchema)
+});
+const WorktreesCommandSchema = typebox.Type.Union([typebox.Type.Object({
+	action: typebox.Type.Literal("create"),
+	branch: S,
+	baseRef: O(S),
+	reservationId: O(typebox.Type.String({
+		minLength: 1,
+		pattern: "^[A-Za-z0-9_-]+$"
+	}))
+}), typebox.Type.Object({
+	action: typebox.Type.Literal("close"),
+	id: S,
+	force: O(B)
+})]);
+const N = typebox.Type.Integer({ minimum: 0 });
+const ChangesSchema = typebox.Type.Object({
+	branch: O(S),
+	base: O(S),
+	added: N,
+	removed: N,
+	files: N,
+	truncated: O(B),
+	upstream: O(typebox.Type.Object({
+		ref: S,
+		ahead: N,
+		behind: N
+	})),
+	rebase: O(typebox.Type.Object({ conflicts: typebox.Type.Array(S) }))
+});
+const SyncErrorTargetSchema = typebox.Type.Union([typebox.Type.Object({ action: literals([
+	"pull",
+	"rebase",
+	"abort-rebase"
+]) }), typebox.Type.Object({
+	action: typebox.Type.Literal("push"),
+	forceRequired: O(typebox.Type.Literal(true))
+})]);
+const GitChangesPayloadSchema = typebox.Type.Object({
+	changes: O(ChangesSchema),
+	pending: O(S),
+	error: O(S),
+	errorTarget: O(SyncErrorTargetSchema)
+});
+const GitChangesCommandSchema = typebox.Type.Union([typebox.Type.Object({ action: literals([
+	"pull",
+	"rebase",
+	"abort-rebase"
+]) }), typebox.Type.Object({
+	action: typebox.Type.Literal("push"),
+	force: O(typebox.Type.Literal(true))
+})]);
+const AuthViewSchema = typebox.Type.Object({
+	method: literals([
+		"none",
+		"ssh",
+		"https"
+	]),
+	ssh: O(typebox.Type.Object({ keyPath: O(S) })),
+	https: O(typebox.Type.Object({
+		host: S,
+		username: S,
+		hasToken: B
+	}))
+});
+const AuthSaveSchema = typebox.Type.Union([
+	typebox.Type.Object({ method: typebox.Type.Literal("none") }),
+	typebox.Type.Object({
+		method: typebox.Type.Literal("ssh"),
+		keyPath: O(S)
+	}),
+	typebox.Type.Object({
+		method: typebox.Type.Literal("https"),
+		host: S,
+		username: S,
+		token: O(typebox.Type.String({ writeOnly: true }))
+	})
+]);
+const DiffRowSchema = typebox.Type.Object({
+	marker: literals([
+		"+",
+		"-",
+		" "
+	]),
+	line: N,
+	content: S
+});
+const ReviewSummarySchema = typebox.Type.Object({
+	repository: B,
+	branch: O(S),
+	base: O(S),
+	mergeBase: O(S),
+	truncated: O(B),
+	files: typebox.Type.Array(typebox.Type.Object({
+		path: S,
+		status: literals([
+			"added",
+			"modified",
+			"deleted",
+			"untracked",
+			"conflicted"
+		]),
+		added: N,
+		removed: N,
+		binary: O(B)
+	}))
+});
+const ReviewFileSchema = typebox.Type.Object({
+	path: S,
+	hunks: typebox.Type.Array(typebox.Type.Object({
+		start: N,
+		rows: typebox.Type.Array(DiffRowSchema)
+	})),
+	binary: O(typebox.Type.Literal(true)),
+	tooLarge: O(typebox.Type.Literal(true))
+});
+const query = [{
+	name: "repositoryId",
+	in: "query",
+	required: true,
+	schema: S
+}, {
+	name: "sessionId",
+	in: "query",
+	required: true,
+	schema: S
+}];
+const apiContracts = (0, _agimon_ai_po_core_apiContracts.defineApiContract)({
+	version: 1,
+	dynamic: [],
+	http: ["global", "workspace"].flatMap((scope) => [
+		{
+			id: "git.list",
+			scope,
+			basePath: "git",
+			path: "/worktrees",
+			method: "GET",
+			authentication: "owner",
+			description: "List admitted repository worktrees.",
+			parameters: query.map((item) => ({
+				...item,
+				required: item.name === "repositoryId"
+			})),
+			responses: (0, _agimon_ai_po_core_apiContracts.jsonApiResponses)(typebox.Type.Object({ worktrees: typebox.Type.Array(RecordSchema) }))
+		},
+		{
+			id: "git.create",
+			scope,
+			basePath: "git",
+			path: "/worktrees",
+			method: "POST",
+			authentication: "owner",
+			description: "Create a worktree and session.",
+			parameters: query,
+			body: {
+				required: true,
+				contentType: "application/json",
+				schema: typebox.Type.Object({
+					branch: typebox.Type.String({ minLength: 1 }),
+					baseRef: O(S),
+					name: O(S)
+				})
+			},
+			responses: (0, _agimon_ai_po_core_apiContracts.jsonApiResponses)(typebox.Type.Object({ worktree: RecordSchema }), 201)
+		},
+		{
+			id: "git.close",
+			scope,
+			basePath: "git",
+			path: "/worktrees/{id}",
+			method: "DELETE",
+			authentication: "owner",
+			description: "Close a worktree.",
+			parameters: [...query, {
+				name: "force",
+				in: "query",
+				required: false,
+				schema: B
+			}],
+			responses: (0, _agimon_ai_po_core_apiContracts.jsonApiResponses)(typebox.Type.Object({ worktree: RecordSchema }))
+		},
+		...scope === "workspace" ? [
+			{
+				id: "git.auth.read",
+				scope,
+				basePath: "git",
+				path: "/auth",
+				method: "GET",
+				authentication: "owner",
+				description: "Read a workspace's remote auth for manual sync. The token is never returned.",
+				parameters: [{
+					name: "repositoryId",
+					in: "query",
+					required: true,
+					schema: S
+				}],
+				responses: (0, _agimon_ai_po_core_apiContracts.jsonApiResponses)(AuthViewSchema)
+			},
+			{
+				id: "git.auth.save",
+				scope,
+				basePath: "git",
+				path: "/auth",
+				method: "PUT",
+				authentication: "owner",
+				description: "Replace a workspace's remote auth. Passkey step-up gated for remote devices.",
+				parameters: [{
+					name: "repositoryId",
+					in: "query",
+					required: true,
+					schema: S
+				}],
+				body: {
+					required: true,
+					contentType: "application/json",
+					schema: AuthSaveSchema
+				},
+				responses: (0, _agimon_ai_po_core_apiContracts.jsonApiResponses)(AuthViewSchema)
+			},
+			{
+				id: "git.branches",
+				scope,
+				basePath: "git",
+				path: "/branches",
+				method: "GET",
+				authentication: "owner",
+				description: "List the workspace branches for the new-session dialog.",
+				responses: (0, _agimon_ai_po_core_apiContracts.jsonApiResponses)(typebox.Type.Object({
+					repository: B,
+					current: O(S),
+					defaultBase: O(S),
+					local: typebox.Type.Array(typebox.Type.Object({
+						name: S,
+						checkedOutAt: O(S)
+					})),
+					remote: typebox.Type.Array(typebox.Type.Object({
+						remote: S,
+						name: S
+					}))
+				}))
+			},
+			{
+				id: "git.sessions.create",
+				scope,
+				basePath: "git",
+				path: "/sessions",
+				method: "POST",
+				authentication: "owner",
+				description: "Start a top-level worktree session on an existing or new branch.",
+				body: {
+					required: true,
+					contentType: "application/json",
+					schema: typebox.Type.Union([typebox.Type.Object({
+						mode: typebox.Type.Literal("existing-branch"),
+						branch: S,
+						remote: O(S),
+						name: O(S)
+					}), typebox.Type.Object({
+						mode: typebox.Type.Literal("new-branch"),
+						branch: S,
+						baseRef: O(S),
+						name: O(S)
+					})])
+				},
+				responses: (0, _agimon_ai_po_core_apiContracts.jsonApiResponses)(typebox.Type.Object({
+					sessionId: S,
+					worktreeId: S
+				}), 201)
+			}
+		] : [],
+		...scope === "global" ? [{
+			id: "git.review.summary",
+			scope: "session",
+			basePath: "git",
+			path: "/review",
+			method: "GET",
+			authentication: "owner",
+			description: "List the files the session's checkout changed against its base.",
+			responses: (0, _agimon_ai_po_core_apiContracts.jsonApiResponses)(ReviewSummarySchema)
+		}, {
+			id: "git.review.file",
+			scope: "session",
+			basePath: "git",
+			path: "/review/file",
+			method: "GET",
+			authentication: "owner",
+			description: "One changed file's hunks; the path must be in the session's change set.",
+			parameters: [{
+				name: "path",
+				in: "query",
+				required: true,
+				schema: typebox.Type.String({ minLength: 1 })
+			}],
+			responses: (0, _agimon_ai_po_core_apiContracts.jsonApiResponses)(ReviewFileSchema)
+		}] : []
+	]),
+	sockets: ["global", "workspace"].flatMap((scope) => [
+		{
+			id: "git.changes.channel",
+			scope,
+			service: "po.hub.v1",
+			member: "git_changes",
+			kind: "channel",
+			direction: "server-to-client",
+			description: "The session's change against its base, and manual sync state.",
+			input: GitChangesPayloadSchema
+		},
+		{
+			id: "git.changes.command",
+			scope,
+			service: "po.hub.v1",
+			member: "git_changes",
+			kind: "channel",
+			direction: "client-to-server",
+			description: "Manual pull, push, rebase or abort-rebase for the session.",
+			input: GitChangesCommandSchema
+		},
+		{
+			id: "git.channel",
+			scope,
+			service: "po.hub.v1",
+			member: "git_worktrees",
+			kind: "channel",
+			direction: "server-to-client",
+			description: "Worktree channel payload.",
+			input: WorktreesPayloadSchema
+		},
+		{
+			id: "git.command",
+			scope,
+			service: "po.hub.v1",
+			member: "git_worktrees",
+			kind: "channel",
+			direction: "client-to-server",
+			description: "Worktree channel command payload.",
+			input: WorktreesCommandSchema
+		}
+	])
+});
+//#endregion
+exports.apiContracts = apiContracts;
+exports.default = apiContracts;
+
+//# sourceMappingURL=apiContracts.cjs.map

package/dist/apiContracts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.cjs","names":["Type","defineApiContract","jsonApiResponses"],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract, jsonApiResponses } from '@agimon-ai/po-core/apiContracts';\nimport { Type } from 'typebox';\n\nconst S = Type.String();\nconst B = Type.Boolean();\nconst O = Type.Optional;\nconst literals = <T extends string>(values: T[]) => Type.Union(values.map((value) => Type.Literal(value)));\nconst RecordSchema = Type.Object({\n  version: Type.Literal(1),\n  id: S,\n  branch: S,\n  baseRef: S,\n  path: S,\n  repositoryRoot: S,\n  sessionId: S,\n  parentSessionId: Type.Optional(S),\n  status: literals(['spawning', 'running', 'closing', 'orphaned']),\n  createdAt: S,\n});\nconst ErrorTargetSchema = Type.Union([\n  Type.Object({ action: Type.Literal('create') }),\n  Type.Object({ action: Type.Literal('close'), id: S }),\n]);\nexport const WorktreesPayloadSchema = Type.Object({\n  worktrees: Type.Array(\n    Type.Object({ id: S, branch: S, path: S, sessionId: Type.Union([S, Type.Null()]), orphaned: B, unowned: B }),\n  ),\n  pending: O(S),\n  error: O(S),\n  errorTarget: O(ErrorTargetSchema),\n});\nexport const WorktreesCommandSchema = Type.Union([\n  Type.Object({\n    action: Type.Literal('create'),\n    branch: S,\n    baseRef: O(S),\n    reservationId: O(Type.String({ minLength: 1, pattern: '^[A-Za-z0-9_-]+$' })),\n  }),\n  Type.Object({ action: Type.Literal('close'), id: S, force: O(B) }),\n]);\nconst N = Type.Integer({ minimum: 0 });\nconst ChangesSchema = Type.Object({\n  branch: O(S),\n  base: O(S),\n  added: N,\n  removed: N,\n  files: N,\n  truncated: O(B),\n  upstream: O(Type.Object({ ref: S, ahead: N, behind: N })),\n  rebase: O(Type.Object({ conflicts: Type.Array(S) })),\n});\nconst SyncErrorTargetSchema = Type.Union([\n  Type.Object({ action: literals(['pull', 'rebase', 'abort-rebase']) }),\n  Type.Object({ action: Type.Literal('push'), forceRequired: O(Type.Literal(true)) }),\n]);\nexport const GitChangesPayloadSchema = Type.Object({\n  changes: O(ChangesSchema),\n  pending: O(S),\n  error: O(S),\n  errorTarget: O(SyncErrorTargetSchema),\n});\nexport const GitChangesCommandSchema = Type.Union([\n  Type.Object({ action: literals(['pull', 'rebase', 'abort-rebase']) }),\n  Type.Object({ action: Type.Literal('push'), force: O(Type.Literal(true)) }),\n]);\nconst AuthViewSchema = Type.Object({\n  method: literals(['none', 'ssh', 'https']),\n  ssh: O(Type.Object({ keyPath: O(S) })),\n  https: O(Type.Object({ host: S, username: S, hasToken: B })),\n});\nconst AuthSaveSchema = Type.Union([\n  Type.Object({ method: Type.Literal('none') }),\n  Type.Object({ method: Type.Literal('ssh'), keyPath: O(S) }),\n  Type.Object({ method: Type.Literal('https'), host: S, username: S, token: O(Type.String({ writeOnly: true })) }),\n]);\nconst DiffRowSchema = Type.Object({ marker: literals(['+', '-', ' ']), line: N, content: S });\nconst ReviewSummarySchema = Type.Object({\n  repository: B,\n  branch: O(S),\n  base: O(S),\n  mergeBase: O(S),\n  truncated: O(B),\n  files: Type.Array(\n    Type.Object({\n      path: S,\n      status: literals(['added', 'modified', 'deleted', 'untracked', 'conflicted']),\n      added: N,\n      removed: N,\n      binary: O(B),\n    }),\n  ),\n});\nconst ReviewFileSchema = Type.Object({\n  path: S,\n  hunks: Type.Array(Type.Object({ start: N, rows: Type.Array(DiffRowSchema) })),\n  binary: O(Type.Literal(true)),\n  tooLarge: O(Type.Literal(true)),\n});\nconst query = [\n  { name: 'repositoryId', in: 'query' as const, required: true, schema: S },\n  { name: 'sessionId', in: 'query' as const, required: true, schema: S },\n];\nexport const apiContracts = defineApiContract({\n  version: 1,\n  dynamic: [],\n  http: (['global', 'workspace'] as const).flatMap((scope) => [\n    {\n      id: 'git.list',\n      scope,\n      basePath: 'git',\n      path: '/worktrees',\n      method: 'GET',\n      authentication: 'owner',\n      description: 'List admitted repository worktrees.',\n      parameters: query.map((item) => ({ ...item, required: item.name === 'repositoryId' })),\n      responses: jsonApiResponses(Type.Object({ worktrees: Type.Array(RecordSchema) })),\n    },\n    {\n      id: 'git.create',\n      scope,\n      basePath: 'git',\n      path: '/worktrees',\n      method: 'POST',\n      authentication: 'owner',\n      description: 'Create a worktree and session.',\n      parameters: query,\n      body: {\n        required: true,\n        contentType: 'application/json',\n        schema: Type.Object({ branch: Type.String({ minLength: 1 }), baseRef: O(S), name: O(S) }),\n      },\n      responses: jsonApiResponses(Type.Object({ worktree: RecordSchema }), 201),\n    },\n    {\n      id: 'git.close',\n      scope,\n      basePath: 'git',\n      path: '/worktrees/{id}',\n      method: 'DELETE',\n      authentication: 'owner',\n      description: 'Close a worktree.',\n      parameters: [...query, { name: 'force', in: 'query', required: false, schema: B }],\n      responses: jsonApiResponses(Type.Object({ worktree: RecordSchema })),\n    },\n    // The new-session dialog's routes and a workspace's remote auth exist only on a workspace mount.\n    ...(scope === 'workspace'\n      ? [\n          {\n            id: 'git.auth.read',\n            scope,\n            basePath: 'git',\n            path: '/auth',\n            method: 'GET' as const,\n            authentication: 'owner' as const,\n            description: \"Read a workspace's remote auth for manual sync. The token is never returned.\",\n            parameters: [{ name: 'repositoryId', in: 'query' as const, required: true, schema: S }],\n            responses: jsonApiResponses(AuthViewSchema),\n          },\n          {\n            id: 'git.auth.save',\n            scope,\n            basePath: 'git',\n            path: '/auth',\n            method: 'PUT' as const,\n            authentication: 'owner' as const,\n            description: \"Replace a workspace's remote auth. Passkey step-up gated for remote devices.\",\n            parameters: [{ name: 'repositoryId', in: 'query' as const, required: true, schema: S }],\n            body: { required: true, contentType: 'application/json', schema: AuthSaveSchema },\n            responses: jsonApiResponses(AuthViewSchema),\n          },\n          {\n            id: 'git.branches',\n            scope,\n            basePath: 'git',\n            path: '/branches',\n            method: 'GET' as const,\n            authentication: 'owner' as const,\n            description: 'List the workspace branches for the new-session dialog.',\n            responses: jsonApiResponses(\n              Type.Object({\n                repository: B,\n                current: O(S),\n                defaultBase: O(S),\n                local: Type.Array(Type.Object({ name: S, checkedOutAt: O(S) })),\n                remote: Type.Array(Type.Object({ remote: S, name: S })),\n              }),\n            ),\n          },\n          {\n            id: 'git.sessions.create',\n            scope,\n            basePath: 'git',\n            path: '/sessions',\n            method: 'POST' as const,\n            authentication: 'owner' as const,\n            description: 'Start a top-level worktree session on an existing or new branch.',\n            body: {\n              required: true,\n              contentType: 'application/json',\n              schema: Type.Union([\n                Type.Object({ mode: Type.Literal('existing-branch'), branch: S, remote: O(S), name: O(S) }),\n                Type.Object({ mode: Type.Literal('new-branch'), branch: S, baseRef: O(S), name: O(S) }),\n              ]),\n            },\n            responses: jsonApiResponses(Type.Object({ sessionId: S, worktreeId: S }), 201),\n          },\n        ]\n      : []),\n    // The review routes exist only on a session mount; listed once, beside the global entries.\n    ...(scope === 'global'\n      ? [\n          {\n            id: 'git.review.summary',\n            scope: 'session' as const,\n            basePath: 'git',\n            path: '/review',\n            method: 'GET' as const,\n            authentication: 'owner' as const,\n            description: \"List the files the session's checkout changed against its base.\",\n            responses: jsonApiResponses(ReviewSummarySchema),\n          },\n          {\n            id: 'git.review.file',\n            scope: 'session' as const,\n            basePath: 'git',\n            path: '/review/file',\n            method: 'GET' as const,\n            authentication: 'owner' as const,\n            description: \"One changed file's hunks; the path must be in the session's change set.\",\n            parameters: [{ name: 'path', in: 'query' as const, required: true, schema: Type.String({ minLength: 1 }) }],\n            responses: jsonApiResponses(ReviewFileSchema),\n          },\n        ]\n      : []),\n  ]),\n  sockets: (['global', 'workspace'] as const).flatMap((scope) => [\n    {\n      id: 'git.changes.channel',\n      scope,\n      service: 'po.hub.v1',\n      member: 'git_changes',\n      kind: 'channel',\n      direction: 'server-to-client',\n      description: \"The session's change against its base, and manual sync state.\",\n      input: GitChangesPayloadSchema,\n    },\n    {\n      id: 'git.changes.command',\n      scope,\n      service: 'po.hub.v1',\n      member: 'git_changes',\n      kind: 'channel',\n      direction: 'client-to-server',\n      description: 'Manual pull, push, rebase or abort-rebase for the session.',\n      input: GitChangesCommandSchema,\n    },\n    {\n      id: 'git.channel',\n      scope,\n      service: 'po.hub.v1',\n      member: 'git_worktrees',\n      kind: 'channel',\n      direction: 'server-to-client',\n      description: 'Worktree channel payload.',\n      input: WorktreesPayloadSchema,\n    },\n    {\n      id: 'git.command',\n      scope,\n      service: 'po.hub.v1',\n      member: 'git_worktrees',\n      kind: 'channel',\n      direction: 'client-to-server',\n      description: 'Worktree channel command payload.',\n      input: WorktreesCommandSchema,\n    },\n  ]),\n});\nexport default apiContracts;\n"],"mappings":";;;;;;;AAGA,MAAM,IAAIA,QAAAA,KAAK,OAAO;AACtB,MAAM,IAAIA,QAAAA,KAAK,QAAQ;AACvB,MAAM,IAAIA,QAAAA,KAAK;AACf,MAAM,YAA8B,WAAgBA,QAAAA,KAAK,MAAM,OAAO,KAAK,UAAUA,QAAAA,KAAK,QAAQ,KAAK,CAAC,CAAC;AACzG,MAAM,eAAeA,QAAAA,KAAK,OAAO;CAC/B,SAASA,QAAAA,KAAK,QAAQ,CAAC;CACvB,IAAI;CACJ,QAAQ;CACR,SAAS;CACT,MAAM;CACN,gBAAgB;CAChB,WAAW;CACX,iBAAiBA,QAAAA,KAAK,SAAS,CAAC;CAChC,QAAQ,SAAS;EAAC;EAAY;EAAW;EAAW;CAAU,CAAC;CAC/D,WAAW;AACb,CAAC;AACD,MAAM,oBAAoBA,QAAAA,KAAK,MAAM,CACnCA,QAAAA,KAAK,OAAO,EAAE,QAAQA,QAAAA,KAAK,QAAQ,QAAQ,EAAE,CAAC,GAC9CA,QAAAA,KAAK,OAAO;CAAE,QAAQA,QAAAA,KAAK,QAAQ,OAAO;CAAG,IAAI;AAAE,CAAC,CACtD,CAAC;AACD,MAAa,yBAAyBA,QAAAA,KAAK,OAAO;CAChD,WAAWA,QAAAA,KAAK,MACdA,QAAAA,KAAK,OAAO;EAAE,IAAI;EAAG,QAAQ;EAAG,MAAM;EAAG,WAAWA,QAAAA,KAAK,MAAM,CAAC,GAAGA,QAAAA,KAAK,KAAK,CAAC,CAAC;EAAG,UAAU;EAAG,SAAS;CAAE,CAAC,CAC7G;CACA,SAAS,EAAE,CAAC;CACZ,OAAO,EAAE,CAAC;CACV,aAAa,EAAE,iBAAiB;AAClC,CAAC;AACD,MAAa,yBAAyBA,QAAAA,KAAK,MAAM,CAC/CA,QAAAA,KAAK,OAAO;CACV,QAAQA,QAAAA,KAAK,QAAQ,QAAQ;CAC7B,QAAQ;CACR,SAAS,EAAE,CAAC;CACZ,eAAe,EAAEA,QAAAA,KAAK,OAAO;EAAE,WAAW;EAAG,SAAS;CAAmB,CAAC,CAAC;AAC7E,CAAC,GACDA,QAAAA,KAAK,OAAO;CAAE,QAAQA,QAAAA,KAAK,QAAQ,OAAO;CAAG,IAAI;CAAG,OAAO,EAAE,CAAC;AAAE,CAAC,CACnE,CAAC;AACD,MAAM,IAAIA,QAAAA,KAAK,QAAQ,EAAE,SAAS,EAAE,CAAC;AACrC,MAAM,gBAAgBA,QAAAA,KAAK,OAAO;CAChC,QAAQ,EAAE,CAAC;CACX,MAAM,EAAE,CAAC;CACT,OAAO;CACP,SAAS;CACT,OAAO;CACP,WAAW,EAAE,CAAC;CACd,UAAU,EAAEA,QAAAA,KAAK,OAAO;EAAE,KAAK;EAAG,OAAO;EAAG,QAAQ;CAAE,CAAC,CAAC;CACxD,QAAQ,EAAEA,QAAAA,KAAK,OAAO,EAAE,WAAWA,QAAAA,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC;AACrD,CAAC;AACD,MAAM,wBAAwBA,QAAAA,KAAK,MAAM,CACvCA,QAAAA,KAAK,OAAO,EAAE,QAAQ,SAAS;CAAC;CAAQ;CAAU;AAAc,CAAC,EAAE,CAAC,GACpEA,QAAAA,KAAK,OAAO;CAAE,QAAQA,QAAAA,KAAK,QAAQ,MAAM;CAAG,eAAe,EAAEA,QAAAA,KAAK,QAAQ,IAAI,CAAC;AAAE,CAAC,CACpF,CAAC;AACD,MAAa,0BAA0BA,QAAAA,KAAK,OAAO;CACjD,SAAS,EAAE,aAAa;CACxB,SAAS,EAAE,CAAC;CACZ,OAAO,EAAE,CAAC;CACV,aAAa,EAAE,qBAAqB;AACtC,CAAC;AACD,MAAa,0BAA0BA,QAAAA,KAAK,MAAM,CAChDA,QAAAA,KAAK,OAAO,EAAE,QAAQ,SAAS;CAAC;CAAQ;CAAU;AAAc,CAAC,EAAE,CAAC,GACpEA,QAAAA,KAAK,OAAO;CAAE,QAAQA,QAAAA,KAAK,QAAQ,MAAM;CAAG,OAAO,EAAEA,QAAAA,KAAK,QAAQ,IAAI,CAAC;AAAE,CAAC,CAC5E,CAAC;AACD,MAAM,iBAAiBA,QAAAA,KAAK,OAAO;CACjC,QAAQ,SAAS;EAAC;EAAQ;EAAO;CAAO,CAAC;CACzC,KAAK,EAAEA,QAAAA,KAAK,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;CACrC,OAAO,EAAEA,QAAAA,KAAK,OAAO;EAAE,MAAM;EAAG,UAAU;EAAG,UAAU;CAAE,CAAC,CAAC;AAC7D,CAAC;AACD,MAAM,iBAAiBA,QAAAA,KAAK,MAAM;CAChCA,QAAAA,KAAK,OAAO,EAAE,QAAQA,QAAAA,KAAK,QAAQ,MAAM,EAAE,CAAC;CAC5CA,QAAAA,KAAK,OAAO;EAAE,QAAQA,QAAAA,KAAK,QAAQ,KAAK;EAAG,SAAS,EAAE,CAAC;CAAE,CAAC;CAC1DA,QAAAA,KAAK,OAAO;EAAE,QAAQA,QAAAA,KAAK,QAAQ,OAAO;EAAG,MAAM;EAAG,UAAU;EAAG,OAAO,EAAEA,QAAAA,KAAK,OAAO,EAAE,WAAW,KAAK,CAAC,CAAC;CAAE,CAAC;AACjH,CAAC;AACD,MAAM,gBAAgBA,QAAAA,KAAK,OAAO;CAAE,QAAQ,SAAS;EAAC;EAAK;EAAK;CAAG,CAAC;CAAG,MAAM;CAAG,SAAS;AAAE,CAAC;AAC5F,MAAM,sBAAsBA,QAAAA,KAAK,OAAO;CACtC,YAAY;CACZ,QAAQ,EAAE,CAAC;CACX,MAAM,EAAE,CAAC;CACT,WAAW,EAAE,CAAC;CACd,WAAW,EAAE,CAAC;CACd,OAAOA,QAAAA,KAAK,MACVA,QAAAA,KAAK,OAAO;EACV,MAAM;EACN,QAAQ,SAAS;GAAC;GAAS;GAAY;GAAW;GAAa;EAAY,CAAC;EAC5E,OAAO;EACP,SAAS;EACT,QAAQ,EAAE,CAAC;CACb,CAAC,CACH;AACF,CAAC;AACD,MAAM,mBAAmBA,QAAAA,KAAK,OAAO;CACnC,MAAM;CACN,OAAOA,QAAAA,KAAK,MAAMA,QAAAA,KAAK,OAAO;EAAE,OAAO;EAAG,MAAMA,QAAAA,KAAK,MAAM,aAAa;CAAE,CAAC,CAAC;CAC5E,QAAQ,EAAEA,QAAAA,KAAK,QAAQ,IAAI,CAAC;CAC5B,UAAU,EAAEA,QAAAA,KAAK,QAAQ,IAAI,CAAC;AAChC,CAAC;AACD,MAAM,QAAQ,CACZ;CAAE,MAAM;CAAgB,IAAI;CAAkB,UAAU;CAAM,QAAQ;AAAE,GACxE;CAAE,MAAM;CAAa,IAAI;CAAkB,UAAU;CAAM,QAAQ;AAAE,CACvE;AACA,MAAa,gBAAA,GAAeC,gCAAAA,kBAAAA,CAAkB;CAC5C,SAAS;CACT,SAAS,CAAC;CACV,MAAO,CAAC,UAAU,WAAW,CAAC,CAAW,SAAS,UAAU;EAC1D;GACE,IAAI;GACJ;GACA,UAAU;GACV,MAAM;GACN,QAAQ;GACR,gBAAgB;GAChB,aAAa;GACb,YAAY,MAAM,KAAK,UAAU;IAAE,GAAG;IAAM,UAAU,KAAK,SAAS;GAAe,EAAE;GACrF,YAAA,GAAWC,gCAAAA,iBAAAA,CAAiBF,QAAAA,KAAK,OAAO,EAAE,WAAWA,QAAAA,KAAK,MAAM,YAAY,EAAE,CAAC,CAAC;EAClF;EACA;GACE,IAAI;GACJ;GACA,UAAU;GACV,MAAM;GACN,QAAQ;GACR,gBAAgB;GAChB,aAAa;GACb,YAAY;GACZ,MAAM;IACJ,UAAU;IACV,aAAa;IACb,QAAQA,QAAAA,KAAK,OAAO;KAAE,QAAQA,QAAAA,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC;KAAG,SAAS,EAAE,CAAC;KAAG,MAAM,EAAE,CAAC;IAAE,CAAC;GAC1F;GACA,YAAA,GAAWE,gCAAAA,iBAAAA,CAAiBF,QAAAA,KAAK,OAAO,EAAE,UAAU,aAAa,CAAC,GAAG,GAAG;EAC1E;EACA;GACE,IAAI;GACJ;GACA,UAAU;GACV,MAAM;GACN,QAAQ;GACR,gBAAgB;GAChB,aAAa;GACb,YAAY,CAAC,GAAG,OAAO;IAAE,MAAM;IAAS,IAAI;IAAS,UAAU;IAAO,QAAQ;GAAE,CAAC;GACjF,YAAA,GAAWE,gCAAAA,iBAAAA,CAAiBF,QAAAA,KAAK,OAAO,EAAE,UAAU,aAAa,CAAC,CAAC;EACrE;EAEA,GAAI,UAAU,cACV;GACE;IACE,IAAI;IACJ;IACA,UAAU;IACV,MAAM;IACN,QAAQ;IACR,gBAAgB;IAChB,aAAa;IACb,YAAY,CAAC;KAAE,MAAM;KAAgB,IAAI;KAAkB,UAAU;KAAM,QAAQ;IAAE,CAAC;IACtF,YAAA,GAAWE,gCAAAA,iBAAAA,CAAiB,cAAc;GAC5C;GACA;IACE,IAAI;IACJ;IACA,UAAU;IACV,MAAM;IACN,QAAQ;IACR,gBAAgB;IAChB,aAAa;IACb,YAAY,CAAC;KAAE,MAAM;KAAgB,IAAI;KAAkB,UAAU;KAAM,QAAQ;IAAE,CAAC;IACtF,MAAM;KAAE,UAAU;KAAM,aAAa;KAAoB,QAAQ;IAAe;IAChF,YAAA,GAAWA,gCAAAA,iBAAAA,CAAiB,cAAc;GAC5C;GACA;IACE,IAAI;IACJ;IACA,UAAU;IACV,MAAM;IACN,QAAQ;IACR,gBAAgB;IAChB,aAAa;IACb,YAAA,GAAWA,gCAAAA,iBAAAA,CACTF,QAAAA,KAAK,OAAO;KACV,YAAY;KACZ,SAAS,EAAE,CAAC;KACZ,aAAa,EAAE,CAAC;KAChB,OAAOA,QAAAA,KAAK,MAAMA,QAAAA,KAAK,OAAO;MAAE,MAAM;MAAG,cAAc,EAAE,CAAC;KAAE,CAAC,CAAC;KAC9D,QAAQA,QAAAA,KAAK,MAAMA,QAAAA,KAAK,OAAO;MAAE,QAAQ;MAAG,MAAM;KAAE,CAAC,CAAC;IACxD,CAAC,CACH;GACF;GACA;IACE,IAAI;IACJ;IACA,UAAU;IACV,MAAM;IACN,QAAQ;IACR,gBAAgB;IAChB,aAAa;IACb,MAAM;KACJ,UAAU;KACV,aAAa;KACb,QAAQA,QAAAA,KAAK,MAAM,CACjBA,QAAAA,KAAK,OAAO;MAAE,MAAMA,QAAAA,KAAK,QAAQ,iBAAiB;MAAG,QAAQ;MAAG,QAAQ,EAAE,CAAC;MAAG,MAAM,EAAE,CAAC;KAAE,CAAC,GAC1FA,QAAAA,KAAK,OAAO;MAAE,MAAMA,QAAAA,KAAK,QAAQ,YAAY;MAAG,QAAQ;MAAG,SAAS,EAAE,CAAC;MAAG,MAAM,EAAE,CAAC;KAAE,CAAC,CACxF,CAAC;IACH;IACA,YAAA,GAAWE,gCAAAA,iBAAAA,CAAiBF,QAAAA,KAAK,OAAO;KAAE,WAAW;KAAG,YAAY;IAAE,CAAC,GAAG,GAAG;GAC/E;EACF,IACA,CAAC;EAEL,GAAI,UAAU,WACV,CACE;GACE,IAAI;GACJ,OAAO;GACP,UAAU;GACV,MAAM;GACN,QAAQ;GACR,gBAAgB;GAChB,aAAa;GACb,YAAA,GAAWE,gCAAAA,iBAAAA,CAAiB,mBAAmB;EACjD,GACA;GACE,IAAI;GACJ,OAAO;GACP,UAAU;GACV,MAAM;GACN,QAAQ;GACR,gBAAgB;GAChB,aAAa;GACb,YAAY,CAAC;IAAE,MAAM;IAAQ,IAAI;IAAkB,UAAU;IAAM,QAAQF,QAAAA,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC;GAAE,CAAC;GAC1G,YAAA,GAAWE,gCAAAA,iBAAAA,CAAiB,gBAAgB;EAC9C,CACF,IACA,CAAC;CACP,CAAC;CACD,SAAU,CAAC,UAAU,WAAW,CAAC,CAAW,SAAS,UAAU;EAC7D;GACE,IAAI;GACJ;GACA,SAAS;GACT,QAAQ;GACR,MAAM;GACN,WAAW;GACX,aAAa;GACb,OAAO;EACT;EACA;GACE,IAAI;GACJ;GACA,SAAS;GACT,QAAQ;GACR,MAAM;GACN,WAAW;GACX,aAAa;GACb,OAAO;EACT;EACA;GACE,IAAI;GACJ;GACA,SAAS;GACT,QAAQ;GACR,MAAM;GACN,WAAW;GACX,aAAa;GACb,OAAO;EACT;EACA;GACE,IAAI;GACJ;GACA,SAAS;GACT,QAAQ;GACR,MAAM;GACN,WAAW;GACX,aAAa;GACb,OAAO;EACT;CACF,CAAC;AACH,CAAC"}

package/dist/apiContracts.d.mts

@@ -0,0 +1,53 @@
+import { Type } from "typebox";
+//#region src/schemas/apiContracts.d.ts
+export declare const apiContracts: {
+  version: 1;
+  protocols?: Record<string, string> | undefined;
+  schemas?: Record<string, boolean | object> | undefined;
+  http: {
+    id: string;
+    scope: "global" | "session" | "workspace";
+    basePath?: string | undefined;
+    path: string;
+    method: "DELETE" | "GET" | "HEAD" | "OPTIONS" | "PATCH" | "POST" | "PUT";
+    description: string;
+    availability?: string | undefined;
+    authentication: "device" | "none" | "owner";
+    parameters?: {
+      name: string;
+      in: "header" | "path" | "query";
+      required: boolean;
+      schema: boolean | object;
+    }[] | undefined;
+    body?: {
+      contentType: string;
+      contentTypes?: string[] | undefined;
+      required: boolean;
+      schema: boolean | object;
+    } | undefined;
+    responses: Record<string, {
+      description: string;
+      contentType?: string | undefined;
+      schema?: boolean | object | undefined;
+      events?: Record<string, boolean | object> | undefined;
+    }>;
+  }[];
+  sockets: {
+    id: string;
+    scope: "global" | "session" | "workspace";
+    description: string;
+    availability?: string | undefined;
+    service: string;
+    member: string;
+    direction: "client-to-server" | "server-to-client";
+    kind: "channel" | "method" | "state";
+    input: boolean | object;
+    output?: boolean | object | undefined;
+    errors?: boolean | object | undefined;
+  }[];
+  dynamic: string[];
+  gaps?: string[] | undefined;
+};
+//#endregion
+export { apiContracts as default };
+//# sourceMappingURL=apiContracts.d.mts.map

package/dist/apiContracts.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.d.mts","names":[],"sources":["../src/schemas/apiContracts.ts"],"mappings":";;qBAsGa"}