@sharpee/core 0.9.56-beta

package/dist/events/standard-events.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Standard event types and tags
+ * TODO: Move to proper location
+ */
+export declare const StandardEventTypes: {
+    readonly ACTION: "action";
+    readonly SYSTEM: "system";
+    readonly NARRATIVE: "narrative";
+    readonly ERROR: "error";
+};
+export declare const StandardEventTags: {
+    readonly SUCCESS: "success";
+    readonly FAILURE: "failure";
+    readonly INFO: "info";
+    readonly WARNING: "warning";
+    readonly ERROR: "error";
+};
+export declare const EventCategories: {
+    readonly ACTION: "action";
+    readonly SYSTEM: "system";
+    readonly NARRATIVE: "narrative";
+};
+export type StandardEventType = typeof StandardEventTypes[keyof typeof StandardEventTypes];
+export type StandardEventTag = typeof StandardEventTags[keyof typeof StandardEventTags];
+export type EventCategory = typeof EventCategories[keyof typeof EventCategories];
+//# sourceMappingURL=standard-events.d.ts.map

package/dist/events/standard-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-events.d.ts","sourceRoot":"","sources":["../../src/events/standard-events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,eAAO,MAAM,kBAAkB;;;;;CAKrB,CAAC;AAEX,eAAO,MAAM,iBAAiB;;;;;;CAMpB,CAAC;AAEX,eAAO,MAAM,eAAe;;;;CAIlB,CAAC;AAGX,MAAM,MAAM,iBAAiB,GAAG,OAAO,kBAAkB,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAC3F,MAAM,MAAM,gBAAgB,GAAG,OAAO,iBAAiB,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AACxF,MAAM,MAAM,aAAa,GAAG,OAAO,eAAe,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC"}

package/dist/events/standard-events.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Standard event types and tags
+ * TODO: Move to proper location
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventCategories = exports.StandardEventTags = exports.StandardEventTypes = void 0;
+// Using const objects instead of enums for better JavaScript compatibility
+exports.StandardEventTypes = {
+    ACTION: 'action',
+    SYSTEM: 'system',
+    NARRATIVE: 'narrative',
+    ERROR: 'error'
+};
+exports.StandardEventTags = {
+    SUCCESS: 'success',
+    FAILURE: 'failure',
+    INFO: 'info',
+    WARNING: 'warning',
+    ERROR: 'error'
+};
+exports.EventCategories = {
+    ACTION: 'action',
+    SYSTEM: 'system',
+    NARRATIVE: 'narrative'
+};
+//# sourceMappingURL=standard-events.js.map

package/dist/events/standard-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-events.js","sourceRoot":"","sources":["../../src/events/standard-events.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,2EAA2E;AAC9D,QAAA,kBAAkB,GAAG;IAChC,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,WAAW;IACtB,KAAK,EAAE,OAAO;CACN,CAAC;AAEE,QAAA,iBAAiB,GAAG;IAC/B,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;CACN,CAAC;AAEE,QAAA,eAAe,GAAG;IAC7B,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,WAAW;CACd,CAAC"}

package/dist/events/system-event.d.ts

@@ -0,0 +1,62 @@
+/**
+ * System events are used for debugging, monitoring, and system-level notifications.
+ * These are separate from SemanticEvents which represent story-meaningful occurrences.
+ */
+/**
+ * System event for debugging and monitoring
+ */
+export interface ISystemEvent {
+    /**
+     * Unique identifier for this event instance
+     */
+    id: string;
+    /**
+     * Timestamp when the event occurred
+     */
+    timestamp: number;
+    /**
+     * Which subsystem emitted this event
+     */
+    subsystem: string;
+    /**
+     * Type of system event (e.g., 'parse_attempt', 'validation_error', 'entity_resolved')
+     */
+    type: string;
+    /**
+     * Event-specific data
+     */
+    data: unknown;
+    /**
+     * Optional severity level
+     */
+    severity?: 'debug' | 'info' | 'warning' | 'error';
+    /**
+     * Optional correlation ID to track related events
+     */
+    correlationId?: string;
+}
+/**
+ * Common subsystem identifiers
+ */
+export declare const Subsystems: {
+    readonly PARSER: "parser";
+    readonly VALIDATOR: "validator";
+    readonly EXECUTOR: "executor";
+    readonly WORLD_MODEL: "world-model";
+    readonly TEXT_SERVICE: "text-service";
+    readonly EVENT_PROCESSOR: "event-processor";
+    readonly RULE_ENGINE: "rule-engine";
+};
+export type SubsystemType = typeof Subsystems[keyof typeof Subsystems];
+/**
+ * Helper to create a system event with common fields
+ */
+export declare function createSystemEvent(subsystem: string, type: string, data: unknown, options?: {
+    severity?: ISystemEvent['severity'];
+    correlationId?: string;
+}): ISystemEvent;
+/**
+ * Type guard to check if an object is a SystemEvent
+ */
+export declare function isSystemEvent(obj: unknown): obj is ISystemEvent;
+//# sourceMappingURL=system-event.d.ts.map

