Workspace Nodes
Applies to: ChengOS v0.2.0+ ｜ Last verified: 2026-09-25 ｜ Source:
crates/cheng-nodes/src/nodes/builtin/workspace
Two nodes that answer "where am I working". workspace/context resolves the current workspace and
hands its identity to downstream nodes, which is what workspace-scoped tools bind against.
workspace/knowledge_base selects, lists, or creates a knowledge base inside that workspace and emits
the id the RAG nodes expect. Wire these first when a graph mixes workspace tools with retrieval;
everything downstream depends on the ids they produce.
Workspace Context — workspace/context
Reads the current runtime workspace ID injected by the executor. Use this when a downstream node needs to consume the active workspace explicitly.
Inputs
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
workspaceId | string | — | — | Runtime workspace identifier (auto-injected) |
Outputs
| Field | Type | Description |
|---|---|---|
hasWorkspace | boolean | True iff a workspace was actually present in the runtime context. |
workspaceId | string | The resolved workspace ID, or empty string when the executor did not inject one (e.g. the workflow was triggered outside of any workspace). |
Knowledge Base — workspace/knowledge_base
Select, list, or create knowledge bases in a workspace
Inputs
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
mode | enum | — | select | select: Select existing KB; list: List all KBs in workspace; create: Create new KB. Control: select. Options: select, list, create |
kb_id | string | — | null | Knowledge base to select (select mode). Control: dynamic-select |
name | string | — | null | New knowledge base name (create mode) |
description | string | — | null | Knowledge base description (create mode, optional) |
embedding_model | string | — | null | Embedding model name (create mode, optional) |
Outputs
| Field | Type | Description |
|---|---|---|
success | boolean | Whether the operation succeeded. |
workspace_id | string | Workspace ID (for direct connection) |
kb_id | string | Knowledge base ID (for direct connection) |
knowledge_base | object | Single knowledge base info (select/create modes). |
knowledge_bases | array | List of knowledge bases (list mode). |
error | string | Error message if the operation failed. |