@ftai/dsh-plugin-acn 0.0.0-stage → 0.1.1

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

@@ -0,0 +1,24 @@
+import type { ButtonHTMLAttributes, ReactNode, RefObject } from 'react';
+import type { Copy } from './interaction-ui.js';
+type IconName = 'network' | 'chevron' | 'book' | 'sync' | 'recap' | 'settings' | 'check' | 'user' | 'close';
+export declare function Icon({ name, size }: {
+    name: IconName;
+    size?: number;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function MenuItem({ icon, children, ...props }: ButtonHTMLAttributes<HTMLButtonElement> & {
+    icon: IconName;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function ComposerMenu({ anchor, close, id, label, children }: {
+    anchor: RefObject<HTMLButtonElement>;
+    close: () => void;
+    id: string;
+    label: string;
+    children: ReactNode;
+}): import("react").ReactPortal;
+export declare function Notice({ children, c, close, failed }: {
+    children: ReactNode;
+    c: Copy;
+    close: () => void;
+    failed?: boolean;
+}): import("react").ReactPortal;
+export {};

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

@@ -0,0 +1,11 @@
+import type { ConfigurationResult, ConfigurationSnapshot, SaveConfiguration } from '../configuration.js';
+import type { ConfigurationText } from './locales.js';
+export interface ConfigurationApi {
+    read: (signal?: AbortSignal) => Promise<ConfigurationSnapshot>;
+    save: (request: SaveConfiguration) => Promise<ConfigurationResult>;
+}
+export interface ConfigurationPageProps {
+    api: ConfigurationApi;
+    t: (key: ConfigurationText) => string;
+}
+export declare function ConfigurationPage({ api, t }: ConfigurationPageProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,12 @@
+import type { InteractionResult } from '../interaction.js';
+import type { Copy } from './interaction-ui.js';
+export type ConnectionCheckResult = {
+    message: string;
+    checks: InteractionResult['checks'];
+    failed: boolean;
+};
+export declare function ConnectionCheckDialog({ result, close, c }: {
+    result: ConnectionCheckResult;
+    close: () => void;
+    c: Copy;
+}): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,6 @@
+import type { Copy } from './interaction-ui.js';
+export declare function KnowledgeDetail({ text, c, openClaim }: {
+    text: string;
+    c: Copy;
+    openClaim: (id: string) => void;
+}): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,11 @@
+import type { InteractionApi } from './TeamSettingsPage.js';
+import type { Copy } from './interaction-ui.js';
+export declare function KnowledgeDirectoryField({ value, change, busy, api, c, label, feedback }: {
+    value: string;
+    change: (path: string) => void;
+    busy: boolean;
+    api: InteractionApi;
+    c: Copy;
+    label: string;
+    feedback: (text: string, failed?: boolean) => void;
+}): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,12 @@
+import type { InteractionApi } from './TeamSettingsPage.js';
+import type { Copy } from './interaction-ui.js';
+export declare function KnowledgePanel({ api, initialKey, initialTab, showHeading, c, openSource, openSettings, openComponents }: {
+    api: InteractionApi;
+    initialKey: string;
+    initialTab?: 'knowledge' | 'activity';
+    showHeading?: boolean;
+    c: Copy;
+    openSource?: (id: string) => void;
+    openSettings?: (() => void) | undefined;
+    openComponents?: (() => void) | undefined;
+}): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,13 @@
+import type { InteractionApi } from './TeamSettingsPage.js';
+import type { Copy } from './interaction-ui.js';
+export declare function KnowledgeReference({ api, runtimeKey, id, from, origin, c, back, openClaim, openSource }: {
+    api: InteractionApi;
+    runtimeKey: string;
+    id: string;
+    from: string;
+    origin?: HTMLElement | null;
+    c: Copy;
+    back: () => void;
+    openClaim: (id: string, from: string) => void;
+    openSource?: ((id: string) => void) | undefined;
+}): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,16 @@
+import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { InteractionApi } from './TeamSettingsPage.js';
+import type { SessionView } from '../interaction.js';
+import type { SettingsTab } from './TeamSettingsPage.js';
+import type { Copy } from './interaction-ui.js';
+type Props = Pick<PropsRuntime<'conversation.input.left'>, 'sessionId' | 'useSession'> & {
+    api: InteractionApi;
+    c: Copy;
+    block: (id: string, reason?: string) => void;
+    openSettings: (tab?: SettingsTab) => void;
+    openKnowledge: (key: string, activity?: boolean) => void;
+    suppressed?: boolean;
+};
+export declare const composerBlockReason: (view: SessionView, c?: Copy) => string | undefined;
+export declare function SessionToolbar(props: Props): import("react/jsx-runtime").JSX.Element | null;
+export {};

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

@@ -0,0 +1,3 @@
+export declare function SettingsToast({ text }: {
+    text: string;
+}): import("react").ReactPortal | null;

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

@@ -0,0 +1,16 @@
+import type { SourceSession } from '../interaction.js';
+import type { InteractionApi } from './TeamSettingsPage.js';
+import type { Copy } from './interaction-ui.js';
+export declare function SourceSessionLink({ source, api, c, open, label: customLabel }: {
+    label?: string | undefined;
+    source: SourceSession;
+    api: InteractionApi;
+    c: Copy;
+    open?: ((id: string) => void) | undefined;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function KnowledgeSources({ sources, api, c, open }: {
+    sources?: SourceSession[] | undefined;
+    api: InteractionApi;
+    c: Copy;
+    open?: ((id: string) => void) | undefined;
+}): import("react/jsx-runtime").JSX.Element | null;

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

@@ -0,0 +1,16 @@
+import type { CredentialRequest, CredentialResult } from '../credentials.js';
+import type { Copy } from './interaction-ui.js';
+type CredentialApi = (request: CredentialRequest, signal?: AbortSignal) => Promise<CredentialResult>;
+export declare function TeamCredentialField({ reference, api, c, disabled, value, change, refresh, removed, bound, remove }: {
+    reference: string;
+    api?: CredentialApi | undefined;
+    c: Copy;
+    disabled: boolean;
+    value: string;
+    change: (value: string) => void;
+    refresh: number;
+    removed?: boolean;
+    bound?: boolean;
+    remove?: () => void;
+}): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,28 @@
+import type { ConfigurationApi } from './ConfigurationPage.js';
+import type { ConfigurationValues } from '../configuration.js';
+import type { InteractionRequest, InteractionResult } from '../interaction.js';
+import type { CredentialRequest, CredentialResult } from '../credentials.js';
+import type { ConfigurationText } from './locales.js';
+export interface InteractionApi extends ConfigurationApi {
+    interact: (request: InteractionRequest, signal?: AbortSignal) => Promise<InteractionResult>;
+    credential?: (request: CredentialRequest, signal?: AbortSignal) => Promise<CredentialResult>;
+    pickDirectory?: () => Promise<string | null>;
+}
+export type SettingsTab = 'upstreams' | 'knowledge' | 'preferences';
+export interface TeamSettingsProps {
+    api: InteractionApi;
+    t: (key: ConfigurationText) => string;
+    openKnowledge: (key: string) => void;
+    initialTab?: SettingsTab;
+    openPlugins?: (() => void) | undefined;
+}
+export declare function settingsUpstreams(values: ConfigurationValues): Record<string, {
+    name: string;
+    agentId: string & import("zod").$brand<"AgentId">;
+    enabled: boolean;
+    routerEndpoint: string;
+    maintainerEndpoint: string;
+    keyEnv: string;
+    timeoutMs: number;
+}>;
+export declare function TeamSettingsPage({ api, t, openKnowledge, initialTab, openPlugins }: TeamSettingsProps): import("react/jsx-runtime").JSX.Element;

package/lib/types/client/configuration-errors.d.ts

@@ -0,0 +1,2 @@
+import type { Copy } from './interaction-ui.js';
+export declare function configurationFieldError(path: string, c: Copy): string;

package/lib/types/client/interaction-styles.d.ts

@@ -0,0 +1 @@
+export declare const interactionStyles = "\n.acn-trigger,.acn-item,.acn-tab,.acn-dismiss{color:inherit;background:transparent;border:0;font:inherit;cursor:pointer}\n.acn-trigger{height:28px;display:inline-flex;flex:none;align-items:center;gap:5px;padding:0 7px;border-radius:7px;white-space:nowrap;color:var(--dsw-alias-label-secondary,GrayText);font-size:var(--dsh-content-font-size-secondary,13px);line-height:1;font-weight:500}\n.acn-short-label{max-width:145px;overflow:hidden;text-overflow:ellipsis}\n.acn-trigger:hover,.acn-trigger[aria-expanded=true],.acn-item:not(:disabled):not([aria-disabled=true]):hover,.acn-dismiss:hover,.acn-tab:hover{background:var(--dsw-alias-interactive-bg-hover,var(--dsw-alias-bg-layer-2,#8882))}\n.acn-trigger:focus-visible,.acn-item:focus-visible,.acn-tab:focus-visible,.acn-dismiss:focus-visible,.acn-btn:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary,Highlight);outline-offset:1px}\n.acn-mark{position:relative;display:inline-flex}\n.acn-mark[data-state]::after{content:\"\";position:absolute;right:-2px;top:-2px;width:6px;height:6px;border:1px solid var(--dsw-alias-bg-base,Canvas);border-radius:50%;background:var(--dsw-alias-state-business-primary,#4268bd)}\n.acn-mark[data-state=warning]::after{background:var(--dsw-alias-state-warning-primary,#b76b09)}\n.acn-mark[data-state=team]::after{background:var(--dsw-alias-state-success-primary,#268353)}\n@container (max-width:420px){.acn-trigger .acn-short-label,.acn-trigger .acn-chevron{display:none}}\n.acn-surface{box-sizing:border-box;color:var(--dsw-alias-label-primary,CanvasText);background:var(--dsw-alias-bg-layer-1,Canvas);border:1px solid var(--dsw-alias-border-l2,#8884);border-radius:12px;box-shadow:0 6px 24px #0002}\n.acn-menu{position:fixed;z-index:10001;width:min(276px,calc(100vw - 16px));padding:6px;overflow:auto;overscroll-behavior:contain;font-size:13px}\n.acn-menu p{margin:5px 7px;color:var(--dsw-alias-label-secondary,GrayText);font-size:12px;line-height:1.5;overflow-wrap:anywhere}\n.acn-separator{border:0;border-top:1px solid var(--dsw-alias-border-l1,#8883);margin:5px 2px}\n.acn-item{display:flex;align-items:center;gap:9px;width:100%;text-align:start;border-radius:6px;padding:6px 8px;min-height:32px;line-height:1.4;overflow-wrap:anywhere}\n.acn-item svg,.acn-trigger svg{flex:none}.acn-item:disabled,.acn-item[aria-disabled=true],.acn-btn:disabled{opacity:.5;cursor:default}\n.acn-item small{margin-inline-start:auto;color:var(--dsw-alias-label-secondary,GrayText);font-size:11px;white-space:nowrap}\n.acn-notice{position:fixed;z-index:10000;inset-block-start:16px;inset-inline-end:16px;width:max-content;max-width:min(360px,calc(100vw - 32px));padding:10px 12px;display:flex;align-items:flex-start;gap:10px;font-size:13px;line-height:1.5;overflow-wrap:anywhere}\n.acn-notice p{margin:3px 0}.acn-dismiss{display:inline-grid;place-items:center;flex:none;width:26px;height:26px;border-radius:6px;color:var(--dsw-alias-label-secondary,GrayText)}\n/* \u8BBE\u7F6E\u4E0E\u6D4F\u89C8\u9875\u5171\u7528\u7D27\u51D1\u7684\u5B57\u53F7\u548C\u95F4\u8DDD\uFF1B\u4E0D\u8986\u76D6\u5BBF\u4E3B\u6216\u5176\u4ED6\u63D2\u4EF6\u3002 */\n.acn-page{--acn-accent:var(--dsw-alias-state-business-primary,#1976ed);box-sizing:border-box;width:100%;min-width:0;max-width:960px;margin:0 auto;padding:8px 0 24px;text-align:start;font-size:14px;line-height:1.5;color:var(--dsw-alias-label-primary,CanvasText)}\n.acn-page p,.acn-page dl,.acn-page dd,.acn-page h2,.acn-page h3{margin:0}.acn-page p{line-height:1.6}.acn-page a{color:var(--acn-accent)}\n.acn-page-heading{margin-bottom:22px}.acn-page-heading h2{font-size:22px;line-height:1.35;font-weight:650;margin:0 0 7px}.acn-page-heading p,.acn-description{font-size:13px;color:var(--dsw-alias-label-secondary,GrayText);line-height:1.6;margin-bottom:18px}\n.acn-tabs{display:flex;gap:4px;align-items:stretch;border-bottom:1px solid var(--dsw-alias-border-l2,#8883);margin:0 0 22px}\n.acn-tab{display:inline-flex;align-items:center;justify-content:center;min-height:36px;padding:7px 12px;font-size:13px;line-height:20px;color:var(--dsw-alias-label-secondary,GrayText);border-bottom:2px solid transparent;border-radius:7px 7px 0 0}\n.acn-tab[aria-selected=true]{border-bottom-color:var(--acn-accent);color:var(--dsw-alias-label-primary,CanvasText);font-weight:600}\n.acn-kind-tabs{display:flex;gap:5px;margin-bottom:16px}.acn-kind-tabs .acn-tab{border:0;border-radius:9px;min-height:32px;padding:5px 12px}.acn-kind-tabs .acn-tab[aria-selected=true]{background:var(--dsw-alias-bg-layer-2,#8881)}\n.acn-page h3,.acn-section-title{font-size:13px;font-weight:600;line-height:20px;margin:24px 0 11px}.acn-page form h3{font-size:17px;line-height:24px;margin:0 0 20px}\n.acn-page .acn-field{display:flex;flex-direction:column;gap:7px;font-size:13px;font-weight:500;line-height:20px;margin:18px 0}.acn-help{display:block;font-size:12px;font-weight:400;line-height:1.6;color:var(--dsw-alias-label-secondary,GrayText)}\n.acn-page .acn-help{margin-top:4px}.acn-form-grid,.acn-connection-fields{display:grid;grid-template-columns:repeat(auto-fit,minmax(min(100%,230px),1fr));gap:14px 20px}.acn-form-grid .acn-field,.acn-connection-fields .acn-field{margin:0}\n.acn-connection-fields{margin:20px 0 18px}.acn-actions,.acn-filterbar{display:flex;align-items:center;gap:9px;flex-wrap:wrap;margin:16px 0}.acn-filterbar{margin:0 0 20px}.acn-filterbar input{flex:1 1 220px}.acn-select{display:inline-flex;position:relative;max-width:100%;min-width:0}.acn-select select{min-width:138px;border-radius:999px}.acn-select svg{position:absolute;right:11px;top:50%;transform:translateY(-50%);pointer-events:none}\n.acn-setting-group,.acn-profiles{border:1px solid var(--dsw-alias-border-l1,#8883);border-radius:14px;overflow:hidden;margin:12px 0 20px;background:var(--dsw-alias-bg-layer-1,Canvas)}\n.acn-row{display:flex;align-items:center;justify-content:space-between;gap:12px 24px;flex-wrap:wrap;padding:16px 18px;border-bottom:1px solid var(--dsw-alias-border-l1,#8883)}.acn-row:last-child{border-bottom:0}.acn-row strong{font-size:13px;font-weight:550;line-height:20px}.acn-row>div:first-child{flex:1 1 220px;min-width:0;overflow-wrap:anywhere}.acn-row>div:last-child{display:flex;align-items:center;gap:8px;flex-wrap:wrap;min-width:0;max-width:100%}\n.acn-btn{display:inline-flex;align-items:center;justify-content:center;gap:6px;box-sizing:border-box;min-height:32px;width:auto;border:1px solid var(--dsw-alias-border-l2,#8884);border-radius:999px;padding:5px 12px;background:var(--dsw-alias-bg-layer-1,Canvas);color:inherit;font:inherit;font-size:12px;font-weight:500;line-height:20px;cursor:pointer;text-decoration:none}\n.acn-btn:not(:disabled):hover{background:var(--dsw-alias-interactive-bg-hover,var(--dsw-alias-bg-layer-2,#8881))}.acn-primary{background:var(--acn-accent,var(--dsw-alias-state-business-primary,#1976ed));border-color:transparent;color:#fff}.acn-primary:not(:disabled):hover{background:var(--acn-accent,var(--dsw-alias-state-business-primary,#1976ed));filter:brightness(.94)}.acn-text-button{border-color:transparent;background:transparent;color:var(--acn-accent,var(--dsw-alias-state-business-primary,#1976ed))}\n.acn-switch,.acn-page input[role=switch]{appearance:none;width:34px;height:20px;box-sizing:border-box;flex:none;cursor:pointer;border:1px solid var(--dsw-alias-border-l2,#8885);border-radius:20px;background:var(--dsw-alias-bg-layer-2,#8884);display:inline-grid;align-items:center;padding:2px;margin:0}.acn-switch::after,.acn-page input[role=switch]::after{content:\"\";width:14px;height:14px;border-radius:50%;background:var(--dsw-alias-bg-layer-1,Canvas);box-shadow:0 1px 3px #0002}.acn-switch:checked,.acn-page input[role=switch]:checked{background:var(--acn-accent,var(--dsw-alias-state-business-primary,#1976ed));border-color:transparent}.acn-switch:checked::after,.acn-page input[role=switch]:checked::after{transform:translateX(13px);background:#fff}\n.acn-disclosure{margin:20px 0;border:1px solid var(--dsw-alias-border-l1,#8883);border-radius:12px}.acn-disclosure>summary{display:flex;align-items:center;justify-content:space-between;gap:14px;padding:14px 16px;cursor:pointer;list-style:none;font-size:13px;line-height:20px}.acn-disclosure>summary::-webkit-details-marker{display:none}.acn-disclosure>summary::after{content:\"\u2304\";color:var(--dsw-alias-label-secondary,GrayText);font-size:17px;flex:none}.acn-disclosure[open]>summary::after{transform:rotate(180deg)}.acn-disclosure-body,.acn-advanced-body{padding:2px 16px 16px}.acn-disclosure-body>input{margin:4px 0 8px}\n.acn-feedback{padding:10px 12px;margin:12px 0!important;font-size:13px;border-radius:8px;background:var(--dsw-alias-bg-layer-2,#8881);white-space:pre-line}.acn-feedback.is-error{color:var(--dsw-alias-state-error-primary,#b42318)}.acn-status-list{display:grid;gap:9px;margin:12px 0}.acn-status-row{display:flex;align-items:flex-start;gap:9px;font-size:12px;line-height:20px}.acn-status-row strong{min-width:78px;font-weight:500}.acn-status-row .acn-status-icon{width:18px;flex:none}\n.acn-settings-page>.acn-tabs{margin-bottom:16px}.acn-settings-page>.acn-tabs+[role=tabpanel]{display:flex;flex-direction:column;gap:12px}\n.acn-settings-page>.acn-tabs+[role=tabpanel]>.acn-feedback{margin:0!important;padding:8px 10px;font-size:12px;line-height:20px}\n.acn-settings-page>.acn-tabs+[role=tabpanel]>.acn-profiles,.acn-settings-page>.acn-tabs+[role=tabpanel]>.acn-setting-group,.acn-settings-page>.acn-tabs+[role=tabpanel]>.acn-disclosure,.acn-settings-page>.acn-tabs+[role=tabpanel]>.acn-actions{margin:0}\n.acn-settings-page .acn-settings-intro{margin:0;font-size:12px;line-height:20px;color:var(--dsw-alias-label-secondary,GrayText)}.acn-settings-page form h3{margin:0 0 16px}.acn-settings-page form>.acn-field:first-of-type{margin-top:0}\n.acn-row-title{display:flex;align-items:center;gap:8px;flex-wrap:wrap}.acn-profile-kind[data-mode=solo]{background:color-mix(in srgb,var(--dsw-alias-state-success-primary,#087e65) 10%,transparent);color:var(--dsw-alias-state-success-primary,#087e65)}.acn-profile-kind[data-mode=team]{background:color-mix(in srgb,var(--acn-accent) 10%,transparent);color:var(--acn-accent)}.acn-badge.acn-profile-default{background:color-mix(in srgb,var(--dsw-alias-state-warning-primary,#a96606) 10%,transparent);color:var(--dsw-alias-state-warning-primary,#a96606)}\n.acn-settings-page .acn-profile-options{margin:0 0 20px}.acn-back-link:disabled{opacity:.5;cursor:default}\n.acn-directory-control{display:flex;align-items:stretch;gap:8px;min-width:0}.acn-directory-input{flex:1;min-width:0;position:relative}.acn-directory-control>.acn-btn{flex:none;min-height:36px;white-space:nowrap}.acn-directory-picker{position:absolute;right:4px;top:4px;display:grid;place-items:center;width:28px;height:28px;padding:0;border:0;border-radius:6px;color:var(--dsw-alias-label-secondary,GrayText);background:transparent;cursor:pointer}.acn-directory-picker:hover{background:var(--dsw-alias-interactive-bg-hover,#8881)}.acn-directory-picker:focus-visible{outline:2px solid var(--acn-accent);outline-offset:1px}.acn-directory-picker:disabled{opacity:.45;cursor:default}\n.acn-settings-toast{position:fixed;z-index:10004;top:24px;left:50%;transform:translateX(-50%);display:flex;align-items:center;gap:9px;box-sizing:border-box;max-width:min(560px,calc(100vw - 32px));padding:10px 18px;border-radius:999px;background:var(--dsw-alias-bg-layer-1,Canvas);color:var(--dsw-alias-label-primary,CanvasText);box-shadow:0 2px 8px #0003;font-size:13px;line-height:20px;overflow-wrap:anywhere;pointer-events:none;animation:acn-toast-enter .18s ease-out backwards;transition:opacity .22s ease-out,transform .22s ease-out}.acn-toast-dot{width:6px;height:6px;border-radius:50%;background:var(--dsw-alias-state-business-primary,#1976ed);flex:none}.acn-settings-toast.is-leaving{opacity:0;transform:translate(-50%,-6px)}\n@keyframes acn-toast-enter{from{opacity:0;transform:translate(-50%,-8px)}to{opacity:1;transform:translate(-50%,0)}}\n.acn-modal.acn-confirm{width:min(420px,100%);border-radius:16px}.acn-confirm .acn-modal-header{padding:20px 22px 8px}.acn-confirm .acn-modal-body{padding:4px 22px 20px}.acn-confirm-message{font-size:14px;line-height:1.7;margin:0;overflow-wrap:anywhere}.acn-confirm-message strong{font-weight:600}.acn-confirm-actions{display:flex;justify-content:flex-end;gap:8px;margin-top:24px}.acn-confirm-actions .acn-btn{min-width:72px}\n@media (prefers-reduced-motion:reduce){.acn-settings-toast{animation:none;transition:none}}\n.acn-backbar{display:flex;justify-content:flex-start;width:100%;margin:0 0 20px!important;text-align:start}.acn-back-link{display:inline-flex;align-items:center;gap:7px;padding:4px 0;border:0;background:transparent;font:inherit;font-size:12px;line-height:20px;color:var(--dsw-alias-label-secondary,GrayText);cursor:pointer}\n.acn-entity{border-bottom:1px solid var(--dsw-alias-border-l1,#8883)}.acn-entity>summary{display:flex;align-items:flex-start;justify-content:space-between;gap:16px;list-style:none;padding:14px 8px;cursor:pointer;border-radius:8px}.acn-entity>summary::-webkit-details-marker{display:none}.acn-entity>summary:hover{background:var(--dsw-alias-interactive-bg-hover,#8881)}.acn-entity-main{display:block;min-width:0;flex:1}.acn-entity-title{display:flex;align-items:center;gap:8px;flex-wrap:nowrap;line-height:20px;font-size:13px}.acn-entity-title strong{font-weight:550;min-width:0;flex:1;max-width:100%;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.acn-entity-title .acn-badge,.acn-entity-id{flex:none}.acn-source-sessions{margin-top:18px;display:grid;gap:4px}.acn-source-link .acn-btn{padding:0;min-height:24px;white-space:normal;text-align:start;overflow-wrap:anywhere;justify-content:flex-start}.acn-entity-id{color:var(--dsw-alias-label-secondary,GrayText);font-size:11px;font-family:ui-monospace,monospace}.acn-entity-preview{display:-webkit-box;-webkit-box-orient:vertical;-webkit-line-clamp:1;overflow:hidden;margin-top:5px;font-size:12px;line-height:19px;color:var(--dsw-alias-label-secondary,GrayText)}.acn-time{flex:none;font-size:11px;line-height:20px;font-variant-numeric:tabular-nums;color:var(--dsw-alias-label-secondary,GrayText);white-space:nowrap}\n.acn-badge{display:inline-flex;align-items:center;gap:4px;min-height:19px;padding:0 7px;font-size:11px;line-height:19px;font-weight:500;border-radius:999px;background:var(--dsw-alias-bg-layer-2,#8881);color:var(--dsw-alias-label-secondary,GrayText)}.acn-badge[data-tone=positive]{background:#16876a14;color:var(--dsw-alias-state-success-primary,#087e65)}.acn-badge[data-tone=warning]{background:#c77b1014;color:var(--dsw-alias-state-warning-primary,#a96606)}.acn-badge[data-tone=danger]{background:#c02e2e12;color:var(--dsw-alias-state-error-primary,#b42318)}\n.acn-entity-detail{padding:10px 10px 20px}.acn-detail-fields{display:grid;gap:18px}.acn-detail-fields dt{font-size:12px;line-height:19px;color:var(--dsw-alias-label-secondary,GrayText);margin-bottom:5px}.acn-detail-fields dd{font-size:13px;line-height:1.7;white-space:pre-wrap;overflow-wrap:anywhere}.acn-inline-links{display:flex;gap:5px;flex-wrap:wrap}.acn-detail-meta{margin-top:20px;font-size:12px}.acn-detail-meta summary{cursor:pointer;color:var(--dsw-alias-label-secondary,GrayText);line-height:24px}.acn-detail-meta .acn-detail-fields{margin-top:12px;gap:10px}.acn-counts{display:flex;gap:12px;flex-wrap:wrap;font-size:12px;color:var(--dsw-alias-label-secondary,GrayText);margin:8px 0 18px}.acn-counts span{white-space:nowrap}.acn-empty{padding:30px 12px;text-align:center;color:var(--dsw-alias-label-secondary,GrayText);font-size:13px}.acn-pagination{display:flex;align-items:center;justify-content:space-between;gap:12px;margin-top:18px}.acn-pagination small{color:var(--dsw-alias-label-secondary,GrayText);font-size:11px}.acn-activity-summary{display:flex;align-items:baseline;gap:8px;flex-wrap:wrap}\n.acn-knowledge-shell{width:100%;min-width:0;max-width:960px;margin:0 auto}.acn-knowledge-shell>.acn-backbar{margin-bottom:12px!important}.acn-knowledge-header{display:flex;align-items:center;justify-content:space-between;flex-wrap:wrap;gap:12px;margin-bottom:18px}.acn-knowledge-header>.acn-page-heading,.acn-knowledge-header>.acn-filterbar{margin:0;max-width:100%}.acn-knowledge-header h2{font-size:20px;line-height:28px;margin:0}.acn-knowledge-header select{max-width:100%}.acn-kind-tabs .acn-tab[aria-selected=true]{background:var(--dsw-alias-interactive-bg-hover,#8882)}.acn-back-link:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary,Highlight);outline-offset:3px;border-radius:4px}\n.acn-reference-actions{display:flex;align-items:center;justify-content:space-between;gap:12px;margin-bottom:12px}.acn-reference-actions .acn-back-link{scroll-margin-top:64px}.acn-modal-body .acn-reference-actions .acn-back-link{scroll-margin-top:12px}.acn-reference h3{font-size:15px;line-height:22px;margin:16px 0 12px;overflow-wrap:anywhere}.acn-reference>p{overflow-wrap:anywhere}.acn-activity[open] .acn-entity-preview{-webkit-line-clamp:unset}.acn-activity-detail{display:flex;align-items:flex-start;flex-direction:column;gap:10px}.acn-activity-detail>p{margin:0!important;max-width:100%;overflow-wrap:anywhere}.acn-activity-detail .acn-counts{margin:0}.acn-activity-detail .acn-source-sessions{margin-top:4px}\n.acn-activity-card{padding:16px 8px;border-bottom:1px solid var(--dsw-alias-border-l1,#8883);display:flex;flex-direction:column;gap:7px;min-width:0}.acn-activity-card>header{display:flex;align-items:flex-start;justify-content:space-between;gap:12px}.acn-activity-title{display:flex;align-items:center;gap:8px;flex-wrap:wrap;min-width:0;font-size:13px;line-height:20px}.acn-activity-title strong{font-weight:550}.acn-activity-card .acn-activity-source{font-size:12px;line-height:19px;color:var(--dsw-alias-label-secondary,GrayText);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.acn-activity-outcome{font-size:12px;line-height:20px!important;overflow-wrap:anywhere}.acn-activity-links{display:flex;flex-wrap:wrap;gap:2px 14px}.acn-activity-links .acn-btn{min-height:24px;padding:0;max-width:100%;overflow-wrap:anywhere;justify-content:flex-start;font-family:ui-monospace,monospace}.acn-execution{font-size:12px;width:100%;min-width:0}.acn-execution>summary{cursor:pointer;color:var(--dsw-alias-label-secondary,GrayText);width:fit-content;line-height:24px;border-radius:4px}.acn-execution>summary:focus-visible{outline:2px solid var(--acn-accent);outline-offset:2px}.acn-execution-body{display:flex;flex-direction:column;gap:8px;padding:10px 0 3px;font-size:12px;line-height:20px;overflow-wrap:anywhere}.acn-execution-body .acn-counts{margin:0}.acn-activity-source-action{display:flex}.acn-activity-source-action .acn-btn{min-height:28px}.acn-activity-card .acn-activity-detail{gap:8px}\n.acn-modal-backdrop{position:fixed;inset:0;z-index:10002;background:#0005;display:grid;place-items:center;padding:clamp(8px,2vw,20px);box-sizing:border-box}\n.acn-modal{width:min(920px,100%);max-height:min(84dvh,800px);display:flex;flex-direction:column;overflow:hidden}.acn-modal-header{display:flex;align-items:center;justify-content:space-between;padding:18px 24px 14px;gap:12px}.acn-modal-header h2{font-size:16px;font-weight:600;line-height:1.5;margin:0}\n.acn-modal-body{overflow:auto;overscroll-behavior:contain;min-width:0;padding:0 24px 22px}.acn-command-result{font:inherit;font-size:12px;line-height:1.65;white-space:pre-wrap;overflow-wrap:anywhere;margin:8px 0 0}\n@media (max-width:600px){.acn-time{white-space:normal;max-width:90px;text-align:end}.acn-row{padding:14px}.acn-page-heading h2{font-size:20px}}\n@media (max-width:440px){.acn-tabs{gap:10px}.acn-modal-body{padding-inline:12px}.acn-notice{inset-inline-end:8px}}\n";

package/lib/types/client/interaction-ui.d.ts

@@ -0,0 +1,30 @@
+import type { CSSProperties, ReactNode, SelectHTMLAttributes, ButtonHTMLAttributes } from 'react';
+export type Copy = (zh: string, en: string) => string;
+export declare function configurationLabel(name: string, agentId: string): string;
+export declare const muted: CSSProperties;
+export declare const inputStyle: CSSProperties;
+export declare function Select(props: SelectHTMLAttributes<HTMLSelectElement>): import("react/jsx-runtime").JSX.Element;
+export declare function Button({ primary, className, ...props }: ButtonHTMLAttributes<HTMLButtonElement> & {
+    primary?: boolean;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function Row({ title, description, badges, children }: {
+    title: string;
+    description?: string;
+    badges?: ReactNode;
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function Tabs<K extends string>({ label, choices, value, change, children, disabled }: {
+    label: string;
+    choices: readonly (readonly [K, string])[];
+    value: K;
+    change: (key: K) => void;
+    children: ReactNode;
+    disabled?: boolean;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function Modal({ title, close, closeLabel, children, compact }: {
+    title: string;
+    close: () => void;
+    closeLabel: string;
+    children: ReactNode;
+    compact?: boolean;
+}): import("react").ReactPortal;

package/lib/types/client/knowledge-labels.d.ts

@@ -0,0 +1,5 @@
+import type { Copy } from './interaction-ui.js';
+export declare function knowledgeStatus(value: string, c: Copy): string;
+export declare function knowledgeConfidence(value: string, c: Copy): string;
+export declare function knowledgeDate(value: string | number): string;
+export declare function knowledgeLabels(c: Copy): Record<string, string>;

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

@@ -0,0 +1,51 @@
+export declare const en: {
+    readonly title: "Configuration";
+    readonly intro: "Distill reusable knowledge from agent work traces, and let experience flow across your team.";
+    readonly identity: "Agent and knowledge";
+    readonly agentId: "Agent ID";
+    readonly agentSoloHint: "In solo mode, choose any fixed name, such as personal, using lowercase letters, numbers, underscores or hyphens. It identifies local knowledge storage: projects and sessions using this configuration share the same knowledge. It does not change with the project; keep it stable after setup.";
+    readonly agentTeamHint: "Use a stable, unique ID for each team member, matching the identity authorized by your team services. Only lowercase letters, numbers, underscores or hyphens are allowed. This ID identifies the owner of shared knowledge.";
+    readonly home: "Knowledge directory";
+    readonly homeHint: "An absolute path or ~/ path on the DSH host. Each work configuration has an isolated directory under upstreams/. This is separate from the project workspace.";
+    readonly switchHint: "Changing the ID or directory switches to that storage location. Existing data stays in place; it is not migrated. Finish the current turn before saving. After changing identity or directory, old sessions and historical forks are blocked; start a new session.";
+    readonly model: "ACN background model";
+    readonly modelHint: "Used for Recap, Finalize, Inbox and Dream. The chat model is selected separately in DSH.";
+    readonly automatic: "Follow the session model";
+    readonly unavailableModel: "Unavailable — choose a registered model";
+    readonly modelHelp: "Models come from DSH Settings → Models. Add or configure a provider there, then reload this page.";
+    readonly connection: "Team connection";
+    readonly mode: "Mode";
+    readonly solo: "Solo";
+    readonly team: "Team";
+    readonly soloHint: "Solo mode makes no team requests and creates no new team upload tasks.";
+    readonly teamHint: "Connect both services to discover shared claims, deliver knowledge and internalize team messages.";
+    readonly router: "Router URL";
+    readonly maintainer: "Maintainer URL";
+    readonly keyEnv: "Team credential reference";
+    readonly keyHint: "Enter a credential reference here. Store its value below in DSH, or set the environment variable before starting the app. Both services must accept the member credential. Leave blank for local services without authentication.";
+    readonly timeout: "Team request timeout (ms)";
+    readonly timeoutHint: "Allow enough time for model reranking and arbitration; 180000 ms is useful for local model acceptance.";
+    readonly save: "Save and apply";
+    readonly saving: "Saving and reloading…";
+    readonly reload: "Reload saved configuration";
+    readonly loading: "Loading configuration…";
+    readonly saveHint: "Changes take effect only after you click Save and apply.";
+    readonly unsaved: "You have unsaved changes";
+    readonly noChanges: "No unsaved changes";
+    readonly reloadHint: "Unsaved changes will be discarded";
+    readonly saved: "Saved and applied. Open a new session to use this configuration.";
+    readonly directory: "Current agent data directory";
+    readonly active: "Knowledge service active";
+    readonly pending: "Set an Agent ID to get started";
+    readonly inactive: "Knowledge service inactive";
+    readonly errorLoad: "Could not load configuration. Check that the plugin and DSH configuration services are enabled, then retry.";
+    readonly errorTransport: "The save result could not be confirmed. Your draft is retained. Use Refresh and keep edits to check the saved configuration before retrying.";
+    readonly invalid: "Invalid configuration. Check these fields:";
+    readonly conflict: "Configuration changed in another window or on disk. Your draft is retained. Use Refresh and keep edits, review, then save.";
+    readonly busy: "An agent is still running. Finish or stop the current turn, then retry.";
+    readonly unavailable: "This model is no longer available. Configure it in DSH or choose another registered model.";
+    readonly persistence: "The save could not be confirmed. Check permissions, configuration overrides and plugin status, then use Refresh and keep edits.";
+    readonly activation: "Configuration was saved, but the knowledge service did not activate. Check the plugin status and host logs, then retry activation.";
+};
+export type ConfigurationText = keyof typeof en;
+export declare const zh: Record<ConfigurationText, string>;

package/lib/types/commands/claim.d.ts

@@ -0,0 +1,4 @@
+import type { AcnKnowledge } from '../knowledge/service.js';
+export declare function commandWords(input: string, literalBackslashes?: boolean): string[];
+export declare function claimCommand(knowledge: AcnKnowledge, input: string, readOnly: boolean, signal?: AbortSignal): Promise<string>;
+export declare function commandDomainError(error: unknown): string | undefined;

package/lib/types/commands/import.d.ts

@@ -0,0 +1,10 @@
+import type { AcnKnowledge } from '../knowledge/service.js';
+export interface ImportReport {
+    dryRun: boolean;
+    claims: string[];
+    traces: string[];
+    skipped: string[];
+}
+export declare function importWords(input: string, platform?: NodeJS.Platform): string[];
+export declare function importCommand(knowledge: AcnKnowledge, input: string, readOnly: boolean, signal?: AbortSignal): Promise<ImportReport>;
+export declare function renderImportReport(report: ImportReport): string;

package/lib/types/commands/status.d.ts

@@ -0,0 +1,5 @@
+import type { AcnKnowledge } from '../knowledge/service.js';
+export declare function statusCommand(knowledge: AcnKnowledge, options?: {
+    failed?: boolean;
+    page?: number;
+}): Promise<string>;

package/lib/types/config.d.ts

@@ -0,0 +1,111 @@
+import { z } from 'zod';
+export declare const UpstreamNameSchema: z.ZodString;
+export declare const UpstreamSchema: z.ZodObject<{
+    name: z.ZodDefault<z.ZodString>;
+    agentId: z.core.$ZodBranded<z.ZodString, "AgentId", "out">;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    routerEndpoint: z.ZodDefault<z.ZodString>;
+    maintainerEndpoint: z.ZodDefault<z.ZodString>;
+    keyEnv: z.ZodDefault<z.ZodString>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export type Upstream = z.infer<typeof UpstreamSchema>;
+export declare const ConnectionSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    agentId: z.core.$ZodBranded<z.ZodString, "AgentId", "out">;
+    routerEndpoint: z.ZodString;
+    maintainerEndpoint: z.ZodString;
+    keyEnv: z.ZodDefault<z.ZodString>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export type Connection = z.infer<typeof ConnectionSchema>;
+export declare const ConfigSchema: z.ZodObject<{
+    upstream: z.ZodDefault<z.ZodString>;
+    upstreams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        name: z.ZodDefault<z.ZodString>;
+        agentId: z.core.$ZodBranded<z.ZodString, "AgentId", "out">;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        routerEndpoint: z.ZodDefault<z.ZodString>;
+        maintainerEndpoint: z.ZodDefault<z.ZodString>;
+        keyEnv: z.ZodDefault<z.ZodString>;
+        timeoutMs: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>>;
+    agentId: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"">, z.core.$ZodBranded<z.ZodString, "AgentId", "out">]>>;
+    home: z.ZodDefault<z.ZodString>;
+    sessionEpoch: z.ZodDefault<z.ZodNumber>;
+    connections: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        agentId: z.core.$ZodBranded<z.ZodString, "AgentId", "out">;
+        routerEndpoint: z.ZodString;
+        maintainerEndpoint: z.ZodString;
+        keyEnv: z.ZodDefault<z.ZodString>;
+        timeoutMs: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>>;
+    defaultConnection: z.ZodDefault<z.ZodString>;
+    legacyEnabled: z.ZodDefault<z.ZodBoolean>;
+    showCompletion: z.ZodDefault<z.ZodBoolean>;
+    team: z.ZodPrefault<z.ZodObject<{
+        routerEndpoint: z.ZodDefault<z.ZodString>;
+        maintainerEndpoint: z.ZodDefault<z.ZodString>;
+        keyEnv: z.ZodDefault<z.ZodString>;
+        timeoutMs: z.ZodDefault<z.ZodNumber>;
+        routerTimeoutMs: z.ZodDefault<z.ZodNumber>;
+        retryCount: z.ZodDefault<z.ZodNumber>;
+        retryBaseDelayMs: z.ZodDefault<z.ZodNumber>;
+        retryMaxDelayMs: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>;
+    llm: z.ZodPrefault<z.ZodObject<{
+        provider: z.ZodDefault<z.ZodString>;
+        model: z.ZodDefault<z.ZodString>;
+        maxOutputTokens: z.ZodDefault<z.ZodNumber>;
+        timeoutMs: z.ZodDefault<z.ZodNumber>;
+        structuredRetries: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>;
+    catalog: z.ZodPrefault<z.ZodObject<{
+        maxClaims: z.ZodDefault<z.ZodNumber>;
+        maxChars: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>;
+    formation: z.ZodPrefault<z.ZodObject<{
+        recapOnCompaction: z.ZodDefault<z.ZodBoolean>;
+        idleRecap: z.ZodDefault<z.ZodBoolean>;
+        recapMinTurns: z.ZodDefault<z.ZodNumber>;
+        recapMinTokens: z.ZodDefault<z.ZodNumber>;
+        recapBatchIdleMinutes: z.ZodDefault<z.ZodNumber>;
+        recapTailIdleMinutes: z.ZodDefault<z.ZodNumber>;
+        recapScanSeconds: z.ZodDefault<z.ZodNumber>;
+        finalizeIdleMinutes: z.ZodDefault<z.ZodNumber>;
+        finalizeOnDispose: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    inbox: z.ZodPrefault<z.ZodObject<{
+        pullOnSessionStart: z.ZodDefault<z.ZodBoolean>;
+        processingStaleAfterSecs: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>;
+    dream: z.ZodPrefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        minIntervalHours: z.ZodDefault<z.ZodNumber>;
+        minChangedClaims: z.ZodDefault<z.ZodNumber>;
+        checkIntervalHours: z.ZodDefault<z.ZodNumber>;
+        evidenceCalibration: z.ZodDefault<z.ZodBoolean>;
+        maxModelSteps: z.ZodDefault<z.ZodNumber>;
+        maxWrapUpSteps: z.ZodDefault<z.ZodNumber>;
+        evidenceMaxCalls: z.ZodDefault<z.ZodNumber>;
+        evidenceMaxSteps: z.ZodDefault<z.ZodNumber>;
+        evidenceMaxBytes: z.ZodDefault<z.ZodNumber>;
+        evidenceMaxChars: z.ZodDefault<z.ZodNumber>;
+        evidenceMaxFiles: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ResolvedConfig = z.output<typeof ConfigSchema>;
+export type ConfigInput = z.input<typeof ConfigSchema>;
+export declare class ConfigError extends Error {
+    readonly fields: readonly string[];
+    readonly kind = "config";
+    constructor(fields: readonly string[]);
+}
+export declare function resolveConfig(input: unknown): ResolvedConfig;
+export declare function upstreamsOf(config: ResolvedConfig): Record<string, Upstream>;
+export declare function activeUpstream(config: ResolvedConfig): string;