deepseek-coder-agent-cli 1.0.0

package/dist/contracts/module-schema.json

@@ -0,0 +1,419 @@
+{
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "title": "AGI CLI Unified Module Schema",
+    "description": "Defines the modular architecture for both TypeScript and Python implementations",
+    "version": "1.0.0",
+    "author": "Bo Shang",
+    "framework": "agi-cli",
+    "modules": {
+        "core": {
+            "description": "Core runtime and execution infrastructure",
+            "required": true,
+            "submodules": {
+                "types": {
+                    "description": "Shared type definitions - single source of truth",
+                    "exports": [
+                        "ConversationRole", "ConversationMessage", "ToolCallRequest",
+                        "ProviderToolDefinition", "JSONSchemaObject", "JSONSchemaProperty",
+                        "ProviderResponse", "StreamChunk", "ProviderUsage"
+                    ]
+                },
+                "schema": {
+                    "description": "Schema loading and validation",
+                    "exports": [
+                        "loadUnifiedSchema", "validateToolArguments", "getProviderConfig",
+                        "getTaskTypeConfig", "getToolDefinition", "SchemaCache"
+                    ],
+                    "dependencies": ["types"]
+                },
+                "errors": {
+                    "description": "Structured error handling with auto-fix capabilities",
+                    "exports": [
+                        "StructuredError", "ErrorSeverity", "ErrorCategory",
+                        "DangerousOperationError", "BlockedOperationError",
+                        "ValidationError", "ResourceLimitError", "ContextOverflowError",
+                        "ErrorSuggestion", "ErrorRecoveryStrategy"
+                    ],
+                    "dependencies": ["types"]
+                },
+                "version": {
+                    "description": "Semantic versioning and compatibility checking",
+                    "exports": [
+                        "SemanticVersion", "VersionBump", "VersionConstraint",
+                        "parseVersion", "compareVersions", "satisfiesConstraint",
+                        "VersionManager", "SelfUpgradeManager", "PluginDependencyResolver"
+                    ],
+                    "dependencies": ["types", "errors"]
+                },
+                "dynamic_guardrails": {
+                    "description": "Adaptive safety controls that evolve with AI capabilities",
+                    "exports": [
+                        "GuardrailCategory", "GuardrailSeverity", "GuardrailCondition",
+                        "AdaptiveGuardrail", "GuardrailManager", "SafetyContext",
+                        "createGuardrail", "evaluateGuardrail", "updateGuardrail",
+                        "getGuardrailStatus", "resetGuardrail", "exportGuardrails",
+                        "importGuardrails", "mergeGuardrailSets"
+                    ],
+                    "dependencies": ["types", "errors"]
+                },
+                "ai_system_updater": {
+                    "description": "Comprehensive AI system update and migration framework",
+                    "exports": [
+                        "UpdateSource", "UpdatePackage", "UpdateStrategy",
+                        "SystemUpdater", "UpdateValidator", "RollbackManager",
+                        "MigrationPlan", "BackupStrategy", "UpdateOrchestrator",
+                        "checkForUpdates", "prepareUpdate", "executeUpdate",
+                        "validateUpdate", "rollbackUpdate", "cleanupUpdate"
+                    ],
+                    "dependencies": ["types", "errors", "version"]
+                },
+                "toolRuntime": {
+                    "description": "Tool execution engine with caching and validation",
+                    "exports": [
+                        "ToolRuntime", "ToolRecord", "ToolSuite", "CacheEntry",
+                        "ToolRuntimeObserver", "ToolExecutionResult", "CACHEABLE_TOOLS"
+                    ],
+                    "dependencies": ["types", "schema", "errors"]
+                },
+                "provider": {
+                    "description": "LLM provider abstraction layer",
+                    "exports": [
+                        "LLMProvider", "ProviderFactory", "ProviderAdapter",
+                        "UnifiedProviderConfig", "createProvider", "listProviders"
+                    ],
+                    "dependencies": ["types", "schema", "errors"]
+                },
+                "context": {
+                    "description": "Token and context management",
+                    "exports": [
+                        "ContextManager", "ContextManagerConfig", "TruncationResult",
+                        "estimateTokens", "truncateToolOutput", "pruneMessages"
+                    ],
+                    "dependencies": ["types"]
+                },
+                "agent": {
+                    "description": "Agent runtime and conversation management",
+                    "exports": [
+                        "Agent", "AgentConfig", "AgentRuntime",
+                        "processConversation", "resolveToolCalls"
+                    ],
+                    "dependencies": ["types", "toolRuntime", "provider", "context", "errors"]
+                }
+            }
+        },
+        "plugins": {
+            "description": "Plugin system for extensibility",
+            "required": true,
+            "submodules": {
+                "base": {
+                    "description": "Plugin base class and metadata",
+                    "exports": [
+                        "Plugin", "PluginMetadata", "PluginConfig", "PluginCategory",
+                        "PluginState", "PluginLifecycle"
+                    ],
+                    "dependencies": ["core.types", "core.version"]
+                },
+                "registry": {
+                    "description": "Plugin discovery and registration",
+                    "exports": [
+                        "PluginRegistry", "discoverPlugins", "loadPlugin", "unloadPlugin",
+                        "getPluginTools", "validatePluginCompatibility"
+                    ],
+                    "dependencies": ["base", "core.toolRuntime", "core.version"]
+                },
+                "loader": {
+                    "description": "Dynamic plugin loading with lazy initialization",
+                    "exports": [
+                        "PluginLoader", "LazyPlugin", "loadPluginModule",
+                        "isPluginEnabled", "getPluginModule"
+                    ],
+                    "dependencies": ["base", "registry"]
+                }
+            }
+        },
+        "alphaZero": {
+            "description": "Alpha Zero 2 - Competitive RL Framework",
+            "required": false,
+            "submodules": {
+                "types": {
+                    "description": "Alpha Zero specific types",
+                    "exports": [
+                        "AgentPerformanceMetrics", "CompetitiveAgentConfig",
+                        "CompetitionRoundResult", "CompetitionStandings",
+                        "CodeQualityMetrics", "TournamentConfig", "TournamentResult"
+                    ]
+                },
+                "metrics": {
+                    "description": "Performance metrics tracking",
+                    "exports": [
+                        "MetricsTracker", "createDefaultMetrics", "recordMetric",
+                        "getMetricsSummary", "exportMetrics"
+                    ],
+                    "dependencies": ["types"]
+                },
+                "codeEvaluator": {
+                    "description": "Code quality evaluation",
+                    "exports": [
+                        "extractCodeBlocks", "evaluateCodeQuality", "calculateRewardScore",
+                        "analyzeComplexity", "analyzeErrorHandling", "analyzeDocumentation"
+                    ],
+                    "dependencies": ["types", "metrics"]
+                },
+                "selfModification": {
+                    "description": "Version-controlled code self-improvement",
+                    "exports": [
+                        "SelfModificationEngine", "ToolVersion", "ModificationResult",
+                        "createCheckpoint", "modifyTool", "rollback", "getVersionHistory"
+                    ],
+                    "dependencies": ["types", "core.version"]
+                },
+                "introspection": {
+                    "description": "Runtime analysis and self-awareness",
+                    "exports": [
+                        "IntrospectionEngine", "PerformanceProfile", "CodeAnalysis",
+                        "recordExecution", "generateSuggestions", "identifyBottlenecks"
+                    ],
+                    "dependencies": ["types", "metrics"]
+                },
+                "competitive": {
+                    "description": "Multi-agent competition framework",
+                    "exports": [
+                        "CompetitiveAgentRunner", "TournamentRunner",
+                        "runCompetitionRound", "runTournament", "formatTournamentSummary"
+                    ],
+                    "dependencies": ["types", "metrics", "codeEvaluator", "core.agent"]
+                },
+                "reward": {
+                    "description": "Reward calculation system",
+                    "exports": [
+                        "RewardSystem", "RewardSignal", "calculateReward",
+                        "normalizeReward", "combineRewards"
+                    ],
+                    "dependencies": ["types", "codeEvaluator"]
+                }
+            }
+        },
+        "security": {
+            "description": "Security research module (optional, lazy loaded)",
+            "required": false,
+            "requiresAuth": true,
+            "submodules": {
+                "core": {
+                    "description": "Authorization and reconnaissance",
+                    "exports": [
+                        "AuthorizationScope", "AuthorizationRecord", "ReconResult",
+                        "VulnerabilityFinding", "SecurityResearchEngine",
+                        "createBugBountyAuthorization", "createPentestAuthorization"
+                    ]
+                },
+                "google": {
+                    "description": "Google Cloud/Workspace persistence research",
+                    "optional": true,
+                    "exports": [
+                        "GoogleService", "PersistenceCategory", "PersistenceVector",
+                        "GooglePersistenceResearcher", "GCP_PERSISTENCE_VECTORS",
+                        "WORKSPACE_PERSISTENCE_VECTORS"
+                    ],
+                    "dependencies": ["core"]
+                }
+            }
+        },
+        "capabilities": {
+            "description": "Core tool implementations",
+            "required": true,
+            "submodules": {
+                "filesystem": {
+                    "description": "File operations",
+                    "exports": ["readFile", "writeFile", "listDirectory"],
+                    "tools": ["read", "write"]
+                },
+                "edit": {
+                    "description": "In-place file editing",
+                    "exports": ["editFile", "applyEdit"],
+                    "tools": ["edit"]
+                },
+                "bash": {
+                    "description": "Shell command execution",
+                    "exports": ["executeBash", "runInBackground", "killProcess"],
+                    "tools": ["bash"]
+                },
+                "search": {
+                    "description": "Code and file search",
+                    "exports": ["globSearch", "grepSearch"],
+                    "tools": ["glob", "grep"]
+                },
+                "web": {
+                    "description": "Web operations",
+                    "exports": ["webSearch", "webFetch"],
+                    "tools": ["web_search", "web_fetch"]
+                },
+                "coding": {
+                    "description": "Code analysis and generation",
+                    "exports": [
+                        "analyzeComplexity", "findDependencies", "generateDocstring",
+                        "suggestRefactorings", "generateTestStub"
+                    ],
+                    "tools": ["analyze_complexity", "find_dependencies", "generate_docstring"]
+                }
+            }
+        },
+        "ui": {
+            "description": "User interface components",
+            "required": false,
+            "submodules": {
+                "display": {
+                    "description": "Output formatting and display",
+                    "exports": ["formatOutput", "formatError", "formatToolResult"]
+                },
+                "prompt": {
+                    "description": "Interactive prompt handling",
+                    "exports": ["createPrompt", "promptUser"]
+                },
+                "theme": {
+                    "description": "Theming and styling",
+                    "exports": ["Theme", "applyTheme", "getColors"]
+                }
+            }
+        }
+    },
+    "interfaces": {
+        "ToolSuite": {
+            "description": "Collection of related tools",
+            "properties": {
+                "name": { "type": "string", "description": "Suite identifier" },
+                "version": { "type": "string", "description": "Semantic version" },
+                "tools": { "type": "array", "items": { "$ref": "#/interfaces/ToolDefinition" } }
+            }
+        },
+        "ToolDefinition": {
+            "description": "Single tool definition",
+            "properties": {
+                "name": { "type": "string" },
+                "description": { "type": "string" },
+                "parameters": { "$ref": "#/interfaces/JSONSchemaObject" },
+                "execute": { "type": "function", "async": true }
+            }
+        },
+        "Plugin": {
+            "description": "Plugin interface",
+            "properties": {
+                "metadata": { "$ref": "#/interfaces/PluginMetadata" },
+                "initialize": { "type": "function", "async": true },
+                "getToolSuites": { "type": "function", "returns": "ToolSuite[]" },
+                "unload": { "type": "function", "async": true }
+            }
+        },
+        "PluginMetadata": {
+            "description": "Plugin metadata",
+            "properties": {
+                "id": { "type": "string" },
+                "name": { "type": "string" },
+                "version": { "type": "string" },
+                "category": { "type": "string", "enum": ["coding", "rl", "security", "dev"] },
+                "dependencies": { "type": "array", "items": { "type": "string" } },
+                "minCliVersion": { "type": "string", "optional": true },
+                "maxCliVersion": { "type": "string", "optional": true }
+            }
+        },
+        "LLMProvider": {
+            "description": "LLM provider interface",
+            "properties": {
+                "id": { "type": "string" },
+                "model": { "type": "string" },
+                "generate": { "type": "function", "async": true },
+                "generateStream": { "type": "function", "async": true, "optional": true }
+            }
+        },
+        "StructuredError": {
+            "description": "Structured error with recovery capabilities",
+            "properties": {
+                "code": { "type": "string" },
+                "message": { "type": "string" },
+                "severity": { "type": "string", "enum": ["critical", "error", "warning", "info"] },
+                "category": { "type": "string" },
+                "suggestions": { "type": "array", "items": { "$ref": "#/interfaces/ErrorSuggestion" } },
+                "recoverable": { "type": "boolean" },
+                "tryAutoFix": { "type": "function", "optional": true }
+            }
+        },
+        "SemanticVersion": {
+            "description": "Semantic version representation",
+            "properties": {
+                "major": { "type": "integer" },
+                "minor": { "type": "integer" },
+                "patch": { "type": "integer" },
+                "prerelease": { "type": "string", "optional": true },
+                "build": { "type": "string", "optional": true }
+            }
+        }
+    },
+    "patterns": {
+        "lazyLoading": {
+            "description": "Pattern for lazy loading optional modules",
+            "example": {
+                "typescript": "let _module: typeof import('./module') | null = null;\nexport async function getModule() {\n  if (!_module) _module = await import('./module');\n  return _module;\n}",
+                "python": "_module = None\ndef get_module():\n    global _module\n    if _module is None:\n        from . import module as _m\n        _module = _m\n    return _module"
+            }
+        },
+        "observer": {
+            "description": "Observer pattern for lifecycle events",
+            "events": ["onStart", "onResult", "onError", "onCacheHit"]
+        },
+        "registry": {
+            "description": "Registry pattern for tool/plugin management",
+            "operations": ["register", "unregister", "get", "list", "has"]
+        },
+        "factory": {
+            "description": "Factory pattern for creating providers/agents",
+            "operations": ["create", "configure", "validate"]
+        }
+    },
+    "fileStructure": {
+        "typescript": {
+            "src/": {
+                "core/": ["types.ts", "schema.ts", "errors.ts", "version.ts", "toolRuntime.ts", "provider.ts", "context.ts", "agent.ts", "index.ts"],
+                "plugins/": ["base.ts", "registry.ts", "loader.ts", "index.ts"],
+                "alpha-zero/": ["types.ts", "metrics.ts", "codeEvaluator.ts", "selfModification.ts", "introspection.ts", "competitive.ts", "reward.ts", "index.ts"],
+                "alpha-zero/security/": ["core.ts", "simulation.ts", "google.ts", "googleLoader.ts", "index.ts"],
+                "capabilities/": ["filesystem.ts", "edit.ts", "bash.ts", "search.ts", "web.ts", "coding.ts", "index.ts"],
+                "ui/": ["UnifiedUIRenderer.ts", "PromptController.ts", "outputMode.ts", "theme.ts", "globalWriteLock.ts", "index.ts"],
+                "contracts/": ["unified-schema.json", "module-schema.json"]
+            }
+        },
+        "python": {
+            "agi_cli/": {
+                "core/": ["types.py", "schema.py", "errors.py", "version.py", "tool_runtime.py", "provider.py", "context.py", "agent.py", "__init__.py"],
+                "plugins/": ["base.py", "registry.py", "loader.py", "__init__.py"],
+                "alpha_zero/": ["types.py", "metrics.py", "code_evaluator.py", "self_modification.py", "introspection.py", "competitive.py", "reward.py", "__init__.py"],
+                "alpha_zero/security/": ["core.py", "google.py", "__init__.py"],
+                "capabilities/": ["filesystem.py", "edit.py", "bash.py", "search.py", "web.py", "coding.py", "__init__.py"],
+                "ui/": ["unified_ui_renderer.py", "prompt_controller.py", "output_mode.py", "theme.py", "__init__.py"]
+            }
+        }
+    },
+    "conventions": {
+        "naming": {
+            "typescript": {
+                "files": "camelCase.ts",
+                "classes": "PascalCase",
+                "functions": "camelCase",
+                "constants": "SCREAMING_SNAKE_CASE",
+                "interfaces": "PascalCase (no I prefix)"
+            },
+            "python": {
+                "files": "snake_case.py",
+                "classes": "PascalCase",
+                "functions": "snake_case",
+                "constants": "SCREAMING_SNAKE_CASE"
+            }
+        },
+        "exports": {
+            "typescript": "Named exports preferred, barrel files (index.ts) for modules",
+            "python": "__all__ in __init__.py, explicit imports"
+        },
+        "async": {
+            "typescript": "async/await with Promise<T>",
+            "python": "async/await with Optional sync wrappers"
+        }
+    }
+}

