@loopstack/github-oauth-example 0.1.1 → 0.2.1

package/README.md

@@ -2,7 +2,7 @@
 
 > An example module for the [Loopstack AI](https://loopstack.ai) automation framework.
 
-This module demonstrates how to build workflows that interact with the GitHub API using OAuth authentication. It includes two workflows: a structured overview that fetches repository data, and an interactive chat agent powered by an LLM that can use all 25 GitHub tools.
+This module demonstrates how to build workflows that interact with the GitHub API using OAuth authentication. It includes two workflows: a structured overview that fetches repository data, and an interactive chat agent powered by Claude that can use all 25 GitHub tools.
 
 ## Workflows
 
@@ -15,16 +15,70 @@ A multi-step workflow that fetches and displays a comprehensive overview of a Gi
 **Flow:**
 
 ```
-start -> fetch_user -> fetch_orgs -> fetch_repo_details -> fetch_issues_prs
-  -> fetch_content_actions -> fetch_search -> display_results -> end
+start -> user_fetched -> orgs_fetched -> repo_fetched -> issues_prs_fetched
+  -> content_actions_fetched -> search_done -> end
 ```
 
 With OAuth branching:
 
 ```
-fetch_user -> (unauthorized) -> auth_required -> awaiting_auth
-                                                    |
-                                              auth_completed -> start (retry)
+user_fetched -> (unauthorized via @Guard) -> awaiting_auth
+                                                |
+                                          auth_completed -> start (retry)
+```
+
+**Key patterns:**
+
+The workflow uses `@Guard` to check if authentication is needed and routes to the OAuth flow:
+
+```typescript
+@Transition({ from: 'user_fetched', to: 'awaiting_auth', priority: 10 })
+@Guard('needsAuth')
+async authRequired() {
+  const result = await this.oAuth.run(
+    { provider: 'github', scopes: ['repo', 'read:org', 'workflow'] },
+    { alias: 'oAuth', callback: { transition: 'authCompleted' } },
+  );
+
+  await this.repository.save(
+    LinkDocument,
+    {
+      label: 'GitHub authentication required',
+      workflowId: result.workflowId,
+      embed: true,
+      expanded: true,
+    },
+    { id: `link_${result.workflowId}` },
+  );
+}
+
+needsAuth(): boolean {
+  return !!this.requiresAuthentication;
+}
+```
+
+The auth callback uses `wait: true` with `CallbackSchema` to receive the OAuth completion signal:
+
+```typescript
+@Transition({
+  from: 'awaiting_auth',
+  to: 'start',
+  wait: true,
+  schema: CallbackSchema,
+})
+async authCompleted(payload: { workflowId: string }) {
+  await this.repository.save(
+    LinkDocument,
+    {
+      status: 'success',
+      label: 'GitHub authentication completed',
+      workflowId: payload.workflowId,
+      embed: true,
+      expanded: false,
+    },
+    { id: `link_${payload.workflowId}` },
+  );
+}
 ```
 
 **Tools exercised in the workflow:**
@@ -61,18 +115,60 @@ All 25 tools are injected and available; 9 are called directly by the workflow t
 
 ### GitHub Agent (`gitHubAgent`)
 
-An interactive chat agent that gives an LLM access to all 25 GitHub tools. The agent can manage repositories, issues, pull requests, browse code, check CI/CD status, search across GitHub, and handle OAuth automatically.
+An interactive chat agent that gives Claude access to all 25 GitHub tools. The agent can manage repositories, issues, pull requests, browse code, check CI/CD status, search across GitHub, and handle OAuth automatically via the `AuthenticateGitHubTask` custom tool.
 
 **How it works:**
 
-1. Sets up a system prompt describing available GitHub capabilities
-2. Waits for user input via a chat prompt
-3. Sends the conversation to the LLM with all GitHub tools available
-4. Executes any tool calls the LLM makes
-5. If a tool returns an auth error, launches OAuth and resumes after authentication
+1. Sets up a hidden system message describing available GitHub capabilities
+2. Waits for user input via a `wait: true` transition
+3. Sends the conversation to Claude with all 25 GitHub tools plus `authenticateGitHub`
+4. If `stop_reason === 'tool_use'`, delegates tool calls via `DelegateToolCalls` and collects results with `UpdateToolResult`
+5. If a tool returns an auth error, the LLM calls `authenticateGitHub` which launches OAuth
 6. Loops back to wait for the next user message
 
-This is the easiest way to interactively test every GitHub tool — just ask the agent to perform any GitHub operation.
+**Agent loop pattern:**
+
+```typescript
+@Transition({ from: 'ready', to: 'prompt_executed' })
+async llmTurn() {
+  const result: ToolResult<ClaudeGenerateTextResult> = await this.claudeGenerateText.call({
+    system: `You are a helpful GitHub assistant with access to repository, issue, PR, code, actions,
+and search tools. When a tool returns an unauthorized error, use authenticateGitHub
+to let the user sign in, then retry. Be concise and format results using markdown.`,
+    claude: { model: 'claude-sonnet-4-6' },
+    messagesSearchTag: 'message',
+    tools: [
+      'gitHubListRepos', 'gitHubGetRepo', 'gitHubCreateRepo', 'gitHubListBranches',
+      'gitHubListIssues', 'gitHubGetIssue', 'gitHubCreateIssue', 'gitHubCreateIssueComment',
+      'gitHubListPullRequests', 'gitHubGetPullRequest', 'gitHubCreatePullRequest',
+      'gitHubMergePullRequest', 'gitHubListPrReviews',
+      'gitHubGetFileContent', 'gitHubCreateOrUpdateFile', 'gitHubListDirectory', 'gitHubGetCommit',
+      'gitHubListWorkflowRuns', 'gitHubTriggerWorkflow', 'gitHubGetWorkflowRun',
+      'gitHubSearchCode', 'gitHubSearchRepos', 'gitHubSearchIssues',
+      'gitHubGetAuthenticatedUser', 'gitHubListUserOrgs',
+      'authenticateGitHub',
+    ],
+  });
+  this.llmResult = result.data;
+}
+
+@Transition({ from: 'prompt_executed', to: 'awaiting_tools', priority: 10 })
+@Guard('hasToolCalls')
+async executeToolCalls() {
+  const result: ToolResult<DelegateToolCallsResult> = await this.delegateToolCalls.call({
+    message: this.llmResult!,
+    document: ClaudeMessageDocument,
+    callback: { transition: 'toolResultReceived' },
+  });
+  this.delegateResult = result.data;
+}
+
+hasToolCalls(): boolean {
+  return this.llmResult?.stop_reason === 'tool_use';
+}
+```
+
+This is the easiest way to interactively test every GitHub tool -- just ask the agent to perform any GitHub operation.
 
 ## Setup
 
@@ -89,17 +185,17 @@ GITHUB_OAUTH_REDIRECT_URI=http://localhost:5173/oauth/callback
 For the GitHub Agent workflow, you also need an LLM API key:
 
 ```bash
-OPENAI_API_KEY=your-openai-api-key
+ANTHROPIC_API_KEY=your-anthropic-api-key
 ```
 
 ## Dependencies
 
-- `@loopstack/core` — Core framework functionality including `ExecuteWorkflowAsync`
-- `@loopstack/ai-module` — LLM integration (`AiGenerateText`, `DelegateToolCall`)
-- `@loopstack/oauth-module` — OAuth infrastructure (`OAuthTokenStore`, `OAuthWorkflow`)
-- `@loopstack/github-module` — All 25 GitHub tools and the GitHub OAuth provider
-- `@loopstack/core-ui-module` — `CreateDocument`, `LinkDocument`, `MarkdownDocument`
-- `@loopstack/create-chat-message-tool` — `CreateChatMessage`
+- `@loopstack/common` - Core framework decorators (`BaseWorkflow`, `@Workflow`, `@Initial`, `@Transition`, `@Final`, `@Guard`, `@InjectTool`, `@InjectWorkflow`, `CallbackSchema`, `ToolResult`)
+- `@loopstack/core` - Provides `LinkDocument` and `MarkdownDocument`
+- `@loopstack/claude-module` - Claude integration (`ClaudeGenerateText`, `ClaudeMessageDocument`, `DelegateToolCalls`, `UpdateToolResult`)
+- `@loopstack/oauth-module` - OAuth infrastructure (`OAuthWorkflow`)
+- `@loopstack/github-module` - All 25 GitHub tools
+- `@loopstack/create-chat-message-tool` - `CreateChatMessage` (used in agent workflow)
 
 ## About
 

package/dist/tools/authenticate-github-task.tool.d.ts

@@ -1,17 +1,18 @@
 import { z } from 'zod';
-import { RunContext, ToolInterface, ToolResult, WorkflowInterface, WorkflowMetadataInterface } from '@loopstack/common';
+import { BaseTool, ToolResult } from '@loopstack/common';
 declare const AuthenticateGitHubTaskInputSchema: z.ZodObject<{
     scopes: z.ZodArray<z.ZodString>;
+    callback: z.ZodOptional<z.ZodObject<{
+        transition: z.ZodString;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
 }, z.core.$strict>;
 type AuthenticateGitHubTaskInput = z.infer<typeof AuthenticateGitHubTaskInputSchema>;
-export declare class AuthenticateGitHubTask implements ToolInterface<AuthenticateGitHubTaskInput> {
+export declare class AuthenticateGitHubTask extends BaseTool {
     private readonly logger;
-    private task;
-    private createDocument;
-    private linkDocument;
-    args: AuthenticateGitHubTaskInput;
-    execute(args: AuthenticateGitHubTaskInput, ctx: RunContext, parent: WorkflowInterface | ToolInterface, metadata: WorkflowMetadataInterface): Promise<ToolResult>;
-    complete(result: Record<string, unknown>, ctx: RunContext, parent: WorkflowInterface | ToolInterface, metadata: WorkflowMetadataInterface): Promise<ToolResult>;
+    private oAuth;
+    call(args: AuthenticateGitHubTaskInput): Promise<ToolResult>;
+    complete(result: Record<string, unknown>): Promise<ToolResult>;
 }
 export {};
 //# sourceMappingURL=authenticate-github-task.tool.d.ts.map

package/dist/tools/authenticate-github-task.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"authenticate-github-task.tool.d.ts","sourceRoot":"","sources":["../../src/tools/authenticate-github-task.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAIL,UAAU,EAEV,aAAa,EACb,UAAU,EAEV,iBAAiB,EACjB,yBAAyB,EAC1B,MAAM,mBAAmB,CAAC;AAG3B,QAAA,MAAM,iCAAiC;;kBAI5B,CAAC;AAEZ,KAAK,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAErF,qBAUa,sBAAuB,YAAW,aAAa,CAAC,2BAA2B,CAAC;IACvF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2C;IAEpD,OAAO,CAAC,IAAI,CAAO;IACnB,OAAO,CAAC,cAAc,CAAiB;IACnC,OAAO,CAAC,YAAY,CAAe;IAGrD,IAAI,EAAE,2BAA2B,CAAC;IAE5B,OAAO,CACX,IAAI,EAAE,2BAA2B,EACjC,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,iBAAiB,GAAG,aAAa,EACzC,QAAQ,EAAE,yBAAyB,GAClC,OAAO,CAAC,UAAU,CAAC;IAuChB,QAAQ,CACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,iBAAiB,GAAG,aAAa,EACzC,QAAQ,EAAE,yBAAyB,GAClC,OAAO,CAAC,UAAU,CAAC;CA+BvB"}
+{"version":3,"file":"authenticate-github-task.tool.d.ts","sourceRoot":"","sources":["../../src/tools/authenticate-github-task.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAwB,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAI/E,QAAA,MAAM,iCAAiC;;;;;;kBAU5B,CAAC;AAEZ,KAAK,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAErF,qBAWa,sBAAuB,SAAQ,QAAQ;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2C;IAEhD,OAAO,CAAC,KAAK,CAAgB;IAEzC,IAAI,CAAC,IAAI,EAAE,2BAA2B,GAAG,OAAO,CAAC,UAAU,CAAC;IAuB5D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CAiBrE"}

package/dist/tools/authenticate-github-task.tool.js

@@ -15,93 +15,61 @@ const common_1 = require("@nestjs/common");
 const zod_1 = require("zod");
 const common_2 = require("@loopstack/common");
 const core_1 = require("@loopstack/core");
+const oauth_module_1 = require("@loopstack/oauth-module");
 const AuthenticateGitHubTaskInputSchema = zod_1.z
     .object({
     scopes: zod_1.z.array(zod_1.z.string()).describe('The OAuth scopes to request (e.g. repo, user, workflow, read:org)'),
+    callback: zod_1.z
+        .object({
+        transition: zod_1.z.string(),
+        metadata: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+    })
+        .optional(),
 })
     .strict();
-let AuthenticateGitHubTask = AuthenticateGitHubTask_1 = class AuthenticateGitHubTask {
+let AuthenticateGitHubTask = AuthenticateGitHubTask_1 = class AuthenticateGitHubTask extends common_2.BaseTool {
     logger = new common_1.Logger(AuthenticateGitHubTask_1.name);
-    task;
-    createDocument;
-    linkDocument;
-    args;
-    async execute(args, ctx, parent, metadata) {
-        const taskResult = await this.task.execute({ workflow: 'oAuth', args: { provider: 'github', scopes: args.scopes } }, ctx, parent);
-        const effects = [];
-        const linkResult = await this.createDocument.execute({
-            document: 'linkDocument',
-            id: 'github_auth_link',
-            validate: 'skip',
-            update: {
-                content: {
-                    icon: 'LockKeyhole',
-                    label: 'GitHub authentication required',
-                    caption: 'Complete sign-in to access GitHub',
-                    href: `/pipelines/${String(taskResult.data.pipelineId)}`,
-                    embed: true,
-                    expanded: true,
-                },
-            },
-        }, ctx, this, metadata);
-        if (linkResult.effects) {
-            effects.push(...linkResult.effects);
-        }
+    oAuth;
+    async call(args) {
+        const result = await this.oAuth.run({ provider: 'github', scopes: args.scopes }, { alias: 'oAuth', callback: args.callback });
+        await this.repository.save(core_1.LinkDocument, {
+            status: 'pending',
+            label: 'GitHub authentication required',
+            workflowId: result.workflowId,
+            embed: true,
+            expanded: true,
+        }, { id: `link_${result.workflowId}` });
         return {
-            data: taskResult.data,
-            effects,
+            data: { ...result, mode: 'async' },
         };
     }
-    async complete(result, ctx, parent, metadata) {
+    async complete(result) {
         const data = result;
-        const effects = [];
-        const linkResult = await this.createDocument.execute({
-            document: 'linkDocument',
-            id: 'github_auth_link',
-            validate: 'skip',
-            update: {
-                content: {
-                    icon: 'ShieldCheck',
-                    label: 'GitHub authentication completed',
-                    href: `/pipelines/${data.pipelineId}`,
-                },
-            },
-        }, ctx, this, metadata);
-        if (linkResult.effects) {
-            effects.push(...linkResult.effects);
-        }
+        await this.repository.save(core_1.LinkDocument, {
+            status: 'success',
+            label: 'GitHub authentication completed',
+            workflowId: data.workflowId,
+        }, { id: `link_${data.workflowId}` });
         return {
             data: 'GitHub authentication completed successfully. You can now use GitHub tools.',
-            effects,
         };
     }
 };
 exports.AuthenticateGitHubTask = AuthenticateGitHubTask;
 __decorate([
-    (0, common_2.InjectTool)(),
-    __metadata("design:type", core_1.Task)
-], AuthenticateGitHubTask.prototype, "task", void 0);
-__decorate([
-    (0, common_2.InjectTool)(),
-    __metadata("design:type", core_1.CreateDocument)
-], AuthenticateGitHubTask.prototype, "createDocument", void 0);
-__decorate([
-    (0, common_2.InjectDocument)(),
-    __metadata("design:type", core_1.LinkDocument)
-], AuthenticateGitHubTask.prototype, "linkDocument", void 0);
-__decorate([
-    (0, common_2.Input)({ schema: AuthenticateGitHubTaskInputSchema }),
-    __metadata("design:type", Object)
-], AuthenticateGitHubTask.prototype, "args", void 0);
+    (0, common_2.InjectWorkflow)(),
+    __metadata("design:type", oauth_module_1.OAuthWorkflow)
+], AuthenticateGitHubTask.prototype, "oAuth", void 0);
 exports.AuthenticateGitHubTask = AuthenticateGitHubTask = AuthenticateGitHubTask_1 = __decorate([
     (0, common_1.Injectable)(),
     (0, common_2.Tool)({
-        config: {
+        uiConfig: {
             description: 'Launches GitHub OAuth authentication. Shows the user a sign-in prompt to authorize access to GitHub. ' +
                 'Use this when a GitHub tool returns an "unauthorized" error. ' +
                 'Pass the required OAuth scopes for the GitHub APIs you need access to. ' +
                 'IMPORTANT: When using this tool, it must be the ONLY tool call in your response. Do not combine it with other tool calls.',
         },
+        schema: AuthenticateGitHubTaskInputSchema,
     })
 ], AuthenticateGitHubTask);
 //# sourceMappingURL=authenticate-github-task.tool.js.map

package/dist/tools/authenticate-github-task.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"authenticate-github-task.tool.js","sourceRoot":"","sources":["../../src/tools/authenticate-github-task.tool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"authenticate-github-task.tool.js","sourceRoot":"","sources":["../../src/tools/authenticate-github-task.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,2CAAoD;AACpD,6BAAwB;AACxB,8CAA+E;AAC/E,0CAA+C;AAC/C,0DAAwD;AAExD,MAAM,iCAAiC,GAAG,OAAC;KACxC,MAAM,CAAC;IACN,MAAM,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,mEAAmE,CAAC;IACzG,QAAQ,EAAE,OAAC;SACR,MAAM,CAAC;QACN,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE;QACtB,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;KACvD,CAAC;SACD,QAAQ,EAAE;CACd,CAAC;KACD,MAAM,EAAE,CAAC;AAeL,IAAM,sBAAsB,8BAA5B,MAAM,sBAAuB,SAAQ,iBAAQ;IACjC,MAAM,GAAG,IAAI,eAAM,CAAC,wBAAsB,CAAC,IAAI,CAAC,CAAC;IAExC,KAAK,CAAgB;IAE/C,KAAK,CAAC,IAAI,CAAC,IAAiC;QAC1C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CACjC,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,EAC3C,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAC5C,CAAC;QAEF,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CACxB,mBAAY,EACZ;YACE,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,gCAAgC;YACvC,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,KAAK,EAAE,IAAI;YACX,QAAQ,EAAE,IAAI;SACf,EACD,EAAE,EAAE,EAAE,QAAQ,MAAM,CAAC,UAAU,EAAE,EAAE,CACpC,CAAC;QAEF,OAAO;YACL,IAAI,EAAE,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE;SACnC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAA+B;QAC5C,MAAM,IAAI,GAAG,MAAiC,CAAC;QAE/C,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CACxB,mBAAY,EACZ;YACE,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,iCAAiC;YACxC,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,EACD,EAAE,EAAE,EAAE,QAAQ,IAAI,CAAC,UAAU,EAAE,EAAE,CAClC,CAAC;QAEF,OAAO;YACL,IAAI,EAAE,6EAA6E;SACpF,CAAC;IACJ,CAAC;CACF,CAAA;AA7CY,wDAAsB;AAGP;IAAzB,IAAA,uBAAc,GAAE;8BAAgB,4BAAa;qDAAC;iCAHpC,sBAAsB;IAXlC,IAAA,mBAAU,GAAE;IACZ,IAAA,aAAI,EAAC;QACJ,QAAQ,EAAE;YACR,WAAW,EACT,uGAAuG;gBACvG,+DAA+D;gBAC/D,yEAAyE;gBACzE,2HAA2H;SAC9H;QACD,MAAM,EAAE,iCAAiC;KAC1C,CAAC;GACW,sBAAsB,CA6ClC"}

package/dist/workflows/github-agent.ui.yaml

@@ -0,0 +1,16 @@
+title: 'GitHub Agent'
+
+description: |
+  An interactive chat agent with access to GitHub.
+  Ask it to manage repositories, issues, pull requests, browse code, check CI/CD status,
+  search across GitHub, and more. Handles OAuth authentication automatically when needed —
+  the agent detects unauthorized errors and launches authentication on its own.
+
+ui:
+  widgets:
+    - widget: prompt-input
+      enabledWhen:
+        - waiting_for_user
+      options:
+        transition: userMessage
+        label: Send Message

package/dist/workflows/github-agent.workflow.d.ts

@@ -1,18 +1,13 @@
-import { ClaudeGenerateText, ClaudeMessageDocument, DelegateToolCalls, UpdateToolResult } from '@loopstack/claude-module';
-import { WorkflowInterface } from '@loopstack/common';
-import { CreateDocument, LinkDocument, Task } from '@loopstack/core';
+import { ClaudeGenerateText, ClaudeGenerateTextResult, DelegateToolCalls, DelegateToolCallsResult, UpdateToolResult } from '@loopstack/claude-module';
+import { BaseWorkflow } from '@loopstack/common';
 import { GitHubCreateIssueCommentTool, GitHubCreateIssueTool, GitHubCreateOrUpdateFileTool, GitHubCreatePullRequestTool, GitHubCreateRepoTool, GitHubGetAuthenticatedUserTool, GitHubGetCommitTool, GitHubGetFileContentTool, GitHubGetIssueTool, GitHubGetPullRequestTool, GitHubGetRepoTool, GitHubGetWorkflowRunTool, GitHubListBranchesTool, GitHubListDirectoryTool, GitHubListIssuesTool, GitHubListPrReviewsTool, GitHubListPullRequestsTool, GitHubListReposTool, GitHubListUserOrgsTool, GitHubListWorkflowRunsTool, GitHubMergePullRequestTool, GitHubSearchCodeTool, GitHubSearchIssuesTool, GitHubSearchReposTool, GitHubTriggerWorkflowTool } from '@loopstack/github-module';
 import { OAuthWorkflow } from '@loopstack/oauth-module';
 import { AuthenticateGitHubTask } from '../tools/authenticate-github-task.tool';
-export declare class GitHubAgentWorkflow implements WorkflowInterface {
-    createDocument: CreateDocument;
+export declare class GitHubAgentWorkflow extends BaseWorkflow {
     claudeGenerateText: ClaudeGenerateText;
     delegateToolCalls: DelegateToolCalls;
     updateToolResult: UpdateToolResult;
-    task: Task;
     authenticateGitHub: AuthenticateGitHubTask;
-    claudeMessageDocument: ClaudeMessageDocument;
-    linkDocument: LinkDocument;
     gitHubListRepos: GitHubListReposTool;
     gitHubGetRepo: GitHubGetRepoTool;
     gitHubCreateRepo: GitHubCreateRepoTool;
@@ -39,10 +34,16 @@ export declare class GitHubAgentWorkflow implements WorkflowInterface {
     gitHubGetAuthenticatedUser: GitHubGetAuthenticatedUserTool;
     gitHubListUserOrgs: GitHubListUserOrgsTool;
     oAuth: OAuthWorkflow;
-    state: {
-        llmResult?: any;
-        delegateResult?: any;
-    };
-    runtime: any;
+    llmResult?: ClaudeGenerateTextResult;
+    delegateResult?: DelegateToolCallsResult;
+    setup(): Promise<void>;
+    userMessage(payload: string): Promise<void>;
+    llmTurn(): Promise<void>;
+    executeToolCalls(): Promise<void>;
+    hasToolCalls(): boolean;
+    toolResultReceived(payload: Record<string, unknown>): Promise<void>;
+    allToolsCompleteTransition(): void;
+    allToolsComplete(): boolean;
+    respond(): Promise<void>;
 }
 //# sourceMappingURL=github-agent.workflow.d.ts.map

package/dist/workflows/github-agent.workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"github-agent.workflow.d.ts","sourceRoot":"","sources":["../../src/workflows/github-agent.workflow.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAOL,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,EACrB,4BAA4B,EAC5B,2BAA2B,EAC3B,oBAAoB,EACpB,8BAA8B,EAC9B,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,EACvB,0BAA0B,EAC1B,mBAAmB,EACnB,sBAAsB,EACtB,0BAA0B,EAC1B,0BAA0B,EAC1B,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,EAC1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAEhF,qBAIa,mBAAoB,YAAW,iBAAiB;IAC7C,cAAc,EAAE,cAAc,CAAC;IAC/B,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,IAAI,EAAE,IAAI,CAAC;IACX,kBAAkB,EAAE,sBAAsB,CAAC;IAEvC,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C,YAAY,EAAE,YAAY,CAAC;IAG/B,eAAe,EAAE,mBAAmB,CAAC;IACrC,aAAa,EAAE,iBAAiB,CAAC;IACjC,gBAAgB,EAAE,oBAAoB,CAAC;IACvC,kBAAkB,EAAE,sBAAsB,CAAC;IAG3C,gBAAgB,EAAE,oBAAoB,CAAC;IACvC,cAAc,EAAE,kBAAkB,CAAC;IACnC,iBAAiB,EAAE,qBAAqB,CAAC;IACzC,wBAAwB,EAAE,4BAA4B,CAAC;IAGvD,sBAAsB,EAAE,0BAA0B,CAAC;IACnD,oBAAoB,EAAE,wBAAwB,CAAC;IAC/C,uBAAuB,EAAE,2BAA2B,CAAC;IACrD,sBAAsB,EAAE,0BAA0B,CAAC;IACnD,mBAAmB,EAAE,uBAAuB,CAAC;IAG7C,oBAAoB,EAAE,wBAAwB,CAAC;IAC/C,wBAAwB,EAAE,4BAA4B,CAAC;IACvD,mBAAmB,EAAE,uBAAuB,CAAC;IAC7C,eAAe,EAAE,mBAAmB,CAAC;IAGrC,sBAAsB,EAAE,0BAA0B,CAAC;IACnD,qBAAqB,EAAE,yBAAyB,CAAC;IACjD,oBAAoB,EAAE,wBAAwB,CAAC;IAG/C,gBAAgB,EAAE,oBAAoB,CAAC;IACvC,iBAAiB,EAAE,qBAAqB,CAAC;IACzC,kBAAkB,EAAE,sBAAsB,CAAC;IAG3C,0BAA0B,EAAE,8BAA8B,CAAC;IAC3D,kBAAkB,EAAE,sBAAsB,CAAC;IAEvC,KAAK,EAAE,aAAa,CAAC;IAQvC,KAAK,EAAE;QACL,SAAS,CAAC,EAAE,GAAG,CAAC;QAChB,cAAc,CAAC,EAAE,GAAG,CAAC;KACtB,CAAC;IAGF,OAAO,EAAE,GAAG,CAAC;CACd"}
+{"version":3,"file":"github-agent.workflow.d.ts","sourceRoot":"","sources":["../../src/workflows/github-agent.workflow.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EAExB,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,YAAY,EAQb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,EACrB,4BAA4B,EAC5B,2BAA2B,EAC3B,oBAAoB,EACpB,8BAA8B,EAC9B,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,EACvB,0BAA0B,EAC1B,mBAAmB,EACnB,sBAAsB,EACtB,0BAA0B,EAC1B,0BAA0B,EAC1B,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,EAC1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAEhF,qBAGa,mBAAoB,SAAQ,YAAY;IACrC,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,kBAAkB,EAAE,sBAAsB,CAAC;IAG3C,eAAe,EAAE,mBAAmB,CAAC;IACrC,aAAa,EAAE,iBAAiB,CAAC;IACjC,gBAAgB,EAAE,oBAAoB,CAAC;IACvC,kBAAkB,EAAE,sBAAsB,CAAC;IAG3C,gBAAgB,EAAE,oBAAoB,CAAC;IACvC,cAAc,EAAE,kBAAkB,CAAC;IACnC,iBAAiB,EAAE,qBAAqB,CAAC;IACzC,wBAAwB,EAAE,4BAA4B,CAAC;IAGvD,sBAAsB,EAAE,0BAA0B,CAAC;IACnD,oBAAoB,EAAE,wBAAwB,CAAC;IAC/C,uBAAuB,EAAE,2BAA2B,CAAC;IACrD,sBAAsB,EAAE,0BAA0B,CAAC;IACnD,mBAAmB,EAAE,uBAAuB,CAAC;IAG7C,oBAAoB,EAAE,wBAAwB,CAAC;IAC/C,wBAAwB,EAAE,4BAA4B,CAAC;IACvD,mBAAmB,EAAE,uBAAuB,CAAC;IAC7C,eAAe,EAAE,mBAAmB,CAAC;IAGrC,sBAAsB,EAAE,0BAA0B,CAAC;IACnD,qBAAqB,EAAE,yBAAyB,CAAC;IACjD,oBAAoB,EAAE,wBAAwB,CAAC;IAG/C,gBAAgB,EAAE,oBAAoB,CAAC;IACvC,iBAAiB,EAAE,qBAAqB,CAAC;IACzC,kBAAkB,EAAE,sBAAsB,CAAC;IAG3C,0BAA0B,EAAE,8BAA8B,CAAC;IAC3D,kBAAkB,EAAE,sBAAsB,CAAC;IAEvC,KAAK,EAAE,aAAa,CAAC;IAEvC,SAAS,CAAC,EAAE,wBAAwB,CAAC;IACrC,cAAc,CAAC,EAAE,uBAAuB,CAAC;IAGnC,KAAK;IAYL,WAAW,CAAC,OAAO,EAAE,MAAM;IAQ3B,OAAO;IAyCP,gBAAgB;IAStB,YAAY,IAAI,OAAO;IAKjB,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAWzD,0BAA0B;IAE1B,gBAAgB,IAAI,OAAO;IAKrB,OAAO;CAGd"}