mote-core 0.1.2

package/dist/contracts.js

@@ -0,0 +1,229 @@
+import { z } from "zod";
+export const jsonValueSchema = z.lazy(() => z.union([
+    z.string(),
+    z.number(),
+    z.boolean(),
+    z.null(),
+    z.array(jsonValueSchema),
+    z.record(z.string(), jsonValueSchema)
+]));
+export const accessModeSchema = z.enum(["tenant_user", "system_admin", "service"]);
+export const actorSchema = z.object({
+    id: z.string().min(1),
+    type: z.enum(["user", "system", "service"]),
+    displayName: z.string().optional()
+});
+export const executionContextSchema = z.object({
+    tenantId: z.string().nullable(),
+    actor: actorSchema,
+    accessMode: accessModeSchema,
+    capabilities: z.array(z.string()).default([]),
+    requestId: z.string().min(1)
+});
+export const connectorKindSchema = z.enum(["structured", "knowledge"]);
+export const connectorDescriptorSchema = z.object({
+    id: z.string().min(1),
+    kind: connectorKindSchema,
+    label: z.string().min(1),
+    capabilities: z.array(z.string()).default([]),
+    cacheNamespace: z.string().min(1),
+    authModes: z.array(accessModeSchema).default(["tenant_user", "system_admin", "service"])
+});
+export const connectorHealthSchema = z.object({
+    status: z.enum(["ok", "degraded", "unavailable"]),
+    checkedAt: z.string().datetime(),
+    message: z.string().optional(),
+    details: z.record(z.string(), jsonValueSchema).optional()
+});
+export const structuredFieldSchema = z.object({
+    name: z.string(),
+    dataType: z.string(),
+    nullable: z.boolean().default(true)
+});
+export const structuredSurfaceSchema = z.object({
+    name: z.string(),
+    schema: z.string(),
+    type: z.enum(["table", "view", "materialized_view"]).default("view"),
+    dimensions: z.array(structuredFieldSchema).default([]),
+    measures: z.array(structuredFieldSchema).default([]),
+    primaryTimeField: z.string().optional()
+});
+export const structuredSchemaSnapshotSchema = z.object({
+    connectorId: z.string(),
+    fetchedAt: z.string().datetime(),
+    surfaces: z.array(structuredSurfaceSchema)
+});
+export const structuredFilterSchema = z.object({
+    field: z.string(),
+    op: z.enum(["eq", "neq", "gt", "gte", "lt", "lte", "in"]),
+    value: z.unknown()
+});
+export const structuredOrderBySchema = z.object({
+    field: z.string(),
+    direction: z.enum(["asc", "desc"]).default("asc")
+});
+export const structuredQueryRequestSchema = z.object({
+    surface: z.string().min(1),
+    select: z.array(z.string()).default([]),
+    filters: z.array(structuredFilterSchema).default([]),
+    orderBy: z.array(structuredOrderBySchema).default([]),
+    limit: z.number().int().positive().max(500).default(50),
+    accessLevel: z.enum(["serving", "system"]).default("serving")
+});
+export const provenanceRefSchema = z.object({
+    kind: z.enum(["structured_row", "knowledge_doc", "resource", "prompt"]),
+    connectorId: z.string().optional(),
+    resourceId: z.string().optional(),
+    surface: z.string().optional(),
+    rowIndex: z.number().int().nonnegative().optional(),
+    path: z.string().optional(),
+    docId: z.string().optional(),
+    snippet: z.string().optional(),
+    label: z.string().optional()
+});
+export const structuredQueryResultSchema = z.object({
+    connectorId: z.string(),
+    surface: z.string(),
+    columns: z.array(structuredFieldSchema),
+    rows: z.array(z.record(z.string(), z.unknown())),
+    rowCount: z.number().int().nonnegative(),
+    provenance: z.array(provenanceRefSchema).default([])
+});
+export const knowledgeSearchSchema = z.object({
+    type: z.enum(["lex", "vec", "hyde"])
+        .describe("lex = keyword BM25, vec = semantic, hyde = hypothetical answer"),
+    query: z.string().min(1)
+});
+export const knowledgeQueryRequestSchema = z.object({
+    query: z.string().optional(),
+    searches: z.array(knowledgeSearchSchema).default([]),
+    collections: z.array(z.string()).default([]),
+    limit: z.number().int().positive().max(50).default(10),
+    minScore: z.number().min(0).max(1).default(0),
+    rerank: z.boolean().default(true),
+    intent: z.string().optional()
+}).superRefine((value, ctx) => {
+    if (!value.query && value.searches.length === 0) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "knowledge query requires either query or searches"
+        });
+    }
+});
+export const knowledgeDocumentRefSchema = z.object({
+    connectorId: z.string(),
+    collection: z.string().optional(),
+    path: z.string(),
+    docId: z.string().optional(),
+    title: z.string().optional(),
+    snippet: z.string().optional(),
+    score: z.number().optional(),
+    context: z.string().optional()
+});
+export const knowledgeDocumentSchema = knowledgeDocumentRefSchema.extend({
+    body: z.string(),
+    lineStart: z.number().int().positive().optional()
+});
+export const knowledgeCollectionSchema = z.object({
+    name: z.string(),
+    path: z.string().nullable(),
+    pattern: z.string().nullable(),
+    documents: z.number().int().nonnegative(),
+    lastUpdated: z.string().nullable()
+});
+export const knowledgeQueryResultSchema = z.object({
+    connectorId: z.string(),
+    hits: z.array(knowledgeDocumentRefSchema),
+    totalHits: z.number().int().nonnegative(),
+    provenance: z.array(provenanceRefSchema).default([])
+});
+export const datasetSpecSchema = z.object({
+    id: z.string(),
+    label: z.string(),
+    connectorId: z.string(),
+    kind: connectorKindSchema,
+    columns: z.array(structuredFieldSchema).default([]),
+    rows: z.array(z.record(z.string(), z.unknown())).default([]),
+    docs: z.array(knowledgeDocumentRefSchema).default([]),
+    metadata: z.record(z.string(), jsonValueSchema).default({})
+});
+export const chartIntentSchema = z.object({
+    type: z.enum(["line", "bar", "table", "metric", "timeline"]),
+    title: z.string(),
+    datasetId: z.string(),
+    xField: z.string().optional(),
+    yField: z.string().optional(),
+    groupBy: z.string().optional(),
+    rationale: z.string()
+});
+export const findingSchema = z.object({
+    id: z.string(),
+    title: z.string(),
+    summary: z.string(),
+    confidence: z.number().min(0).max(1),
+    evidence: z.array(provenanceRefSchema).default([]),
+    chartIntents: z.array(chartIntentSchema).default([])
+});
+export const insightRequestSchema = z.object({
+    question: z.string().min(1),
+    resourceIds: z.array(z.string()).default([]),
+    structuredQueries: z.array(z.object({
+        connectorId: z.string(),
+        request: structuredQueryRequestSchema
+    })).default([]),
+    knowledgeQueries: z.array(z.object({
+        connectorId: z.string(),
+        request: knowledgeQueryRequestSchema
+    })).default([]),
+    promptId: z.string().optional(),
+    maxFindings: z.number().int().positive().max(20).default(5)
+});
+export const insightBundleSchema = z.object({
+    question: z.string(),
+    summary: z.string(),
+    findings: z.array(findingSchema),
+    datasets: z.array(datasetSpecSchema).default([]),
+    evidence: z.array(provenanceRefSchema).default([]),
+    warnings: z.array(z.string()).default([]),
+    prompt: z.string().optional()
+});
+export const chartSpecSchema = z.object({
+    id: z.string(),
+    type: z.enum(["line", "bar", "table", "metric", "timeline"]),
+    title: z.string(),
+    datasetId: z.string(),
+    xField: z.string().optional(),
+    yField: z.string().optional(),
+    groupBy: z.string().optional(),
+    rationale: z.string()
+});
+export const dashboardSectionSchema = z.object({
+    id: z.string(),
+    title: z.string(),
+    chartIds: z.array(z.string()).default([]),
+    narrative: z.string().optional()
+});
+export const dashboardSpecSchema = z.object({
+    dashboardId: z.string(),
+    title: z.string(),
+    question: z.string(),
+    sections: z.array(dashboardSectionSchema),
+    charts: z.array(chartSpecSchema),
+    datasets: z.array(datasetSpecSchema),
+    insights: z.array(findingSchema),
+    warnings: z.array(z.string()).default([]),
+    provenance: z.array(provenanceRefSchema).default([])
+});
+export function createExecutionContext(input = {}) {
+    return executionContextSchema.parse({
+        tenantId: input.tenantId ?? null,
+        actor: input.actor ?? { id: "system", type: "system", displayName: "System" },
+        accessMode: input.accessMode ?? "service",
+        capabilities: input.capabilities ?? [],
+        requestId: input.requestId ?? `req_${Date.now().toString(36)}`
+    });
+}
+export function isPrivilegedAccess(context) {
+    return context.accessMode === "system_admin" || context.accessMode === "service";
+}
+//# sourceMappingURL=contracts.js.map

