@keyoku/types 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './memory.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,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './memory.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":"AAAA,cAAc,aAAa,CAAC"}

package/dist/memory.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Keyoku memory engine types
+ */
+export interface Memory {
+    id: string;
+    entity_id: string;
+    agent_id: string;
+    team_id: string;
+    visibility: string;
+    content: string;
+    type: string;
+    state: string;
+    importance: number;
+    confidence: number;
+    sentiment: number;
+    tags: string[];
+    access_count: number;
+    created_at: string;
+    updated_at: string;
+    last_accessed_at: string;
+    expires_at: string | null;
+}
+export interface SearchResult {
+    memory: Memory;
+    similarity: number;
+    score: number;
+}
+export interface RememberResult {
+    memories_created: number;
+    memories_updated: number;
+    memories_deleted: number;
+    skipped: number;
+}
+export interface HeartbeatResult {
+    should_act: boolean;
+    pending_work: Memory[];
+    deadlines: Memory[];
+    scheduled: Memory[];
+    decaying: Memory[];
+    conflicts: Array<{
+        memory: Memory;
+        reason: string;
+    }>;
+    stale_monitors: Memory[];
+    summary: string;
+    priority_action?: string;
+    action_items?: string[];
+    urgency?: 'immediate' | 'soon' | 'can_wait';
+}
+export interface HeartbeatAnalysis {
+    should_act: boolean;
+    action_brief: string;
+    recommended_actions: string[];
+    urgency: 'none' | 'low' | 'medium' | 'high' | 'critical';
+    reasoning: string;
+    autonomy: 'observe' | 'suggest' | 'act';
+    user_facing: string;
+}
+export interface GoalProgress {
+    plan: Memory;
+    activities: Memory[];
+    progress: number;
+    days_left: number;
+    status: 'on_track' | 'at_risk' | 'stalled' | 'no_activity';
+}
+export interface SessionContinuity {
+    last_memories: Memory[];
+    session_age_hours: number;
+    was_interrupted: boolean;
+    resume_suggestion: string;
+}
+export interface SentimentTrend {
+    recent_avg: number;
+    previous_avg: number;
+    direction: 'improving' | 'declining' | 'stable';
+    delta: number;
+    notable: Memory[];
+}
+export interface RelationshipAlert {
+    entity_name: string;
+    days_silent: number;
+    related_plans: Memory[];
+    urgency: 'info' | 'attention' | 'urgent';
+}
+export interface KnowledgeGap {
+    question: string;
+    asked_at: string;
+}
+export interface BehavioralPattern {
+    description: string;
+    confidence: number;
+    day_of_week?: number;
+    topics: string[];
+}
+export interface HeartbeatContextResult {
+    should_act: boolean;
+    scheduled: Memory[];
+    deadlines: Memory[];
+    pending_work: Memory[];
+    conflicts: Array<{
+        memory: Memory;
+        reason: string;
+    }>;
+    relevant_memories: SearchResult[];
+    summary: string;
+    analysis?: HeartbeatAnalysis;
+    goal_progress?: GoalProgress[];
+    continuity?: SessionContinuity;
+    sentiment_trend?: SentimentTrend;
+    relationship_alerts?: RelationshipAlert[];
+    knowledge_gaps?: KnowledgeGap[];
+    behavioral_patterns?: BehavioralPattern[];
+}
+export interface MemoryStats {
+    total_memories: number;
+    active_memories: number;
+    by_type: Record<string, number>;
+    by_state: Record<string, number>;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

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

package/dist/memory.js

@@ -0,0 +1,5 @@
+/**
+ * Keyoku memory engine types
+ */
+export {};
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

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

package/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@keyoku/types",
+  "version": "1.0.0",
+  "description": "Shared type definitions for Keyoku memory engine",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  }
+}

package/src/index.ts

@@ -0,0 +1 @@
+export * from './memory.js';

package/src/memory.ts

@@ -0,0 +1,128 @@
+/**
+ * Keyoku memory engine types
+ */
+
+export interface Memory {
+  id: string;
+  entity_id: string;
+  agent_id: string;
+  team_id: string;
+  visibility: string;
+  content: string;
+  type: string;
+  state: string;
+  importance: number;
+  confidence: number;
+  sentiment: number;
+  tags: string[];
+  access_count: number;
+  created_at: string;
+  updated_at: string;
+  last_accessed_at: string;
+  expires_at: string | null;
+}
+
+export interface SearchResult {
+  memory: Memory;
+  similarity: number;
+  score: number;
+}
+
+export interface RememberResult {
+  memories_created: number;
+  memories_updated: number;
+  memories_deleted: number;
+  skipped: number;
+}
+
+export interface HeartbeatResult {
+  should_act: boolean;
+  pending_work: Memory[];
+  deadlines: Memory[];
+  scheduled: Memory[];
+  decaying: Memory[];
+  conflicts: Array<{ memory: Memory; reason: string }>;
+  stale_monitors: Memory[];
+  summary: string;
+  priority_action?: string;
+  action_items?: string[];
+  urgency?: 'immediate' | 'soon' | 'can_wait';
+}
+
+export interface HeartbeatAnalysis {
+  should_act: boolean;
+  action_brief: string;
+  recommended_actions: string[];
+  urgency: 'none' | 'low' | 'medium' | 'high' | 'critical';
+  reasoning: string;
+  autonomy: 'observe' | 'suggest' | 'act';
+  user_facing: string;
+}
+
+export interface GoalProgress {
+  plan: Memory;
+  activities: Memory[];
+  progress: number;
+  days_left: number;
+  status: 'on_track' | 'at_risk' | 'stalled' | 'no_activity';
+}
+
+export interface SessionContinuity {
+  last_memories: Memory[];
+  session_age_hours: number;
+  was_interrupted: boolean;
+  resume_suggestion: string;
+}
+
+export interface SentimentTrend {
+  recent_avg: number;
+  previous_avg: number;
+  direction: 'improving' | 'declining' | 'stable';
+  delta: number;
+  notable: Memory[];
+}
+
+export interface RelationshipAlert {
+  entity_name: string;
+  days_silent: number;
+  related_plans: Memory[];
+  urgency: 'info' | 'attention' | 'urgent';
+}
+
+export interface KnowledgeGap {
+  question: string;
+  asked_at: string;
+}
+
+export interface BehavioralPattern {
+  description: string;
+  confidence: number;
+  day_of_week?: number;
+  topics: string[];
+}
+
+export interface HeartbeatContextResult {
+  should_act: boolean;
+  scheduled: Memory[];
+  deadlines: Memory[];
+  pending_work: Memory[];
+  conflicts: Array<{ memory: Memory; reason: string }>;
+  relevant_memories: SearchResult[];
+  summary: string;
+  analysis?: HeartbeatAnalysis;
+
+  // Extended signals
+  goal_progress?: GoalProgress[];
+  continuity?: SessionContinuity;
+  sentiment_trend?: SentimentTrend;
+  relationship_alerts?: RelationshipAlert[];
+  knowledge_gaps?: KnowledgeGap[];
+  behavioral_patterns?: BehavioralPattern[];
+}
+
+export interface MemoryStats {
+  total_memories: number;
+  active_memories: number;
+  by_type: Record<string, number>;
+  by_state: Record<string, number>;
+}

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src"]
+}