@github-tools/sdk 1.6.0 → 1.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/README.md +150 -10
  2. package/dist/connect/eve.d.mts +17 -0
  3. package/dist/connect/eve.d.mts.map +1 -0
  4. package/dist/connect/eve.mjs +27 -0
  5. package/dist/connect/eve.mjs.map +1 -0
  6. package/dist/connect.d.mts +46 -0
  7. package/dist/connect.d.mts.map +1 -0
  8. package/dist/connect.mjs +22 -0
  9. package/dist/connect.mjs.map +1 -0
  10. package/dist/eve-B-LChKzS.mjs +526 -0
  11. package/dist/eve-B-LChKzS.mjs.map +1 -0
  12. package/dist/eve.d.mts +125 -0
  13. package/dist/eve.d.mts.map +1 -0
  14. package/dist/eve.mjs +3 -0
  15. package/dist/index-SZCaP-y9.d.mts +220 -0
  16. package/dist/index-SZCaP-y9.d.mts.map +1 -0
  17. package/dist/index.d.mts +3 -2
  18. package/dist/index.mjs +3 -2
  19. package/dist/src-CfzZfU82.mjs +812 -0
  20. package/dist/src-CfzZfU82.mjs.map +1 -0
  21. package/dist/token-CW8lQBND.mjs +100 -0
  22. package/dist/token-CW8lQBND.mjs.map +1 -0
  23. package/dist/tool-types-C0kszIwd.d.mts +249 -0
  24. package/dist/tool-types-C0kszIwd.d.mts.map +1 -0
  25. package/dist/types-BTanS_dq.d.mts +49 -0
  26. package/dist/types-BTanS_dq.d.mts.map +1 -0
  27. package/dist/types-DOeq0Iia.d.mts +27 -0
  28. package/dist/types-DOeq0Iia.d.mts.map +1 -0
  29. package/dist/workflow.d.mts +53 -730
  30. package/dist/workflow.d.mts.map +1 -1
  31. package/dist/workflow.mjs +14 -74
  32. package/dist/workflow.mjs.map +1 -1
  33. package/dist/write-tools-Dx9LfYlU.mjs +1840 -0
  34. package/dist/write-tools-Dx9LfYlU.mjs.map +1 -0
  35. package/package.json +40 -8
  36. package/dist/index-ikP-LT-3.d.mts +0 -1634
  37. package/dist/index-ikP-LT-3.d.mts.map +0 -1
  38. package/dist/src--pAdGYqY.mjs +0 -1961
  39. package/dist/src--pAdGYqY.mjs.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"workflow.d.mts","names":[],"sources":["../src/workflow.ts"],"mappings":";;;;;;;;AAWA;UAAiB,gCAAA,gBAAgD,OAAA,GAAU,OAAA;EACzE,IAAA;EACA,YAAA,EAAc,YAAA;EACd,KAAA,EAAO,kBAAA;EACP,KAAA,EAAO,UAAA,CAAW,MAAA;EAClB,QAAA,EAAU,6BAAA;IAAkC,QAAA,EAAU,YAAA;EAAA;AAAA;;;;;;;;;;;cAa3C,kBAAA,gBAAkC,OAAA,GAAU,OAAA;EAAA,QAC/C,KAAA;EAAA,QACA,MAAA;EAAA,QACA,aAAA;EAAA,QACA,UAAA;EAAA,QACA,MAAA;cAEI,OAAA,EAAS,mBAAA,CAAoB,MAAA;EApBa;EAAA,IA6BlD,KAAA,CAAA,GAAS,MAAA;EA7BqD;AAapE;;;EAwBE,MAAA,sBAA4B,MAAA,GAAS,MAAA,yCAAA,CACnC,OAAA,EAAS,yBAAA,CAA0B,YAAA,EAAc,MAAA,EAAQ,cAAA,IACxD,OAAA,CAAQ,wBAAA,CAAyB,YAAA,EAAc,MAAA;EA1BK;;;;;;;;;;;;;;;;;;;;EAkDjD,QAAA,CAAA;IAAW,MAAA;IAAQ;EAAA;IAAc,MAAA;IAAgB,QAAA,GAAW,aAAA,CAAc,MAAA,IAAU,KAAA,CAAM,aAAA,CAAc,MAAA;EAAA,IAAa,OAAA,CAAQ,gCAAA,CAAiC,MAAA;AAAA;;;;;;;KAoC1J,+BAAA,GACV,IAAA,CAAK,mBAAA;EACH,KAAA,WAAgB,uBAAA,UAAiC,OAAA,CAAQ,uBAAA;EAnFnD;;;;EAwFN,KAAA;EACA,MAAA,GAAS,gBAAA,GAAmB,gBAAA;EAC5B,eAAA,GAAkB,cAAA;EAClB,YAAA;EACA,sBAAA;EAzE0B;;;;EA8E1B,MAAA,GAAS,cAAA;EA7E0B;;;;EAkFnC,SAAA,GAAY,cAAA;EAjFH;;;;EAsFT,SAAA,GAAY,cAAA;AAAA;;;;;;;;;;;;;;;AA1BhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2EgB,wBAAA,CAAA;EACd,KAAA;EACA,KAAA;EACA,MAAA;EACA,eAAA;EACA,YAAA;EACA,sBAAA;EACA,MAAA;EACA,SAAA;EACA,SAAA;EAAA,GACG;AAAA,GACF,+BAAA,GAA+B,kBAAA,CAAA,OAAA;iBAAA,IAAA,CAAA,IAAA"}
