shazhou/united-workforce
8
0
Fork 0
Code Issues 8 Pull Requests 2 Actions Packages Projects Releases Wiki Activity

refactor: rebrand npm packages @uncaged/* → @united-workforce/*
CI / check (pull_request) Failing after 9m51s
Details

Browse Source 
Package mapping:
- @uncaged/cli-workflow → @united-workforce/cli
- @uncaged/workflow-protocol → @united-workforce/protocol
- @uncaged/workflow-util → @united-workforce/util
- @uncaged/workflow-util-agent → @united-workforce/util-agent
- @uncaged/workflow-agent-hermes → @united-workforce/agent-hermes
- @uncaged/workflow-agent-claude-code → @united-workforce/agent-claude-code
- @uncaged/workflow-agent-builtin → @united-workforce/agent-builtin
- @uncaged/workflow-dashboard → @united-workforce/dashboard

Changes:
- 8 package.json name + dependency refs
- 82 files: import statements updated
- .changeset/config.json updated
- CLAUDE.md updated
- bunfig.toml restored for preload

CLI command (uwf) and directory names unchanged.

Closes shazhou/united-workforce#8
This commit is contained in:
星月
2026-06-02 20:56:06 +08:00
parent 7b1db96d7e
commit e067a2f25a
82 changed files with 169 additions and 166 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.changeset/config.json
+2 -2
View File
@@ -2,10 +2,10 @@
"$schema": "https://unpkg.com/@changesets/config@3.1.4/schema.json",
"changelog": "@changesets/cli/changelog",
"commit": false,
"fixed": [["@uncaged/*"]],
"fixed": [["@united-workforce/*"]],
"linked": [],
"access": "public",
"baseBranch": "main",
"updateInternalDependencies": "patch",
"ignore": ["@uncaged/workflow-dashboard"]
"ignore": ["@united-workforce/dashboard"]
}
CLAUDE.md
+13 -10
View File
@@ -21,11 +21,14 @@ This monorepo implements a stateless workflow engine driven by a single-step CLI
```
workflow/
packages/
workflow-protocol/ # @uncaged/workflow-protocol — shared types (WorkflowPayload, StepNodePayload, WorkflowConfig, etc.)
workflow-util/ # @uncaged/workflow-util — Crockford Base32, ULID, logger, frontmatter parsing/validation
workflow-util-agent/ # @uncaged/workflow-util-agent — createAgent factory, context builder, extract pipeline
workflow-agent-hermes/ # @uncaged/workflow-agent-hermes — uwf-hermes CLI binary (spawns hermes chat)
cli-workflow/ # @uncaged/cli-workflow — uwf CLI binary (includes status-based moderator in src/moderator/)
workflow-protocol/ # @united-workforce/protocol — shared types (WorkflowPayload, StepNodePayload, WorkflowConfig, etc.)
workflow-util/ # @united-workforce/util — Crockford Base32, ULID, logger, frontmatter parsing/validation
workflow-util-agent/ # @united-workforce/util-agent — createAgent factory, context builder, extract pipeline
workflow-agent-hermes/ # @united-workforce/agent-hermes — uwf-hermes CLI binary (spawns hermes chat)
workflow-agent-claude-code/ # @united-workforce/agent-claude-code — uwf-claude-code CLI binary
workflow-agent-builtin/ # @united-workforce/agent-builtin — uwf-builtin CLI binary
cli-workflow/ # @united-workforce/cli — uwf CLI binary (includes status-based moderator in src/moderator/)
workflow-dashboard/ # @united-workforce/dashboard — web dashboard (private, not published)
legacy-packages/ # Archived packages (preserved for reference, not active)
examples/ # Workflow YAML examples (solve-issue.yaml)
docs/ # Architecture docs
@@ -33,7 +36,7 @@ workflow/
tsconfig.json # root TypeScript config
```
- Dependency layers: `workflow-protocol` → `workflow-util` → `workflow-util-agent` → `workflow-agent-hermes` / `cli-workflow`
- Dependency layers: `workflow-protocol` → `workflow-util` → `workflow-util-agent` → `workflow-agent-hermes` / `workflow-agent-claude-code` / `workflow-agent-builtin` / `cli-workflow`
- Packages use `workspace:^` protocol (resolves to `^x.y.z` on publish)
- External CAS: `@ocas/core` (store API, hashing, schema validation) + `@ocas/fs` (filesystem backend)
@@ -173,10 +176,10 @@ type Result<T, E = Error> = { ok: true; value: T } | { ok: false; error: E };
Never use `console.log/warn/error` directly — Biome's `noConsole` rule enforces this.
All logging goes through the structured logger from `@uncaged/workflow-util`:
All logging goes through the structured logger from `@united-workforce/util`:
```typescript
import { createLogger } from "@uncaged/workflow-util";
import { createLogger } from "@united-workforce/util";
const log = createLogger();
@@ -202,7 +205,7 @@ log("7BQST3VW", `Role ${role} started`);
### CLI entry point exception
The CLI package (`@uncaged/cli-workflow`) may use `console.log` for user-facing output only. Suppress with:
The CLI package (`@united-workforce/cli`) may use `console.log` for user-facing output only. Suppress with:
```typescript
// biome-ignore lint/nursery/noConsole: CLI user-facing output
@@ -243,7 +246,7 @@ bun test # must pass — all package tests
### Publishing
All public `@uncaged/*` packages are published to **npmjs.org** with **fixed mode** (all packages share the same version number).
All public `@united-workforce/*` packages are published to **npmjs.org** with **fixed mode** (all packages share the same version number).
```bash
# 1. Add a changeset describing the change
package.json
+2 -2
View File
@@ -1,5 +1,5 @@
{
"name": "@uncaged/workflow-monorepo",
"name": "@united-workforce/monorepo",
"private": true,
"packageManager": "bun@1.3.14",
"workspaces": [
@@ -25,7 +25,7 @@
"@changesets/cli": "^2.31.0",
"@types/node": "^25.7.0",
"@types/xxhashjs": "^0.2.4",
"@uncaged/workflow-agent-hermes": "workspace:*",
"@united-workforce/agent-hermes": "workspace:*",
"bun-types": "^1.3.13",
"typescript": "^5.8.3",
"yaml": "^2.9.0"
packages/cli-workflow/README.md
+4 -4
View File
@@ -1,4 +1,4 @@
# @uncaged/cli-workflow
# @united-workforce/cli
`uwf` CLI — thread lifecycle, workflow registry, CAS inspection, and setup.
@@ -20,14 +20,14 @@ workflow → thread → step → turn
This package has no library `src/index.ts` — it is consumed as a CLI binary only.
**Dependencies:** `@ocas/core`, `@ocas/fs`, `@uncaged/workflow-util-agent`, `@uncaged/workflow-protocol`, `@uncaged/workflow-util`, `commander`, `dotenv`, `mustache`, `yaml`
**Dependencies:** `@ocas/core`, `@ocas/fs`, `@united-workforce/util-agent`, `@united-workforce/protocol`, `@united-workforce/util`, `commander`, `dotenv`, `mustache`, `yaml`
## Installation
Included as the `uwf` binary when you install `@uncaged/cli-workflow`:
Included as the `uwf` binary when you install `@united-workforce/cli`:
```bash
bun add -g @uncaged/cli-workflow
bun add -g @united-workforce/cli
# or from the monorepo:
bun link packages/cli-workflow
```
packages/cli-workflow/package.json
+4 -4
View File
@@ -1,5 +1,5 @@
{
"name": "@uncaged/cli-workflow",
"name": "@united-workforce/cli",
"version": "0.5.0",
"files": [
"src",
@@ -13,9 +13,9 @@
"dependencies": {
"@ocas/core": "^0.1.1",
"@ocas/fs": "^0.1.1",
"@uncaged/workflow-protocol": "workspace:^",
"@uncaged/workflow-util": "workspace:^",
"@uncaged/workflow-util-agent": "workspace:^",
"@united-workforce/protocol": "workspace:^",
"@united-workforce/util": "workspace:^",
"@united-workforce/util-agent": "workspace:^",
"commander": "^14.0.3",
"dotenv": "^16.6.1",
"mustache": "^4.2.0",
packages/cli-workflow/src/__tests__/adapter-json-roundtrip.test.ts
+1 -1
View File
@@ -5,7 +5,7 @@ import { tmpdir } from "node:os";
import { join } from "node:path";
import { putSchema } from "@ocas/core";
import { createFsStore } from "@ocas/fs";
import type { CasRef, StepNodePayload, ThreadId } from "@uncaged/workflow-protocol";
import type { CasRef, StepNodePayload, ThreadId } from "@united-workforce/protocol";
import { registerUwfSchemas } from "../schemas.js";
import { saveThreadsIndex } from "../store.js";
packages/cli-workflow/src/__tests__/current-role.test.ts
+1 -1
View File
@@ -3,7 +3,7 @@ import { mkdir, rm, writeFile } from "node:fs/promises";
import { tmpdir } from "node:os";
import { join } from "node:path";
import { putSchema } from "@ocas/core";
import type { CasRef, ThreadId } from "@uncaged/workflow-protocol";
import type { CasRef, ThreadId } from "@united-workforce/protocol";
import { createMarker, deleteMarker } from "../background/index.js";
import { cmdThreadList, cmdThreadShow, cmdThreadStart } from "../commands/thread.js";
import {
packages/cli-workflow/src/__tests__/moderator-evaluate.test.ts
+1 -1
View File
@@ -1,5 +1,5 @@
import { describe, expect, test } from "bun:test";
import type { Target, WorkflowPayload } from "@uncaged/workflow-protocol";
import type { Target, WorkflowPayload } from "@united-workforce/protocol";
import { evaluate } from "../moderator/evaluate.js";
packages/cli-workflow/src/__tests__/resolve-head-hash.test.ts
+1 -1
View File
@@ -2,7 +2,7 @@ import { afterEach, beforeEach, describe, expect, test } from "bun:test";
import { mkdtemp, rm } from "node:fs/promises";
import { tmpdir } from "node:os";
import { join } from "node:path";
import type { CasRef, ThreadId } from "@uncaged/workflow-protocol";
import type { CasRef, ThreadId } from "@united-workforce/protocol";
import { resolveHeadHash } from "../commands/shared.js";
import { appendThreadHistory, saveThreadsIndex } from "../store.js";
packages/cli-workflow/src/__tests__/solve-issue-tea-worktree.test.ts
+1 -1
View File
@@ -1,7 +1,7 @@
import { describe, expect, test } from "bun:test";
import { readFile } from "node:fs/promises";
import { join } from "node:path";
import type { WorkflowPayload } from "@uncaged/workflow-protocol";
import type { WorkflowPayload } from "@united-workforce/protocol";
import { parse } from "yaml";
/**
packages/cli-workflow/src/__tests__/step-read.test.ts
+1 -1
View File
@@ -4,7 +4,7 @@ import { tmpdir } from "node:os";
import { join } from "node:path";
import { bootstrap, putSchema } from "@ocas/core";
import { createFsStore } from "@ocas/fs";
import type { CasRef } from "@uncaged/workflow-protocol";
import type { CasRef } from "@united-workforce/protocol";
import { cmdStepRead } from "../commands/step.js";
import { registerUwfSchemas } from "../schemas.js";
packages/cli-workflow/src/__tests__/step-show-json.test.ts
+1 -1
View File
@@ -4,7 +4,7 @@ import { tmpdir } from "node:os";
import { join } from "node:path";
import { bootstrap, type Hash, type JSONSchema, putSchema } from "@ocas/core";
import { createFsStore } from "@ocas/fs";
import type { CasRef, StepNodePayload } from "@uncaged/workflow-protocol";
import type { CasRef, StepNodePayload } from "@united-workforce/protocol";
import { cmdStepShow } from "../commands/step.js";
import { formatOutput } from "../format.js";
import { registerUwfSchemas } from "../schemas.js";
packages/cli-workflow/src/__tests__/step-timing.test.ts
+5 -5
View File
@@ -4,8 +4,8 @@ import { tmpdir } from "node:os";
import { join } from "node:path";
import { bootstrap, putSchema } from "@ocas/core";
import { createFsStore } from "@ocas/fs";
import type { CasRef, ThreadId } from "@uncaged/workflow-protocol";
import { STEP_NODE_SCHEMA } from "@uncaged/workflow-protocol";
import type { CasRef, ThreadId } from "@united-workforce/protocol";
import { STEP_NODE_SCHEMA } from "@united-workforce/protocol";
import { cmdStepList } from "../commands/step.js";
import { cmdThreadRead } from "../commands/thread.js";
import { registerUwfSchemas } from "../schemas.js";
@@ -86,7 +86,7 @@ afterEach(async () => {
describe("protocol types", () => {
test("StepRecord has startedAtMs and completedAtMs as required fields", () => {
// Type-level test: this block compiles only if fields exist and are number
const record: import("@uncaged/workflow-protocol").StepRecord = {
const record: import("@united-workforce/protocol").StepRecord = {
role: "test",
output: "hash1" as CasRef,
detail: "hash2" as CasRef,
@@ -102,7 +102,7 @@ describe("protocol types", () => {
});
test("StepEntry has durationMs as required field", () => {
const entry: import("@uncaged/workflow-protocol").StepEntry = {
const entry: import("@united-workforce/protocol").StepEntry = {
hash: "hash" as CasRef,
role: "test",
output: {},
@@ -222,7 +222,7 @@ describe("step list timing", () => {
const stepEntries = result.steps.slice(1); // skip start entry
expect(stepEntries).toHaveLength(1);
const step = stepEntries[0] as import("@uncaged/workflow-protocol").StepEntry;
const step = stepEntries[0] as import("@united-workforce/protocol").StepEntry;
expect(step.durationMs).toBe(3500);
});
});
packages/cli-workflow/src/__tests__/thread-cancel-status.test.ts
+1 -1
View File
@@ -2,7 +2,7 @@ import { describe, expect, test } from "bun:test";
import { mkdtemp } from "node:fs/promises";
import { tmpdir } from "node:os";
import { join } from "node:path";
import type { CasRef, ThreadId } from "@uncaged/workflow-protocol";
import type { CasRef, ThreadId } from "@united-workforce/protocol";
import { appendThreadHistory, loadThreadHistory } from "../store.js";
describe("thread cancel status", () => {
packages/cli-workflow/src/__tests__/thread-list-filters.test.ts
+3 -3
View File
@@ -2,9 +2,9 @@ import { afterEach, beforeEach, describe, expect, test } from "bun:test";
import { mkdir, mkdtemp, rm } from "node:fs/promises";
import { tmpdir } from "node:os";
import { join } from "node:path";
import type { CasRef, ThreadId } from "@uncaged/workflow-protocol";
import { createThreadIndexEntry } from "@uncaged/workflow-protocol";
import { extractUlidTimestamp, generateUlid } from "@uncaged/workflow-util";
import type { CasRef, ThreadId } from "@united-workforce/protocol";
import { createThreadIndexEntry } from "@united-workforce/protocol";
import { extractUlidTimestamp, generateUlid } from "@united-workforce/util";
import { createMarker, deleteMarker } from "../background/index.js";
import { cmdThreadList } from "../commands/thread.js";
import { parseTimeInput } from "../commands/thread-time-parser.js";
packages/cli-workflow/src/__tests__/thread-location.test.ts
+1 -1
View File
@@ -2,7 +2,7 @@ import { describe, expect, test } from "bun:test";
import { mkdir, rm, writeFile } from "node:fs/promises";
import { tmpdir } from "node:os";
import { join } from "node:path";
import type { CasRef, StartNodePayload, ThreadId } from "@uncaged/workflow-protocol";
import type { CasRef, StartNodePayload, ThreadId } from "@united-workforce/protocol";
import { cmdThreadStart } from "../commands/thread.js";
import { createUwfStore } from "../store.js";
packages/cli-workflow/src/__tests__/thread-read-quota.test.ts
+1 -1
View File
@@ -4,7 +4,7 @@ import { tmpdir } from "node:os";
import { join } from "node:path";
import { bootstrap, putSchema } from "@ocas/core";
import { createFsStore } from "@ocas/fs";
import type { CasRef, ThreadId } from "@uncaged/workflow-protocol";
import type { CasRef, ThreadId } from "@united-workforce/protocol";
import { cmdThreadRead } from "../commands/thread.js";
import { registerUwfSchemas } from "../schemas.js";
import { saveThreadsIndex } from "../store.js";
packages/cli-workflow/src/__tests__/thread-read-xml-tags.test.ts
+1 -1
View File
@@ -4,7 +4,7 @@ import { tmpdir } from "node:os";
import { join } from "node:path";
import { bootstrap, putSchema } from "@ocas/core";
import { createFsStore } from "@ocas/fs";
import type { CasRef, ThreadId } from "@uncaged/workflow-protocol";
import type { CasRef, ThreadId } from "@united-workforce/protocol";
import { cmdThreadRead, THREAD_READ_DEFAULT_QUOTA } from "../commands/thread.js";
import { registerUwfSchemas } from "../schemas.js";
import type { UwfStore } from "../store.js";
packages/cli-workflow/src/__tests__/thread-resume.test.ts
+1 -1
View File
@@ -5,7 +5,7 @@ import { tmpdir } from "node:os";
import { join } from "node:path";
import { putSchema } from "@ocas/core";
import { createFsStore } from "@ocas/fs";
import type { CasRef, StepNodePayload, ThreadId } from "@uncaged/workflow-protocol";
import type { CasRef, StepNodePayload, ThreadId } from "@united-workforce/protocol";
import { parse } from "yaml";
import { cmdThreadShow } from "../commands/thread.js";
import { registerUwfSchemas } from "../schemas.js";
packages/cli-workflow/src/__tests__/thread-show-status.test.ts
+1 -1
View File
@@ -3,7 +3,7 @@ import { mkdir, rm, writeFile } from "node:fs/promises";
import { tmpdir } from "node:os";
import { join } from "node:path";
import { putSchema } from "@ocas/core";
import type { CasRef, ThreadId } from "@uncaged/workflow-protocol";
import type { CasRef, ThreadId } from "@united-workforce/protocol";
import { createMarker, deleteMarker } from "../background/index.js";
import { cmdThreadShow, cmdThreadStart } from "../commands/thread.js";
import {
packages/cli-workflow/src/__tests__/thread-start-cwd-cli.test.ts
+1 -1
View File
@@ -3,7 +3,7 @@ import { execFileSync } from "node:child_process";
import { mkdir, rm, writeFile } from "node:fs/promises";
import { tmpdir } from "node:os";
import { join } from "node:path";
import type { CasRef, StartNodePayload, ThreadId } from "@uncaged/workflow-protocol";
import type { CasRef, StartNodePayload, ThreadId } from "@united-workforce/protocol";
import { cmdThreadStart } from "../commands/thread.js";
import { createUwfStore, loadThreadsIndex } from "../store.js";
packages/cli-workflow/src/__tests__/thread-suspend-step.test.ts
+1 -1
View File
@@ -5,7 +5,7 @@ import { tmpdir } from "node:os";
import { join } from "node:path";
import { putSchema } from "@ocas/core";
import { createFsStore } from "@ocas/fs";
import type { CasRef, StepNodePayload, ThreadId } from "@uncaged/workflow-protocol";
import type { CasRef, StepNodePayload, ThreadId } from "@united-workforce/protocol";
import { parse } from "yaml";
import { cmdThreadShow } from "../commands/thread.js";
import { registerUwfSchemas } from "../schemas.js";
packages/cli-workflow/src/__tests__/thread-suspended-display.test.ts
+2 -2
View File
@@ -3,8 +3,8 @@ import { mkdir, mkdtemp, rm } from "node:fs/promises";
import { tmpdir } from "node:os";
import { join } from "node:path";
import { putSchema } from "@ocas/core";
import type { ThreadId } from "@uncaged/workflow-protocol";
import { createThreadIndexEntry, markThreadSuspended } from "@uncaged/workflow-protocol";
import type { ThreadId } from "@united-workforce/protocol";
import { createThreadIndexEntry, markThreadSuspended } from "@united-workforce/protocol";
import { cmdThreadList, cmdThreadShow } from "../commands/thread.js";
import { createUwfStore, saveThreadsIndex } from "../store.js";
packages/cli-workflow/src/__tests__/thread.test.ts
+1 -1
View File
@@ -4,7 +4,7 @@ import { tmpdir } from "node:os";
import { join } from "node:path";
import { bootstrap, putSchema } from "@ocas/core";
import { createFsStore } from "@ocas/fs";
import type { CasRef, ThreadId } from "@uncaged/workflow-protocol";
import type { CasRef, ThreadId } from "@united-workforce/protocol";
import { cmdStepList, cmdStepShow } from "../commands/step.js";
import {
cmdThreadRead,
packages/cli-workflow/src/__tests__/validate-semantic.test.ts
+1 -1
View File
@@ -1,5 +1,5 @@
import { describe, expect, test } from "bun:test";
import type { WorkflowPayload } from "@uncaged/workflow-protocol";
import type { WorkflowPayload } from "@united-workforce/protocol";
import { validateWorkflow } from "../validate-semantic.js";
/** Build a valid two-role workflow that passes all checks. */
packages/cli-workflow/src/__tests__/workflow-resolution.test.ts
+1 -1
View File
@@ -3,7 +3,7 @@ import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
import { tmpdir } from "node:os";
import { join } from "node:path";
import { createFsStore } from "@ocas/fs";
import type { CasRef, WorkflowPayload } from "@uncaged/workflow-protocol";
import type { CasRef, WorkflowPayload } from "@united-workforce/protocol";
import { stringify } from "yaml";
import { cmdThreadStart } from "../commands/thread.js";
import { registerUwfSchemas } from "../schemas.js";
packages/cli-workflow/src/background/background.ts
+1 -1
View File
@@ -1,6 +1,6 @@
import { mkdir, readdir, readFile, rename, rm, writeFile } from "node:fs/promises";
import { join } from "node:path";
import type { RunningThreadItem, ThreadId } from "@uncaged/workflow-protocol";
import type { RunningThreadItem, ThreadId } from "@united-workforce/protocol";
import type { RunningMarker } from "./types.js";
packages/cli-workflow/src/background/types.ts
+1 -1
View File
@@ -1,4 +1,4 @@
import type { CasRef, ThreadId } from "@uncaged/workflow-protocol";
import type { CasRef, ThreadId } from "@united-workforce/protocol";
/** Marker file stored at ~/.uncaged/workflow/running/<thread-id>.json */
export type RunningMarker = {
packages/cli-workflow/src/cli.ts
+1 -1
View File
@@ -1,6 +1,6 @@
#!/usr/bin/env node
import type { CasRef, ThreadId, ThreadStatus } from "@uncaged/workflow-protocol";
import type { CasRef, ThreadId, ThreadStatus } from "@united-workforce/protocol";
import { Command } from "commander";
import {
cmdCasGet,
packages/cli-workflow/src/commands/prompt.ts
+2 -2
View File
@@ -4,7 +4,7 @@ import {
generateBootstrapReference,
generateDeveloperReference,
generateUserReference,
} from "@uncaged/workflow-util";
} from "@united-workforce/util";
export {
generateAdapterReference as cmdPromptAdapter,
@@ -42,7 +42,7 @@ so that you know how to use the \`uwf\` CLI for workflow orchestration.
\`\`\`bash
uwf --help
\`\`\`
If not installed: \`bun add -g @uncaged/cli-workflow\`
If not installed: \`bun add -g @united-workforce/cli\`
2. **Clean up old versions of the skill** (if any exist):
- Look for any existing uwf/workflow skill files in your skill directories
packages/cli-workflow/src/commands/setup.ts
+3 -3
View File
@@ -2,7 +2,7 @@ import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSy
import { join } from "node:path";
import { stdin as input, stdout as output } from "node:process";
import { createInterface } from "node:readline/promises";
import type { Result } from "@uncaged/workflow-util";
import type { Result } from "@united-workforce/util";
import { parse, stringify } from "yaml";
/**
@@ -304,8 +304,8 @@ export async function _promptAgentSelection(
if (agents.length === 0) {
console.log(" No uwf-* agent binaries found in PATH.\n");
console.log(" Install one first, for example:");
console.log(" npm i -g @uncaged/workflow-agent-hermes");
console.log(" npm i -g @uncaged/workflow-agent-claude-code\n");
console.log(" npm i -g @united-workforce/agent-hermes");
console.log(" npm i -g @united-workforce/agent-claude-code\n");
const manual = (
await rl.question("Agent binary name (e.g. uwf-hermes), or press Enter to skip: ")
).trim();
packages/cli-workflow/src/commands/shared.ts
+1 -1
View File
@@ -5,7 +5,7 @@ import type {
StartNodePayload,
StepNodePayload,
ThreadId,
} from "@uncaged/workflow-protocol";
} from "@united-workforce/protocol";
import { findThreadInHistory, loadThreadsIndex, type UwfStore } from "../store.js";
type ChainState = {
packages/cli-workflow/src/commands/step.ts
+2 -2
View File
@@ -7,8 +7,8 @@ import type {
ThreadForkOutput,
ThreadId,
ThreadStepsOutput,
} from "@uncaged/workflow-protocol";
import { generateUlid } from "@uncaged/workflow-util";
} from "@united-workforce/protocol";
import { generateUlid } from "@united-workforce/util";
import { createUwfStore, loadThreadsIndex, saveThreadsIndex } from "../store.js";
import {
collectOrderedSteps,
packages/cli-workflow/src/commands/thread.ts
+5 -5
View File
@@ -17,20 +17,20 @@ import type {
ThreadsIndex,
WorkflowConfig,
WorkflowPayload,
} from "@uncaged/workflow-protocol";
} from "@united-workforce/protocol";
import {
createThreadIndexEntry,
markThreadSuspended,
updateThreadHead,
} from "@uncaged/workflow-protocol";
} from "@united-workforce/protocol";
import {
createProcessLogger,
extractUlidTimestamp,
generateUlid,
type ProcessLogger,
} from "@uncaged/workflow-util";
import type { AdapterOutput } from "@uncaged/workflow-util-agent";
import { getEnvPath, loadWorkflowConfig } from "@uncaged/workflow-util-agent";
} from "@united-workforce/util";
import type { AdapterOutput } from "@united-workforce/util-agent";
import { getEnvPath, loadWorkflowConfig } from "@united-workforce/util-agent";
import { config as loadDotenv } from "dotenv";
import { parse } from "yaml";
import { createMarker, deleteMarker, isThreadRunning } from "../background/index.js";
packages/cli-workflow/src/commands/workflow.ts
+1 -1
View File
@@ -3,7 +3,7 @@ import { dirname, resolve as resolvePath } from "node:path";
import type { JSONSchema } from "@ocas/core";
import { putSchema, validate } from "@ocas/core";
import type { CasRef, RoleDefinition, Target, WorkflowPayload } from "@uncaged/workflow-protocol";
import type { CasRef, RoleDefinition, Target, WorkflowPayload } from "@united-workforce/protocol";
import { parse } from "yaml";
import { createIncludeTag } from "../include.js";
packages/cli-workflow/src/moderator/evaluate.ts
+1 -1
View File
@@ -1,4 +1,4 @@
import type { Target } from "@uncaged/workflow-protocol";
import type { Target } from "@united-workforce/protocol";
import mustache from "mustache";
import type { EvaluateResult, Result } from "./types.js";
packages/cli-workflow/src/schemas.ts
+1 -1
View File
@@ -1,6 +1,6 @@
import type { Hash, Store } from "@ocas/core";
import { putSchema } from "@ocas/core";
import { START_NODE_SCHEMA, STEP_NODE_SCHEMA, WORKFLOW_SCHEMA } from "@uncaged/workflow-protocol";
import { START_NODE_SCHEMA, STEP_NODE_SCHEMA, WORKFLOW_SCHEMA } from "@united-workforce/protocol";
export const TEXT_SCHEMA = { type: "string" as const };
packages/cli-workflow/src/store.ts
+2 -2
View File
@@ -11,12 +11,12 @@ import type {
ThreadIndexEntry,
ThreadListItem,
ThreadsIndex,
} from "@uncaged/workflow-protocol";
} from "@united-workforce/protocol";
import {
createThreadIndexEntry,
parseThreadsIndex,
serializeThreadsIndex,
} from "@uncaged/workflow-protocol";
} from "@united-workforce/protocol";
import { parse, stringify } from "yaml";
import { registerUwfSchemas, type UwfSchemaHashes } from "./schemas.js";
packages/cli-workflow/src/validate-semantic.ts
+1 -1
View File
@@ -1,4 +1,4 @@
import type { WorkflowPayload } from "@uncaged/workflow-protocol";
import type { WorkflowPayload } from "@united-workforce/protocol";
type SchemaObj = Record<string, unknown>;
packages/cli-workflow/src/validate.ts
+1 -1
View File
@@ -1,5 +1,5 @@
import { basename, dirname } from "node:path";
import type { CasRef, WorkflowPayload } from "@uncaged/workflow-protocol";
import type { CasRef, WorkflowPayload } from "@united-workforce/protocol";
const CAS_REF_PATTERN = /^[0-9A-HJKMNP-TV-Z]{13}$/;
packages/workflow-agent-builtin/README.md
+4 -4
View File
@@ -1,4 +1,4 @@
# @uncaged/workflow-agent-builtin
# @united-workforce/agent-builtin
`uwf-builtin` agent — built-in LLM agent with file read/write and shell tools.
@@ -8,14 +8,14 @@ Layer 3 agent implementation. Runs an OpenAI-compatible chat completion loop wit
Useful when you want a self-contained agent without an external CLI like Hermes or Claude Code.
**Dependencies:** `@ocas/core`, `@uncaged/workflow-util-agent`, `@uncaged/workflow-util`
**Dependencies:** `@ocas/core`, `@united-workforce/util-agent`, `@united-workforce/util`
## Installation
Included as the `uwf-builtin` binary when you install `@uncaged/workflow-agent-builtin`:
Included as the `uwf-builtin` binary when you install `@united-workforce/agent-builtin`:
```bash
bun add -g @uncaged/workflow-agent-builtin
bun add -g @united-workforce/agent-builtin
```
## CLI Usage
packages/workflow-agent-builtin/__tests__/prompt.test.ts
+1 -1
View File
@@ -1,6 +1,6 @@
import { describe, expect, test } from "bun:test";
import type { AgentContext } from "@uncaged/workflow-util-agent";
import type { AgentContext } from "@united-workforce/util-agent";
import { buildBuiltinMessages } from "../src/prompt.js";
packages/workflow-agent-builtin/package.json
+3 -3
View File
@@ -1,5 +1,5 @@
{
"name": "@uncaged/workflow-agent-builtin",
"name": "@united-workforce/agent-builtin",
"version": "0.5.0",
"files": [
"src",
@@ -24,8 +24,8 @@
},
"dependencies": {
"@ocas/core": "^0.1.1",
"@uncaged/workflow-util-agent": "workspace:^",
"@uncaged/workflow-util": "workspace:^"
"@united-workforce/util-agent": "workspace:^",
"@united-workforce/util": "workspace:^"
},
"devDependencies": {
"typescript": "^5.8.3"
packages/workflow-agent-builtin/src/agent.ts
+2 -2
View File
@@ -1,5 +1,5 @@
import type { Store } from "@ocas/core";
import { createLogger, generateUlid } from "@uncaged/workflow-util";
import { createLogger, generateUlid } from "@united-workforce/util";
import {
type AgentContext,
type AgentRunResult,
@@ -7,7 +7,7 @@ import {
loadWorkflowConfig,
resolveModel,
resolveStorageRoot,
} from "@uncaged/workflow-util-agent";
} from "@united-workforce/util-agent";
import { storeBuiltinDetail } from "./detail.js";
import type { ChatMessage } from "./llm/index.js";
packages/workflow-agent-builtin/src/llm/llm.ts
+1 -1
View File
@@ -1,4 +1,4 @@
import type { ResolvedLlmProvider } from "@uncaged/workflow-util-agent";
import type { ResolvedLlmProvider } from "@united-workforce/util-agent";
import type {
ChatMessage,
packages/workflow-agent-builtin/src/loop.ts
+2 -2
View File
@@ -1,5 +1,5 @@
import { createLogger } from "@uncaged/workflow-util";
import type { ResolvedLlmProvider } from "@uncaged/workflow-util-agent";
import { createLogger } from "@united-workforce/util";
import type { ResolvedLlmProvider } from "@united-workforce/util-agent";
import {
type ChatMessage,
packages/workflow-agent-builtin/src/prompt.ts
+1 -1
View File
@@ -1,4 +1,4 @@
import { type AgentContext, buildRolePrompt } from "@uncaged/workflow-util-agent";
import { type AgentContext, buildRolePrompt } from "@united-workforce/util-agent";
import type { ChatMessage } from "./llm/index.js";
packages/workflow-agent-builtin/src/session.ts
+1 -1
View File
@@ -1,7 +1,7 @@
import { appendFile, mkdir, readFile, rm } from "node:fs/promises";
import { join } from "node:path";
import { createLogger } from "@uncaged/workflow-util";
import { createLogger } from "@united-workforce/util";
import type { BuiltinTurnPayload } from "./types.js";
packages/workflow-agent-claude-code/README.md
+6 -6
View File
@@ -1,4 +1,4 @@
# @uncaged/workflow-agent-claude-code
# @united-workforce/agent-claude-code
`uwf-claude-code` agent — spawns the Claude Code CLI and captures session detail.
@@ -6,14 +6,14 @@
Layer 3 agent implementation. Spawns the `claude` CLI with a composed system prompt (role definition, task, prior steps, edge prompt). Parses stream or JSON stdout, caches session IDs for multi-turn continuation, and stores raw output plus structured detail in CAS.
**Dependencies:** `@ocas/core`, `@uncaged/workflow-util-agent`
**Dependencies:** `@ocas/core`, `@united-workforce/util-agent`
## Installation
Included as the `uwf-claude-code` binary when you install `@uncaged/workflow-agent-claude-code`:
Included as the `uwf-claude-code` binary when you install `@united-workforce/agent-claude-code`:
```bash
bun add -g @uncaged/workflow-agent-claude-code
bun add -g @united-workforce/agent-claude-code
```
Requires the `claude` CLI on `PATH`.
@@ -66,7 +66,7 @@ function storeClaudeCodeRawOutput(store: Store, rawOutput: string): Promise<stri
## Usage (library)
```typescript
import { createClaudeCodeAgent, buildClaudeCodePrompt } from "@uncaged/workflow-agent-claude-code";
import { createClaudeCodeAgent, buildClaudeCodePrompt } from "@united-workforce/agent-claude-code";
const main = createClaudeCodeAgent();
void main();
@@ -86,6 +86,6 @@ src/
## Configuration
Uses session caching from `@uncaged/workflow-util-agent` (`getCachedSessionId` / `setCachedSessionId`). No separate config file — relies on the Claude Code CLI's own authentication.
Uses session caching from `@united-workforce/util-agent` (`getCachedSessionId` / `setCachedSessionId`). No separate config file — relies on the Claude Code CLI's own authentication.
Maximum turns per invocation: 90 (constant in `claude-code.ts`).
packages/workflow-agent-claude-code/__tests__/claude-code.test.ts
+2 -2
View File
@@ -1,6 +1,6 @@
import { describe, expect, test } from "bun:test";
import type { ThreadId } from "@uncaged/workflow-protocol";
import type { AgentContext } from "@uncaged/workflow-util-agent";
import type { ThreadId } from "@united-workforce/protocol";
import type { AgentContext } from "@united-workforce/util-agent";
import { buildClaudeCodePrompt } from "../src/claude-code.js";
function makeCtx(overrides: Partial<AgentContext> = {}): AgentContext {
packages/workflow-agent-claude-code/package.json
+3 -3
View File
@@ -1,5 +1,5 @@
{
"name": "@uncaged/workflow-agent-claude-code",
"name": "@united-workforce/agent-claude-code",
"version": "0.1.0",
"files": [
"src",
@@ -24,8 +24,8 @@
},
"dependencies": {
"@ocas/core": "^0.1.1",
"@uncaged/workflow-util-agent": "workspace:^",
"@uncaged/workflow-util": "workspace:^"
"@united-workforce/util-agent": "workspace:^",
"@united-workforce/util": "workspace:^"
},
"devDependencies": {
"typescript": "^5.8.3"
packages/workflow-agent-claude-code/src/claude-code.ts
+2 -2
View File
@@ -1,6 +1,6 @@
import { spawn } from "node:child_process";
import type { Store } from "@ocas/core";
import { createLogger } from "@uncaged/workflow-util";
import { createLogger } from "@united-workforce/util";
import {
type AgentContext,
type AgentRunResult,
@@ -9,7 +9,7 @@ import {
createAgent,
getCachedSessionId,
setCachedSessionId,
} from "@uncaged/workflow-util-agent";
} from "@united-workforce/util-agent";
import { parseClaudeCodeStreamOutput, storeClaudeCodeDetail } from "./session-detail.js";
packages/workflow-agent-hermes/README.md
+5 -5
View File
@@ -1,4 +1,4 @@
# @uncaged/workflow-agent-hermes
# @united-workforce/agent-hermes
`uwf-hermes` — an **agent adapter** that bridges the `uwf` workflow engine and the Hermes CLI.
@@ -8,14 +8,14 @@
On first visit to a role it sends a composed prompt (role definition, task, history, edge prompt); on continuation it resumes the cached session. Session transcripts and raw output are stored as CAS detail nodes.
**Dependencies:** `@ocas/core`, `@uncaged/workflow-util-agent`, `@uncaged/workflow-protocol`, `@uncaged/workflow-util`
**Dependencies:** `@ocas/core`, `@united-workforce/util-agent`, `@united-workforce/protocol`, `@united-workforce/util`
## Installation
Included as the `uwf-hermes` binary when you install `@uncaged/workflow-agent-hermes`:
Included as the `uwf-hermes` binary when you install `@united-workforce/agent-hermes`:
```bash
bun add -g @uncaged/workflow-agent-hermes
bun add -g @united-workforce/agent-hermes
```
Requires the `hermes` CLI on `PATH`.
@@ -73,7 +73,7 @@ class HermesAcpClient {
## Usage (library)
```typescript
import { createHermesAgent, buildHermesPrompt } from "@uncaged/workflow-agent-hermes";
import { createHermesAgent, buildHermesPrompt } from "@united-workforce/agent-hermes";
// CLI entry (src/cli.ts):
const main = createHermesAgent();
packages/workflow-agent-hermes/__tests__/hermes-prompt.test.ts
+2 -2
View File
@@ -1,6 +1,6 @@
import { describe, expect, test } from "bun:test";
import type { ThreadId } from "@uncaged/workflow-protocol";
import type { AgentContext } from "@uncaged/workflow-util-agent";
import type { ThreadId } from "@united-workforce/protocol";
import type { AgentContext } from "@united-workforce/util-agent";
import { buildHermesPrompt } from "../src/hermes.js";
function makeCtx(overrides: Partial<AgentContext> = {}): AgentContext {
packages/workflow-agent-hermes/package.json
+4 -4
View File
@@ -1,5 +1,5 @@
{
"name": "@uncaged/workflow-agent-hermes",
"name": "@united-workforce/agent-hermes",
"version": "0.5.0",
"files": [
"src",
@@ -24,9 +24,9 @@
},
"dependencies": {
"@ocas/core": "^0.1.1",
"@uncaged/workflow-util-agent": "workspace:^",
"@uncaged/workflow-protocol": "workspace:^",
"@uncaged/workflow-util": "workspace:^"
"@united-workforce/util-agent": "workspace:^",
"@united-workforce/protocol": "workspace:^",
"@united-workforce/util": "workspace:^"
},
"devDependencies": {
"typescript": "^5.8.3"
packages/workflow-agent-hermes/src/hermes.ts
+2 -2
View File
@@ -1,12 +1,12 @@
import type { Store } from "@ocas/core";
import { createLogger } from "@uncaged/workflow-util";
import { createLogger } from "@united-workforce/util";
import {
type AgentContext,
type AgentRunResult,
buildContinuationPrompt,
buildRolePrompt,
createAgent,
} from "@uncaged/workflow-util-agent";
} from "@united-workforce/util-agent";
import { HermesAcpClient } from "./acp-client.js";
import { getCachedSessionId, isResumeDisabled, setCachedSessionId } from "./session-cache.js";
packages/workflow-agent-hermes/src/session-cache.ts
+2 -2
View File
@@ -1,10 +1,10 @@
// Re-export session cache from the shared agent-kit package with agent name injected.
import type { ThreadId } from "@uncaged/workflow-protocol";
import type { ThreadId } from "@united-workforce/protocol";
import {
getCachedSessionId as getCachedSessionIdBase,
setCachedSessionId as setCachedSessionIdBase,
} from "@uncaged/workflow-util-agent";
} from "@united-workforce/util-agent";
export async function getCachedSessionId(threadId: ThreadId, role: string): Promise<string | null> {
return getCachedSessionIdBase("hermes", threadId, role);
packages/workflow-dashboard/README.md
+3 -3
View File
@@ -1,14 +1,14 @@
# @uncaged/workflow-dashboard
# @united-workforce/dashboard
Web graph editor for visualizing and editing workflow YAML definitions.
## Overview
A private alpha web app (not part of the runtime engine stack). Provides a React + `@xyflow/react` canvas for editing workflow roles, conditions, and graph transitions. Uses `@uncaged/workflow-protocol` types for validation and YAML round-tripping.
A private alpha web app (not part of the runtime engine stack). Provides a React + `@xyflow/react` canvas for editing workflow roles, conditions, and graph transitions. Uses `@united-workforce/protocol` types for validation and YAML round-tripping.
Planned integration: local `uwf connect` over WebSocket to sync YAML between CLI and the browser editor. The REST API and Elysia backend are currently stubs for development.
**Dependencies:** `@uncaged/workflow-protocol`, `@xyflow/react`, React 19, react-router v7, Vite 8, Tailwind CSS v4, Elysia
**Dependencies:** `@united-workforce/protocol`, `@xyflow/react`, React 19, react-router v7, Vite 8, Tailwind CSS v4, Elysia
## Installation
packages/workflow-dashboard/package.json
+2 -2
View File
@@ -1,5 +1,5 @@
{
"name": "@uncaged/workflow-dashboard",
"name": "@united-workforce/dashboard",
"version": "0.5.0-alpha.4",
"private": true,
"type": "module",
@@ -12,7 +12,7 @@
"dependencies": {
"@base-ui/react": "^1.5.0",
"@fontsource-variable/geist": "^5.2.9",
"@uncaged/workflow-protocol": "workspace:*",
"@united-workforce/protocol": "workspace:*",
"@xyflow/react": "^12.10.2",
"class-variance-authority": "^0.7.1",
"clsx": "^2.1.1",
packages/workflow-dashboard/server/workflow.ts
+1 -1
View File
@@ -1,6 +1,6 @@
import { mkdir, readdir, readFile, unlink, writeFile } from "node:fs/promises";
import { join } from "node:path";
import type { RoleDefinition, Target, WorkflowPayload } from "@uncaged/workflow-protocol";
import type { RoleDefinition, Target, WorkflowPayload } from "@united-workforce/protocol";
import YAML from "yaml";
import type { WorkFlowSteps, WorkFlowTransition, WorkflowSummary } from "../shared/types.ts";
packages/workflow-protocol/README.md
+3 -3
View File
@@ -1,4 +1,4 @@
# @uncaged/workflow-protocol
# @united-workforce/protocol
Shared TypeScript types and JSON Schema constants for the workflow engine.
@@ -11,7 +11,7 @@ This is the contract layer (Layer 0). It defines `WorkflowPayload`, thread node
## Installation
```bash
bun add @uncaged/workflow-protocol
bun add @united-workforce/protocol
```
## API
@@ -183,4 +183,4 @@ src/
## Configuration
This package defines `WorkflowConfig` types only. Runtime config loading lives in `@uncaged/workflow-util-agent` (`loadWorkflowConfig`).
This package defines `WorkflowConfig` types only. Runtime config loading lives in `@united-workforce/util-agent` (`loadWorkflowConfig`).
packages/workflow-protocol/package.json
+1 -1
View File
@@ -1,5 +1,5 @@
{
"name": "@uncaged/workflow-protocol",
"name": "@united-workforce/protocol",
"version": "0.5.0",
"files": [
"src",
packages/workflow-util-agent/README.md
+6 -6
View File
@@ -1,4 +1,4 @@
# @uncaged/workflow-util-agent
# @united-workforce/util-agent
Agent framework — `createAgent` factory, context builder, frontmatter fast-path, and LLM extract pipeline.
@@ -8,12 +8,12 @@ Layer 2 agent framework. Provides the standard entrypoint for all agent CLIs: pa
Also exports prompt builders, config/storage helpers, and session ID caching for multi-turn agents.
**Dependencies:** `@ocas/core`, `@ocas/fs`, `@uncaged/workflow-protocol`, `@uncaged/workflow-util`, `dotenv`, `yaml`
**Dependencies:** `@ocas/core`, `@ocas/fs`, `@united-workforce/protocol`, `@united-workforce/util`, `dotenv`, `yaml`
## Installation
```bash
bun add @uncaged/workflow-util-agent
bun add @united-workforce/util-agent
```
## API
@@ -140,8 +140,8 @@ function loadWorkflowConfig(storageRoot: string): Promise<WorkflowConfig>
## Usage
```typescript
import { createAgent, buildRolePrompt } from "@uncaged/workflow-util-agent";
import type { AgentContext, AgentRunResult } from "@uncaged/workflow-util-agent";
import { createAgent, buildRolePrompt } from "@united-workforce/util-agent";
import type { AgentContext, AgentRunResult } from "@united-workforce/util-agent";
async function run(ctx: AgentContext): Promise<AgentRunResult> {
const prompt = buildRolePrompt(ctx.workflow.roles[ctx.role]!);
@@ -180,4 +180,4 @@ src/
## Configuration
Reads `config.yaml` and `.env` from the workflow storage root (`~/.uncaged/workflow` by default). See `@uncaged/workflow-protocol` for `WorkflowConfig` shape. Set via `uwf setup`.
Reads `config.yaml` and `.env` from the workflow storage root (`~/.uncaged/workflow` by default). See `@united-workforce/protocol` for `WorkflowConfig` shape. Set via `uwf setup`.
packages/workflow-util-agent/__tests__/build-continuation-prompt.test.ts
+1 -1
View File
@@ -1,5 +1,5 @@
import { describe, expect, test } from "bun:test";
import type { StepContext } from "@uncaged/workflow-protocol";
import type { StepContext } from "@united-workforce/protocol";
import { buildContinuationPrompt } from "../src/build-continuation-prompt.js";
const reviewerStep: StepContext = {
packages/workflow-util-agent/__tests__/build-role-prompt.test.ts
+1 -1
View File
@@ -1,5 +1,5 @@
import { describe, expect, test } from "bun:test";
import type { RoleDefinition } from "@uncaged/workflow-protocol";
import type { RoleDefinition } from "@united-workforce/protocol";
import { buildRolePrompt } from "../src/build-role-prompt.js";
describe("buildRolePrompt", () => {
packages/workflow-util-agent/__tests__/resolve-extract-model.test.ts
+1 -1
View File
@@ -1,5 +1,5 @@
import { describe, expect, test } from "bun:test";
import type { WorkflowConfig } from "@uncaged/workflow-protocol";
import type { WorkflowConfig } from "@united-workforce/protocol";
import { resolveExtractModelAlias } from "../src/extract.js";
function baseConfig(overrides: Partial<WorkflowConfig> = {}): WorkflowConfig {
packages/workflow-util-agent/__tests__/session-cache.test.ts
+1 -1
View File
@@ -1,7 +1,7 @@
import { afterEach, beforeEach, describe, expect, test } from "bun:test";
import { mkdir, readdir, readFile, rm, stat, writeFile } from "node:fs/promises";
import { dirname, join } from "node:path";
import type { ThreadId } from "@uncaged/workflow-protocol";
import type { ThreadId } from "@united-workforce/protocol";
import { getCachedSessionId, getCachePath, setCachedSessionId } from "../src/session-cache.js";
import { resolveStorageRoot } from "../src/storage.js";
packages/workflow-util-agent/package.json
+3 -3
View File
@@ -1,5 +1,5 @@
{
"name": "@uncaged/workflow-util-agent",
"name": "@united-workforce/util-agent",
"version": "0.5.0",
"files": [
"src",
@@ -22,8 +22,8 @@
"dependencies": {
"@ocas/core": "^0.1.1",
"@ocas/fs": "^0.1.1",
"@uncaged/workflow-protocol": "workspace:^",
"@uncaged/workflow-util": "workspace:^",
"@united-workforce/protocol": "workspace:^",
"@united-workforce/util": "workspace:^",
"dotenv": "^16.6.1",
"yaml": "^2.8.4"
},
packages/workflow-util-agent/src/build-continuation-prompt.ts
+1 -1
View File
@@ -1,4 +1,4 @@
import type { StepContext } from "@uncaged/workflow-protocol";
import type { StepContext } from "@united-workforce/protocol";
function formatStep(step: StepContext, stepNumber: number, includeContent: boolean): string {
const lines = [
packages/workflow-util-agent/src/build-role-prompt.ts
+2 -2
View File
@@ -1,5 +1,5 @@
import type { RoleDefinition } from "@uncaged/workflow-protocol";
import { generateCliReference } from "@uncaged/workflow-util";
import type { RoleDefinition } from "@united-workforce/protocol";
import { generateCliReference } from "@united-workforce/util";
/**
* Build the role prompt from a RoleDefinition.
packages/workflow-util-agent/src/context.ts
+1 -1
View File
@@ -5,7 +5,7 @@ import type {
StepContext,
StepNodePayload,
ThreadId,
} from "@uncaged/workflow-protocol";
} from "@united-workforce/protocol";
import type { AgentStore } from "./storage.js";
import { createAgentStore, loadThreadsIndex, resolveStorageRoot } from "./storage.js";
import type { AgentContext } from "./types.js";
packages/workflow-util-agent/src/extract.ts
+1 -1
View File
@@ -1,6 +1,6 @@
import { getSchema, validate } from "@ocas/core";
import type { CasRef, ModelAlias, WorkflowConfig } from "@uncaged/workflow-protocol";
import type { CasRef, ModelAlias, WorkflowConfig } from "@united-workforce/protocol";
import { createAgentStore, resolveStorageRoot } from "./storage.js";
export type ResolvedLlmProvider = {
packages/workflow-util-agent/src/frontmatter.ts
+2 -2
View File
@@ -1,12 +1,12 @@
import type { Store } from "@ocas/core";
import { getSchema, validate } from "@ocas/core";
import type { CasRef } from "@uncaged/workflow-protocol";
import type { CasRef } from "@united-workforce/protocol";
import {
type AgentFrontmatter,
createLogger,
parseFrontmatterMarkdown,
validateFrontmatter,
} from "@uncaged/workflow-util";
} from "@united-workforce/util";
import { parse as parseYaml } from "yaml";
import { extractSchemaFields } from "./build-output-format-instruction.js";
packages/workflow-util-agent/src/run.ts
+1 -1
View File
@@ -1,5 +1,5 @@
import { getSchema, validate } from "@ocas/core";
import type { CasRef, StepNodePayload, ThreadId } from "@uncaged/workflow-protocol";
import type { CasRef, StepNodePayload, ThreadId } from "@united-workforce/protocol";
import { config as loadDotenv } from "dotenv";
import { buildOutputFormatInstruction } from "./build-output-format-instruction.js";
import { buildContextWithMeta } from "./context.js";
packages/workflow-util-agent/src/schemas.ts
+1 -1
View File
@@ -1,6 +1,6 @@
import type { Hash, Store } from "@ocas/core";
import { putSchema } from "@ocas/core";
import { START_NODE_SCHEMA, STEP_NODE_SCHEMA, WORKFLOW_SCHEMA } from "@uncaged/workflow-protocol";
import { START_NODE_SCHEMA, STEP_NODE_SCHEMA, WORKFLOW_SCHEMA } from "@united-workforce/protocol";
export type UwfAgentSchemaHashes = {
workflow: Hash;
packages/workflow-util-agent/src/session-cache.ts
+1 -1
View File
@@ -2,7 +2,7 @@ import { randomBytes } from "node:crypto";
import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
import { dirname, join } from "node:path";
import type { ThreadId } from "@uncaged/workflow-protocol";
import type { ThreadId } from "@united-workforce/protocol";
import { resolveStorageRoot } from "./storage.js";
packages/workflow-util-agent/src/storage.ts
+2 -2
View File
@@ -15,8 +15,8 @@ import type {
ThreadsIndex,
WorkflowConfig,
WorkflowName,
} from "@uncaged/workflow-protocol";
import { parseThreadsIndex } from "@uncaged/workflow-protocol";
} from "@united-workforce/protocol";
import { parseThreadsIndex } from "@united-workforce/protocol";
import { parse } from "yaml";
import { registerAgentSchemas } from "./schemas.js";
packages/workflow-util-agent/src/types.ts
+1 -1
View File
@@ -1,5 +1,5 @@
import type { Store } from "@ocas/core";
import type { ModeratorContext, ThreadId, WorkflowPayload } from "@uncaged/workflow-protocol";
import type { ModeratorContext, ThreadId, WorkflowPayload } from "@united-workforce/protocol";
export type AgentContext = ModeratorContext & {
threadId: ThreadId;
packages/workflow-util/README.md
+3 -3
View File
@@ -1,4 +1,4 @@
# @uncaged/workflow-util
# @united-workforce/util
Shared utilities: encoding, IDs, logging, frontmatter parsing, storage paths, and CLI reference generation.
@@ -11,7 +11,7 @@ Layer 1 shared infrastructure used across CLI, agent-kit, and agent packages. Pr
## Installation
```bash
bun add @uncaged/workflow-util
bun add @united-workforce/util
```
## API
@@ -114,7 +114,7 @@ import {
generateUlid,
getDefaultWorkflowStorageRoot,
parseFrontmatterMarkdown,
} from "@uncaged/workflow-util";
} from "@united-workforce/util";
const log = createLogger();
log("4KNMR2PX", "Loading workflow...");
packages/workflow-util/package.json
+1 -1
View File
@@ -1,5 +1,5 @@
{
"name": "@uncaged/workflow-util",
"name": "@united-workforce/util",
"version": "0.5.0",
"files": [
"src",
packages/workflow-util/src/adapter-reference.ts
+6 -6
View File
@@ -16,8 +16,8 @@ The adapter must produce frontmatter markdown output. The engine handles argumen
## Quick Start
\`\`\`typescript
import { createAgent } from "@uncaged/workflow-util-agent";
import type { AgentContext, AgentRunResult, AgentContinueFn, AgentRunFn } from "@uncaged/workflow-util-agent";
import { createAgent } from "@united-workforce/util-agent";
import type { AgentContext, AgentRunResult, AgentContinueFn, AgentRunFn } from "@united-workforce/util-agent";
const run: AgentRunFn = async (ctx: AgentContext): Promise<AgentRunResult> => {
// 1. Build your prompt from ctx
@@ -91,7 +91,7 @@ type AgentRunResult = {
## Building the Prompt
Use helpers from \`@uncaged/workflow-util-agent\`:
Use helpers from \`@united-workforce/util-agent\`:
| Helper | Purpose |
|--------|---------|
@@ -145,9 +145,9 @@ defaultAgent: my-agent
| Adapter | Package | Backend |
|---------|---------|---------|
| \`uwf-hermes\` | \`@uncaged/workflow-agent-hermes\` | Hermes ACP (chat sessions) |
| \`uwf-builtin\` | \`@uncaged/workflow-agent-builtin\` | Direct OpenAI API (tools + loop) |
| \`uwf-claude-code\` | \`@uncaged/workflow-agent-claude-code\` | Claude Code CLI |
| \`uwf-hermes\` | \`@united-workforce/agent-hermes\` | Hermes ACP (chat sessions) |
| \`uwf-builtin\` | \`@united-workforce/agent-builtin\` | Direct OpenAI API (tools + loop) |
| \`uwf-claude-code\` | \`@united-workforce/agent-claude-code\` | Claude Code CLI |
Study these for patterns on prompt building, session management, and detail storage.
packages/workflow-util/src/developer-reference.ts
+4 -4
View File
@@ -39,7 +39,7 @@ Classes allowed only when required by third-party libraries or for Error subclas
### Error Handling
- \`Result<T, E>\` type for expected failures (\`ok\`/\`err\` constructors from \`@uncaged/workflow-util\`)
- \`Result<T, E>\` type for expected failures (\`ok\`/\`err\` constructors from \`@united-workforce/util\`)
- \`throw\` only for unrecoverable bugs
- No try-catch for flow control
@@ -52,14 +52,14 @@ Always \`async/await\`, never \`.then()\` chains.
\`console.*\` is banned (Biome \`noConsole\` rule). Use the structured logger:
\`\`\`typescript
import { createLogger } from "@uncaged/workflow-util";
import { createLogger } from "@united-workforce/util";
const log = createLogger();
log("4KNMR2PX", "Loading workflow..."); // 8-char Crockford Base32 tag
\`\`\`
Each call site gets a unique hand-written tag. \`grep "4KNMR2PX"\` in logs → instant code location.
CLI package (\`@uncaged/cli-workflow\`) may use \`console.log\` for user-facing output with a biome-ignore comment.
CLI package (\`@united-workforce/cli\`) may use \`console.log\` for user-facing output with a biome-ignore comment.
### No Dynamic Import
@@ -90,7 +90,7 @@ Before committing: \`bun run check\` + \`bun test\` must both pass.
### Publishing
Fixed-mode versioning — all \`@uncaged/*\` packages share the same version number.
Fixed-mode versioning — all \`@united-workforce/*\` packages share the same version number.
\`\`\`bash
bun changeset # describe the change