@qilin-agent/client-ui-subagent 0.0.0-stage → 3.1.3

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
+* qilin.client declaration.
+*/
+/** Host plugin body — no host-side behavior for this source plugin. */
+function apply() {}
+//#endregion
+export { apply };

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

@@ -0,0 +1,30 @@
+import type { SubagentAddress } from '@qilin-agent/subagent/client';
+import type { SessionId } from '@qilin-agent/session/types';
+import type { PropsLocale, PropsRuntime } from '@qilin-agent/client-ui-slots';
+import { NS } from './locales.ts';
+/** Business actions supplied by the slot registration. */
+export interface SubagentCatalogInjected {
+    openChild: (address: SubagentAddress) => void;
+    openChildAside: (address: SubagentAddress) => void;
+    refreshProjection: (parentSessionId: SessionId) => void;
+}
+/** Full props for the session-header lineage renderer. */
+export type SubagentHeaderLineageProps = PropsRuntime<'conversation.session.header.lineage'> & SubagentCatalogInjected & PropsLocale<typeof NS>;
+/** Full props for the root-session catalog entry in the header actions band. */
+export type SubagentCatalogActionProps = PropsRuntime<'conversation.session.header.actions'> & SubagentCatalogInjected & PropsLocale<typeof NS>;
+/**
+ * Session-header catalog action for root sessions: the descendant count and
+ * its dropdown, ordered after the task list. Child sessions render nothing
+ * here — their breadcrumb switcher in the lineage slot owns the same
+ * navigation.
+ * @param props - Session standard props plus the catalog actions and translator.
+ * @returns The count dropdown, or null on a child session.
+ */
+export declare function SubagentCatalogAction({ sessionId, useSessions, useSessionStatus, openChild, openChildAside, refreshProjection, t, }: SubagentCatalogActionProps): import("react").JSX.Element | null;
+/**
+ * Render one breadcrumb title together with its subagent navigation.
+ * @param props - Breadcrumb title, session standard props, and catalog actions.
+ * @returns A title-and-chevron sibling switcher, or nothing on a root session.
+ */
+export declare function SubagentHeaderLineage({ lineageSessionId, displayTitle, openTitle, useSessions, useSession, useSessionStatus, openChild, openChildAside, refreshProjection, t, }: SubagentHeaderLineageProps): import("react").JSX.Element | null;
+//# sourceMappingURL=SubagentHeaderLineage.d.ts.map

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

