@manifesto-ai/sdk 0.1.0

package/dist/hooks/app-ref.d.ts

@@ -0,0 +1,71 @@
+/**
+ * AppRef Implementation
+ *
+ * Read-only facade for hooks that prevents re-entrant mutations.
+ *
+ * @see SPEC v2.0.0 §17.2
+ * @module
+ */
+import type { DomainSchema } from "@manifesto-ai/core";
+import type { AppRef, AppState, AppStatus, ActOptions, Branch, ProposalId } from "@manifesto-ai/runtime";
+import type { WorldId } from "@manifesto-ai/world";
+import type { JobQueue } from "./queue.js";
+/**
+ * Callbacks for AppRef operations.
+ */
+export interface AppRefCallbacks {
+    getStatus(): AppStatus;
+    getState<T>(): AppState<T>;
+    getDomainSchema(): DomainSchema;
+    getCurrentHead(): WorldId;
+    currentBranch(): Branch;
+    generateProposalId(): ProposalId;
+}
+/**
+ * AppRefImpl: Read-only facade for hooks.
+ *
+ * HOOK-6: Hooks receive AppRef, not full App
+ * HOOK-7: enqueueAction() MUST defer execution until after hook completes
+ *
+ * @see SPEC v2.0.0 §17.2
+ */
+export declare class AppRefImpl implements AppRef {
+    private _callbacks;
+    private _queue;
+    private _enqueueAction;
+    constructor(callbacks: AppRefCallbacks, queue: JobQueue, enqueueAction: (proposalId: ProposalId, type: string, input?: unknown, opts?: ActOptions) => void);
+    /**
+     * Get current app status.
+     */
+    get status(): AppStatus;
+    /**
+     * Get current state.
+     */
+    getState<T = unknown>(): AppState<T>;
+    /**
+     * Get domain schema.
+     */
+    getDomainSchema(): DomainSchema;
+    /**
+     * Get current head WorldId.
+     */
+    getCurrentHead(): WorldId;
+    /**
+     * Get current branch.
+     */
+    currentBranch(): Branch;
+    /**
+     * Enqueue an action for execution after current hook completes.
+     *
+     * HOOK-7: MUST defer execution until after current hook completes.
+     * NOT synchronous execution — prevents re-entrancy.
+     *
+     * @see SPEC v2.0.0 §17.2
+     */
+    enqueueAction(type: string, input?: unknown, opts?: ActOptions): ProposalId;
+}
+/**
+ * Create an AppRef with the given callbacks.
+ */
+export declare function createAppRef(callbacks: AppRefCallbacks, queue: JobQueue, enqueueAction: (proposalId: ProposalId, type: string, input?: unknown, opts?: ActOptions) => void): AppRef;
+//# sourceMappingURL=app-ref.d.ts.map

package/dist/hooks/app-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-ref.d.ts","sourceRoot":"","sources":["../../src/hooks/app-ref.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EACV,MAAM,EACN,QAAQ,EACR,SAAS,EACT,UAAU,EACV,MAAM,EACN,UAAU,EACX,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,IAAI,SAAS,CAAC;IACvB,QAAQ,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC3B,eAAe,IAAI,YAAY,CAAC;IAChC,cAAc,IAAI,OAAO,CAAC;IAC1B,aAAa,IAAI,MAAM,CAAC;IACxB,kBAAkB,IAAI,UAAU,CAAC;CAClC;AAED;;;;;;;GAOG;AACH,qBAAa,UAAW,YAAW,MAAM;IACvC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,cAAc,CAKZ;gBAGR,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,QAAQ,EACf,aAAa,EAAE,CACb,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,OAAO,EACf,IAAI,CAAC,EAAE,UAAU,KACd,IAAI;IAOX;;OAEG;IACH,IAAI,MAAM,IAAI,SAAS,CAEtB;IAED;;OAEG;IACH,QAAQ,CAAC,CAAC,GAAG,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC;IAIpC;;OAEG;IACH,eAAe,IAAI,YAAY;IAI/B;;OAEG;IACH,cAAc,IAAI,OAAO;IAIzB;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;;;;;;OAOG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,UAAU;CAgB5E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,QAAQ,EACf,aAAa,EAAE,CACb,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,OAAO,EACf,IAAI,CAAC,EAAE,UAAU,KACd,IAAI,GACR,MAAM,CAER"}

