@amodalai/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Amodal Labs, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/src/amodal-config.d.ts

@@ -0,0 +1,194 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { Config, type ConfigParameters, type SkillManager, type ToolRegistry, type MessageBus, type GeminiClient, type AuthType } from '@google/gemini-cli-core';
+import type { ToolContext } from './tool-context.js';
+import type { AuditLogger, AuditConfig } from './audit/index.js';
+import type { ConnectionsMap } from './templates/index.js';
+import type { ConnectionInfo } from './platform/platform-types.js';
+import type { LoadedStore } from './repo/store-types.js';
+import type { StoreBackend } from './stores/store-backend.js';
+import type { KBDocument } from './knowledge/kb-types.js';
+import { KnowledgeStore } from './knowledge/knowledge-store.js';
+import type { ModelConfig } from './repo/config-schema.js';
+/**
+ * Extension fields that AmodalConfig adds beyond upstream ConfigParameters.
+ */
+export interface AmodalConfigExtensions {
+    /** Platform API URL for knowledge base proposals */
+    platformApiUrl?: string;
+    /** Platform API key for authentication */
+    platformApiKey?: string;
+    /** Application ID for scope resolution */
+    applicationId?: string;
+    /** Tenant ID for scope resolution */
+    tenantId?: string;
+    /** Audit logging configuration */
+    auditConfig?: AuditConfig;
+    /** User identifier for audit entries */
+    auditUser?: string;
+    /** Source identifier for audit entries */
+    auditSource?: string;
+    /** Audit version string */
+    auditVersion?: string;
+    /** Backend API connection secrets */
+    connections?: ConnectionsMap;
+    /** Application-level knowledge documents */
+    appDocuments?: KBDocument[];
+    /** Tenant-level knowledge documents */
+    tenantDocuments?: KBDocument[];
+    /** Connection metadata for agent awareness */
+    connectionInfos?: ConnectionInfo[];
+    /** Agent context description */
+    agentContext?: string;
+    /** HTTP tool configs from version bundle or platform */
+    httpToolConfigs?: unknown[];
+    /** Chain tool configs from version bundle or platform */
+    chainToolConfigs?: unknown[];
+    /** Function tool configs from version bundle or platform */
+    functionToolConfigs?: unknown[];
+    /** Function tool handlers loaded from version bundle */
+    functionToolHandlers?: Record<string, unknown>;
+    /** Role definitions from version bundle */
+    roleDefinitions?: unknown[];
+    /** Active role for this session */
+    activeRole?: string;
+    /** Skills from version bundle */
+    bundleSkills?: Array<{
+        name: string;
+        description: string;
+        body: string;
+    }>;
+    /** Subagent configs from version bundle */
+    bundleSubagents?: unknown[];
+    /** Automation definitions from version bundle */
+    automationDefinitions?: unknown[];
+    /** Built-in tools to disable */
+    disabledBuiltInTools?: string[];
+    /** Version bundle version string (from platform config) */
+    versionBundleVersion?: string;
+    /** Version bundle source URL */
+    versionBundleUrl?: string;
+    /** Version bundle local file path */
+    versionBundlePath?: string;
+    /** Enable experimental Zed editor integration (ACP mode) */
+    experimentalZedIntegration?: boolean;
+    /** Enable prompt completion feature */
+    enablePromptCompletion?: boolean;
+    /** Model configuration (provider, model, credentials, fallback) for content generator */
+    modelConfig?: ModelConfig;
+    /** Subagent names to disable (e.g., ['explore', 'plan']) */
+    disabledSubagents?: string[];
+    /** Store definitions from the deployment snapshot */
+    stores?: unknown[];
+    /** Store backend for persisting store documents */
+    storeBackend?: StoreBackend;
+    /** Custom base system prompt (overrides the platform default) */
+    basePrompt?: string;
+    /** Agent display name */
+    agentName?: string;
+    /** Agent description */
+    agentDescription?: string;
+}
+/**
+ * Parameters accepted by AmodalConfig constructor.
+ * Upstream ConfigParameters + our extension fields.
+ */
+export type AmodalConfigParameters = Partial<ConfigParameters> & AmodalConfigExtensions;
+/**
+ * Composition wrapper around upstream Config.
+ *
+ * Holds an upstream Config instance for the ReAct loop, tool registry, and
+ * model configuration. Adds our extension state (platform, knowledge,
+ * connections, audit) and implements ToolContext so our tools can access
+ * extension fields without coupling to Config internals.
+ *
+ * After initialize(), registers amodal-specific tools (propose_knowledge,
+ * load_knowledge, present, request, custom HTTP/chain/function tools) on
+ * the upstream ToolRegistry.
+ */
+export declare class AmodalConfig implements ToolContext {
+    private readonly config;
+    private readonly extensions;
+    private readonly knowledgeStore;
+    private auditLogger;
+    constructor(params: AmodalConfigParameters);
+    /**
+     * Initialize the upstream Config, then register amodal tools on its registry.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Register amodal-specific tools and skills on the upstream registry.
+     * Called after the upstream Config is already initialized.
+     */
+    registerTools(): Promise<void>;
+    getSessionId(): string;
+    getPlatformApiUrl(): string | undefined;
+    getPlatformApiKey(): string | undefined;
+    getApplicationId(): string | undefined;
+    getTenantId(): string | undefined;
+    getAuditLogger(): AuditLogger | undefined;
+    getConnections(): ConnectionsMap;
+    getKnowledgeStore(): KnowledgeStore;
+    getConnectionInfos(): ConnectionInfo[];
+    getAgentContext(): string | undefined;
+    getBasePrompt(): string | undefined;
+    getAgentName(): string | undefined;
+    getBundleSubagents(): unknown[];
+    getDisabledSubagents(): string[];
+    getStores(): LoadedStore[];
+    getStoreBackend(): StoreBackend | undefined;
+    getSessionEnv(): Record<string, string>;
+    setStoreBackend(backend: StoreBackend): void;
+    getAgentDescription(): string | undefined;
+    getRoleDefinitions(): unknown[];
+    getActiveRoleName(): string | undefined;
+    getVersionBundleVersion(): string | undefined;
+    getVersionBundleUrl(): string | undefined;
+    getVersionBundlePath(): string | undefined;
+    getExperimentalZedIntegration(): boolean;
+    getEnablePromptCompletion(): boolean;
+    /** Access the upstream Config instance directly. */
+    getUpstreamConfig(): Config;
+    getToolRegistry(): ToolRegistry;
+    getMessageBus(): MessageBus;
+    getSkillManager(): SkillManager;
+    getGeminiClient(): GeminiClient;
+    getModel(): string;
+    getModelConfig(): ModelConfig | undefined;
+    setModelConfig(mc: ModelConfig): void;
+    refreshAuth(authType: AuthType, apiKey?: string, baseUrl?: string, customHeaders?: Record<string, string>): Promise<void>;
+    /**
+     * Initialize the upstream content generator.
+     *
+     * When a non-Google provider is configured (via modelConfig), creates a
+     * MultiProviderContentGenerator that routes calls through our existing
+     * RuntimeProvider system (Anthropic, OpenAI, Bedrock, Azure, etc.).
+     *
+     * For Google providers (or when no modelConfig is set), falls back to
+     * the upstream Gemini content generator.
+     */
+    initializeAuth(): Promise<void>;
+    /**
+     * Allowlist environment variable names on the upstream Config so the
+     * sanitization pipeline doesn't strip them.
+     */
+    addAllowedEnvironmentVariables(names: string[]): void;
+    /**
+     * Alias for shutdown — used by session manager to flush audit on destroy.
+     */
+    shutdownAudit(): Promise<void>;
+    /**
+     * Shutdown: flush audit logs and dispose upstream Config.
+     * Disposing the upstream Config removes coreEvents listeners, stops MCP
+     * servers, and frees GeminiClient/AgentRegistry resources — critical for
+     * preventing listener leaks in multi-session server runtimes.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Register bundle skills on the upstream SkillManager.
+     */
+    private registerBundleSkills;
+}