@@ -0,0 +1,17 @@
+import type { PropsLocale, PropsRuntime } from '@qilin-agent/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' | 'unknown';
+}
+/** 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 '@qilin-agent/kylin';
+import { type SubagentKey } from './locales.ts';
+declare module '@qilin-agent/client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** Subagent catalog and read-only composer copy. */
+        'subagent': SubagentKey;
+    }
+}
+export type { SubagentCatalogActionProps, SubagentCatalogInjected, SubagentHeaderLineageProps, } from './SubagentHeaderLineage.tsx';
+export type { SubagentReadOnlyComposerProps, SubagentReadOnlyMatch, } from './SubagentReadOnlyComposer.tsx';
+/** Required services for subagent presentation and 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,49 @@
+/** `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 '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 'load.error': "无法加载子代理";
+    readonly retry: "重试";
+    readonly 'mode.oneShot': "一次性";
+    readonly 'mode.continuable': "可继续";
+    readonly 'mode.unknown': "模式未知";
+    readonly 'readonly.unknown.body': "读取子会话后才能确定是否可继续。";
+    readonly 'activity.running': "正在运行";
+    readonly 'activity.completed': "已完成";
+    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 'open.sidebar': "在侧边栏打开 {label}";
+    readonly 'sidebar.chat': "聊天";
+    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/sidebar-chat/index.d.ts

@@ -0,0 +1,62 @@
+/** Right-Sidebar presentation of an existing subagent Conversation. */
+import type { Context } from '@qilin-agent/kylin';
+import type { SessionReference } from '@qilin-agent/api-session-controller/client';
+import type { ConversationViewsProps } from '@qilin-agent/client-ui-conversation/client';
+import type { PropsRenderFactories, PropsRenderSlots, PropsRuntime, TranslateNS } from '@qilin-agent/client-ui-slots';
+import type { SubagentAddress } from '@qilin-agent/subagent/client';
+import type { NS } from '../locales.ts';
+/** Stable implementation identity for the Sidebar tab body. */
+export declare const SUBAGENT_CHAT_ID = "@qilin-agent/client-ui-subagent";
+/** Resource-address prefix for an embedded Session chat. */
+export declare const SUBAGENT_CHAT_ADDRESS = "qilin-resource://subagentchat/session/";
+/** Value retained by one live chat resource occurrence. */
+export interface SubagentChatResource {
+    readonly address: SubagentAddress;
+    readonly reference: SessionReference;
+}
+declare module '@qilin-agent/api-session-controller/client' {
+    interface SessionReferenceSourceMap {
+        sidebarChat: unknown;
+    }
+}
+declare module '@qilin-agent/client-ui-slots' {
+    interface ResourceProtocolMap {
+        subagentchat: SubagentChatResource;
+    }
+    interface SlotMap {
+        /** Session-scoped Conversation occurrence hosted by one Sidebar chat tab. */
+        'sidebar.chat.conversation': {
+            kind: 'single';
+            scope: 'session';
+        };
+    }
+}
+/**
+ * Address one subagent Session together with the routing facts needed to restore it.
+ * @param address - durable direct-parent subagent address.
+ * @returns canonical Sidebar resource address.
+ */
+export declare function subagentChatAddress(address: SubagentAddress): string;
+/**
+ * Parse one canonical Sidebar chat resource address.
+ * @param value - possible chat resource address.
+ * @returns the encoded direct-parent address, or undefined for another or malformed resource.
+ */
+export declare function parseSubagentChatAddress(value: string): SubagentAddress | undefined;
+/** Fixed Chat selection used by an embedded Conversation occurrence. */
+export declare function FixedChatConversationView(props: ConversationViewsProps): import("react").JSX.Element;
+/** Props supplied to the child-Session Conversation host. */
+export type ConversationSlotPanelProps = PropsRuntime<'sidebar.chat.conversation'> & PropsRenderFactories;
+/** Render the shared Conversation content for one explicitly provided child Session. */
+export declare function ConversationSlotPanel({ sessionId, useSession, useConversation, useSessions, renderFactorySlot, }: ConversationSlotPanelProps): import("react").ReactNode;
+/** Props supplied to the parent-Session Sidebar tab body. */
+export type SidebarChatTabProps = PropsRuntime<'sidebar.right.pane.tab'> & PropsRenderSlots<'sidebar.chat.conversation'>;
+/** Bind a chat resource's child reference around its Conversation slot. */
+export declare function SidebarChatTab({ useResource, useTabInfo, SessionProvider, renderSlot }: SidebarChatTabProps): import("react").JSX.Element;
+/**
+ * Register the chat resource owner and its right-Sidebar presentation.
+ * @param ctx - Client root carrying Sessions, resources, Slots, and Sidebar registries.
+ * @param t - Chat namespace translator used for fallback tab titles.
+ */
+export declare function registerSidebarChat(ctx: Context, t: TranslateNS<typeof NS>): void;
+//# sourceMappingURL=index.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
+ * qilin.client declaration.
+ */
+/** Host plugin body — no host-side behavior for this source plugin. */
+export declare function apply(): void;
+//# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,6 +1,84 @@
 {
   "name": "@qilin-agent/client-ui-subagent",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "description": "Subagent conversation catalog, continuation routing UI, and '@' reference source",
+  "version": "3.1.3",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kkutysllb/QiLin.git",
+    "directory": "packages/client/ui-subagent"
+  },
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "qilin": {
+    "client": {
+      "inject": [
+        "@qilin-agent/api-session-controller",
+        "@qilin-agent/client-locale",
+        "@qilin-agent/client-resources",
+        "@qilin-agent/client-ui-chat",
+        "@qilin-agent/client-ui-conversation",
+        "@qilin-agent/client-ui-primitives",
+        "@qilin-agent/client-ui-sidebar-right",
+        "@qilin-agent/client-ui-input-trigger",
+        "@qilin-agent/client-ui-workspace"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "@qilin-agent/kylin": "~4.0.3"
+  },
+  "devDependencies": {
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "~18.3.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "@qilin-agent/client-locale": "3.1.3",
+    "@qilin-agent/client-resources": "3.1.3",
+    "@qilin-agent/client-test-runtime": "3.1.3",
+    "@qilin-agent/client-ui-chat": "3.1.3",
+    "@qilin-agent/client-ui-conversation": "3.1.3",
+    "@qilin-agent/client-ui-input-trigger": "3.1.3",
+    "@qilin-agent/client-ui-primitives": "3.1.3",
+    "@qilin-agent/client-ui-slots": "3.1.3",
+    "@qilin-agent/subagent": "3.1.3",
+    "@qilin-agent/token-meter": "3.1.3",
+    "@qilin-agent/kylin": "~4.0.3",
+    "@qilin-agent/api-session-controller": "3.1.3",
+    "@qilin-agent/client-connection": "3.1.3",
+    "@qilin-agent/client-ui-renderer": "3.1.3",
+    "@qilin-agent/session": "3.1.3",
+    "@qilin-agent/client-ui-sidebar-right": "3.1.3",
+    "@qilin-agent/client-ui-session": "3.1.3",
+    "@qilin-agent/client-ui-workspace": "3.1.3"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
 }