@github-tools/sdk 1.2.0 → 1.4.0

package/dist/workflow.mjs

@@ -0,0 +1,55 @@
+import { n as resolveInstructions, t as createGithubAgent } from "./agents-D9aKsd_7.mjs";
+import { createGithubTools } from "./index.mjs";
+import { DurableAgent } from "@workflow/ai/agent";
+
+//#region src/workflow.ts
+/**
+* Create a pre-configured durable GitHub agent powered by Vercel Workflow SDK's `DurableAgent`.
+*
+* Each tool call runs as a durable step with automatic retries and observability.
+* Must be used inside a `"use workflow"` function.
+*
+* **Note:** `requireApproval` is accepted for forward-compatibility but is currently
+* ignored by `DurableAgent` — the Workflow SDK does not yet support interactive tool
+* approval. All tools execute immediately without user confirmation.
+*
+* @example
+* ```ts
+* import { createDurableGithubAgent } from '@github-tools/sdk/workflow'
+* import { getWritable } from 'workflow'
+* import type { ModelMessage, UIMessageChunk } from 'ai'
+*
+* async function chatWorkflow(messages: ModelMessage[], token: string) {
+*   "use workflow"
+*   const agent = createDurableGithubAgent({
+*     model: 'anthropic/claude-sonnet-4.6',
+*     token,
+*     preset: 'code-review',
+*   })
+*   const writable = getWritable<UIMessageChunk>()
+*   await agent.stream({ messages, writable })
+* }
+* ```
+*/
+function createDurableGithubAgent({ model, token, preset, requireApproval, instructions, additionalInstructions, ...agentOptions }) {
+	const tools = createGithubTools({
+		token,
+		requireApproval,
+		preset
+	});
+	const resolvedModel = typeof model === "string" || typeof model === "function" ? model : () => Promise.resolve(model);
+	return new DurableAgent({
+		...agentOptions,
+		model: resolvedModel,
+		tools,
+		instructions: resolveInstructions({
+			preset,
+			instructions,
+			additionalInstructions
+		})
+	});
+}
+
+//#endregion
+export { createDurableGithubAgent, createGithubAgent, createGithubTools };
+//# sourceMappingURL=workflow.mjs.map

package/dist/workflow.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.mjs","names":[],"sources":["../src/workflow.ts"],"sourcesContent":["import { DurableAgent } from '@workflow/ai/agent'\nimport type { CompatibleLanguageModel } from '@workflow/ai/agent'\nimport { createGithubTools } from './index'\nimport { resolveInstructions } from './agents'\nimport type { GithubToolPreset, ApprovalConfig } from './index'\n\nexport type CreateDurableGithubAgentOptions = {\n  model: string | CompatibleLanguageModel | (() => Promise<CompatibleLanguageModel>)\n  /**\n   * GitHub personal access token.\n   * Falls back to `process.env.GITHUB_TOKEN` when omitted.\n   */\n  token?: string\n  preset?: GithubToolPreset | GithubToolPreset[]\n  requireApproval?: ApprovalConfig\n  instructions?: string\n  additionalInstructions?: string\n  /** Maximum number of LLM calls before stopping. Unlimited by default. */\n  maxSteps?: number\n  temperature?: number\n}\n\n/**\n * Create a pre-configured durable GitHub agent powered by Vercel Workflow SDK's `DurableAgent`.\n *\n * Each tool call runs as a durable step with automatic retries and observability.\n * Must be used inside a `\"use workflow\"` function.\n *\n * **Note:** `requireApproval` is accepted for forward-compatibility but is currently\n * ignored by `DurableAgent` — the Workflow SDK does not yet support interactive tool\n * approval. All tools execute immediately without user confirmation.\n *\n * @example\n * ```ts\n * import { createDurableGithubAgent } from '@github-tools/sdk/workflow'\n * import { getWritable } from 'workflow'\n * import type { ModelMessage, UIMessageChunk } from 'ai'\n *\n * async function chatWorkflow(messages: ModelMessage[], token: string) {\n *   \"use workflow\"\n *   const agent = createDurableGithubAgent({\n *     model: 'anthropic/claude-sonnet-4.6',\n *     token,\n *     preset: 'code-review',\n *   })\n *   const writable = getWritable<UIMessageChunk>()\n *   await agent.stream({ messages, writable })\n * }\n * ```\n */\nexport function createDurableGithubAgent({\n  model,\n  token,\n  preset,\n  requireApproval,\n  instructions,\n  additionalInstructions,\n  ...agentOptions\n}: CreateDurableGithubAgentOptions) {\n  const tools = createGithubTools({ token, requireApproval, preset })\n\n  const resolvedModel = typeof model === 'string' || typeof model === 'function'\n    ? model\n    : () => Promise.resolve(model)\n\n  return new DurableAgent({\n    ...agentOptions,\n    model: resolvedModel,\n    tools,\n    instructions: resolveInstructions({ preset, instructions, additionalInstructions }),\n  })\n}\n\nexport { createGithubTools, createGithubAgent } from './index'\nexport type { GithubTools, GithubToolsOptions, GithubToolPreset, GithubWriteToolName, ApprovalConfig } from './index'\nexport type { CreateGithubAgentOptions } from './agents'\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkDA,SAAgB,yBAAyB,EACvC,OACA,OACA,QACA,iBACA,cACA,wBACA,GAAG,gBAC+B;CAClC,MAAM,QAAQ,kBAAkB;EAAE;EAAO;EAAiB;EAAQ,CAAC;CAEnE,MAAM,gBAAgB,OAAO,UAAU,YAAY,OAAO,UAAU,aAChE,cACM,QAAQ,QAAQ,MAAM;AAEhC,QAAO,IAAI,aAAa;EACtB,GAAG;EACH,OAAO;EACP;EACA,cAAc,oBAAoB;GAAE;GAAQ;GAAc;GAAwB,CAAC;EACpF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@github-tools/sdk",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "GitHub tools for the Vercel AI SDK, wrap GitHub's API as AI SDK tools ready to plug into any agent",
   "author": "HugoRCD <hugo.richard@vercel.com",
   "repository": {
@@ -13,11 +13,17 @@
     "url": "https://github.com/vercel-labs/github-tools/issues"
   },
   "type": "module",
-  "sideEffects": false,
+  "sideEffects": [
+    "./dist/agents-*.mjs"
+  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.mts",
       "import": "./dist/index.mjs"
+    },
+    "./workflow": {
+      "types": "./dist/workflow.d.mts",
+      "import": "./dist/workflow.mjs"
     }
   },
   "main": "./dist/index.mjs",
@@ -31,7 +37,9 @@
     "ai-sdk",
     "github",
     "tools",
-    "agent"
+    "agent",
+    "workflow",
+    "durable"
   ],
   "license": "MIT",
   "dependencies": {
@@ -39,7 +47,17 @@
   },
   "peerDependencies": {
     "ai": "^6.0.97",
-    "zod": "^4.3.6"
+    "zod": "^4.3.6",
+    "workflow": "^4.2.0-beta.76",
+    "@workflow/ai": "^4.1.0-beta.60"
+  },
+  "peerDependenciesMeta": {
+    "workflow": {
+      "optional": true
+    },
+    "@workflow/ai": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@types/node": "^24.10.13",