@gixcopilot/context 0.1.0

package/dist/state-store.d.ts

@@ -0,0 +1,80 @@
+import type { StatePatch, StatePatchResult } from './state-patch.js';
+/**
+ * State's own scope vocabulary (Section 41) - deliberately smaller than `ContextScope`
+ * (Section 8): state is either shared for the app's lifetime (`global`), shared for the
+ * current workflow (`session`), or owned by one mounted component (`component`). State does
+ * not have a `page`/`user`/`temporary` distinction the way context does - see
+ * `Phase_4_Decisions.md` ("State vs Context separation").
+ */
+export type StateScope = 'global' | 'session' | 'component';
+export interface StateValidationResult {
+    readonly valid: boolean;
+    readonly error?: string;
+}
+export type StateValidator<T> = (value: T) => boolean | StateValidationResult;
+export interface CopilotStateDefinition<T> {
+    readonly id: string;
+    readonly name: string;
+    readonly initialValue: T;
+    readonly scope?: StateScope;
+    readonly validate?: StateValidator<T>;
+    /**
+     * Capability metadata (Section 38-39, added in Phase 6) - `true` allows this slot to
+     * accept a validated `applyPatch()` call (typically from an AI-proposed patch, via a
+     * reserved tool - see `@gixcopilot/generative-ui`). Defaults to `false`: a slot is
+     * read-only from the model's perspective unless explicitly opted in, mirroring
+     * `@gixcopilot/context`'s own "nothing is exposed unless explicit" convention from Phase 4.
+     * This is capability metadata, not enforcement of *who* may call `applyPatch()` - Phase 7
+     * will add real authorization.
+     */
+    readonly modelWritable?: boolean;
+}
+/**
+ * A framework-independent, typed, subscribable state slot store (Section 42). Distinct from
+ * `ContextRegistry`: this holds *mutable application/Copilot data*; nothing here is
+ * automatically model-facing (Section 44) - bridging a specific slot to context is an
+ * explicit, separate act performed by the caller (see `Phase_4_Decisions.md`, "State
+ * exposure policy").
+ */
+export interface CopilotStateStore {
+    /**
+     * Ensures `definition.id` exists, seeding it with `initialValue` the first time only
+     * (later calls for the same id do not reset an already-set value - Section 18's
+     * "identity by explicit id" rule applies here too). Returns the slot's current value.
+     * Always refreshes the stored `validate`/`scope` to the latest definition passed in.
+     */
+    register<T>(definition: CopilotStateDefinition<T>): T;
+    has(id: string): boolean;
+    get<T>(id: string): T | undefined;
+    /** Validates (if a validator was registered) then replaces the value; throws on failure. */
+    set<T>(id: string, value: T): void;
+    /** Functional update (Section 48) - reads the previous value, validates, then replaces. */
+    update<T>(id: string, updater: (previous: T) => T): void;
+    /** Notified on every `set`/`update`/successfully-applied patch for this id. Removing the id
+     * does not auto-unsubscribe. */
+    subscribe<T>(id: string, listener: (value: T) => void): () => void;
+    remove(id: string): void;
+    list(): readonly string[];
+    /**
+     * Monotonically increases on every successful `set`/`update`/`applyPatch` for this id
+     * (Section 45) - not just patches, so a stale AI-proposed `baseRevision` is detected even
+     * when the *UI* (not another patch) moved the value in the meantime (Section 46).
+     * `undefined` for an unregistered id.
+     */
+    getRevision(id: string): number | undefined;
+    isModelWritable(id: string): boolean;
+    /**
+     * The validated state-patch pipeline (Section 43): unknown id / not writable / stale
+     * `baseRevision` / schema-invalid result each return a distinct, non-throwing
+     * `StatePatchResult` - state is left completely unchanged unless `status: 'applied'`
+     * (Section 43's "invalid patch must not mutate state", satisfied structurally: nothing is
+     * written until every check has already passed).
+     */
+    applyPatch(id: string, patch: StatePatch, baseRevision: number): StatePatchResult;
+}
+/**
+ * Creates an isolated store - no mandatory global singleton (Section 42); a host creates
+ * one per independent Copilot instance, mirroring `createContextRegistry()`.
+ */
+export declare function createCopilotStateStore(): CopilotStateStore;
+//# sourceMappingURL=state-store.d.ts.map