1
+ {"version":3,"file":"workflow.d.mts","names":[],"sources":["../src/workflow.ts"],"mappings":";;;;;;;;;;UA8BiB,gCAAA,gBAAgD,OAAA,GAAU,OAAA;EACzE,IAAA;EACA,YAAA,EAAc,YAAA;EACd,KAAA,EAAO,kBAAA;EACP,KAAA,EAAO,UAAA,CAAW,MAAA;EAClB,QAAA,EAAU,6BAAA;IAAkC,QAAA,EAAU,YAAA;EAAA;AAAA;;;;;;;;;;;cAa3C,kBAAA,gBAAkC,OAAA,GAAU,OAAA;EAAA,QAC/C,KAAA;EAAA,QACA,MAAA;EAAA,QACA,aAAA;EAAA,QACA,UAAA;EAAA,QACA,MAAA;cAEI,OAAA,EAAS,oBAAA,CAAqB,MAAA;EAP/B;EAAA,IAgBP,KAAA,CAAA,GAAS,MAAA;EAhBgB;;;;EAwB7B,MAAA,sBAA4B,MAAA,GAAS,MAAA,yCAAA,CACnC,OAAA,EAAS,0BAAA,CAA2B,YAAA,EAAc,OAAA,EAAS,MAAA,EAAQ,cAAA,IAClE,OAAA,CAAQ,yBAAA,CAA0B,YAAA,EAAc,MAAA;EAVtC;;;;;;;EAqBP,QAAA,CAAA;IAAW,MAAA;IAAQ;EAAA;IAAc,MAAA;IAAgB,QAAA,GAAW,aAAA,CAAc,MAAA,IAAU,KAAA,CAAM,aAAA,CAAc,MAAA;EAAA,IAAa,OAAA,CAAQ,gCAAA,CAAiC,MAAA;AAAA;;;;;;;KA8B1J,+BAAA,GACV,IAAA,CAAK,oBAAA;EACH,KAAA,WAAgB,aAAA;EAhCiH;;;;EAqCjI,KAAA,GAAQ,gBAAA;EA1EmC;;;;;;;;EAmF3C,MAAA,GAAS,gBAAA,GAAmB,gBAAA;EA5EY;;;;;EAkFxC,eAAA,GAAkB,cAAA;EAjEQ;;;;EAsE1B,YAAA;EArEoC;;;;EA0EpC,sBAAA;EAzEC;;;;EA8ED,MAAA,GAAS,cAAA;EAnEM;;;;EAwEf,SAAA,GAAY,cAAA;EAxEyC;;;;EA6ErD,SAAA,GAAY,cAAA;AAAA;;;;;;AA/ChB;;;;;;;;;;;;;;;;;;;;;;;;;iBAgFgB,wBAAA,CACd,OAAA,EAAS,+BAAA;EAAoC,MAAA;AAAA,IAC5C,kBAAA,CAAmB,cAAA;AAAA,iBACN,wBAAA,WAAmC,gBAAA,CAAA,CACjD,OAAA,EAAS,+BAAA;EAAoC,MAAA,EAAQ,CAAA;AAAA,IACpD,kBAAA,CAAmB,IAAA,CAAK,cAAA,EAAgB,cAAA,CAAe,CAAA;AAAA,iBAC1C,wBAAA,oBAA4C,gBAAA,GAAA,CAC1D,OAAA,EAAS,+BAAA;EAAoC,MAAA,EAAQ,CAAA;AAAA,IACpD,kBAAA,CAAmB,IAAA,CAAK,cAAA,EAAgB,uBAAA,CAAwB,CAAA"}
package/dist/workflow.mjs CHANGED
@@ -1,12 +1,13 @@
1
- import { n as createGithubAgent, r as resolveInstructions, t as createGithubTools } from "./src--pAdGYqY.mjs";
2
- import { DurableAgent } from "@workflow/ai/agent";
1
+ import { i as PRESET_TOOLS, in as resolveGithubToken, r as GITHUB_TOOL_NAMES, t as GITHUB_WRITE_TOOLS } from "./write-tools-Dx9LfYlU.mjs";
2
+ import { n as createGithubAgent, r as resolveInstructions, t as createGithubTools } from "./src-CfzZfU82.mjs";
3
+ import { WorkflowAgent } from "@ai-sdk/workflow";
3
4
  //#region src/workflow.ts
