coaiajs 0.4.2 → 0.5.0

package/dist/src/narrative/jsonl-preservation.js

@@ -0,0 +1,293 @@
+import { promises as fs } from 'fs';
+import path from 'path';
+// Record classification lives in a pure module so the read contract can import the
+// SAME predicates rather than re-implementing them. See src/jsonl-records.ts.
+import { isObject, removeUndefined, isEntityRecord, isLegacyNarrativeBeatRecord, isRelationRecord, normalizeLegacyNarrativeBeat } from './jsonl-records.js';
+const ENTITY_TOP_LEVEL_KEYS = new Set(['type', 'name', 'entityType', 'observations', 'metadata']);
+const RELATION_TOP_LEVEL_KEYS = new Set(['type', 'from', 'to', 'relationType', 'metadata']);
+const NARRATIVE_BEAT_TOP_LEVEL_KEYS = new Set([
+    ...ENTITY_TOP_LEVEL_KEYS,
+    'narrative',
+    'relational_alignment',
+    'four_directions'
+]);
+const MUTABLE_METADATA_KEYS = new Set([
+    'dueDate',
+    'chartId',
+    'phase',
+    'completionStatus',
+    'completedAt',
+    'parentChart',
+    'parentActionStep',
+    'level',
+    'createdAt',
+    'updatedAt',
+    'act',
+    'type_dramatic',
+    'universes',
+    'timestamp',
+    'elementsOfPerformance',
+    'mmotEvaluations',
+    'relationalAlignment',
+    'fourDirections',
+    'narrative',
+    'isTelescopedChart',
+    'telescopedChartId'
+]);
+function cloneJson(value) {
+    return value === undefined ? value : JSON.parse(JSON.stringify(value));
+}
+function deepEqual(left, right) {
+    return JSON.stringify(left) === JSON.stringify(right);
+}
+function relationKey(relation) {
+    return `${relation.from}\u0000${relation.to}\u0000${relation.relationType}`;
+}
+function mergePreservedMetadata(originalMetadata, currentMetadata) {
+    if (!isObject(originalMetadata) && !isObject(currentMetadata)) {
+        return undefined;
+    }
+    const merged = {
+        ...(isObject(currentMetadata) ? currentMetadata : {})
+    };
+    if (isObject(originalMetadata)) {
+        for (const [key, value] of Object.entries(originalMetadata)) {
+            if (!(key in merged) && (!MUTABLE_METADATA_KEYS.has(key) || key === 'github')) {
+                merged[key] = cloneJson(value);
+            }
+        }
+    }
+    return merged;
+}
+function serializeEntity(entity, original) {
+    const originalType = original?.type;
+    const metadata = mergePreservedMetadata(original?.metadata, entity.metadata);
+    if (originalType === 'narrative_beat') {
+        const record = {
+            ...original,
+            type: 'narrative_beat',
+            name: entity.name,
+            observations: entity.observations
+        };
+        if ('entityType' in (original || {})) {
+            record.entityType = entity.entityType;
+        }
+        if (metadata) {
+            record.metadata = metadata;
+        }
+        if ('narrative' in (original || {}) && entity.metadata?.narrative !== undefined) {
+            record.narrative = cloneJson(entity.metadata.narrative);
+        }
+        if ('relational_alignment' in (original || {}) && entity.metadata?.relationalAlignment !== undefined) {
+            record.relational_alignment = cloneJson(entity.metadata.relationalAlignment);
+        }
+        if ('four_directions' in (original || {}) && entity.metadata?.fourDirections !== undefined) {
+            record.four_directions = cloneJson(entity.metadata.fourDirections);
+        }
+        return removeUndefined(record);
+    }
+    return removeUndefined({
+        ...original,
+        ...entity,
+        type: 'entity',
+        metadata
+    });
+}
+function serializeRelation(relation, original) {
+    return removeUndefined({
+        ...original,
+        ...relation,
+        type: 'relation',
+        metadata: mergePreservedMetadata(original?.metadata, relation.metadata)
+    });
+}
+function findRecord(records, key) {
+    return records.find((record) => {
+        if ((isEntityRecord(record) || isLegacyNarrativeBeatRecord(record)) && record.name === key) {
+            return true;
+        }
+        if (isRelationRecord(record)) {
+            return relationKey(record) === key;
+        }
+        return false;
+    });
+}
+function validateRecordPreservation(beforeRecords, afterRecords, graph) {
+    if (!beforeRecords || beforeRecords.length === 0) {
+        return;
+    }
+    const currentEntityNames = new Set(graph.entities.map((entity) => entity.name));
+    const currentRelationKeys = new Set(graph.relations.map((relation) => relationKey(relation)));
+    const failures = [];
+    for (const before of beforeRecords) {
+        if (isEntityRecord(before) || isLegacyNarrativeBeatRecord(before)) {
+            const name = before.name;
+            if (!currentEntityNames.has(name)) {
+                continue;
+            }
+            const after = findRecord(afterRecords, name);
+            if (!after) {
+                failures.push(`${name}: record missing after write`);
+                continue;
+            }
+            if (before.type === 'narrative_beat' && after.type !== 'narrative_beat') {
+                failures.push(`${name}: legacy narrative_beat record type was flattened`);
+            }
+            const knownKeys = before.type === 'narrative_beat'
+                ? NARRATIVE_BEAT_TOP_LEVEL_KEYS
+                : ENTITY_TOP_LEVEL_KEYS;
+            for (const key of Object.keys(before)) {
+                if (!knownKeys.has(key) && !deepEqual(before[key], after[key])) {
+                    failures.push(`${name}: top-level extension field "${key}" was not preserved`);
+                }
+            }
+            validateMetadata(name, before.metadata, after.metadata, failures);
+        }
+        if (isRelationRecord(before)) {
+            const key = relationKey(before);
+            if (!currentRelationKeys.has(key)) {
+                continue;
+            }
+            const after = findRecord(afterRecords, key);
+            if (!after) {
+                failures.push(`${key}: relation missing after write`);
+                continue;
+            }
+            for (const topLevelKey of Object.keys(before)) {
+                if (!RELATION_TOP_LEVEL_KEYS.has(topLevelKey) && !deepEqual(before[topLevelKey], after[topLevelKey])) {
+                    failures.push(`${key}: relation extension field "${topLevelKey}" was not preserved`);
+                }
+            }
+            validateMetadata(key, before.metadata, after.metadata, failures);
+        }
+    }
+    if (failures.length > 0) {
+        throw new Error(`COAIA JSONL metadata preservation failed:\n- ${failures.join('\n- ')}`);
+    }
+}
+function validateMetadata(label, beforeMetadata, afterMetadata, failures) {
+    if (!isObject(beforeMetadata)) {
+        return;
+    }
+    if (!isObject(afterMetadata)) {
+        failures.push(`${label}: metadata object missing after write`);
+        return;
+    }
+    for (const [key, value] of Object.entries(beforeMetadata)) {
+        if (!(key in afterMetadata)) {
+            failures.push(`${label}: metadata.${key} missing after write`);
+            continue;
+        }
+        if ((key === 'github' || !MUTABLE_METADATA_KEYS.has(key)) && !deepEqual(value, afterMetadata[key])) {
+            failures.push(`${label}: metadata.${key} changed unexpectedly`);
+        }
+    }
+}
+export function parseJsonlMemory(content) {
+    const records = content
+        .split('\n')
+        .filter((line) => line.trim() !== '')
+        .map((line) => JSON.parse(line));
+    const graph = { entities: [], relations: [], rawRecords: records };
+    for (const record of records) {
+        if (isEntityRecord(record)) {
+            graph.entities.push(record);
+        }
+        else if (isRelationRecord(record)) {
+            graph.relations.push(record);
+        }
+        else if (isLegacyNarrativeBeatRecord(record)) {
+            graph.entities.push(normalizeLegacyNarrativeBeat(record));
+        }
+    }
+    return graph;
+}
+export function serializeJsonlMemory(graph) {
+    const rawRecords = graph.rawRecords;
+    const emittedEntities = new Set();
+    const emittedRelations = new Set();
+    const entitiesByName = new Map(graph.entities.map((entity) => [entity.name, entity]));
+    const relationsByKey = new Map(graph.relations.map((relation) => [relationKey(relation), relation]));
+    const records = [];
+    if (rawRecords && rawRecords.length > 0) {
+        for (const original of rawRecords) {
+            if (isEntityRecord(original) || isLegacyNarrativeBeatRecord(original)) {
+                const name = original.name;
+                const entity = entitiesByName.get(name);
+                if (entity) {
+                    records.push(serializeEntity(entity, original));
+                    emittedEntities.add(name);
+                }
+                continue;
+            }
+            if (isRelationRecord(original)) {
+                const key = relationKey(original);
+                const relation = relationsByKey.get(key);
+                if (relation) {
+                    records.push(serializeRelation(relation, original));
+                    emittedRelations.add(key);
+                }
+                continue;
+            }
+            records.push(original);
+        }
+    }
+    for (const entity of graph.entities) {
+        if (!emittedEntities.has(entity.name)) {
+            records.push(serializeEntity(entity));
+        }
+    }
+    for (const relation of graph.relations) {
+        const key = relationKey(relation);
+        if (!emittedRelations.has(key)) {
+            records.push(serializeRelation(relation));
+        }
+    }
+    validateRecordPreservation(rawRecords, records, graph);
+    return `${records.map((record) => JSON.stringify(record)).join('\n')}\n`;
+}
+export async function readJsonlMemoryFile(memoryFilePath) {
+    try {
+        return parseJsonlMemory(await fs.readFile(memoryFilePath, 'utf-8'));
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+            return { entities: [], relations: [], rawRecords: [] };
+        }
+        throw error;
+    }
+}
+/**
+ * Write the store atomically: full content to a sibling temp file, then rename over the
+ * target. `rename` within a directory is atomic on POSIX, so a concurrent reader sees
+ * either the entire previous store or the entire new one — never a truncated prefix and
+ * never an empty file.
+ *
+ * The previous implementation was a bare `fs.writeFile`, which truncates and then
+ * writes. A reader landing in that window got a partial store, and — worse — a
+ * SYNTACTICALLY VALID partial store, because every whole line before the cut parses
+ * fine. That is undetectable by any reader: fewer charts is not distinguishable from
+ * fewer charts existing. Six MCP servers currently point at one store file, so the
+ * window is real rather than theoretical.
+ *
+ * WHAT THIS DOES NOT FIX: two processes that both load, then both write, still lose the
+ * earlier update — last writer wins, and both report success. Atomicity removes torn
+ * READS; it does not provide compare-and-swap. That remains open.
+ *
+ * The temp file is a sibling so the rename stays on one filesystem; a rename across
+ * devices is not atomic and would fail with EXDEV.
+ */
+export async function writeJsonlMemoryFile(memoryFilePath, graph) {
+    const content = serializeJsonlMemory(graph);
+    const dir = path.dirname(memoryFilePath);
+    const tmp = path.join(dir, `.${path.basename(memoryFilePath)}.tmp-${process.pid}-${Date.now()}`);
+    try {
+        await fs.writeFile(tmp, content, 'utf-8');
+        await fs.rename(tmp, memoryFilePath);
+    }
+    catch (error) {
+        await fs.unlink(tmp).catch(() => { });
+        throw error;
+    }
+}
+//# sourceMappingURL=jsonl-preservation.js.map