package/dist/state-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-store.d.ts","sourceRoot":"","sources":["../src/state-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAErE;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;AAE5D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,GAAG,qBAAqB,CAAC;AAE9E,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IACtC;;;;;;;;OAQG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,CAAC,EAAE,UAAU,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACtD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAClC,4FAA4F;IAC5F,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACnC,2FAA2F;IAC3F,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IACzD;oCACgC;IAChC,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACnE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,IAAI,SAAS,MAAM,EAAE,CAAC;IAC1B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC5C,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACrC;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,GAAG,gBAAgB,CAAC;CACnF;AAgCD;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,CAoG3D"}

package/dist/state-store.js

@@ -0,0 +1,129 @@
+import { CopilotError } from '@gixcopilot/protocol';
+function validateForPatch(validate, value) {
+    if (!validate)
+        return { valid: true };
+    const result = validate(value);
+    if (typeof result === 'boolean')
+        return { valid: result };
+    return result;
+}
+function assertValid(validate, value) {
+    if (!validate)
+        return;
+    const result = validate(value);
+    const valid = typeof result === 'boolean' ? result : result.valid;
+    if (!valid) {
+        const message = typeof result === 'object' && result.error ? result.error : 'Rejected state update.';
+        throw CopilotError.validation(message);
+    }
+}
+/**
+ * Creates an isolated store - no mandatory global singleton (Section 42); a host creates
+ * one per independent Copilot instance, mirroring `createContextRegistry()`.
+ */
+export function createCopilotStateStore() {
+    const slots = new Map();
+    function requireSlot(id) {
+        const slot = slots.get(id);
+        if (!slot) {
+            throw CopilotError.validation('No state registered with that id.', { id });
+        }
+        return slot;
+    }
+    function notify(slot) {
+        for (const listener of slot.listeners)
+            listener(slot.value);
+    }
+    return {
+        register(definition) {
+            const existing = slots.get(definition.id);
+            if (existing) {
+                existing.scope = definition.scope ?? existing.scope;
+                existing.validate = definition.validate;
+                existing.modelWritable = definition.modelWritable ?? existing.modelWritable;
+                return existing.value;
+            }
+            const slot = {
+                value: definition.initialValue,
+                scope: definition.scope ?? 'component',
+                validate: definition.validate,
+                modelWritable: definition.modelWritable ?? false,
+                revision: 0,
+                listeners: new Set(),
+            };
+            slots.set(definition.id, slot);
+            return definition.initialValue;
+        },
+        has: (id) => slots.has(id),
+        get: (id) => slots.get(id)?.value,
+        set(id, value) {
+            const slot = requireSlot(id);
+            assertValid(slot.validate, value);
+            slot.value = value;
+            slot.revision += 1;
+            notify(slot);
+        },
+        update(id, updater) {
+            const slot = requireSlot(id);
+            const next = updater(slot.value);
+            assertValid(slot.validate, next);
+            slot.value = next;
+            slot.revision += 1;
+            notify(slot);
+        },
+        subscribe(id, listener) {
+            const slot = requireSlot(id);
+            const wrapped = listener;
+            slot.listeners.add(wrapped);
+            return () => {
+                slot.listeners.delete(wrapped);
+            };
+        },
+        remove(id) {
+            slots.delete(id);
+        },
+        list: () => Array.from(slots.keys()),
+        getRevision: (id) => slots.get(id)?.revision,
+        isModelWritable: (id) => slots.get(id)?.modelWritable ?? false,
+        applyPatch(id, patch, baseRevision) {
+            const slot = slots.get(id);
+            if (!slot)
+                return { status: 'rejected', reason: 'unknown-state' };
+            if (!slot.modelWritable)
+                return { status: 'rejected', reason: 'not-writable' };
+            if (slot.revision !== baseRevision) {
+                return { status: 'conflict', currentRevision: slot.revision };
+            }
+            let nextValue;
+            if (patch.op === 'set') {
+                nextValue = patch.value;
+            }
+            else {
+                const current = slot.value;
+                if (!isPlainObject(current) || !isPlainObject(patch.value)) {
+                    return {
+                        status: 'rejected',
+                        reason: 'invalid-patch',
+                        detail: 'A "merge" patch requires both the current and patched value to be plain objects.',
+                    };
+                }
+                nextValue = { ...current, ...patch.value };
+            }
+            const validation = validateForPatch(slot.validate, nextValue);
+            if (!validation.valid) {
+                return { status: 'rejected', reason: 'invalid-value', detail: validation.error };
+            }
+            slot.value = nextValue;
+            slot.revision += 1;
+            notify(slot);
+            return { status: 'applied', revision: slot.revision, value: nextValue };
+        },
+    };
+}
+function isPlainObject(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return false;
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
+//# sourceMappingURL=state-store.js.map

package/dist/state-store.js.map

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

package/dist/token-estimator.d.ts

@@ -0,0 +1,17 @@
+/**
+ * A provider-neutral abstraction over "how many tokens will this text cost" (Section 26).
+ * The context package must not couple itself to any one provider's tokenizer - a host
+ * application can supply a more accurate estimator (e.g. backed by a real tokenizer) via
+ * `ContextEngineOptions.estimator`; the default below is a documented approximation only.
+ */
+export interface TokenEstimator {
+    estimate(text: string): number;
+}
+/**
+ * A simple, dependency-free heuristic (~4 characters per token, English-text average),
+ * rounded up. This is intentionally approximate - see Section 26 - and good enough for
+ * deterministic budgeting decisions; it is not a substitute for a real tokenizer when
+ * precise accounting matters.
+ */
+export declare function createDefaultTokenEstimator(): TokenEstimator;
+//# sourceMappingURL=token-estimator.d.ts.map

package/dist/token-estimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimator.d.ts","sourceRoot":"","sources":["../src/token-estimator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,IAAI,cAAc,CAO5D"}

package/dist/token-estimator.js

@@ -0,0 +1,16 @@
+/**
+ * A simple, dependency-free heuristic (~4 characters per token, English-text average),
+ * rounded up. This is intentionally approximate - see Section 26 - and good enough for
+ * deterministic budgeting decisions; it is not a substitute for a real tokenizer when
+ * precise accounting matters.
+ */
+export function createDefaultTokenEstimator() {
+    return {
+        estimate(text) {
+            if (!text)
+                return 0;
+            return Math.max(1, Math.ceil(text.length / 4));
+        },
+    };
+}
+//# sourceMappingURL=token-estimator.js.map

package/dist/token-estimator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimator.js","sourceRoot":"","sources":["../src/token-estimator.ts"],"names":[],"mappings":"AAUA;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B;IACzC,OAAO;QACL,QAAQ,CAAC,IAAY;YACnB,IAAI,CAAC,IAAI;gBAAE,OAAO,CAAC,CAAC;YACpB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;QACjD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@gixcopilot/context",
+  "version": "0.1.0",
+  "description": "Framework-independent application context and shared state engine for the AI Copilot SDK: registration, scopes, priority, serialization, token budgeting, and resolution.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AfoudaSWE/gix_ai_copilot_nx.git",
+    "directory": "packages/context"
+  },
+  "homepage": "https://github.com/AfoudaSWE/gix_ai_copilot_nx/tree/main/packages/context#readme",
+  "bugs": {
+    "url": "https://github.com/AfoudaSWE/gix_ai_copilot_nx/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.spec.*",
+    "!dist/**/*.spec-helper.*",
+    "!dist/**/*.integration.spec.*",
+    "!dist/**/*.tsbuildinfo"
+  ],
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@gixcopilot/protocol": "0.1.0"
+  },
+  "devDependencies": {
+    "vitest": "5.0.1"
+  },
+  "scripts": {
+    "build": "tsc -b tsconfig.json",
+    "typecheck": "tsc -b tsconfig.json",
+    "test": "vitest run",
+    "lint": "eslint src"
+  }
+}