xiaoju
aad2792754
fix(hermes): disable ACP session/resume by default
...
Hermes ACP _restore fails for custom providers — resolve_runtime_provider
throws and base_url/api_mode are lost, causing resume to silently create a
new session with no history. Prompt then returns empty text or refusal.
Disable resume by default. Set UWF_HERMES_RESUME=1 to opt back in.
Includes investigation notes in docs/investigations/.
Refs #418
2026-05-23 07:23:14 +00:00
xiaoju
c60c310074
refactor: rename RoleDefinition fields for clarity
...
- identity → goal
- prepare → capabilities (string[])
- execute → procedure
- report → output
- outputSchema → meta
Fixes #364
2026-05-22 00:46:06 +00:00
xiaoju
7b9cb6a9c8
chore: rename uwf-* → workflow-*, cli-uwf → cli-workflow
...
Reclaim the workflow-* package names now that legacy packages are archived.
Package renames:
- @uncaged/uwf-protocol → @uncaged/workflow-protocol
- @uncaged/uwf-moderator → @uncaged/workflow-moderator
- @uncaged/uwf-agent-kit → @uncaged/workflow-agent-kit
- @uncaged/uwf-agent-hermes → @uncaged/workflow-agent-hermes
- @uncaged/cli-uwf → @uncaged/cli-workflow
All internal imports, tsconfig references, and docs updated.
CLI binary name 'uwf' unchanged.
小橘 🍊 (NEKO Team)
2026-05-19 07:52:16 +00:00
xiaoju
d63d58ccb5
chore: reorganize repo — legacy packages to legacy-packages/, templates to examples/
...
- Move 15 old workflow-* packages to legacy-packages/ (inactive, preserved for reference)
- Rename templates/ → examples/ for clarity
- Rewrite docs/architecture.md to reflect current uwf architecture
- Active packages remain in packages/: cli-uwf, uwf-agent-hermes, uwf-agent-kit, uwf-moderator, uwf-protocol, workflow-util
小橘 🍊 (NEKO Team)
2026-05-19 07:19:40 +00:00
jiayiyan
f08ba6914c
chore: remove .DS_Store and add to .gitignore
2026-05-18 21:35:40 +08:00
jiayiyan
f6dd4d59a1
docs: add office-agent document template spec and implementation plan
2026-05-18 21:26:11 +08:00
jiayiyan
20ddc5d7aa
docs(architecture): add workflow-agent-office, workflow-agent-docx-diff, workflow-template-document
...
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
2026-05-18 21:26:11 +08:00
xiaoju
08de1ae5eb
docs: fresh uwf-* packages, depend on @uncaged/json-cas, no reuse
2026-05-18 08:44:04 +00:00
xiaoju
c91a3d1ec6
docs: add description to condition definitions
2026-05-18 08:41:29 +00:00
xiaoju
13d932f69c
docs: config with provider/model/agent registries and alias-based overrides
2026-05-18 08:38:08 +00:00
xiaoju
f84d327410
docs: add .env for API keys, separate from config.yaml
2026-05-18 08:19:48 +00:00
xiaoju
9c2f93629b
docs: add models config (default + extract LLM)
2026-05-18 08:16:03 +00:00
xiaoju
bcefcb9af7
docs: add section 4 — key data types with shared StepRecord
2026-05-18 08:13:18 +00:00
xiaoju
b14dce2bc6
docs: fix inconsistencies — title, terminology, threads.yaml, JSONata context
2026-05-18 08:09:40 +00:00
xiaoju
85c572e770
docs: inline roles/moderator into Workflow, output as cas_ref, detail polymorphic
2026-05-18 08:07:20 +00:00
xiaoju
9a89885ce6
docs: rewrite CAS structure — flatten refs, named conditions, config.yaml, output naming
2026-05-18 07:55:04 +00:00
xiaoju
d095ceaafa
docs: agent CLI takes thread-id + role, outputs CAS hash, step owns pointer
2026-05-18 07:24:14 +00:00
xiaoju
2a0346f48b
docs: simplify show to pure thread-id → head query, all output JSON
2026-05-18 07:18:29 +00:00
xiaoju
b4e25ea002
docs: add done field to step output
2026-05-18 07:12:38 +00:00
xiaoju
77f2060e6b
docs: step on ended thread is an error, not null head
2026-05-18 07:11:50 +00:00
xiaoju
8f9a925179
docs: simplify step output to workflow/thread/head
2026-05-18 07:10:11 +00:00
xiaoju
a7eb9814ae
docs: fix agent invocation format in thread step
2026-05-18 07:05:35 +00:00
xiaoju
a8024e6d42
docs: use full 26-char Crockford Base32 ULIDs for thread IDs
2026-05-18 07:03:40 +00:00
xiaoju
6d94d9c85a
docs: fix hash format to 13-char Crockford Base32 (XXH64)
2026-05-18 07:03:02 +00:00
xiaoju
49a4d08c04
docs: add thread list --all and thread kill
2026-05-18 06:59:47 +00:00
xiaoju
d5773369af
docs: uwf thread subcommands, simplify start output
2026-05-18 06:58:35 +00:00
xiaoju
f49e014f41
docs: update CLI design — uwf naming, simplify commands and agent protocol
2026-05-18 06:56:55 +00:00
xiaoju
ab48a8169d
docs: add stateless workflow CLI design
...
Refs #297
2026-05-18 06:37:25 +00:00
xiaoju
11ba185fef
docs: RFC v3 — react adapter as thin wrapper over reactor
...
小橘 🍊
2026-05-13 02:19:12 +00:00
xiaoju
730340d123
docs: RFC v2 — AdapterFn replaces AgentFn, schema-aware resolve
...
小橘 🍊
2026-05-13 02:15:21 +00:00
xiaoju
c848216396
docs: RFC for workflow-agent-react package
...
小橘 🍊
2026-05-13 01:55:14 +00:00
xingyue
2c26be6ec6
docs: update graph visualization RFC — Phase 0 done ( #198 )
2026-05-12 10:13:39 +08:00
xingyue
0fe17b0fb2
docs: workflow graph visualization design plan ( #198 )
2026-05-12 09:38:58 +08:00
xiaoju
82d9abf260
rfc: Merkle Call Stack — cross-thread DAG linking
...
Design doc for parent-child workflow Merkle linking:
- StartNodePayload.parentState: child → parent head state at spawn time
- StateNodePayload.childThread: parent → child final state hash
- Both also in refs[] for GC reachability
- 4-phase implementation plan
小橘 <xiaoju@shazhou.work >
2026-05-12 01:29:38 +00:00
xiaoju
e29d1bf345
feat: Phase 5 — CLI + Dashboard CAS adaptation, cleanup .data.jsonl
...
- Align REST API contracts for Dashboard (threads list, detail, SSE)
- Add content resolution from CAS in thread show + API responses
- Rename dataWatcher → threadsJsonWatcher in SSE routes
- Update docs (CLAUDE.md, architecture.md, skill.ts) to reflect CAS storage
- Zero .data.jsonl code paths in production code
- All 166 tests pass, bun run check clean
Refs #155 , closes #160
小橘 <xiaoju@shazhou.work >
2026-05-09 08:16:04 +00:00
xiaoju
8f78a00063
docs: RFC v3 — named payload fields, refs as GC index, merge parent+ancestors
...
- payload is source of truth with named fields (start, content, ancestors, compact)
- refs[] auto-derived by collectRefs(), pure GC index
- parent merged into ancestors[0]
小橘 <xiaoju@shazhou.work >
2026-05-09 07:12:29 +00:00
xiaoju
6c2a137aef
docs: update CAS thread storage RFC
...
- StartNode prompt via refs[0] instead of inline
- threads.json active-only, completed → history/{date}.jsonl
- Content Merkle node carries role artifact refs
- Extract phase expanded to produce refs[]
小橘 <xiaoju@shazhou.work >
2026-05-09 07:08:10 +00:00
xiaoju
6cd856ca99
docs: add RFC for CAS-based thread storage
...
小橘 <xiaoju@shazhou.work >
2026-05-09 06:34:24 +00:00
xiaoju
064696c558
docs: update architecture docs and package READMEs for post-split structure
...
- Rewrite docs/architecture.md with 15-package map, dependency graph, updated engine paths
- Update CLAUDE.md monorepo structure section
- Add READMEs for: workflow-protocol, workflow-runtime, workflow-util, workflow-cas, workflow-register, workflow-execute, workflow-reactor
- Fix agent READMEs: update deps from @uncaged/workflow to actual packages
- Mark workflow-as-agent plan as outdated
Fixes #153
小橘 <xiaoju@shazhou.work >
2026-05-09 04:39:57 +00:00
xiaoju
4a925b98af
docs: create README.md, update architecture.md for current structure
...
- Create root README.md with project intro, concepts, packages, quickstart
- Remove workflow-role-* references from docs/architecture.md
- Roles now live inside template packages (src/roles/)
- Clean up untracked dist/packages/workflow-role-* remnants
Fixes #88
2026-05-07 16:10:37 +00:00
xiaoju
c096f4d94e
docs: add workflow-as-agent implementation plan
...
Covers 4 phases:
1. Global CAS migration
2. RoleStep refs tracking
3. CAS garbage collection
4. workflowAsAgent(name) factory
Refs #25
2026-05-07 10:35:26 +00:00
xiaoju
7926751b01
docs: replace RFC-001 with up-to-date architecture doc
...
RFC-001 was severely outdated (pre-refactor types). New architecture.md
covers the current three-phase engine, pure data roles, AgentBinding,
ExtractFn, and all design decisions.
小橘 <xiaoju@shazhou.work >
2026-05-07 01:45:51 +00:00
xiaoju
2482fb7e62
chore: remove all dryRun infrastructure
...
dryRun no longer needed — tests use mock agents + mock fetch instead.
Removes isDryRun from WorkflowFnOptions, dryRun from ExtractConfig,
dryRunMeta from RoleDefinition, --dry-run from CLI, and all related
plumbing in engine/worker/fork/extract.
小橘 <xiaoju@shazhou.work >
2026-05-06 14:25:44 +00:00
xiaoju
3467b772e6
refactor: named exports (run + descriptor), remove build pipeline
...
- Bundle contract: export const run + export const descriptor (no default export)
- add only accepts .esm.js, extracts descriptor via dynamic import → .yaml
- Removed: build-pipeline, generate-types, json-schema-to-ts
- Worker loads mod.run instead of mod.default
- Biome: no more noDefaultExport overrides for bundles
- 62 tests pass, biome clean
Closes #8
小橘 <xiaoju@shazhou.work >
2026-05-06 06:39:15 +00:00
xiaoju
9a4cec2b2d
docs(rfc-001): WorkflowFn input → ThreadInput for fork/resume support
...
- First param is now { prompt, steps } instead of bare prompt
- steps: [] for new thread, pre-filled for fork/resume
- createRoleModerator naturally handles resume via moderator routing
- No special replay logic needed
小橘 <xiaoju@shazhou.work >
2026-05-06 05:25:00 +00:00
xiaoju
eda00d1c8e
docs(rfc-001): bundle contract → AsyncGenerator, Role/Moderator → helper pattern
...
Breaking design change:
- Section 2: WorkflowFn is now an AsyncGenerator that yields RoleOutput
- Section 8: Role/Moderator demoted from contract to optional helper
- Engine controls the loop via generator protocol (DIP)
- Zero injection — bundles don't import engine types
小橘 <xiaoju@shazhou.work >
2026-05-06 05:18:56 +00:00
xiaoju
01e930df8f
docs(rfc-001): add execution model — Role, Moderator, Agent types
...
Ported from nerve's workflow types. Covers ThreadContext, StartStep,
RoleStep, Moderator (pure router), Role (async actor), AgentFn (LLM adapter),
WorkflowDefinition, and execution flow.
小橘 <xiaoju@shazhou.work >
2026-05-06 04:41:52 +00:00
xiaoju
8939194133
init: bun workspace + RFC-001 workflow engine design
...
- @uncaged/workflow (core lib) + @uncaged/cli-workflow (CLI)
- RFC-001: full design doc covering storage, threading, CLI
小橘 <xiaoju@shazhou.work >
2026-05-06 04:20:05 +00:00