imccyu
6f77da4c8c
Move the agent-spine bundle and the stdio/ACP/JSON-RPC app packages out of core/ and ui/ into a new packages/examples/ group, renamed with a -demo suffix so the npm name marks them as non-product surface: core/agent-core -> examples/agent-spine-demo (dsh-agent-spine-demo) ui/stdio-agent -> examples/stdio-demo (dsh-stdio-demo) ui/acp-agent -> examples/acp-demo (dsh-acp-demo) ui/jsonrpc-agent -> examples/jsonrpc-demo (dsh-jsonrpc-demo) Update every code/config/test reference and reference-only doc mentions, and regenerate module-graph, config-catalog, and doc-graphs. The jsonrpc bin (dsh-jsonrpc-agent) and single-file exe (dsh-jsonrpc-agent-pkg) keep their names; the SDK runtime-startup surface is reconciled separately.
82 lines
4.0 KiB
TypeScript
82 lines
4.0 KiB
TypeScript
/**
|
|
* The ACP server app: the default agent spine ({@link @deepseek-ai/dsh-agent-spine-demo}),
|
|
* JSONL session persistence, and the {@link @deepseek-ai/dsh-acp} bridge. It
|
|
* writes nothing to stdout.
|
|
* It pre-creates no agents and leaves adapters, executors, and optional tools to
|
|
* the leaf, which must likewise avoid stdout loggers. Named exports are
|
|
* required so Loader retains this plugin's `Config` schema (see
|
|
* docs/postmortem/0001).
|
|
* @module @deepseek-ai/dsh-acp-demo
|
|
*/
|
|
|
|
import type { Context } from 'cordis'
|
|
import z from 'schemastery'
|
|
import * as acp from '@deepseek-ai/dsh-acp'
|
|
import * as agentCore from '@deepseek-ai/dsh-agent-spine-demo'
|
|
import ToolRegistry, { type Config as ToolsConfig } from '@deepseek-ai/dsh-tools'
|
|
import SessionPersistenceJsonl from '@deepseek-ai/dsh-session-persistence-jsonl'
|
|
import UserInteractionService from '@deepseek-ai/dsh-user-interaction'
|
|
|
|
export const name = 'acp-demo'
|
|
|
|
/**
|
|
* App config: the swappable per-deployment values. `model` configures the
|
|
* agent template the ACP bridge creates each session's agent from (NOT a
|
|
* pre-created agent — ACP creates agents at `session/new`); `persona` is the
|
|
* deployment persona (forwarded to the system-prompt plugin); `toolOrder` is
|
|
* the explicit model-facing tool order (forwarded to the system-prompt plugin);
|
|
* `tools` is the tool registry's config (its presentation `mode`, forwarded
|
|
* through agent-spine-demo); `persistenceRoot` is the JSONL backend's directory.
|
|
*/
|
|
export interface Config {
|
|
/** Model name for ACP-created agents (must have a registered adapter). */
|
|
model: string
|
|
/** Deployment persona (the system-prompt plugin's `persona` config). */
|
|
persona?: string
|
|
/** Explicit model-facing tool order (the system-prompt plugin's `toolOrder` config; see dsh-system-prompt). */
|
|
toolOrder?: string[]
|
|
/** Tool-registry config — its presentation `mode` (forwarded through agent-spine-demo; see dsh-tools). */
|
|
tools?: ToolsConfig
|
|
/** Directory the JSONL session backend writes under. Defaults to `./.sessions`. */
|
|
persistenceRoot?: string
|
|
/** Skill registry, local-provider, and model-facing consumer config forwarded to agent-spine-demo. */
|
|
skills?: agentCore.SkillConfig
|
|
}
|
|
|
|
// Each front door owns a complete, directly readable config schema; extracting
|
|
// the common fields would make two small app contracts depend on a new facade.
|
|
/* jscpd:ignore-start */
|
|
export const Config: z<Config> = z.object({
|
|
model: z.string().required(),
|
|
persona: z.string(),
|
|
// The array default is forced to undefined: ABSENT means "lexicographic
|
|
// order" (the owning dsh-system-prompt schema does the same), while
|
|
// schemastery's native [] default would read as an invalid configured list.
|
|
toolOrder: z.array(z.string()).default(undefined as unknown as string[]),
|
|
tools: ToolRegistry.Config,
|
|
// TODO(single-default-literal): share this schema default and the defensive
|
|
// apply() fallback through one named constant while retaining both boundaries.
|
|
persistenceRoot: z.string().default('./.sessions'),
|
|
skills: agentCore.SkillConfigSchema,
|
|
})
|
|
/* jscpd:ignore-end */
|
|
|
|
/**
|
|
* Compose the spine with the ACP front door. The agent-spine-demo bundle pre-creates
|
|
* NO agents (its `agents` list defaults to `[]`) and carries the deployment
|
|
* `persona`; the JSONL backend persists under `persistenceRoot`; the ACP
|
|
* bridge owns stdout for JSON-RPC and creates one agent per `session/new`
|
|
* from `model`. No logger, no `hmr` — stdout stays pure.
|
|
*/
|
|
export function apply(ctx: Context, config: Config): void {
|
|
ctx.plugin(agentCore, {
|
|
...config.persona !== undefined ? { persona: config.persona } : {},
|
|
...config.toolOrder !== undefined ? { toolOrder: config.toolOrder } : {},
|
|
...config.tools !== undefined ? { tools: config.tools } : {},
|
|
...config.skills !== undefined ? { skills: config.skills } : {},
|
|
})
|
|
ctx.plugin(UserInteractionService)
|
|
ctx.plugin(SessionPersistenceJsonl, { root: config.persistenceRoot ?? './.sessions' })
|
|
ctx.plugin(acp, { model: config.model })
|
|
}
|