@yushaw/sanqian-chat 0.2.2 → 0.2.4

package/dist/main/index.d.mts

@@ -8,6 +8,51 @@ import { BrowserWindow } from 'electron';
  * Application-facing types that hide SDK implementation details.
  * These provide a stable API even as the underlying SDK evolves.
  */
+/**
+ * Context data returned by a provider
+ */
+interface AppContextData {
+    /** Resource ID (for getById scenarios) */
+    id?: string;
+    /** Content to inject into conversation */
+    content: string;
+    /** Display title */
+    title?: string;
+    /** Summary for preview */
+    summary?: string;
+    /** Version for change detection (optional, Sanqian uses content hash if not provided) */
+    version?: string;
+}
+/**
+ * List item for context provider's getList method
+ */
+interface AppContextListItem {
+    /** Resource ID */
+    id: string;
+    /** Display title */
+    title: string;
+    /** Optional summary */
+    summary?: string;
+    /** Optional icon */
+    icon?: string;
+}
+/**
+ * Context provider definition
+ */
+interface AppContextProvider {
+    /** Provider ID (unique within app) */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Description */
+    description: string;
+    /** Get current state (for dynamic context) */
+    getCurrent?: () => Promise<AppContextData | null>;
+    /** Get list of available contexts */
+    getList?: () => Promise<AppContextListItem[]>;
+    /** Get full content by ID */
+    getById?: (id: string) => Promise<AppContextData | null>;
+}
 /**
  * Application configuration for connecting to Sanqian
  */
@@ -22,6 +67,8 @@ interface AppConfig {
     launchCommand?: string;
     /** Tools provided by this application */
     tools?: AppToolDefinition[];
+    /** Context providers for injecting app state */
+    contexts?: AppContextProvider[];
     /** Enable debug logging */
     debug?: boolean;
 }
@@ -66,8 +113,25 @@ interface AppAgentConfig {
     description?: string;
     /** System prompt */
     systemPrompt?: string;
-    /** Enabled tool names (without app prefix) */
+    /**
+     * Tools to enable. Supports:
+     * - Builtin: "file_ops", "run_bash", "web_search"
+     * - SDK: "myapp:tool_name" or just "tool_name" (auto-prefixed)
+     * - MCP: "mcp_server_tool"
+     * - Wildcard: ["*"]
+     */
     tools?: string[];
+    /**
+     * Skills to enable.
+     * @example ["pdf", "web-research", "xlsx"]
+     */
+    skills?: string[];
+    /**
+     * Context providers to attach by default.
+     * Uses provider ID without app prefix (auto-prefixed with appName).
+     * @example ["editor-state"] -> "sanqian-notes:editor-state"
+     */
+    attachedContexts?: string[];
 }
 /**
  * Embedding configuration from Sanqian
@@ -207,6 +271,40 @@ declare class SanqianAppClient {
      * Delete a conversation
      */
     deleteConversation(conversationId: string): Promise<void>;
