@anthropic-field/core 0.1.0

package/dist/src/code_assist/types.d.ts

@@ -0,0 +1,306 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from 'zod';
+export interface ClientMetadata {
+    ideType?: ClientMetadataIdeType;
+    ideVersion?: string;
+    pluginVersion?: string;
+    platform?: ClientMetadataPlatform;
+    updateChannel?: string;
+    duetProject?: string;
+    pluginType?: ClientMetadataPluginType;
+    ideName?: string;
+}
+export type ClientMetadataIdeType = 'IDE_UNSPECIFIED' | 'VSCODE' | 'INTELLIJ' | 'VSCODE_CLOUD_WORKSTATION' | 'INTELLIJ_CLOUD_WORKSTATION' | 'CLOUD_SHELL' | 'GEMINI_CLI';
+export type ClientMetadataPlatform = 'PLATFORM_UNSPECIFIED' | 'DARWIN_AMD64' | 'DARWIN_ARM64' | 'LINUX_AMD64' | 'LINUX_ARM64' | 'WINDOWS_AMD64';
+export type ClientMetadataPluginType = 'PLUGIN_UNSPECIFIED' | 'CLOUD_CODE' | 'GEMINI' | 'AIPLUGIN_INTELLIJ' | 'AIPLUGIN_STUDIO';
+export interface LoadCodeAssistRequest {
+    cloudaicompanionProject?: string;
+    metadata: ClientMetadata;
+}
+/**
+ * Represents LoadCodeAssistResponse proto json field
+ * http://google3/google/internal/cloud/code/v1internal/cloudcode.proto;l=224
+ */
+export interface LoadCodeAssistResponse {
+    currentTier?: GeminiUserTier | null;
+    allowedTiers?: GeminiUserTier[] | null;
+    ineligibleTiers?: IneligibleTier[] | null;
+    cloudaicompanionProject?: string | null;
+}
+/**
+ * GeminiUserTier reflects the structure received from the CodeAssist when calling LoadCodeAssist.
+ */
+export interface GeminiUserTier {
+    id: UserTierId;
+    name?: string;
+    description?: string;
+    userDefinedCloudaicompanionProject?: boolean | null;
+    isDefault?: boolean;
+    privacyNotice?: PrivacyNotice;
+    hasAcceptedTos?: boolean;
+    hasOnboardedPreviously?: boolean;
+}
+/**
+ * Includes information specifying the reasons for a user's ineligibility for a specific tier.
+ * @param reasonCode mnemonic code representing the reason for in-eligibility.
+ * @param reasonMessage message to display to the user.
+ * @param tierId id of the tier.
+ * @param tierName name of the tier.
+ */
+export interface IneligibleTier {
+    reasonCode: IneligibleTierReasonCode;
+    reasonMessage: string;
+    tierId: UserTierId;
+    tierName: string;
+    validationErrorMessage?: string;
+    validationUrl?: string;
+    validationUrlLinkText?: string;
+    validationLearnMoreUrl?: string;
+    validationLearnMoreLinkText?: string;
+}
+/**
+ * List of predefined reason codes when a tier is blocked from a specific tier.
+ * https://source.corp.google.com/piper///depot/google3/google/internal/cloud/code/v1internal/cloudcode.proto;l=378
+ */
+export declare enum IneligibleTierReasonCode {
+    DASHER_USER = "DASHER_USER",
+    INELIGIBLE_ACCOUNT = "INELIGIBLE_ACCOUNT",
+    NON_USER_ACCOUNT = "NON_USER_ACCOUNT",
+    RESTRICTED_AGE = "RESTRICTED_AGE",
+    RESTRICTED_NETWORK = "RESTRICTED_NETWORK",
+    UNKNOWN = "UNKNOWN",
+    UNKNOWN_LOCATION = "UNKNOWN_LOCATION",
+    UNSUPPORTED_LOCATION = "UNSUPPORTED_LOCATION",
+    VALIDATION_REQUIRED = "VALIDATION_REQUIRED"
+}
+/**
+ * UserTierId represents IDs returned from the Cloud Code Private API representing a user's tier
+ *
+ * //depot/google3/cloud/developer_experience/cloudcode/pa/service/usertier.go;l=16
+ */
+export declare enum UserTierId {
+    FREE = "free-tier",
+    LEGACY = "legacy-tier",
+    STANDARD = "standard-tier"
+}
+/**
+ * PrivacyNotice reflects the structure received from the CodeAssist in regards to a tier
+ * privacy notice.
+ */
+export interface PrivacyNotice {
+    showNotice: boolean;
+    noticeText?: string;
+}
+/**
+ * Proto signature of OnboardUserRequest as payload to OnboardUser call
+ */
+export interface OnboardUserRequest {
+    tierId: string | undefined;
+    cloudaicompanionProject: string | undefined;
+    metadata: ClientMetadata | undefined;
+}
+/**
+ * Represents LongRunningOperation proto
+ * http://google3/google/longrunning/operations.proto;rcl=698857719;l=107
+ */
+export interface LongRunningOperationResponse {
+    name: string;
+    done?: boolean;
+    response?: OnboardUserResponse;
+}
+/**
+ * Represents OnboardUserResponse proto
+ * http://google3/google/internal/cloud/code/v1internal/cloudcode.proto;l=215
+ */
+export interface OnboardUserResponse {
+    cloudaicompanionProject?: {
+        id: string;
+        name: string;
+    };
+}
+/**
+ * Status code of user license status
+ * it does not strictly correspond to the proto
+ * Error value is an additional value assigned to error responses from OnboardUser
+ */
+export declare enum OnboardUserStatusCode {
+    Default = "DEFAULT",
+    Notice = "NOTICE",
+    Warning = "WARNING",
+    Error = "ERROR"
+}
+/**
+ * Status of user onboarded to gemini
+ */
+export interface OnboardUserStatus {
+    statusCode: OnboardUserStatusCode;
+    displayMessage: string;
+    helpLink: HelpLinkUrl | undefined;
+}
+export interface HelpLinkUrl {
+    description: string;
+    url: string;
+}
+export interface SetCodeAssistGlobalUserSettingRequest {
+    cloudaicompanionProject?: string;
+    freeTierDataCollectionOptin?: boolean;
+}
+export interface CodeAssistGlobalUserSettingResponse {
+    cloudaicompanionProject?: string;
+    freeTierDataCollectionOptin: boolean;
+}
+/**
+ * Relevant fields that can be returned from a Google RPC response
+ */
+export interface GoogleRpcResponse {
+    error?: {
+        details?: GoogleRpcErrorInfo[];
+    };
+}
+/**
+ * Relevant fields that can be returned in the details of an error returned from GoogleRPCs
+ */
+interface GoogleRpcErrorInfo {
+    reason?: string;
+}
+export interface RetrieveUserQuotaRequest {
+    project: string;
+    userAgent?: string;
+}
+export interface BucketInfo {
+    remainingAmount?: string;
+    remainingFraction?: number;
+    resetTime?: string;
+    tokenType?: string;
+    modelId?: string;
+}
+export interface RetrieveUserQuotaResponse {
+    buckets?: BucketInfo[];
+}
+export interface RecordCodeAssistMetricsRequest {
+    project: string;
+    requestId?: string;
+    metadata?: ClientMetadata;
+    metrics?: CodeAssistMetric[];
+}
+export interface CodeAssistMetric {
+    timestamp?: string;
+    metricMetadata?: Map<string, string>;
+    conversationOffered?: ConversationOffered;
+    conversationInteraction?: ConversationInteraction;
+}
+export declare enum ConversationInteractionInteraction {
+    UNKNOWN = 0,
+    THUMBSUP = 1,
+    THUMBSDOWN = 2,
+    COPY = 3,
+    INSERT = 4,
+    ACCEPT_CODE_BLOCK = 5,
+    ACCEPT_ALL = 6,
+    ACCEPT_FILE = 7,
+    DIFF = 8,
+    ACCEPT_RANGE = 9
+}
+export declare enum ActionStatus {
+    ACTION_STATUS_UNSPECIFIED = 0,
+    ACTION_STATUS_NO_ERROR = 1,
+    ACTION_STATUS_ERROR_UNKNOWN = 2,
+    ACTION_STATUS_CANCELLED = 3,
+    ACTION_STATUS_EMPTY = 4
+}
+export declare enum InitiationMethod {
+    INITIATION_METHOD_UNSPECIFIED = 0,
+    TAB = 1,
+    COMMAND = 2,
+    AGENT = 3
+}
+export interface ConversationOffered {
+    citationCount?: string;
+    includedCode?: boolean;
+    status?: ActionStatus;
+    traceId?: string;
+    streamingLatency?: StreamingLatency;
+    isAgentic?: boolean;
+    initiationMethod?: InitiationMethod;
+}
+export interface StreamingLatency {
+    firstMessageLatency?: string;
+    totalLatency?: string;
+}
+export interface ConversationInteraction {
+    traceId: string;
+    status?: ActionStatus;
+    interaction?: ConversationInteractionInteraction;
+    acceptedLines?: string;
+    language?: string;
+    isAgentic?: boolean;
+}
+export interface FetchAdminControlsRequest {
+    project: string;
+}
+export type FetchAdminControlsResponse = z.infer<typeof FetchAdminControlsResponseSchema>;
+export declare const FetchAdminControlsResponseSchema: z.ZodObject<{
+    secureModeEnabled: z.ZodOptional<z.ZodBoolean>;
+    strictModeDisabled: z.ZodOptional<z.ZodBoolean>;
+    mcpSetting: z.ZodOptional<z.ZodObject<{
+        mcpEnabled: z.ZodOptional<z.ZodBoolean>;
+        overrideMcpConfigJson: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        mcpEnabled?: boolean | undefined;
+        overrideMcpConfigJson?: string | undefined;
+    }, {
+        mcpEnabled?: boolean | undefined;
+        overrideMcpConfigJson?: string | undefined;
+    }>>;
+    cliFeatureSetting: z.ZodOptional<z.ZodObject<{
+        extensionsSetting: z.ZodOptional<z.ZodObject<{
+            extensionsEnabled: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            extensionsEnabled?: boolean | undefined;
+        }, {
+            extensionsEnabled?: boolean | undefined;
+        }>>;
+        unmanagedCapabilitiesEnabled: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        extensionsSetting?: {
+            extensionsEnabled?: boolean | undefined;
+        } | undefined;
+        unmanagedCapabilitiesEnabled?: boolean | undefined;
+    }, {
+        extensionsSetting?: {
+            extensionsEnabled?: boolean | undefined;
+        } | undefined;
+        unmanagedCapabilitiesEnabled?: boolean | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    secureModeEnabled?: boolean | undefined;
+    strictModeDisabled?: boolean | undefined;
+    mcpSetting?: {
+        mcpEnabled?: boolean | undefined;
+        overrideMcpConfigJson?: string | undefined;
+    } | undefined;
+    cliFeatureSetting?: {
+        extensionsSetting?: {
+            extensionsEnabled?: boolean | undefined;
+        } | undefined;
+        unmanagedCapabilitiesEnabled?: boolean | undefined;
+    } | undefined;
+}, {
+    secureModeEnabled?: boolean | undefined;
+    strictModeDisabled?: boolean | undefined;
+    mcpSetting?: {
+        mcpEnabled?: boolean | undefined;
+        overrideMcpConfigJson?: string | undefined;
+    } | undefined;
+    cliFeatureSetting?: {
+        extensionsSetting?: {
+            extensionsEnabled?: boolean | undefined;
+        } | undefined;
+        unmanagedCapabilitiesEnabled?: boolean | undefined;
+    } | undefined;
+}>;
+export {};

package/dist/src/code_assist/types.js

@@ -0,0 +1,94 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from 'zod';
+/**
+ * List of predefined reason codes when a tier is blocked from a specific tier.
+ * https://source.corp.google.com/piper///depot/google3/google/internal/cloud/code/v1internal/cloudcode.proto;l=378
+ */
+export var IneligibleTierReasonCode;
+(function (IneligibleTierReasonCode) {
+    // go/keep-sorted start
+    IneligibleTierReasonCode["DASHER_USER"] = "DASHER_USER";
+    IneligibleTierReasonCode["INELIGIBLE_ACCOUNT"] = "INELIGIBLE_ACCOUNT";
+    IneligibleTierReasonCode["NON_USER_ACCOUNT"] = "NON_USER_ACCOUNT";
+    IneligibleTierReasonCode["RESTRICTED_AGE"] = "RESTRICTED_AGE";
+    IneligibleTierReasonCode["RESTRICTED_NETWORK"] = "RESTRICTED_NETWORK";
+    IneligibleTierReasonCode["UNKNOWN"] = "UNKNOWN";
+    IneligibleTierReasonCode["UNKNOWN_LOCATION"] = "UNKNOWN_LOCATION";
+    IneligibleTierReasonCode["UNSUPPORTED_LOCATION"] = "UNSUPPORTED_LOCATION";
+    IneligibleTierReasonCode["VALIDATION_REQUIRED"] = "VALIDATION_REQUIRED";
+    // go/keep-sorted end
+})(IneligibleTierReasonCode || (IneligibleTierReasonCode = {}));
+/**
+ * UserTierId represents IDs returned from the Cloud Code Private API representing a user's tier
+ *
+ * //depot/google3/cloud/developer_experience/cloudcode/pa/service/usertier.go;l=16
+ */
+export var UserTierId;
+(function (UserTierId) {
+    UserTierId["FREE"] = "free-tier";
+    UserTierId["LEGACY"] = "legacy-tier";
+    UserTierId["STANDARD"] = "standard-tier";
+})(UserTierId || (UserTierId = {}));
+/**
+ * Status code of user license status
+ * it does not strictly correspond to the proto
+ * Error value is an additional value assigned to error responses from OnboardUser
+ */
+export var OnboardUserStatusCode;
+(function (OnboardUserStatusCode) {
+    OnboardUserStatusCode["Default"] = "DEFAULT";
+    OnboardUserStatusCode["Notice"] = "NOTICE";
+    OnboardUserStatusCode["Warning"] = "WARNING";
+    OnboardUserStatusCode["Error"] = "ERROR";
+})(OnboardUserStatusCode || (OnboardUserStatusCode = {}));
+export var ConversationInteractionInteraction;
+(function (ConversationInteractionInteraction) {
+    ConversationInteractionInteraction[ConversationInteractionInteraction["UNKNOWN"] = 0] = "UNKNOWN";
+    ConversationInteractionInteraction[ConversationInteractionInteraction["THUMBSUP"] = 1] = "THUMBSUP";
+    ConversationInteractionInteraction[ConversationInteractionInteraction["THUMBSDOWN"] = 2] = "THUMBSDOWN";
+    ConversationInteractionInteraction[ConversationInteractionInteraction["COPY"] = 3] = "COPY";
+    ConversationInteractionInteraction[ConversationInteractionInteraction["INSERT"] = 4] = "INSERT";
+    ConversationInteractionInteraction[ConversationInteractionInteraction["ACCEPT_CODE_BLOCK"] = 5] = "ACCEPT_CODE_BLOCK";
+    ConversationInteractionInteraction[ConversationInteractionInteraction["ACCEPT_ALL"] = 6] = "ACCEPT_ALL";
+    ConversationInteractionInteraction[ConversationInteractionInteraction["ACCEPT_FILE"] = 7] = "ACCEPT_FILE";
+    ConversationInteractionInteraction[ConversationInteractionInteraction["DIFF"] = 8] = "DIFF";
+    ConversationInteractionInteraction[ConversationInteractionInteraction["ACCEPT_RANGE"] = 9] = "ACCEPT_RANGE";
+})(ConversationInteractionInteraction || (ConversationInteractionInteraction = {}));
+export var ActionStatus;
+(function (ActionStatus) {
+    ActionStatus[ActionStatus["ACTION_STATUS_UNSPECIFIED"] = 0] = "ACTION_STATUS_UNSPECIFIED";
+    ActionStatus[ActionStatus["ACTION_STATUS_NO_ERROR"] = 1] = "ACTION_STATUS_NO_ERROR";
+    ActionStatus[ActionStatus["ACTION_STATUS_ERROR_UNKNOWN"] = 2] = "ACTION_STATUS_ERROR_UNKNOWN";
+    ActionStatus[ActionStatus["ACTION_STATUS_CANCELLED"] = 3] = "ACTION_STATUS_CANCELLED";
+    ActionStatus[ActionStatus["ACTION_STATUS_EMPTY"] = 4] = "ACTION_STATUS_EMPTY";
+})(ActionStatus || (ActionStatus = {}));
+export var InitiationMethod;
+(function (InitiationMethod) {
+    InitiationMethod[InitiationMethod["INITIATION_METHOD_UNSPECIFIED"] = 0] = "INITIATION_METHOD_UNSPECIFIED";
+    InitiationMethod[InitiationMethod["TAB"] = 1] = "TAB";
+    InitiationMethod[InitiationMethod["COMMAND"] = 2] = "COMMAND";
+    InitiationMethod[InitiationMethod["AGENT"] = 3] = "AGENT";
+})(InitiationMethod || (InitiationMethod = {}));
+const ExtensionsSettingSchema = z.object({
+    extensionsEnabled: z.boolean().optional(),
+});
+const CliFeatureSettingSchema = z.object({
+    extensionsSetting: ExtensionsSettingSchema.optional(),
+    unmanagedCapabilitiesEnabled: z.boolean().optional(),
+});
+const McpSettingSchema = z.object({
+    mcpEnabled: z.boolean().optional(),
+    overrideMcpConfigJson: z.string().optional(),
+});
+export const FetchAdminControlsResponseSchema = z.object({
+    // TODO: deprecate once backend stops sending this field
+    secureModeEnabled: z.boolean().optional(),
+    strictModeDisabled: z.boolean().optional(),
+    mcpSetting: McpSettingSchema.optional(),
+    cliFeatureSetting: CliFeatureSettingSchema.optional(),
+});
+//# sourceMappingURL=types.js.map

package/dist/src/code_assist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/code_assist/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAqFxB;;;GAGG;AACH,MAAM,CAAN,IAAY,wBAYX;AAZD,WAAY,wBAAwB;IAClC,uBAAuB;IACvB,uDAA2B,CAAA;IAC3B,qEAAyC,CAAA;IACzC,iEAAqC,CAAA;IACrC,6DAAiC,CAAA;IACjC,qEAAyC,CAAA;IACzC,+CAAmB,CAAA;IACnB,iEAAqC,CAAA;IACrC,yEAA6C,CAAA;IAC7C,uEAA2C,CAAA;IAC3C,qBAAqB;AACvB,CAAC,EAZW,wBAAwB,KAAxB,wBAAwB,QAYnC;AACD;;;;GAIG;AACH,MAAM,CAAN,IAAY,UAIX;AAJD,WAAY,UAAU;IACpB,gCAAkB,CAAA;IAClB,oCAAsB,CAAA;IACtB,wCAA0B,CAAA;AAC5B,CAAC,EAJW,UAAU,KAAV,UAAU,QAIrB;AA0CD;;;;GAIG;AACH,MAAM,CAAN,IAAY,qBAKX;AALD,WAAY,qBAAqB;IAC/B,4CAAmB,CAAA;IACnB,0CAAiB,CAAA;IACjB,4CAAmB,CAAA;IACnB,wCAAe,CAAA;AACjB,CAAC,EALW,qBAAqB,KAArB,qBAAqB,QAKhC;AA2ED,MAAM,CAAN,IAAY,kCAWX;AAXD,WAAY,kCAAkC;IAC5C,iGAAW,CAAA;IACX,mGAAY,CAAA;IACZ,uGAAc,CAAA;IACd,2FAAQ,CAAA;IACR,+FAAU,CAAA;IACV,qHAAqB,CAAA;IACrB,uGAAc,CAAA;IACd,yGAAe,CAAA;IACf,2FAAQ,CAAA;IACR,2GAAgB,CAAA;AAClB,CAAC,EAXW,kCAAkC,KAAlC,kCAAkC,QAW7C;AAED,MAAM,CAAN,IAAY,YAMX;AAND,WAAY,YAAY;IACtB,yFAA6B,CAAA;IAC7B,mFAA0B,CAAA;IAC1B,6FAA+B,CAAA;IAC/B,qFAA2B,CAAA;IAC3B,6EAAuB,CAAA;AACzB,CAAC,EANW,YAAY,KAAZ,YAAY,QAMvB;AAED,MAAM,CAAN,IAAY,gBAKX;AALD,WAAY,gBAAgB;IAC1B,yGAAiC,CAAA;IACjC,qDAAO,CAAA;IACP,6DAAW,CAAA;IACX,yDAAS,CAAA;AACX,CAAC,EALW,gBAAgB,KAAhB,gBAAgB,QAK3B;AAkCD,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC;AAEH,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,iBAAiB,EAAE,uBAAuB,CAAC,QAAQ,EAAE;IACrD,4BAA4B,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACrD,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAClC,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,CAAC;IACvD,wDAAwD;IACxD,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACzC,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC1C,UAAU,EAAE,gBAAgB,CAAC,QAAQ,EAAE;IACvC,iBAAiB,EAAE,uBAAuB,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAC"}

package/dist/src/cognitive/gemini-adapter.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Gemini Client Adapter for Cognitive Modules
+ *
+ * This adapter connects Cognitive Modules to the Gemini CLI's
+ * content generation infrastructure.
+ */
+import type { ContentGenerator } from '../core/contentGenerator.js';
+import type { Config } from '../config/config.js';
+import type { LLMCaller } from './runtime/executor.js';
+/**
+ * Create an LLM caller from Gemini CLI's ContentGenerator.
+ *
+ * This allows Cognitive Modules to use the same authentication,
+ * model configuration, and API infrastructure as the rest of Gemini CLI.
+ */
+export declare function createLLMCallerFromContentGenerator(contentGenerator: ContentGenerator, config: Config): LLMCaller;
+/**
+ * Create a simple LLM caller using GoogleGenAI directly.
+ * This is for standalone use outside of the full Gemini CLI infrastructure.
+ */
+export declare function createSimpleLLMCaller(options: {
+    apiKey?: string;
+    model?: string;
+}): Promise<LLMCaller>;
+export type { LLMCaller };

package/dist/src/cognitive/gemini-adapter.js

@@ -0,0 +1,109 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Gemini Client Adapter for Cognitive Modules
+ *
+ * This adapter connects Cognitive Modules to the Gemini CLI's
+ * content generation infrastructure.
+ */
+import { resolveModel } from '../config/models.js';
+// =============================================================================
+// Adapter Implementation
+// =============================================================================
+/**
+ * Create an LLM caller from Gemini CLI's ContentGenerator.
+ *
+ * This allows Cognitive Modules to use the same authentication,
+ * model configuration, and API infrastructure as the rest of Gemini CLI.
+ */
+export function createLLMCallerFromContentGenerator(contentGenerator, config) {
+    return {
+        async call({ systemPrompt, userPrompt, model }) {
+            // Resolve model
+            const resolvedModel = model
+                ? resolveModel(model, config.getPreviewFeatures())
+                : resolveModel(config.getModel(), config.getPreviewFeatures());
+            // Build the request
+            const request = {
+                model: resolvedModel,
+                config: {
+                    systemInstruction: systemPrompt,
+                    // Request JSON output for cognitive modules
+                    responseMimeType: 'application/json',
+                },
+                contents: [
+                    {
+                        role: 'user',
+                        parts: [{ text: userPrompt }],
+                    },
+                ],
+            };
+            // Call the API
+            const response = await contentGenerator.generateContent(request, `cognitive-module-${Date.now()}`);
+            // Extract text from response
+            const candidate = response.candidates?.[0];
+            if (!candidate?.content?.parts) {
+                throw new Error('No content in response');
+            }
+            // Concatenate all text parts
+            const textParts = candidate.content.parts
+                .filter((part) => typeof part.text === 'string')
+                .map((part) => part.text);
+            if (textParts.length === 0) {
+                throw new Error('No text content in response');
+            }
+            return textParts.join('');
+        },
+    };
+}
+// =============================================================================
+// Simplified Caller for Standalone Use
+// =============================================================================
+/**
+ * Create a simple LLM caller using GoogleGenAI directly.
+ * This is for standalone use outside of the full Gemini CLI infrastructure.
+ */
+export async function createSimpleLLMCaller(options) {
+    const { GoogleGenAI } = await import('@google/genai');
+    const apiKey = options.apiKey ||
+        process.env['GEMINI_API_KEY'] ||
+        process.env['GOOGLE_API_KEY'];
+    if (!apiKey) {
+        throw new Error('No API key provided. Set GEMINI_API_KEY or GOOGLE_API_KEY environment variable.');
+    }
+    const genAI = new GoogleGenAI({ apiKey });
+    const defaultModel = options.model || 'gemini-2.5-flash';
+    return {
+        async call({ systemPrompt, userPrompt, model }) {
+            const modelToUse = model || defaultModel;
+            const response = await genAI.models.generateContent({
+                model: modelToUse,
+                config: {
+                    systemInstruction: systemPrompt,
+                    responseMimeType: 'application/json',
+                },
+                contents: [
+                    {
+                        role: 'user',
+                        parts: [{ text: userPrompt }],
+                    },
+                ],
+            });
+            // Extract text
+            const candidate = response.candidates?.[0];
+            if (!candidate?.content?.parts) {
+                throw new Error('No content in response');
+            }
+            const textParts = candidate.content.parts
+                .filter((part) => typeof part.text === 'string')
+                .map((part) => part.text);
+            if (textParts.length === 0) {
+                throw new Error('No text content in response');
+            }
+            return textParts.join('');
+        },
+    };
+}
+//# sourceMappingURL=gemini-adapter.js.map

package/dist/src/cognitive/gemini-adapter.js.map

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

package/dist/src/cognitive/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Cognitive Modules - Native Support for Gemini CLI
+ *
+ * This module provides first-class support for Cognitive Modules in Gemini CLI,
+ * implementing the Cognitive v2.2 specification.
+ *
+ * Three core components:
+ * 1. Module Loader - Reads module.yaml + prompt.md + schema.json
+ * 2. Runtime Executor - Parse → Validate → Repair Pass → Return
+ * 3. Tool Integration - Makes modules available as @cognitive tools
+ */
+export type { ModuleTier, SchemaStrictness, EnumStrategy, RiskLevel, RiskRule, CognitiveModule, ModuleManifest, SchemaContract, OverflowPolicy, EnumPolicy, Policies, ToolsPolicy, FailureContract, RuntimeRequirements, CompatConfig, IOConfig, EnvelopeResponse, EnvelopeSuccess, EnvelopeFailure, EnvelopeMeta, EnvelopeError, Insight, Extensions, ErrorCode, RunModuleOptions, ValidationResult, ModuleSearchPaths, } from './types.js';
+export { loadModule, findModule, discoverModules, detectFormat, detectV2Version, isValidModulePath, getModuleTier, isOverflowEnabled, shouldAutoWrap, type ModuleFormat, } from './loader/index.js';
+export { validateInput, validateData, validateMeta, validateError, validateEnvelope, validateOverflow, validateFull, isEnvelopeResponse, isV22Envelope, isSuccessEnvelope, isFailureEnvelope, validateEnvelopeStructure, validateMetaFields, type FullValidationResult, type EnvelopeStructureResult, } from './validator/index.js';
+export { executeModule, runModule, parseLLMResponse, setDefaultLLMCaller, getDefaultLLMCaller, extractMeta, shouldEscalate, requiresConfirmation, type ExecuteModuleParams, type LLMCaller, wrapV21ToV22, convertLegacyToEnvelope, createSuccessEnvelope, createFailureEnvelope, createParseError, createInvalidInputError, createModuleNotFoundError, createSchemaValidationError, createInternalError, aggregateRisk, aggregateRiskFromList, compareRisk, maxRisk, requiresReview, repairEnvelope, repairErrorEnvelope, tryRepair, isMetaRepairable, type RepairResult, buildPrompt, buildSystemPrompt, substituteArguments, formatConstraints, type BuildPromptOptions, } from './runtime/index.js';
+export { CognitiveTool, createCognitiveTool, createCognitiveTools, CognitiveModuleRegistry, getGlobalRegistry, initGlobalRegistry, resetGlobalRegistry, getDefaultConfig, type CognitiveToolParams, type CognitiveToolResult, type CognitiveConfig, } from './tool/index.js';
+export { discoverAndRegisterCognitiveTools, registerCognitiveModule, getCognitiveTools, isCognitiveTool, getCognitiveConfigFromSettings, createLLMCallerFromGeminiClient, type GeminiClientAdapter, } from './integration.js';
+export { createLLMCallerFromContentGenerator, createSimpleLLMCaller, } from './gemini-adapter.js';

package/dist/src/cognitive/index.js

@@ -0,0 +1,50 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Cognitive Modules - Native Support for Gemini CLI
+ *
+ * This module provides first-class support for Cognitive Modules in Gemini CLI,
+ * implementing the Cognitive v2.2 specification.
+ *
+ * Three core components:
+ * 1. Module Loader - Reads module.yaml + prompt.md + schema.json
+ * 2. Runtime Executor - Parse → Validate → Repair Pass → Return
+ * 3. Tool Integration - Makes modules available as @cognitive tools
+ */
+// =============================================================================
+// Loader
+// =============================================================================
+export { loadModule, findModule, discoverModules, detectFormat, detectV2Version, isValidModulePath, getModuleTier, isOverflowEnabled, shouldAutoWrap, } from './loader/index.js';
+// =============================================================================
+// Validator
+// =============================================================================
+export { validateInput, validateData, validateMeta, validateError, validateEnvelope, validateOverflow, validateFull, isEnvelopeResponse, isV22Envelope, isSuccessEnvelope, isFailureEnvelope, validateEnvelopeStructure, validateMetaFields, } from './validator/index.js';
+// =============================================================================
+// Runtime
+// =============================================================================
+export { 
+// Executor
+executeModule, runModule, parseLLMResponse, setDefaultLLMCaller, getDefaultLLMCaller, extractMeta, shouldEscalate, requiresConfirmation, 
+// Envelope factory
+wrapV21ToV22, convertLegacyToEnvelope, createSuccessEnvelope, createFailureEnvelope, createParseError, createInvalidInputError, createModuleNotFoundError, createSchemaValidationError, createInternalError, 
+// Risk
+aggregateRisk, aggregateRiskFromList, compareRisk, maxRisk, requiresReview, 
+// Repair
+repairEnvelope, repairErrorEnvelope, tryRepair, isMetaRepairable, 
+// Prompt
+buildPrompt, buildSystemPrompt, substituteArguments, formatConstraints, } from './runtime/index.js';
+// =============================================================================
+// Tool Integration
+// =============================================================================
+export { CognitiveTool, createCognitiveTool, createCognitiveTools, CognitiveModuleRegistry, getGlobalRegistry, initGlobalRegistry, resetGlobalRegistry, getDefaultConfig, } from './tool/index.js';
+// =============================================================================
+// Integration
+// =============================================================================
+export { discoverAndRegisterCognitiveTools, registerCognitiveModule, getCognitiveTools, isCognitiveTool, getCognitiveConfigFromSettings, createLLMCallerFromGeminiClient, } from './integration.js';
+// =============================================================================
+// Gemini Adapter
+// =============================================================================
+export { createLLMCallerFromContentGenerator, createSimpleLLMCaller, } from './gemini-adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/src/cognitive/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cognitive/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA2CH,gFAAgF;AAChF,SAAS;AACT,gFAAgF;AAEhF,OAAO,EACL,UAAU,EACV,UAAU,EACV,eAAe,EACf,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,cAAc,GAEf,MAAM,mBAAmB,CAAC;AAE3B,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,OAAO,EACL,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,yBAAyB,EACzB,kBAAkB,GAGnB,MAAM,sBAAsB,CAAC;AAE9B,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF,OAAO;AACL,WAAW;AACX,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,oBAAoB;AAIpB,mBAAmB;AACnB,YAAY,EACZ,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,uBAAuB,EACvB,yBAAyB,EACzB,2BAA2B,EAC3B,mBAAmB;AAEnB,OAAO;AACP,aAAa,EACb,qBAAqB,EACrB,WAAW,EACX,OAAO,EACP,cAAc;AAEd,SAAS;AACT,cAAc,EACd,mBAAmB,EACnB,SAAS,EACT,gBAAgB;AAGhB,SAAS;AACT,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,GAElB,MAAM,oBAAoB,CAAC;AAE5B,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GAIjB,MAAM,iBAAiB,CAAC;AAEzB,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF,OAAO,EACL,iCAAiC,EACjC,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EACf,8BAA8B,EAC9B,+BAA+B,GAEhC,MAAM,kBAAkB,CAAC;AAE1B,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF,OAAO,EACL,mCAAmC,EACnC,qBAAqB,GACtB,MAAM,qBAAqB,CAAC"}