@memgrafter/flatagents 2.2.0 → 2.2.2

package/MACHINES.md

@@ -22,7 +22,7 @@
 ```yaml
 # profiles.yml — agents reference by name
 spec: flatprofiles
-spec_version: "2.2.0"
+spec_version: "2.2.2"
 data:
   model_profiles:
     fast: { provider: cerebras, name: zai-glm-4.6, temperature: 0.6 }
@@ -166,8 +166,18 @@ class MyHooks(MachineHooks):
 ## Persistence
 
 ```yaml
-persistence: { enabled: true, backend: local }  # local | memory
+persistence: { enabled: true, backend: local }  # local | memory | sqlite
 ```
+
+SQLite backend (durable, single-file, no external dependencies):
+```yaml
+persistence:
+  enabled: true
+  backend: sqlite
+  db_path: ./flatmachines.sqlite   # optional, defaults to flatmachines.sqlite
+```
+Auto-selects `SQLiteLeaseLock` and `SQLiteConfigStore` — no runner injection needed.
+
 Resume: `machine.execute(resume_from=execution_id)`
 
 ## SDKs

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memgrafter/flatagents",
-  "version": "2.2.0",
+  "version": "2.2.2",
   "description": "TypeScript SDK for FlatAgents - Declarative LLM orchestration with YAML",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/schemas/flatagent.d.ts

@@ -149,7 +149,7 @@
  * The profile field specifies which profile name to use as base.
  */
 
-export const SPEC_VERSION = "2.2.0";
+export const SPEC_VERSION = "2.2.2";
 
 export interface AgentWrapper {
   spec: "flatagent";

package/schemas/flatagent.slim.d.ts

@@ -1,4 +1,4 @@
-export const SPEC_VERSION = "2.2.0";
+export const SPEC_VERSION = "2.2.2";
 export interface AgentWrapper {
     spec: "flatagent";
     spec_version: string;

package/schemas/flatagents-runtime.d.ts

@@ -800,7 +800,7 @@ export interface BackendConfig {
     aws_region?: string;
 }
 
-export const SPEC_VERSION = "2.2.0";
+export const SPEC_VERSION = "2.2.2";
 
 export interface SDKRuntimeWrapper {
     spec: "flatagents-runtime";

package/schemas/flatagents-runtime.schema.json

@@ -11,7 +11,7 @@
         },
         "spec_version": {
           "type": "string",
-          "const": "2.2.0"
+          "const": "2.2.2"
         },
         "execution_lock": {
           "$ref": "#/definitions/ExecutionLock"

package/schemas/flatagents-runtime.slim.d.ts

@@ -252,7 +252,7 @@ export interface BackendConfig {
     dynamodb_table?: string;
     aws_region?: string;
 }
-export const SPEC_VERSION = "2.2.0";
+export const SPEC_VERSION = "2.2.2";
 export interface SDKRuntimeWrapper {
     spec: "flatagents-runtime";
     spec_version: typeof SPEC_VERSION;

package/schemas/flatmachine.d.ts

@@ -240,7 +240,7 @@
  * PERSISTENCE (v0.2.0):
  * --------------------
  * MachineSnapshot    - Wire format for checkpoints (execution_id, state, context, step)
- * PersistenceConfig  - Backend config: {enabled: true, backend: "local"|"memory"}
+ * PersistenceConfig  - Backend config: {enabled: true, backend: "local"|"memory"|"sqlite"}
  * checkpoint_on      - Events to checkpoint: ["machine_start", "execute", "machine_end"]
  *
  * MACHINE LAUNCHING:
@@ -319,7 +319,7 @@
  * config_hash         - Content-addressed machine config key for cross-SDK resume (v2.1.0)
  */
 
-export const SPEC_VERSION = "2.2.0";
+export const SPEC_VERSION = "2.2.2";
 
 export interface MachineWrapper {
   spec: "flatmachine";
@@ -467,7 +467,9 @@ export interface MachineSnapshot {
 
 export interface PersistenceConfig {
   enabled: boolean;
-  backend: "local" | "redis" | "memory" | string;
+  backend: "local" | "sqlite" | "memory";
+  /** Database file path for sqlite backend. Defaults to "flatmachines.sqlite". */
+  db_path?: string;
   checkpoint_on?: string[];
   [key: string]: any;
 }

package/schemas/flatmachine.schema.json

@@ -707,7 +707,16 @@
           "type": "boolean"
         },
         "backend": {
-          "type": "string"
+          "type": "string",
+          "enum": [
+            "local",
+            "sqlite",
+            "memory"
+          ]
+        },
+        "db_path": {
+          "type": "string",
+          "description": "Database file path for sqlite backend. Defaults to \"flatmachines.sqlite\"."
         },
         "checkpoint_on": {
           "type": "array",

package/schemas/flatmachine.slim.d.ts

@@ -1,4 +1,4 @@
-export const SPEC_VERSION = "2.2.0";
+export const SPEC_VERSION = "2.2.2";
 export interface MachineWrapper {
     spec: "flatmachine";
     spec_version: string;
@@ -127,7 +127,8 @@ export interface MachineSnapshot {
 }
 export interface PersistenceConfig {
     enabled: boolean;
-    backend: "local" | "redis" | "memory" | string;
+    backend: "local" | "sqlite" | "memory";
+    db_path?: string;
     checkpoint_on?: string[];
     [key: string]: any;
 }

package/schemas/profiles.d.ts

@@ -108,7 +108,7 @@
  * stream            - Enable streaming responses (default: false)
  */
 
-export const SPEC_VERSION = "2.2.0";
+export const SPEC_VERSION = "2.2.2";
 
 export interface ProfilesWrapper {
   spec: "flatprofiles";

package/schemas/profiles.slim.d.ts

@@ -1,4 +1,4 @@
-export const SPEC_VERSION = "2.2.0";
+export const SPEC_VERSION = "2.2.2";
 export interface ProfilesWrapper {
     spec: "flatprofiles";
     spec_version: string;