+    /**
+     * List available capabilities (tools, skills, agents)
+     *
+     * @example
+     * ```typescript
+     * // List all tools
+     * const tools = await client.listCapabilities({ type: 'tool' });
+     *
+     * // List builtin tools only
+     * const builtinTools = await client.listCapabilities({ type: 'tool', source: 'builtin' });
+     * ```
+     */
+    listCapabilities(options?: _yushaw_sanqian_sdk.ListCapabilitiesOptions): Promise<_yushaw_sanqian_sdk.Capability[]>;
+    /**
+     * Search capabilities by query
+     *
+     * @example
+     * ```typescript
+     * const results = await client.searchCapabilities('file operations', { type: 'tool', limit: 5 });
+     * ```
+     */
+    searchCapabilities(query: string, options?: _yushaw_sanqian_sdk.SearchCapabilitiesOptions): Promise<_yushaw_sanqian_sdk.CapabilitySearchResult[]>;
+    /**
+     * List available tools
+     */
+    listTools(source?: 'builtin' | 'sdk' | 'mcp'): Promise<_yushaw_sanqian_sdk.ToolCapability[]>;
+    /**
+     * List available skills
+     */
+    listSkills(): Promise<_yushaw_sanqian_sdk.SkillCapability[]>;
+    /**
+     * List all available agents (not just own agents)
+     */
+    listAvailableAgents(): Promise<_yushaw_sanqian_sdk.AgentCapability[]>;
     /**
      * Get the underlying SDK instance
      * @internal This is for internal use by other sanqian-chat components
@@ -370,4 +468,4 @@ declare class FloatingWindow {
     getWindow(): BrowserWindow | null;
 }
 
-export { type AppAgentConfig, type AppClientEvent, type AppClientEventHandlers, type AppConfig, type AppEmbeddingConfig, type AppJsonSchemaProperty, type AppToolDefinition, type ChatUiConfigSerializable, FloatingWindow, type FloatingWindowConfig, type FloatingWindowOptions, SanqianAppClient, type WindowPosition };
+export { type AppAgentConfig, type AppClientEvent, type AppClientEventHandlers, type AppConfig, type AppContextData, type AppContextListItem, type AppContextProvider, type AppEmbeddingConfig, type AppJsonSchemaProperty, type AppToolDefinition, type ChatUiConfigSerializable, FloatingWindow, type FloatingWindowConfig, type FloatingWindowOptions, SanqianAppClient, type WindowPosition };

package/dist/main/index.d.ts

@@ -8,6 +8,51 @@ import { BrowserWindow } from 'electron';
  * Application-facing types that hide SDK implementation details.
  * These provide a stable API even as the underlying SDK evolves.
  */
+/**
+ * Context data returned by a provider
+ */
+interface AppContextData {
+    /** Resource ID (for getById scenarios) */
+    id?: string;
+    /** Content to inject into conversation */
+    content: string;
+    /** Display title */
+    title?: string;
+    /** Summary for preview */
+    summary?: string;
+    /** Version for change detection (optional, Sanqian uses content hash if not provided) */
+    version?: string;
+}
+/**
+ * List item for context provider's getList method
+ */
+interface AppContextListItem {
+    /** Resource ID */
+    id: string;
+    /** Display title */
+    title: string;
+    /** Optional summary */
+    summary?: string;
+    /** Optional icon */
+    icon?: string;
+}
+/**
+ * Context provider definition
+ */
+interface AppContextProvider {
+    /** Provider ID (unique within app) */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Description */
+    description: string;
+    /** Get current state (for dynamic context) */
+    getCurrent?: () => Promise<AppContextData | null>;
+    /** Get list of available contexts */
+    getList?: () => Promise<AppContextListItem[]>;
+    /** Get full content by ID */
+    getById?: (id: string) => Promise<AppContextData | null>;
+}
 /**
  * Application configuration for connecting to Sanqian
  */
@@ -22,6 +67,8 @@ interface AppConfig {
     launchCommand?: string;
     /** Tools provided by this application */
     tools?: AppToolDefinition[];
+    /** Context providers for injecting app state */
+    contexts?: AppContextProvider[];
     /** Enable debug logging */
     debug?: boolean;
 }
@@ -66,8 +113,25 @@ interface AppAgentConfig {
     description?: string;
     /** System prompt */
     systemPrompt?: string;
-    /** Enabled tool names (without app prefix) */
+    /**
+     * Tools to enable. Supports:
+     * - Builtin: "file_ops", "run_bash", "web_search"
+     * - SDK: "myapp:tool_name" or just "tool_name" (auto-prefixed)
+     * - MCP: "mcp_server_tool"
+     * - Wildcard: ["*"]
+     */
     tools?: string[];
+    /**
+     * Skills to enable.
+     * @example ["pdf", "web-research", "xlsx"]
+     */
+    skills?: string[];
+    /**
+     * Context providers to attach by default.
+     * Uses provider ID without app prefix (auto-prefixed with appName).
+     * @example ["editor-state"] -> "sanqian-notes:editor-state"
+     */
+    attachedContexts?: string[];
 }
 /**
  * Embedding configuration from Sanqian
@@ -207,6 +271,40 @@ declare class SanqianAppClient {
      * Delete a conversation
      */
     deleteConversation(conversationId: string): Promise<void>;
