@loopstack/github-oauth-example 0.1.1

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

@@ -0,0 +1,249 @@
+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/index.ts

@@ -0,0 +1,2 @@
+export * from './github-agent.workflow';
+export * from './github-repos-overview.workflow';