@manifesto-ai/sdk 0.1.0

package/dist/hooks/queue.js

@@ -0,0 +1,141 @@
+/**
+ * Job Queue Implementation
+ *
+ * Manages enqueued jobs with priority support.
+ *
+ * @see SPEC §11.3 ENQ-1~6
+ * @module
+ */
+/**
+ * Job Queue for managing enqueued jobs.
+ *
+ * @see SPEC §11.3
+ */
+export class JobQueue {
+    _immediateJobs = [];
+    _normalJobs = [];
+    _deferredJobs = [];
+    _isProcessing = false;
+    _processScheduled = false;
+    /**
+     * 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, opts) {
+        const priority = opts?.priority ?? "normal";
+        const queuedJob = {
+            job,
+            priority,
+            label: opts?.label,
+            enqueuedAt: Date.now(),
+        };
+        switch (priority) {
+            case "immediate":
+                this._immediateJobs.push(queuedJob);
+                break;
+            case "defer":
+                this._deferredJobs.push(queuedJob);
+                break;
+            case "normal":
+            default:
+                this._normalJobs.push(queuedJob);
+                break;
+        }
+        // Schedule processing if not already scheduled
+        this._scheduleProcess();
+    }
+    /**
+     * 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
+     */
+    async processAll() {
+        if (this._isProcessing) {
+            return;
+        }
+        this._isProcessing = true;
+        this._processScheduled = false;
+        try {
+            // Process until all queues are empty
+            while (this._hasJobs()) {
+                // Process in priority order: immediate > normal > defer
+                const job = this._dequeueNext();
+                if (job) {
+                    try {
+                        await job.job();
+                    }
+                    catch (error) {
+                        // ENQ-5: Log error but continue processing
+                        console.error(`[JobQueue] Error in job${job.label ? ` "${job.label}"` : ""}:`, error);
+                    }
+                }
+            }
+        }
+        finally {
+            this._isProcessing = false;
+        }
+    }
+    /**
+     * Check if queue has pending jobs.
+     */
+    hasPendingJobs() {
+        return this._hasJobs();
+    }
+    /**
+     * Get count of pending jobs.
+     */
+    pendingCount() {
+        return (this._immediateJobs.length +
+            this._normalJobs.length +
+            this._deferredJobs.length);
+    }
+    /**
+     * Clear all pending jobs.
+     */
+    clear() {
+        this._immediateJobs = [];
+        this._normalJobs = [];
+        this._deferredJobs = [];
+    }
+    // ===========================================================================
+    // Private Methods
+    // ===========================================================================
+    _hasJobs() {
+        return (this._immediateJobs.length > 0 ||
+            this._normalJobs.length > 0 ||
+            this._deferredJobs.length > 0);
+    }
+    _dequeueNext() {
+        // Priority order: immediate > normal > defer
+        if (this._immediateJobs.length > 0) {
+            return this._immediateJobs.shift();
+        }
+        if (this._normalJobs.length > 0) {
+            return this._normalJobs.shift();
+        }
+        if (this._deferredJobs.length > 0) {
+            return this._deferredJobs.shift();
+        }
+        return undefined;
+    }
+    _scheduleProcess() {
+        if (this._processScheduled || this._isProcessing) {
+            return;
+        }
+        this._processScheduled = true;
+        // Use queueMicrotask for immediate scheduling
+        queueMicrotask(() => {
+            void this.processAll();
+        });
+    }
+}
+//# sourceMappingURL=queue.js.map

package/dist/hooks/queue.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @manifesto-ai/sdk v0.1.0
+ *
+ * Public developer API layer for the Manifesto protocol stack.
+ *
+ * @see sdk-SPEC-v0.1.0.md
+ * @packageDocumentation
+ */
+export type { SdkManifest } from './manifest.js';
+export { createApp, createTestApp } from './create-app.js';
+export { ManifestoApp } from './app.js';
+export { AppRefImpl, createAppRef } from './hooks/index.js';
+export type { AppRefCallbacks } from './hooks/index.js';
+export { HookableImpl } from './hooks/index.js';
+export type { HookState } from './hooks/index.js';
+export { JobQueue } from './hooks/index.js';
+export { HookContextImpl, createHookContext } from './hooks/index.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;;;;;;;GAOG;AACH,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAMjD,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAM3D,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAMxC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC5D,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+// =============================================================================
+// App Factory (SDK-CREATE)
+// =============================================================================
+export { createApp, createTestApp } from './create-app.js';
+// =============================================================================
+// ManifestoApp (SDK-APP)
+// =============================================================================
+export { ManifestoApp } from './app.js';
+// =============================================================================
+// Hooks (SDK-HOOKS)
+// =============================================================================
+export { AppRefImpl, createAppRef } from './hooks/index.js';
+export { HookableImpl } from './hooks/index.js';
+export { JobQueue } from './hooks/index.js';
+export { HookContextImpl, createHookContext } from './hooks/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;AAEhF,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE3D,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/manifest.d.ts

@@ -0,0 +1,10 @@
+/**
+ * SDK package identity and SPEC version metadata.
+ * Used for phase tracking and compatibility verification.
+ */
+export type SdkManifest = {
+    readonly name: '@manifesto-ai/sdk';
+    readonly specVersion: '0.1.0';
+    readonly phase: 'bootstrap';
+};
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;CAC7B,CAAC"}

package/dist/manifest.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

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

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@manifesto-ai/sdk",
+  "version": "0.1.0",
+  "description": "Manifesto SDK - Public developer API layer",
+  "author": "eggplantiny <eggplantiny@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/manifesto-ai/core.git",
+    "directory": "packages/sdk"
+  },
+  "bugs": {
+    "url": "https://github.com/manifesto-ai/core/issues"
+  },
+  "homepage": "https://github.com/manifesto-ai/core/tree/main/packages/sdk#readme",
+  "keywords": [
+    "manifesto",
+    "sdk",
+    "state-management",
+    "deterministic",
+    "semantic",
+    "traceable",
+    "ai"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@manifesto-ai/core": "2.4.0",
+    "@manifesto-ai/runtime": "0.1.0",
+    "@manifesto-ai/world": "2.3.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "test": "vitest run"
+  }
+}