@jungjaehoon/mama-os 0.57.0 → 0.58.1

package/dist/runtime/stimulus-delivery.d.ts

@@ -1,14 +1,14 @@
 import type { JsonValue } from '@jungjaehoon/mama-core/knowledge';
-import type { MemoryKind, MemoryStatus } from '@jungjaehoon/mama-core/memory/types';
 import type { MailboxRow, Stimulus } from '@jungjaehoon/mama-core/runtime/mailbox';
 import type { RuntimeHandle, StimulusDelivery, StimulusReceipt } from '@jungjaehoon/mama-core/runtime/runtime';
 import type { NativeTurnResult } from '@jungjaehoon/mama-core/runtime/native-turn';
 import type { NativeTurnResultRecord } from '@jungjaehoon/mama-core/runtime/native-input-journal';
 import type { SourceDelta } from '../connectors/framework/polling-scheduler.js';
 import type { WindowQueue } from '../replay/window-queue.js';
-import { type OwnerExchange } from './recent-owner-exchanges.js';
+import type { OwnerExchange } from './recent-owner-exchanges.js';
 import { type OwnerRuntimeBackend } from './owner-system-prompt.js';
-import type { TimeZoneSetting } from './timezone.js';
+import { type Lesson } from './turn-orders.js';
+import { type TimeZoneSetting } from './timezone.js';
 export declare const OWNER_RUNTIME_SESSION_KEY = "owner:runtime";
 export interface OwnerMessageInput {
     id: string;
@@ -24,53 +24,50 @@ export interface ScheduledInput {
     occurredAt: number;
     payload?: JsonValue;
 }
-export interface NativeEventInput {
-    id: string;
-    channelKey: string;
-    occurredAt: number;
-    payload?: JsonValue;
-}
 export interface StimulusIntake {
     accept(stimulus: Stimulus): StimulusReceipt;
     isPending?(sourceMessageRef: string): boolean;
     acceptOwnerMessage(input: OwnerMessageInput): StimulusReceipt;
     acceptSourceDelta(delta: SourceDelta): StimulusReceipt;
     acceptScheduled(input: ScheduledInput): StimulusReceipt;
-    acceptNativeEvent(input: NativeEventInput): StimulusReceipt;
+}
+/** A lesson the host may attach to a turn; the id keeps it from repeating within a session day. */
+export interface TurnLesson extends Lesson {
+    id: string;
+}
+/** The record order a live delta's notify turn leaves behind (W23). */
+export interface RecordOrderPort {
+    /** Enqueue the first record order for a live delta; called before its reply is routed. */
+    enqueueFirst(row: MailboxRow): void;
+    /** Check a finished record order; enqueue the next attempt when the batch is still unrecorded. */
+    onResult(row: MailboxRow, modelRunId: string | null): void | Promise<void>;
+    /** A record row that went uncertain or dead: the same check, run at once. */
+    onLost(row: MailboxRow, reason: string): void | Promise<void>;
 }
 export interface StimulusDeliveryOptions {
-    guidanceResolver: GuidanceResolver;
-    backend?: OwnerRuntimeBackend;
-    openWorkPipeline?: () => Promise<unknown>;
-    openWorkCandidates?: () => Promise<unknown>;
+    backend: OwnerRuntimeBackend;
     wikiEnabled?: boolean;
     formattingRoutes?: {
         reports: string;
         notifications: string;
     };
     timeZone: TimeZoneSetting;
+    /** Top lessons for a turn's text, most relevant first. */
+    lessons?: (text: string) => Promise<readonly TurnLesson[]>;
+    recordOrders?: RecordOrderPort;
     readResult?: (row: MailboxRow) => NativeTurnResultRecord | null;
     onUncertain?: StimulusDelivery['onUncertain'];
+    onDead?: StimulusDelivery['onDead'];
     recentOwnerExchanges?: (row: MailboxRow) => readonly OwnerExchange[] | Promise<readonly OwnerExchange[]>;
     onOwnerResult?: (row: MailboxRow, result: NativeTurnResult) => void | Promise<void>;
     onSourceResult?: (row: MailboxRow, result: NativeTurnResult) => void | Promise<void>;
+    /** Scheduled report results only; record orders never reach the owner. */
     onScheduledResult?: (row: MailboxRow, result: NativeTurnResult) => void | Promise<void>;
-    onNativeEventResult?: (row: MailboxRow, result: NativeTurnResult) => void | Promise<void>;
     onDelivered?: (row: MailboxRow, modelRunId: string | null) => void | Promise<void>;
     onFailed?: (row: MailboxRow, reason: string, modelRunId: string | null) => void | Promise<void>;
+    /** A live delta acked without a turn because every line was history when it was accepted. */
+    onSkipped?: (row: MailboxRow, reason: string) => void | Promise<void>;
 }
-export interface GuidanceEntry {
-    id: string;
-    kind: Extract<MemoryKind, 'lesson' | 'preference' | 'constraint' | 'workflow'>;
-    topic: string;
-    summary: string;
-    status: MemoryStatus;
-    updated_at: number | string;
-    applies_when?: string;
-    steps?: string[];
-    evidence_checks?: string[];
-}
-export type GuidanceResolver = () => Promise<readonly GuidanceEntry[]>;
 export interface ReplayClockDelivery extends StimulusDelivery {
     getReplaySourceEndMs(): number | undefined;
 }
@@ -80,6 +77,7 @@ export declare function createStimulusIntake(runtime: Pick<RuntimeHandle, 'accep
 export declare function renderWindowQueue(queue: WindowQueue): string;
 /** One bounded log line; preserve the original thrown error for runtime settlement. */
 export declare function stimulusFailureReason(error: unknown): string;
+export declare function isRecordOrderRow(row: Pick<MailboxRow, 'kind' | 'channelKey'>): boolean;
 /** Deliver every model-bearing kind through one serialized owner session. */
 export declare function createStimulusDelivery(options: StimulusDeliveryOptions): ReplayClockDelivery;
 //# sourceMappingURL=stimulus-delivery.d.ts.map

package/dist/runtime/stimulus-delivery.d.ts.map

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