package/dist/hooks/app-ref.js

@@ -0,0 +1,82 @@
+/**
+ * AppRef Implementation
+ *
+ * Read-only facade for hooks that prevents re-entrant mutations.
+ *
+ * @see SPEC v2.0.0 §17.2
+ * @module
+ */
+/**
+ * AppRefImpl: Read-only facade for hooks.
+ *
+ * HOOK-6: Hooks receive AppRef, not full App
+ * HOOK-7: enqueueAction() MUST defer execution until after hook completes
+ *
+ * @see SPEC v2.0.0 §17.2
+ */
+export class AppRefImpl {
+    _callbacks;
+    _queue;
+    _enqueueAction;
+    constructor(callbacks, queue, enqueueAction) {
+        this._callbacks = callbacks;
+        this._queue = queue;
+        this._enqueueAction = enqueueAction;
+    }
+    /**
+     * Get current app status.
+     */
+    get status() {
+        return this._callbacks.getStatus();
+    }
+    /**
+     * Get current state.
+     */
+    getState() {
+        return this._callbacks.getState();
+    }
+    /**
+     * Get domain schema.
+     */
+    getDomainSchema() {
+        return this._callbacks.getDomainSchema();
+    }
+    /**
+     * Get current head WorldId.
+     */
+    getCurrentHead() {
+        return this._callbacks.getCurrentHead();
+    }
+    /**
+     * Get current branch.
+     */
+    currentBranch() {
+        return this._callbacks.currentBranch();
+    }
+    /**
+     * Enqueue an action for execution after current hook completes.
+     *
+     * HOOK-7: MUST defer execution until after current hook completes.
+     * NOT synchronous execution — prevents re-entrancy.
+     *
+     * @see SPEC v2.0.0 §17.2
+     */
+    enqueueAction(type, input, opts) {
+        // Generate proposalId immediately (HANDLE-9)
+        const proposalId = this._callbacks.generateProposalId();
+        // Defer actual execution via job queue
+        this._queue.enqueue(() => {
+            // Execute action via callback (deferred)
+            this._enqueueAction(proposalId, type, input, opts);
+        }, { label: `enqueueAction:${type}:${proposalId}` });
+        // Return proposalId immediately for tracking
+        return proposalId;
+    }
+}
+/**
+ * Create an AppRef with the given callbacks.
+ */
+export function createAppRef(callbacks, queue, enqueueAction) {
+    return new AppRefImpl(callbacks, queue, enqueueAction);
+}
+//# sourceMappingURL=app-ref.js.map

package/dist/hooks/app-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-ref.js","sourceRoot":"","sources":["../../src/hooks/app-ref.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA0BH;;;;;;;GAOG;AACH,MAAM,OAAO,UAAU;IACb,UAAU,CAAkB;IAC5B,MAAM,CAAW;IACjB,cAAc,CAKZ;IAEV,YACE,SAA0B,EAC1B,KAAe,EACf,aAKS;QAET,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,cAAc,GAAG,aAAa,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAK,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC;IACzC,CAAC;IAED;;;;;;;OAOG;IACH,aAAa,CAAC,IAAY,EAAE,KAAe,EAAE,IAAiB;QAC5D,6CAA6C;QAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC;QAExD,uCAAuC;QACvC,IAAI,CAAC,MAAM,CAAC,OAAO,CACjB,GAAG,EAAE;YACH,yCAAyC;YACzC,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QACrD,CAAC,EACD,EAAE,KAAK,EAAE,iBAAiB,IAAI,IAAI,UAAU,EAAE,EAAE,CACjD,CAAC;QAEF,6CAA6C;QAC7C,OAAO,UAAU,CAAC;IACpB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,SAA0B,EAC1B,KAAe,EACf,aAKS;IAET,OAAO,IAAI,UAAU,CAAC,SAAS,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;AACzD,CAAC"}

