@almadar/agent 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,170 @@
+import { FullOrbitalUnit, OrbitalSchema, OrbitalDefinition } from '@almadar/core/types';
+import { LLMClient } from '@almadar/llm';
+
+/**
+ * @almadar/agent Types
+ *
+ * Core types for the agent package.
+ *
+ * LLM access is provided by @almadar/llm (imported directly).
+ * Skill prompts are provided by @almadar/skills (imported directly).
+ *
+ * Only builder-specific modules that don't exist as almadar packages
+ * use dependency injection via AgentDependencies.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Options for combining orbitals into a schema.
+ */
+interface CombinerOptions {
+    name: string;
+    description?: string;
+    version?: string;
+    theme?: string;
+    defaultRoute?: string;
+    validate?: boolean;
+}
+/**
+ * Result from combining orbitals.
+ */
+interface CombinerResult {
+    success: boolean;
+    schema?: OrbitalSchema;
+    error?: string;
+    stats?: {
+        totalOrbitals: number;
+        totalEntities: number;
+        totalPages: number;
+        totalTraits: number;
+    };
+    validation?: {
+        valid: boolean;
+        errors: Array<{
+            code: string;
+            path: string;
+            message: string;
+        }>;
+        warnings: Array<{
+            code: string;
+            path: string;
+            message: string;
+        }>;
+    };
+}
+/**
+ * Function signature for combining orbitals.
+ */
+type CombineOrbitalsFn = (orbitals: FullOrbitalUnit[], options: CombinerOptions) => CombinerResult;
+/**
+ * Result from converting domain language to schema.
+ */
+interface DomainConversionResult {
+    success: boolean;
+    schema?: OrbitalSchema;
+    errors?: Array<{
+        message: string;
+    }>;
+}
+/**
+ * Function signature for converting domain text to schema.
+ */
+type ConvertDomainToSchemaFn = (domainText: string, baseSchema: {
+    name: string;
+    orbitals: unknown[];
+}) => DomainConversionResult;
+/**
+ * Log entry from orbital generation.
+ */
+interface GenerationLog {
+    level: 'info' | 'warn' | 'error' | 'debug';
+    message: string;
+    data?: Record<string, unknown>;
+}
+/**
+ * Result from orbital generation.
+ */
+interface OrbitalGenerationResult {
+    orbital: unknown;
+    fingerprint?: string;
+    usedTemplate?: boolean;
+    usage?: {
+        totalTokens: number;
+        inputTokens?: number;
+        outputTokens?: number;
+    };
+    validation?: {
+        valid: boolean;
+        errors?: Array<{
+            code: string;
+            path: string;
+            message: string;
+        }>;
+    };
+}
+/**
+ * Options for orbital generation.
+ */
+interface OrbitalGenerationOptions {
+    validate?: boolean;
+    requirements?: {
+        entities?: string[];
+        states?: string[];
+        events?: string[];
+        guards?: string[];
+        pages?: string[];
+        effects?: string[];
+        rawRequirements?: string[];
+    };
+    onLog?: (log: GenerationLog) => void;
+}
+/**
+ * Function signature for generating a full orbital.
+ * Accepts LLMClient from @almadar/llm directly.
+ */
+type GenerateFullOrbitalFn = (client: LLMClient, orbital: OrbitalDefinition, options?: OrbitalGenerationOptions) => Promise<OrbitalGenerationResult>;
+/**
+ * @deprecated AgentDependencies is no longer needed. All functions are now
+ * internal to @almadar/agent. Import them directly:
+ * - combineOrbitals from '@almadar/agent'
+ * - convertDomainToSchema from '@almadar/agent'
+ * - generateFullOrbital from '@almadar/agent'
+ *
+ * @example Old (deprecated):
+ * ```typescript
+ * const deps: AgentDependencies = { ... };
+ * const tools = createAgentTools('/workspace', deps);
+ * ```
+ *
+ * @example New:
+ * ```typescript
+ * import { createAgentTools } from '@almadar/agent';
+ * const tools = createAgentTools('/workspace');
+ * ```
+ */
+interface AgentDependencies {
+    /**
+     * @deprecated Use combineOrbitals from '@almadar/agent' instead
+     */
+    combineOrbitals: CombineOrbitalsFn;
+    /**
+     * @deprecated Use convertDomainToSchema from '@almadar/agent' instead
+     */
+    convertDomainToSchema: ConvertDomainToSchemaFn;
+    /**
+     * @deprecated Use generateFullOrbital from '@almadar/agent' instead
+     */
+    generateFullOrbital: GenerateFullOrbitalFn;
+}
+/**
+ * Subagent configuration.
+ * Compatible with the deepagents library SubAgent type.
+ */
+interface SubAgent {
+    name: string;
+    description: string;
+    systemPrompt: string;
+}
+
+export type { AgentDependencies, CombineOrbitalsFn, CombinerOptions, CombinerResult, ConvertDomainToSchemaFn, DomainConversionResult, GenerateFullOrbitalFn, GenerationLog, OrbitalGenerationOptions, OrbitalGenerationResult, SubAgent };

package/dist/types.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=types.js.map
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"types.js"}

package/package.json

@@ -0,0 +1,102 @@
+{
+  "name": "@almadar/agent",
+  "version": "1.0.0",
+  "description": "AI agent infrastructure for Almadar orbital schema generation",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./types": {
+      "import": "./dist/types.js",
+      "types": "./dist/types.d.ts"
+    },
+    "./tools": {
+      "import": "./dist/tools/index.js",
+      "types": "./dist/tools/index.d.ts"
+    },
+    "./prompts": {
+      "import": "./dist/prompts/index.js",
+      "types": "./dist/prompts/index.d.ts"
+    },
+    "./agent": {
+      "import": "./dist/agent/index.js",
+      "types": "./dist/agent/index.d.ts"
+    },
+    "./persistence": {
+      "import": "./dist/persistence/index.js",
+      "types": "./dist/persistence/index.d.ts"
+    },
+    "./event-transformer": {
+      "import": "./dist/event-transformer/index.js",
+      "types": "./dist/event-transformer/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "uuid": "^9.0.0",
+    "zod": "^3.22.0",
+    "@almadar/core": "1.0.1",
+    "@almadar/integrations": "1.0.0",
+    "@almadar/patterns": "1.0.1",
+    "@almadar/skills": "1.0.0",
+    "@almadar/llm": "1.0.0",
+    "@almadar/std": "1.0.1"
+  },
+  "peerDependencies": {
+    "@langchain/core": ">=0.2.0",
+    "@langchain/langgraph": ">=0.2.0",
+    "@langchain/langgraph-checkpoint": ">=1.0.0",
+    "deepagents": ">=1.3.0"
+  },
+  "peerDependenciesMeta": {
+    "@langchain/core": {
+      "optional": false
+    },
+    "@langchain/langgraph": {
+      "optional": false
+    },
+    "@langchain/langgraph-checkpoint": {
+      "optional": false
+    },
+    "deepagents": {
+      "optional": false
+    }
+  },
+  "devDependencies": {
+    "@langchain/core": "^0.3.0",
+    "@langchain/langgraph": "^0.2.0",
+    "@langchain/langgraph-checkpoint": "^1.0.0",
+    "@types/uuid": "^9.0.0",
+    "deepagents": "^1.3.1",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/almadar-io/almadar.git",
+    "directory": "packages/almadar-agent"
+  },
+  "license": "MIT",
+  "keywords": [
+    "almadar",
+    "orbital",
+    "agent",
+    "deepagent",
+    "schema-generation"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "build:watch": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}