package/dist/events/system-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-event.d.ts","sourceRoot":"","sources":["../../src/events/system-event.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IAElD;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;CAQb,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,OAAO,UAAU,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEvE;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GACA,YAAY,CASd;AAWD;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,YAAY,CAU/D"}

package/dist/events/system-event.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * System events are used for debugging, monitoring, and system-level notifications.
+ * These are separate from SemanticEvents which represent story-meaningful occurrences.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Subsystems = void 0;
+exports.createSystemEvent = createSystemEvent;
+exports.isSystemEvent = isSystemEvent;
+/**
+ * Common subsystem identifiers
+ */
+exports.Subsystems = {
+    PARSER: 'parser',
+    VALIDATOR: 'validator',
+    EXECUTOR: 'executor',
+    WORLD_MODEL: 'world-model',
+    TEXT_SERVICE: 'text-service',
+    EVENT_PROCESSOR: 'event-processor',
+    RULE_ENGINE: 'rule-engine',
+};
+/**
+ * Helper to create a system event with common fields
+ */
+function createSystemEvent(subsystem, type, data, options) {
+    return {
+        id: generateEventId(),
+        timestamp: Date.now(),
+        subsystem,
+        type,
+        data,
+        ...options
+    };
+}
+/**
+ * Simple ID generator for events
+ * In production, might use UUID or similar
+ */
+let eventCounter = 0;
+function generateEventId() {
+    return `sys_${Date.now()}_${++eventCounter}`;
+}
+/**
+ * Type guard to check if an object is a SystemEvent
+ */
+function isSystemEvent(obj) {
+    return (typeof obj === 'object' &&
+        obj !== null &&
+        'id' in obj &&
+        'timestamp' in obj &&
+        'subsystem' in obj &&
+        'type' in obj &&
+        'data' in obj);
+}
+//# sourceMappingURL=system-event.js.map

package/dist/events/system-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-event.js","sourceRoot":"","sources":["../../src/events/system-event.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA4DH,8CAiBC;AAcD,sCAUC;AA3DD;;GAEG;AACU,QAAA,UAAU,GAAG;IACxB,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,UAAU;IACpB,WAAW,EAAE,aAAa;IAC1B,YAAY,EAAE,cAAc;IAC5B,eAAe,EAAE,iBAAiB;IAClC,WAAW,EAAE,aAAa;CAClB,CAAC;AAIX;;GAEG;AACH,SAAgB,iBAAiB,CAC/B,SAAiB,EACjB,IAAY,EACZ,IAAa,EACb,OAGC;IAED,OAAO;QACL,EAAE,EAAE,eAAe,EAAE;QACrB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,SAAS;QACT,IAAI;QACJ,IAAI;QACJ,GAAG,OAAO;KACX,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,IAAI,YAAY,GAAG,CAAC,CAAC;AACrB,SAAS,eAAe;IACtB,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,GAAY;IACxC,OAAO,CACL,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,IAAI,IAAI,GAAG;QACX,WAAW,IAAI,GAAG;QAClB,WAAW,IAAI,GAAG;QAClB,MAAM,IAAI,GAAG;QACb,MAAM,IAAI,GAAG,CACd,CAAC;AACJ,CAAC"}

