branchora-sdk 1.0.0 → 1.1.0

package/README.md

@@ -1,9 +1,9 @@
 # Branchora SDK
 
-Install the locally verified tarball while npm registry publication is pending:
+Install the JavaScript/TypeScript SDK:
 
 ```sh
-npm install /absolute/path/branchora-sdk-1.0.0.tgz
+npm install branchora-sdk@1.1.0
 ```
 
 ```js
@@ -13,11 +13,22 @@ const client = new BranchoraClient({
   url: process.env.BRANCHORA_URL,
   apiKey: process.env.BRANCHORA_API_KEY,
 });
-const agent = await client.createAgent({ name: 'My agent', provider: 'openai', model: 'my-model' });
-const run = await client.createRun({ projectId, rootAgentId: agent.id, title: 'Task', prompt: 'Review changes' });
+// Use a provisioned bag_ credential; the server assigns the project and stable agent.
+const identity = await client.agentIdentity();
+const run = await client.createAgentRun({
+  title: 'Task', prompt: 'Review changes', branch: 'agents/builder/task',
+});
 await run.decision({ title: 'Inspect first', summary: 'Check source and tests before editing.' });
 ```
 
+Git helpers include `repositoryRefs`, `createBranch`, `commitFiles`, `openPullRequest`,
+`reviewPullRequest`, `recordCommitCheck`, and `mergePullRequest`. Commits use expected-head CAS;
+reviews/checks bind exact SHAs and merges enforce independent agent review and branch policy.
+
+Administrative credentials can configure agent repositories, grant capabilities/branches and
+issue or revoke credentials. Agent credentials cannot self-provision or change their permissions.
+Legacy workspace credentials and execution helpers remain supported.
+
 JavaScript ESM and TypeScript declarations are included. Requires Node 22.12 or later.
 The declaration dependency tree supports NodeNext and Bundler module resolution, including
 strict consumer checks without `skipLibCheck`. Runtime dependencies are bundled; Zod remains