package/dist/hooks/context.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Hook Context Implementation
+ *
+ * @see SPEC §11.2
+ * @module
+ */
+import type { AppRef, HookContext } from "@manifesto-ai/runtime";
+/**
+ * Internal HookContext implementation.
+ *
+ * @see SPEC §11.2
+ */
+export declare class HookContextImpl implements HookContext {
+    readonly app: AppRef;
+    readonly timestamp: number;
+    constructor(app: AppRef, timestamp: number);
+}
+/**
+ * Create a HookContext with the given parameters.
+ */
+export declare function createHookContext(app: AppRef, timestamp: number): HookContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/hooks/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/hooks/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEjE;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,WAAW;aAE/B,GAAG,EAAE,MAAM;aACX,SAAS,EAAE,MAAM;gBADjB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM;CAGpC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAChB,WAAW,CAEb"}

package/dist/hooks/context.js

@@ -0,0 +1,26 @@
+/**
+ * Hook Context Implementation
+ *
+ * @see SPEC §11.2
+ * @module
+ */
+/**
+ * Internal HookContext implementation.
+ *
+ * @see SPEC §11.2
+ */
+export class HookContextImpl {
+    app;
+    timestamp;
+    constructor(app, timestamp) {
+        this.app = app;
+        this.timestamp = timestamp;
+    }
+}
+/**
+ * Create a HookContext with the given parameters.
+ */
+export function createHookContext(app, timestamp) {
+    return new HookContextImpl(app, timestamp);
+}
+//# sourceMappingURL=context.js.map

package/dist/hooks/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/hooks/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;GAIG;AACH,MAAM,OAAO,eAAe;IAER;IACA;IAFlB,YACkB,GAAW,EACX,SAAiB;QADjB,QAAG,GAAH,GAAG,CAAQ;QACX,cAAS,GAAT,SAAS,CAAQ;IAEnC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAW,EACX,SAAiB;IAEjB,OAAO,IAAI,eAAe,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AAC7C,CAAC"}

package/dist/hooks/hookable.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Hookable Implementation
+ *
+ * @see SPEC §11 Hook System
+ * @module
+ */
+import type { Hookable, Unsubscribe } from "@manifesto-ai/runtime";
+import { JobQueue } from "./queue.js";
+/**
+ * Hook execution state for mutation guard.
+ */
+export interface HookState {
+    /** Currently executing hook name */
+    currentHook: string | null;
+    /** Depth of nested hook calls */
+    depth: number;
+}
+/**
+ * Enhanced Hookable implementation with mutation guard.
+ *
+ * @see SPEC §11.1 Hookable interface
+ * @see SPEC §11.4 HOOK-MUT-1~4
+ */
+export declare class HookableImpl<TEvents> implements Hookable<TEvents> {
+    private _handlers;
+    private _hookState;
+    private _jobQueue;
+    constructor(jobQueue?: JobQueue);
+    /**
+     * Register a hook handler.
+     *
+     * @see SPEC §11.1
+     */
+    on<K extends keyof TEvents>(name: K, fn: TEvents[K]): Unsubscribe;
+    /**
+     * Register a one-time hook handler.
+     *
+     * @see SPEC §11.1
+     */
+    once<K extends keyof TEvents>(name: K, fn: TEvents[K]): Unsubscribe;
+    /**
+     * Emit a hook event.
+     *
+     * @see SPEC §11.4 HOOK-MUT-1~4
+     * @internal
+     */
+    emit<K extends keyof TEvents>(name: K, ...args: any[]): Promise<void>;
+    /**
+     * Check if currently inside a hook execution.
+     *
+     * HOOK-MUT-1: Direct mutations during hook execution are forbidden
+     */
+    isInHook(): boolean;
+    /**
+     * Get current hook name (if in hook).
+     */
+    getCurrentHook(): string | null;
+    /**
+     * Assert that we are NOT in a hook.
+     * Throws HookMutationError if we are.
+     *
+     * HOOK-MUT-2: Mutation attempts during hooks throw HookMutationError
+     *
+     * @param apiName - Name of the API being called
+     * @throws HookMutationError
+     */
+    assertNotInHook(apiName: string): void;
+    /**
+     * Get the job queue for enqueue operations.
+     * @internal
+     */
+    getJobQueue(): JobQueue;
+    /**
+     * Get count of registered handlers for a hook.
+     * @internal
+     */
+    handlerCount<K extends keyof TEvents>(name: K): number;
+}
+//# sourceMappingURL=hookable.d.ts.map