package/dist/events/typed-event.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Typed Semantic Event - Generic event interface with compile-time type safety
+ *
+ * @see ADR-082 for design rationale
+ */
+import { EventDataRegistry, EventType } from './event-registry';
+import { ISemanticEvent } from './types';
+/**
+ * A semantic event with typed data based on the event type.
+ *
+ * Use this when you know the specific event type at compile time.
+ * The `data` property is strictly typed based on the event type.
+ *
+ * @example
+ * ```typescript
+ * const event: TypedSemanticEvent<'query.invalid'> = {
+ *   id: 'evt-1',
+ *   type: 'query.invalid',
+ *   timestamp: Date.now(),
+ *   entities: {},
+ *   data: { message: 'Invalid input', hint: 'Try again' }
+ * };
+ *
+ * // TypeScript knows event.data.message is string | undefined
+ * console.log(event.data.message);
+ * ```
+ */
+export interface TypedSemanticEvent<T extends EventType> extends Omit<ISemanticEvent, 'type' | 'data'> {
+    /**
+     * The event type - a literal string type for discrimination.
+     */
+    type: T;
+    /**
+     * Typed event data based on the event type.
+     */
+    data: EventDataRegistry[T];
+}
+/**
+ * Union of all known typed semantic events.
+ *
+ * Use this for exhaustive event handling where you want TypeScript
+ * to verify you've handled all event types.
+ *
+ * @example
+ * ```typescript
+ * function handleEvent(event: KnownSemanticEvent) {
+ *   switch (event.type) {
+ *     case 'query.invalid':
+ *       // TypeScript knows event.data is QueryInvalidData
+ *       return event.data.message;
+ *     case 'query.pending':
+ *       // TypeScript knows event.data is QueryPendingData
+ *       return event.data.query.messageId;
+ *     // ... handle all cases
+ *   }
+ * }
+ * ```
+ */
+export type KnownSemanticEvent = {
+    [K in EventType]: TypedSemanticEvent<K>;
+}[EventType];
+/**
+ * Type guard to check if an ISemanticEvent is a known typed event.
+ *
+ * This is useful when you have an ISemanticEvent and want to narrow
+ * it to a KnownSemanticEvent for exhaustive handling.
+ */
+export declare function isKnownEvent(event: ISemanticEvent): event is KnownSemanticEvent;
+//# sourceMappingURL=typed-event.d.ts.map

package/dist/events/typed-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-event.d.ts","sourceRoot":"","sources":["../../src/events/typed-event.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,SAAS,CACrD,SAAQ,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7C;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC;IAER;;OAEG;IACH,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,kBAAkB,GAAG;KAC9B,CAAC,IAAI,SAAS,GAAG,kBAAkB,CAAC,CAAC,CAAC;CACxC,CAAC,SAAS,CAAC,CAAC;AAEb;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,KAAK,IAAI,kBAAkB,CAI/E"}

package/dist/events/typed-event.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * Typed Semantic Event - Generic event interface with compile-time type safety
+ *
+ * @see ADR-082 for design rationale
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isKnownEvent = isKnownEvent;
+/**
+ * Type guard to check if an ISemanticEvent is a known typed event.
+ *
+ * This is useful when you have an ISemanticEvent and want to narrow
+ * it to a KnownSemanticEvent for exhaustive handling.
+ */
+function isKnownEvent(event) {
+    // Check if the event type is in our registry
+    // This is a runtime check that the type string is known
+    return event.type in {};
+}
+//# sourceMappingURL=typed-event.js.map

package/dist/events/typed-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-event.js","sourceRoot":"","sources":["../../src/events/typed-event.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAqEH,oCAIC;AAVD;;;;;GAKG;AACH,SAAgB,YAAY,CAAC,KAAqB;IAChD,6CAA6C;IAC7C,wDAAwD;IACxD,OAAO,KAAK,CAAC,IAAI,IAAK,EAAwB,CAAC;AACjD,CAAC"}

package/dist/events/types.d.ts