+    /**
+     * List available capabilities (tools, skills, agents)
+     *
+     * @example
+     * ```typescript
+     * // List all tools
+     * const tools = await client.listCapabilities({ type: 'tool' });
+     *
+     * // List builtin tools only
+     * const builtinTools = await client.listCapabilities({ type: 'tool', source: 'builtin' });
+     * ```
+     */
+    listCapabilities(options?: _yushaw_sanqian_sdk.ListCapabilitiesOptions): Promise<_yushaw_sanqian_sdk.Capability[]>;
+    /**
+     * Search capabilities by query
+     *
+     * @example
+     * ```typescript
+     * const results = await client.searchCapabilities('file operations', { type: 'tool', limit: 5 });
+     * ```
+     */
+    searchCapabilities(query: string, options?: _yushaw_sanqian_sdk.SearchCapabilitiesOptions): Promise<_yushaw_sanqian_sdk.CapabilitySearchResult[]>;
+    /**
+     * List available tools
+     */
+    listTools(source?: 'builtin' | 'sdk' | 'mcp'): Promise<_yushaw_sanqian_sdk.ToolCapability[]>;
+    /**
+     * List available skills
+     */
+    listSkills(): Promise<_yushaw_sanqian_sdk.SkillCapability[]>;
+    /**
+     * List all available agents (not just own agents)
+     */
+    listAvailableAgents(): Promise<_yushaw_sanqian_sdk.AgentCapability[]>;
     /**
      * Get the underlying SDK instance
      * @internal This is for internal use by other sanqian-chat components
@@ -370,4 +468,4 @@ declare class FloatingWindow {
     getWindow(): BrowserWindow | null;
 }
 
-export { type AppAgentConfig, type AppClientEvent, type AppClientEventHandlers, type AppConfig, type AppEmbeddingConfig, type AppJsonSchemaProperty, type AppToolDefinition, type ChatUiConfigSerializable, FloatingWindow, type FloatingWindowConfig, type FloatingWindowOptions, SanqianAppClient, type WindowPosition };
+export { type AppAgentConfig, type AppClientEvent, type AppClientEventHandlers, type AppConfig, type AppContextData, type AppContextListItem, type AppContextProvider, type AppEmbeddingConfig, type AppJsonSchemaProperty, type AppToolDefinition, type ChatUiConfigSerializable, FloatingWindow, type FloatingWindowConfig, type FloatingWindowOptions, SanqianAppClient, type WindowPosition };

package/dist/main/index.js

@@ -45,13 +45,22 @@ var SanqianAppClient = class {
       parameters: t.parameters,
       handler: t.handler
     }));
+    const contexts = config.contexts?.map((c) => ({
+      id: c.id,
+      name: c.name,
+      description: c.description,
+      getCurrent: c.getCurrent,
+      getList: c.getList,
+      getById: c.getById
+    }));
     const sdkConfig = {
       appName: config.appName,
       appVersion: config.appVersion,
       displayName: config.displayName,
       launchCommand: config.launchCommand,
       debug: config.debug,
-      tools
+      tools,
+      contexts
     };
     this.sdk = new import_sanqian_sdk.SanqianSDK(sdkConfig);
   }
@@ -112,7 +121,9 @@ var SanqianAppClient = class {
       name: config.name,
       description: config.description,
       system_prompt: config.systemPrompt,
-      tools: config.tools
+      tools: config.tools,
+      skills: config.skills,
+      attached_contexts: config.attachedContexts
     };
     const result = await this.sdk.createAgent(sdkConfig);
     return { agentId: result.agent_id };
@@ -191,6 +202,53 @@ var SanqianAppClient = class {
     return this.sdk.deleteConversation(conversationId);
   }
   // ============================================================
+  // Capability Discovery
+  // ============================================================
+  /**
+   * List available capabilities (tools, skills, agents)
+   *
+   * @example
+   * ```typescript
+   * // List all tools
+   * const tools = await client.listCapabilities({ type: 'tool' });
+   *
+   * // List builtin tools only
+   * const builtinTools = await client.listCapabilities({ type: 'tool', source: 'builtin' });
+   * ```
+   */
+  async listCapabilities(options) {
+    return this.sdk.listCapabilities(options);
+  }
+  /**
+   * Search capabilities by query
+   *
+   * @example
+   * ```typescript
+   * const results = await client.searchCapabilities('file operations', { type: 'tool', limit: 5 });
+   * ```
+   */
+  async searchCapabilities(query, options) {
+    return this.sdk.searchCapabilities(query, options);
+  }
+  /**
+   * List available tools
+   */
+  async listTools(source) {
+    return this.sdk.listTools(source);
+  }
+  /**
+   * List available skills
+   */
+  async listSkills() {
+    return this.sdk.listSkills();
+  }
+  /**
+   * List all available agents (not just own agents)
+   */
+  async listAvailableAgents() {
+    return this.sdk.listAvailableAgents();
+  }
+  // ============================================================
   // Internal Access (for FloatingWindow and other internal components)
   // ============================================================
   /**

package/dist/main/index.mjs

@@ -8,13 +8,22 @@ var SanqianAppClient = class {
       parameters: t.parameters,
       handler: t.handler
     }));
+    const contexts = config.contexts?.map((c) => ({
+      id: c.id,
+      name: c.name,
+      description: c.description,
+      getCurrent: c.getCurrent,
+      getList: c.getList,
+      getById: c.getById
+    }));
     const sdkConfig = {
       appName: config.appName,
       appVersion: config.appVersion,
       displayName: config.displayName,
       launchCommand: config.launchCommand,
       debug: config.debug,
-      tools
+      tools,
+      contexts
     };
     this.sdk = new SanqianSDK(sdkConfig);
   }
@@ -75,7 +84,9 @@ var SanqianAppClient = class {
       name: config.name,
       description: config.description,
       system_prompt: config.systemPrompt,
-      tools: config.tools
+      tools: config.tools,
+      skills: config.skills,
+      attached_contexts: config.attachedContexts
     };
     const result = await this.sdk.createAgent(sdkConfig);
     return { agentId: result.agent_id };
@@ -154,6 +165,53 @@ var SanqianAppClient = class {
     return this.sdk.deleteConversation(conversationId);
   }
   // ============================================================
+  // Capability Discovery
+  // ============================================================
+  /**
+   * List available capabilities (tools, skills, agents)
+   *
+   * @example
+   * ```typescript
+   * // List all tools
+   * const tools = await client.listCapabilities({ type: 'tool' });
+   *
+   * // List builtin tools only
+   * const builtinTools = await client.listCapabilities({ type: 'tool', source: 'builtin' });
+   * ```
+   */
+  async listCapabilities(options) {
+    return this.sdk.listCapabilities(options);
+  }
+  /**
+   * Search capabilities by query
+   *
+   * @example
+   * ```typescript
+   * const results = await client.searchCapabilities('file operations', { type: 'tool', limit: 5 });
+   * ```
+   */
+  async searchCapabilities(query, options) {
+    return this.sdk.searchCapabilities(query, options);
+  }
+  /**
+   * List available tools
+   */
+  async listTools(source) {
+    return this.sdk.listTools(source);
+  }
+  /**
+   * List available skills
+   */
+  async listSkills() {
+    return this.sdk.listSkills();
+  }
+  /**
+   * List all available agents (not just own agents)
+   */
+  async listAvailableAgents() {
+    return this.sdk.listAvailableAgents();
+  }
+  // ============================================================
   // Internal Access (for FloatingWindow and other internal components)
   // ============================================================
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yushaw/sanqian-chat",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Floating chat window SDK for Sanqian AI Assistant",
   "main": "./dist/main/index.js",
   "types": "./dist/main/index.d.ts",
@@ -43,7 +43,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@yushaw/sanqian-sdk": "^0.3.0",
+    "@yushaw/sanqian-sdk": "^0.3.1",
     "react-virtuoso": "^4.15.0",
     "rehype-harden": "^1.1.6",
     "remark-gfm": "^4.0.1",