package/dist/hooks/hookable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hookable.d.ts","sourceRoot":"","sources":["../../src/hooks/hookable.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAKtC;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,oCAAoC;IACpC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,qBAAa,YAAY,CAAC,OAAO,CAAE,YAAW,QAAQ,CAAC,OAAO,CAAC;IAC7D,OAAO,CAAC,SAAS,CAA4C;IAC7D,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,SAAS,CAAW;gBAEhB,QAAQ,CAAC,EAAE,QAAQ;IAI/B;;;;OAIG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,WAAW;IAajE;;;;OAIG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,WAAW;IAWnE;;;;;OAKG;IAEG,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAmC3E;;;;OAIG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,cAAc,IAAI,MAAM,GAAG,IAAI;IAI/B;;;;;;;;OAQG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMtC;;;OAGG;IACH,WAAW,IAAI,QAAQ;IAIvB;;;OAGG;IACH,YAAY,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM;CAIvD"}

package/dist/hooks/hookable.js

@@ -0,0 +1,137 @@
+/**
+ * Hookable Implementation
+ *
+ * @see SPEC §11 Hook System
+ * @module
+ */
+import { HookMutationError } from "@manifesto-ai/runtime";
+import { JobQueue } from "./queue.js";
+/**
+ * Enhanced Hookable implementation with mutation guard.
+ *
+ * @see SPEC §11.1 Hookable interface
+ * @see SPEC §11.4 HOOK-MUT-1~4
+ */
+export class HookableImpl {
+    _handlers = new Map();
+    _hookState = { currentHook: null, depth: 0 };
+    _jobQueue;
+    constructor(jobQueue) {
+        this._jobQueue = jobQueue ?? new JobQueue();
+    }
+    /**
+     * Register a hook handler.
+     *
+     * @see SPEC §11.1
+     */
+    on(name, fn) {
+        const key = name;
+        if (!this._handlers.has(key)) {
+            this._handlers.set(key, new Set());
+        }
+        const handlers = this._handlers.get(key);
+        handlers.add(fn);
+        return () => {
+            handlers.delete(fn);
+        };
+    }
+    /**
+     * Register a one-time hook handler.
+     *
+     * @see SPEC §11.1
+     */
+    once(name, fn) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const wrapper = ((...args) => {
+            unsub();
+            return fn(...args);
+        });
+        const unsub = this.on(name, wrapper);
+        return unsub;
+    }
+    /**
+     * Emit a hook event.
+     *
+     * @see SPEC §11.4 HOOK-MUT-1~4
+     * @internal
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async emit(name, ...args) {
+        const key = name;
+        const handlers = this._handlers.get(key);
+        if (!handlers || handlers.size === 0)
+            return;
+        // Track hook execution state
+        const previousHook = this._hookState.currentHook;
+        this._hookState.currentHook = key;
+        this._hookState.depth++;
+        try {
+            for (const handler of handlers) {
+                try {
+                    const result = handler(...args);
+                    if (result && typeof result.catch === "function") {
+                        result.catch((error) => {
+                            console.error(`[Hookable] Error in hook '${key}':`, error);
+                        });
+                    }
+                }
+                catch (error) {
+                    console.error(`[Hookable] Error in hook '${key}':`, error);
+                }
+            }
+        }
+        finally {
+            // Restore previous state
+            this._hookState.depth--;
+            this._hookState.currentHook = previousHook;
+            // Process enqueued jobs after all hooks complete
+            if (this._hookState.depth === 0) {
+                void this._jobQueue.processAll();
+            }
+        }
+    }
+    /**
+     * Check if currently inside a hook execution.
+     *
+     * HOOK-MUT-1: Direct mutations during hook execution are forbidden
+     */
+    isInHook() {
+        return this._hookState.depth > 0;
+    }
+    /**
+     * Get current hook name (if in hook).
+     */
+    getCurrentHook() {
+        return this._hookState.currentHook;
+    }
+    /**
+     * Assert that we are NOT in a hook.
+     * Throws HookMutationError if we are.
+     *
+     * HOOK-MUT-2: Mutation attempts during hooks throw HookMutationError
+     *
+     * @param apiName - Name of the API being called
+     * @throws HookMutationError
+     */
+    assertNotInHook(apiName) {
+        if (this.isInHook()) {
+            throw new HookMutationError(apiName, this._hookState.currentHook);
+        }
+    }
+    /**
+     * Get the job queue for enqueue operations.
+     * @internal
+     */
+    getJobQueue() {
+        return this._jobQueue;
+    }
+    /**
+     * Get count of registered handlers for a hook.
+     * @internal
+     */
+    handlerCount(name) {
+        const key = name;
+        return this._handlers.get(key)?.size ?? 0;
+    }
+}
+//# sourceMappingURL=hookable.js.map

