diff --git a/apis-living-system-development/developer-home.md b/apis-living-system-development/developer-home.md index 0535af1..7ffab7c 100644 --- a/apis-living-system-development/developer-home.md +++ b/apis-living-system-development/developer-home.md @@ -178,7 +178,7 @@ Some `PAYMENT_REQUIRED` errors also have a `featureId` field. It names the plan | [Bundles & App Kits](bundles.md) | Import or export full Taskade Genesis apps as portable `.tsk` bundles | | [Long-Term Memory](long-term-memory.md) | Taskade stores agent memory as projects. You can edit it, query it, and reach it with the API | | [Autonomous Agents](autonomous-agents.md) | Automations, orchestration, and patterns for one agent to call another | -| [TypeScript SDK (Preview)](sdk-quickstart.md) | Generated client for v2. It is not yet on public npm, so use the REST API | +| [TypeScript SDK (Preview)](sdk-quickstart.md) | Call the API from TypeScript with the built-in `fetch` | | [Contact support](https://www.taskade.com/contact) | Help from the Taskade team | ## What you can build diff --git a/apis-living-system-development/developers/README.md b/apis-living-system-development/developers/README.md index 8b78b0e..c4990f7 100644 --- a/apis-living-system-development/developers/README.md +++ b/apis-living-system-development/developers/README.md @@ -64,7 +64,7 @@ Each surface below reads or changes the same workspace data. Pick the row that m | **Webhooks** | Signed event delivery to your endpoint, and inbound webhook triggers. Both need Pro and above | [Webhooks](../webhooks.md) | | **Hosted Taskade MCP** | Use your workspace from an MCP client, and edit Taskade Genesis app source from your IDE. Every paid plan | [Hosted MCP](../genesis-app-mcp.md) | | **Workspace MCP** | [`@taskade/mcp-server`](https://github.com/taskade/mcp), a local MCP server for Claude, Cursor, and Claude Code | [Workspace MCP](../workspace-mcp.md) | -| **TypeScript SDK** | `@taskade/sdk`, a generated client. It is in preview and not yet on public npm | [TypeScript SDK](../sdk-quickstart.md) | +| **TypeScript SDK** | Call the API from TypeScript with the built-in `fetch`. No package to install | [TypeScript SDK](../sdk-quickstart.md) | | **Bundles** | Export a whole app as a `.tsk` bundle (Pro and above), and import one into a workspace | [Bundles](../bundles.md) | | **Automations** | A trigger starts a run, and the steps run in order. After 5 failed runs in a row, the automation turns off and the owners get an email | [Automations](https://www.taskade.com/automate) | | **Triggers and actions** | A trigger reacts to an event. An action does the work, with its own error handling and timeout for an outside service | [Action and trigger reference](https://www.taskade.com/automate) | diff --git a/apis-living-system-development/developers/api.md b/apis-living-system-development/developers/api.md index 976e074..ac73fa4 100644 --- a/apis-living-system-development/developers/api.md +++ b/apis-living-system-development/developers/api.md @@ -70,7 +70,7 @@ graph TD | **Public agent embed** | Puts a public AI agent on your site as an iframe or a chat widget | [Agent embeds](../agent-embeds.md) | | **Bundles** | Exports and imports a whole app or workspace as JSON, `.zip`, or `.tsk` | [Bundles & App Kits](../bundles.md) | | **MCP Client connector** | Lets a Taskade automation call the tools of another MCP server | [Which Taskade MCP do I want?](../mcp-overview.md) | -| **TypeScript SDK** | A generated client for the Action API v2. It is in preview and not on npm yet. | [TypeScript SDK](../sdk-quickstart.md) | +| **TypeScript SDK** | Calls the API from TypeScript with the built-in `fetch`. No package to install. | [TypeScript SDK](../sdk-quickstart.md) | Each surface has its own endpoint and access rule: @@ -84,7 +84,7 @@ Each surface has its own endpoint and access rule: | **Public agent embed** | The embed code in the publish settings of the agent | Every plan. No token: the agent must be public. | | **Bundles** | `/api/v1/bundles/…` or `/api/v2/exportBundle` | Export: Pro plan and above. Import: the plan limit for each item type. | | **MCP Client connector** | An automation step | Every plan, Free included | -| **TypeScript SDK** | `@taskade/sdk` (preview) | Not available yet. Call the API over HTTPS. | +| **TypeScript SDK** | The built-in `fetch` | No package. Call the API over HTTPS. | ## Choose your path diff --git a/apis-living-system-development/sdk-cookbook.md b/apis-living-system-development/sdk-cookbook.md index a821890..4e139d8 100644 --- a/apis-living-system-development/sdk-cookbook.md +++ b/apis-living-system-development/sdk-cookbook.md @@ -89,7 +89,7 @@ The response lists the workspaces that this caller can see: Declare the shapes that you read. Then the compiler finds a wrong field. -The future generated client will export `TaskadePublicApi` plus request and response types. Until then, declare your own: +Declare a type for each response that you read: ```typescript type Project = { id: string; name?: string }; diff --git a/apis-living-system-development/sdk-quickstart.md b/apis-living-system-development/sdk-quickstart.md index e093492..1d36239 100644 --- a/apis-living-system-development/sdk-quickstart.md +++ b/apis-living-system-development/sdk-quickstart.md @@ -5,7 +5,7 @@ description: >- # TypeScript SDK -Call the Taskade API from TypeScript today with the built-in `fetch`. The `@taskade/sdk` client is a preview and is not on npm yet. Thus this page shows the calls without it. +Call the Taskade API from TypeScript with the built-in `fetch`. You do not need to install a package. {% hint style="warning" %} **Important:** `@taskade/sdk` is not published on the public npm registry. `npm install @taskade/sdk` returns `404 Not Found` today. Use `fetch`, as the examples on this page do. @@ -205,33 +205,6 @@ The two calls return the same JSON as the cURL tab: an `items` array, then an ob {% endtabs %} -## What the SDK will look like - -`@taskade/sdk` is a **generated client** for the [Action API v2](api-v2-reference.md). Do not install it yet. The code below shows the planned shape only. - -When Taskade releases the SDK, it will provide `HttpClient` and `TaskadePublicApi`. Its methods map directly to v2 operations: - -```typescript -import { HttpClient, TaskadePublicApi } from "@taskade/sdk"; - -const http = new HttpClient({ - baseUrl: "https://www.taskade.com/api/v2", - securityWorker: () => ({ - headers: { Authorization: `Bearer ${process.env.TASKADE_TOKEN}` }, - }), -}); -const taskade = new TaskadePublicApi(http); - -const { data } = await taskade.promptAgent({ spaceId, agentId, prompt: "Hi" }); -// data is the response body: { ok: true, summary: "..." } -``` - -{% hint style="info" %} -**Note:** Method names match the v2 operations: `listSpaces`, `createProject`, `promptAgent`, `exportBundle`, and more. The preview client does not cover every v2 operation. For example, it has no task-write or webhook-registration methods. -{% endhint %} - -For an operation that the preview does not cover, call it over HTTPS with the wrapper above. See the [Action API v2 reference](api-v2-reference.md) for the full list and the request shapes. - ## Fix common errors Match what you see to a fix. @@ -247,7 +220,7 @@ Match what you see to a fix. ## Next steps - [REST API v1 guide](comprehensive-api-guide/README.md): full task create, update, and complete calls. -- [Action API v2 guide](api-v2-reference.md): every operation that the SDK will wrap. +- [Action API v2 guide](api-v2-reference.md): every v2 operation and its request shape. - [Authentication](developers/authentication.md): personal access tokens and OAuth 2.0. - [SDK Cookbook](sdk-cookbook.md): retries, pagination, webhooks, and tests. - [Workspace MCP](workspace-mcp.md): connect AI tools to your workspace. diff --git a/help-and-support/index/07_api.md b/help-and-support/index/07_api.md index 19a6f84..1d1bd17 100644 --- a/help-and-support/index/07_api.md +++ b/help-and-support/index/07_api.md @@ -513,7 +513,7 @@ data = res.json() The official TypeScript SDK (`@taskade/sdk`) is in preview and **not yet published to the public npm registry**. Until it ships, use the REST API directly as shown above. {% endhint %} -* [**TypeScript SDK (Preview)**](../../apis-living-system-development/sdk-quickstart.md) — generated client for API v2; the quickstart shows the HTTP-first path you can use today +* [**TypeScript SDK (Preview)**](../../apis-living-system-development/sdk-quickstart.md) — call the API from TypeScript with the built-in `fetch` * [**Workspace MCP Server**](https://github.com/taskade/mcp) — `@taskade/mcp-server` on npm; connect Claude Desktop, Cursor, and any MCP client to your workspace * [**Integration Kit**](https://github.com/taskade/integrations) — open-source Zapier and n8n actions & triggers built on this public API diff --git a/llms.txt b/llms.txt index 87f5829..b73076e 100644 --- a/llms.txt +++ b/llms.txt @@ -108,7 +108,7 @@ Developers can build on the REST API v1, the action-based Public API v2, webhook - [Personal Tokens](https://docs.taskade.com/developers/authentication/personal-tokens): Generate a Personal Access Token and authenticate with the Authorization Bearer header. - [REST API v1 Reference](https://docs.taskade.com/developers/comprehensive-api-guide): Manage workspaces, projects, tasks, agents, folders, and media with full CRUD and code examples. - [Action API v2 Reference](https://docs.taskade.com/developers/api-v2-reference): The action-based (RPC-over-HTTP) Public API v2 — every call is a POST to a named operation. -- [TypeScript SDK (Preview)](https://docs.taskade.com/developers/sdk-quickstart): Call the API today with plain HTTP, and what the generated client will look like. +- [TypeScript SDK (Preview)](https://docs.taskade.com/developers/sdk-quickstart): Call the API from TypeScript with plain HTTP and the built-in `fetch`. - [SDK Cookbook](https://docs.taskade.com/developers/sdk-quickstart/sdk-cookbook): Integration patterns — agents, automations, projects, bundles, error handling, pagination, testing. - [Webhooks](https://docs.taskade.com/developers/webhooks): Inbound webhooks to trigger automations and signed outbound webhooks over the Public API v2. - [Bundles & App Kits](https://docs.taskade.com/developers/bundles): Export and import complete Genesis apps and workspaces as portable bundles via the Action API v2. diff --git a/updates-and-timeline/changelog-2026/july-2026/july-16-2026.md b/updates-and-timeline/changelog-2026/july-2026/july-16-2026.md index 57d1635..00676ea 100644 --- a/updates-and-timeline/changelog-2026/july-2026/july-16-2026.md +++ b/updates-and-timeline/changelog-2026/july-2026/july-16-2026.md @@ -29,3 +29,5 @@ All four take a `spaceId` (get it from `list_spaces`) and require workspace memb ### Free Plan: Full-Depth First Builds Auto now gives Free-plan workspaces a serious first build: your first Genesis app build runs at full **Reasoning** depth, and follow-up edit turns run at **Thinking** depth — the same capability tiers paid plans use. Welcome credits (1,000 when you verify your account, plus 5,000 when you start your first app build) are sized to cover one complete build. See [TSK-1 Model Tiers](../../../genesis-living-system-builder/ai-features/tsk-1-model-tiers.md). + +**Update:** This welcome credit offer ended. The Free plan now starts with 0 AI credits. See [Taskade pricing](https://www.taskade.com/pricing). diff --git a/updates-and-timeline/changelog-2026/march-2026/README.md b/updates-and-timeline/changelog-2026/march-2026/README.md index 38489f0..91455ef 100644 --- a/updates-and-timeline/changelog-2026/march-2026/README.md +++ b/updates-and-timeline/changelog-2026/march-2026/README.md @@ -16,7 +16,7 @@ coverY: 0 ## Releases this month * [March 31, 2026](march-31-2026.md) — New v8 Max and Enterprise plans -* [March 28, 2026](march-28-2026.md) — @taskade/embed Migrated into Monorepo with Security Hardening +* [March 28, 2026](march-28-2026.md) — Agent Chat Embed Widget Security Hardening * [March 26, 2026](march-26-2026.md) — Appkit Template UI Refresh * [March 22, 2026](march-22-2026.md) — MCP SDK Upgraded to ^1.27.1 / mcp-proxy ^6.4.4 * [March 19, 2026](march-19-2026.md) — New Pieces for Automations diff --git a/updates-and-timeline/changelog-2026/march-2026/march-28-2026.md b/updates-and-timeline/changelog-2026/march-2026/march-28-2026.md index de9359a..1f2ae60 100644 --- a/updates-and-timeline/changelog-2026/march-2026/march-28-2026.md +++ b/updates-and-timeline/changelog-2026/march-2026/march-28-2026.md @@ -11,16 +11,14 @@ description: >- ## What's New: -### @taskade/embed Migrated into Monorepo with Security Hardening +### Agent Chat Embed Widget Security Hardening -The `@taskade/embed` package — the floating-popup AI agent chat widget for embedding Taskade agents on external websites — is now versioned and released alongside the rest of the Taskade platform. Version 1.1.1 is published. Key security improvements shipped alongside the migration: +The floating-popup AI agent chat widget for embedding Taskade agents on external websites received these security improvements: - **`sandbox` attribute added to the embed iframe** — the agent chat iframe now carries `sandbox="allow-scripts allow-same-origin allow-forms allow-popups"`, restricting what the embedded frame can do on the host page. Host page developers who embed agents via the widget should review these sandbox permissions if they rely on cross-frame interaction. - **`title` attribute set on the embed iframe** — improves accessibility for screen readers on host pages. - Shadow DOM style isolation and React 18 compatibility improvements were also included. -The embed package is published to the GitHub npm registry with automated build and release workflows. - Reference: [API Guide](../../../apis-living-system-development/comprehensive-api-guide/README.md) ***