@gdrl/kronos-lib 0.1.0

package/dist/types-Gt5ZdRxW.d.ts

@@ -0,0 +1,364 @@
+type IngestStatus = 'queued' | 'chunking' | 'embedding' | 'processing' | 'complete' | 'failed';
+type IngestPriorityBand = 'low' | 'medium' | 'high';
+type IngestMemoryDisposition = 'requested' | 'skipped_by_request';
+interface IngestRequest {
+    app_id: string;
+    tenant_user_id: string;
+    source_type: string;
+    priority?: IngestPriorityBand;
+    addToMemory?: boolean;
+    content: {
+        type: 'text';
+        text: string;
+    };
+    metadata?: Record<string, unknown>;
+}
+interface IngestResponse {
+    ingest_id: string;
+}
+interface IngestStatusResponse {
+    ingest_id: string;
+    tenant_user_id: string;
+    status: IngestStatus;
+    memory: {
+        requested: boolean;
+        disposition: IngestMemoryDisposition;
+    };
+    progress: {
+        chunks_total: number;
+        chunks_embedded: number;
+        chunks_dispatched: number;
+        jobs_accepted: number;
+    };
+    error: {
+        code: string;
+        message: string;
+    } | null;
+}
+interface CreateMCPServerRequest {
+    app_id: string;
+    tenant_user_id: string;
+    /** Omit or pass [] for all-memory access. */
+    scope_ids?: string[] | null;
+    name: string;
+    description?: string;
+    options?: {
+        /** Expose `search_skills` and `read_skill`. Defaults to true. */
+        exposeSkillsTool?: boolean;
+        /** Expose the read-only `context_graph` tool. Defaults to false. */
+        exposeContextGraphTool?: boolean;
+    };
+}
+type MCPServerStatus = 'active' | 'disabled';
+interface MCPServerToolCapabilities {
+    skills: boolean;
+    context_graph: boolean;
+}
+interface CreateMCPServerResponse {
+    mcp_server_id: string;
+    url: string;
+    status: MCPServerStatus;
+    name: string;
+    description: string | null;
+    scope_ids: string[];
+    tool_capabilities: MCPServerToolCapabilities;
+}
+interface MCPServerDetails {
+    mcp_server_id: string;
+    app_id: string;
+    tenant_user_id: string;
+    scope_ids: string[];
+    status: MCPServerStatus;
+    name: string;
+    description: string | null;
+    tool_capabilities: MCPServerToolCapabilities;
+    created_at: string;
+    updated_at: string;
+}
+interface ListMCPServersResponse {
+    servers: MCPServerDetails[];
+    count: number;
+}
+interface GetMCPServerResponse extends MCPServerDetails {
+}
+interface ConnectMCPServerRequest {
+    app_id: string;
+    tenant_user_id: string;
+}
+interface ConnectMCPServerResponse {
+    mcp_server_id: string;
+    url: string;
+    access_token: string;
+    expires_at: string;
+}
+interface RotateMCPServerTokenRequest {
+    app_id: string;
+    tenant_user_id: string;
+}
+interface RotateMCPServerTokenResponse {
+    token: string;
+}
+interface MemoryStatsResponse {
+    claim_count: number;
+    observation_count: number;
+    artifact_count: number;
+    scope_count: number;
+}
+interface ScratchsheetResponse {
+    scratchsheet: string | null;
+    updated_at: string | null;
+}
+interface ScopeSummary {
+    scope_id: string;
+    name: string;
+    claim_count: number;
+}
+interface ScopeDetail {
+    scope_id: string;
+    name: string;
+    claim_count: number;
+    mcp_server_ids: string[];
+    include_query: string;
+    exclude_query: string | null;
+    match_mode: 'strict' | 'broad';
+    allowed_source_types: string[] | null;
+    time_start: string | null;
+    time_end: string | null;
+    description: string | null;
+    created_by: string | null;
+    last_refreshed_at: string | null;
+    created_at: string;
+    updated_at: string;
+}
+interface ListScopesResponse {
+    scopes: ScopeDetail[];
+    count: number;
+}
+interface GetScopeResponse {
+    scope: ScopeDetail;
+}
+interface ScopeSpec {
+    name: string;
+    include_query: string;
+    exclude_query?: string;
+    match_mode?: 'strict' | 'broad';
+    time_range?: {
+        start?: string;
+        end?: string;
+    };
+    allowed_source_types?: string[] | 'all';
+}
+interface CreateScopeRequest {
+    app_id: string;
+    tenant_user_id: string;
+    spec: ScopeSpec;
+    created_by: string;
+    description?: string;
+}
+interface CreateScopeResponse {
+    scope_id: string;
+    backfill_job_id: string;
+    mcp_server_id?: string | null;
+    mcp_server_error?: string | null;
+}
+interface UpdateScopeResponse {
+    scope_id: string;
+    updated: boolean;
+    backfill_job_id?: string;
+}
+type TriggerType = 'cron_recurring' | 'cron_oneoff' | 'nl_webhook';
+type OnTriggered = {
+    run: 'skill';
+    skill_id: string;
+    skill_version_id?: string | null;
+} | {
+    run: 'freeform';
+    freeform: string;
+};
+interface TriggerRecord {
+    trigger_id: string;
+    app_id: string;
+    tenant_user_id: string;
+    trigger_type: TriggerType;
+    trigger_spec: Record<string, unknown>;
+    webhook_url: string;
+    /** User-facing name for the automation. */
+    title?: string | null;
+    action_description?: string | null;
+    skill_id?: string | null;
+    skill_version_id?: string | null;
+    status?: string | null;
+    last_triggered_at?: string | null;
+    next_run_at?: string | null;
+    on_triggered?: OnTriggered | null;
+    metadata?: Record<string, unknown> | null;
+    created_at?: string | null;
+    updated_at?: string | null;
+}
+interface CreateTriggerRequest {
+    app_id: string;
+    tenant_user_id: string;
+    webhook_url: string;
+    webhook_secret: string;
+    /** User-facing name for the automation (required for manual/NL triggers). */
+    title?: string | null;
+    action_description?: string;
+    skill_id?: string;
+    skill_version_id?: string;
+    trigger_description?: string;
+    trigger_type?: TriggerType;
+    trigger_spec?: Record<string, unknown>;
+    next_run_at?: string;
+    on_triggered?: OnTriggered | null;
+    metadata?: Record<string, unknown>;
+}
+interface CreateTriggerResponse {
+    accepted?: boolean;
+    trigger_id?: string;
+}
+interface ListTriggersResponse {
+    triggers: TriggerRecord[];
+}
+interface UpdateTriggerRequest {
+    app_id: string;
+    tenant_user_id: string;
+    webhook_url?: string;
+    title?: string | null;
+    trigger_type?: TriggerType;
+    trigger_spec?: Record<string, unknown>;
+    next_run_at?: string | null;
+    action_description?: string;
+    skill_id?: string | null;
+    skill_version_id?: string | null;
+    on_triggered?: OnTriggered | null;
+    status?: string;
+    metadata?: Record<string, unknown>;
+}
+interface UpdateTriggerResponse {
+    success: boolean;
+    trigger_id: string;
+}
+interface DeleteTriggerResponse {
+    success: boolean;
+}
+type SkillFileType = 'markdown-file' | 'script' | 'template';
+type SkillReadMode = 'metadata' | 'instructions' | 'full' | 'tree' | 'files';
+type SkillFileContentMode = 'metadata' | 'full';
+interface SkillFileInput {
+    path: string;
+    type: SkillFileType;
+    content: string;
+}
+interface SkillFileRecord {
+    path: string;
+    type: SkillFileType;
+    checksum?: string;
+    size_bytes?: number;
+    content?: string;
+}
+interface SkillTreeNode {
+    path: string;
+    kind: 'directory' | 'file';
+    type?: SkillFileType;
+    checksum?: string;
+    size_bytes?: number;
+}
+interface SkillMetadataRecord {
+    skill_id: string;
+    name: string;
+    description: string;
+    metadata?: Record<string, unknown>;
+    created_at?: string | null;
+    updated_at?: string | null;
+}
+interface SkillSummaryRecord {
+    skill_id: string;
+    name: string;
+    description: string;
+    created_at?: string | null;
+    updated_at?: string | null;
+}
+type SkillManageParams = {
+    operation: 'create';
+    tenant_user_id: string;
+    name: string;
+    description: string;
+    instructions: string;
+    files?: SkillFileInput[];
+    metadata?: Record<string, unknown>;
+    idempotencyKey?: string;
+} | {
+    operation: 'list';
+    tenant_user_id: string;
+    include_internal?: boolean;
+} | {
+    operation: 'read';
+    tenant_user_id: string;
+    skill_id: string;
+    mode: SkillReadMode;
+    files?: string[];
+    fileContent?: SkillFileContentMode;
+} | {
+    operation: 'update';
+    tenant_user_id: string;
+    skill_id: string;
+    patch: {
+        name?: string;
+        description?: string;
+        instructions?: string;
+        files?: {
+            upsert?: SkillFileInput[];
+            removePaths?: string[];
+        };
+        metadata?: Record<string, unknown> | null;
+    };
+    idempotencyKey?: string;
+} | {
+    operation: 'delete';
+    tenant_user_id: string;
+    skill_id: string;
+};
+interface SkillManageResponse {
+    success?: boolean;
+    operation: 'create' | 'list' | 'read' | 'update' | 'delete';
+    mode?: SkillReadMode;
+    skill_id?: string;
+    skill?: SkillMetadataRecord;
+    skills?: SkillSummaryRecord[];
+    instructions?: string;
+    files?: SkillFileRecord[];
+    tree?: SkillTreeNode[];
+    fileContent?: SkillFileContentMode;
+    error?: string;
+}
+interface ContextGraphProcedureSummary {
+    title: string;
+    description: string;
+    path: string;
+}
+interface ContextGraphSummaryResponse {
+    skill_id: string | null;
+    procedures: ContextGraphProcedureSummary[];
+}
+interface ContextGraphReadResponse {
+    skill_id: string | null;
+    path: string;
+    content: string | null;
+}
+interface CreateFrontendTokenRequest {
+    tenantUserId: string;
+    ttlSeconds?: number;
+    ops?: string[];
+}
+interface CreateFrontendTokenResponse {
+    token: string;
+    expiresAt: string;
+}
+interface KronosClientConfig {
+    /** App API key for Worker authentication (Bearer token) */
+    apiKey: string;
+    /** App ID - used for API key validation and request scoping */
+    appId: string;
+}
+
+export type { ScopeDetail as A, CreateScopeRequest as B, CreateMCPServerResponse as C, DeleteTriggerResponse as D, TriggerType as E, CreateFrontendTokenRequest as F, GetMCPServerResponse as G, SkillFileType as H, IngestResponse as I, SkillReadMode as J, KronosClientConfig as K, ListMCPServersResponse as L, MemoryStatsResponse as M, SkillFileContentMode as N, OnTriggered as O, SkillFileInput as P, SkillFileRecord as Q, RotateMCPServerTokenResponse as R, ScratchsheetResponse as S, TriggerRecord as T, UpdateScopeResponse as U, SkillTreeNode as V, SkillMetadataRecord as W, SkillSummaryRecord as X, ContextGraphProcedureSummary as Y, IngestStatusResponse as a, ConnectMCPServerResponse as b, ListScopesResponse as c, GetScopeResponse as d, ScopeSpec as e, CreateScopeResponse as f, ListTriggersResponse as g, CreateTriggerRequest as h, CreateTriggerResponse as i, UpdateTriggerRequest as j, UpdateTriggerResponse as k, CreateFrontendTokenResponse as l, SkillManageParams as m, SkillManageResponse as n, ContextGraphSummaryResponse as o, ContextGraphReadResponse as p, IngestStatus as q, IngestMemoryDisposition as r, IngestRequest as s, CreateMCPServerRequest as t, MCPServerStatus as u, MCPServerToolCapabilities as v, MCPServerDetails as w, ConnectMCPServerRequest as x, RotateMCPServerTokenRequest as y, ScopeSummary as z };

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@gdrl/kronos-lib",
+  "version": "0.1.0",
+  "description": "Lightweight TypeScript SDK for the Kronos Knowledge Graph API",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.mjs",
+      "require": "./dist/react/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepublishOnly": "KRONOS_WORKER_URL=${KRONOS_WORKER_URL:-https://api.kronos.ai} KRONOS_MASTRA_URL=${KRONOS_MASTRA_URL:-https://mastra.kronos.ai} npm run build"
+  },
+  "keywords": [
+    "kronos",
+    "knowledge-graph",
+    "mcp",
+    "ingest",
+    "query"
+  ],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^25.0.10",
+    "@types/react": "^19.2.14",
+    "dotenv": "^17.2.3",
+    "react": "^19.0.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}