Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
40 commits
Select commit Hold shift + click to select a range
598f344
Build Parsar collaborative workspace
SaladDay Oct 14, 2026
e9d8619
Complete Parsar workspace and Feishu workflows
SaladDay Oct 14, 2026
c5fada5
Organize Parsar around Agent and environment templates
SaladDay Oct 14, 2026
c2ffb64
Allow external links to open the Parsar homepage
SaladDay Oct 14, 2026
a4ae7b7
Accept loopback ports used by Parsar SSH forwards
SaladDay Oct 14, 2026
d3f6232
Merge main into Parsar example branch
SaladDay Oct 14, 2026
44c93ff
feat(parsar): configure hosted environment preparation
SaladDay Oct 14, 2026
0d0be19
docs: clarify hosted example boundary
SaladDay Oct 14, 2026
ce17851
Connect Parsar user accounts through Feishu consent
SaladDay Oct 14, 2026
b545b77
Compose Parsar cases from templates
SaladDay Oct 15, 2026
e4bccd2
Check example environment scripts in CI
SaladDay Oct 15, 2026
a90e6c9
Unify Parsar Agent configuration form
SaladDay Oct 15, 2026
dd89ce6
Simplify Parsar Feishu onboarding
SaladDay Oct 15, 2026
0d51ae9
Focus Parsar on Web chat and Feishu conversations
SaladDay Oct 20, 2026
a982104
Merge origin/main into feat/parsar-collaborative-workspace
SaladDay Oct 20, 2026
561d675
Let Parsar Agents use web search and reasoning effort
SaladDay Oct 20, 2026
bfb1614
Fix Parsar usability issues found in review
SaladDay Oct 20, 2026
ebae24c
Separate how Parsar Agents run into execution profiles
SaladDay Oct 20, 2026
442077f
Let Parsar environment templates prepare Sessions ahead
SaladDay Oct 20, 2026
c77e138
Let Parsar listen on a configured LAN address
SaladDay Oct 20, 2026
d100d7f
Ignore Feishu topic replies addressed to other people
SaladDay Oct 20, 2026
4870b84
Align Parsar Agent resource limits with Core's Environment limits
SaladDay Oct 21, 2026
ccd32e5
Configure Parsar Agent engines on the Agent itself
SaladDay Oct 21, 2026
510feb6
Watch every Parsar turn and recover the failures users hit
SaladDay Oct 22, 2026
9cdea00
Keep the Feishu workspace's lark-cli state under /workspace
SaladDay Oct 22, 2026
04b5bb0
Merge main into feat/parsar-collaborative-workspace
SaladDay Oct 22, 2026
ca4bedd
Give each Parsar rule one home
SaladDay Oct 22, 2026
3bc52ee
Send a claimed prepared Session's first input through the Turn ledger
SaladDay Oct 22, 2026
6d1f8fa
Match each ledger entry to the first Core Turn after its baseline
SaladDay Oct 22, 2026
60277ad
Let the Turn monitor recover a claimed prepared Session
SaladDay Oct 22, 2026
15a2c7c
Add Parsar management CLI and ordinary manager agent
SaladDay Oct 23, 2026
a06ec75
Enable authenticated HTTPS access for Parsar manager
SaladDay Oct 23, 2026
01143a4
fix(parsar): stream thinking in the conversation
SaladDay Oct 23, 2026
b7553b5
fix(parsar): keep expanded thinking in view
SaladDay Oct 23, 2026
4b2e86c
Add bot onboarding and chat media
SaladDay Oct 23, 2026
43b6267
Refine Feishu cards and isolate reply details
SaladDay Oct 23, 2026
188e050
Keep Feishu replies compact and recover ordered delivery
SaladDay Oct 23, 2026
d790450
Show every running conversation turn in the 运行 view
SaladDay Oct 25, 2026
58dae8c
Put 运行 directly under 新对话 with a live count
SaladDay Oct 25, 2026
e5a9700
Merge main into feat/parsar-collaborative-workspace
SaladDay Oct 25, 2026
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
8 changes: 4 additions & 4 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,12 +38,12 @@ Core builds, deploys and runs independently of product services, frontends and d

### Optional application example

`example/parsar/` is an optional Agent workbench in this repository. Its [README](example/parsar/README.md) owns its product behavior.
`example/parsar/` is an optional conversation workspace in this repository. Its [README](example/parsar/README.md) owns its product behavior.