package/dist/src/narrative/jsonl-preservation.js.map

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

package/dist/src/narrative/jsonl-records.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Record classification for the JSONL store — pure, no I/O, no imports beyond types.
+ *
+ * WHY THIS FILE EXISTS
+ *
+ * These predicates decide what a line in the store IS. They were private to
+ * jsonl-preservation.ts, which cannot be imported by a renderer because its first line
+ * is `import fs`. So the read contract re-implemented them by hand — and got it wrong:
+ * it dropped the legacy `type:"narrative_beat"` dialect this package still writes and
+ * reads, losing real beats AND reporting them as corruption.
+ *
+ * Splitting them out costs nothing and means classification has exactly one definition.
+ * jsonl-preservation.ts imports it, so the writer round-trips through these; contract.ts
+ * imports it, so a reader classifies identically. They cannot drift, because there is
+ * no second copy to drift from.
+ */
+import type { Entity, JsonlRecord } from '../types.js';
+export declare function isObject(value: unknown): value is Record<string, unknown>;
+export declare function removeUndefined<T extends Record<string, unknown>>(record: T): T;
+export declare function isEntityRecord(record: JsonlRecord): boolean;
+/**
+ * The older on-disk dialect: a beat written with `type:"narrative_beat"` at the top
+ * level instead of `type:"entity"` + `entityType:"narrative_beat"`. Still present in
+ * live stores, still round-tripped by serializeEntity, still asserted by
+ * test-metadata-preservation.js. A reader that does not know this dialect silently
+ * renders fewer beats than exist.
+ */
+export declare function isLegacyNarrativeBeatRecord(record: JsonlRecord): boolean;
+export declare function isRelationRecord(record: JsonlRecord): boolean;
+export declare function normalizeLegacyNarrativeBeat(record: JsonlRecord): Entity;
+//# sourceMappingURL=jsonl-records.d.ts.map