package/dist/src/amodal-config.js

@@ -0,0 +1,326 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { Config, getAuthTypeFromEnv, } from '@google/gemini-cli-core';
+import { AuditLogger as AuditLoggerImpl } from './audit/audit-logger.js';
+import { KnowledgeStore } from './knowledge/knowledge-store.js';
+import { registerAmodalTools } from './tool-registration.js';
+import { MultiProviderContentGenerator } from './providers/content-generator/index.js';
+// Keys that are AmodalConfigExtensions-only (not in upstream ConfigParameters)
+const EXTENSION_KEYS = [
+    'platformApiUrl',
+    'platformApiKey',
+    'applicationId',
+    'tenantId',
+    'auditConfig',
+    'auditUser',
+    'auditSource',
+    'auditVersion',
+    'connections',
+    'appDocuments',
+    'tenantDocuments',
+    'connectionInfos',
+    'agentContext',
+    'httpToolConfigs',
+    'chainToolConfigs',
+    'functionToolConfigs',
+    'functionToolHandlers',
+    'roleDefinitions',
+    'activeRole',
+    'bundleSkills',
+    'bundleSubagents',
+    'automationDefinitions',
+    'disabledBuiltInTools',
+    'versionBundleVersion',
+    'versionBundleUrl',
+    'versionBundlePath',
+    'experimentalZedIntegration',
+    'enablePromptCompletion',
+    'modelConfig',
+    'disabledSubagents',
+    'stores',
+    'storeBackend',
+    'basePrompt',
+    'agentName',
+    'agentDescription',
+];
+/**
+ * Composition wrapper around upstream Config.
+ *
+ * Holds an upstream Config instance for the ReAct loop, tool registry, and
+ * model configuration. Adds our extension state (platform, knowledge,
+ * connections, audit) and implements ToolContext so our tools can access
+ * extension fields without coupling to Config internals.
+ *
+ * After initialize(), registers amodal-specific tools (propose_knowledge,
+ * load_knowledge, present, request, custom HTTP/chain/function tools) on
+ * the upstream ToolRegistry.
+ */
+export class AmodalConfig {
+    config;
+    extensions;
+    knowledgeStore;
+    auditLogger;
+    constructor(params) {
+        // Separate extension fields from upstream ConfigParameters
+        const extensions = {};
+        const upstreamParams = {};
+        const extensionKeySet = new Set(EXTENSION_KEYS);
+        for (const [key, value] of Object.entries(params)) {
+            if (extensionKeySet.has(key)) {
+                extensions[key] = value;
+            }
+            else {
+                upstreamParams[key] = value;
+            }
+        }
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- splitting merged params
+        this.extensions = extensions;
+        // Disable upstream Gemini CLI builtin skills not relevant to the Amodal runtime
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- upstream params are untyped Record
+        const existingDisabled = upstreamParams['disabledSkills'] ?? [];
+        upstreamParams['disabledSkills'] = [...existingDisabled, 'skill-creator'];
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- passing upstream params
+        this.config = new Config(upstreamParams);
+        // Initialize knowledge store from KB docs
+        this.knowledgeStore = new KnowledgeStore(this.extensions.appDocuments ?? [], this.extensions.tenantDocuments ?? []);
+        // Initialize audit logger if configured
+        if (this.extensions.auditConfig) {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- audit config shape
+            const auditConfig = this.extensions.auditConfig;
+            const context = {
+                sessionId: params.sessionId ?? 'unknown',
+                user: this.extensions.auditUser ?? 'unknown',
+                source: this.extensions.auditSource ?? 'interactive',
+                version: this.extensions.auditVersion ?? 'local',
+                role: this.extensions.activeRole ?? 'default',
+            };
+            this.auditLogger = new AuditLoggerImpl(auditConfig, context);
+        }
+    }
+    /**
+     * Initialize the upstream Config, then register amodal tools on its registry.
+     */
+    async initialize() {
+        await this.config.initialize();
+        await this.registerTools();
+    }
+    /**
+     * Register amodal-specific tools and skills on the upstream registry.
+     * Called after the upstream Config is already initialized.
+     */
+    async registerTools() {
+        await registerAmodalTools(this, this.config);
+        await this.registerBundleSkills();
+    }
+    // ---------------------------------------------------------------------------
+    // ToolContext implementation
+    // ---------------------------------------------------------------------------
+    getSessionId() {
+        return this.config.getSessionId();
+    }
+    getPlatformApiUrl() {
+        return this.extensions.platformApiUrl;
+    }
+    getPlatformApiKey() {
+        return this.extensions.platformApiKey;
+    }
+    getApplicationId() {
+        return this.extensions.applicationId;
+    }
+    getTenantId() {
+        return this.extensions.tenantId;
+    }
+    getAuditLogger() {
+        return this.auditLogger;
+    }
+    getConnections() {
+        return this.extensions.connections ?? {};
+    }
+    getKnowledgeStore() {
+        return this.knowledgeStore;
+    }
+    getConnectionInfos() {
+        return this.extensions.connectionInfos ?? [];
+    }
+    getAgentContext() {
+        return this.extensions.agentContext;
+    }
+    getBasePrompt() {
+        return this.extensions.basePrompt;
+    }
+    getAgentName() {
+        return this.extensions.agentName;
+    }
+    getBundleSubagents() {
+        return this.extensions.bundleSubagents ?? [];
+    }
+    getDisabledSubagents() {
+        return this.extensions.disabledSubagents ?? [];
+    }
+    getStores() {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- stores from snapshot are validated at load time
+        return (this.extensions.stores ?? []);
+    }
+    getStoreBackend() {
+        return this.extensions.storeBackend;
+    }
+    getSessionEnv() {
+        const secrets = this.extensions.connections?.['_secrets'];
+        if (secrets && typeof secrets === 'object') {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- _secrets is stored as Record<string, string> by AgentSDK
+            return secrets;
+        }
+        return {};
+    }
+    setStoreBackend(backend) {
+        this.extensions.storeBackend = backend;
+    }
+    getAgentDescription() {
+        return this.extensions.agentDescription;
+    }
+    getRoleDefinitions() {
+        return this.extensions.roleDefinitions ?? [];
+    }
+    getActiveRoleName() {
+        return this.extensions.activeRole;
+    }
+    getVersionBundleVersion() {
+        return this.extensions.versionBundleVersion;
+    }
+    getVersionBundleUrl() {
+        return this.extensions.versionBundleUrl;
+    }
+    getVersionBundlePath() {
+        return this.extensions.versionBundlePath;
+    }
+    getExperimentalZedIntegration() {
+        return this.extensions.experimentalZedIntegration ?? false;
+    }
+    getEnablePromptCompletion() {
+        return this.extensions.enablePromptCompletion ?? false;
+    }
+    // ---------------------------------------------------------------------------
+    // Upstream delegation
+    // ---------------------------------------------------------------------------
+    /** Access the upstream Config instance directly. */
+    getUpstreamConfig() {
+        return this.config;
+    }
+    getToolRegistry() {
+        return this.config.getToolRegistry();
+    }
+    getMessageBus() {
+        return this.config.getMessageBus();
+    }
+    getSkillManager() {
+        return this.config.getSkillManager();
+    }
+    getGeminiClient() {
+        return this.config.getGeminiClient();
+    }
+    getModel() {
+        return this.config.getModel();
+    }
+    getModelConfig() {
+        return this.extensions.modelConfig;
+    }
+    setModelConfig(mc) {
+        this.extensions.modelConfig = mc;
+    }
+    async refreshAuth(authType, apiKey, baseUrl, customHeaders) {
+        return this.config.refreshAuth(authType, apiKey, baseUrl, customHeaders);
+    }
+    /**
+     * Initialize the upstream content generator.
+     *
+     * When a non-Google provider is configured (via modelConfig), creates a
+     * MultiProviderContentGenerator that routes calls through our existing
+     * RuntimeProvider system (Anthropic, OpenAI, Bedrock, Azure, etc.).
+     *
+     * For Google providers (or when no modelConfig is set), falls back to
+     * the upstream Gemini content generator.
+     */
+    async initializeAuth() {
+        const modelConfig = this.extensions.modelConfig;
+        if (modelConfig && modelConfig.provider !== 'google') {
+            // Create our multi-provider content generator
+            const generator = new MultiProviderContentGenerator(modelConfig);
+            // Try to initialize upstream state (model router, etc.) via refreshAuth.
+            // This may fail without valid Gemini credentials — that's OK since
+            // we're replacing the content generator anyway.
+            const authType = getAuthTypeFromEnv();
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+                await this.config.refreshAuth(authType ?? 'gemini-api-key');
+            }
+            catch {
+                // Expected when no Gemini credentials are available
+            }
+            // Replace the content generator on the upstream Config (private field).
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+            const raw = this.config;
+            raw['contentGenerator'] = generator;
+            return;
+        }
+        // Default: use upstream Gemini content generator
+        const authType = getAuthTypeFromEnv();
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+        await this.config.refreshAuth(authType ?? 'gemini-api-key');
+    }
+    /**
+     * Allowlist environment variable names on the upstream Config so the
+     * sanitization pipeline doesn't strip them.
+     */
+    addAllowedEnvironmentVariables(names) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- accessing private field for runtime env var allowlisting
+        const raw = this.config;
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- accessing private field
+        const existing = raw['allowedEnvironmentVariables'];
+        raw['allowedEnvironmentVariables'] = [...(existing ?? []), ...names];
+    }
+    /**
+     * Alias for shutdown — used by session manager to flush audit on destroy.
+     */
+    async shutdownAudit() {
+        return this.shutdown();
+    }
+    /**
+     * Shutdown: flush audit logs and dispose upstream Config.
+     * Disposing the upstream Config removes coreEvents listeners, stops MCP
+     * servers, and frees GeminiClient/AgentRegistry resources — critical for
+     * preventing listener leaks in multi-session server runtimes.
+     */
+    async shutdown() {
+        if (this.auditLogger) {
+            await this.auditLogger.flush();
+        }
+        try {
+            await this.config.dispose();
+        }
+        catch {
+            // Best-effort — upstream may already be partially torn down
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Register bundle skills on the upstream SkillManager.
+     */
+    async registerBundleSkills() {
+        const skills = this.extensions.bundleSkills;
+        if (!skills || skills.length === 0)
+            return;
+        const skillManager = this.config.getSkillManager();
+        skillManager.addSkills(skills.map((skill) => ({
+            name: skill.name,
+            description: skill.description,
+            body: skill.body,
+            location: 'bundle', // virtual location for bundle-sourced skills
+        })));
+    }
+}
+//# sourceMappingURL=amodal-config.js.map

package/dist/src/amodal-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"amodal-config.js","sourceRoot":"","sources":["../../src/amodal-config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,MAAM,EAON,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,WAAW,IAAI,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAMzE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,EAAE,6BAA6B,EAAE,MAAM,wCAAwC,CAAC;AAoFvF,+EAA+E;AAC/E,MAAM,cAAc,GAAgD;IAClE,gBAAgB;IAChB,gBAAgB;IAChB,eAAe;IACf,UAAU;IACV,aAAa;IACb,WAAW;IACX,aAAa;IACb,cAAc;IACd,aAAa;IACb,cAAc;IACd,iBAAiB;IACjB,iBAAiB;IACjB,cAAc;IACd,iBAAiB;IACjB,kBAAkB;IAClB,qBAAqB;IACrB,sBAAsB;IACtB,iBAAiB;IACjB,YAAY;IACZ,cAAc;IACd,iBAAiB;IACjB,uBAAuB;IACvB,sBAAsB;IACtB,sBAAsB;IACtB,kBAAkB;IAClB,mBAAmB;IACnB,4BAA4B;IAC5B,wBAAwB;IACxB,aAAa;IACb,mBAAmB;IACnB,QAAQ;IACR,cAAc;IACd,YAAY;IACZ,WAAW;IACX,kBAAkB;CACnB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,YAAY;IACN,MAAM,CAAS;IACf,UAAU,CAAyB;IACnC,cAAc,CAAiB;IACxC,WAAW,CAA0B;IAE7C,YAAY,MAA8B;QACxC,2DAA2D;QAC3D,MAAM,UAAU,GAA4B,EAAE,CAAC;QAC/C,MAAM,cAAc,GAA4B,EAAE,CAAC;QAEnD,MAAM,eAAe,GAAG,IAAI,GAAG,CAAS,cAAc,CAAC,CAAC;QAExD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7B,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YAC1B,CAAC;iBAAM,CAAC;gBACN,cAAc,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,kGAAkG;QAClG,IAAI,CAAC,UAAU,GAAG,UAA+C,CAAC;QAElE,gFAAgF;QAChF,6GAA6G;QAC7G,MAAM,gBAAgB,GAAI,cAAc,CAAC,gBAAgB,CAA0B,IAAI,EAAE,CAAC;QAC1F,cAAc,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,gBAAgB,EAAE,eAAe,CAAC,CAAC;QAE1E,kGAAkG;QAClG,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,cAA6C,CAAC,CAAC;QAExE,0CAA0C;QAC1C,IAAI,CAAC,cAAc,GAAG,IAAI,cAAc,CACtC,IAAI,CAAC,UAAU,CAAC,YAAY,IAAI,EAAE,EAClC,IAAI,CAAC,UAAU,CAAC,eAAe,IAAI,EAAE,CACtC,CAAC;QAEF,wCAAwC;QACxC,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;YAChC,6FAA6F;YAC7F,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,WAAsE,CAAC;YAC3G,MAAM,OAAO,GAAiB;gBAC5B,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,SAAS;gBACxC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,SAAS,IAAI,SAAS;gBAC5C,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,WAAW,IAAI,aAAa;gBACpD,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,YAAY,IAAI,OAAO;gBAChD,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,UAAU,IAAI,SAAS;aAC9C,CAAC;YACF,IAAI,CAAC,WAAW,GAAG,IAAI,eAAe,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QAC/B,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,aAAa;QACjB,MAAM,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;IACpC,CAAC;IAED,8EAA8E;IAC9E,6BAA6B;IAC7B,8EAA8E;IAE9E,YAAY;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;IACpC,CAAC;IAED,iBAAiB;QACf,OAAO,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;IACxC,CAAC;IAED,iBAAiB;QACf,OAAO,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;IACxC,CAAC;IAED,gBAAgB;QACd,OAAO,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;IACvC,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;IAClC,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,IAAI,EAAE,CAAC;IAC3C,CAAC;IAED,iBAAiB;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,kBAAkB;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC,eAAe,IAAI,EAAE,CAAC;IAC/C,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;IACtC,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;IACpC,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;IACnC,CAAC;IAED,kBAAkB;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC,eAAe,IAAI,EAAE,CAAC;IAC/C,CAAC;IAED,oBAAoB;QAClB,OAAO,IAAI,CAAC,UAAU,CAAC,iBAAiB,IAAI,EAAE,CAAC;IACjD,CAAC;IAED,SAAS;QACP,0HAA0H;QAC1H,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,EAAE,CAAkB,CAAC;IACzD,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;IACtC,CAAC;IAED,aAAa;QACX,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,CAAC;QAC1D,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC3C,mIAAmI;YACnI,OAAO,OAA4C,CAAC;QACtD,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,eAAe,CAAC,OAAqB;QACnC,IAAI,CAAC,UAAU,CAAC,YAAY,GAAG,OAAO,CAAC;IACzC,CAAC;IAED,mBAAmB;QACjB,OAAO,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC;IAC1C,CAAC;IAED,kBAAkB;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC,eAAe,IAAI,EAAE,CAAC;IAC/C,CAAC;IAED,iBAAiB;QACf,OAAO,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;IACpC,CAAC;IAED,uBAAuB;QACrB,OAAO,IAAI,CAAC,UAAU,CAAC,oBAAoB,CAAC;IAC9C,CAAC;IAED,mBAAmB;QACjB,OAAO,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC;IAC1C,CAAC;IAED,oBAAoB;QAClB,OAAO,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC;IAC3C,CAAC;IAED,6BAA6B;QAC3B,OAAO,IAAI,CAAC,UAAU,CAAC,0BAA0B,IAAI,KAAK,CAAC;IAC7D,CAAC;IAED,yBAAyB;QACvB,OAAO,IAAI,CAAC,UAAU,CAAC,sBAAsB,IAAI,KAAK,CAAC;IACzD,CAAC;IAED,8EAA8E;IAC9E,sBAAsB;IACtB,8EAA8E;IAE9E,oDAAoD;IACpD,iBAAiB;QACf,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;IACvC,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;IACrC,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;IACvC,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;IACvC,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;IACrC,CAAC;IAED,cAAc,CAAC,EAAe;QAC5B,IAAI,CAAC,UAAU,CAAC,WAAW,GAAG,EAAE,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,QAAkB,EAAE,MAAe,EAAE,OAAgB,EAAE,aAAsC;QAC7G,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;IAC3E,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,cAAc;QAClB,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QAEhD,IAAI,WAAW,IAAI,WAAW,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACrD,8CAA8C;YAC9C,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC,WAAW,CAAC,CAAC;YAEjE,yEAAyE;YACzE,mEAAmE;YACnE,gDAAgD;YAChD,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAC;YACtC,IAAI,CAAC;gBACH,uEAAuE;gBACvE,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,QAAQ,IAAK,gBAA6B,CAAC,CAAC;YAC5E,CAAC;YAAC,MAAM,CAAC;gBACP,oDAAoD;YACtD,CAAC;YAED,wEAAwE;YACxE,uEAAuE;YACvE,MAAM,GAAG,GAAG,IAAI,CAAC,MAA4C,CAAC;YAC9D,GAAG,CAAC,kBAAkB,CAAC,GAAG,SAAS,CAAC;YACpC,OAAO;QACT,CAAC;QAED,iDAAiD;QACjD,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAC;QACtC,uEAAuE;QACvE,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,QAAQ,IAAK,gBAA6B,CAAC,CAAC;IAC5E,CAAC;IAED;;;OAGG;IACH,8BAA8B,CAAC,KAAe;QAC5C,mIAAmI;QACnI,MAAM,GAAG,GAAG,IAAI,CAAC,MAA4C,CAAC;QAC9D,kGAAkG;QAClG,MAAM,QAAQ,GAAG,GAAG,CAAC,6BAA6B,CAAyB,CAAC;QAC5E,GAAG,CAAC,6BAA6B,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC;IACvE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa;QACjB,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ;QACZ,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QACjC,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,4DAA4D;QAC9D,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,kBAAkB;IAClB,8EAA8E;IAE9E;;OAEG;IACK,KAAK,CAAC,oBAAoB;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;QAC5C,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAE3C,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;QACnD,YAAY,CAAC,SAAS,CACpB,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACrB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,QAAQ,EAAE,6CAA6C;SAClE,CAAC,CAAC,CACJ,CAAC;IACJ,CAAC;CACF"}

package/dist/src/audit/audit-logger.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { type Kind } from '@google/gemini-cli-core';
+import type { AuditConfig, AuditContext } from './audit-types.js';
+/**
+ * Structured audit logger. Emits entries to configured outputs.
+ *
+ * Audit must never throw or crash the process — all errors are swallowed.
+ */
+export declare class AuditLogger {
+    private readonly outputs;
+    private readonly config;
+    private readonly context;
+    constructor(config: AuditConfig, context: AuditContext);
+    /**
+     * Log a tool call event.
+     */
+    logToolCall(name: string, params?: Record<string, unknown>, durationMs?: number): void;
+    /**
+     * Log a write operation event (mutations: edit, delete, move, execute).
+     */
+    logWriteOp(name: string, params?: Record<string, unknown>, durationMs?: number): void;
+    /**
+     * Log session start.
+     */
+    logSessionStart(): void;
+    /**
+     * Log session end.
+     */
+    logSessionEnd(): void;
+    /**
+     * Log a version bundle load.
+     */
+    logVersionLoad(version: string): void;
+    /**
+     * Log a knowledge base proposal event.
+     */
+    logKbProposal(scope: string, title: string, proposalId?: string): void;
+    /**
+     * Flush all outputs that support it.
+     */
+    flush(): Promise<void>;
+    /**
+     * Check whether a tool kind represents a write/mutation operation.
+     */
+    static isWriteOperation(kind: Kind): boolean;
+    private emit;
+    private createOutputs;
+}