@k2wanko/gemini-cli-sdk 0.2.0 → 0.3.0

package/README.md

@@ -7,6 +7,8 @@ Built on top of `@google/gemini-cli-core`.
 
 - **Skill support** — Load skill directories compatible with Gemini CLI's skill format
 - **Non-interactive by default** — All tool calls are auto-approved, designed for headless agent usage
+- **Logging control** — Suppress noisy core logs by default (`"silent"`), or route them to a custom logger (pino, winston, etc.) via `logLevel` and `logger` options
+- **Hooks** — Run shell commands at lifecycle events (BeforeTool, AfterTool, BeforeAgent, etc.) to inject context, block operations, or audit tool calls — compatible with Gemini CLI's hook protocol
 
 ## Install
 

package/dist/agent.d.ts

@@ -1,8 +1,9 @@
-import { GeminiEventType, type ServerGeminiStreamEvent } from "@google/gemini-cli-core";
+import { GeminiEventType, type HookDefinition, HookEventName, HookType, type ServerGeminiStreamEvent } from "@google/gemini-cli-core";
 import { type SessionContext } from "./context.js";
+import { type Logger, type LogLevel } from "./logger.js";
 import type { SkillRef } from "./skills.js";
 import { type ToolDef } from "./tool.js";
-export { GeminiEventType, type ServerGeminiStreamEvent };
+export { GeminiEventType, HookEventName, HookType, type HookDefinition, type ServerGeminiStreamEvent, };
 export interface GeminiAgentOptions {
     instructions: string | ((ctx: SessionContext) => string | Promise<string>);
     tools?: ToolDef<any>[];
@@ -14,6 +15,12 @@ export interface GeminiAgentOptions {
     sessionId?: string;
     /** Context compression threshold (0-1 fraction) */
     compressionThreshold?: number;
+    /** Core logger verbosity — default: "silent" */
+    logLevel?: LogLevel;
+    /** Custom log destination — defaults to console when logLevel is not "silent" */
+    logger?: Logger;
+    /** Hook definitions — automatically enables the hook system when provided */
+    hooks?: Partial<Record<HookEventName, HookDefinition[]>>;
 }
 export declare class GeminiAgent {
     private readonly config;
@@ -23,7 +30,13 @@ export declare class GeminiAgent {
     private readonly resumeSessionId;
     private instructionsLoaded;
     constructor(options: GeminiAgentOptions);
+    /** Return the session ID assigned to this agent instance */
+    getSessionId(): string;
+    /** List available sessions for the current project */
+    listSessions(): Promise<import("./session.js").SessionInfo[]>;
     sendStream(prompt: string, signal?: AbortSignal): AsyncGenerator<ServerGeminiStreamEvent>;
+    private initialized;
+    private ensureInitialized;
     private initialize;
     private resolveInstructions;
     private buildScopedRegistry;

package/dist/agent.js

@@ -1,8 +1,9 @@
-import { ActivateSkillTool, AuthType, Config, GeminiEventType, getAuthTypeFromEnv, loadSkillsFromDir, PolicyDecision, PREVIEW_GEMINI_MODEL_AUTO, scheduleAgentTools, } from "@google/gemini-cli-core";
+import { ActivateSkillTool, AuthType, Config, GeminiEventType, getAuthTypeFromEnv, HookEventName, HookType, loadSkillsFromDir, PolicyDecision, PREVIEW_GEMINI_MODEL_AUTO, scheduleAgentTools, } from "@google/gemini-cli-core";
 import { AgentFsImpl, AgentShellImpl } from "./context.js";
+import { patchCoreLogger } from "./logger.js";
 import { listSessions, loadSession, messageRecordsToHistory, } from "./session.js";
 import { SdkTool } from "./tool.js";
-export { GeminiEventType };
+export { GeminiEventType, HookEventName, HookType, };
 export class GeminiAgent {
     config;
     tools;
@@ -11,6 +12,7 @@ export class GeminiAgent {
     resumeSessionId;
     instructionsLoaded = false;
     constructor(options) {
+        patchCoreLogger(options.logLevel ?? "silent", options.logger);
         this.instructions = options.instructions;
         this.tools = options.tools ?? [];
         this.skillRefs = options.skills ?? [];
@@ -24,7 +26,8 @@ export class GeminiAgent {
             debugMode: options.debug ?? false,
             model: options.model ?? PREVIEW_GEMINI_MODEL_AUTO,
             userMemory: initialMemory,
-            enableHooks: false,
+            enableHooks: !!options.hooks,
+            ...(options.hooks && { hooks: options.hooks }),
             mcpEnabled: false,
             extensionsEnabled: false,
             skillsSupport: true,
@@ -36,6 +39,15 @@ export class GeminiAgent {
         };
         this.config = new Config(configParams);
     }
+    /** Return the session ID assigned to this agent instance */
+    getSessionId() {
+        return this.config.getSessionId();
+    }
+    /** List available sessions for the current project */
+    async listSessions() {
+        await this.ensureInitialized();
+        return listSessions(this.config);
+    }
     async *sendStream(prompt, signal) {
         await this.initialize();
         const client = this.config.getGeminiClient();
@@ -91,12 +103,19 @@ export class GeminiAgent {
     // -------------------------------------------------------------------------
     // Private helpers
     // -------------------------------------------------------------------------
-    async initialize() {
-        if (this.config.getContentGenerator())
+    initialized = false;
+    async ensureInitialized() {
+        if (this.initialized)
             return;
         const authType = getAuthTypeFromEnv() || AuthType.COMPUTE_ADC;
         await this.config.refreshAuth(authType);
         await this.config.initialize();
+        this.initialized = true;
+    }
+    async initialize() {
+        if (this.config.getContentGenerator())
+            return;
+        await this.ensureInitialized();
         // Resume previous session if requested
         if (this.resumeSessionId) {
             const sessions = await listSessions(this.config);

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./agent.js";
 export * from "./context.js";
+export * from "./logger.js";
 export * from "./session.js";
 export * from "./skills.js";
 export * from "./tool.js";

package/dist/index.js

@@ -1,5 +1,6 @@
 export * from "./agent.js";
 export * from "./context.js";
+export * from "./logger.js";
 export * from "./session.js";
 export * from "./skills.js";
 export * from "./tool.js";

package/dist/logger.d.ts

@@ -0,0 +1,8 @@
+export type LogLevel = "silent" | "error" | "warn" | "info" | "debug";
+export interface Logger {
+    log?: (...args: unknown[]) => void;
+    warn?: (...args: unknown[]) => void;
+    error?: (...args: unknown[]) => void;
+    debug?: (...args: unknown[]) => void;
+}
+export declare function patchCoreLogger(level: LogLevel, logger?: Logger): void;

package/dist/logger.js

@@ -0,0 +1,21 @@
+import { debugLogger } from "@google/gemini-cli-core";
+const LOG_LEVEL_ORDER = {
+    silent: 0,
+    error: 1,
+    warn: 2,
+    info: 3,
+    debug: 4,
+};
+const noop = () => { };
+export function patchCoreLogger(level, logger) {
+    const threshold = LOG_LEVEL_ORDER[level];
+    const dest = logger ?? console;
+    debugLogger.log =
+        threshold >= LOG_LEVEL_ORDER.info ? (dest.log ?? noop).bind(dest) : noop;
+    debugLogger.warn =
+        threshold >= LOG_LEVEL_ORDER.warn ? (dest.warn ?? noop).bind(dest) : noop;
+    debugLogger.error =
+        threshold >= LOG_LEVEL_ORDER.error ? (dest.error ?? noop).bind(dest) : noop;
+    debugLogger.debug =
+        threshold >= LOG_LEVEL_ORDER.debug ? (dest.debug ?? noop).bind(dest) : noop;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k2wanko/gemini-cli-sdk",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "A lightweight SDK for building non-interactive AI agents powered by Google Gemini",
   "type": "module",
   "private": false,