package/dist/src/narrative/jsonl-records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl-records.d.ts","sourceRoot":"","sources":["../../../src/narrative/jsonl-records.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEvD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAO/E;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAE3D;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAExE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAK7D;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAsBxE"}

package/dist/src/narrative/jsonl-records.js

@@ -0,0 +1,69 @@
+/**
+ * Record classification for the JSONL store — pure, no I/O, no imports beyond types.
+ *
+ * WHY THIS FILE EXISTS
+ *
+ * These predicates decide what a line in the store IS. They were private to
+ * jsonl-preservation.ts, which cannot be imported by a renderer because its first line
+ * is `import fs`. So the read contract re-implemented them by hand — and got it wrong:
+ * it dropped the legacy `type:"narrative_beat"` dialect this package still writes and
+ * reads, losing real beats AND reporting them as corruption.
+ *
+ * Splitting them out costs nothing and means classification has exactly one definition.
+ * jsonl-preservation.ts imports it, so the writer round-trips through these; contract.ts
+ * imports it, so a reader classifies identically. They cannot drift, because there is
+ * no second copy to drift from.
+ */
+export function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+export function removeUndefined(record) {
+    for (const key of Object.keys(record)) {
+        if (record[key] === undefined) {
+            delete record[key];
+        }
+    }
+    return record;
+}
+export function isEntityRecord(record) {
+    return record.type === 'entity' && typeof record.name === 'string';
+}
+/**
+ * The older on-disk dialect: a beat written with `type:"narrative_beat"` at the top
+ * level instead of `type:"entity"` + `entityType:"narrative_beat"`. Still present in
+ * live stores, still round-tripped by serializeEntity, still asserted by
+ * test-metadata-preservation.js. A reader that does not know this dialect silently
+ * renders fewer beats than exist.
+ */
+export function isLegacyNarrativeBeatRecord(record) {
+    return record.type === 'narrative_beat' && typeof record.name === 'string';
+}
+export function isRelationRecord(record) {
+    return record.type === 'relation' &&
+        typeof record.from === 'string' &&
+        typeof record.to === 'string' &&
+        typeof record.relationType === 'string';
+}
+export function normalizeLegacyNarrativeBeat(record) {
+    const metadata = {
+        ...(isObject(record.metadata) ? record.metadata : {}),
+        narrative: isObject(record.metadata) && record.metadata.narrative !== undefined
+            ? record.metadata.narrative
+            : record.narrative,
+        relationalAlignment: isObject(record.metadata) && record.metadata.relationalAlignment !== undefined
+            ? record.metadata.relationalAlignment
+            : record.relational_alignment,
+        fourDirections: isObject(record.metadata) && record.metadata.fourDirections !== undefined
+            ? record.metadata.fourDirections
+            : record.four_directions
+    };
+    return removeUndefined({
+        ...record,
+        type: 'narrative_beat',
+        name: record.name,
+        entityType: 'narrative_beat',
+        observations: Array.isArray(record.observations) ? record.observations : [],
+        metadata: removeUndefined(metadata)
+    });
+}
+//# sourceMappingURL=jsonl-records.js.map

