@loopstack/github-oauth-example 0.1.1 → 0.2.1

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

@@ -1,154 +0,0 @@
-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:
-  actions:
-    - type: custom
-      widget: prompt-input
-      enabledWhen:
-        - waiting_for_user
-      options:
-        transition: user_message
-        label: Send Message
-
-transitions:
-  - id: setup
-    from: start
-    to: waiting_for_user
-    call:
-      - tool: createDocument
-        args:
-          document: claudeMessageDocument
-          update:
-            meta:
-              hidden: true
-            content:
-              role: user
-              content: |
-                You are a helpful GitHub assistant. You have access to the user's
-                GitHub account through the tools provided to you.
-
-                You can help with:
-                - **Repositories**: List repos, get repo details, create repos, list branches
-                - **Issues**: List issues, get issue details, create issues, comment on issues
-                - **Pull Requests**: List PRs, get PR details, create PRs, merge PRs, list reviews
-                - **Code & Content**: Read files, create/update files, browse directories, view commits
-                - **Actions (CI/CD)**: List workflow runs, trigger workflows, check run status
-                - **Search**: Search code, repositories, and issues across GitHub
-                - **Users & Orgs**: Get user profile, list organizations
-
-                When a tool returns `{ error: "unauthorized" }` or `{ error: "401" }`, call the
-                `authenticateGitHub` tool with the required OAuth scopes to let the user sign in.
-                After authentication completes, retry the original request.
-
-                Common scopes: repo, user, workflow, read:org
-
-                IMPORTANT: When using authenticateGitHub, it must be the ONLY tool call in your response.
-
-                Be concise and helpful. Format results clearly using markdown.
-                When showing repository or issue information, include links where available.
-
-  - id: user_message
-    from: waiting_for_user
-    to: ready
-    trigger: manual
-    call:
-      - tool: createDocument
-        args:
-          document: claudeMessageDocument
-          update:
-            content:
-              role: user
-              content: ${{ runtime.transition.payload }}
-
-  - id: llm_turn
-    from: ready
-    to: prompt_executed
-    call:
-      - id: llm_call
-        tool: claudeGenerateText
-        args:
-          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
-        assign:
-          llmResult: ${{ result.data }}
-
-  - id: execute_tool_calls
-    from: prompt_executed
-    to: awaiting_tools
-    if: ${{ state.llmResult.stop_reason == 'tool_use' }}
-    call:
-      - tool: delegateToolCalls
-        args:
-          message: ${{ state.llmResult }}
-          document: claudeMessageDocument
-          callback:
-            transition: tool_result_received
-        assign:
-          delegateResult: ${{ result.data }}
-
-  - id: tool_result_received
-    from: awaiting_tools
-    to: awaiting_tools
-    trigger: manual
-    call:
-      - tool: updateToolResult
-        args:
-          delegateResult: ${{ state.delegateResult }}
-          completedTool: ${{ runtime.transition.payload }}
-          document: claudeMessageDocument
-        assign:
-          delegateResult: ${{ result.data }}
-
-  - id: all_tools_complete
-    from: awaiting_tools
-    to: ready
-    if: ${{ state.delegateResult.allCompleted }}
-
-  - id: respond
-    from: prompt_executed
-    to: waiting_for_user
-    call:
-      - tool: createDocument
-        args:
-          id: ${{ state.llmResult.id }}
-          document: claudeMessageDocument
-          update:
-            content: ${{ state.llmResult }}

package/dist/workflows/github-repos-overview.workflow.yaml

