Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions .agents/skills/build-channels-agent/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,13 +3,13 @@ name: build-channels-agent
description: >-
Use for this hackathon's Slack template in apps/channel-slack: CopilotKit
Channels setup, thread context, tools, and native cards. Read before editing
that app. This skill does not apply to the independent OpenAI Agents SDK +
Auth0 WhatsApp template or to the CopilotKit React web template.
that app. This skill does not apply to the CopilotKit React web template
or the React Native mobile app.
---

# Build the Slack template with Channels

**Hackathon scope:** apply this skill to `templates/slack.md` and `apps/channel-slack/`. Other adapters below are SDK reference material, not instructions to migrate the WhatsApp template. Preserve the repository's pinned Channels/runtime pair instead of installing the older illustrative versions below.
**Hackathon scope:** apply this skill to `templates/slack.md` and `apps/channel-slack/`. Other adapters below are SDK reference material. Preserve the repository's pinned Channels/runtime pair instead of installing the older illustrative versions below.

The Channels SDK (`@copilotkit/channels`) is a **platform-agnostic engine** for
agents that live in chat. You write the logic once — handlers, tools, and
Expand Down
2 changes: 0 additions & 2 deletions .env.example
Original file line number Diff line number Diff line change
Expand Up @@ -83,5 +83,3 @@ EXA_SEARCH_TYPE=fast
# Use your demo workspace Connect instructions: https://www.ambiguous.ai/auth.md
# Full sponsor setup and first calls: using-sponsor-tools.md
# AMBIGUOUS_API_KEY=

# WhatsApp uses apps/whatsapp/.env; see templates/whatsapp.md.
13 changes: 0 additions & 13 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -32,16 +32,3 @@ jobs:
cache-dependency-path: examples/auth0/package-lock.json
- run: npm ci --prefix examples/auth0
- run: npm test --prefix examples/auth0

whatsapp-template:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 22
cache: npm
cache-dependency-path: apps/whatsapp/package-lock.json
- run: npm ci --prefix apps/whatsapp
- run: npm run typecheck --prefix apps/whatsapp
- run: npm test --prefix apps/whatsapp
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Read [hackathon-overview.md](hackathon-overview.md), [hackathon-rules.md](hackathon-rules.md), and [using-sponsor-tools.md](using-sponsor-tools.md), then the chosen guide in `templates/`. Build the team's own workflow; the incident app is infrastructure reference code.

CopilotKit powers the Slack and web templates. `apps/whatsapp` is an independent OpenAI Agents SDK + Auth0 app with a separate install and environment; do not add Channels to it. Run its own typecheck/tests when changing it.
CopilotKit powers the Slack and web templates. The mobile starting point in `apps/mobile` has its own install and environment; follow its README for setup and checks.