package/dist/src/narrative/jsonl-records.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl-records.js","sourceRoot":"","sources":["../../../src/narrative/jsonl-records.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,eAAe,CAAoC,MAAS;IAC1E,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAmB;IAChD,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC;AACrE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAmB;IAC7D,OAAO,MAAM,CAAC,IAAI,KAAK,gBAAgB,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAmB;IAClD,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU;QAC/B,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;QAC/B,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ;QAC7B,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,MAAmB;IAC9D,MAAM,QAAQ,GAAG;QACf,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,KAAK,SAAS;YAC7E,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS;YAC3B,CAAC,CAAC,MAAM,CAAC,SAAS;QACpB,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,mBAAmB,KAAK,SAAS;YACjG,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB;YACrC,CAAC,CAAC,MAAM,CAAC,oBAAoB;QAC/B,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,cAAc,KAAK,SAAS;YACvF,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc;YAChC,CAAC,CAAC,MAAM,CAAC,eAAe;KAC3B,CAAC;IAEF,OAAO,eAAe,CAAC;QACrB,GAAG,MAAM;QACT,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,MAAM,CAAC,IAAc;QAC3B,UAAU,EAAE,gBAAgB;QAC5B,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,YAAwB,CAAC,CAAC,CAAC,EAAE;QACvF,QAAQ,EAAE,eAAe,CAAC,QAAQ,CAAC;KACpC,CAAW,CAAC;AACf,CAAC"}

