@dtoolkit/core 0.1.0 → 0.2.1

package/README.md

@@ -0,0 +1,57 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/ivncmp/dtoolkit/main/logo.png" alt="dtoolkit" />
+</p>
+
+<h1 align="center">@dtoolkit/core</h1>
+<p align="center">Shared types and schemas for the dtoolkit ecosystem</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@dtoolkit/core"><img src="https://img.shields.io/npm/v/@dtoolkit/core.svg" alt="npm"></a>
+  <a href="../../LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License"></a>
+</p>
+
+## Install
+
+```bash
+npm install @dtoolkit/core
+```
+
+## What's inside
+
+### Adapter types
+
+The universal adapter contract used by all `@dtoolkit/adapter-*` packages:
+
+| Export | Description |
+| --- | --- |
+| `Adapter` | Interface: `{ provider: string; execute(request): Promise<AdapterResult> }` |
+| `AdapterRequest` | Request shape: prompt, model, maxTurns, sessionId, options |
+| `AdapterResult` | Result shape: text, sessionId, costUsd, durationMs, usage, model, raw |
+| `AdapterUsage` | Token counts: inputTokens, outputTokens, totalTokens |
+
+```ts
+import type { Adapter, AdapterRequest, AdapterResult, AdapterUsage } from "@dtoolkit/core";
+```
+
+### Data types and schemas
+
+| Export | Description |
+| --- | --- |
+| `Entity` | Entity type, PARA category, and Zod schema |
+| `Fact` | Fact type with tier config and `computeTier()` |
+| `ContextBlock` | Context injection block schema |
+| `HistoryEntry` | Prompt history entry type |
+| `TemplateDefinition` | YAML prompt template types |
+
+```ts
+import { EntitySchema, computeTier, Tier } from "@dtoolkit/core";
+
+const entity = EntitySchema.parse(data);
+
+const tier = computeTier(fact, { hotDays: 7, hotMinAccess: 10, warmDays: 30 });
+// Tier.HOT | Tier.WARM | Tier.COLD
+```
+
+## License
+
+[MIT](../../LICENSE)

package/dist/adapter.d.ts

@@ -0,0 +1,36 @@
+export interface AdapterRequest {
+    prompt: string;
+    systemPrompt?: string;
+    model?: string;
+    maxTurns?: number;
+    stdinContent?: string;
+    sessionId?: string;
+    continueSession?: boolean;
+    options?: Record<string, unknown>;
+}
+export interface AdapterUsage {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+}
+export interface AdapterResult {
+    text: string;
+    sessionId?: string;
+    costUsd?: number;
+    durationMs: number;
+    isError: boolean;
+    usage?: AdapterUsage;
+    model?: string;
+    raw?: unknown;
+}
+export interface AdapterStreamEvent {
+    type: 'text' | 'result';
+    text?: string;
+    result?: AdapterResult;
+}
+export interface Adapter {
+    readonly provider: string;
+    execute(request: AdapterRequest): Promise<AdapterResult>;
+    stream(request: AdapterRequest): AsyncGenerator<AdapterStreamEvent>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACzD,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc,CAAC,kBAAkB,CAAC,CAAC;CACrE"}

package/dist/adapter.js

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

package/dist/adapter.js.map

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

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+export type { Adapter, AdapterRequest, AdapterResult, AdapterStreamEvent, AdapterUsage, } from "./adapter.js";
+export { LineBuffer } from "./line-buffer.js";
 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";

package/dist/index.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,OAAO,EACP,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,YAAY,GACb,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,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

@@ -1,3 +1,4 @@
+export { LineBuffer } from "./line-buffer.js";
 export { EntityType, ParaCategory, EntitySchema, } from "./entity.js";
 export { Tier, FactSchema, computeTier, } from "./fact.js";
 export { ContextBlockSchema } from "./context.js";

package/dist/index.js.map

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,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/line-buffer.d.ts

@@ -0,0 +1,6 @@
+export declare class LineBuffer {
+    private buffer;
+    push(chunk: string): string[];
+    flush(): string | undefined;
+}
+//# sourceMappingURL=line-buffer.d.ts.map

package/dist/line-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-buffer.d.ts","sourceRoot":"","sources":["../src/line-buffer.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAM;IAEpB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAO7B,KAAK,IAAI,MAAM,GAAG,SAAS;CAK5B"}

package/dist/line-buffer.js

@@ -0,0 +1,15 @@
+export class LineBuffer {
+    buffer = '';
+    push(chunk) {
+        this.buffer += chunk;
+        const lines = this.buffer.split('\n');
+        this.buffer = lines.pop() ?? '';
+        return lines.filter((l) => l.trim());
+    }
+    flush() {
+        const remaining = this.buffer.trim();
+        this.buffer = '';
+        return remaining || undefined;
+    }
+}
+//# sourceMappingURL=line-buffer.js.map

package/dist/line-buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-buffer.js","sourceRoot":"","sources":["../src/line-buffer.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,UAAU;IACb,MAAM,GAAG,EAAE,CAAC;IAEpB,IAAI,CAAC,KAAa;QAChB,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,KAAK;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,OAAO,SAAS,IAAI,SAAS,CAAC;IAChC,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dtoolkit/core",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Shared types for dtoolkit (ContextBlock, Fact, Entity, Tier, hooks API)",
   "type": "module",
   "license": "MIT",