Read `.agents/skills/build-channels-agent/SKILL.md` before touching anything in
`apps/channel-slack/`. It carries the verified API surface; the most common
Expand Down
2 changes: 1 addition & 1 deletion CREDITS.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ Creating an API key does not redeem credits. Do not substitute ChatGPT credits f
| CopilotKit | [Docs](https://docs.copilotkit.ai/) · [Intelligence](https://intelligence.copilotkit.ai/) · [Channels guide](https://copilotkit.ai/channels-guide.md) | Check organizer instructions for any event-specific allocation. Web setup does not require a managed Channel. |
| OpenRouter | [Keys](https://openrouter.ai/keys) · [Model catalog](https://openrouter.ai/models) | Obtain an organizer offer if available, then verify account balance and model access. |
| Exa | [API keys](https://dashboard.exa.ai/api-keys) · [Quickstart](https://exa.ai/docs/reference/search-api-guide) | Check the organizer's offer and confirm search access. |
| Auth0 | [Signup](https://auth0.com/signup) · [Phone approval quickstart](https://auth0.com/ai/docs/get-started/asynchronous-authorization) | Check CIBA availability and Guardian setup with Auth0 before the phone demo. |
| Auth0 | [Signup](https://auth0.com/signup) · [Node API quickstart](https://auth0.com/docs/quickstart/backend/nodejs) | Check organizer instructions for access; use the standalone protected-API example to verify authorization. |
| Ambiguous AI | [Workspace](https://app.ambiguous.ai/) · [Authentication](https://www.ambiguous.ai/auth.md) | Follow the organizer's workspace/access instructions if supplied. |

Keep private redemption codes, API keys, and personal claim links out of this public file. [using-sponsor-tools.md](using-sponsor-tools.md) has authentication, configuration, and a first call for each sponsor.
16 changes: 3 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ Your project and its core functionality must be created during the event. Existi

## Templates

Three starting points for different kinds of context. **CopilotKit Channels** brings the Slack agent into the conversation; **CopilotKit React** connects the web agent to the app people are using.
These starting points serve different kinds of context. **CopilotKit Channels** brings the Slack agent into the conversation; **CopilotKit React** connects the web agent to the app people are using.

### 1. Slack — an agent that joins the thread

Expand All @@ -63,16 +63,6 @@ The included web app supplies page context, frontend tools, and agent-rendered U

**[Use the web template →](templates/web.md)** · [CopilotKit docs](https://docs.copilotkit.ai/) · [Ambiguous AI setup](using-sponsor-tools.md#ambiguous-ai)

### 3. WhatsApp — an agent you can text

**OpenAI Agents SDK + Auth0**

An agent recognizes a linked user and requests approval on their phone before executing a protected action. The included app saves an approved, named request and returns a receipt in the conversation. Adapt that action to your own assistant.

This is an independent app with its own install and configuration. It uses OpenAI Agents SDK directly, Auth0 for identity and approval, and a WhatsApp transport. No CopilotKit account is required for this template.

**[Use the WhatsApp template →](templates/whatsapp.md)**

### The demo you can build on

The supplied on-call assistant is an **infrastructure example**: read ambient context, call a tool, render useful UI, and return a verifiable result. **Branch out from the example app.** Choose a different user, problem, dataset, and interaction; the goal is your own project, not another version of the incident demo.
Expand Down Expand Up @@ -106,9 +96,9 @@ The [template guides](templates/) provide launch commands, files to customize, a
| CopilotKit app development | [Docs](https://docs.copilotkit.ai/) · [Tools and context](dev-docs/tools-and-context.md) |
| CopilotKit Channels | [Channels guide](https://copilotkit.ai/channels-guide.md) · [Screenshot walkthrough](dev-docs/channels-sdk-walkthrough/README.md) · [OpenTag example app](https://github.com/CopilotKit/OpenTag) |
| Exa quickstart | [Search API guide](https://exa.ai/docs/reference/search-api-guide) · [Kit setup](using-sponsor-tools.md#exa) |
| Auth0 quickstarts | [Node API](https://auth0.com/docs/quickstart/backend/nodejs) · [Asynchronous authorization](https://auth0.com/ai/docs/get-started/asynchronous-authorization) · [Kit setup](using-sponsor-tools.md#auth0) |
| Auth0 API authorization | [Node API](https://auth0.com/docs/quickstart/backend/nodejs) · [Kit setup](using-sponsor-tools.md#auth0) |
| Ambiguous AI quickstart | [Developer guide](https://www.ambiguous.ai/llms.txt) · [Kit setup](using-sponsor-tools.md#ambiguous-ai) |
| Rehearse and debug | [Demo prompts](dev-docs/demo-prompts.md) · [Troubleshooting](dev-docs/troubleshooting.md) |
| Prepare your entry | [Submission checklist](SUBMISSION.md) |

For the Slack/web workspaces, `npm run verify` runs typechecks, tests, and MCP checks without credentials. `npm run check-env` validates configured startup. WhatsApp has separate checks in its template. Live sponsor calls and platform delivery require your accounts. See [developer docs](dev-docs/README.md) for detailed setup and deployment.
For the Slack/web workspaces, `npm run verify` runs typechecks, tests, and MCP checks without credentials. `npm run check-env` validates configured startup. Live sponsor calls and platform delivery require your accounts. See [developer docs](dev-docs/README.md) for detailed setup and deployment.
17 changes: 0 additions & 17 deletions apps/whatsapp/.env.example

This file was deleted.

4 changes: 0 additions & 4 deletions apps/whatsapp/.gitignore

This file was deleted.

56 changes: 0 additions & 56 deletions apps/whatsapp/README.md

This file was deleted.

Loading
Loading