package/dist/src/narrative/tool-definitions.d.ts

@@ -14,8 +14,9 @@ export interface ToolDefinition {
     };
 }
 export declare const ALL_TOOL_DEFINITIONS: ToolDefinition[];
-export declare const STC_TOOLS: readonly ["create_structural_tension_chart", "manage_action_step", "add_action_step", "telescope_action_step", "remove_action_step", "mark_action_complete", "get_chart_progress", "list_active_charts", "get_chart", "get_action_step", "update_action_progress", "update_current_reality", "update_desired_outcome", "perform_mmot_evaluation"];
+export declare const STC_TOOLS: readonly ["create_structural_tension_chart", "manage_action_step", "add_action_step", "telescope_action_step", "remove_action_step", "mark_action_complete", "get_chart_progress", "list_active_charts", "get_chart", "get_action_step", "update_action_progress", "update_current_reality", "update_desired_outcome", "update_chart_due_date", "link_chart_to_github_issue", "perform_mmot_evaluation"];
 export declare const NARRATIVE_TOOLS: readonly ["create_narrative_beat", "telescope_narrative_beat", "list_narrative_beats"];
+export declare const WAMPUM_TOOLS: readonly ["create_wampum_belt", "add_wampum_bead", "read_wampum_belt"];
 export declare const KG_TOOLS: readonly ["create_entities", "create_relations", "add_observations", "delete_entities", "delete_observations", "delete_relations", "search_nodes", "open_nodes", "read_graph"];
 export declare const CORE_TOOLS: readonly ["list_active_charts", "create_structural_tension_chart", "add_action_step", "mark_action_complete"];
 //# sourceMappingURL=tool-definitions.d.ts.map

