@diyor28/context 1.0.0

package/dist/types/hash.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * Block hashing utilities.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractStableMetaSubset = extractStableMetaSubset;
+exports.computeBlockHash = computeBlockHash;
+const crypto_1 = require("crypto");
+/**
+ * Extract stable metadata subset for hashing.
+ * Excludes volatile fields like createdAt, source, tags.
+ *
+ * @param meta - Full block metadata
+ * @returns Stable metadata subset
+ */
+function extractStableMetaSubset(meta) {
+    return {
+        kind: meta.kind,
+        sensitivity: meta.sensitivity,
+        codecId: meta.codecId,
+        codecVersion: meta.codecVersion,
+    };
+}
+/**
+ * Compute content-addressed block hash.
+ * Uses StableMetaSubset + codec.canonicalize(payload) for deterministic hashing.
+ *
+ * @param meta - Block metadata (or StableMetaSubset)
+ * @param payload - Block payload (or canonicalized payload if codec not provided)
+ * @param codec - Block codec for canonicalization (optional)
+ * @returns Hex-encoded SHA-256 hash
+ */
+function computeBlockHash(meta, payload, codec) {
+    // Extract stable metadata subset (if full meta provided)
+    const stableMeta = 'createdAt' in meta ? extractStableMetaSubset(meta) : meta;
+    // Canonicalize payload (if codec provided)
+    const canonicalized = codec ? codec.canonicalize(payload) : payload;
+    // Combine stable meta + canonicalized payload
+    const combined = {
+        meta: stableMeta,
+        payload: canonicalized,
+    };
+    // Compute SHA-256 hash
+    const hash = (0, crypto_1.createHash)('sha256')
+        .update(JSON.stringify(combined))
+        .digest('hex');
+    return hash;
+}
+//# sourceMappingURL=hash.js.map