package/dist/hooks/hookable.js.map

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

package/dist/hooks/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Hook System Module
+ *
+ * @see SPEC §11 Hook System
+ * @see SPEC v2.0.0 §17 (AppRef pattern)
+ * @module
+ */
+export { HookableImpl } from "./hookable.js";
+export type { HookState } from "./hookable.js";
+export { JobQueue } from "./queue.js";
+export { HookContextImpl, createHookContext } from "./context.js";
+export { AppRefImpl, createAppRef } from "./app-ref.js";
+export type { AppRefCallbacks } from "./app-ref.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGlE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,13 @@
+/**
+ * Hook System Module
+ *
+ * @see SPEC §11 Hook System
+ * @see SPEC v2.0.0 §17 (AppRef pattern)
+ * @module
+ */
+export { HookableImpl } from "./hookable.js";
+export { JobQueue } from "./queue.js";
+export { HookContextImpl, createHookContext } from "./context.js";
+// v2.0.0 AppRef pattern
+export { AppRefImpl, createAppRef } from "./app-ref.js";
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAElE,wBAAwB;AACxB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/hooks/queue.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Job Queue Implementation
+ *
+ * Manages enqueued jobs with priority support.
+ *
+ * @see SPEC §11.3 ENQ-1~6
+ * @module
+ */
+import type { EnqueueOptions, EnqueuedJob } from "@manifesto-ai/runtime";
+/**
+ * Job Queue for managing enqueued jobs.
+ *
+ * @see SPEC §11.3
+ */
+export declare class JobQueue {
+    private _immediateJobs;
+    private _normalJobs;
+    private _deferredJobs;
+    private _isProcessing;
+    private _processScheduled;
+    /**
+     * Enqueue a job with optional priority.
+     *
+     * ENQ-1: Jobs are executed after the current hook completes
+     * ENQ-2: Priority ordering: immediate > normal > defer
+     * ENQ-3: Within same priority, FIFO ordering
+     *
+     * @see SPEC §11.3
+     */
+    enqueue(job: EnqueuedJob, opts?: EnqueueOptions): void;
+    /**
+     * Process all pending jobs.
+     *
+     * ENQ-4: Jobs are processed in priority order
+     * ENQ-5: Errors in jobs are caught and logged (don't break queue)
+     * ENQ-6: New jobs enqueued during processing are handled
+     *
+     * @see SPEC §11.3
+     */
+    processAll(): Promise<void>;
+    /**
+     * Check if queue has pending jobs.
+     */
+    hasPendingJobs(): boolean;
+    /**
+     * Get count of pending jobs.
+     */
+    pendingCount(): number;
+    /**
+     * Clear all pending jobs.
+     */
+    clear(): void;
+    private _hasJobs;
+    private _dequeueNext;
+    private _scheduleProcess;
+}
+//# sourceMappingURL=queue.d.ts.map

package/dist/hooks/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/hooks/queue.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAYzE;;;;GAIG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,cAAc,CAAmB;IACzC,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,aAAa,CAAmB;IACxC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,iBAAiB,CAAS;IAElC;;;;;;;;OAQG;IACH,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,IAAI;IA0BtD;;;;;;;;OAQG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA8BjC;;OAEG;IACH,cAAc,IAAI,OAAO;IAIzB;;OAEG;IACH,YAAY,IAAI,MAAM;IAQtB;;OAEG;IACH,KAAK,IAAI,IAAI;IAUb,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,gBAAgB;CAYzB"}