@poco-ai/agentero-dsh-recommend 0.0.0-stage → 0.1.0

package/lib/client/index.d.ts

@@ -0,0 +1,74 @@
+import type { Context } from '@deepseek-ai/cordis';
+declare const zh: {
+    title: string;
+    arxivTab: string;
+    zhihuTab: string;
+    refresh: string;
+    computing: string;
+    probing: string;
+    addCategory: string;
+    categoryPlaceholder: string;
+    removeCategory: string;
+    categories: string;
+    expand: string;
+    collapse: string;
+    settings: string;
+    settingsDescription: string;
+    baseUrl: string;
+    apiKey: string;
+    model: string;
+    zhihuSecret: string;
+    save: string;
+    saving: string;
+    saved: string;
+    keyConfigured: string;
+    keyMissing: string;
+    secretConfigured: string;
+    secretMissing: string;
+    keepBlank: string;
+    close: string;
+    idle: string;
+    needsEmbedding: string;
+    probeFailed: string;
+    needsCorpus: string;
+    noCandidates: string;
+    retry: string;
+    openSettings: string;
+    updatedAt: string;
+    corpusCount: string;
+    import: string;
+    imported: string;
+    importing: string;
+    open: string;
+    actionFailed: string;
+    vaultMissing: string;
+    zhihuSearchPlaceholder: string;
+    zhihuSearch: string;
+    zhihuNote: string;
+    zhihuEmpty: string;
+    zhihuLoading: string;
+    zhihuRefresh: string;
+    answer: string;
+    article: string;
+    votes: string;
+    zhihuNoSecret: string;
+    zhihuEmptyQuery: string;
+    zhihuHint: string;
+};
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** Recommendation dock copy. */
+        'agentero.recommend': keyof typeof zh;
+    }
+}
+/** Browser plugin name. */
+export declare const name = "agentero-recommend";
+/** Slot and locale services. The dock renders inside the composer stack. */
+export declare const inject: string[];
+/**
+ * Dock the recommendation strip under the conversation composer.
+ * arXiv daily and Zhihu share one surface so neither takes a sidebar page.
+ * @param ctx - Browser plugin context.
+ */
+export declare function apply(ctx: Context): void;
+export {};

package/lib/client/recommend-dock.d.ts

@@ -0,0 +1,14 @@
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import { type ReactNode } from 'react';
+import { type RecommendFace } from './types';
+type RecommendDockProps = PropsLocale<'agentero.recommend'> & RecommendFace;
+/**
+ * Recommendation cards docked under the composer.
+ *
+ * arXiv daily ranking and Zhihu discussions share one compact strip so the
+ * surface never steals the conversation column. Results only refresh on
+ * request: mounting reads the host's same-day cache instead of re-embedding
+ * the whole library.
+ */
+export declare function RecommendDock({ t, loadSettings, saveSettings, probeEmbedding, loadArxiv, recommendArxiv, searchZhihu, importPaper, }: RecommendDockProps): ReactNode;
+export {};

package/lib/client/types.d.ts

@@ -0,0 +1,68 @@
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+export type RecommendT = PropsLocale<'agentero.recommend'>['t'];
+export interface EmbeddingSettingsView {
+    configured: boolean;
+    baseUrl: string;
+    model: string;
+    keyPresent: boolean;
+    source: 'agentero' | 'dsh' | 'none';
+}
+export interface SettingsView {
+    vaultConfigured: boolean;
+    embedding: EmbeddingSettingsView;
+    zhihu: {
+        configured: boolean;
+        source: 'agentero' | 'dsh' | 'none';
+    };
+}
+export interface ArxivRecommendItem {
+    arxivId: string;
+    title: string;
+    abstract: string;
+    url: string;
+    publishedAt?: string;
+    score: number;
+}
+export interface ArxivRecommendResult {
+    items: ArxivRecommendItem[];
+    computedAt: string;
+    categories: string[];
+    corpusSize: number;
+    reusedCache: boolean;
+}
+export interface ZhihuSearchItem {
+    kind: 'answer' | 'article';
+    title: string;
+    url: string;
+    excerpt: string;
+    author: string;
+    votes: number;
+    score: number;
+}
+export interface ProbeResult {
+    dim: number;
+    latencyMs: number;
+}
+export interface SettingsPatch {
+    embeddingBaseUrl?: string;
+    embeddingApiKey?: string;
+    embeddingModel?: string;
+    zhihuAccessSecret?: string;
+}
+export interface RecommendFace {
+    loadSettings(): Promise<SettingsView>;
+    saveSettings(patch: SettingsPatch): Promise<SettingsView>;
+    probeEmbedding(): Promise<ProbeResult>;
+    loadArxiv(categories: string[]): Promise<ArxivRecommendResult | null>;
+    recommendArxiv(categories: string[]): Promise<ArxivRecommendResult>;
+    searchZhihu(query: string, count?: number): Promise<ZhihuSearchItem[]>;
+    importPaper(text: string): Promise<void>;
+}
+export declare function errorText(body: unknown): string | undefined;
+export declare function settingsFrom(body: unknown): SettingsView;
+export declare function arxivFrom(body: unknown): ArxivRecommendResult | null;
+export declare function zhihuFrom(body: unknown): ZhihuSearchItem[];
+export declare function probeFrom(body: unknown): ProbeResult;
+export declare function reasonOf(message: string): 'noEmbedding' | 'probeFailed' | 'emptyCorpus' | 'noCandidates' | 'noSecret' | 'emptyQuery' | 'other';
+export declare function shown(message: string, t: RecommendT): string;
+export declare function messageOf(error: unknown): string;