package/dist/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./contracts.js";
+export * from "./cache.js";
+export * from "./registry.js";
+export * from "./kernel.js";
+export * from "./connectors/types.js";
+export * from "./connectors/qmd.js";
+export * from "./runtime/engine.js";

package/dist/index.js

@@ -0,0 +1,8 @@
+export * from "./contracts.js";
+export * from "./cache.js";
+export * from "./registry.js";
+export * from "./kernel.js";
+export * from "./connectors/types.js";
+export * from "./connectors/qmd.js";
+export * from "./runtime/engine.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}

package/dist/kernel.d.ts

@@ -0,0 +1,51 @@
+import { type DashboardSpec, type ExecutionContext, type InsightBundle, type InsightRequest } from "./contracts.js";
+import { type CacheStore } from "./cache.js";
+import { type AnyConnector, type KnowledgeSourceAdapter, type StructuredDataSourceAdapter } from "./connectors/types.js";
+import { type InsightEngine } from "./runtime/engine.js";
+import { Registry, type PromptDefinition, type ResourceDefinition, type ToolDefinition } from "./registry.js";
+export interface KernelConfig {
+    cache?: CacheStore;
+    connectors?: AnyConnector[];
+    resources?: ResourceDefinition[];
+    tools?: ToolDefinition[];
+    prompts?: PromptDefinition[];
+    insightEngine?: InsightEngine;
+}
+export declare class Kernel {
+    readonly cache: CacheStore;
+    readonly resources: Registry<ResourceDefinition>;
+    readonly tools: Registry<ToolDefinition>;
+    readonly prompts: Registry<PromptDefinition>;
+    private readonly connectors;
+    private readonly structuredConnectors;
+    private readonly knowledgeConnectors;
+    private readonly insightEngine;
+    constructor(config?: KernelConfig);
+    registerConnector(connector: AnyConnector): void;
+    listConnectors(): AnyConnector[];
+    getStructuredConnector(id: string): StructuredDataSourceAdapter;
+    getKnowledgeConnector(id: string): KnowledgeSourceAdapter;
+    describeConnectors(contextInput?: Partial<ExecutionContext>): Promise<{
+        descriptor: {
+            id: string;
+            kind: "structured" | "knowledge";
+            label: string;
+            capabilities: string[];
+            cacheNamespace: string;
+            authModes: ("tenant_user" | "system_admin" | "service")[];
+        };
+        health: {
+            status: "ok" | "degraded" | "unavailable";
+            checkedAt: string;
+            message?: string | undefined;
+            details?: Record<string, unknown> | undefined;
+        };
+    }[]>;
+    getResource(id: string, contextInput?: Partial<ExecutionContext>): Promise<unknown>;
+    executeTool(id: string, input: unknown, contextInput?: Partial<ExecutionContext>): Promise<unknown>;
+    renderPrompt(id: string, input: unknown, contextInput?: Partial<ExecutionContext>): Promise<string>;
+    generateInsight(requestInput: InsightRequest, contextInput?: Partial<ExecutionContext>): Promise<InsightBundle>;
+    buildDashboard(insightInput: InsightBundle, _contextInput?: Partial<ExecutionContext>): Promise<DashboardSpec>;
+    private buildInsightContext;
+    private registerBuiltins;
+}