dsh-fabric
为 DeepSeek Harness 提供 Fabric 风格的确定性压缩、活动、拓扑、代码运行时、网格和参与者功能
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-fabric@0.1.12Fabric 以 dsh-fabric 发布，当前版本为 0.1.12。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Fabric-style capabilities for DeepSeek Harness
Deterministic compaction, checked code execution, durable coordination, and live topology — delivered as native DSH plugins.
dsh-fabric adapts the most useful ideas from pi-fabric to DeepSeek Harness without creating a parallel runtime. DSH ToolRuntime remains the tool and policy authority, Cordis owns component lifecycle, and Fabric adds focused providers for compaction, code execution, coordination, projections, and browser UI.
| Capability | What it unlocks | |
|---|---|---|
| 🧠 | Deterministic compaction | Structured, bounded summaries without a second model request. |
| ⚡ | Checked Code Mode | TypeScript validation followed by isolated QuickJS execution with strict budgets. |
| 🏎️ | Speculative PTC | Literal read, glob, and grep calls start while run_code is still streaming, then commit only at the natural policy gate. |
| 🕸️ | Durable mesh | Topics, compare-and-swap state, and crash-conservative actor mailboxes. |
| 📡 | Unified activity | Fabric, workflow, and compaction events projected into one chronological surface. |
| 🗺️ | Live topology | Portable participants and mesh resources in a grouped tree, with message flow kept as traffic overlays. |
| 🧩 | Native composition | External DSH plugins — no second tool registry, lifecycle, or React business-state store. |
flowchart LR
Model[Model] --> TR[DSH ToolRuntime]
TR --> QJS[Checked QuickJS]
TR --> Mesh[Fabric Mesh]
Mesh --> Store[(storage-domain)]
DSH[DSH events] --> Host[Fabric host projection]
Mesh --> Host
Host --> UI[Activity + Topology UI]
Compiler[Deterministic compiler] --> Compact[DSH compaction transaction]
DSH --> Compiler
The installable workspace bundle masks the inherited code runtime, stock compactor/pruner, and shipped preset roster. It then mounts Fabric's QuickJS provider, deterministic compaction engine, Fabric-owned presets, mesh provider, host projection, and client surfaces under eight composed rows. The Fabric mesh Consumer, the fabric_models Consumer, and the Fabric system-prompt overlay are NOT host rows: they mount inside the fabric preset itself, so their prompt surfaces stay fabric-scoped and no other preset's system prompt is touched. The Fabric-owned roster keeps the four pinned DSH modes and adds a fifth, fabric: Fabric mode uses the Code Mode SDK under its own preset identity and selects runCodeLabel: inferred, so code is the only required outer argument, an explicit description still wins, and otherwise one deterministic title derived from the logged program serves the call card and compaction. Fabric sessions record and display as Fabric mode instead of reusing PTC mode.
| Package | Responsibility |
|---|---|
dsh-fabric-protocol | Host-independent participant, activity, topology, mesh, and actor records. |
dsh-fabric-compaction | Deterministic summary compiler, DSH CompactionEngine, and masked preset roster. |
dsh-fabric-host | Durable-event adapter and bounded session projection. |
dsh-fabric-system-prompt | Fabric-owned system prompt override and native-prose minimization. |
| dsh-fabric-mesh | Topics, CAS state, actor mailboxes, and the fabric_mesh Consumer. |
| dsh-fabric-models | Session model inspection and alias-aware switching through the fabric_models Consumer. |
| dsh-fabric-schema | Schema-enforced world state and root-scoped certification: exact observation allowlist, fail-closed containment of all ToolRuntime effects, and same-run_code hypothesis → certificate → atomic commit transactions with enforce/audit modes. |
| dsh-fabric-code-runtime-quickjs | Checked QuickJS CodeRuntime provider with execution budgets. |
| dsh-fabric-client-ui | Browser Activity, Topology, popup metrics, subagent navigation, and persistent Schema/speculation settings cards. |
Requirements: Node.js ^22.19.0 || >=24, Bun 1.4+, and DSH 0.1.0-rc.7.
Clone the repository and install it into your local DSH web profile:
git clone https://github.com/monotykamary/dsh-fabric.git
cd dsh-fabric
bun install
bun run install:local
The installer builds all packages, links the bundle and its nine packages, and validates the composed plugin graph. It does not start or restart DSH. The plugin graph takes effect on the next profile load.
# Target another profile
bun run install:local -- --profile tui
# Target another DSH home
DSH_HOME=/path/to/dsh-home bun run install:local -- --profile web
# Reuse existing build output
bun run install:local -- --skip-build
# Restore the exact dependency specifications that existed before install
bun run uninstall:local
Use the same --profile or DSH_HOME selection when uninstalling. Without its ownership-state file, the uninstaller refuses to remove packages unless this checkout's exact local links prove ownership.
Installing the bundle replaces the verbose native DSH prompt prose with a minimized Fabric operating prompt:
fabric:system-prompt section (right after the persona) captures pi-fabric's long-horizon disciplines and gives the model the exact one-off tools.subagent({ description, prompt, provider, model }) recipe, background-first continuable lifecycle, and fresh-versus-fork choice.system-prompt/assemble waterfall listener drops redundant native per-tool guidance while preserving the persona, trusted user:system-instructions, plan policy, reporting, Code-Mode SDK/collapse sections, memory, and mesh guidance. The minimized SDK keeps full core contracts, replaces optional schemas with a names-only JSON roster, and retains DSH ToolRuntime's run-scoped tools.describe/tools.call declarations for exact discovery.todo_write, create_goal/get_goal/update_goal, /goal, the goal round driver, and the goal bar) are masked. Long-horizon objectives and progress belong in fabric_mesh instead of same-session todo/goal records.session_search, session_event_search, and the session_trace/session_event_trace/session_event_read readers) over a durable SQLite FTS5 index, with fabric:memory-guidance prompt guidance for re-establishing dropped context after /compact./delegate [--provider <id> --model <id>] [--fork] <task> through the ordinary slash-command UI, starting one background child without a parent model turn.Fabric enables DSH ToolRuntime's speculative Code Mode path while the Harness-wide default remains off. During streamed TypeScript run_code arguments, a lazy literal scanner recognizes complete tools.read(...), tools.glob(...), and tools.grep(...) calls whose arguments are static JSON and launches their definition-owned speculate callbacks early. Dynamic expressions and Python programs stay on the authoritative natural path.
The prefetched work never bypasses policy or writes duplicate lifecycle records. Definitions must opt in with risk: "read", effectKind: "none", and a speculate callback. An unforgeable streamed-root owner prevents reused provider call IDs from crossing sessions/steps, and final arguments must contain exactly one top-level code string identical to the streamed program. The eventual SDK call still traverses DSH's pre-execute, guards, around-dispatch, post-execute, finalization, and durable event pipeline. Definition identity, per-owner mutation epoch, freshness, cancellation, and take-once consumption remain authoritative. Hidden filesystem acquisitions are confined to the canonical session workspace; outside targets fall back to the naturally policy-authorized call. read validates the observed file version and replays fs/observed only after admission. glob and grep rerun their complete acquisition at serve time and reuse output only when the canonical result is unchanged, without running direct-call spill projection early. Any miss or invalidation performs the ordinary tool body.
The Speculative Code Mode card under Settings → Plugins edits the live tool-speculation namespace: enablement, concurrent work, retained entries, stream-buffer bytes, aggregate retained-result bytes, and entry TTL. Saving new bounds cancels unserved hidden work before applying them. The adjacent Fabric Schema card remains the persistent authority for new-session Schema defaults.
fabric_mesh toolOne Consumer exposes durable coordination through a compact action protocol:
| Primitive | Actions | Guarantee |
|---|---|---|
| Topics | create_topic, publish, read_topic, prune_topic | Storage-backed ordered messages with explicit retention. |
| State | get_state, cas_state | Revision-checked updates; revision 0 creates an absent key. |
| Actors | create_actor, send_actor, read_mailbox | Durable command queues addressed to stable actors. |
| Claims | claim_actor_message, settle_actor_message | Token-fenced settlement and replay-safe terminal outcomes. |
| Discovery | snapshot | Bounded metadata for rediscovering durable coordination state. |
Actor claims are deliberately crash-conservative. A claimed command stays claimed after process failure, settlement requires the opaque claim token, and retrying the same settlement returns the stored result rather than executing twice.
Mesh records are isolated by one workspace identity shared by prompt assembly and tool execution: registered workspace membership or canonical path ownership takes precedence, followed by an unregistered path digest and finally a session-only scope when no cwd exists.
Fabric becomes the only composed compaction backend while preserving DSH's /compact command, durable transaction, token meter, and backend-independent invariants.
/compact.TOOL_OUTCOME_UNKNOWN instead of trusting conversational memory.See ADAPTATION_SWEEP.md for the reuse matrix, acceptance evidence, and deferred parity surfaces.
Fabric contributes two bilingual cards under Settings → Plugins — Fabric Schema and Speculative Code Mode — and adds a conversation tab with:
Main → Participants → {Sessions, Agents, Actors} and Main → Mesh → {Topics, State};FabricParticipantRecord is the portable semantic identity used by the UI. The DSH session mirror and Fabric actor records remain lifecycle authorities; the adapter does not introduce a second executor, registry, or client business-state store. Workflow, phase, message, and compaction facts remain available in Activity without crowding the topology.
Business state remains in DSH and storage-domain. Client-local state is limited to view selection, filters, expansion, and viewport state.
Hot reload requires both watchers:
bun run dev:web.bun run watch:client to rebuild packages/client-ui/lib/client.js.A running server alone does not compile this repository, and the first installation of a new profile row requires a later profile load.
bun install
# Optional when co-developing against a sibling ../deepseek-harness checkout
bun run link:harness
bun run check
bun run check type-checks, builds, tests, and verifies the complete workspace. The QuickJS provider enforces fresh contexts, JSON bridge validation, deadlines, cancellation, memory/stack/output budgets, and quiescent disposal.
This is a focused DSH adaptation, not literal pi-fabric parity. Known constraints include:
tool/result.meta and tool/code-dispatch events. Only legacy logs written with the retired required fabric/activity event remain incompatible with DSH 0.1.0-rc.6's static persisted-event allowlist.CodeRunRequest omits the generated SDK declaration prelude, so QuickJS checks namespace/member existence and normal TypeScript semantics while ToolRuntime remains the authoritative argument/result validator.0.1.0-rc.6 and must be reviewed on host upgrades.fabric preset, not pi-fabric's tiered transcript index: regex query mode, pi's Fabric-operation filters, and a session-list browse tool are not ported.MIT © Tom Nguyen. See THIRD_PARTY_NOTICES.md.