@prettier-ai/dsh-client-ui-subagent 0.1.2-alpha.1

package/lib/index.js

@@ -0,0 +1,11 @@
+//#region lib/types/index.js
+/**
+* Subagent reference plugin, node half. Pure UI plugin: the empty apply
+* exists so the plugin appears in the host cordis.yml / Loader; the browser
+* half ships via exports["./client"], discovered through the package.json
+* dsh.client declaration.
+*/
+/** Host plugin body — no host-side behavior for this source plugin. */
+function apply() {}
+//#endregion
+export { apply };

package/lib/invariant.js

@@ -0,0 +1,24 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `@prettier-ai/dsh-client-ui-subagent`.
+* @module @prettier-ai/dsh-client-ui-subagent/invariant
+*/
+const PACKAGE_NAME = "@prettier-ai/dsh-client-ui-subagent";
+/** Cordis companion plugin name. */
+const name = "client-ui-subagent-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: a single slash-source registration whose disposal is
+* proven by the HMR-safety spec — it emits no cordis events and owns no
+* cross-plugin mutable state.
+*/
+const install = () => {};
+/**
+* Register this package's invariant companion.
+* @param ctx - Cordis context carrying the invariant service.
+* @returns the installed registration's disposer after setup succeeds.
+*/
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

package/lib/types/client/SubagentHeaderLineage.d.ts

@@ -0,0 +1,19 @@
+import type { SubagentAddress } from '@prettier-ai/dsh-subagent/client';
+import type { SessionId } from '@prettier-ai/dsh-session/types';
+import type { PropsLocale, PropsRuntime } from '@prettier-ai/dsh-client-ui-slots';
+import { NS } from './locales.ts';
+/** Business actions supplied by the slot registration. */
+export interface SubagentCatalogInjected {
+    openChild: (address: SubagentAddress) => void;
+    refresh: (parentSessionId: SessionId) => void;
+    setCatalogOpen: (parentSessionId: SessionId, open: boolean) => void;
+}
+/** Full props for the session-header lineage renderer. */
+export type SubagentHeaderLineageProps = PropsRuntime<'conversation.session.header.lineage'> & SubagentCatalogInjected & PropsLocale<typeof NS>;
+/**
+ * Render one breadcrumb title together with its subagent navigation.
+ * @param props - Breadcrumb title, session standard props, and catalog actions.
+ * @returns An ordinary-title descendant count, or a title-and-chevron sibling switcher.
+ */
+export declare function SubagentHeaderLineage({ lineageSessionId, displayTitle, openTitle, useSessions, openChild, refresh, setCatalogOpen, t, }: SubagentHeaderLineageProps): import("react").JSX.Element;
+//# sourceMappingURL=SubagentHeaderLineage.d.ts.map

package/lib/types/client/SubagentReadOnlyComposer.d.ts

@@ -0,0 +1,17 @@
+import type { PropsLocale, PropsRuntime } from '@prettier-ai/dsh-client-ui-slots';
+import { NS } from './locales.ts';
+/** Why a catalog-addressed conversation cannot accept human input. */
+export interface SubagentReadOnlyMatch {
+    reason: 'one-shot' | 'parent-unavailable';
+}
+/** Full chain props after the read-only subagent selector accepts the owner currency. */
+export type SubagentReadOnlyComposerProps = PropsRuntime<'conversation.composer'> & {
+    matched: SubagentReadOnlyMatch;
+} & PropsLocale<typeof NS>;
+/**
+ * Explain why the normal composer is unavailable for an addressed child.
+ * @param props - selector-owned read-only reason plus standard slot props.
+ * @returns A read-only composer replacement.
+ */
+export declare function SubagentReadOnlyComposer({ matched, t, }: Pick<SubagentReadOnlyComposerProps, 'matched' | 't'>): import("react").JSX.Element;
+//# sourceMappingURL=SubagentReadOnlyComposer.d.ts.map

package/lib/types/client/index.d.ts