package/dist/contracts/schemas/agent-profile.schema.json

@@ -0,0 +1,157 @@
+{
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "title": "Agent Profile Manifest v1.0",
+    "description": "Schema describing agent profiles, their default providers/models, and how system prompts are constructed.",
+    "type": "object",
+    "required": ["contractVersion", "version", "profiles"],
+    "properties": {
+        "contractVersion": {
+            "type": "string",
+            "description": "Version of the profile manifest contract the payload implements."
+        },
+        "version": {
+            "type": "string",
+            "description": "Semantic or date-based version identifier for the manifest."
+        },
+        "label": {
+            "type": "string",
+            "description": "Optional display label for the manifest."
+        },
+        "description": {
+            "type": "string",
+            "description": "Optional description for operators."
+        },
+        "profiles": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+                "$ref": "#/definitions/ProfileEntry"
+            }
+        },
+        "metadata": {
+            "type": "object",
+            "description": "Implementation specific metadata."
+        }
+    },
+    "definitions": {
+        "ProfileEntry": {
+            "type": "object",
+            "required": ["name", "label", "defaultProvider", "defaultModel", "systemPrompt", "rulebook"],
+            "properties": {
+                "name": {
+                    "type": "string",
+                    "description": "Stable identifier for the agent profile."
+                },
+                "label": {
+                    "type": "string",
+                    "description": "Human readable profile label."
+                },
+                "description": {
+                    "type": "string",
+                    "description": "Optional description rendered in UIs."
+                },
+                "defaultProvider": {
+                    "type": "string",
+                    "description": "Provider identifier the profile defaults to."
+                },
+                "defaultModel": {
+                    "type": "string",
+                    "description": "Default model identifier for the profile."
+                },
+                "temperature": {
+                    "type": "number",
+                    "description": "Optional default temperature."
+                },
+                "maxTokens": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "description": "Optional default max token count."
+                },
+                "systemPrompt": {
+                    "$ref": "#/definitions/PromptConfig"
+                },
+                "rulebook": {
+                    "$ref": "#/definitions/RulebookReference"
+                },
+                "metadata": {
+                    "type": "object",
+                    "description": "Implementation specific metadata."
+                }
+            },
+            "additionalProperties": false
+        },
+        "PromptConfig": {
+            "oneOf": [
+                {
+                    "$ref": "#/definitions/RulebookPromptConfig"
+                },
+                {
+                    "$ref": "#/definitions/LiteralPromptConfig"
+                }
+            ]
+        },
+        "RulebookPromptConfig": {
+            "type": "object",
+            "required": ["type"],
+            "properties": {
+                "type": {
+                    "const": "rulebook"
+                },
+                "template": {
+                    "type": "string",
+                    "description": "Optional template with placeholders like {{rulebook}}."
+                },
+                "metadata": {
+                    "type": "object",
+                    "description": "Implementation specific metadata."
+                }
+            },
+            "additionalProperties": false
+        },
+        "LiteralPromptConfig": {
+            "type": "object",
+            "required": ["type", "content"],
+            "properties": {
+                "type": {
+                    "const": "literal"
+                },
+                "content": {
+                    "type": "string",
+                    "description": "Static system prompt to use verbatim."
+                },
+                "metadata": {
+                    "type": "object",
+                    "description": "Implementation specific metadata."
+                }
+            },
+            "additionalProperties": false
+        },
+        "RulebookReference": {
+            "type": "object",
+            "required": ["file"],
+            "properties": {
+                "file": {
+                    "type": "string",
+                    "description": "Relative path to the rulebook JSON file."
+                },
+                "version": {
+                    "type": "string",
+                    "description": "Optional human readable version of the rulebook."
+                },
+                "contractVersion": {
+                    "type": "string",
+                    "description": "Optional contract version for the referenced rulebook."
+                },
+                "description": {
+                    "type": "string",
+                    "description": "Summary of what the rulebook enforces."
+                },
+                "metadata": {
+                    "type": "object",
+                    "description": "Implementation specific metadata."
+                }
+            },
+            "additionalProperties": false
+        }
+    }
+}