@@ -0,0 +1,105 @@
+import { EntityId } from '../types/entity';
+/**
+ * Represents a semantic event in the system
+ */
+export interface ISemanticEvent {
+    /**
+     * Unique identifier for this event
+     */
+    id: string;
+    /**
+     * The type of event
+     */
+    type: string;
+    /**
+     * Timestamp when the event was created
+     */
+    timestamp: number;
+    /**
+     * Entity IDs relevant to this event
+     */
+    entities: {
+        /**
+         * The entity that initiated the event (often the player)
+         */
+        actor?: EntityId;
+        /**
+         * The primary entity that the event affects
+         */
+        target?: EntityId;
+        /**
+         * A secondary entity involved in the event
+         */
+        instrument?: EntityId;
+        /**
+         * A location where the event occurred
+         */
+        location?: EntityId;
+        /**
+         * Other relevant entities
+         */
+        others?: EntityId[];
+    };
+    /**
+     * Event data - can contain any shape of data needed for the event
+     * Use type assertions to access typed data: event.data as MyEventData
+     */
+    data?: unknown;
+    /**
+     * Tags for categorizing and filtering events
+     */
+    tags?: string[];
+    /**
+     * Priority of the event (higher numbers are more important)
+     */
+    priority?: number;
+    /**
+     * Whether this event should be narrated
+     */
+    narrate?: boolean;
+}
+export { ISemanticEventSource as EventSource } from './semantic-event-source';
+/**
+ * Event listener for semantic events
+ */
+export type EventListener = (event: ISemanticEvent) => void;
+/**
+ * Event emitter for semantic events
+ */
+export interface IEventEmitter {
+    /**
+     * Add an event listener for a specific event type
+     * Use '*' to listen to all events
+     */
+    on: (type: string, listener: EventListener) => void;
+    /**
+     * Remove an event listener
+     */
+    off: (type: string, listener: EventListener) => void;
+    /**
+     * Emit an event
+     */
+    emit: (event: ISemanticEvent) => void;
+}
+/**
+ * Configuration options for the event system
+ */
+export interface IEventSystemOptions {
+    /**
+     * Maximum number of events to store in memory
+     */
+    maxEvents?: number;
+    /**
+     * Whether to emit events immediately when added
+     */
+    emitOnAdd?: boolean;
+    /**
+     * Custom filter for events that should be emitted
+     */
+    emitFilter?: (event: ISemanticEvent) => boolean;
+}
+/**
+ * Type alias for backwards compatibility
+ */
+export type Event = ISemanticEvent;
+//# sourceMappingURL=types.d.ts.map

package/dist/events/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/events/types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,EAAE;QACR;;WAEG;QACH,KAAK,CAAC,EAAE,QAAQ,CAAC;QAEjB;;WAEG;QACH,MAAM,CAAC,EAAE,QAAQ,CAAC;QAElB;;WAEG;QACH,UAAU,CAAC,EAAE,QAAQ,CAAC;QAEtB;;WAEG;QACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;QAEpB;;WAEG;QACH,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;KACrB,CAAC;IAEF;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAID,OAAO,EAAE,oBAAoB,IAAI,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE9E;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;IAEpD;;OAEG;IACH,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;IAErD;;OAEG;IACH,IAAI,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CACvC;AAID;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC;CACjD;AAED;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,cAAc,CAAC"}

package/dist/events/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// packages/core/src/events/types.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/events/types.js.map

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

package/dist/execution/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/execution/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAEA,cAAc,SAAS,CAAC"}

package/dist/execution/index.js

@@ -0,0 +1,23 @@
+"use strict";
+// packages/core/src/execution/index.ts
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+// command-router has been moved to stdlib as it depends on GameContext
+// command-handler has been moved to stdlib as it depends on parser and GameContext
+// game-context has been moved to stdlib as it depends on world-model
+// actions have been moved to stdlib as they depend on parser and GameContext
+//# sourceMappingURL=index.js.map

package/dist/execution/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":";AAAA,uCAAuC;;;;;;;;;;;;;;;;AAEvC,0CAAwB;AACxB,uEAAuE;AACvE,mFAAmF;AACnF,qEAAqE;AACrE,6EAA6E"}