package/dist/src/narrative/tool-definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-definitions.d.ts","sourceRoot":"","sources":["../../../src/narrative/tool-definitions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAED,eAAO,MAAM,oBAAoB,EAAE,cAAc,EA6jBhD,CAAC;AAIF,eAAO,MAAM,SAAS,mVAeZ,CAAC;AAEX,eAAO,MAAM,eAAe,wFAIlB,CAAC;AAEX,eAAO,MAAM,QAAQ,gLAUX,CAAC;AAEX,eAAO,MAAM,UAAU,+GAKb,CAAC"}
+{"version":3,"file":"tool-definitions.d.ts","sourceRoot":"","sources":["../../../src/narrative/tool-definitions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAED,eAAO,MAAM,oBAAoB,EAAE,cAAc,EAmsBhD,CAAC;AAIF,eAAO,MAAM,SAAS,0YAiBZ,CAAC;AAEX,eAAO,MAAM,eAAe,wFAIlB,CAAC;AAEX,eAAO,MAAM,YAAY,wEAIf,CAAC;AAEX,eAAO,MAAM,QAAQ,gLAUX,CAAC;AAEX,eAAO,MAAM,UAAU,+GAKb,CAAC"}

package/dist/src/narrative/tool-definitions.js

@@ -216,6 +216,10 @@ export const ALL_TOOL_DEFINITIONS = [
                     },
                     description: 'Optional Elements of Performance for MMOT evaluation — criteria the agent uses to self-assess output',
                 },
+                githubIssue: {
+                    type: 'string',
+                    description: "Optional GitHub issue this chart is written from, as the FULL path 'owner/repo#number' (e.g. jgwill/coaiajs#1). A bare '#number' is rejected — charts travel between repositories, and a bare number cites the wrong project once the chart is read elsewhere.",
+                },
             },
             required: ['desiredOutcome', 'currentReality', 'dueDate'],
         },
@@ -300,7 +304,12 @@ export const ALL_TOOL_DEFINITIONS = [
                 initialActionSteps: {
                     type: 'array',
                     items: { type: 'string' },
-                    description: 'Optional list of initial action steps for the telescoped chart',
+                    description: "Optional list of initial action steps for the telescoped chart. Also accepted as 'actionSteps', the name its sibling create_structural_tension_chart uses for the same concept.",
+                },
+                actionSteps: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: "Alias for 'initialActionSteps'. Present because create_structural_tension_chart names this same concept 'actionSteps'; supplying either works.",
                 },
             },
             required: ['actionStepName', 'newCurrentReality'],
@@ -423,6 +432,29 @@ export const ALL_TOOL_DEFINITIONS = [
             required: ['chartId', 'newDesiredOutcome'],
         },
     },
+    {
+        name: 'update_chart_due_date',
+        description: 'Change the date a chart is due after it was created. Works for BOTH master charts AND action step charts. Moves the chart and its desired outcome together. Open action steps keep their own dates unless redistributeActionSteps is true; the count still falling after the new date is reported either way. The change is recorded as an observation on the chart.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                chartId: {
+                    type: 'string',
+                    description: "ID of the chart to update (works for master charts like 'chart_123' or action step charts like 'chart_456')",
+                },
+                newDueDate: {
+                    type: 'string',
+                    description: "New due date as an ISO date string (e.g. '2026-09-30T12:00:00Z')",
+                },
+                redistributeActionSteps: {
+                    type: 'boolean',
+                    default: false,
+                    description: 'When true, open action steps and telescoped child charts are redistributed evenly between now and the new due date. When false (default), their dates are left as the caller set them.',
+                },
+            },
+            required: ['chartId', 'newDueDate'],
+        },
+    },
     {
         name: 'perform_mmot_evaluation',
         description: "Autonomous MMOT (Managerial Moment of Truth) self-evaluation on a structural tension chart. The agent compares produced output against defined Elements of Performance, acknowledges discrepancy, analyzes dynamics, updates the chart, and recommits or redirects. Runs the four Creator's Moment of Truth steps: acknowledge → analyze → update → recommit. Can be called from any directional perspective (South/East/West/North) for collective inquiry.",
@@ -545,6 +577,100 @@ export const ALL_TOOL_DEFINITIONS = [
             },
         },
     },
