@skillstate/core 0.0.1 → 2.0.1

package/dist/types.d.ts

@@ -0,0 +1,61 @@
+export type SkillState = Record<string, unknown>;
+export type StatePatch = Record<string, unknown | null>;
+export interface SchemaField {
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    default: unknown;
+    description?: string;
+}
+export type StateSchema = Record<string, SchemaField>;
+export interface ProceduralSpec {
+    id: string;
+    name: string;
+    instructions: string;
+    schema: StateSchema;
+    version: string;
+}
+export interface Observation {
+    content: string;
+    timestamp: number;
+    source?: string;
+}
+export interface StateTransition {
+    previousState: SkillState;
+    patch: StatePatch;
+    newState: SkillState;
+    reasoning: string;
+    action: string;
+    timestamp: number;
+}
+export type ValidationResult = {
+    valid: true;
+} | {
+    valid: false;
+    error: string;
+    field?: string;
+};
+export interface ExecutionStep {
+    step: number;
+    observation: Observation;
+    reasoning: string;
+    statePatch: StatePatch;
+    action: string;
+    /** Char length of the step's prompt At = (P, Σt, Ot). */
+    promptChars: number;
+    /** Char length of the raw LLM response(s) for this step. */
+    responseChars: number;
+    timestamp: number;
+    success?: boolean;
+}
+export interface PlatformAdapter {
+    name: string;
+    injectState(state: SkillState, spec: ProceduralSpec): string;
+    extractPatch(response: string): StatePatch | null;
+    extractAction(response: string): string | null;
+    formatPrompt(state: SkillState, observation: Observation, spec: ProceduralSpec): string;
+}
+export interface TrackerConfig {
+    persistPath?: string;
+    sessionName?: string;
+    platform: 'claude' | 'opencode' | 'generic';
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAGjD,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC,CAAC;AAGxD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC3D,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAGD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAGtD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAGD,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,UAAU,CAAC;IAC1B,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,UAAU,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,MAAM,MAAM,gBAAgB,GACxB;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,GACf;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAKpD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,WAAW,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAGlB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAGD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,CAAC;IAC7D,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IAClD,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC/C,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,CAAC;CACzF;AAGD,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;CAC7C"}

package/dist/types.js

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

package/dist/types.js.map

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

package/dist/validate.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @non-paper opt-in deep patch validation.
+ *
+ * `StateManager.validatePatch` (paper §3.2) stays the single source of truth
+ * for the runtime: flat unknown-key / wrong-type rejection, `null` always
+ * valid (deletion). This module ADDS a stricter, recursive validator for
+ * callers that want defense-in-depth on untrusted patches (e.g. hook
+ * scripts persisting LLM output):
+ *
+ * - recursion into nested objects/arrays with a max depth (default 8);
+ * - a cap on the TOTAL number of object keys at every level (default 100);
+ * - rejection of non-finite numbers (`NaN`, `Infinity`, `-Infinity`);
+ * - optional max string length (off unless `maxStringLength` is set);
+ * - top-level keys and types still checked against the schema, with the
+ *   same error wording as `StateManager.validatePatch`; `null` stays valid
+ *   for deletion at any level.
+ *
+ * Zero dependencies, Node >= 20, ESM.
+ */
+import type { StatePatch, StateSchema, ValidationResult } from './types.js';
+/** Default max nesting depth for {@link validatePatchDeep}. */
+export declare const MAX_PATCH_DEPTH = 8;
+/** Default cap on total object keys (all levels) for {@link validatePatchDeep}. */
+export declare const MAX_PATCH_KEYS = 100;
+/** Tuning knobs for {@link validatePatchDeep}; all optional. */
+export interface ValidateDeepOptions {
+    /** Max nesting depth (containers per level). Defaults to 8. */
+    maxDepth?: number;
+    /** Max total object keys across all levels. Defaults to 100. */
+    maxKeys?: number;
+    /** Max string length anywhere in the patch. Unset = no limit. */
+    maxStringLength?: number;
+}
+/**
+ * Validate `patch` against `schema` recursively. Pure: never mutates its
+ * inputs. Returns `{ valid: true }` or the first failure found.
+ */
+export declare function validatePatchDeep(schema: StateSchema, patch: StatePatch, options?: ValidateDeepOptions): ValidationResult;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAEV,UAAU,EACV,WAAW,EACX,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,+DAA+D;AAC/D,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC,mFAAmF;AACnF,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC,gEAAgE;AAChE,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AA8BD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,gBAAgB,CA0BlB"}

package/dist/validate.js

@@ -0,0 +1,180 @@
+/** Default max nesting depth for {@link validatePatchDeep}. */
+export const MAX_PATCH_DEPTH = 8;
+/** Default cap on total object keys (all levels) for {@link validatePatchDeep}. */
+export const MAX_PATCH_KEYS = 100;
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** Paper-style type name for error messages (`array` instead of `object`). */
+function kindOf(value) {
+    return Array.isArray(value) ? 'array' : typeof value;
+}
+function invalidType(path, expected, value) {
+    return {
+        valid: false,
+        error: `Invalid type for field '${path}': expected ${expected}, got ${kindOf(value)}`,
+        field: path,
+    };
+}
+/**
+ * Validate `patch` against `schema` recursively. Pure: never mutates its
+ * inputs. Returns `{ valid: true }` or the first failure found.
+ */
+export function validatePatchDeep(schema, patch, options) {
+    const budget = {
+        maxDepth: options?.maxDepth ?? MAX_PATCH_DEPTH,
+        maxKeys: options?.maxKeys ?? MAX_PATCH_KEYS,
+        maxStringLength: options?.maxStringLength,
+        seenKeys: 0,
+    };
+    for (const [key, value] of Object.entries(patch)) {
+        budget.seenKeys += 1;
+        if (budget.seenKeys > budget.maxKeys) {
+            return {
+                valid: false,
+                error: `Too many keys: exceeds max ${budget.maxKeys}`,
+                field: key,
+            };
+        }
+        const field = schema[key];
+        if (field === undefined) {
+            return { valid: false, error: `Unknown key: ${key}`, field: key };
+        }
+        const result = checkTopValue(field, value, key, 0, budget);
+        if (!result.valid) {
+            return result;
+        }
+    }
+    return { valid: true };
+}
+/** Top-level value: schema type gate, then recursive descent. */
+function checkTopValue(field, value, path, depth, budget) {
+    if (value === null) {
+        return { valid: true };
+    }
+    switch (field.type) {
+        case 'string':
+            if (typeof value !== 'string') {
+                return invalidType(path, 'string', value);
+            }
+            return checkString(value, path, budget);
+        case 'number':
+            if (typeof value !== 'number') {
+                return invalidType(path, 'number', value);
+            }
+            if (!Number.isFinite(value)) {
+                return {
+                    valid: false,
+                    error: `Invalid number for field '${path}': NaN or Infinity rejected`,
+                    field: path,
+                };
+            }
+            return { valid: true };
+        case 'boolean':
+            if (typeof value !== 'boolean') {
+                return invalidType(path, 'boolean', value);
+            }
+            return { valid: true };
+        case 'array':
+            if (!Array.isArray(value)) {
+                return invalidType(path, 'array', value);
+            }
+            return checkArray(value, path, depth + 1, budget);
+        case 'object':
+            if (!isPlainObject(value)) {
+                return invalidType(path, 'object', value);
+            }
+            return checkObject(value, path, depth + 1, budget);
+        default:
+            return {
+                valid: false,
+                error: `Unknown schema type for field '${path}'`,
+                field: path,
+            };
+    }
+}
+/** Nested value with no schema: structural limits still apply. */
+function checkDeepValue(value, path, depth, budget) {
+    if (value === null) {
+        return { valid: true };
+    }
+    if (typeof value === 'string') {
+        return checkString(value, path, budget);
+    }
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value)) {
+            return {
+                valid: false,
+                error: `Invalid number at '${path}': NaN or Infinity rejected`,
+                field: path,
+            };
+        }
+        return { valid: true };
+    }
+    if (typeof value === 'boolean') {
+        return { valid: true };
+    }
+    if (Array.isArray(value)) {
+        return checkArray(value, path, depth + 1, budget);
+    }
+    if (isPlainObject(value)) {
+        return checkObject(value, path, depth + 1, budget);
+    }
+    return {
+        valid: false,
+        error: `Unsupported type at '${path}': ${typeof value}`,
+        field: path,
+    };
+}
+function checkString(value, path, budget) {
+    if (budget.maxStringLength !== undefined &&
+        value.length > budget.maxStringLength) {
+        return {
+            valid: false,
+            error: `String too long at '${path}': length ${value.length} exceeds max ${budget.maxStringLength}`,
+            field: path,
+        };
+    }
+    return { valid: true };
+}
+function checkArray(value, path, depth, budget) {
+    if (depth > budget.maxDepth) {
+        return {
+            valid: false,
+            error: `Too deep at '${path}': exceeds max depth ${budget.maxDepth}`,
+            field: path,
+        };
+    }
+    for (let index = 0; index < value.length; index += 1) {
+        const result = checkDeepValue(value[index], `${path}[${index}]`, depth, budget);
+        if (!result.valid) {
+            return result;
+        }
+    }
+    return { valid: true };
+}
+function checkObject(value, path, depth, budget) {
+    if (depth > budget.maxDepth) {
+        return {
+            valid: false,
+            error: `Too deep at '${path}': exceeds max depth ${budget.maxDepth}`,
+            field: path,
+        };
+    }
+    for (const [key, nested] of Object.entries(value)) {
+        budget.seenKeys += 1;
+        if (budget.seenKeys > budget.maxKeys) {
+            return {
+                valid: false,
+                error: `Too many keys: exceeds max ${budget.maxKeys}`,
+                field: `${path}.${key}`,
+            };
+        }
+        const result = checkDeepValue(nested, `${path}.${key}`, depth, budget);
+        if (!result.valid) {
+            return result;
+        }
+    }
+    return { valid: true };
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AA0BA,+DAA+D;AAC/D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC;AAEjC,mFAAmF;AACnF,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAmBlC,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,8EAA8E;AAC9E,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC;AACvD,CAAC;AAED,SAAS,WAAW,CAClB,IAAY,EACZ,QAAgB,EAChB,KAAc;IAEd,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,2BAA2B,IAAI,eAAe,QAAQ,SAAS,MAAM,CAAC,KAAK,CAAC,EAAE;QACrF,KAAK,EAAE,IAAI;KACZ,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAmB,EACnB,KAAiB,EACjB,OAA6B;IAE7B,MAAM,MAAM,GAAW;QACrB,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,eAAe;QAC9C,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,cAAc;QAC3C,eAAe,EAAE,OAAO,EAAE,eAAe;QACzC,QAAQ,EAAE,CAAC;KACZ,CAAC;IACF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;QACrB,IAAI,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;YACrC,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,8BAA8B,MAAM,CAAC,OAAO,EAAE;gBACrD,KAAK,EAAE,GAAG;aACX,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,gBAAgB,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QACpE,CAAC;QACD,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;QAC3D,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAClB,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,iEAAiE;AACjE,SAAS,aAAa,CACpB,KAAkB,EAClB,KAAc,EACd,IAAY,EACZ,KAAa,EACb,MAAc;IAEd,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IACD,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,QAAQ;YACX,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,OAAO,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;YAC5C,CAAC;YACD,OAAO,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1C,KAAK,QAAQ;YACX,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,OAAO,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;YAC5C,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5B,OAAO;oBACL,KAAK,EAAE,KAAK;oBACZ,KAAK,EAAE,6BAA6B,IAAI,6BAA6B;oBACrE,KAAK,EAAE,IAAI;iBACZ,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACzB,KAAK,SAAS;YACZ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC/B,OAAO,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;YAC7C,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACzB,KAAK,OAAO;YACV,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;YAC3C,CAAC;YACD,OAAO,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;QACpD,KAAK,QAAQ;YACX,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;YAC5C,CAAC;YACD,OAAO,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;QACrD;YACE,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,kCAAkC,IAAI,GAAG;gBAChD,KAAK,EAAE,IAAI;aACZ,CAAC;IACN,CAAC;AACH,CAAC;AAED,kEAAkE;AAClE,SAAS,cAAc,CACrB,KAAc,EACd,IAAY,EACZ,KAAa,EACb,MAAc;IAEd,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,sBAAsB,IAAI,6BAA6B;gBAC9D,KAAK,EAAE,IAAI;aACZ,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;IACrD,CAAC;IACD,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,wBAAwB,IAAI,MAAM,OAAO,KAAK,EAAE;QACvD,KAAK,EAAE,IAAI;KACZ,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAClB,KAAa,EACb,IAAY,EACZ,MAAc;IAEd,IACE,MAAM,CAAC,eAAe,KAAK,SAAS;QACpC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,eAAe,EACrC,CAAC;QACD,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,uBAAuB,IAAI,aAAa,KAAK,CAAC,MAAM,gBAAgB,MAAM,CAAC,eAAe,EAAE;YACnG,KAAK,EAAE,IAAI;SACZ,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,SAAS,UAAU,CACjB,KAAgB,EAChB,IAAY,EACZ,KAAa,EACb,MAAc;IAEd,IAAI,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC5B,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,gBAAgB,IAAI,wBAAwB,MAAM,CAAC,QAAQ,EAAE;YACpE,KAAK,EAAE,IAAI;SACZ,CAAC;IACJ,CAAC;IACD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,MAAM,GAAG,cAAc,CAC3B,KAAK,CAAC,KAAK,CAAC,EACZ,GAAG,IAAI,IAAI,KAAK,GAAG,EACnB,KAAK,EACL,MAAM,CACP,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAClB,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,SAAS,WAAW,CAClB,KAA8B,EAC9B,IAAY,EACZ,KAAa,EACb,MAAc;IAEd,IAAI,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC5B,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,gBAAgB,IAAI,wBAAwB,MAAM,CAAC,QAAQ,EAAE;YACpE,KAAK,EAAE,IAAI;SACZ,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;QACrB,IAAI,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;YACrC,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,8BAA8B,MAAM,CAAC,OAAO,EAAE;gBACrD,KAAK,EAAE,GAAG,IAAI,IAAI,GAAG,EAAE;aACxB,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,EAAE,GAAG,IAAI,IAAI,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACvE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAClB,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC"}

package/package.json

@@ -1,9 +1,27 @@
 {
   "name": "@skillstate/core",
-  "version": "0.0.1",
-  "description": "skillstate scope placeholder — O(1) execution-state runtime (arXiv 2608.26263)",
+  "version": "2.0.1",
+  "description": "Paper-exact skillstate runtime core (A.4 byte-verbatim formatPaper, §4.3 token tracker).",
   "type": "module",
-  "main": "index.js",
-  "license": "MIT",
-  "keywords": ["skillstate", "llm-agents", "execution-state", "O(1)", "agent-runtime"]
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./schemas": {
+      "types": "./dist/schemas/index.d.ts",
+      "default": "./dist/schemas/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT"
 }

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 skillstate
-
-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/README.md

@@ -1,11 +0,0 @@
-# @skillstate/core
-
-Placeholder package. The `@skillstate` npm scope is reserved for the **skillstate** project — an O(1) execution-state runtime for LLM agents.
-
-- Scope: `@skillstate` (reserved via `@skillstate/core`)
-- Version: `0.0.1` (reserved placeholder)
-- Purpose: register the `@skillstate` npm scope under the project owner account and protect the brand.
-
-This package contains no runtime logic. See the project state docs, `state.md`, and [arXiv 2608.26263](https://arxiv.org/abs/2608.26263) for details.
-
-> Reserved scope placeholder.

package/index.js

@@ -1,3 +0,0 @@
-export const name = "@skillstate/core";
-export const version = "0.0.1";
-export const reserved = true;