@@ -1,249 +0,0 @@
-title: 'GitHub Repository Overview'
-
-description: |
-  Comprehensive GitHub example that exercises every GitHub tool.
-  Fetches user info, repository details, issues, pull requests, branches,
-  directory contents, workflow runs, and search results for a given repository.
-  If not authenticated, launches the OAuth sub-workflow and retries.
-
-ui:
-  form:
-    properties:
-      owner:
-        title: 'Repository Owner'
-        placeholder: 'octocat'
-      repo:
-        title: 'Repository Name'
-        placeholder: 'Hello-World'
-
-transitions:
-  # Step 1: Fetch authenticated user and orgs
-  - id: fetch_user
-    from: start
-    to: user_fetched
-    call:
-      - tool: gitHubGetAuthenticatedUser
-        id: user_fetch
-        args: {}
-        assign:
-          requiresAuthentication: ${{ result.data.error == "unauthorized" }}
-          user: ${{ result.data.user }}
-
-  # If unauthorized -> launch OAuth
-  - id: auth_required
-    from: user_fetched
-    to: awaiting_auth
-    if: ${{ state.requiresAuthentication }}
-    call:
-      - tool: task
-        id: launchAuth
-        args:
-          workflow: oAuth
-          args:
-            provider: 'github'
-            scopes:
-              - 'repo'
-              - 'read:org'
-              - 'workflow'
-          callback:
-            transition: auth_completed
-
-      - tool: createDocument
-        args:
-          id: authStatus
-          document: linkDocument
-          update:
-            content:
-              icon: 'LockKeyhole'
-              label: 'GitHub authentication required'
-              caption: 'Complete sign-in to continue'
-              href: '/pipelines/{{ runtime.tools.auth_required.launchAuth.data.pipelineId }}'
-              embed: true
-              expanded: true
-
-  # Auth completed -> retry from start
-  - id: auth_completed
-    from: awaiting_auth
-    to: start
-    trigger: manual
-    call:
-      - tool: createDocument
-        args:
-          id: authStatus
-          document: linkDocument
-          update:
-            content:
-              icon: 'ShieldCheck'
-              type: 'success'
-              label: 'GitHub authentication completed'
-              caption: 'You are now authenticated with GitHub.'
-              href: '/pipelines/{{ runtime.transition.payload.pipelineId }}'
-
-  # Step 2: Fetch user orgs
-  - id: fetch_orgs
-    from: user_fetched
-    to: orgs_fetched
-    call:
-      - tool: gitHubListUserOrgs
-        id: orgs_fetch
-        args:
-          perPage: 10
-        assign:
-          orgs: ${{ result.data.orgs }}
-
-  # Step 3: Fetch repo details and branches
-  - id: fetch_repo_details
-    from: orgs_fetched
-    to: repo_fetched
-    call:
-      - tool: gitHubGetRepo
-        id: repo_fetch
-        args:
-          owner: ${{ args.owner }}
-          repo: ${{ args.repo }}
-        assign:
-          repo: ${{ result.data.repo }}
-
-      - tool: gitHubListBranches
-        id: branches_fetch
-        args:
-          owner: ${{ args.owner }}
-          repo: ${{ args.repo }}
-        assign:
-          branches: ${{ result.data.branches }}
-
-  # Step 4: Fetch issues and PRs
-  - id: fetch_issues_prs
-    from: repo_fetched
-    to: issues_prs_fetched
-    call:
-      - tool: gitHubListIssues
-        id: issues_fetch
-        args:
-          owner: ${{ args.owner }}
-          repo: ${{ args.repo }}
-          state: 'open'
-          perPage: 10
-        assign:
-          issues: ${{ result.data.issues }}
-
-      - tool: gitHubListPullRequests
-        id: prs_fetch
-        args:
-          owner: ${{ args.owner }}
-          repo: ${{ args.repo }}
-          state: 'open'
-          perPage: 10
-        assign:
-          pullRequests: ${{ result.data.pullRequests }}
-
-  # Step 5: Fetch directory listing and workflow runs
-  - id: fetch_content_actions
-    from: issues_prs_fetched
-    to: content_actions_fetched
-    call:
-      - tool: gitHubListDirectory
-        id: dir_fetch
-        args:
-          owner: ${{ args.owner }}
-          repo: ${{ args.repo }}
-        assign:
-          directoryEntries: ${{ result.data.entries }}
-
-      - tool: gitHubListWorkflowRuns
-        id: runs_fetch
-        args:
-          owner: ${{ args.owner }}
-          repo: ${{ args.repo }}
-          perPage: 5
-        assign:
-          workflowRuns: ${{ result.data.runs }}
-
-  # Step 6: Search code in the repo
-  - id: fetch_search
-    from: content_actions_fetched
-    to: search_done
-    call:
-      - tool: gitHubSearchCode
-        id: code_search
-        args:
-          query: ${{ searchQuery() }}
-          perPage: 5
-        assign:
-          searchResults: ${{ result.data.results }}
-
-  # Display all results
-  - id: display_results
-    from: search_done
-    to: end
-    call:
-      - tool: createDocument
-        args:
-          document: markdown
-          update:
-            content:
-              markdown: |
-                ## Authenticated User
-                **{{ state.user.login }}** {{#if state.user.name}}({{ state.user.name }}){{/if}} — {{ state.user.publicRepos }} public repos
-
-                {{#if state.orgs}}
-                ### Organizations
-                {{#each state.orgs}}
-                - **{{ this.login }}** {{#if this.description}}— {{ this.description }}{{/if}}
-                {{/each}}
-                {{/if}}
-
-                ---
-
-                ## Repository: [{{ state.repo.fullName }}]({{ state.repo.htmlUrl }})
-                {{ state.repo.description }}
-
-                | Language | Stars | Forks | Open Issues | Default Branch |
-                |---|---|---|---|---|
-                | {{ state.repo.language }} | {{ state.repo.stars }} | {{ state.repo.forks }} | {{ state.repo.openIssues }} | {{ state.repo.defaultBranch }} |
-
-                ### Branches
-                {{#each state.branches}}
-                - `{{ this.name }}` {{#if this.protected}}(protected){{/if}}
-                {{/each}}
-
-                ---
-
-                ### Open Issues
-                {{#each state.issues}}
-                - [#{{ this.number }}]({{ this.htmlUrl }}) {{ this.title }} — @{{ this.user }}
-                {{/each}}
-                {{#unless state.issues}}
-                No open issues.
-                {{/unless}}
-
-                ### Open Pull Requests
-                {{#each state.pullRequests}}
-                - [#{{ this.number }}]({{ this.htmlUrl }}) {{ this.title }} — @{{ this.user }} {{#if this.draft}}(draft){{/if}}
-                {{/each}}
-                {{#unless state.pullRequests}}
-                No open pull requests.
-                {{/unless}}
-
-                ---
-
-                ### Root Directory
-                {{#each state.directoryEntries}}
-                - {{ this.type }} `{{ this.name }}`
-                {{/each}}
-
-                ### Recent Workflow Runs
-                {{#each state.workflowRuns}}
-                - [{{ this.name }}]({{ this.htmlUrl }}) — {{ this.status }} {{#if this.conclusion}}({{ this.conclusion }}){{/if}}
-                {{/each}}
-                {{#unless state.workflowRuns}}
-                No workflow runs found.
-                {{/unless}}
-
-                ### Code Search Results
-                {{#each state.searchResults}}
-                - `{{ this.path }}` in {{ this.repository }}
-                {{/each}}
-                {{#unless state.searchResults}}
-                No code search results.
-                {{/unless}}

package/src/workflows/github-agent.workflow.yaml

@@ -1,154 +0,0 @@
-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:
-  actions:
-    - type: custom
-      widget: prompt-input
-      enabledWhen:
-        - waiting_for_user
-      options:
-        transition: user_message
-        label: Send Message
-
-transitions:
-  - id: setup
-    from: start
-    to: waiting_for_user
-    call:
-      - tool: createDocument
-        args:
-          document: claudeMessageDocument
-          update:
-            meta:
-              hidden: true
-            content:
-              role: user
-              content: |
-                You are a helpful GitHub assistant. You have access to the user's
-                GitHub account through the tools provided to you.
-
-                You can help with:
-                - **Repositories**: List repos, get repo details, create repos, list branches
-                - **Issues**: List issues, get issue details, create issues, comment on issues
-                - **Pull Requests**: List PRs, get PR details, create PRs, merge PRs, list reviews
-                - **Code & Content**: Read files, create/update files, browse directories, view commits
-                - **Actions (CI/CD)**: List workflow runs, trigger workflows, check run status
-                - **Search**: Search code, repositories, and issues across GitHub
-                - **Users & Orgs**: Get user profile, list organizations
-
-                When a tool returns `{ error: "unauthorized" }` or `{ error: "401" }`, call the
-                `authenticateGitHub` tool with the required OAuth scopes to let the user sign in.
-                After authentication completes, retry the original request.
-
-                Common scopes: repo, user, workflow, read:org
-
-                IMPORTANT: When using authenticateGitHub, it must be the ONLY tool call in your response.
-
-                Be concise and helpful. Format results clearly using markdown.
-                When showing repository or issue information, include links where available.
-
-  - id: user_message
-    from: waiting_for_user
-    to: ready
-    trigger: manual
-    call:
-      - tool: createDocument
-        args:
-          document: claudeMessageDocument
-          update:
-            content:
-              role: user
-              content: ${{ runtime.transition.payload }}
-
-  - id: llm_turn
-    from: ready
-    to: prompt_executed
-    call:
-      - id: llm_call
-        tool: claudeGenerateText
-        args:
-          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
-        assign:
-          llmResult: ${{ result.data }}
-
-  - id: execute_tool_calls
-    from: prompt_executed
-    to: awaiting_tools
-    if: ${{ state.llmResult.stop_reason == 'tool_use' }}
-    call:
-      - tool: delegateToolCalls
-        args:
-          message: ${{ state.llmResult }}
-          document: claudeMessageDocument
-          callback:
-            transition: tool_result_received
-        assign:
-          delegateResult: ${{ result.data }}
-
-  - id: tool_result_received
-    from: awaiting_tools
-    to: awaiting_tools
-    trigger: manual
-    call:
-      - tool: updateToolResult
-        args:
-          delegateResult: ${{ state.delegateResult }}
-          completedTool: ${{ runtime.transition.payload }}
-          document: claudeMessageDocument
-        assign:
-          delegateResult: ${{ result.data }}
-
-  - id: all_tools_complete
-    from: awaiting_tools
-    to: ready
-    if: ${{ state.delegateResult.allCompleted }}
-
-  - id: respond
-    from: prompt_executed
-    to: waiting_for_user
-    call:
-      - tool: createDocument
-        args:
-          id: ${{ state.llmResult.id }}
-          document: claudeMessageDocument
-          update:
-            content: ${{ state.llmResult }}