@tangle-network/agent-integrations 0.68.0 → 0.69.0

package/dist/{bundled-manifest-data-DhcRFr4L.js → bundled-manifest-data-Bv0ejHMQ.js}

@@ -51587,7 +51587,7 @@ var bundled_adapter_manifests_default = [
 			},
 			{
 				"name": "repos.getBranch",
-				"description": "Read one branch: its head commit sha and that commit's tree sha. Use it to find the base a proposed change builds on.",
+				"description": "Read one branch BY NAME: `commit.sha` is its head commit and `commit.commit.tree.sha` that commit's tree. Step 1 of a draft pull request: read the base branch (e.g. `main`), then git.createTree on that tree, git.createCommit with that head as parent, git.createRef `refs/heads/<new-branch>`, and pulls.create with `draft: true`. A commit sha is not a branch name: read a commit with git.getCommit.",
 				"parameters": {
 					"type": "object",
 					"properties": {
@@ -51595,7 +51595,7 @@ var bundled_adapter_manifests_default = [
 						"repo": { "type": "string" },
 						"branch": {
 							"type": "string",
-							"description": "Branch name, e.g. `main`."
+							"description": "Branch name such as `main` or `gtm-agent/hero-copy`; never a commit sha or a `refs/` path."
 						}
 					},
 					"required": [
@@ -51607,6 +51607,29 @@ var bundled_adapter_manifests_default = [
 				"requiredScopes": { "__tangleUndefined": true },
 				"class": "read"
 			},
+			{
+				"name": "git.getCommit",
+				"description": "Read one commit object by sha: its `tree.sha`, `parents[].sha`, message and author. Use it to verify the commit git.createCommit returned before git.createRef points a new branch at it.",
+				"parameters": {
+					"type": "object",
+					"properties": {
+						"owner": { "type": "string" },
+						"repo": { "type": "string" },
+						"commit_sha": {
+							"type": "string",
+							"pattern": "^(?:[0-9a-fA-F]{40}|[0-9a-fA-F]{64})$",
+							"description": "Full commit sha."
+						}
+					},
+					"required": [
+						"owner",
+						"repo",
+						"commit_sha"
+					]
+				},
+				"requiredScopes": { "__tangleUndefined": true },
+				"class": "read"
+			},
 			{
 				"name": "git.getTree",
 				"description": "Read a git tree. With `recursive: \"1\"` it lists every file path with its blob sha, so files can be read without path URLs.",
@@ -51655,7 +51678,7 @@ var bundled_adapter_manifests_default = [
 			},
 			{
 				"name": "git.createTree",
-				"description": "Write a tree: `base_tree` plus the changed entries. Each entry is `{ path, mode: \"100644\", type: \"blob\", content }` (use `sha: null` to delete a file). Creates an unreferenced object; nothing is visible until a branch points at a commit using it.",
+				"description": "Step 2 of a draft pull request. Write a tree: `base_tree` plus the changed entries. Each entry is `{ path, mode: \"100644\", type: \"blob\", content }` (use `sha: null` to delete a file). Creates an unreferenced object; nothing is visible until a branch points at a commit using it.",
 				"parameters": {
 					"type": "object",
 					"properties": {
@@ -51663,7 +51686,8 @@ var bundled_adapter_manifests_default = [
 						"repo": { "type": "string" },
 						"base_tree": {
 							"type": "string",
-							"description": "Tree sha of the base commit."
+							"pattern": "^(?:[0-9a-fA-F]{40}|[0-9a-fA-F]{64})$",
+							"description": "Tree sha of the base commit: `commit.commit.tree.sha` from repos.getBranch."
 						},
 						"tree": {
 							"type": "array",
@@ -51714,7 +51738,7 @@ var bundled_adapter_manifests_default = [
 			},
 			{
 				"name": "git.createCommit",
-				"description": "Write a commit object for a tree with explicit parents (normally the base branch head). Creates an unreferenced object; it moves no branch.",
+				"description": "Step 3 of a draft pull request. Write a commit object for a tree with explicit parents (normally the base branch head). Creates an unreferenced object; it moves no branch. Its `sha` is what git.createRef needs.",
 				"parameters": {
 					"type": "object",
 					"properties": {
@@ -51723,12 +51747,16 @@ var bundled_adapter_manifests_default = [
 						"message": { "type": "string" },
 						"tree": {
 							"type": "string",
+							"pattern": "^(?:[0-9a-fA-F]{40}|[0-9a-fA-F]{64})$",
 							"description": "Tree sha from git.createTree."
 						},
 						"parents": {
 							"type": "array",
-							"items": { "type": "string" },
-							"description": "Parent commit shas."
+							"items": {
+								"type": "string",
+								"pattern": "^(?:[0-9a-fA-F]{40}|[0-9a-fA-F]{64})$"
+							},
+							"description": "Parent commit shas: the base branch head from repos.getBranch."
 						}
 					},
 					"required": [
@@ -51746,7 +51774,7 @@ var bundled_adapter_manifests_default = [
 			},
 			{
 				"name": "git.createRef",
-				"description": "Create a NEW branch at a commit: `ref` must be `refs/heads/<new-branch>`. Never moves an existing branch; GitHub returns 422 when the ref already exists.",
+				"description": "Step 4 of a draft pull request. Create a NEW branch at a commit: `ref` must be `refs/heads/<new-branch>` and `sha` the commit from git.createCommit. Never moves an existing branch; GitHub returns 422 when the ref already exists. Then pulls.create with `head: \"<new-branch>\"` (no `refs/heads/`) and `draft: true`.",
 				"parameters": {
 					"type": "object",
 					"properties": {
@@ -51759,6 +51787,7 @@ var bundled_adapter_manifests_default = [
 						},
 						"sha": {
 							"type": "string",
+							"pattern": "^(?:[0-9a-fA-F]{40}|[0-9a-fA-F]{64})$",
 							"description": "Commit sha from git.createCommit."
 						}
 					},
@@ -51829,7 +51858,7 @@ var bundled_adapter_manifests_default = [
 			},
 			{
 				"name": "pulls.create",
-				"description": "Open a pull request from `head` into `base` on the target repository.",
+				"description": "Open a pull request from `head` into `base` on the target repository. Step 5 of a draft pull request: `head` is the branch git.createRef created and `draft: true`.",
 				"parameters": {
 					"type": "object",
 					"properties": {
@@ -51838,7 +51867,7 @@ var bundled_adapter_manifests_default = [
 						"title": { "type": "string" },
 						"head": {
 							"type": "string",
-							"description": "Branch (or cross-fork ref like `octocat:feature-x`) containing the changes."
+							"description": "Branch name (or cross-fork `octocat:feature-x`) containing the changes, without `refs/heads/`."
 						},
 						"base": {
 							"type": "string",
@@ -141268,4 +141297,4 @@ function isUndefinedMarker(value) {
 //#endregion
 export { getBundledAdapterManifest as a, listBundledAdapterManifests as c, bundledOAuth2AuthContract as i, bundledAuthMode as n, hasBundledAdapter as o, bundledOAuth2Auth as r, listBundledAdapterKinds as s, bundledApiKeyHint as t };
 
-//# sourceMappingURL=bundled-manifest-data-DhcRFr4L.js.map
+//# sourceMappingURL=bundled-manifest-data-Bv0ejHMQ.js.map