@@ -0,0 +1,19 @@
+/** Web subagent catalog, navigation, and addressed-session composer owner. */
+import type { Context as ClientContext } from '@prettier-ai/cordis';
+import { type SubagentKey } from './locales.ts';
+declare module '@prettier-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** Subagent catalog and read-only composer copy. */
+        'subagent': SubagentKey;
+    }
+}
+export type { SubagentCatalogInjected, SubagentHeaderLineageProps, } from './SubagentHeaderLineage.tsx';
+export type { SubagentReadOnlyComposerProps, SubagentReadOnlyMatch, } from './SubagentReadOnlyComposer.tsx';
+/** Required services for conversation slots and session navigation. */
+export declare const inject: string[];
+/**
+ * Client plugin body: register the subagent catalog and read-only composer seats.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/client/locales.d.ts

@@ -0,0 +1,48 @@
+/** `subagent` namespace dictionaries. */
+/** Dictionary namespace owned by this plugin. */
+export declare const NS = "subagent";
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    readonly 'diagnostic.corrupt': "会话记录损坏";
+    readonly 'diagnostic.unsupported': "子代理记录版本不受支持";
+    readonly 'diagnostic.unavailable': "会话记录暂不可用";
+    readonly 'duration.seconds': "{seconds}秒";
+    readonly 'duration.minutes': "{minutes}分{seconds}秒";
+    readonly 'duration.hours': "{hours}小时{minutes}分{seconds}秒";
+    readonly 'duration.days': "{days}天";
+    readonly 'duration.daysHours': "{days}天{hours}小时";
+    readonly 'duration.months': "约{months}个月";
+    readonly 'duration.monthsDays': "约{months}个月{days}天";
+    readonly 'duration.years': "约{years}年";
+    readonly 'duration.yearsMonths': "约{years}年{months}个月";
+    readonly 'duration.exactDays': "{days}天{hours}小时{minutes}分{seconds}秒";
+    readonly 'duration.exactTitle': "总活跃耗时：{duration}";
+    readonly 'tokens.thousand': "{value}K";
+    readonly 'tokens.million': "{value}M";
+    readonly 'tokens.total': "{value} tok";
+    readonly 'loading.label': "正在加载子代理…";
+    readonly 'loading.aria': "正在加载子代理";
+    readonly 'load.error': "无法加载子代理";
+    readonly retry: "重试";
+    readonly 'mode.oneShot': "一次性";
+    readonly 'mode.continuable': "可继续";
+    readonly 'activity.running': "正在运行";
+    readonly 'activity.inactive': "当前未运行";
+    readonly 'branch.collapse': "收起 {label} 的下级子代理";
+    readonly 'branch.expand': "展开 {label} 的下级子代理";
+    readonly 'count.total.one': "{count} 个子代理";
+    readonly 'count.total.other': "{count} 个子代理";
+    readonly 'count.running.one': "{count} 个子代理，正在运行";
+    readonly 'count.running.other': "{count} 个子代理，正在运行";
+    readonly 'switcher.aria': "切换子代理：{title}";
+    readonly 'tree.aria': "子代理会话";
+    readonly 'readonly.oneShot.title': "一次性子代理记录";
+    readonly 'readonly.title': "此子代理暂时只读";
+    readonly 'readonly.oneShot.body': "一次性任务不支持后续消息，可在这里查看完整执行记录。";
+    readonly 'readonly.body': "父会话当前不在线，重新打开父会话后即可继续发送消息。";
+};
+/** English dictionary, key-identical to the Chinese source of truth. */
+export declare const en: Record<SubagentKey, string>;
+/** Key domain of the `subagent` namespace (zh is the source of truth). */
+export type SubagentKey = keyof typeof zh;
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/client/subagent-lineage.d.ts

@@ -0,0 +1,21 @@
+/** UI Subagent-owned projection of descendant counts from Session summaries. */
+import type { SessionId } from '@prettier-ai/dsh-session/types';
+interface LineageEntry {
+    readonly id: SessionId;
+    readonly parentId?: SessionId;
+    readonly origin?: 'subagent';
+    readonly running: boolean;
+}
+/** Descendant counts for one possible parent Session. */
+export interface SubagentDescendantSummary {
+    readonly count: number;
+    readonly runningCount: number;
+}
+/**
+ * Index uninterrupted subagent descendants under each ancestor.
+ * @param summaries - Session summaries keyed by id.
+ * @returns descendant totals keyed by possible parent id.
+ */
+export declare function indexSubagentDescendants(summaries: Readonly<Record<SessionId, LineageEntry>>): ReadonlyMap<SessionId, SubagentDescendantSummary>;
+export {};
+//# sourceMappingURL=subagent-lineage.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Subagent reference plugin, node half. Pure UI plugin: the empty apply
+ * exists so the plugin appears in the host cordis.yml / Loader; the browser
+ * half ships via exports["./client"], discovered through the package.json
+ * dsh.client declaration.
+ */
+/** Host plugin body — no host-side behavior for this source plugin. */
+export declare function apply(): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@prettier-ai/dsh-client-ui-subagent`.
+ * @module @prettier-ai/dsh-client-ui-subagent/invariant
+ */
+import type { Context } from '@prettier-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "client-ui-subagent-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/package.json

@@ -0,0 +1,90 @@
+{
+  "name": "@prettier-ai/dsh-client-ui-subagent",
+  "description": "Subagent conversation catalog, continuation routing UI, and '@' reference source",
+  "version": "0.1.2-alpha.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/client/ui-subagent"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@prettier-ai/dsh-api-session-controller",
+        "@prettier-ai/dsh-client-locale",
+        "@prettier-ai/dsh-client-ui-conversation",
+        "@prettier-ai/dsh-client-ui-primitives",
+        "@prettier-ai/dsh-client-ui-input-trigger"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "@prettier-ai/dsh-client-locale": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-conversation": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-input-trigger": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-subagent": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-token-meter": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-connection": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-invariants": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-api-session-controller": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-renderer": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-session": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-session": "^0.1.2-alpha.1",
+    "@prettier-ai/cordis": "^4.0.1"
+  },
+  "devDependencies": {
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "~18.3.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "@prettier-ai/dsh-client-locale": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-test-runtime": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-input-trigger": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-slots": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-primitives": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-conversation": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-invariants": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-subagent": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-token-meter": "^0.1.2-alpha.1",
+    "@prettier-ai/cordis": "^4.0.1",
+    "@prettier-ai/dsh-api-session-controller": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-connection": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-session": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-renderer": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-session": "^0.1.2-alpha.1"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
+}