package/dist/types/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/types/hash.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAaH,0DAOC;AAWD,4CAuBC;AApDD,mCAAoC;AAIpC;;;;;;GAMG;AACH,SAAgB,uBAAuB,CAAC,IAAe;IACrD,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,YAAY,EAAE,IAAI,CAAC,YAAY;KAChC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,gBAAgB,CAC9B,IAAkC,EAClC,OAAiB,EACjB,KAA4B;IAE5B,yDAAyD;IACzD,MAAM,UAAU,GAAG,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE9E,2CAA2C;IAC3C,MAAM,aAAa,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAEpE,8CAA8C;IAC9C,MAAM,QAAQ,GAAG;QACf,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,aAAa;KACvB,CAAC;IAEF,uBAAuB;IACvB,MAAM,IAAI,GAAG,IAAA,mBAAU,EAAC,QAAQ,CAAC;SAC9B,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;SAChC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEjB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Core types for @foundry/context
+ */
+export * from './block.js';
+export * from './codec.js';
+export * from './hash.js';
+export * from './policy.js';
+export * from './attachment.js';
+export * from './compiled.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Core types for @foundry/context
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./block.js"), exports);
+__exportStar(require("./codec.js"), exports);
+__exportStar(require("./hash.js"), exports);
+__exportStar(require("./policy.js"), exports);
+__exportStar(require("./attachment.js"), exports);
+__exportStar(require("./compiled.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,6CAA2B;AAC3B,6CAA2B;AAC3B,4CAA0B;AAC1B,8CAA4B;AAC5B,kDAAgC;AAChC,gDAA8B"}

package/dist/types/policy.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Context policy configuration for token budgeting and overflow handling.
+ */
+import type { BlockKind, SensitivityLevel } from './block.js';
+/**
+ * LLM provider type.
+ */
+export type Provider = 'anthropic' | 'openai' | 'gemini';
+/**
+ * Model reference for LLM configuration.
+ */
+export interface ModelRef {
+    /** LLM provider */
+    provider: Provider;
+    /** Model identifier (provider-specific) */
+    model: string;
+}
+/**
+ * Token budget overflow strategy.
+ */
+export type OverflowStrategy = 'error' | 'truncate' | 'compact';
+/**
+ * Block kind priority configuration.
+ */
+export interface KindPriority {
+    /** Block kind */
+    kind: BlockKind;
+    /** Minimum token reservation (guaranteed) */
+    minTokens: number;
+    /** Maximum token allocation (soft limit) */
+    maxTokens: number;
+    /** Can be truncated on overflow */
+    truncatable: boolean;
+}
+/**
+ * Compaction configuration.
+ */
+export interface CompactionConfig {
+    /** Enable tool output pruning */
+    pruneToolOutputs: boolean;
+    /** Maximum tool output age (seconds) to keep */
+    maxToolOutputAge?: number;
+    /** Maximum tool outputs per kind */
+    maxToolOutputsPerKind?: number;
+    /** Enable conversation history summarization */
+    summarizeHistory: boolean;
+    /** Maximum history messages to keep before summarization */
+    maxHistoryMessages?: number;
+}
+/**
+ * Content sensitivity filtering configuration.
+ */
+export interface SensitivityConfig {
+    /** Maximum allowed sensitivity level */
+    maxSensitivity: SensitivityLevel;
+    /** Redact restricted content (vs. remove) */
+    redactRestricted: boolean;
+}
+/**
+ * Context policy configuration.
+ */
+export interface ContextPolicy {
+    /** Target LLM provider */
+    provider: Provider;
+    /** Model identifier (provider-specific) */
+    modelId: string;
+    /** Total context window size (tokens) */
+    contextWindow: number;
+    /** Reserved tokens for completion (subtracted from budget) */
+    completionReserve: number;
+    /** Overflow handling strategy */
+    overflowStrategy: OverflowStrategy;
+    /** Block kind priorities */
+    kindPriorities: KindPriority[];
+    /** Compaction configuration (if overflowStrategy = 'compact') */
+    compaction?: CompactionConfig;
+    /** Sensitivity filtering configuration */
+    sensitivity: SensitivityConfig;
+    /** Attachment selection policy */
+    attachments?: AttachmentPolicy;
+}
+/**
+ * Default kind priorities (general-purpose).
+ */
+export declare const DEFAULT_KIND_PRIORITIES: KindPriority[];
+/**
+ * Default compaction configuration.
+ */
+export declare const DEFAULT_COMPACTION_CONFIG: CompactionConfig;
+/**
+ * Default sensitivity configuration (public only).
+ */
+export declare const DEFAULT_SENSITIVITY_CONFIG: SensitivityConfig;
+/**
+ * Attachment purpose for prioritization.
+ */
+export type AttachmentPurpose = 'evidence' | 'input' | 'context' | 'artifact';
+/**
+ * Selection strategy ranking criteria.
+ */
+export type RankingCriterion = 'purpose' | 'user_mention' | 'recency';
+/**
+ * Attachment selection strategy.
+ */
+export interface SelectionStrategy {
+    /** Ranking criteria in priority order */
+    rankBy: RankingCriterion[];
+    /** Purpose priority mapping (lower = higher priority) */
+    purposePriority?: Record<AttachmentPurpose, number>;
+}
+/**
+ * Attachment policy configuration.
+ */
+export interface AttachmentPolicy {
+    /** Maximum total tokens for all attachments */
+    maxTokensTotal: number;
+    /** Selection strategy */
+    selectionStrategy: SelectionStrategy;
+}
+/**
+ * Default selection strategy (purpose > user_mention > recency).
+ */
+export declare const DEFAULT_SELECTION_STRATEGY: SelectionStrategy;
+/**
+ * Default attachment policy.
+ */
+export declare const DEFAULT_ATTACHMENT_POLICY: AttachmentPolicy;
+//# sourceMappingURL=policy.d.ts.map

package/dist/types/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/types/policy.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,mBAAmB;IACnB,QAAQ,EAAE,QAAQ,CAAC;IAEnB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,OAAO,GACP,UAAU,GACV,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iBAAiB;IACjB,IAAI,EAAE,SAAS,CAAC;IAEhB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAElB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAElB,mCAAmC;IACnC,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,gBAAgB,EAAE,OAAO,CAAC;IAE1B,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,oCAAoC;IACpC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B,gDAAgD;IAChD,gBAAgB,EAAE,OAAO,CAAC;IAE1B,4DAA4D;IAC5D,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,cAAc,EAAE,gBAAgB,CAAC;IAEjC,6CAA6C;IAC7C,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,QAAQ,EAAE,QAAQ,CAAC;IAEnB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAEhB,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;IAEtB,8DAA8D;IAC9D,iBAAiB,EAAE,MAAM,CAAC;IAE1B,iCAAiC;IACjC,gBAAgB,EAAE,gBAAgB,CAAC;IAEnC,4BAA4B;IAC5B,cAAc,EAAE,YAAY,EAAE,CAAC;IAE/B,iEAAiE;IACjE,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAE9B,0CAA0C;IAC1C,WAAW,EAAE,iBAAiB,CAAC;IAE/B,kCAAkC;IAClC,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAChC;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,YAAY,EAQjD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,gBAMvC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,iBAGxC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;AAE9E;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAE3B,yDAAyD;IACzD,eAAe,CAAC,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,cAAc,EAAE,MAAM,CAAC;IAEvB,yBAAyB;IACzB,iBAAiB,EAAE,iBAAiB,CAAC;CACtC;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,iBAQxC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,gBAGvC,CAAC"}

package/dist/types/policy.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * Context policy configuration for token budgeting and overflow handling.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_ATTACHMENT_POLICY = exports.DEFAULT_SELECTION_STRATEGY = exports.DEFAULT_SENSITIVITY_CONFIG = exports.DEFAULT_COMPACTION_CONFIG = exports.DEFAULT_KIND_PRIORITIES = void 0;
+/**
+ * Default kind priorities (general-purpose).
+ */
+exports.DEFAULT_KIND_PRIORITIES = [
+    { kind: 'pinned', minTokens: 500, maxTokens: 2000, truncatable: false },
+    { kind: 'reference', minTokens: 1000, maxTokens: 10000, truncatable: true },
+    { kind: 'memory', minTokens: 500, maxTokens: 5000, truncatable: true },
+    { kind: 'state', minTokens: 200, maxTokens: 2000, truncatable: false },
+    { kind: 'tool_output', minTokens: 1000, maxTokens: 20000, truncatable: true },
+    { kind: 'history', minTokens: 2000, maxTokens: 50000, truncatable: true },
+    { kind: 'turn', minTokens: 500, maxTokens: 10000, truncatable: false },
+];
+/**
+ * Default compaction configuration.
+ */
+exports.DEFAULT_COMPACTION_CONFIG = {
+    pruneToolOutputs: true,
+    maxToolOutputAge: 3600, // 1 hour
+    maxToolOutputsPerKind: 10,
+    summarizeHistory: true,
+    maxHistoryMessages: 20,
+};
+/**
+ * Default sensitivity configuration (public only).
+ */
+exports.DEFAULT_SENSITIVITY_CONFIG = {
+    maxSensitivity: 'public',
+    redactRestricted: true,
+};
+/**
+ * Default selection strategy (purpose > user_mention > recency).
+ */
+exports.DEFAULT_SELECTION_STRATEGY = {
+    rankBy: ['purpose', 'user_mention', 'recency'],
+    purposePriority: {
+        evidence: 1,
+        input: 2,
+        context: 3,
+        artifact: 4,
+    },
+};
+/**
+ * Default attachment policy.
+ */
+exports.DEFAULT_ATTACHMENT_POLICY = {
+    maxTokensTotal: 10000,
+    selectionStrategy: exports.DEFAULT_SELECTION_STRATEGY,
+};
+//# sourceMappingURL=policy.js.map

package/dist/types/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/types/policy.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AA4GH;;GAEG;AACU,QAAA,uBAAuB,GAAmB;IACrD,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE;IACvE,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE;IAC3E,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE;IACtE,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE;IACtE,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE;IAC7E,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE;IACzE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE;CACvE,CAAC;AAEF;;GAEG;AACU,QAAA,yBAAyB,GAAqB;IACzD,gBAAgB,EAAE,IAAI;IACtB,gBAAgB,EAAE,IAAI,EAAE,SAAS;IACjC,qBAAqB,EAAE,EAAE;IACzB,gBAAgB,EAAE,IAAI;IACtB,kBAAkB,EAAE,EAAE;CACvB,CAAC;AAEF;;GAEG;AACU,QAAA,0BAA0B,GAAsB;IAC3D,cAAc,EAAE,QAAQ;IACxB,gBAAgB,EAAE,IAAI;CACvB,CAAC;AAkCF;;GAEG;AACU,QAAA,0BAA0B,GAAsB;IAC3D,MAAM,EAAE,CAAC,SAAS,EAAE,cAAc,EAAE,SAAS,CAAC;IAC9C,eAAe,EAAE;QACf,QAAQ,EAAE,CAAC;QACX,KAAK,EAAE,CAAC;QACR,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,CAAC;KACZ;CACF,CAAC;AAEF;;GAEG;AACU,QAAA,yBAAyB,GAAqB;IACzD,cAAc,EAAE,KAAK;IACrB,iBAAiB,EAAE,kCAA0B;CAC9C,CAAC"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@diyor28/context",
+  "version": "1.0.0",
+  "private": false,
+  "description": "Context management library for LLM conversations with token budgeting and automatic compaction",
+  "keywords": [
+    "llm",
+    "context",
+    "token-budget",
+    "ai",
+    "anthropic",
+    "openai",
+    "gemini"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/iota-uz/foundry.git",
+    "directory": "packages/context"
+  },
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "tiktoken": "^1.0.22",
+    "zod": "^3.24.1"
+  },
+  "peerDependencies": {
+    "@anthropic-ai/sdk": "^0.38.0",
+    "openai": "^4.77.3"
+  },
+  "devDependencies": {
+    "@anthropic-ai/sdk": "^0.38.0",
+    "@types/node": "^20.17.13",
+    "@vitest/coverage-v8": "^2.1.8",
+    "openai": "^4.77.3",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  }
+}

package/postcss.config.js

@@ -0,0 +1,4 @@
+// Disable PostCSS for context package tests
+export default {
+  plugins: [],
+};