@dtoolkit/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Iván Campillo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/context.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+export declare const ContextBlockSchema: z.ZodObject<{
+    source: z.ZodString;
+    priority: z.ZodNumber;
+    content: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type ContextBlock = z.infer<typeof ContextBlockSchema>;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;;;;;iBAK7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/context.js

@@ -0,0 +1,8 @@
+import { z } from "zod";
+export const ContextBlockSchema = z.object({
+    source: z.string(),
+    priority: z.number(),
+    content: z.string(),
+    metadata: z.record(z.string(), z.unknown()).optional(),
+});
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACvD,CAAC,CAAC"}

package/dist/entity.d.ts

@@ -0,0 +1,39 @@
+import { z } from "zod";
+export declare const EntityType: z.ZodEnum<{
+    project: "project";
+    person: "person";
+    system: "system";
+    event: "event";
+    resource: "resource";
+}>;
+export type EntityType = z.infer<typeof EntityType>;
+export declare const ParaCategory: z.ZodEnum<{
+    projects: "projects";
+    areas: "areas";
+    resources: "resources";
+    archives: "archives";
+}>;
+export type ParaCategory = z.infer<typeof ParaCategory>;
+export declare const EntitySchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        project: "project";
+        person: "person";
+        system: "system";
+        event: "event";
+        resource: "resource";
+    }>;
+    category: z.ZodEnum<{
+        projects: "projects";
+        areas: "areas";
+        resources: "resources";
+        archives: "archives";
+    }>;
+    status: z.ZodDefault<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    metadata: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, z.core.$strip>;
+export type Entity = z.infer<typeof EntitySchema>;
+//# sourceMappingURL=entity.d.ts.map

package/dist/entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../src/entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,UAAU;;;;;;EAMrB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,eAAO,MAAM,YAAY;;;;;EAKvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;iBASvB,CAAC;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/entity.js

@@ -0,0 +1,25 @@
+import { z } from "zod";
+export const EntityType = z.enum([
+    "project",
+    "person",
+    "system",
+    "event",
+    "resource",
+]);
+export const ParaCategory = z.enum([
+    "projects",
+    "areas",
+    "resources",
+    "archives",
+]);
+export const EntitySchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    type: EntityType,
+    category: ParaCategory,
+    status: z.string().default("active"),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+    metadata: z.record(z.string(), z.unknown()).nullable().default(null),
+});
+//# sourceMappingURL=entity.js.map

package/dist/entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.js","sourceRoot":"","sources":["../src/entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC;IAC/B,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,UAAU;CACX,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC;IACjC,UAAU;IACV,OAAO;IACP,WAAW;IACX,UAAU;CACX,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,YAAY;IACtB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;IACpC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CACrE,CAAC,CAAC"}

package/dist/fact.d.ts

