interaqt 0.6.4 → 0.7.0

package/agent/agentspace/knowledge/generator/api-reference.md

@@ -175,7 +175,7 @@ import { DELETED_STATE, NON_DELETED_STATE, HARD_DELETION_PROPERTY_NAME } from 'i
 // Define deletion StateMachine for the HardDeletionProperty
 const deletionStateMachine = StateMachine.create({
     states: [NON_DELETED_STATE, DELETED_STATE],
-    defaultState: NON_DELETED_STATE,
+    initialState: NON_DELETED_STATE,
     transfers: [
         StateTransfer.create({
             trigger: {
@@ -263,7 +263,7 @@ const Article = Entity.create({
 const deletionProperty = HardDeletionProperty.create()
 deletionProperty.computation = StateMachine.create({
     states: [NON_DELETED_STATE, DELETED_STATE],
-    defaultState: NON_DELETED_STATE,
+    initialState: NON_DELETED_STATE,
     transfers: [
         StateTransfer.create({
             trigger: {
@@ -1028,20 +1028,20 @@ StateMachine.create(config: StateMachineConfig): StateMachineInstance
 **Parameters**
 - `config.states` (StateNode[], required): List of state nodes
 - `config.transfers` (StateTransfer[], required): List of state transfers
-- `config.defaultState` (StateNode, required): Default state
+- `config.initialState` (StateNode, required): Default state
 
 **Important: Initial Value Handling**
 
 When using StateMachine for entity/relation properties:
 - If the property's initial value is set when the entity/relation is created, handle it in the entity/relation's computation
-- If the StateMachine needs to save or modify this initial value, explicitly define `computeValue` on the `defaultState` to handle it
+- If the StateMachine needs to save or modify this initial value, explicitly define `computeValue` on the `initialState` to handle it
 
 ```typescript
 // Example: StateMachine handling initial value
 const MyStateMachine = StateMachine.create({
     states: [pendingState, activeState],
     transfers: [...],
-    defaultState: StateNode.create({
+    initialState: StateNode.create({
         name: 'pending',
         computeValue: (lastValue, mutationEvent) => {
             // Explicitly handle initial value
@@ -1074,7 +1074,7 @@ const OrderStateMachine = StateMachine.create({
             computeTarget: (mutationEvent) => ({ id: mutationEvent.record.payload.orderId })
         })
     ],
-    defaultState: pendingState
+    initialState: pendingState
 });
 
 // Relation with HardDeletionProperty for deletion management
@@ -1128,7 +1128,7 @@ const relationDeletionProperty = HardDeletionProperty.create()
 // Configure deletion for relation's HardDeletionProperty
 relationDeletionProperty.computation = StateMachine.create({
     states: [NON_DELETED_STATE, DELETED_STATE],
-    defaultState: NON_DELETED_STATE,
+    initialState: NON_DELETED_STATE,
     transfers: [
         StateTransfer.create({
             trigger: {
@@ -1384,7 +1384,7 @@ Custom.create(config: CustomConfig): CustomInstance
   ```typescript
   function(): any
   ```
-- `config.getDefaultValue` (function, optional): Provide default value when computation hasn't run:
+- `config.getInitialValue` (function, optional): Provide default value when computation hasn't run:
   ```typescript
   function(): any
   ```
@@ -1438,7 +1438,7 @@ const userStats = Dictionary.create({
                 avgPostsPerUser: dataDeps.posts.length / dataDeps.users.length || 0
             };
         },
-        getDefaultValue: function() {
+        getInitialValue: function() {
             return {
                 totalUsers: 0,
                 activeUsers: 0,
@@ -1481,7 +1481,7 @@ const counterDict = Dictionary.create({
                 timestamp: Math.floor(Date.now()/1000)  // In seconds
             };
         },
-        getDefaultValue: function() {
+        getInitialValue: function() {
             return { total: 0, count: 0, lastChange: 0 };
         }
     })
@@ -1549,7 +1549,7 @@ const apiDataProcessor = Dictionary.create({
                 processAt: Date.now()
             };
         },
-        getDefaultValue: function() {
+        getInitialValue: function() {
             return { status: 'pending', data: null };
         }
     })
@@ -1721,7 +1721,7 @@ const Order = Entity.create({
 
 **Best Practices**
 
-1. **Always provide `getDefaultValue`**: This ensures the computation has a valid initial value
+1. **Always provide `getInitialValue`**: This ensures the computation has a valid initial value
 2. **Use appropriate context type**: Global computations for system-wide values, property computations for entity-specific values
 3. **Use correct dataDeps type**: 
    - `type: 'property'` for accessing current record data in Property computations (use nested attributeQuery for relations)
@@ -2016,7 +2016,7 @@ const CounterStateMachine = StateMachine.create({
             computeTarget: (mutationEvent) => ({ id: mutationEvent.record.payload.counterId })
         })
     ],
-    defaultState: idleState
+    initialState: idleState
 });
 
 // Timestamp tracking
@@ -2041,7 +2041,7 @@ const ProcessingStateMachine = StateMachine.create({
             computeTarget: (mutationEvent) => ({ id: mutationEvent.record.payload.itemId })
         })
     ],
-    defaultState: pendingState
+    initialState: pendingState
 });
 
 // Apply to property

package/agent/agentspace/knowledge/generator/computation-implementation.md

@@ -133,7 +133,7 @@ When using `InteractionEventEntity` as the Transform input source, understand th
    });
    statusProperty.computation = StateMachine.create({
      states: [activeState, deletedState],
-     defaultState: activeState,  // StateMachine controls initial value
+     initialState: activeState,  // StateMachine controls initial value
      transfers: [
        StateTransfer.create({
          trigger: DeleteStyleInteraction,
@@ -386,7 +386,7 @@ const statusProperty = Property.create({
 statusProperty.computation = StateMachine.create({
   name: 'StyleStatus',
   states: [draftState, activeState, offlineState],
-  defaultState: draftState,  // defaultState determines initial value
+  initialState: draftState,  // initialState determines initial value
   transfers: [
     StateTransfer.create({
       current: draftState,
@@ -432,7 +432,7 @@ const updatedAtProperty = Property.create({
 updatedAtProperty.computation = StateMachine.create({
   name: 'UpdatedAt',
   states: [updatedState],
-  defaultState: updatedState,  // computeValue in updatedState provides initial value
+  initialState: updatedState,  // computeValue in updatedState provides initial value
   transfers: [
     StateTransfer.create({
       current: updatedState,
@@ -495,7 +495,7 @@ const modificationInfoProperty = Property.create({
 modificationInfoProperty.computation = StateMachine.create({
   name: 'ModificationTracker',
   states: [modifiedState],
-  defaultState: modifiedState,  // computeValue in modifiedState handles initial value
+  initialState: modifiedState,  // computeValue in modifiedState handles initial value
   transfers: [
     StateTransfer.create({
       current: modifiedState,
@@ -597,7 +597,7 @@ totalProductValue.computation = Custom.create({
     }, 0);
     return total;
   },
-  getDefaultValue: function() {
+  getInitialValue: function() {
     return 0;
   }
 });
@@ -637,7 +637,7 @@ finalPriceProperty.computation = Custom.create({
     
     return Math.round(finalPrice * 100) / 100; // Round to 2 decimals
   },
-  getDefaultValue: function() {
+  getInitialValue: function() {
     return 0;
   }
 });
@@ -702,7 +702,7 @@ EmployeeDepartmentInfoProperty.computation = Custom.create({
     }
     return `${employeeName} ($${salary}) - No department assigned`;
   },
-  getDefaultValue: function() {
+  getInitialValue: function() {
     return 'No info available';
   }
 });
@@ -813,7 +813,7 @@ const updatedAtProperty = Property.create({
 });
 updatedAtProperty.computation = StateMachine.create({
   states: [updatedState],
-  defaultState: updatedState,
+  initialState: updatedState,
   transfers: [
     StateTransfer.create({
       current: updatedState,
@@ -849,7 +849,7 @@ const statusProperty = Property.create({
 });
 statusProperty.computation = StateMachine.create({
   states: [activeState, offlineState],
-  defaultState: activeState,
+  initialState: activeState,
   transfers: [
     StateTransfer.create({
       current: activeState,
@@ -921,7 +921,7 @@ const updatedAtProperty = Property.create({
 });
 updatedAtProperty.computation = StateMachine.create({
   states: [updatedState],
-  defaultState: updatedState,
+  initialState: updatedState,
   transfers: [
     StateTransfer.create({
       current: updatedState,

package/agent/agentspace/knowledge/usage/04-reactive-computations.md

@@ -1223,7 +1223,7 @@ const EventEntity = Entity.create({
             computeTarget: (event) => ({ id: event.payload.eventId })
           })
         ],
-        defaultState: triggeredState
+        initialState: triggeredState
       })
     })
   ]
@@ -1274,7 +1274,7 @@ const CounterEntity = Entity.create({
             computeTarget: (event) => ({ id: event.payload.counterId })
           })
         ],
-        defaultState: idleState
+        initialState: idleState
       })
     })
   ]
@@ -1341,7 +1341,7 @@ const TaskEntity = Entity.create({
             computeTarget: (event) => ({ id: event.payload.taskId })
           })
         ],
-        defaultState: newState
+        initialState: newState
       })
     })
   ]

package/agent/agentspace/knowledge/usage/05-interactions.md

@@ -609,7 +609,7 @@ const User = Entity.create({
             computeTarget: (event) => ({ id: event.payload.userId })
           })
         ],
-        defaultState: NameUpdatedState
+        initialState: NameUpdatedState
       })
     }),
     Property.create({
@@ -625,7 +625,7 @@ const User = Entity.create({
             computeTarget: (event) => ({ id: event.payload.userId })
           })
         ],
-        defaultState: BioUpdatedState
+        initialState: BioUpdatedState
       })
     })
   ]
@@ -675,7 +675,7 @@ const Post = Entity.create({
       computation: StateMachine.create({
         name: 'PostStatus',
         states: [draftState, publishedState, deletedState],
-        defaultState: draftState,
+        initialState: draftState,
         transfers: [
           StateTransfer.create({
             current: draftState,
@@ -792,7 +792,7 @@ const Order = Entity.create({
       computation: StateMachine.create({
         name: 'OrderStatus',
         states: [pendingState, confirmedState, shippedState, deliveredState, cancelledState],
-        defaultState: pendingState,
+        initialState: pendingState,
         transfers: [
           StateTransfer.create({
             current: pendingState,
@@ -1101,7 +1101,7 @@ const DeliveredState = StateNode.create({ name: 'delivered' });
 const OrderStateMachine = StateMachine.create({
   name: 'OrderStatus',
   states: [PendingState, PaidState, ShippedState, DeliveredState],
-  defaultState: PendingState,
+  initialState: PendingState,
   transfers: [
     StateTransfer.create({
       current: PendingState,

package/agent/agentspace/knowledge/usage/13-testing.md

@@ -618,7 +618,7 @@ describe('Approval Process Activity', () => {
       name: 'ApprovalProcess',
       states: [submittedState, reviewingState, approvedState, rejectedState],
       transfers: [submitTransfer, approveTransfer, rejectTransfer],
-      defaultState: submittedState
+      initialState: submittedState
     });
     
     const controller = new Controller({

package/agent/agentspace/knowledge/usage/14-api-reference.md

@@ -527,7 +527,7 @@ StateMachine.create(config: StateMachineConfig): KlassInstance<typeof StateMachi
 **Parameters**
 - `config.states` (StateNode[], required): List of state nodes
 - `config.transfers` (StateTransfer[], required): List of state transfers
-- `config.defaultState` (StateNode, required): Default state
+- `config.initialState` (StateNode, required): Default state
 
 **Examples**
 ```typescript
@@ -547,7 +547,7 @@ const OrderStateMachine = StateMachine.create({
             trigger: ConfirmOrderInteraction
         })
     ],
-    defaultState: pendingState
+    initialState: pendingState
 })
 ```
 

package/agent/agentspace/knowledge/usage/15-entity-crud-patterns.md

@@ -358,7 +358,7 @@ const DeletedState = StateNode.create({ name: 'deleted' });
 const ArticleStatusStateMachine = StateMachine.create({
   name: 'ArticleStatus',
   states: [ActiveState, DeletedState],
-  defaultState: ActiveState,
+  initialState: ActiveState,
   transfers: [
     StateTransfer.create({
       current: ActiveState,
@@ -393,7 +393,7 @@ const Article = Entity.create({
       name: 'status',
       type: 'string',
       computation: ArticleStatusStateMachine,
-      defaultValue: () => ArticleStatusStateMachine.defaultState.name
+      defaultValue: () => ArticleStatusStateMachine.initialState.name
     }),
     Property.create({
       name: 'deletedAt',
@@ -428,7 +428,7 @@ const Article = Entity.create({
               computeTarget: (event) => ({ id: event.payload.articleId })
             })
           ],
-          defaultState: activeState
+          initialState: activeState
         });
       })()
     })
@@ -473,7 +473,7 @@ const Article = Entity.create({
 const deletionProperty = Article.properties.find(p => p.name === '_isDeleted_');
 deletionProperty.computation = StateMachine.create({
   states: [NON_DELETED_STATE, DELETED_STATE],
-  defaultState: NON_DELETED_STATE,
+  initialState: NON_DELETED_STATE,
   transfers: [
     StateTransfer.create({
       trigger: DeleteArticle,
@@ -606,7 +606,7 @@ const PublishedState = StateNode.create({ name: 'published' });
 const ArticlePublishStateMachine = StateMachine.create({
   name: 'ArticlePublishStatus',
   states: [DraftState, PublishedState],
-  defaultState: DraftState,
+  initialState: DraftState,
   transfers: [
     StateTransfer.create({
       current: DraftState,
@@ -716,7 +716,7 @@ const TimestampState = StateNode.create({
 const TimestampStateMachine = StateMachine.create({
   name: 'TimestampRecorder',
   states: [TimestampState],
-  defaultState: TimestampState,
+  initialState: TimestampState,
   transfers: [
     // Self-transition: stays in same state but triggers computeValue
     StateTransfer.create({
@@ -771,7 +771,7 @@ const User = Entity.create({
             computeTarget: (event) => ({ id: event.user.id })
           })
         ],
-        defaultState: activeState
+        initialState: activeState
       })
     })
   ]
@@ -805,7 +805,7 @@ const Article = Entity.create({
             computeTarget: (event) => ({ id: event.payload.articleId })
           })
         ],
-        defaultState: modifiedState
+        initialState: modifiedState
       })
     })
   ]
@@ -838,7 +838,7 @@ const Sensor = Entity.create({
             computeTarget: (event) => ({ id: event.payload.sensorId })
           })
         ],
-        defaultState: triggeredState
+        initialState: triggeredState
       })
     })
   ]
@@ -891,7 +891,7 @@ Property.create({
   name: 'lastActivityAt',
   computation: StateMachine.create({
     states: [activeState],
-    defaultState: activeState,
+    initialState: activeState,
     transfers: [
       StateTransfer.create({
         current: activeState,
@@ -1028,7 +1028,7 @@ const DeletedState = StateNode.create({ name: 'deleted' });
 const ArticleLifecycleStateMachine = StateMachine.create({
   name: 'ArticleLifecycle',
   states: [DraftState, PublishedState, DeletedState],
-  defaultState: DraftState,
+  initialState: DraftState,
   transfers: [
     StateTransfer.create({
       current: DraftState,

package/agent/agentspace/knowledge/usage/19-common-anti-patterns.md

@@ -235,7 +235,7 @@ StateMachine.create({
       trigger: SomeInteraction
     })
   ],
-  defaultState: 'active'  // Should be object reference!
+  initialState: 'active'  // Should be object reference!
 });
 
 // ✅ CORRECT: Use object references
@@ -251,7 +251,7 @@ StateMachine.create({
       trigger: SomeInteraction
     })
   ],
-  defaultState: activeState     // Object reference
+  initialState: activeState     // Object reference
 });
 ```