4
5
  /**
5
- * A wrapper around the Workflow SDK's `DurableAgent` that adds a non-streaming
6
+ * A wrapper around {@link WorkflowAgent} that adds a non-streaming
6
7
  * `.generate()` method alongside the existing `.stream()`.
7
8
  *
8
- * - `.stream()` — delegates to `DurableAgent.stream()`, each tool call is
9
- * an individually retriable workflow step. Works in workflow context.
9
+ * - `.stream()` — delegates to `WorkflowAgent.stream()`. Each tool call is
10
+ * an individually retriable workflow step. Supports `needsApproval` on tools.
10
11
  * - `.generate()` — uses `generateText` from the AI SDK for non-streaming
11
12
  * execution. Must be called from within a `"use step"` function in
12
13
  * workflow context (the Workflow runtime blocks raw I/O in workflow scope).
@@ -18,10 +19,10 @@ var DurableGithubAgent = class {
18
19
  _telemetry;
19
20
  _tools;
20
21
  constructor(options) {
21
- this.agent = new DurableAgent(options);
22
+ this.agent = new WorkflowAgent(options);
22
23
  this._model = options.model;
23
- this._instructions = options.instructions;
24
- this._telemetry = options.experimental_telemetry;
24
+ this._instructions = typeof options.instructions === "string" ? options.instructions : void 0;
25
+ this._telemetry = options.telemetry;
25
26
  this._tools = options.tools ?? {};
26
27
  }
27
28
  /** The tool set configured for this agent. */
@@ -29,7 +30,7 @@ var DurableGithubAgent = class {
29
30
  return this.agent.tools;
30
31
  }
31
32
  /**
32
- * Stream the agent's response. Delegates directly to `DurableAgent.stream()`.
33
+ * Stream the agent's response. Delegates directly to `WorkflowAgent.stream()`.
33
34
  * Works in workflow context — each tool call is a durable step.
34
35
  */
