@omnidev-ai/core 0.9.0 → 0.10.1

package/dist/index.d.ts

@@ -330,11 +330,6 @@ interface CapabilityExports {
 	module?: string;
 	gitignore?: string[];
 }
-interface EnvDeclaration {
-	required?: boolean;
-	secret?: boolean;
-	default?: string;
-}
 interface SyncConfig {
 	on_sync?: string;
 }
@@ -344,7 +339,6 @@ interface CliConfig {
 interface CapabilityConfig {
 	capability: CapabilityMetadata;
 	exports?: CapabilityExports;
-	env?: Record<string, EnvDeclaration | Record<string, never>>;
 	mcp?: McpConfig;
 	sync?: SyncConfig;
 	cli?: CliConfig;
@@ -360,7 +354,7 @@ interface McpToolSchema {
 *
 * - **stdio**: Local process using stdin/stdout (default)
 *   - Requires: command
-*   - Optional: args, env, cwd
+*   - Optional: args, cwd
 *
 * - **http**: Remote HTTP server (recommended for remote servers)
 *   - Requires: url
@@ -462,8 +456,17 @@ interface GitCapabilitySourceConfig {
 	/** Subdirectory within the repo containing the capability */
 	path?: string;
 }
+/** Configuration for a local file-sourced capability */
+interface FileCapabilitySourceConfig {
+	/** Source path with file:// prefix (e.g., "file://./capabilities/my-cap") */
+	source: string;
+}
 /** Combined type for all capability source configurations */
-type CapabilitySourceConfig = string | GitCapabilitySourceConfig;
+type CapabilitySourceConfig = string | GitCapabilitySourceConfig | FileCapabilitySourceConfig;
+/**
+* Type guard to check if a source config is a FileCapabilitySourceConfig
+*/
+declare function isFileSourceConfig(config: CapabilitySourceConfig): config is FileCapabilitySourceConfig;
 /** Lock file entry for a capability (version tracking) */
 interface CapabilityLockEntry {
 	/** Original source reference */
@@ -499,7 +502,6 @@ interface OmniConfig {
 	project?: string;
 	active_profile?: string;
 	always_enabled_capabilities?: string[];
-	env?: Record<string, string>;
 	profiles?: Record<string, ProfileConfig>;
 	providers?: {
 		enabled?: Provider[];
@@ -554,7 +556,7 @@ interface SyncBundle {
 	subagents: Subagent[];
 	/** Merged hooks from all capabilities */
 	hooks?: HooksConfig;
-	instructionsPath: string;
+	/** Generated instructions content from rules and docs, embedded directly into provider files */
 	instructionsContent: string;
 }
 interface ProviderContext {
@@ -612,14 +614,11 @@ declare function discoverCapabilities(): Promise<string[]>;
 declare function loadCapabilityConfig(capabilityPath: string): Promise<CapabilityConfig>;
 /**
 * Loads a complete capability including config, skills, rules, docs, and exports.
-* Validates environment requirements before loading.
-*
 * @param capabilityPath - Path to the capability directory
-* @param env - Environment variables to validate against
 * @returns Fully loaded capability
-* @throws Error if validation fails or loading errors occur
+* @throws Error if loading errors occur
 */
-declare function loadCapability(capabilityPath: string, env: Record<string, string>): Promise<LoadedCapability>;
+declare function loadCapability(capabilityPath: string): Promise<LoadedCapability>;
 /**
 * Registry of loaded capabilities with helper functions.
 */
@@ -649,13 +648,6 @@ declare function buildCapabilityRegistry(): Promise<CapabilityRegistry>;
 * @returns Array of Rule objects
 */
 declare function loadRules(capabilityPath: string, capabilityId: string): Promise<Rule[]>;
-/**
-* Write aggregated rules and docs to .omni/instructions.md
-* Updates the generated section between markers while preserving user content
-* @param rules Array of rules from all enabled capabilities
-* @param docs Array of docs from all enabled capabilities
-*/
-declare function writeRules(rules: Rule[], docs?: Doc[]): Promise<void>;
 declare function loadSkills(capabilityPath: string, capabilityId: string): Promise<Skill[]>;
 interface FetchResult {
 	id: string;
@@ -674,10 +666,27 @@ interface SourceUpdateInfo {
 	hasUpdate: boolean;
 }
 /**
+* Check if a source string is a git source
+*/
+declare function isGitSource(source: string): boolean;
+/**
+* Check if a source string is a file source
+*/
+declare function isFileSource(source: string): boolean;
+/**
+* Parse a file:// source to get the actual file path
+*/
+declare function parseFileSourcePath(source: string): string;
+/**
+* Read the capability ID from a capability directory
+* Tries to read from capability.toml first, then falls back to directory name
+*/
+declare function readCapabilityIdFromPath(capabilityPath: string): Promise<string | null>;
+/**
 * Parse a capability source string or config into normalized form
-* Returns a GitCapabilitySourceConfig
+* Returns a GitCapabilitySourceConfig or FileCapabilitySourceConfig
 */
-declare function parseSourceConfig(source: CapabilitySourceConfig): GitCapabilitySourceConfig;
+declare function parseSourceConfig(source: CapabilitySourceConfig): GitCapabilitySourceConfig | FileCapabilitySourceConfig;
 /**
 * Convert source to a git-cloneable URL
 */
@@ -721,7 +730,7 @@ interface DiscoveredContent {
 	docsDir: string | null;
 }
 /**
-* Fetch a single capability source from git
+* Fetch a single capability source (git or file)
 */
 declare function fetchCapabilitySource(id: string, sourceConfig: CapabilitySourceConfig, options?: {
 	silent?: boolean;
@@ -902,32 +911,6 @@ declare function enableCapability(capabilityId: string): Promise<void>;
 */
 declare function disableCapability(capabilityId: string): Promise<void>;
 /**
-* Load environment variables from .omni/.env file and merge with process.env.
-* Process environment variables take precedence over file values.
-*
-* @returns Merged environment variables
-*/
-declare function loadEnvironment(): Promise<Record<string, string>>;
-/**
-* Validate that all required environment variables are present.
-* Checks declarations from capability config and throws descriptive errors for missing vars.
-*
-* @param declarations - Environment variable declarations from capability.toml
-* @param env - Loaded environment variables
-* @param capabilityId - ID of the capability being validated
-* @throws Error if required environment variables are missing
-*/
-declare function validateEnv(declarations: Record<string, EnvDeclaration | Record<string, never>>, env: Record<string, string | undefined>, capabilityId: string): void;
-/**
-* Check if an environment variable should be treated as a secret.
-* Secrets should be masked in logs and error messages.
-*
-* @param key - Environment variable name
-* @param declarations - Environment variable declarations from capability.toml
-* @returns true if the variable is marked as secret
-*/
-declare function isSecretEnvVar(key: string, declarations: Record<string, EnvDeclaration | Record<string, never>>): boolean;
-/**
 * Load only the base config file (omni.toml) without merging local overrides.
 * Use this when you need to modify and write back to omni.toml.
 * @returns OmniConfig from omni.toml only
@@ -1184,19 +1167,42 @@ declare function buildSyncBundle(options?: {
 declare function syncAgentConfiguration(options?: SyncOptions): Promise<SyncResult>;
 /**
 * Template for AGENTS.md (Codex provider)
-* Creates a minimal file with reference to OmniDev instructions
+* Creates a minimal file - actual content is generated during sync from OMNI.md + instructions
 */
 declare function generateAgentsTemplate(): string;
 /**
-* Template for CLAUDE.md (Claude provider)
-* Creates a minimal file with reference to OmniDev instructions
+* Templates for bootstrapping new capabilities.
 */
-declare function generateClaudeTemplate(): string;
+interface CapabilityTemplateOptions {
+	id: string;
+	name: string;
+	description?: string;
+}
+/**
+* Generate a capability.toml file for a new capability.
+*/
+declare function generateCapabilityToml(options: CapabilityTemplateOptions): string;
+/**
+* Generate a SKILL.md template file.
+*/
+declare function generateSkillTemplate(skillName: string): string;
 /**
-* Template for .omni/instructions.md
-* Contains OmniDev-specific instructions and capability rules
+* Generate a rule markdown template file.
 */
-declare function generateInstructionsTemplate(): string;
+declare function generateRuleTemplate(ruleName: string): string;
+/**
+* Generate a hooks.toml template file.
+*/
+declare function generateHooksTemplate(): string;
+/**
+* Generate a sample hook script.
+*/
+declare function generateHookScript(): string;
+/**
+* Template for CLAUDE.md (Claude provider)
+* Creates a minimal file - actual content is generated during sync from OMNI.md + instructions
+*/
+declare function generateClaudeTemplate(): string;
 /**
 * Template for OMNI.md - the user's project instructions file.
 * This is the single source of truth that gets transformed into
@@ -1209,4 +1215,4 @@ declare function generateOmniMdTemplate(): string;
 declare function debug(message: string, data?: unknown): void;
 declare const version = "0.1.0";
 declare function getVersion(): string;
-export { writeRules, writeProviderConfig, writeMcpJson, writeEnabledProviders, writeConfig, writeActiveProfileState, version, validateHooksConfig, validateHook, validateEnv, transformToOmnidev, transformToClaude, transformHooksConfig, syncMcpJson, syncAgentConfiguration, sourceToGitUrl, setProfile, setActiveProfile, saveManifest, saveLockFile, resolveEnabledCapabilities, readMcpJson, readEnabledProviders, readActiveProfileState, patchAddToProfile, patchAddMcp, patchAddCapabilitySource, parseSourceConfig, parseProviderFlag, parseOmniConfig, parseCapabilityConfig, mergeHooksConfigs, mergeAndDeduplicateHooks, loadSubagents, loadSkills, loadRules, loadProviderConfig, loadProfileConfig, loadManifest, loadLockFile, loadHooksFromCapability, loadEnvironment, loadDocs, loadConfig, loadCommands, loadCapabilityHooks, loadCapabilityConfig, loadCapability, loadBaseConfig, isValidMatcherPattern, isSecretEnvVar, isProviderEnabled, isPromptHookEvent, isMatcherEvent, isHookType, isHookPrompt, isHookEvent, isHookCommand, installCapabilityDependencies, hasHooks, hasAnyHooks, getVersion, getSourceCapabilityPath, getLockFilePath, getHooksDirectory, getHooksConfigPath, getEventsWithHooks, getEnabledCapabilities, getActiveProviders, getActiveProfile, generateOmniMdTemplate, generateInstructionsTemplate, generateClaudeTemplate, generateAgentsTemplate, findDuplicateCommands, fetchCapabilitySource, fetchAllCapabilitySources, enableProvider, enableCapability, discoverCapabilities, disableProvider, disableCapability, debug, createEmptyValidationResult, createEmptyHooksConfig, countHooks, containsOmnidevVariables, containsClaudeVariables, clearActiveProfileState, cleanupStaleResources, checkForUpdates, buildSyncBundle, buildRouteMap, buildManifestFromCapabilities, buildCommand, buildCapabilityRegistry, ValidationSeverity, VARIABLE_MAPPINGS, SyncResult, SyncOptions, SyncConfig, SyncBundle, SubagentPermissionMode, SubagentModel, SubagentHooks, SubagentHookConfig, SubagentExport, Subagent, SourceUpdateInfo, SkillExport, Skill, SessionStartMatcher, SESSION_START_MATCHERS, Rule, ResourceManifest, ProvidersState, ProviderSyncResult, ProviderManifest, ProviderInitResult, ProviderId, ProviderContext, ProviderConfig, ProviderAdapter, Provider, PromptHookEvent, ProfileConfig, PreCompactMatcher, PROMPT_HOOK_EVENTS, PRE_COMPACT_MATCHERS, OmnidevVariable, OmniConfig, NotificationMatcher, NOTIFICATION_MATCHERS, McpTransport, McpToolSchema, McpServerStdioConfig, McpServerSseConfig, McpServerHttpConfig, McpServerConfig, McpJsonConfig, McpConfig, MatcherEvent, MATCHER_EVENTS, LoadedCapability, LoadHooksResult, LoadHooksOptions, HooksDoctorResult, HooksDoctorCheck, HooksConfig, HookValidationResult, HookValidationIssue, HookValidationCode, HookType, HookPrompt, HookMatcher, HookEvent, HookCommand, Hook, HOOK_TYPES, HOOK_EVENTS, HOOKS_DIRECTORY, HOOKS_CONFIG_FILENAME, GitCapabilitySourceConfig, FileContent, FetchResult, EnvDeclaration, DoctorCheckStatus, DocExport, Doc, DiscoveredContent, DeduplicateOptions, DEFAULT_PROMPT_TIMEOUT, DEFAULT_COMMAND_TIMEOUT, CommandExport, Command, CliConfig, CleanupResult, ClaudeVariable, CapabilitySourceType, CapabilitySourceConfig, CapabilitySource, CapabilityResources, CapabilityRegistry, CapabilityMetadata, CapabilityLockEntry, CapabilityHooks, CapabilityExports, CapabilityExport, CapabilityConfig, CapabilitiesLockFile, CapabilitiesConfig, COMMON_TOOL_MATCHERS };
+export { writeProviderConfig, writeMcpJson, writeEnabledProviders, writeConfig, writeActiveProfileState, version, validateHooksConfig, validateHook, transformToOmnidev, transformToClaude, transformHooksConfig, syncMcpJson, syncAgentConfiguration, sourceToGitUrl, setProfile, setActiveProfile, saveManifest, saveLockFile, resolveEnabledCapabilities, readMcpJson, readEnabledProviders, readCapabilityIdFromPath, readActiveProfileState, patchAddToProfile, patchAddMcp, patchAddCapabilitySource, parseSourceConfig, parseProviderFlag, parseOmniConfig, parseFileSourcePath, parseCapabilityConfig, mergeHooksConfigs, mergeAndDeduplicateHooks, loadSubagents, loadSkills, loadRules, loadProviderConfig, loadProfileConfig, loadManifest, loadLockFile, loadHooksFromCapability, loadDocs, loadConfig, loadCommands, loadCapabilityHooks, loadCapabilityConfig, loadCapability, loadBaseConfig, isValidMatcherPattern, isProviderEnabled, isPromptHookEvent, isMatcherEvent, isHookType, isHookPrompt, isHookEvent, isHookCommand, isGitSource, isFileSourceConfig, isFileSource, installCapabilityDependencies, hasHooks, hasAnyHooks, getVersion, getSourceCapabilityPath, getLockFilePath, getHooksDirectory, getHooksConfigPath, getEventsWithHooks, getEnabledCapabilities, getActiveProviders, getActiveProfile, generateSkillTemplate, generateRuleTemplate, generateOmniMdTemplate, generateHooksTemplate, generateHookScript, generateClaudeTemplate, generateCapabilityToml, generateAgentsTemplate, findDuplicateCommands, fetchCapabilitySource, fetchAllCapabilitySources, enableProvider, enableCapability, discoverCapabilities, disableProvider, disableCapability, debug, createEmptyValidationResult, createEmptyHooksConfig, countHooks, containsOmnidevVariables, containsClaudeVariables, clearActiveProfileState, cleanupStaleResources, checkForUpdates, buildSyncBundle, buildRouteMap, buildManifestFromCapabilities, buildCommand, buildCapabilityRegistry, ValidationSeverity, VARIABLE_MAPPINGS, SyncResult, SyncOptions, SyncConfig, SyncBundle, SubagentPermissionMode, SubagentModel, SubagentHooks, SubagentHookConfig, SubagentExport, Subagent, SourceUpdateInfo, SkillExport, Skill, SessionStartMatcher, SESSION_START_MATCHERS, Rule, ResourceManifest, ProvidersState, ProviderSyncResult, ProviderManifest, ProviderInitResult, ProviderId, ProviderContext, ProviderConfig, ProviderAdapter, Provider, PromptHookEvent, ProfileConfig, PreCompactMatcher, PROMPT_HOOK_EVENTS, PRE_COMPACT_MATCHERS, OmnidevVariable, OmniConfig, NotificationMatcher, NOTIFICATION_MATCHERS, McpTransport, McpToolSchema, McpServerStdioConfig, McpServerSseConfig, McpServerHttpConfig, McpServerConfig, McpJsonConfig, McpConfig, MatcherEvent, MATCHER_EVENTS, LoadedCapability, LoadHooksResult, LoadHooksOptions, HooksDoctorResult, HooksDoctorCheck, HooksConfig, HookValidationResult, HookValidationIssue, HookValidationCode, HookType, HookPrompt, HookMatcher, HookEvent, HookCommand, Hook, HOOK_TYPES, HOOK_EVENTS, HOOKS_DIRECTORY, HOOKS_CONFIG_FILENAME, GitCapabilitySourceConfig, FileContent, FileCapabilitySourceConfig, FetchResult, DoctorCheckStatus, DocExport, Doc, DiscoveredContent, DeduplicateOptions, DEFAULT_PROMPT_TIMEOUT, DEFAULT_COMMAND_TIMEOUT, CommandExport, Command, CliConfig, CleanupResult, ClaudeVariable, CapabilityTemplateOptions, CapabilitySourceType, CapabilitySourceConfig, CapabilitySource, CapabilityResources, CapabilityRegistry, CapabilityMetadata, CapabilityLockEntry, CapabilityHooks, CapabilityExports, CapabilityExport, CapabilityConfig, CapabilitiesLockFile, CapabilitiesConfig, COMMON_TOOL_MATCHERS };