@@ -0,0 +1,36 @@
+import { z } from "zod";
+export declare const Tier: z.ZodEnum<{
+    hot: "hot";
+    warm: "warm";
+    cold: "cold";
+}>;
+export type Tier = z.infer<typeof Tier>;
+export declare const FactSchema: z.ZodObject<{
+    id: z.ZodString;
+    entityId: z.ZodString;
+    fact: z.ZodString;
+    category: z.ZodString;
+    timestamp: z.ZodString;
+    status: z.ZodDefault<z.ZodEnum<{
+        active: "active";
+        superseded: "superseded";
+    }>>;
+    supersededBy: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    relatedEntities: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    lastAccessed: z.ZodString;
+    accessCount: z.ZodDefault<z.ZodNumber>;
+    tier: z.ZodDefault<z.ZodEnum<{
+        hot: "hot";
+        warm: "warm";
+        cold: "cold";
+    }>>;
+    source: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type Fact = z.infer<typeof FactSchema>;
+export interface TierConfig {
+    hotDays: number;
+    hotMinAccess: number;
+    warmDays: number;
+}
+export declare function computeTier(lastAccessed: string, accessCount: number, tiers: TierConfig): Tier;
+//# sourceMappingURL=fact.d.ts.map

package/dist/fact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fact.d.ts","sourceRoot":"","sources":["../src/fact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,IAAI;;;;EAAkC,CAAC;AACpD,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;iBAarB,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE9C,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,WAAW,CACzB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,UAAU,GAChB,IAAI,CASN"}

package/dist/fact.js

@@ -0,0 +1,25 @@
+import { z } from "zod";
+export const Tier = z.enum(["hot", "warm", "cold"]);
+export const FactSchema = z.object({
+    id: z.string(),
+    entityId: z.string(),
+    fact: z.string(),
+    category: z.string(),
+    timestamp: z.string(),
+    status: z.enum(["active", "superseded"]).default("active"),
+    supersededBy: z.string().nullable().default(null),
+    relatedEntities: z.array(z.string()).default([]),
+    lastAccessed: z.string(),
+    accessCount: z.number().default(0),
+    tier: Tier.default("warm"),
+    source: z.string().nullable().default(null),
+});
+export function computeTier(lastAccessed, accessCount, tiers) {
+    const daysSince = Math.floor((Date.now() - new Date(lastAccessed).getTime()) / 86_400_000);
+    if (daysSince <= tiers.hotDays || accessCount >= tiers.hotMinAccess)
+        return "hot";
+    if (daysSince <= tiers.warmDays)
+        return "warm";
+    return "cold";
+}
+//# sourceMappingURL=fact.js.map

package/dist/fact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fact.js","sourceRoot":"","sources":["../src/fact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAGpD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC1D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACjD,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAChD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAClC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC1B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CAC5C,CAAC,CAAC;AASH,MAAM,UAAU,WAAW,CACzB,YAAoB,EACpB,WAAmB,EACnB,KAAiB;IAEjB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAC1B,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,UAAU,CAC7D,CAAC;IAEF,IAAI,SAAS,IAAI,KAAK,CAAC,OAAO,IAAI,WAAW,IAAI,KAAK,CAAC,YAAY;QACjE,OAAO,KAAK,CAAC;IACf,IAAI,SAAS,IAAI,KAAK,CAAC,QAAQ;QAAE,OAAO,MAAM,CAAC;IAC/C,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/history.d.ts

@@ -0,0 +1,17 @@
+export interface HistoryEntry {
+    id: string;
+    timestamp: string;
+    prompt: string;
+    result: string;
+    sessionId: string;
+    costUsd: number;
+    durationMs: number;
+    model?: string;
+    templateUsed?: string;
+}
+export interface SessionInfo {
+    sessionId: string;
+    startedAt: string;
+    name?: string;
+}
+//# sourceMappingURL=history.d.ts.map

package/dist/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/history.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=history.js.map

package/dist/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { EntityType, ParaCategory, EntitySchema, type Entity, } from "./entity.js";
+export { Tier, FactSchema, type Fact, type TierConfig, computeTier, } from "./fact.js";
+export { ContextBlockSchema, type ContextBlock } from "./context.js";
+export type { HistoryEntry, SessionInfo } from "./history.js";
+export type { TemplateDefinition, TemplateVariable } from "./template.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,KAAK,MAAM,GACZ,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,IAAI,EACJ,UAAU,EACV,KAAK,IAAI,EACT,KAAK,UAAU,EACf,WAAW,GACZ,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAErE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE9D,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { EntityType, ParaCategory, EntitySchema, } from "./entity.js";
+export { Tier, FactSchema, computeTier, } from "./fact.js";
+export { ContextBlockSchema } from "./context.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,OAAO,EACL,UAAU,EACV,YAAY,EACZ,YAAY,GAEb,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,IAAI,EACJ,UAAU,EAGV,WAAW,GACZ,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,kBAAkB,EAAqB,MAAM,cAAc,CAAC"}

package/dist/template.d.ts

@@ -0,0 +1,18 @@
+export interface TemplateVariable {
+    name: string;
+    source?: "stdin" | "arg" | "flag";
+    required?: boolean;
+    default?: string;
+}
+export interface TemplateDefinition {
+    name: string;
+    description?: string;
+    prompt: string;
+    variables?: TemplateVariable[];
+    claudeOptions?: Partial<{
+        model: string;
+        maxTurns: number;
+        maxBudgetUsd: number;
+    }>;
+}
+//# sourceMappingURL=template.d.ts.map

package/dist/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,aAAa,CAAC,EAAE,OAAO,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ"}

package/dist/template.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=template.js.map

package/dist/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@dtoolkit/core",
+  "version": "0.1.0",
+  "description": "Shared types for dtoolkit (ContextBlock, Fact, Entity, Tier, hooks API)",
+  "type": "module",
+  "license": "MIT",
+  "author": "Iván Campillo <ivncmp@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ivncmp/dtoolkit.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/ivncmp/dtoolkit/tree/main/packages/core",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "keywords": [
+    "ai",
+    "types",
+    "dtoolkit",
+    "dbrain",
+    "mcp"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix"
+  }
+}