35
36
  stream(options) {
@@ -41,26 +42,12 @@ var DurableGithubAgent = class {
41
42
  * In workflow context this **must** be called from within a `"use step"`
42
43
  * function, because the Workflow runtime blocks direct I/O (HTTP calls)
43
44
  * at the workflow scope level.
44
- *
45
- * @example
46
- * ```ts
47
- * async function agentTurn(prompt: string) {
48
- * "use step"
49
- * const agent = createDurableGithubAgent({
50
- * model: 'anthropic/claude-sonnet-4.6',
51
- * preset: 'code-review',
52
- * })
53
- * const { text } = await agent.generate({ prompt })
54
- * return text
55
- * }
56
- * ```
57
45
  */
58
46
  async generate({ prompt, stopWhen }) {
59
47
  const { generateText } = await import("ai");
60
- const model = typeof this._model === "function" ? await this._model() : this._model;
61
- const system = typeof this._instructions === "string" ? this._instructions : void 0;
48
+ const system = this._instructions;
62
49
  const result = await generateText({
63
- model,
50
+ model: this._model,
64
51
  tools: this._tools,
65
52
  system,
66
53
  prompt,
@@ -76,52 +63,6 @@ var DurableGithubAgent = class {
76
63
  };
77
64
  }
78
65
  };
79
- /**
80
- * Create a pre-configured durable GitHub agent powered by Vercel Workflow SDK's `DurableAgent`.
81
- *
82
- * Returns a {@link DurableGithubAgent} with two interaction modes:
83
- *
84
- * - `.stream()` — works directly in workflow scope; each tool call is a durable step.
85
- * - `.generate()` — uses `generateText` from the AI SDK; must be called from
86
- * within a `"use step"` function when running inside a workflow.
87
- *
88
- * **Note:** `requireApproval` is accepted for forward-compatibility but is currently
89
- * ignored by `DurableAgent` — the Workflow SDK does not yet support interactive tool
90
- * approval. All tools execute immediately without user confirmation.
91
- *
92
- * @example Streaming (chat UI — works in workflow scope)
93
- * ```ts
94
- * import { createDurableGithubAgent } from '@github-tools/sdk/workflow'
95
- * import { getWritable } from 'workflow'
96
- * import type { ModelMessage, UIMessageChunk } from 'ai'
97
- *
98
- * async function chatWorkflow(messages: ModelMessage[], token: string) {
99
- * "use workflow"
100
- * const agent = createDurableGithubAgent({
101
- * model: 'anthropic/claude-sonnet-4.6',
102
- * token,
103
- * preset: 'code-review',
104
- * })
105
- * const writable = getWritable<UIMessageChunk>()
106
- * await agent.stream({ messages, writable })
107
- * }
108
- * ```
109
- *
110
- * @example Non-streaming (bot / background job — needs "use step")
111
- * ```ts
112
- * import { createDurableGithubAgent } from '@github-tools/sdk/workflow'
113
- *
114
- * async function agentTurn(prompt: string) {
115
- * "use step"
116
- * const agent = createDurableGithubAgent({
117
- * model: 'anthropic/claude-sonnet-4.6',
118
- * preset: 'code-review',
119
- * })
120
- * const { text } = await agent.generate({ prompt })
121
- * return text
122
- * }
123
- * ```
124
- */
125
66
  function createDurableGithubAgent({ model, token, preset, requireApproval, instructions, additionalInstructions, author, committer, coAuthors, ...agentOptions }) {
126
67
  const tools = createGithubTools({
127
68
  token,
@@ -131,10 +72,9 @@ function createDurableGithubAgent({ model, token, preset, requireApproval, instr
131
72
  committer,
132
73
  coAuthors
133
74
  });
134
- const resolvedModel = typeof model === "string" || typeof model === "function" ? model : () => Promise.resolve(model);
135
75
  return new DurableGithubAgent({
136
76
  ...agentOptions,
137
- model: resolvedModel,
77
+ model,
138
78
  tools,
139
79
  instructions: resolveInstructions({
140
80
  preset,
@@ -144,6 +84,6 @@ function createDurableGithubAgent({ model, token, preset, requireApproval, instr
144
84
  });
145
85
  }
146
86
  //#endregion
147
- export { DurableGithubAgent, createDurableGithubAgent, createGithubAgent, createGithubTools };
87
+ export { DurableGithubAgent, GITHUB_TOOL_NAMES, GITHUB_WRITE_TOOLS, PRESET_TOOLS, createDurableGithubAgent, createGithubAgent, createGithubTools, resolveGithubToken };
148
88
 
149
89
  //# sourceMappingURL=workflow.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"workflow.mjs","names":[],"sources":["../src/workflow.ts"],"sourcesContent":["import { DurableAgent } from '@workflow/ai/agent'\nimport type { CompatibleLanguageModel, DurableAgentOptions, DurableAgentStreamOptions, DurableAgentStreamResult, TelemetrySettings } from '@workflow/ai/agent'\nimport type { ToolSet, StepResult, FinishReason, LanguageModelUsage, LanguageModelResponseMetadata, ModelMessage, StopCondition } from 'ai'\nimport { createGithubTools } from './index'\nimport { resolveInstructions } from './agents'\nimport type { GithubToolPreset, ApprovalConfig } from './index'\nimport type { CommitIdentity } from './types'\n\n/**\n * Result of {@link DurableGithubAgent.generate}.\n */\nexport interface DurableGithubAgentGenerateResult<TTools extends ToolSet = ToolSet> {\n text: string\n finishReason: FinishReason\n usage: LanguageModelUsage\n steps: StepResult<TTools>[]\n response: LanguageModelResponseMetadata & { messages: ModelMessage[] }\n}\n\n/**\n * A wrapper around the Workflow SDK's `DurableAgent` that adds a non-streaming\n * `.generate()` method alongside the existing `.stream()`.\n *\n * - `.stream()` — delegates to `DurableAgent.stream()`, each tool call is\n * an individually retriable workflow step. Works in workflow context.\n * - `.generate()` — uses `generateText` from the AI SDK for non-streaming\n * execution. Must be called from within a `\"use step\"` function in\n * workflow context (the Workflow runtime blocks raw I/O in workflow scope).\n */\nexport class DurableGithubAgent<TTools extends ToolSet = ToolSet> {\n private agent: DurableAgent<TTools>\n private _model: DurableAgentOptions<TTools>['model']\n private _instructions?: DurableAgentOptions<TTools>['instructions']\n private _telemetry?: TelemetrySettings\n private _tools: TTools\n\n constructor(options: DurableAgentOptions<TTools>) {\n this.agent = new DurableAgent(options)\n this._model = options.model\n this._instructions = options.instructions\n this._telemetry = options.experimental_telemetry\n this._tools = options.tools ?? {} as TTools\n }\n\n /** The tool set configured for this agent. */\n get tools(): TTools {\n return this.agent.tools\n }\n\n /**\n * Stream the agent's response. Delegates directly to `DurableAgent.stream()`.\n * Works in workflow context — each tool call is a durable step.\n */\n stream<TStreamTools extends TTools = TTools, OUTPUT = never, PARTIAL_OUTPUT = never>(\n options: DurableAgentStreamOptions<TStreamTools, OUTPUT, PARTIAL_OUTPUT>,\n ): Promise<DurableAgentStreamResult<TStreamTools, OUTPUT>> {\n return this.agent.stream(options)\n }\n\n /**\n * Generate a non-streaming response using `generateText` from the AI SDK.\n *\n * In workflow context this **must** be called from within a `\"use step\"`\n * function, because the Workflow runtime blocks direct I/O (HTTP calls)\n * at the workflow scope level.\n *\n * @example\n * ```ts\n * async function agentTurn(prompt: string) {\n * \"use step\"\n * const agent = createDurableGithubAgent({\n * model: 'anthropic/claude-sonnet-4.6',\n * preset: 'code-review',\n * })\n * const { text } = await agent.generate({ prompt })\n * return text\n * }\n * ```\n */\n async generate({ prompt, stopWhen }: { prompt: string, stopWhen?: StopCondition<TTools> | Array<StopCondition<TTools>> }): Promise<DurableGithubAgentGenerateResult<TTools>> {\n const { generateText } = await import('ai')\n\n const model = typeof this._model === 'function'\n ? await this._model()\n : this._model\n\n const system = typeof this._instructions === 'string'\n ? this._instructions\n : undefined\n\n const result = await generateText({\n model: model as Parameters<typeof generateText>[0]['model'],\n tools: this._tools,\n system,\n prompt,\n stopWhen,\n experimental_telemetry: this._telemetry as Parameters<typeof generateText>[0]['experimental_telemetry'],\n })\n\n return {\n text: result.text,\n finishReason: result.finishReason,\n usage: result.usage,\n steps: result.steps as StepResult<TTools>[],\n response: result.response,\n }\n }\n}\n\n/**\n * Options for creating a durable GitHub agent via {@link createDurableGithubAgent}.\n *\n * Extends all `DurableAgentOptions` (temperature, telemetry, callbacks, etc.)\n * and adds GitHub-specific fields (token, preset, approval config).\n */\nexport type CreateDurableGithubAgentOptions =\n Omit<DurableAgentOptions, 'model' | 'tools' | 'instructions'> & {\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 /**\n * Default author for commit-creating tools.\n * Falls back to the authenticated user when omitted.\n */\n author?: CommitIdentity\n /**\n * Default committer for commit-creating tools.\n * Falls back to the authenticated user when omitted.\n */\n committer?: CommitIdentity\n /**\n * Co-authors to attribute on all commits.\n * Added as \"Co-authored-by\" trailers to commit messages.\n */\n coAuthors?: CommitIdentity[]\n }\n\n/**\n * Create a pre-configured durable GitHub agent powered by Vercel Workflow SDK's `DurableAgent`.\n *\n * Returns a {@link DurableGithubAgent} with two interaction modes:\n *\n * - `.stream()` — works directly in workflow scope; each tool call is a durable step.\n * - `.generate()` — uses `generateText` from the AI SDK; must be called from\n * within a `\"use step\"` function when running inside a workflow.\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 Streaming (chat UI — works in workflow scope)\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 *\n * @example Non-streaming (bot / background job — needs \"use step\")\n * ```ts\n * import { createDurableGithubAgent } from '@github-tools/sdk/workflow'\n *\n * async function agentTurn(prompt: string) {\n * \"use step\"\n * const agent = createDurableGithubAgent({\n * model: 'anthropic/claude-sonnet-4.6',\n * preset: 'code-review',\n * })\n * const { text } = await agent.generate({ prompt })\n * return text\n * }\n * ```\n */\nexport function createDurableGithubAgent({\n model,\n token,\n preset,\n requireApproval,\n instructions,\n additionalInstructions,\n author,\n committer,\n coAuthors,\n ...agentOptions\n}: CreateDurableGithubAgentOptions) {\n const tools = createGithubTools({ token, requireApproval, preset, author, committer, coAuthors })\n\n const resolvedModel = typeof model === 'string' || typeof model === 'function'\n ? model\n : () => Promise.resolve(model)\n\n return new DurableGithubAgent({\n ...agentOptions as Omit<typeof agentOptions, 'toolChoice'>,\n model: resolvedModel,\n tools,\n instructions: resolveInstructions({ preset, instructions, additionalInstructions }),\n })\n}\n\nexport { createGithubTools, createGithubAgent } from './index'\nexport type { CommitIdentity, CommitToolOptions, GithubTools, GithubToolsOptions, GithubToolPreset, GithubWriteToolName, ApprovalConfig, ToolOverrides } from './index'\nexport type { CreateGithubAgentOptions } from './agents'\n"],"mappings":";;;;;;;;;;;;;AA6BA,IAAa,qBAAb,MAAkE;CAChE;CACA;CACA;CACA;CACA;CAEA,YAAY,SAAsC;AAChD,OAAK,QAAQ,IAAI,aAAa,QAAQ;AACtC,OAAK,SAAS,QAAQ;AACtB,OAAK,gBAAgB,QAAQ;AAC7B,OAAK,aAAa,QAAQ;AAC1B,OAAK,SAAS,QAAQ,SAAS,EAAE;;;CAInC,IAAI,QAAgB;AAClB,SAAO,KAAK,MAAM;;;;;;CAOpB,OACE,SACyD;AACzD,SAAO,KAAK,MAAM,OAAO,QAAQ;;;;;;;;;;;;;;;;;;;;;;CAuBnC,MAAM,SAAS,EAAE,QAAQ,YAAoJ;EAC3K,MAAM,EAAE,iBAAiB,MAAM,OAAO;EAEtC,MAAM,QAAQ,OAAO,KAAK,WAAW,aACjC,MAAM,KAAK,QAAQ,GACnB,KAAK;EAET,MAAM,SAAS,OAAO,KAAK,kBAAkB,WACzC,KAAK,gBACL,KAAA;EAEJ,MAAM,SAAS,MAAM,aAAa;GACzB;GACP,OAAO,KAAK;GACZ;GACA;GACA;GACA,wBAAwB,KAAK;GAC9B,CAAC;AAEF,SAAO;GACL,MAAM,OAAO;GACb,cAAc,OAAO;GACrB,OAAO,OAAO;GACd,OAAO,OAAO;GACd,UAAU,OAAO;GAClB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqFL,SAAgB,yBAAyB,EACvC,OACA,OACA,QACA,iBACA,cACA,wBACA,QACA,WACA,WACA,GAAG,gBAC+B;CAClC,MAAM,QAAQ,kBAAkB;EAAE;EAAO;EAAiB;EAAQ;EAAQ;EAAW;EAAW,CAAC;CAEjG,MAAM,gBAAgB,OAAO,UAAU,YAAY,OAAO,UAAU,aAChE,cACM,QAAQ,QAAQ,MAAM;AAEhC,QAAO,IAAI,mBAAmB;EAC5B,GAAG;EACH,OAAO;EACP;EACA,cAAc,oBAAoB;GAAE;GAAQ;GAAc;GAAwB,CAAC;EACpF,CAAC"}
1
+ {"version":3,"file":"workflow.mjs","names":[],"sources":["../src/workflow.ts"],"sourcesContent":["import { WorkflowAgent } from '@ai-sdk/workflow'\nimport type {\n WorkflowAgentOptions,\n WorkflowAgentStreamOptions,\n WorkflowAgentStreamResult,\n TelemetryOptions,\n} from '@ai-sdk/workflow'\nimport type {\n LanguageModel,\n ToolSet,\n StepResult,\n FinishReason,\n LanguageModelUsage,\n LanguageModelResponseMetadata,\n ModelMessage,\n StopCondition,\n} from 'ai'\nimport { createGithubTools } from './index'\nimport { resolveInstructions } from './agents'\nimport type { AllGithubTools } from './core/tool-types'\nimport type { CombinedPresetToolNames, GithubToolPreset, PresetToolName } from './core/presets'\nimport type { GithubToolName } from './core/tool-names'\nimport type { ApprovalConfig } from './index'\nimport type { CommitIdentity } from './types'\nimport type { GithubTokenInput } from './core/token'\nimport type { Context } from '@ai-sdk/provider-utils'\n\n/**\n * Result of {@link DurableGithubAgent.generate}.\n */\nexport interface DurableGithubAgentGenerateResult<TTools extends ToolSet = ToolSet> {\n text: string\n finishReason: FinishReason\n usage: LanguageModelUsage\n steps: StepResult<TTools>[]\n response: LanguageModelResponseMetadata & { messages: ModelMessage[] }\n}\n\n/**\n * A wrapper around {@link WorkflowAgent} that adds a non-streaming\n * `.generate()` method alongside the existing `.stream()`.\n *\n * - `.stream()` — delegates to `WorkflowAgent.stream()`. Each tool call is\n * an individually retriable workflow step. Supports `needsApproval` on tools.\n * - `.generate()` — uses `generateText` from the AI SDK for non-streaming\n * execution. Must be called from within a `\"use step\"` function in\n * workflow context (the Workflow runtime blocks raw I/O in workflow scope).\n */\nexport class DurableGithubAgent<TTools extends ToolSet = ToolSet> {\n private agent: WorkflowAgent<TTools>\n private _model: LanguageModel\n private _instructions?: string\n private _telemetry?: TelemetryOptions\n private _tools: TTools\n\n constructor(options: WorkflowAgentOptions<TTools>) {\n this.agent = new WorkflowAgent(options)\n this._model = options.model\n this._instructions = typeof options.instructions === 'string' ? options.instructions : undefined\n this._telemetry = options.telemetry\n this._tools = options.tools ?? {} as TTools\n }\n\n /** The tool set configured for this agent. */\n get tools(): TTools {\n return this.agent.tools\n }\n\n /**\n * Stream the agent's response. Delegates directly to `WorkflowAgent.stream()`.\n * Works in workflow context — each tool call is a durable step.\n */\n stream<TStreamTools extends TTools = TTools, OUTPUT = never, PARTIAL_OUTPUT = never>(\n options: WorkflowAgentStreamOptions<TStreamTools, Context, OUTPUT, PARTIAL_OUTPUT>,\n ): Promise<WorkflowAgentStreamResult<TStreamTools, OUTPUT>> {\n return this.agent.stream(options)\n }\n\n /**\n * Generate a non-streaming response using `generateText` from the AI SDK.\n *\n * In workflow context this **must** be called from within a `\"use step\"`\n * function, because the Workflow runtime blocks direct I/O (HTTP calls)\n * at the workflow scope level.\n */\n async generate({ prompt, stopWhen }: { prompt: string, stopWhen?: StopCondition<TTools> | Array<StopCondition<TTools>> }): Promise<DurableGithubAgentGenerateResult<TTools>> {\n const { generateText } = await import('ai')\n\n const system = this._instructions\n\n const result = await generateText({\n model: this._model,\n tools: this._tools,\n system,\n prompt,\n stopWhen,\n experimental_telemetry: this._telemetry as Parameters<typeof generateText>[0]['experimental_telemetry'],\n })\n\n return {\n text: result.text,\n finishReason: result.finishReason,\n usage: result.usage,\n steps: result.steps as StepResult<TTools>[],\n response: result.response,\n }\n }\n}\n\n/**\n * Options for creating a durable GitHub agent via {@link createDurableGithubAgent}.\n *\n * Extends all `WorkflowAgentOptions` (temperature, telemetry, callbacks, etc.)\n * and adds GitHub-specific fields (token, preset, approval config).\n */\nexport type CreateDurableGithubAgentOptions =\n Omit<WorkflowAgentOptions, 'model' | 'tools' | 'instructions'> & {\n model: string | LanguageModel\n /**\n * GitHub personal access token or async token provider.\n * Falls back to `process.env.GITHUB_TOKEN` when omitted.\n */\n token?: GithubTokenInput\n /**\n * Restrict tools and system prompt to a predefined preset.\n *\n * Selects a subset of tools and, when a single preset is passed,\n * sets a matching system prompt. Combine presets with an array to merge tool sets.\n *\n * @see {@link GithubToolPreset} for available presets and included tools.\n */\n preset?: GithubToolPreset | GithubToolPreset[]\n /**\n * Control whether write operations require user approval before execution.\n *\n * @see {@link ApprovalConfig} for global and per-tool options.\n */\n requireApproval?: ApprovalConfig\n /**\n * Fully replace the default system prompt.\n * When set, `preset` system prompts and `additionalInstructions` are ignored.\n */\n instructions?: string\n /**\n * Append text to the preset-specific (or default) system prompt.\n * Ignored when `instructions` is set.\n */\n additionalInstructions?: string\n /**\n * Default author for commit-creating tools.\n * Falls back to the authenticated user when omitted.\n */\n author?: CommitIdentity\n /**\n * Default committer for commit-creating tools.\n * Falls back to the authenticated user when omitted.\n */\n committer?: CommitIdentity\n /**\n * Co-authors to attribute on all commits.\n * Added as \"Co-authored-by\" trailers to commit messages.\n */\n coAuthors?: CommitIdentity[]\n }\n\n/**\n * Create a pre-configured durable GitHub agent powered by `WorkflowAgent`\n * from `@ai-sdk/workflow`.\n *\n * Returns a {@link DurableGithubAgent} with two interaction modes:\n *\n * - `.stream()` — works directly in workflow scope; each tool call is a durable step.\n * Write tools honor `requireApproval` via `needsApproval` and pause the workflow\n * until the user approves or denies.\n * - `.generate()` — uses `generateText` from the AI SDK; must be called from\n * within a `\"use step\"` function when running inside a workflow.\n *\n * @example Streaming (chat UI — works in workflow scope)\n * ```ts\n * import { createDurableGithubAgent } from '@github-tools/sdk/workflow'\n * import { getWritable } from 'workflow'\n * import type { ModelMessage, ModelCallStreamPart } 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<ModelCallStreamPart>()\n * await agent.stream({ messages, writable })\n * }\n * ```\n */\nexport function createDurableGithubAgent(\n options: CreateDurableGithubAgentOptions & { preset?: undefined },\n): DurableGithubAgent<AllGithubTools>\nexport function createDurableGithubAgent<P extends GithubToolPreset>(\n options: CreateDurableGithubAgentOptions & { preset: P },\n): DurableGithubAgent<Pick<AllGithubTools, PresetToolName<P>>>\nexport function createDurableGithubAgent<P extends readonly GithubToolPreset[]>(\n options: CreateDurableGithubAgentOptions & { preset: P },\n): DurableGithubAgent<Pick<AllGithubTools, CombinedPresetToolNames<P>>>\nexport function createDurableGithubAgent({\n model,\n token,\n preset,\n requireApproval,\n instructions,\n additionalInstructions,\n author,\n committer,\n coAuthors,\n ...agentOptions\n}: CreateDurableGithubAgentOptions): DurableGithubAgent<AllGithubTools | Pick<AllGithubTools, GithubToolName>> {\n const tools = createGithubTools({ token, requireApproval, preset, author, committer, coAuthors })\n\n return new DurableGithubAgent({\n ...agentOptions,\n model,\n tools,\n instructions: resolveInstructions({ preset, instructions, additionalInstructions }),\n }) as DurableGithubAgent<typeof tools>\n}\n\nexport { createGithubTools, createGithubAgent } from './index'\nexport type { CommitIdentity, CommitToolOptions, GithubTools, GithubToolsOptions, GithubToolPreset, GithubToolName, GithubWriteToolName, ApprovalConfig, ToolOverrides, AllGithubTools, PresetToolName, CombinedPresetToolNames, GithubToolsForPreset, PickGithubTools, GithubTokenInput } from './index'\nexport { PRESET_TOOLS, GITHUB_TOOL_NAMES, GITHUB_WRITE_TOOLS, resolveGithubToken } from './index'\nexport type { CreateGithubAgentOptions } from './agents'\n"],"mappings":";;;;;;;;;;;;;;AAgDA,IAAa,qBAAb,MAAkE;CAChE;CACA;CACA;CACA;CACA;CAEA,YAAY,SAAuC;AACjD,OAAK,QAAQ,IAAI,cAAc,QAAQ;AACvC,OAAK,SAAS,QAAQ;AACtB,OAAK,gBAAgB,OAAO,QAAQ,iBAAiB,WAAW,QAAQ,eAAe,KAAA;AACvF,OAAK,aAAa,QAAQ;AAC1B,OAAK,SAAS,QAAQ,SAAS,EAAE;;;CAInC,IAAI,QAAgB;AAClB,SAAO,KAAK,MAAM;;;;;;CAOpB,OACE,SAC0D;AAC1D,SAAO,KAAK,MAAM,OAAO,QAAQ;;;;;;;;;CAUnC,MAAM,SAAS,EAAE,QAAQ,YAAoJ;EAC3K,MAAM,EAAE,iBAAiB,MAAM,OAAO;EAEtC,MAAM,SAAS,KAAK;EAEpB,MAAM,SAAS,MAAM,aAAa;GAChC,OAAO,KAAK;GACZ,OAAO,KAAK;GACZ;GACA;GACA;GACA,wBAAwB,KAAK;GAC9B,CAAC;AAEF,SAAO;GACL,MAAM,OAAO;GACb,cAAc,OAAO;GACrB,OAAO,OAAO;GACd,OAAO,OAAO;GACd,UAAU,OAAO;GAClB;;;AAmGL,SAAgB,yBAAyB,EACvC,OACA,OACA,QACA,iBACA,cACA,wBACA,QACA,WACA,WACA,GAAG,gBAC0G;CAC7G,MAAM,QAAQ,kBAAkB;EAAE;EAAO;EAAiB;EAAQ;EAAQ;EAAW;EAAW,CAAC;AAEjG,QAAO,IAAI,mBAAmB;EAC5B,GAAG;EACH;EACA;EACA,cAAc,oBAAoB;GAAE;GAAQ;GAAc;GAAwB,CAAC;EACpF,CAAC"}