diff --git a/content/docs/en/cli/overview.mdx b/content/docs/en/cli/overview.mdx index 81b7683..6e699ac 100644 --- a/content/docs/en/cli/overview.mdx +++ b/content/docs/en/cli/overview.mdx @@ -39,7 +39,7 @@ printf '%s' "$MOSOO_API_TOKEN" | \ ```bash mosoo --help mosoo commands --json -mosoo commands show console apps deploy-app +mosoo commands show console environments create-environment mosoo search "create environment" ``` @@ -60,12 +60,6 @@ mosoo run \ # Create an Environment from the project context or explicit flags mosoo console environments create-environment - -# Deploy a public GitHub repository -mosoo console apps deploy-app \ - --input-app-id \ - --input-repo-url https://github.com/owner/repository \ - --wait ``` Use `--target local|cloud|custom`, `--base-url`, or `--hostname` to control endpoint resolution. Output formats are `table`, `json`, `yaml`, and `raw`. diff --git a/content/docs/en/concepts.mdx b/content/docs/en/concepts.mdx index a2e42ab..62d3481 100644 --- a/content/docs/en/concepts.mdx +++ b/content/docs/en/concepts.mdx @@ -7,7 +7,7 @@ mosoo is an open-source agent runtime for coding agents. It runs Claude Agent SD ## Apps are isolation boundaries -An App keeps its Agents, files, configuration resources, deployment, and usage separate. Switching Apps changes the resources visible in the console. The current Alpha is single-owner: organization team roles, invitations, and ownership transfer are not available. +An App keeps its Agents, files, configuration resources, and usage separate. Switching Apps changes the resources visible in the console. The current Alpha is single-owner: organization team roles, invitations, and ownership transfer are not available. ## Agent types control continuity diff --git a/content/docs/en/deploy-app.mdx b/content/docs/en/deploy-app.mdx deleted file mode 100644 index 5568c30..0000000 --- a/content/docs/en/deploy-app.mdx +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: "Deploy an App" -description: "Publish a supported public GitHub repository from mosoo." ---- - -App Deployment is a secondary Alpha surface for publishing one supported public repository to a mosoo-managed URL alongside your Agents. - -## Deploy from Overview - -1. Open the App **Overview**. -2. Enter a public GitHub repository URL. -3. Select **Deploy**. -4. Follow the deployment as **Deploying**, **Successful**, or **Failed**. -5. After success, open the live site or inspect earlier attempts. - -mosoo pulls the default branch HEAD and auto-detects a supported static or request-handling web App. A `.mosoo.toml` file can override supported detection settings. - -## Deploy with the CLI - -```bash -mosoo console apps deploy-app \ - --input-app-id \ - --input-repo-url https://github.com/owner/repository \ - --wait -``` - -## Operate the deployment - -From Overview, you can publish the latest default branch again, change the source repository, or delete the deployment. A failed later attempt does not hide the last successful URL. Deleting a deployment removes its hosted site and bound Agent access, but never changes the GitHub repository. - - - App Deployment currently supports a public repository and one deployed site per App. It does not provide private repositories, custom domains, branch previews, automatic deployment, rollback, App-user authentication, schedules, or durable backend state. - diff --git a/content/docs/en/deploy-mosoo.mdx b/content/docs/en/deploy-mosoo.mdx index 488294a..3c083b6 100644 --- a/content/docs/en/deploy-mosoo.mdx +++ b/content/docs/en/deploy-mosoo.mdx @@ -3,7 +3,7 @@ title: "Deploy mosoo on Cloudflare" description: "Deploy mosoo with Cloudflare Workers from GitHub Actions or a local Wrangler toolchain." --- -mosoo runs as two Cloudflare Workers: an API Worker backed by D1, R2, Queues, Durable Objects, and Containers, plus a Web Worker that serves the console and binds to the API service. It is not a standalone Cloudflare Pages site. +mosoo runs as two Cloudflare Workers: an API Worker backed by D1, R2, Queues, Durable Objects, and Containers, plus a Web Worker that serves the console and binds to the API service. This guide covers the two deployment paths used by the reference deployment: @@ -15,17 +15,17 @@ Both paths use `apps/api/wrangler.toml`, `apps/web/wrangler.toml`, and the repos ## Prerequisites - A Cloudflare account with Workers, D1, R2, Queues, Durable Objects, and Containers available. -- A domain in Cloudflare DNS, such as `console.example.com`, plus a deployment subdomain such as `apps.example.com` if you enable App Deployment. +- A domain in Cloudflare DNS, such as `console.example.com`. - Git, Docker, [Bun](https://bun.sh/), [just](https://just.systems/), and the repository submodules. - A Cloudflare API token with the account and zone permissions required to deploy the resources above. Keep tokens and secret values outside Git. Use the least privilege that covers the operations below. | Scope | Required operations | | --- | --- | -| Account | Workers scripts, versions, deployments, custom domains, and Containers; D1 migrations; R2; Queues; and, when App Deployment is enabled, Pages projects and domains | -| Zone selected by `CLOUDFLARE_ZONE_ID` | Workers Routes changes for the App Deployment domain | -| R2 S3 credentials | Read and write the sandbox-state bucket used by deployed apps | +| Account | Workers scripts, versions, deployments, custom domains, and Containers; D1 migrations; R2; Queues | +| Zone that owns the console domain | Workers Routes changes for the `/api/*` API route | +| R2 S3 credentials | Read and write the sandbox-state bucket used for Agent runtime backups | -`CLOUDFLARE_ZONE_ID` must identify the zone that owns `MOSOO_APP_DEPLOYMENT_DOMAIN`. Cloudflare's token labels can change; verify that the token permits these exact API operations rather than granting account-wide administrator access. +Cloudflare's token labels can change; verify that the token permits these exact API operations rather than granting account-wide administrator access. Clone your fork and install the pinned dependencies: @@ -80,7 +80,6 @@ Edit the `[env.prod]` sections in both Wrangler files. At minimum: 1. In `apps/api/wrangler.toml`: - set `WEB_ORIGIN` to the public HTTPS console URL; - - set `MOSOO_APP_DEPLOYMENT_DOMAIN` to the deployment domain; - set the API route to `/api/*` and its `zone_name`; - set the D1 `database_id` returned by `wrangler d1 create`; - update D1, R2, and Queue names if you did not use the defaults; @@ -94,7 +93,6 @@ For example, the routing shape is: ```text https://console.example.com/* -> Web Worker https://console.example.com/api/* -> API Worker -https://*.apps.example.com/* -> Apps published by mosoo, when enabled ``` Choose names that are unused in each resource's Cloudflare namespace. Workers, D1 databases, Queues, R2 buckets, and hostnames have different naming and uniqueness rules. Do not copy database IDs, account IDs, zone IDs, or hostnames from another deployment. @@ -109,12 +107,10 @@ The current production configuration requires these API Worker secrets: - `R2_ACCESS_KEY_ID` - `R2_SECRET_ACCESS_KEY` - `CLOUDFLARE_ACCOUNT_ID` -- `CLOUDFLARE_API_TOKEN` -- `CLOUDFLARE_ZONE_ID` - `GOOGLE_OAUTH_CLIENT_ID` - `GOOGLE_OAUTH_CLIENT_SECRET` -Generate independent random values for the first three secrets. Create R2 S3 credentials and the Cloudflare API token in the Cloudflare dashboard. Configure the Google OAuth client with the public mosoo origin and the exact callback URL `https://console.example.com/api/auth/callback/google`, replacing the example domain with `WEB_ORIGIN`. +Generate independent random values for the first three secrets. Copy the account ID and create the R2 S3 credentials in the Cloudflare dashboard. Configure the Google OAuth client with the public mosoo origin and the exact callback URL `https://console.example.com/api/auth/callback/google`, replacing the example domain with `WEB_ORIGIN`. Store each value with Wrangler; do not add it to `wrangler.toml` or a committed `.env` file: diff --git a/content/docs/en/import-export-versions.mdx b/content/docs/en/import-export-versions.mdx index ba40969..7229039 100644 --- a/content/docs/en/import-export-versions.mdx +++ b/content/docs/en/import-export-versions.mdx @@ -23,8 +23,7 @@ A `.agent` package is not an App backup or running-state snapshot. It does not c - Provider or MCP credentials; - conversations, logs, or usage history; -- live runtime state or working files; -- App deployment history. +- live runtime state or working files. Reconnect external services and reselect missing Environment or secret values in the destination App. diff --git a/content/docs/en/index.mdx b/content/docs/en/index.mdx index 6e084cf..7d1b042 100644 --- a/content/docs/en/index.mdx +++ b/content/docs/en/index.mdx @@ -22,7 +22,6 @@ mosoo gives you one workspace to configure AI Agents, test them against real tas ## Publish and operate - [Publish the Agent and enable API access](/docs/publish-and-api-access). -- [Deploy a supported public App](/docs/deploy-app). - Track [Runs, files, and usage](/docs/operations). - Reuse setup through [import, export, fork, and version history](/docs/import-export-versions). diff --git a/content/docs/en/meta.json b/content/docs/en/meta.json index 0e29da9..12ed37d 100644 --- a/content/docs/en/meta.json +++ b/content/docs/en/meta.json @@ -16,7 +16,6 @@ "test-and-debug", "---Publish and operate---", "publish-and-api-access", - "deploy-app", "operations", "import-export-versions", "use-cases", diff --git a/content/docs/en/product-tour.mdx b/content/docs/en/product-tour.mdx index 57bdfbe..252c04d 100644 --- a/content/docs/en/product-tour.mdx +++ b/content/docs/en/product-tour.mdx @@ -3,16 +3,14 @@ title: "Product tour" description: "Understand how Organizations, Apps, Agents, and runs fit together in mosoo." --- -mosoo is a managed workspace for building, running, publishing, and operating AI Agents. You configure an Agent once, test it in the console, then make it available through a Thread, an API endpoint, or an App deployment. - -![The App Overview connects Agent setup, CLI onboarding, and deployment.](/docs/images/product/app-overview.png) +mosoo is a managed workspace for building, running, publishing, and operating AI Agents. You configure an Agent once, test it in the console, then use it through a Thread or an API endpoint. ## The product model | Resource | What it owns | | --- | --- | | **Organization** | Your account-level container. The current product is a single-owner experience; team roles and invitations are not available. | -| **App** | The engineering and delivery boundary for Agents, files, configuration, usage, and one optional deployed site. A new account starts with a Default App. | +| **App** | The isolation boundary for Agents, files, configuration, and usage. A new account starts with a Default App. | | **Agent** | A reusable worker with a type, runtime, model, instructions, Skills, MCP connections, and an Environment. | | **Thread** | The durable conversation and work record for one Agent. Replies can resume work asynchronously. | | **Run** | One execution inside a Thread. Runs produce events, logs, usage, and files. | @@ -25,7 +23,7 @@ mosoo is a managed workspace for building, running, publishing, and operating AI 4. Configure its identity, instructions, Skills, MCP servers, and Environment. 5. Test in **Preview**; inspect **Logs**, **Cost**, and **Terminal** when applicable. 6. Publish the Agent. -7. Start Threads in mosoo, enable API access, or bind the Agent to a deployed App. +7. Start Threads in mosoo or enable API access. 8. Monitor Runs, files, versions, and usage. diff --git a/content/docs/en/use-cases.mdx b/content/docs/en/use-cases.mdx index 82e7181..73bcef3 100644 --- a/content/docs/en/use-cases.mdx +++ b/content/docs/en/use-cases.mdx @@ -35,4 +35,4 @@ Use these patterns as starting points, then test with your own data and failure ## Public application -Publish the Agent, then use the Public Thread API from your backend. If you also need a simple website, App Deployment can publish one supported public repository and bind Agent access. It is not a general backend, authentication, scheduling, or custom-domain platform. +Publish the Agent, then use the Public Thread API from your backend to create or resume a Thread for each application user. diff --git a/content/docs/ja/cli/overview.mdx b/content/docs/ja/cli/overview.mdx index 96857fe..a5f7289 100644 --- a/content/docs/ja/cli/overview.mdx +++ b/content/docs/ja/cli/overview.mdx @@ -39,7 +39,7 @@ printf '%s' "$MOSOO_API_TOKEN" | \ ```bash mosoo --help mosoo commands --json -mosoo commands show console apps deploy-app +mosoo commands show console environments create-environment mosoo search "create environment" ``` @@ -60,12 +60,6 @@ mosoo run \ # project context または明示した flag から Environment を作成 mosoo console environments create-environment - -# public GitHub repository をデプロイ -mosoo console apps deploy-app \ - --input-app-id \ - --input-repo-url https://github.com/owner/repository \ - --wait ``` endpoint resolution は `--target local|cloud|custom`、`--base-url`、`--hostname` で制御します。output format は `table`、`json`、`yaml`、`raw` です。 diff --git a/content/docs/ja/concepts.mdx b/content/docs/ja/concepts.mdx index f529883..232b3af 100644 --- a/content/docs/ja/concepts.mdx +++ b/content/docs/ja/concepts.mdx @@ -7,7 +7,7 @@ mosoo は Coding Agent 向けのオープンソース Agent runtime です。Cla ## App は分離の境界 -App は Agent、ファイル、設定リソース、デプロイ、使用量を分離します。App を切り替えると console に表示されるリソースも変わります。現在の Alpha は単一オーナー向けであり、Organization のチームロール、招待、所有権移管は利用できません。 +App は Agent、ファイル、設定リソース、使用量を分離します。App を切り替えると console に表示されるリソースも変わります。現在の Alpha は単一オーナー向けであり、Organization のチームロール、招待、所有権移管は利用できません。 ## Agent タイプは継続性を決める diff --git a/content/docs/ja/deploy-app.mdx b/content/docs/ja/deploy-app.mdx deleted file mode 100644 index 6dcea81..0000000 --- a/content/docs/ja/deploy-app.mdx +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: "App をデプロイ" -description: "対応する公開 GitHub repository を mosoo から公開します。" ---- - -App Deployment は、Agent と並んで一つの対応する公開 repository を mosoo 管理 URL に公開するための secondary Alpha 機能です。 - -## Overview からデプロイする - -1. App の **Overview** を開きます。 -2. public GitHub repository URL を入力します。 -3. **Deploy** を選択します。 -4. deployment の **Deploying**、**Successful**、**Failed** state を確認します。 -5. 成功後、live site を開くか、以前の attempt を確認します。 - -mosoo は default branch の HEAD を取得し、対応する static または request-handling web App を自動検出します。`.mosoo.toml` で対応する検出設定を上書きできます。 - -## CLI でデプロイする - -```bash -mosoo console apps deploy-app \ - --input-app-id \ - --input-repo-url https://github.com/owner/repository \ - --wait -``` - -## Deployment を運用する - -Overview から、最新の default branch の再公開、source repository の変更、deployment の削除ができます。後の attempt が失敗しても、最後に成功した URL は表示され続けます。deployment を削除すると hosted site と紐付いた Agent access は削除されますが、GitHub repository は変更されません。 - - - App Deployment は現在、public repository と App ごとに一つの deployed site をサポートします。private repository、custom domain、branch preview、automatic deployment、rollback、App-user authentication、schedule、durable backend state は提供しません。 - diff --git a/content/docs/ja/deploy-mosoo.mdx b/content/docs/ja/deploy-mosoo.mdx index af4e98a..146c303 100644 --- a/content/docs/ja/deploy-mosoo.mdx +++ b/content/docs/ja/deploy-mosoo.mdx @@ -3,7 +3,7 @@ title: "Cloudflare に mosoo をデプロイ" description: "GitHub Actions またはローカルの Wrangler toolchain から Cloudflare Workers に mosoo をデプロイします。" --- -mosoo は二つの Cloudflare Worker として動作します。一つは D1、R2、Queues、Durable Objects、Containers を使用する API Worker、もう一つは console を配信し API service に binding する Web Worker です。単体の Cloudflare Pages site ではありません。 +mosoo は二つの Cloudflare Worker として動作します。一つは D1、R2、Queues、Durable Objects、Containers を使用する API Worker、もう一つは console を配信し API service に binding する Web Worker です。 このガイドでは、reference deployment で使用する二つの方法を説明します。 @@ -15,17 +15,17 @@ mosoo は二つの Cloudflare Worker として動作します。一つは D1、R ## 前提条件 - Workers、D1、R2、Queues、Durable Objects、Containers が利用可能な Cloudflare account。 -- Cloudflare DNS にある `console.example.com` などの domain。App Deployment を有効にする場合は `apps.example.com` などの deployment subdomain も必要です。 +- Cloudflare DNS にある `console.example.com` などの domain。 - Git、Docker、[Bun](https://bun.sh/)、[just](https://just.systems/)、repository submodule。 - 上記 resource のデプロイに必要な account と zone permission を持つ Cloudflare API token。token と secret value は Git の外に保管し、以下の操作に必要な最小権限を使用してください。 | Scope | 必要な操作 | | --- | --- | -| Account | Workers script、version、deployment、custom domain、Containers、D1 migration、R2、Queues。App Deployment を有効にする場合は Pages project と domain も必要です。 | -| `CLOUDFLARE_ZONE_ID` で選択する Zone | App Deployment domain に対する Workers Routes の変更。 | -| R2 S3 credential | deployed app が使用する sandbox-state bucket の読み書き。 | +| Account | Workers script、version、deployment、custom domain、Containers、D1 migration、R2、Queues。 | +| Console domain を所有する Zone | `/api/*` API route に対する Workers Routes の変更。 | +| R2 S3 credential | Agent runtime backup が使用する sandbox-state bucket の読み書き。 | -`CLOUDFLARE_ZONE_ID` は `MOSOO_APP_DEPLOYMENT_DOMAIN` を所有する zone を指定する必要があります。Cloudflare の token label は変わることがあるため、account 全体の administrator 権限を付与するのではなく、上記の API operation が許可されていることを確認してください。 +Cloudflare の token label は変わることがあるため、account 全体の administrator 権限を付与するのではなく、上記の API operation が許可されていることを確認してください。 fork を clone し、固定された dependency を install します。 @@ -80,7 +80,6 @@ resource 名を変更した場合は、`apps/api/wrangler.toml` にある対応 1. `apps/api/wrangler.toml`: - `WEB_ORIGIN` を公開 HTTPS console URL に設定。 - - `MOSOO_APP_DEPLOYMENT_DOMAIN` を deployment domain に設定。 - API route を `/api/*` に設定し、その `zone_name` を指定。 - `wrangler d1 create` が返した D1 `database_id` を設定。 - default を使用しなかった場合は D1、R2、Queue 名を更新。 @@ -94,7 +93,6 @@ resource 名を変更した場合は、`apps/api/wrangler.toml` にある対応 ```text https://console.example.com/* -> Web Worker https://console.example.com/api/* -> API Worker -https://*.apps.example.com/* -> Apps published by mosoo, when enabled ``` Cloudflare の各 resource namespace で未使用の名前を選びます。Workers、D1 database、Queue、R2 bucket、hostname にはそれぞれ異なる命名規則と一意性の要件があります。別の deployment の database ID、account ID、zone ID、hostname をコピーしないでください。 @@ -109,12 +107,10 @@ Cloudflare の各 resource namespace で未使用の名前を選びます。Work - `R2_ACCESS_KEY_ID` - `R2_SECRET_ACCESS_KEY` - `CLOUDFLARE_ACCOUNT_ID` -- `CLOUDFLARE_API_TOKEN` -- `CLOUDFLARE_ZONE_ID` - `GOOGLE_OAUTH_CLIENT_ID` - `GOOGLE_OAUTH_CLIENT_SECRET` -最初の三つにはそれぞれ独立した random value を生成します。R2 S3 credential と Cloudflare API token は Cloudflare dashboard で作成します。Google OAuth client には公開 mosoo origin と正確な callback URL `https://console.example.com/api/auth/callback/google` を設定し、example domain は `WEB_ORIGIN` に置き換えてください。 +最初の三つにはそれぞれ独立した random value を生成します。Cloudflare dashboard で account ID を確認し、R2 S3 credential を作成します。Google OAuth client には公開 mosoo origin と正確な callback URL `https://console.example.com/api/auth/callback/google` を設定し、example domain は `WEB_ORIGIN` に置き換えてください。 各 value は Wrangler で保存し、`wrangler.toml` や commit 対象の `.env` file には追加しないでください。 diff --git a/content/docs/ja/import-export-versions.mdx b/content/docs/ja/import-export-versions.mdx index 45540aa..61a5ee0 100644 --- a/content/docs/ja/import-export-versions.mdx +++ b/content/docs/ja/import-export-versions.mdx @@ -24,7 +24,6 @@ Agent settings を開いて **Fork agent** を選択します。fork は同じ A - Provider または MCP credential。 - conversation、ログ、使用履歴。 - live runtime state または作業ファイル。 -- App deployment history。 移行先 App で外部 service を再接続し、見つからない Environment や secret value を再選択してください。 diff --git a/content/docs/ja/index.mdx b/content/docs/ja/index.mdx index f3ec1b1..45ead0f 100644 --- a/content/docs/ja/index.mdx +++ b/content/docs/ja/index.mdx @@ -22,7 +22,6 @@ mosoo は、AI Agent の設定、実際のタスクによるテスト、安定 ## 公開と運用 - [Agent を公開して API access を有効化](/docs/ja/publish-and-api-access)します。 -- [対応する公開 App をデプロイ](/docs/ja/deploy-app)します。 - [Run、ファイル、使用量](/docs/ja/operations)を確認します。 - [インポート、エクスポート、fork、バージョン履歴](/docs/ja/import-export-versions)で設定を再利用します。 diff --git a/content/docs/ja/meta.json b/content/docs/ja/meta.json index 461f2ad..92d2ca2 100644 --- a/content/docs/ja/meta.json +++ b/content/docs/ja/meta.json @@ -16,7 +16,6 @@ "test-and-debug", "---公開と運用---", "publish-and-api-access", - "deploy-app", "operations", "import-export-versions", "use-cases", diff --git a/content/docs/ja/product-tour.mdx b/content/docs/ja/product-tour.mdx index 8178a6c..540f774 100644 --- a/content/docs/ja/product-tour.mdx +++ b/content/docs/ja/product-tour.mdx @@ -3,16 +3,14 @@ title: "製品ツアー" description: "mosoo における Organization、App、Agent、Run の関係を理解します。" --- -mosoo は、AI Agent を構築、実行、公開、運用するためのマネージドワークスペースです。Agent を一度設定して console でテストした後、Thread、API endpoint、または App deployment から利用できるようにします。 - -![App Overview は Agent のセットアップ、CLI のオンボーディング、デプロイを結び付けます。](/docs/images/product/app-overview.png) +mosoo は、AI Agent を構築、実行、公開、運用するためのマネージドワークスペースです。Agent を一度設定して console でテストした後、Thread または API endpoint から利用できます。 ## 製品モデル | リソース | 所有するもの | | --- | --- | | **Organization** | アカウントレベルのコンテナです。現在は単一オーナー向けであり、チームロールや招待は利用できません。 | -| **App** | Agent、ファイル、設定、使用量、任意のデプロイ済みサイト一つをまとめる開発・提供上の境界です。新しいアカウントには Default App が作成されます。 | +| **App** | Agent、ファイル、設定、使用量を分離する境界です。新しいアカウントには Default App が作成されます。 | | **Agent** | タイプ、runtime、モデル、指示、Skill、MCP connection、Environment を備えた再利用可能なワーカーです。 | | **Thread** | 一つの Agent に対する永続的な会話と作業の記録です。返信によって非同期に作業を再開できます。 | | **Run** | Thread 内の一回の実行です。Run はイベント、ログ、使用量、ファイルを生成します。 | @@ -25,7 +23,7 @@ mosoo は、AI Agent を構築、実行、公開、運用するためのマネ 4. 識別情報、指示、Skill、MCP server、Environment を設定します。 5. **Preview** でテストし、必要に応じて **Logs**、**Cost**、**Terminal** を確認します。 6. Agent を公開します。 -7. mosoo で Thread を開始するか、API access を有効にするか、デプロイ済み App に Agent を紐付けます。 +7. mosoo で Thread を開始するか、API access を有効にします。 8. Run、ファイル、バージョン、使用量を監視します。 diff --git a/content/docs/ja/use-cases.mdx b/content/docs/ja/use-cases.mdx index 5962190..148b415 100644 --- a/content/docs/ja/use-cases.mdx +++ b/content/docs/ja/use-cases.mdx @@ -35,4 +35,4 @@ description: "一般的な workflow に合う Agent タイプと mosoo 機能を ## 公開 application -Agent を公開し、backend から Public Thread API を使用します。簡単な website も必要な場合、App Deployment で対応する public repository を一つ公開し、Agent access を紐付けられます。これは汎用 backend、authentication、scheduling、custom-domain platform ではありません。 +Agent を公開し、backend から Public Thread API を使用して、application user ごとに Thread を作成または再開します。 diff --git a/content/docs/zh-Hans/cli/overview.mdx b/content/docs/zh-Hans/cli/overview.mdx index 8ff01e8..1fca922 100644 --- a/content/docs/zh-Hans/cli/overview.mdx +++ b/content/docs/zh-Hans/cli/overview.mdx @@ -39,7 +39,7 @@ printf '%s' "$MOSOO_API_TOKEN" | \ ```bash mosoo --help mosoo commands --json -mosoo commands show console apps deploy-app +mosoo commands show console environments create-environment mosoo search "create environment" ``` @@ -60,12 +60,6 @@ mosoo run \ # 根据项目上下文或显式参数创建 Environment mosoo console environments create-environment - -# 部署 public GitHub repository -mosoo console apps deploy-app \ - --input-app-id \ - --input-repo-url https://github.com/owner/repository \ - --wait ``` 通过 `--target local|cloud|custom`、`--base-url` 或 `--hostname` 控制 endpoint resolution。输出格式包括 `table`、`json`、`yaml` 和 `raw`。 diff --git a/content/docs/zh-Hans/concepts.mdx b/content/docs/zh-Hans/concepts.mdx index b1315f9..be4aeb1 100644 --- a/content/docs/zh-Hans/concepts.mdx +++ b/content/docs/zh-Hans/concepts.mdx @@ -7,7 +7,7 @@ mosoo 是面向 Coding Agent 的开源 Agent runtime。它把 Claude Agent SDK ## App 是隔离边界 -App 将自己的 Agents、文件、配置资源、部署和用量保持独立。切换 App 会改变控制台中可见的资源。当前 Alpha 是单所有者模式,暂不提供组织团队角色、邀请或所有权转移。 +App 将自己的 Agents、文件、配置资源和用量保持独立。切换 App 会改变控制台中可见的资源。当前 Alpha 是单所有者模式,暂不提供组织团队角色、邀请或所有权转移。 ## Agent 类型决定连续性 diff --git a/content/docs/zh-Hans/deploy-app.mdx b/content/docs/zh-Hans/deploy-app.mdx deleted file mode 100644 index ce80075..0000000 --- a/content/docs/zh-Hans/deploy-app.mdx +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: "部署 App" -description: "通过 mosoo 发布受支持的公共 GitHub repository。" ---- - -App Deployment 是一项次要 Alpha 能力,用于在 Agents 之外将一个受支持的 public repository 发布到 mosoo-managed URL。 - -## 从 Overview 部署 - -1. 打开 App **Overview**。 -2. 输入公共 GitHub repository URL。 -3. 选择 **Deploy**。 -4. 查看状态:**Deploying**、**Successful** 或 **Failed**。 -5. 成功后打开 live site 或查看之前的 attempts。 - -mosoo 拉取 default branch HEAD,并自动识别受支持的 static 或 request-handling web App。可用 `.mosoo.toml` 覆盖受支持的检测设置。 - -## 使用 CLI 部署 - -```bash -mosoo console apps deploy-app \ - --input-app-id \ - --input-repo-url https://github.com/owner/repository \ - --wait -``` - -## 运营 deployment - -在 Overview 中可以重新发布最新 default branch、更换 source repository 或删除 deployment。后续部署失败不会隐藏上一次成功 URL。删除 deployment 会移除 hosted site 与绑定的 Agent access,但不会修改 GitHub repository。 - - - 当前每个 App 只支持一个 public repository 和一个 deployed site;不提供 private repository、custom domain、branch preview、automatic deployment、rollback、App-user authentication、schedule 或 durable backend state。 - diff --git a/content/docs/zh-Hans/deploy-mosoo.mdx b/content/docs/zh-Hans/deploy-mosoo.mdx index a77ff11..cc1e276 100644 --- a/content/docs/zh-Hans/deploy-mosoo.mdx +++ b/content/docs/zh-Hans/deploy-mosoo.mdx @@ -3,7 +3,7 @@ title: "在 Cloudflare 上部署 mosoo" description: "通过 GitHub Actions 云端部署,或在本地使用 Wrangler 工具链部署 mosoo。" --- -mosoo 由两个 Cloudflare Workers 组成:API Worker 使用 D1、R2、Queues、Durable Objects 和 Containers;Web Worker 提供控制台,并通过服务绑定连接 API。mosoo 不是一个可以单独部署的 Cloudflare Pages 静态站点。 +mosoo 由两个 Cloudflare Workers 组成:API Worker 使用 D1、R2、Queues、Durable Objects 和 Containers;Web Worker 提供控制台,并通过服务绑定连接 API。 本指南介绍参考部署所采用的两种发布方式: @@ -15,17 +15,17 @@ mosoo 由两个 Cloudflare Workers 组成:API Worker 使用 D1、R2、Queues ## 前置要求 - Cloudflare 账号已开通 Workers、D1、R2、Queues、Durable Objects 和 Containers。 -- 一个由 Cloudflare DNS 托管的域名,例如 `console.example.com`;如需启用 App 部署,还需准备 `apps.example.com` 这类部署子域名。 +- 一个由 Cloudflare DNS 托管的域名,例如 `console.example.com`。 - 已安装 Git、Docker、[Bun](https://bun.sh/)、[just](https://just.systems/),并能拉取仓库子模块。 - 一个具备上述账号资源和域名区域部署权限的 Cloudflare API 令牌。令牌和密钥不得提交到 Git,并应按以下操作范围配置最小权限。 | 范围 | 必需操作 | | --- | --- | -| 账号 | Workers 脚本、版本、部署、自定义域名与 Containers;D1 迁移;R2;Queues;启用 App 部署时还包括 Pages 项目与域名 | -| `CLOUDFLARE_ZONE_ID` 指定的域名区域 | 修改 App 部署域名的 Workers Routes | -| R2 S3 凭据 | 读写已部署应用使用的 sandbox-state 存储桶 | +| 账号 | Workers 脚本、版本、部署、自定义域名与 Containers;D1 迁移;R2;Queues | +| 控制台域名所在的域名区域 | 修改 `<控制台域名>/api/*` API 路由使用的 Workers Routes | +| R2 S3 凭据 | 读写 Agent runtime 备份使用的 sandbox-state 存储桶 | -`CLOUDFLARE_ZONE_ID` 必须对应 `MOSOO_APP_DEPLOYMENT_DOMAIN` 所在的域名区域。Cloudflare 控制台中的权限名称可能调整,应核对令牌是否允许这些具体 API 操作,而不是直接授予账号管理员权限。 +Cloudflare 控制台中的权限名称可能调整,应核对令牌是否允许这些具体 API 操作,而不是直接授予账号管理员权限。 克隆你的 fork,并安装仓库锁定的依赖: @@ -80,7 +80,6 @@ done 1. 在 `apps/api/wrangler.toml` 中: - 将 `WEB_ORIGIN` 设为公开的 HTTPS 控制台地址; - - 将 `MOSOO_APP_DEPLOYMENT_DOMAIN` 设为应用部署域名; - 将 API 路由改为 `<控制台域名>/api/*`,并设置对应的 `zone_name`; - 填入 `wrangler d1 create` 返回的 D1 `database_id`; - 如果没有采用默认名称,同步更新 D1、R2 和 Queue 名称; @@ -94,7 +93,6 @@ done ```text https://console.example.com/* -> Web Worker https://console.example.com/api/* -> API Worker -https://*.apps.example.com/* -> mosoo 发布的应用(启用时) ``` 请分别按照 Cloudflare 各类资源的命名空间选择尚未使用的名称;Workers、D1 数据库、Queues、R2 存储桶和域名的命名与唯一性规则并不相同。不要复制其他部署的数据库 ID、账号 ID、区域 ID 或域名。 @@ -109,12 +107,10 @@ https://*.apps.example.com/* -> mosoo 发布的应用(启用时) - `R2_ACCESS_KEY_ID` - `R2_SECRET_ACCESS_KEY` - `CLOUDFLARE_ACCOUNT_ID` -- `CLOUDFLARE_API_TOKEN` -- `CLOUDFLARE_ZONE_ID` - `GOOGLE_OAUTH_CLIENT_ID` - `GOOGLE_OAUTH_CLIENT_SECRET` -前三项应分别生成独立的随机值。在 Cloudflare 控制台创建 R2 S3 凭据和 Cloudflare API 令牌;为 Google OAuth 客户端配置公开的 mosoo 来源地址,并将回调地址精确设置为 `https://console.example.com/api/auth/callback/google`,其中示例域名应替换为 `WEB_ORIGIN`。 +前三项应分别生成独立的随机值。在 Cloudflare 控制台复制账号 ID 并创建 R2 S3 凭据;为 Google OAuth 客户端配置公开的 mosoo 来源地址,并将回调地址精确设置为 `https://console.example.com/api/auth/callback/google`,其中示例域名应替换为 `WEB_ORIGIN`。 通过 Wrangler 保存每一项,不要把密钥写入 `wrangler.toml` 或提交到仓库的 `.env` 文件: diff --git a/content/docs/zh-Hans/import-export-versions.mdx b/content/docs/zh-Hans/import-export-versions.mdx index ad7e396..306a25d 100644 --- a/content/docs/zh-Hans/import-export-versions.mdx +++ b/content/docs/zh-Hans/import-export-versions.mdx @@ -23,8 +23,7 @@ description: "安全复用 Agent 配置并理解发布历史。" - Provider 或 MCP credentials; - conversations、logs 或 usage history; -- live runtime state 或 working files; -- App deployment history。 +- live runtime state 或 working files。 请在目标 App 重新连接外部服务,并补选缺失的 Environment 或 secret values。 diff --git a/content/docs/zh-Hans/index.mdx b/content/docs/zh-Hans/index.mdx index 3a2f6f3..2416f58 100644 --- a/content/docs/zh-Hans/index.mdx +++ b/content/docs/zh-Hans/index.mdx @@ -22,7 +22,6 @@ mosoo 提供一个统一工作区,用于配置 AI Agent、用真实任务测 ## 发布与运营 - [发布 Agent 并启用 API access](/docs/zh-Hans/publish-and-api-access)。 -- [部署受支持的公共 App](/docs/zh-Hans/deploy-app)。 - 查看 [Runs、文件与用量](/docs/zh-Hans/operations)。 - 通过[导入、导出、fork 与 version history](/docs/zh-Hans/import-export-versions)复用配置。 diff --git a/content/docs/zh-Hans/meta.json b/content/docs/zh-Hans/meta.json index 41034ba..4053309 100644 --- a/content/docs/zh-Hans/meta.json +++ b/content/docs/zh-Hans/meta.json @@ -16,7 +16,6 @@ "test-and-debug", "---发布与运营---", "publish-and-api-access", - "deploy-app", "operations", "import-export-versions", "use-cases", diff --git a/content/docs/zh-Hans/product-tour.mdx b/content/docs/zh-Hans/product-tour.mdx index 136fdfa..c538f83 100644 --- a/content/docs/zh-Hans/product-tour.mdx +++ b/content/docs/zh-Hans/product-tour.mdx @@ -3,16 +3,14 @@ title: "产品导览" description: "了解 mosoo 中组织、App、Agent 与运行记录之间的关系。" --- -mosoo 是一个用于构建、运行、发布和运营 AI Agent 的托管工作区。你可以先配置 Agent,在控制台中测试,然后通过 Thread、API endpoint 或 App deployment 对外提供能力。 - -![App Overview 汇集了 Agent 配置、CLI 上手和部署入口。](/docs/images/product/app-overview.png) +mosoo 是一个用于构建、运行、发布和运营 AI Agent 的托管工作区。你可以先配置 Agent,在控制台中测试,然后通过 Thread 或 API endpoint 使用它。 ## 产品模型 | 资源 | 负责的范围 | | --- | --- | | **Organization** | 账号级容器。当前产品是单所有者体验,暂不提供团队角色和邀请。 | -| **App** | Agent、文件、配置、用量以及一个可选部署站点的工程与交付边界。新账号会获得 Default App。 | +| **App** | Agent、文件、配置和用量的隔离边界。新账号会获得 Default App。 | | **Agent** | 可复用的工作者,包含类型、runtime、模型、指令、Skills、MCP 连接和 Environment。 | | **Thread** | 一个 Agent 的持久对话与工作记录,可以通过后续回复异步恢复。 | | **Run** | Thread 中的一次执行,会产生事件、日志、用量和文件。 | @@ -25,7 +23,7 @@ mosoo 是一个用于构建、运行、发布和运营 AI Agent 的托管工作 4. 配置身份、指令、Skills、MCP servers 和 Environment。 5. 在 **Preview** 中测试;需要时检查 **Logs**、**Cost** 和 **Terminal**。 6. 发布 Agent。 -7. 在 mosoo 中创建 Thread、启用 API access,或绑定到已部署 App。 +7. 在 mosoo 中创建 Thread 或启用 API access。 8. 持续查看 Runs、文件、版本和用量。 diff --git a/content/docs/zh-Hans/use-cases.mdx b/content/docs/zh-Hans/use-cases.mdx index 290c8f1..0209932 100644 --- a/content/docs/zh-Hans/use-cases.mdx +++ b/content/docs/zh-Hans/use-cases.mdx @@ -35,4 +35,4 @@ description: "为常见工作流选择 Agent type 和 mosoo 功能。" ## 公共应用 -先发布 Agent,再由你的 backend 调用 Public Thread API。如还需要简单网站,App Deployment 可发布一个受支持的 public repository 并绑定 Agent access。它不是通用 backend、authentication、scheduling 或 custom-domain 平台。 +先发布 Agent,再由你的 backend 通过 Public Thread API 为每位应用用户创建或恢复 Thread。 diff --git a/public/docs/images/product/app-overview.png b/public/docs/images/product/app-overview.png deleted file mode 100644 index 3a81c71..0000000 Binary files a/public/docs/images/product/app-overview.png and /dev/null differ diff --git a/public/docs/openapi/mosoo-openapi.provenance.json b/public/docs/openapi/mosoo-openapi.provenance.json index 454c7b8..36d0ddd 100644 --- a/public/docs/openapi/mosoo-openapi.provenance.json +++ b/public/docs/openapi/mosoo-openapi.provenance.json @@ -2,5 +2,5 @@ "normalizedOpenApiSha256": "e36dcaffb596559a4854923b289cf15707999a1f9e8047a7fc938093e62ec462", "upstreamRef": "main", "upstreamRepository": "https://github.com/langgenius/mosoo", - "upstreamSha": "1b802e4d222b9a04782896ee6a770baf91120c20" + "upstreamSha": "dd0bf6e08c80450587a328a74d820171fb71b4cb" } diff --git a/tests/deployment-docs.test.mjs b/tests/deployment-docs.test.mjs index 1a603b2..68c4969 100644 --- a/tests/deployment-docs.test.mjs +++ b/tests/deployment-docs.test.mjs @@ -38,11 +38,11 @@ test('deployment guides put the non-mutating production preflight before deploy' } }); -test('deployment guides document callback and Cloudflare permission scope', () => { +test('deployment guides document callback and mosoo deployment permission scope', () => { for (const [locale, content] of deploymentGuides) { assert.ok(content.includes('/api/auth/callback/google'), `${locale} callback path missing`); assert.ok(content.includes('Workers Routes'), `${locale} Workers Routes permission missing`); - assert.ok(content.includes('Pages'), `${locale} Pages permission missing`); + assert.ok(content.includes('sandbox-state'), `${locale} runtime backup bucket missing`); assert.doesNotMatch(content, /\bMosoo\b/, `${locale} uses inconsistent brand capitalization`); } });