- It calls only public `/v1` APIs. Its Project key stays server-side; it never holds a Core key or issues machine credentials. Self-hosted connection displays the public Session installation command unchanged; Core owns bootstrap authorization and machine credential issuance.
- It calls only public `/v1` APIs. Its Project key stays server-side; it never holds a Core key or issues machine credentials. The example uses only Core-managed hosted environments; its environment templates prepare packages, initialization commands, variables and initial files through the public Session contract.
- It may keep a small product-owned SQLite database (Node's built-in module, Node 22.13+), outside the checkout and isolated by Core origin and Project key fingerprint. Provider keys never reach the browser.
- Core owns Skills and all execution and history state. The example stores only Session references and pending creation requests with stable idempotency keys.
- Product resources use `/app/` and never become Core API or database conventions.
- Core owns Skills and authoritative execution/history state. The example owns resource configurations, projects, tasks, comments, interval/Cron plans and Feishu delivery receipts. Session records retain Core references and pending creation requests with stable idempotency keys; product workers use the same public API as interactive flows.
- Product resources use `/app/` and never become Core API or database conventions. Execution uses bypass mode. The local Web operator, Agent-scoped local MCP tokens and configured Feishu routes are the example’s access boundary; it does not implement product accounts or fine-grained permissions.
- It is excluded from Core distributions and cannot become a service dependency.

## Workflow and review
Expand Down
6 changes: 3 additions & 3 deletions docs/examples.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ Complete applications built on the [Agents API guide](./api/public-agent-api.md)

## Parsar Agent workbench

A small single-user product built on Core. You save model providers, Skills and MCP servers, combine them into Agents, then start Sessions in a managed sandbox, with no workspace, or on your own machine.
A conversation workspace built on Core. Assemble Agents from a resource library and an environment template, then talk to them in a local Web chat or through Feishu bots that act as the Agent's identity. Both entries create ordinary public Sessions.

Source: [`example/parsar`](https://github.com/MiniMax-AI/OpenAgentCore/blob/main/example/parsar/README.md).

Expand All @@ -20,12 +20,12 @@ Each feature maps to one part of the API. Read the code next to the guide sectio
| --- | --- | --- | --- |
| Server-side key and headers | Bearer key, `OpenAI-Beta`, route allowlist | [Before you start](./api/public-agent-api.md#before-you-start) | [`server.mjs`](https://github.com/MiniMax-AI/OpenAgentCore/blob/main/example/parsar/server.mjs) |
| Agents with a Harness and model | `x_agents_core.harness`, `model_provider` | [Core extensions](./api/public-agent-api.md#core-extensions) | [`server/sessions.mjs`](https://github.com/MiniMax-AI/OpenAgentCore/blob/main/example/parsar/server/sessions.mjs) |
| Sessions on three runtimes | `openai_hosted`, `none`, `self_hosted` with `workspace_directory` | [Create a Session](./api/public-agent-api.md#create-a-session) | [`server/sessions.mjs`](https://github.com/MiniMax-AI/OpenAgentCore/blob/main/example/parsar/server/sessions.mjs) |
| Web and Feishu conversations | Public Session creation, input events, Turns and Items | [Send input](./api/public-agent-api.md#send-input) | [`server/sessions.mjs`](https://github.com/MiniMax-AI/OpenAgentCore/blob/main/example/parsar/server/sessions.mjs), [`server/feishu.mjs`](https://github.com/MiniMax-AI/OpenAgentCore/blob/main/example/parsar/server/feishu.mjs) |
| Hosted Environments from templates | `openai_hosted` with packages, files, `env` and `setup_commands` | [Create a Session](./api/public-agent-api.md#create-a-session) | [`server/runtime-profile.mjs`](https://github.com/MiniMax-AI/OpenAgentCore/blob/main/example/parsar/server/runtime-profile.mjs) |
| Crash-safe Session creation | `Idempotency-Key`, recovery from a lost response | [Idempotency](./api/public-agent-api.md#idempotency) | [`server/sessions.mjs`](https://github.com/MiniMax-AI/OpenAgentCore/blob/main/example/parsar/server/sessions.mjs) |
| Live replies | Event stream, text deltas, reconnect and reconcile | [Stream events](./api/public-agent-api.md#stream-events) | [`src/lib/live-session.ts`](https://github.com/MiniMax-AI/OpenAgentCore/blob/main/example/parsar/src/lib/live-session.ts) |
| Follow-ups and cancel | Input events with idempotency keys | [Send input](./api/public-agent-api.md#send-input) | [`src/Composer.tsx`](https://github.com/MiniMax-AI/OpenAgentCore/blob/main/example/parsar/src/Composer.tsx) |
| History | Paging Turns and Items | [Pagination](./api/public-agent-api.md#pagination) | [`src/lib/api.ts`](https://github.com/MiniMax-AI/OpenAgentCore/blob/main/example/parsar/src/lib/api.ts) |
| Skills and versions | `/skills`, default version | [Skills](./api/public-agent-api.md#skills) | [`src/Skills.tsx`](https://github.com/MiniMax-AI/OpenAgentCore/blob/main/example/parsar/src/Skills.tsx) |
| Connect your own machine | `x_agents_core.installation`, Environment status | [Run self-hosted Sessions](./getting-started/self-hosted.md) | [`src/ConnectMachine.tsx`](https://github.com/MiniMax-AI/OpenAgentCore/blob/main/example/parsar/src/ConnectMachine.tsx) |

To contribute an example, follow the [application example boundary](https://github.com/MiniMax-AI/OpenAgentCore/blob/main/CONTRIBUTING.md#optional-application-example).
8 changes: 4 additions & 4 deletions docs/zh/examples.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
---
title: "示例"
source: docs/examples.md
source_hash: 9678dd4dd68c8b78151a441360adb3384542708ad981eb451d98732c4a4a7c58
source_hash: 99d9e955b20c81fea35ba28915e0bd96619afa94b6fc224b8b7a2a1047cce4a4
---

基于 [Agents API 指南](api/public-agent-api.md)构建的完整应用,每个都使用项目 API 密钥连接真实的 Core 安装。

## Parsar Agent 工作台 {#parsar-agent-workbench}

基于 Core 构建的小型单用户产品。保存模型提供商、Skills 和 MCP 服务器,将它们组合成 Agent,然后在托管沙箱、无工作区环境或自己的机器上启动 Session。
基于 Core 构建的对话工作空间。从资源库和环境模板组装 Agent,然后在本地网页聊天中对话,或通过以 Agent 身份工作的飞书机器人对话。两个入口都创建普通的公开 Session。

源码:[`example/parsar`](https://github.com/MiniMax-AI/OpenAgentCore/blob/main/example/parsar/README.md)。

Expand All @@ -22,12 +22,12 @@ source_hash: 9678dd4dd68c8b78151a441360adb3384542708ad981eb451d98732c4a4a7c58
| --- | --- | --- | --- |
| 服务端密钥和请求头 | Bearer 密钥、`OpenAI-Beta`、路由允许列表 | [开始前](api/public-agent-api.md#before-you-start) | [`server.mjs`](https://github.com/MiniMax-AI/OpenAgentCore/blob/main/example/parsar/server.mjs) |
| 带 Harness 和模型的 Agent | `x_agents_core.harness`、`model_provider` | [Core 扩展](api/public-agent-api.md#core-extensions) | [`server/sessions.mjs`](https://github.com/MiniMax-AI/OpenAgentCore/blob/main/example/parsar/server/sessions.mjs) |
| 三种 Runtime 上的 Session | `openai_hosted`、`none`、带 `workspace_directory` 的 `self_hosted` | [创建 Session](api/public-agent-api.md#create-a-session) | [`server/sessions.mjs`](https://github.com/MiniMax-AI/OpenAgentCore/blob/main/example/parsar/server/sessions.mjs) |
| 网页与飞书对话 | 公开 Session 创建、输入事件、Turns 和 Items | [发送输入](api/public-agent-api.md#send-input) | [`server/sessions.mjs`](https://github.com/MiniMax-AI/OpenAgentCore/blob/main/example/parsar/server/sessions.mjs)、[`server/feishu.mjs`](https://github.com/MiniMax-AI/OpenAgentCore/blob/main/example/parsar/server/feishu.mjs) |
| 基于模板的托管 Environment | 带软件包、文件、`env` 和 `setup_commands` 的 `openai_hosted` | [创建 Session](api/public-agent-api.md#create-a-session) | [`server/runtime-profile.mjs`](https://github.com/MiniMax-AI/OpenAgentCore/blob/main/example/parsar/server/runtime-profile.mjs) |
| 可在崩溃后恢复的 Session 创建 | `Idempotency-Key`、响应丢失后的恢复 | [幂等性](api/public-agent-api.md#idempotency) | [`server/sessions.mjs`](https://github.com/MiniMax-AI/OpenAgentCore/blob/main/example/parsar/server/sessions.mjs) |
| 实时回复 | 事件流、文本增量、重连与状态协调 | [流式事件](api/public-agent-api.md#stream-events) | [`src/lib/live-session.ts`](https://github.com/MiniMax-AI/OpenAgentCore/blob/main/example/parsar/src/lib/live-session.ts) |
| 后续输入与取消 | 带幂等键的输入事件 | [发送输入](api/public-agent-api.md#send-input) | [`src/Composer.tsx`](https://github.com/MiniMax-AI/OpenAgentCore/blob/main/example/parsar/src/Composer.tsx) |
| 历史 | 分页读取 Turns 和 Items | [分页](api/public-agent-api.md#pagination) | [`src/lib/api.ts`](https://github.com/MiniMax-AI/OpenAgentCore/blob/main/example/parsar/src/lib/api.ts) |
| Skills 和版本 | `/skills`、默认版本 | [Skills](api/public-agent-api.md#skills) | [`src/Skills.tsx`](https://github.com/MiniMax-AI/OpenAgentCore/blob/main/example/parsar/src/Skills.tsx) |
| 连接自己的机器 | `x_agents_core.installation`、Environment 状态 | [运行自托管 Session](getting-started/self-hosted.md) | [`src/ConnectMachine.tsx`](https://github.com/MiniMax-AI/OpenAgentCore/blob/main/example/parsar/src/ConnectMachine.tsx) |

要贡献示例,请遵循[应用示例边界](https://github.com/MiniMax-AI/OpenAgentCore/blob/main/CONTRIBUTING.md#optional-application-example)。
Loading
Loading