package/dist/execution/types.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Generic context interface for execution
+ * Domain-specific contexts should extend this interface
+ */
+export interface IExecutionContext {
+    /**
+     * Additional context data
+     */
+    [key: string]: any;
+}
+/**
+ * Generic handler interface for any command-like system
+ * This is kept generic - specific implementations (IF, visual novel, etc)
+ * should define their own command and result types
+ */
+export interface ICommandHandler<TCommand = any, TResult = any> {
+    /**
+     * The verb or verbs that this handler can process
+     */
+    verbs: string[];
+    /**
+     * Check if this handler can handle the given command
+     */
+    canHandle: (command: TCommand, context: IExecutionContext) => boolean;
+    /**
+     * Execute the command
+     */
+    execute: (command: TCommand, context: IExecutionContext) => Promise<TResult> | TResult;
+    /**
+     * Validate the command before execution
+     */
+    validate?: (command: TCommand, context: IExecutionContext) => {
+        valid: boolean;
+        error?: string;
+    };
+}
+/**
+ * Generic action interface
+ * Actions are handlers with unique identifiers
+ */
+export interface IAction<TCommand = any, TResult = any> extends ICommandHandler<TCommand, TResult> {
+    /**
+     * Unique identifier for the action
+     */
+    id: string;
+    /**
+     * Action metadata (if any)
+     */
+    metadata?: any;
+}
+/**
+ * Generic router interface for command-like systems
+ */
+export interface ICommandRouter<TCommand = any, TResult = any> {
+    /**
+     * Register a command handler
+     */
+    registerHandler: (handler: ICommandHandler<TCommand, TResult>) => void;
+    /**
+     * Unregister a command handler
+     */
+    unregisterHandler: (handler: ICommandHandler<TCommand, TResult>) => void;
+    /**
+     * Get a handler for the command
+     */
+    getHandler: (command: TCommand, context: IExecutionContext) => ICommandHandler<TCommand, TResult> | undefined;
+    /**
+     * Route and execute a command
+     */
+    execute: (command: TCommand, context: IExecutionContext, options?: ICommandExecutionOptions<TCommand>) => Promise<TResult>;
+    /**
+     * Process the result of command execution and return text output
+     */
+    processResult?: (result: TResult) => string;
+}
+/**
+ * Generic factory interface for creating handlers
+ */
+export interface ICommandHandlerFactory<TCommand = any, TResult = any> {
+    /**
+     * Create a standard command handler
+     */
+    createHandler: (config: {
+        verbs: string[];
+        canHandle?: (command: TCommand, context: IExecutionContext) => boolean;
+        execute: (command: TCommand, context: IExecutionContext) => Promise<TResult> | TResult;
+        validate?: (command: TCommand, context: IExecutionContext) => {
+            valid: boolean;
+            error?: string;
+        };
+    }) => ICommandHandler<TCommand, TResult>;
+}
+/**
+ * Options for command execution
+ */
+export interface ICommandExecutionOptions<TCommand = any, TResult = any> {
+    /**
+     * Whether to skip validation
+     */
+    skipValidation?: boolean;
+    /**
+     * Custom validation callback
+     */
+    customValidation?: (command: TCommand, context: IExecutionContext) => {
+        valid: boolean;
+        error?: string;
+    };
+    /**
+     * Pre-execution hooks
+     */
+    preExecute?: ((command: TCommand, context: IExecutionContext) => Promise<void> | void)[];
+    /**
+     * Post-execution hooks
+     */
+    postExecute?: ((result: TResult, command: TCommand, context: IExecutionContext) => Promise<TResult> | TResult)[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/execution/types.d.ts.map

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

package/dist/execution/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// packages/core/src/execution/types.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/execution/types.js.map

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

package/dist/extensions/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types';
+export * from './registry';
+//# sourceMappingURL=index.d.ts.map

package/dist/extensions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/extensions/index.ts"],"names":[],"mappings":"AAEA,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC"}

package/dist/extensions/index.js

@@ -0,0 +1,20 @@
+"use strict";
+// packages/core/src/extensions/index.ts
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./registry"), exports);
+//# sourceMappingURL=index.js.map

package/dist/extensions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/extensions/index.ts"],"names":[],"mappings":";AAAA,wCAAwC;;;;;;;;;;;;;;;;AAExC,0CAAwB;AACxB,6CAA2B"}