+    {
+        name: 'link_chart_to_github_issue',
+        description: "Record on an existing chart the GitHub issue it was written from. The reference must be the full 'owner/repo#number' path.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                chartId: { type: 'string', description: 'ID of the chart to link' },
+                githubIssue: {
+                    type: 'string',
+                    description: "GitHub issue as the FULL path 'owner/repo#number' (e.g. jgwill/coaiajs#1). A bare '#number' is rejected.",
+                },
+            },
+            required: ['chartId', 'githubIssue'],
+        },
+    },
+    {
+        name: 'create_wampum_belt',
+        description: 'Create a Wampum Belt: a non-linear mnemonic grid that runs in parallel with linear narrative beats.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                title: { type: 'string', description: 'Name of this Wampum belt' },
+                purpose: { type: 'string', description: 'What this belt encodes or remembers' },
+                rows: { type: 'number', description: 'Grid row count (default 1)' },
+                cols: { type: 'number', description: 'Grid column count (default 1)' },
+            },
+            required: ['title', 'purpose'],
+        },
+    },
+    {
+        name: 'add_wampum_bead',
+        description: 'Add a bead at a grid position with mnemonic anchor, optional relational readings, and optional ceremony/accountability links.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                beltId: { type: 'string', description: 'Target belt ID' },
+                mnemonic: { type: 'string', description: 'Short anchor phrase for this bead' },
+                color: {
+                    type: 'string',
+                    enum: ['white', 'purple', 'black', 'mixed'],
+                    description: 'Bead color',
+                },
+                position: {
+                    type: 'object',
+                    properties: {
+                        row: { type: 'number' },
+                        col: { type: 'number' },
+                    },
+                    required: ['row', 'col'],
+                },
+                reading: { type: 'string', description: 'Canonical meaning for the bead' },
+                relationalReadings: {
+                    type: 'object',
+                    description: 'Optional perspective-specific readings (left/center/right/row:N/col:N)',
+                },
+                ceremonyLink: {
+                    type: 'object',
+                    properties: {
+                        ceremonyType: {
+                            type: 'string',
+                            enum: ['commitment', 'accountability', 'witness', 'renewal'],
+                        },
+                        chartId: { type: 'string' },
+                        beatName: { type: 'string' },
+                        witnessNames: { type: 'array', items: { type: 'string' } },
+                        renewalDate: { type: 'string' },
+                        notes: { type: 'string' },
+                    },
+                    required: ['ceremonyType'],
+                },
+                observations: { type: 'array', items: { type: 'string' } },
+            },
+            required: ['beltId', 'mnemonic', 'color', 'position', 'reading'],
+        },
+    },
+    {
+        name: 'read_wampum_belt',
+        description: 'Read a Wampum Belt in full, or read a bead by position with relational interpretation.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                beltId: { type: 'string', description: 'Wampum belt ID' },
+                position: {
+                    type: 'object',
+                    properties: {
+                        row: { type: 'number' },
+                        col: { type: 'number' },
+                    },
+                    required: ['row', 'col'],
+                },
+            },
+            required: ['beltId'],
+        },
+    },
 ];
 // ─── Tool Group Subsets ─────────────────────────────────────────────
 export const STC_TOOLS = [
@@ -561,6 +687,8 @@ export const STC_TOOLS = [
     'update_action_progress',
     'update_current_reality',
     'update_desired_outcome',
+    'update_chart_due_date',
+    'link_chart_to_github_issue',
     'perform_mmot_evaluation',
 ];
 export const NARRATIVE_TOOLS = [
@@ -568,6 +696,11 @@ export const NARRATIVE_TOOLS = [
     'telescope_narrative_beat',
     'list_narrative_beats',
 ];
+export const WAMPUM_TOOLS = [
+    'create_wampum_belt',
+    'add_wampum_bead',
+    'read_wampum_belt',
+];
 export const KG_TOOLS = [
     'create_entities',
     'create_relations',