@medicine-wheel/perception-layer 0.4.9

package/README.md

@@ -0,0 +1,76 @@
+# @medicine-wheel/perception-layer
+
+Witness film-production source material as typed relational events.
+
+This package is the **eyes and ears** layer for agent-supported Indigenous film production. It turns transcript or device-stream material into `PerceptualEvent`s, records who witnessed the material, and seeds an additive production graph in `@medicine-wheel/ontology-core`.
+
+## Why it exists
+
+Episode 066 introduced the belt-device / eyes-and-ears metaphor. Episode 067 and the Nicolas Renaud conversation clarified the relational frame: film is not just content capture, it is knowledge emerging through relationship. This package makes that frame executable without changing core ontology unions.
+
+Production entities ride on existing `knowledge` nodes with `metadata.kind`; edges use the additive `ProductionRelation` subtype.
+
+## Install
+
+```bash
+npm install @medicine-wheel/perception-layer
+```
+
+## API
+
+```ts
+import {
+  registerParticipant,
+  ingestTranscript,
+  buildProductionGraph,
+} from '@medicine-wheel/perception-layer';
+
+const mia = registerParticipant('Mia', 'witness', ['🧠', 'Mia']);
+const events = ingestTranscript(transcript, {
+  source: '/path/to/episode-066-transcript.txt',
+  participant: mia,
+});
+
+const graph = buildProductionGraph(events, {
+  participant: mia,
+  recordingName: 'Episode 066 belt recording',
+});
+```
+
+## Main concepts
+
+- `PerceptualEvent`: one witnessed segment with a sense (`ear` or `eye`) and an event type.
+- `AgentParticipant`: the human or agent recorded as witness, observer, or storyteller.
+- `ProductionGraphSeed`: recording node, segment nodes, collaborator nodes, and `ProductionRelation` edges.
+- `observedBy`: records relationship in-band; the agent witnesses rather than extracts.
+
+## Event types
+
+- `transcript-segment`
+- `director-intent`
+- `ambient-sound`
+- `shot-composition`
+- `relational-moment`
+
+## Verification
+
+The real vertical slice is covered by:
+
+```bash
+cd /workspace/repos/jgwill/medicine-wheel
+npm run build:packages
+npm test -- --run tests/film-production-vertical-slice.test.ts
+```
+
+That test uses the real Episode 066 transcript and proves:
+
+1. transcript → perceptual events,
+2. events → production graph,
+3. production graph remains additive over ontology-core,
+4. the Jerry and Nicolas/Renaud relationship threads stay legible.
+
+## Related issues
+
+- #85 — Episode 068 vertical slice
+- #86 — perception layer package
+- #84 — Episode 068 plan-review audio steering context

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @medicine-wheel/perception-layer
+ *
+ * The eyes & ears of agent-supported film production. Witness a belt-device
+ * recording as typed perceptual events and seed a production knowledge graph —
+ * relationship, not extraction.
+ *
+ * @example
+ * ```ts
+ * import { registerParticipant, ingestTranscript, buildProductionGraph } from '@medicine-wheel/perception-layer';
+ *
+ * const mia = registerParticipant('Mia', 'witness', ['🧠']);
+ * const events = ingestTranscript(transcript, { source: 'belt-device', participant: mia });
+ * const graph = buildProductionGraph(events, { participant: mia });
+ * ```
+ *
+ * @packageDocumentation
+ */
+export type { PerceptualSense, PerceptualEventType, PerceptualEvent, AgentParticipant, IngestOptions, BuildGraphOptions, ProductionGraphSeed, } from './types.js';
+export type { PerceptualObserver, Classification } from './observers.js';
+export { OBSERVERS, classify, relationalWitnessingObserver, directorIntentObserver, shotCompositionObserver, ambientSoundObserver, } from './observers.js';
+export { segmentTranscript, registerParticipant, ingestTranscript, buildProductionGraph, } from './ingest.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EACL,SAAS,EACT,QAAQ,EACR,4BAA4B,EAC5B,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildProductionGraph = exports.ingestTranscript = exports.registerParticipant = exports.segmentTranscript = exports.ambientSoundObserver = exports.shotCompositionObserver = exports.directorIntentObserver = exports.relationalWitnessingObserver = exports.classify = exports.OBSERVERS = void 0;
+var observers_js_1 = require("./observers.js");
+Object.defineProperty(exports, "OBSERVERS", { enumerable: true, get: function () { return observers_js_1.OBSERVERS; } });
+Object.defineProperty(exports, "classify", { enumerable: true, get: function () { return observers_js_1.classify; } });
+Object.defineProperty(exports, "relationalWitnessingObserver", { enumerable: true, get: function () { return observers_js_1.relationalWitnessingObserver; } });
+Object.defineProperty(exports, "directorIntentObserver", { enumerable: true, get: function () { return observers_js_1.directorIntentObserver; } });
+Object.defineProperty(exports, "shotCompositionObserver", { enumerable: true, get: function () { return observers_js_1.shotCompositionObserver; } });
+Object.defineProperty(exports, "ambientSoundObserver", { enumerable: true, get: function () { return observers_js_1.ambientSoundObserver; } });
+var ingest_js_1 = require("./ingest.js");
+Object.defineProperty(exports, "segmentTranscript", { enumerable: true, get: function () { return ingest_js_1.segmentTranscript; } });
+Object.defineProperty(exports, "registerParticipant", { enumerable: true, get: function () { return ingest_js_1.registerParticipant; } });
+Object.defineProperty(exports, "ingestTranscript", { enumerable: true, get: function () { return ingest_js_1.ingestTranscript; } });
+Object.defineProperty(exports, "buildProductionGraph", { enumerable: true, get: function () { return ingest_js_1.buildProductionGraph; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AA6BA,+CAOwB;AANtB,yGAAA,SAAS,OAAA;AACT,wGAAA,QAAQ,OAAA;AACR,4HAAA,4BAA4B,OAAA;AAC5B,sHAAA,sBAAsB,OAAA;AACtB,uHAAA,uBAAuB,OAAA;AACvB,oHAAA,oBAAoB,OAAA;AAGtB,yCAKqB;AAJnB,8GAAA,iBAAiB,OAAA;AACjB,gHAAA,mBAAmB,OAAA;AACnB,6GAAA,gBAAgB,OAAA;AAChB,iHAAA,oBAAoB,OAAA"}

package/dist/ingest.d.ts

@@ -0,0 +1,14 @@
+import type { PerceptualEvent, AgentParticipant, IngestOptions, BuildGraphOptions, ProductionGraphSeed } from './types.js';
+/** Split a transcript into sentence-ish segments. */
+export declare function segmentTranscript(text: string, minSegmentLength?: number): string[];
+/** Register a production participant with a persistent persona signature. */
+export declare function registerParticipant(name: string, role: AgentParticipant['role'], signature: string[]): AgentParticipant;
+/** Witness a transcript as a stream of perceptual events. */
+export declare function ingestTranscript(text: string, opts?: IngestOptions): PerceptualEvent[];
+/**
+ * Seed a production graph from perceptual events. Each segment is `rush-of` the
+ * recording; the participant is recorded as `witnessed-by` — relationship over
+ * extraction.
+ */
+export declare function buildProductionGraph(events: PerceptualEvent[], opts?: BuildGraphOptions): ProductionGraphSeed;
+//# sourceMappingURL=ingest.d.ts.map

package/dist/ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../src/ingest.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AASpB,qDAAqD;AACrD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,SAAK,GAAG,MAAM,EAAE,CAM/E;AAED,6EAA6E;AAC7E,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAC9B,SAAS,EAAE,MAAM,EAAE,GAClB,gBAAgB,CAElB;AAED,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,eAAe,EAAE,CAmB1F;AA+CD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,eAAe,EAAE,EACzB,IAAI,GAAE,iBAAsB,GAC3B,mBAAmB,CA8DrB"}

package/dist/ingest.js

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.segmentTranscript = segmentTranscript;
+exports.registerParticipant = registerParticipant;
+exports.ingestTranscript = ingestTranscript;
+exports.buildProductionGraph = buildProductionGraph;
+const observers_js_1 = require("./observers.js");
+let _seq = 0;
+function uid(prefix) {
+    _seq += 1;
+    return `${prefix}:${Date.now()}:${_seq}`;
+}
+/** Split a transcript into sentence-ish segments. */
+function segmentTranscript(text, minSegmentLength = 24) {
+    return text
+        .replace(/\s+/g, ' ')
+        .split(/(?<=[.?!])\s+/)
+        .map((s) => s.trim())
+        .filter((s) => s.length >= minSegmentLength);
+}
+/** Register a production participant with a persistent persona signature. */
+function registerParticipant(name, role, signature) {
+    return { id: uid('participant'), name, role, signature };
+}
+/** Witness a transcript as a stream of perceptual events. */
+function ingestTranscript(text, opts = {}) {
+    const source = opts.source ?? 'belt-device';
+    const minSegmentLength = opts.minSegmentLength ?? 24;
+    const observedBy = opts.participant?.id;
+    const now = new Date().toISOString();
+    return segmentTranscript(text, minSegmentLength).map((seg, index) => {
+        const { sense, type } = (0, observers_js_1.classify)(seg);
+        return {
+            id: uid('pevent'),
+            sense,
+            type,
+            text: seg,
+            source,
+            index,
+            observedBy,
+            timestamp: now,
+        };
+    });
+}
+const KIND_BY_TYPE = {
+    'shot-composition': 'shot',
+    'transcript-segment': 'rush',
+    'director-intent': 'rush',
+    'ambient-sound': 'rush',
+    'relational-moment': 'scene',
+};
+function makeProductionRelation(fromId, toId, relationshipType, productionId, timecode) {
+    const now = new Date().toISOString();
+    return {
+        id: uid('rel'),
+        from_id: fromId,
+        to_id: toId,
+        relationship_type: relationshipType,
+        strength: 1,
+        obligations: [],
+        ocap: {
+            ownership: 'creator',
+            control: 'creator',
+            access: 'community',
+            possession: 'on-premise',
+            compliant: true,
+        },
+        accountability: {
+            respect: 1,
+            reciprocity: 1,
+            responsibility: 1,
+            wilson_alignment: 1,
+            relations_honored: [],
+        },
+        metadata: {},
+        production_id: productionId,
+        timecode,
+        created_at: now,
+        updated_at: now,
+    };
+}
+/**
+ * Seed a production graph from perceptual events. Each segment is `rush-of` the
+ * recording; the participant is recorded as `witnessed-by` — relationship over
+ * extraction.
+ */
+function buildProductionGraph(events, opts = {}) {
+    const now = new Date().toISOString();
+    const productionId = opts.productionId ?? uid('production');
+    const recordingName = opts.recordingName ?? 'Belt-device recording';
+    const recording = {
+        id: uid('node'),
+        name: recordingName,
+        type: 'knowledge',
+        direction: 'east',
+        metadata: {
+            kind: 'recording',
+            production_id: productionId,
+            event_count: events.length,
+        },
+        created_at: now,
+        updated_at: now,
+    };
+    const segments = [];
+    const collaborators = [];
+    const relations = [];
+    if (opts.participant) {
+        const witness = {
+            id: uid('node'),
+            name: opts.participant.name,
+            type: 'human',
+            metadata: {
+                kind: 'collaborator',
+                role: opts.participant.role,
+                signature: opts.participant.signature,
+            },
+            created_at: now,
+            updated_at: now,
+        };
+        collaborators.push(witness);
+        relations.push(makeProductionRelation(recording.id, witness.id, 'witnessed-by', productionId));
+    }
+    for (const ev of events) {
+        const node = {
+            id: uid('node'),
+            name: ev.text.slice(0, 60),
+            type: 'knowledge',
+            metadata: {
+                kind: KIND_BY_TYPE[ev.type],
+                event_type: ev.type,
+                sense: ev.sense,
+                index: ev.index,
+                source: ev.source,
+            },
+            created_at: now,
+            updated_at: now,
+        };
+        segments.push(node);
+        relations.push(makeProductionRelation(node.id, recording.id, 'rush-of', productionId, String(ev.index)));
+    }
+    return { recording, segments, collaborators, relations };
+}
+//# sourceMappingURL=ingest.js.map

package/dist/ingest.js.map

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

package/dist/observers.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @medicine-wheel/perception-layer — Observers
+ *
+ * Pure classifiers — the perceptual organs. Each observer recognizes a kind of
+ * witnessed material. Observers take NO world action; they only see and hear.
+ * Precedence is intentional: relational witnessing (the Renaud thread) is
+ * recognized first so relationships are never buried under technical chatter.
+ */
+import type { PerceptualEventType, PerceptualSense } from './types.js';
+export interface PerceptualObserver {
+    name: string;
+    sense: PerceptualSense;
+    type: PerceptualEventType;
+    /** True when this observer recognizes the segment. */
+    matches: (text: string) => boolean;
+}
+/** Eye — what relationship is being witnessed. */
+export declare const relationalWitnessingObserver: PerceptualObserver;
+/** Ear — stated creative intent. */
+export declare const directorIntentObserver: PerceptualObserver;
+/** Eye — what is seen / framed. */
+export declare const shotCompositionObserver: PerceptualObserver;
+/** Ear — recording / sonic environment. */
+export declare const ambientSoundObserver: PerceptualObserver;
+/** Ordered observer registry — precedence matters (see module doc). */
+export declare const OBSERVERS: PerceptualObserver[];
+export interface Classification {
+    sense: PerceptualSense;
+    type: PerceptualEventType;
+    observer: string;
+}
+/** Classify a segment through the observer registry; default is a plain ear. */
+export declare function classify(text: string): Classification;
+//# sourceMappingURL=observers.d.ts.map

package/dist/observers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observers.d.ts","sourceRoot":"","sources":["../src/observers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEvE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,eAAe,CAAC;IACvB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,sDAAsD;IACtD,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACpC;AAOD,kDAAkD;AAClD,eAAO,MAAM,4BAA4B,EAAE,kBAiB1C,CAAC;AAEF,oCAAoC;AACpC,eAAO,MAAM,sBAAsB,EAAE,kBAepC,CAAC;AAEF,mCAAmC;AACnC,eAAO,MAAM,uBAAuB,EAAE,kBAiBrC,CAAC;AAEF,2CAA2C;AAC3C,eAAO,MAAM,oBAAoB,EAAE,kBAelC,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,SAAS,EAAE,kBAAkB,EAKzC,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,eAAe,CAAC;IACvB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAOrD"}

package/dist/observers.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OBSERVERS = exports.ambientSoundObserver = exports.shotCompositionObserver = exports.directorIntentObserver = exports.relationalWitnessingObserver = void 0;
+exports.classify = classify;
+function has(text, words) {
+    const t = text.toLowerCase();
+    return words.some((w) => t.includes(w));
+}
+/** Eye — what relationship is being witnessed. */
+exports.relationalWitnessingObserver = {
+    name: 'relational-witnessing-observer',
+    sense: 'eye',
+    type: 'relational-moment',
+    matches: (t) => has(t, [
+        'jerry',
+        'nicolas',
+        'renaud',
+        'renault',
+        'relationship',
+        'knowledge comes from relationship',
+        'my friend',
+        'ceremony',
+        'community',
+        'my meeting',
+    ]),
+};
+/** Ear — stated creative intent. */
+exports.directorIntentObserver = {
+    name: 'director-intent-observer',
+    sense: 'ear',
+    type: 'director-intent',
+    matches: (t) => has(t, [
+        'i want',
+        'i believe',
+        'vision',
+        'end result',
+        "i'm trying",
+        'desire',
+        'requirement',
+        'optimal',
+    ]),
+};
+/** Eye — what is seen / framed. */
+exports.shotCompositionObserver = {
+    name: 'shot-composition-observer',
+    sense: 'eye',
+    type: 'shot-composition',
+    matches: (t) => has(t, [
+        "i'm seeing",
+        'seeing',
+        'shot',
+        'video',
+        'image',
+        'animation',
+        'screen',
+        'visual',
+        'picture',
+        'frame',
+    ]),
+};
+/** Ear — recording / sonic environment. */
+exports.ambientSoundObserver = {
+    name: 'ambient-sound-observer',
+    sense: 'ear',
+    type: 'ambient-sound',
+    matches: (t) => has(t, [
+        'record',
+        'recording',
+        'audio',
+        'sound',
+        'natural sound',
+        'transcription',
+        'voice',
+        'hear',
+    ]),
+};
+/** Ordered observer registry — precedence matters (see module doc). */
+exports.OBSERVERS = [
+    exports.relationalWitnessingObserver,
+    exports.directorIntentObserver,
+    exports.shotCompositionObserver,
+    exports.ambientSoundObserver,
+];
+/** Classify a segment through the observer registry; default is a plain ear. */
+function classify(text) {
+    for (const obs of exports.OBSERVERS) {
+        if (obs.matches(text)) {
+            return { sense: obs.sense, type: obs.type, observer: obs.name };
+        }
+    }
+    return { sense: 'ear', type: 'transcript-segment', observer: 'default' };
+}
+//# sourceMappingURL=observers.js.map

package/dist/observers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observers.js","sourceRoot":"","sources":["../src/observers.ts"],"names":[],"mappings":";;;AAkHA,4BAOC;AAvGD,SAAS,GAAG,CAAC,IAAY,EAAE,KAAe;IACxC,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAC7B,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,kDAAkD;AACrC,QAAA,4BAA4B,GAAuB;IAC9D,IAAI,EAAE,gCAAgC;IACtC,KAAK,EAAE,KAAK;IACZ,IAAI,EAAE,mBAAmB;IACzB,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CACb,GAAG,CAAC,CAAC,EAAE;QACL,OAAO;QACP,SAAS;QACT,QAAQ;QACR,SAAS;QACT,cAAc;QACd,mCAAmC;QACnC,WAAW;QACX,UAAU;QACV,WAAW;QACX,YAAY;KACb,CAAC;CACL,CAAC;AAEF,oCAAoC;AACvB,QAAA,sBAAsB,GAAuB;IACxD,IAAI,EAAE,0BAA0B;IAChC,KAAK,EAAE,KAAK;IACZ,IAAI,EAAE,iBAAiB;IACvB,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CACb,GAAG,CAAC,CAAC,EAAE;QACL,QAAQ;QACR,WAAW;QACX,QAAQ;QACR,YAAY;QACZ,YAAY;QACZ,QAAQ;QACR,aAAa;QACb,SAAS;KACV,CAAC;CACL,CAAC;AAEF,mCAAmC;AACtB,QAAA,uBAAuB,GAAuB;IACzD,IAAI,EAAE,2BAA2B;IACjC,KAAK,EAAE,KAAK;IACZ,IAAI,EAAE,kBAAkB;IACxB,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CACb,GAAG,CAAC,CAAC,EAAE;QACL,YAAY;QACZ,QAAQ;QACR,MAAM;QACN,OAAO;QACP,OAAO;QACP,WAAW;QACX,QAAQ;QACR,QAAQ;QACR,SAAS;QACT,OAAO;KACR,CAAC;CACL,CAAC;AAEF,2CAA2C;AAC9B,QAAA,oBAAoB,GAAuB;IACtD,IAAI,EAAE,wBAAwB;IAC9B,KAAK,EAAE,KAAK;IACZ,IAAI,EAAE,eAAe;IACrB,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CACb,GAAG,CAAC,CAAC,EAAE;QACL,QAAQ;QACR,WAAW;QACX,OAAO;QACP,OAAO;QACP,eAAe;QACf,eAAe;QACf,OAAO;QACP,MAAM;KACP,CAAC;CACL,CAAC;AAEF,uEAAuE;AAC1D,QAAA,SAAS,GAAyB;IAC7C,oCAA4B;IAC5B,8BAAsB;IACtB,+BAAuB;IACvB,4BAAoB;CACrB,CAAC;AAQF,gFAAgF;AAChF,SAAgB,QAAQ,CAAC,IAAY;IACnC,KAAK,MAAM,GAAG,IAAI,iBAAS,EAAE,CAAC;QAC5B,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;QAClE,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;AAC3E,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @medicine-wheel/perception-layer — Types
+ *
+ * The eyes & ears of agent-supported film production. A production participant
+ * (human or agent) witnesses a recording as a stream of typed perceptual events
+ * and seeds a production knowledge graph. The agent is recorded as the WITNESS
+ * (`observedBy`) of each event — relationship, not extraction.
+ */
+import type { RelationalNode, ProductionRelation } from '@medicine-wheel/ontology-core';
+/** Through which organ the event is sensed. */
+export type PerceptualSense = 'ear' | 'eye';
+export type PerceptualEventType = 'transcript-segment' | 'director-intent' | 'ambient-sound' | 'shot-composition' | 'relational-moment';
+export interface PerceptualEvent {
+    id: string;
+    sense: PerceptualSense;
+    type: PerceptualEventType;
+    text: string;
+    /** File path or device id the event was witnessed from. */
+    source: string;
+    /** Order of the event within the stream. */
+    index: number;
+    /** AgentParticipant id — the witness, not the owner. */
+    observedBy?: string;
+    timestamp: string;
+}
+/**
+ * A production participant. An agent registers with a persistent persona
+ * signature carried across sessions, making it part of the production rather
+ * than an external tool.
+ */
+export interface AgentParticipant {
+    id: string;
+    name: string;
+    role: 'witness' | 'observer' | 'storyteller';
+    /** Persona markers (names, glyphs, phrases) carried across sessions. */
+    signature: string[];
+}
+export interface IngestOptions {
+    /** File path or device id; defaults to 'belt-device'. */
+    source?: string;
+    /** Participant recorded as witness on every event. */
+    participant?: AgentParticipant;
+    /** Minimum characters for a segment to be kept (default: 24). */
+    minSegmentLength?: number;
+}
+export interface BuildGraphOptions {
+    productionId?: string;
+    participant?: AgentParticipant;
+    recordingName?: string;
+}
+/** The seeded production graph — additive over ontology-core. */
+export interface ProductionGraphSeed {
+    /** Parent recording node (kind: 'recording'). */
+    recording: RelationalNode;
+    /** Per-segment knowledge nodes (kind: 'shot' | 'rush' | 'scene'). */
+    segments: RelationalNode[];
+    /** Witness/collaborator nodes (kind: 'collaborator'). */
+    collaborators: RelationalNode[];
+    /** ProductionRelation edges (rush-of / witnessed-by). */
+    relations: ProductionRelation[];
+}
+//# 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":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAExF,+CAA+C;AAC/C,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,KAAK,CAAC;AAE5C,MAAM,MAAM,mBAAmB,GAC3B,oBAAoB,GACpB,iBAAiB,GACjB,eAAe,GACf,kBAAkB,GAClB,mBAAmB,CAAC;AAExB,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,eAAe,CAAC;IACvB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,aAAa,CAAC;IAC7C,wEAAwE;IACxE,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,iEAAiE;AACjE,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,SAAS,EAAE,cAAc,CAAC;IAC1B,qEAAqE;IACrE,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,yDAAyD;IACzD,aAAa,EAAE,cAAc,EAAE,CAAC;IAChC,yDAAyD;IACzD,SAAS,EAAE,kBAAkB,EAAE,CAAC;CACjC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# 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/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@medicine-wheel/perception-layer",
+  "version": "0.4.9",
+  "description": "Eyes & ears of agent-supported film production — witness a belt-device recording as typed perceptual events and seed a production knowledge graph",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "medicine-wheel",
+    "film-production",
+    "perception",
+    "eyes-and-ears",
+    "indigenous",
+    "witnessing"
+  ],
+  "author": "jgwill",
+  "license": "MIT",
+  "dependencies": {
+    "@medicine-wheel/ontology-core": "^0.4.9"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0"
+  }
+}