@kweaver-ai/kweaver-sdk 0.7.3 → 0.7.4

package/dist/index.d.ts

@@ -29,6 +29,10 @@ export type { ListKnowledgeNetworksOptions, GetKnowledgeNetworkOptions, CreateKn
 export { listKnowledgeNetworks, getKnowledgeNetwork, createKnowledgeNetwork, updateKnowledgeNetwork, deleteKnowledgeNetwork, listObjectTypes, listRelationTypes, listActionTypes, } from "./api/knowledge-networks.js";
 export type { OntologyQueryBaseOptions, ObjectTypeQueryOptions, ObjectTypePropertiesOptions, SubgraphOptions, ActionTypeQueryOptions, ActionTypeExecuteOptions, ActionExecutionGetOptions, ActionLogsListOptions, ActionLogGetOptions, ActionLogCancelOptions, } from "./api/ontology-query.js";
 export { objectTypeQuery, objectTypeProperties, subgraph, actionTypeQuery, actionTypeExecute, actionExecutionGet, actionLogsList, actionLogGet, actionLogCancel, } from "./api/ontology-query.js";
+export type { MetricQueryDataOptions, MetricDryRunOptions } from "./api/ontology-query-metrics.js";
+export { metricQueryData, metricDryRun } from "./api/ontology-query-metrics.js";
+export type { ListMetricsOptions, CreateMetricsOptions, SearchMetricsOptions, ValidateMetricsOptions, GetMetricOptions, UpdateMetricOptions, DeleteMetricOptions, GetMetricsByIdsOptions, DeleteMetricsByIdsOptions, } from "./api/bkn-metrics.js";
+export { listMetrics, createMetrics, searchMetrics, validateMetrics, getMetric, updateMetric, deleteMetric, getMetrics, deleteMetrics, } from "./api/bkn-metrics.js";
 export type { SendChatRequestOptions, SendChatRequestStreamCallbacks, ChatResult, ProgressItem, AgentInfo, } from "./api/agent-chat.js";
 export { sendChatRequest, sendChatRequestStream, fetchAgentInfo, buildChatUrl, buildAgentInfoUrl, extractText, } from "./api/agent-chat.js";
 export type { ListAgentsOptions, GetAgentOptions, GetAgentByKeyOptions, CreateAgentOptions, UpdateAgentOptions, DeleteAgentOptions, PublishAgentOptions, UnpublishAgentOptions, } from "./api/agent-list.js";
@@ -52,11 +56,16 @@ export { ContextLoaderResource } from "./resources/context-loader.js";
 export { SkillsResource } from "./resources/skills.js";
 export { ToolboxesResource } from "./resources/toolboxes.js";
 export type { InvokeToolArgs } from "./resources/toolboxes.js";
+export { ModelsResource, LlmModelsSubresource, SmallModelsSubresource, ModelInvocationSubresource, } from "./resources/models.js";
 export type { SkillStatus, SkillSummary, SkillInfo, SkillFileSummary, SkillContentIndex, SkillFileReadResult, RegisterSkillResult, DeleteSkillResult, UpdateSkillStatusResult, SkillListResult, ListSkillsOptions, ListSkillMarketOptions, GetSkillOptions, RegisterSkillContentOptions, RegisterSkillZipOptions, UpdateSkillStatusOptions, ReadSkillFileOptions, DownloadSkillOptions, DownloadedSkillArchive, } from "./api/skills.js";
 export { listSkills, listSkillMarket, getSkill, deleteSkill, updateSkillStatus, registerSkillContent, registerSkillZip, getSkillContentIndex, fetchSkillContent, readSkillFile, fetchSkillFile, downloadSkill, installSkillArchive, } from "./api/skills.js";
 export type { ViewField, DataView, CreateDataViewOptions, GetDataViewOptions, ListDataViewsOptions, DeleteDataViewOptions, FindDataViewOptions, QueryDataViewOptions, DataViewQueryResult, } from "./api/dataviews.js";
 export { parseDataView, createDataView, getDataView, listDataViews, deleteDataView, findDataView, queryDataView, } from "./api/dataviews.js";
 export { DataViewsResource } from "./resources/dataviews.js";
+export type { MfManagerBaseOptions, ListLlmModelsOptions, GetLlmModelOptions, AddLlmModelOptions, EditLlmModelOptions, DeleteLlmModelsOptions, TestLlmModelOptions, ListSmallModelsOptions, GetSmallModelOptions, AddSmallModelOptions, EditSmallModelOptions, DeleteSmallModelsOptions, TestSmallModelOptions, } from "./api/models.js";
+export { MF_MODEL_MANAGER_PATH_PREFIX, assertSmallModelConfigAdapterExclusive, assertSmallModelEditBody, listLlmModels, getLlmModel, addLlmModel, editLlmModel, deleteLlmModels, testLlmModel, listSmallModels, getSmallModel, addSmallModel, editSmallModel, deleteSmallModels, testSmallModel, } from "./api/models.js";
+export type { MfApiBaseOptions, ChatMessage, ModelChatCompletionsOptions, ModelChatResult, ModelEmbeddingOptions, ModelRerankOptions, } from "./api/model-invocation.js";
+export { MF_MODEL_API_PATH_PREFIX, consumeOpenAiSseText, modelChatCompletions, modelEmbedding, modelEmbeddings, modelRerank, } from "./api/model-invocation.js";
 export type { BusinessDomain, ListBusinessDomainsOptions } from "./api/business-domains.js";
 export { listBusinessDomains } from "./api/business-domains.js";
 export type { CreateToolboxOptions, DeleteToolboxOptions, SetToolboxStatusOptions, UploadToolOptions, SetToolStatusesOptions, ListToolboxesOptions, ListToolsOptions, InvokeToolOptions, } from "./api/toolboxes.js";

package/dist/index.js

@@ -27,6 +27,8 @@
  */
 export { listKnowledgeNetworks, getKnowledgeNetwork, createKnowledgeNetwork, updateKnowledgeNetwork, deleteKnowledgeNetwork, listObjectTypes, listRelationTypes, listActionTypes, } from "./api/knowledge-networks.js";
 export { objectTypeQuery, objectTypeProperties, subgraph, actionTypeQuery, actionTypeExecute, actionExecutionGet, actionLogsList, actionLogGet, actionLogCancel, } from "./api/ontology-query.js";
+export { metricQueryData, metricDryRun } from "./api/ontology-query-metrics.js";
+export { listMetrics, createMetrics, searchMetrics, validateMetrics, getMetric, updateMetric, deleteMetric, getMetrics, deleteMetrics, } from "./api/bkn-metrics.js";
 export { sendChatRequest, sendChatRequestStream, fetchAgentInfo, buildChatUrl, buildAgentInfoUrl, extractText, } from "./api/agent-chat.js";
 export { listAgents, getAgent, getAgentByKey, createAgent, updateAgent, deleteAgent, publishAgent, unpublishAgent, } from "./api/agent-list.js";
 export { listConversations, listMessages } from "./api/conversations.js";
@@ -41,9 +43,12 @@ export { ConversationsResource } from "./resources/conversations.js";
 export { ContextLoaderResource } from "./resources/context-loader.js";
 export { SkillsResource } from "./resources/skills.js";
 export { ToolboxesResource } from "./resources/toolboxes.js";
+export { ModelsResource, LlmModelsSubresource, SmallModelsSubresource, ModelInvocationSubresource, } from "./resources/models.js";
 export { listSkills, listSkillMarket, getSkill, deleteSkill, updateSkillStatus, registerSkillContent, registerSkillZip, getSkillContentIndex, fetchSkillContent, readSkillFile, fetchSkillFile, downloadSkill, installSkillArchive, } from "./api/skills.js";
 export { parseDataView, createDataView, getDataView, listDataViews, deleteDataView, findDataView, queryDataView, } from "./api/dataviews.js";
 export { DataViewsResource } from "./resources/dataviews.js";
+export { MF_MODEL_MANAGER_PATH_PREFIX, assertSmallModelConfigAdapterExclusive, assertSmallModelEditBody, listLlmModels, getLlmModel, addLlmModel, editLlmModel, deleteLlmModels, testLlmModel, listSmallModels, getSmallModel, addSmallModel, editSmallModel, deleteSmallModels, testSmallModel, } from "./api/models.js";
+export { MF_MODEL_API_PATH_PREFIX, consumeOpenAiSseText, modelChatCompletions, modelEmbedding, modelEmbeddings, modelRerank, } from "./api/model-invocation.js";
 export { listBusinessDomains } from "./api/business-domains.js";
 export { createToolbox, deleteToolbox, setToolboxStatus, uploadTool, setToolStatuses, listToolboxes, listTools, executeTool, debugTool, } from "./api/toolboxes.js";
 // ── HTTP utilities ────────────────────────────────────────────────────────────

package/dist/resources/models.d.ts

@@ -0,0 +1,40 @@
+import type { ClientContext } from "../client.js";
+import { type ListLlmModelsOptions, type ListSmallModelsOptions, type MfManagerBaseOptions } from "../api/models.js";
+import { type MfApiBaseOptions, type ModelChatCompletionsOptions, type ModelEmbeddingOptions, type ModelRerankOptions } from "../api/model-invocation.js";
+type Base = MfManagerBaseOptions;
+export declare class LlmModelsSubresource {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    list(opts: Omit<ListLlmModelsOptions, keyof Base> & Partial<MfManagerBaseOptions>): Promise<unknown>;
+    get(modelId: string, opts?: Partial<Pick<MfManagerBaseOptions, "mfManagerBaseUrl" | "businessDomain">>): Promise<unknown>;
+    add(body: Record<string, unknown>, opts?: Partial<Pick<MfManagerBaseOptions, "mfManagerBaseUrl" | "businessDomain">>): Promise<unknown>;
+    edit(body: Record<string, unknown>, opts?: Partial<Pick<MfManagerBaseOptions, "mfManagerBaseUrl" | "businessDomain">>): Promise<unknown>;
+    delete(modelIds: string[], opts?: Partial<Pick<MfManagerBaseOptions, "mfManagerBaseUrl" | "businessDomain">>): Promise<unknown>;
+    test(body: Record<string, unknown>, opts?: Partial<Pick<MfManagerBaseOptions, "mfManagerBaseUrl" | "businessDomain">>): Promise<unknown>;
+}
+export declare class SmallModelsSubresource {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    list(opts: Omit<ListSmallModelsOptions, keyof Base> & Partial<MfManagerBaseOptions>): Promise<unknown>;
+    get(modelId: string, opts?: Partial<Pick<MfManagerBaseOptions, "mfManagerBaseUrl" | "businessDomain">>): Promise<unknown>;
+    add(body: Record<string, unknown>, opts?: Partial<Pick<MfManagerBaseOptions, "mfManagerBaseUrl" | "businessDomain">>): Promise<unknown>;
+    edit(body: Record<string, unknown>, opts?: Partial<Pick<MfManagerBaseOptions, "mfManagerBaseUrl" | "businessDomain">>): Promise<unknown>;
+    delete(modelIds: string[], opts?: Partial<Pick<MfManagerBaseOptions, "mfManagerBaseUrl" | "businessDomain">>): Promise<unknown>;
+    test(body: Record<string, unknown>, opts?: Partial<Pick<MfManagerBaseOptions, "mfManagerBaseUrl" | "businessDomain">>): Promise<unknown>;
+}
+export declare class ModelInvocationSubresource {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    chat(opts: Omit<ModelChatCompletionsOptions, "baseUrl" | "accessToken" | "businessDomain"> & Partial<Pick<MfApiBaseOptions, "mfApiBaseUrl" | "businessDomain">>): Promise<import("../api/model-invocation.js").ModelChatResult>;
+    embedding(opts: Omit<ModelEmbeddingOptions, "baseUrl" | "accessToken" | "businessDomain"> & Partial<Pick<MfApiBaseOptions, "mfApiBaseUrl" | "businessDomain">>): Promise<unknown>;
+    embeddings(opts: Omit<ModelEmbeddingOptions, "baseUrl" | "accessToken" | "businessDomain"> & Partial<Pick<MfApiBaseOptions, "mfApiBaseUrl" | "businessDomain">>): Promise<unknown>;
+    rerank(opts: Omit<ModelRerankOptions, "baseUrl" | "accessToken" | "businessDomain"> & Partial<Pick<MfApiBaseOptions, "mfApiBaseUrl" | "businessDomain">>): Promise<unknown>;
+}
+/** Model factory: mf-model-manager (CRUD) + mf-model-api (invoke chat / embedding / rerank). */
+export declare class ModelsResource {
+    readonly llm: LlmModelsSubresource;
+    readonly small: SmallModelsSubresource;
+    readonly invocation: ModelInvocationSubresource;
+    constructor(ctx: ClientContext);
+}
+export {};

package/dist/resources/models.js

@@ -0,0 +1,88 @@
+import { addLlmModel, addSmallModel, deleteLlmModels, deleteSmallModels, editLlmModel, editSmallModel, getLlmModel, getSmallModel, listLlmModels, listSmallModels, testLlmModel, testSmallModel, } from "../api/models.js";
+import { modelChatCompletions, modelEmbedding, modelEmbeddings, modelRerank, } from "../api/model-invocation.js";
+export class LlmModelsSubresource {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    list(opts) {
+        return listLlmModels({ ...this.ctx.base(), ...opts });
+    }
+    get(modelId, opts = {}) {
+        return getLlmModel({ ...this.ctx.base(), modelId, ...opts });
+    }
+    add(body, opts = {}) {
+        return addLlmModel({ ...this.ctx.base(), body, ...opts });
+    }
+    edit(body, opts = {}) {
+        return editLlmModel({ ...this.ctx.base(), body, ...opts });
+    }
+    delete(modelIds, opts = {}) {
+        return deleteLlmModels({ ...this.ctx.base(), modelIds, ...opts });
+    }
+    test(body, opts = {}) {
+        return testLlmModel({ ...this.ctx.base(), body, ...opts });
+    }
+}
+export class SmallModelsSubresource {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    list(opts) {
+        return listSmallModels({ ...this.ctx.base(), ...opts });
+    }
+    get(modelId, opts = {}) {
+        return getSmallModel({ ...this.ctx.base(), modelId, ...opts });
+    }
+    add(body, opts = {}) {
+        return addSmallModel({ ...this.ctx.base(), body, ...opts });
+    }
+    edit(body, opts = {}) {
+        return editSmallModel({ ...this.ctx.base(), body, ...opts });
+    }
+    delete(modelIds, opts = {}) {
+        return deleteSmallModels({ ...this.ctx.base(), modelIds, ...opts });
+    }
+    test(body, opts = {}) {
+        return testSmallModel({ ...this.ctx.base(), body, ...opts });
+    }
+}
+export class ModelInvocationSubresource {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    chat(opts) {
+        const { baseUrl, accessToken, businessDomain } = this.ctx.base();
+        return modelChatCompletions({
+            baseUrl,
+            accessToken,
+            businessDomain,
+            ...opts,
+        });
+    }
+    embedding(opts) {
+        const { baseUrl, accessToken, businessDomain } = this.ctx.base();
+        return modelEmbedding({ baseUrl, accessToken, businessDomain, ...opts });
+    }
+    embeddings(opts) {
+        const { baseUrl, accessToken, businessDomain } = this.ctx.base();
+        return modelEmbeddings({ baseUrl, accessToken, businessDomain, ...opts });
+    }
+    rerank(opts) {
+        const { baseUrl, accessToken, businessDomain } = this.ctx.base();
+        return modelRerank({ baseUrl, accessToken, businessDomain, ...opts });
+    }
+}
+/** Model factory: mf-model-manager (CRUD) + mf-model-api (invoke chat / embedding / rerank). */
+export class ModelsResource {
+    llm;
+    small;
+    invocation;
+    constructor(ctx) {
+        this.llm = new LlmModelsSubresource(ctx);
+        this.small = new SmallModelsSubresource(ctx);
+        this.invocation = new ModelInvocationSubresource(ctx);
+    }
+}

package/dist/templates/model/llm-basic.json

@@ -0,0 +1,13 @@
+{
+  "__template_note": "Shape aligned with mf-model-manager POST /llm/add: nested model_config (required). model_series must be one of: tome, qwen, openai, internlm, deepseek, qianxun, claude, chatglm, llama, others, baidu, baidu_tianchen. model_type: llm | rlm | vu. Optional: model_parameters (int>0), quota (bool). openai series: api_key required by backend validation. baidu/baidu_tianchen need extra keys inside model_config per vendor.",
+  "model_name": "example-llm",
+  "model_series": "others",
+  "model_type": "llm",
+  "max_model_len": 8192,
+  "model_config": {
+    "api_url": "https://example.com/v1/chat/completions",
+    "api_model": "example-deployment",
+    "api_key": ""
+  },
+  "quota": false
+}

package/dist/templates/model/manifest.json

@@ -0,0 +1,16 @@
+{
+  "llm": [
+    {
+      "id": "basic",
+      "file": "llm-basic.json",
+      "summary": "Minimal POST /llm/add body — model_config nested + model_series / max_model_len / model_type"
+    }
+  ],
+  "small": [
+    {
+      "id": "basic",
+      "file": "small-basic.json",
+      "summary": "Minimal model_config stub for embedding/reranker registration — extend or merge with CLI flags"
+    }
+  ]
+}

package/dist/templates/model/small-basic.json

@@ -0,0 +1,6 @@
+{
+  "__template_note": "Fragment for small-model model_config only (POST /small-model/add). Backend requires api_url + api_model inside model_config. Root fields model_name, model_type (embedding|reranker), batch_size, and for embedding also max_tokens + embedding_dim are supplied via CLI flags or separate JSON root — not repeated here.",
+  "api_url": "https://example.com/v1/embeddings",
+  "api_model": "example-embedding-model",
+  "api_key": ""
+}

package/dist/utils/trace-views.d.ts

@@ -0,0 +1,44 @@
+import type { TraceSpan, TracesByConversationResult } from "../api/conversations.js";
+export interface SpanNode {
+    span: TraceSpan;
+    children: SpanNode[];
+}
+/**
+ * Build a parent-child forest from a flat span array.
+ *
+ * Spans whose parentSpanId is missing or points to a span that is not in the set
+ * are treated as roots. Multiple traceIds in one conversation produce multiple roots.
+ * Children are sorted by startTime ascending.
+ */
+export declare function buildSpanTree(spans: TraceSpan[]): SpanNode[];
+/**
+ * Tree view: indented call topology with duration, status, service, and inline metadata.
+ */
+export declare function formatTreeView(spans: TraceSpan[]): string;
+/**
+ * Perf view: aggregated duration and call count per category.
+ */
+export declare function formatPerfView(spans: TraceSpan[]): string;
+/**
+ * Evidence view: ordered chain of execute_tool spans with arguments, hit count, and score.
+ */
+export declare function formatEvidenceView(spans: TraceSpan[]): string;
+export interface ReasoningOptions {
+    /** When true, print every message at full length. Default truncates large bodies. */
+    full?: boolean;
+}
+/**
+ * Reasoning view: walks the LLM's chat history (input messages of the chat span +
+ * the assistant's final output) so the user can read the agent's actual thought
+ * process — system / user / assistant / tool_call / tool result / final answer.
+ */
+export declare function formatReasoningView(spans: TraceSpan[], opts?: ReasoningOptions): string;
+export type TraceView = "tree" | "perf" | "evidence" | "reasoning" | "all";
+export interface FormatOptions {
+    /** Pass through to formatReasoningView — disables per-message truncation. */
+    full?: boolean;
+}
+/**
+ * Render one or more views over a trace result. Returns concatenated text suitable for stdout.
+ */
+export declare function formatTraceResult(result: TracesByConversationResult, view: TraceView, opts?: FormatOptions): string;