@clinebot/core 0.0.4 → 0.0.6

package/dist/{default-tools → tools}/schemas.d.ts

@@ -23,6 +23,12 @@ export declare const ReadFilesInputUnionSchema: z.ZodUnion<readonly [z.ZodObject
 export declare const SearchCodebaseInputSchema: z.ZodObject<{
     queries: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;
+/**
+ * Union schema for search_codebase tool input, allowing either a single string, an array of strings, or the full object schema
+ */
+export declare const SearchCodebaseUnionInputSchema: z.ZodUnion<readonly [z.ZodObject<{
+    queries: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, z.ZodArray<z.ZodString>, z.ZodString]>;
 /**
  * Schema for run_commands tool input
  */

package/dist/types/config.d.ts

@@ -1,7 +1,7 @@
 import type { AgentConfig, AgentHooks, ConsecutiveMistakeLimitContext, ConsecutiveMistakeLimitDecision, HookErrorMode, TeamEvent, Tool } from "@clinebot/agents";
 import type { providers as LlmsProviders } from "@clinebot/llms";
-import type { AgentMode, BasicLogger, SessionExecutionConfig, SessionPromptConfig, SessionWorkspaceConfig } from "@clinebot/shared";
-import type { ToolRoutingRule } from "../default-tools/model-tool-routing.js";
+import type { AgentMode, BasicLogger, ITelemetryService, SessionExecutionConfig, SessionPromptConfig, SessionWorkspaceConfig } from "@clinebot/shared";
+import type { ToolRoutingRule } from "../tools/model-tool-routing.js";
 export type CoreAgentMode = AgentMode;
 export interface CoreModelConfig {
     providerId: string;
@@ -35,6 +35,7 @@ export interface CoreSessionConfig extends CoreModelConfig, CoreRuntimeFeatures,
     hooks?: AgentHooks;
     hookErrorMode?: HookErrorMode;
     logger?: BasicLogger;
+    telemetry?: ITelemetryService;
     extraTools?: Tool[];
     pluginPaths?: string[];
     extensions?: AgentConfig["extensions"];

package/package.json

@@ -1,10 +1,19 @@
 {
 	"name": "@clinebot/core",
-	"version": "0.0.4",
+	"version": "0.0.6",
 	"main": "./dist/index.node.js",
 	"dependencies": {
-		"@clinebot/agents": "0.0.4",
-		"@clinebot/llms": "0.0.4",
+		"@clinebot/agents": "0.0.6",
+		"@clinebot/llms": "0.0.6",
+		"@opentelemetry/api": "^1.9.0",
+		"@opentelemetry/api-logs": "^0.56.0",
+		"@opentelemetry/exporter-logs-otlp-http": "^0.56.0",
+		"@opentelemetry/exporter-metrics-otlp-http": "^0.56.0",
+		"@opentelemetry/resources": "^1.30.1",
+		"@opentelemetry/sdk-logs": "^0.56.0",
+		"@opentelemetry/sdk-metrics": "^1.30.1",
+		"@opentelemetry/semantic-conventions": "^1.37.0",
+		"better-sqlite3": "^11.10.0",
 		"nanoid": "^5.1.7",
 		"simple-git": "^3.32.3",
 		"yaml": "^2.8.2",
@@ -20,6 +29,11 @@
 			"development": "./src/index.node.ts",
 			"types": "./dist/index.node.d.ts",
 			"import": "./dist/index.node.js"
+		},
+		"./telemetry/opentelemetry": {
+			"development": "./src/telemetry/opentelemetry.ts",
+			"types": "./dist/telemetry/opentelemetry.d.ts",
+			"import": "./dist/telemetry/opentelemetry.js"
 		}
 	},
 	"description": "State-aware orchestration for Cline Agent runtimes",

package/src/agents/agent-config-parser.ts

@@ -1,7 +1,7 @@
 import type { AgentConfig, Tool } from "@clinebot/agents";
 import YAML from "yaml";
 import { z } from "zod";
-import { ALL_DEFAULT_TOOL_NAMES, type DefaultToolName } from "../default-tools";
+import { ALL_DEFAULT_TOOL_NAMES, type DefaultToolName } from "../tools";
 
 const AgentConfigFrontmatterSchema = z.object({
 	name: z.string().trim().min(1),

package/src/agents/hooks-config-loader.ts

@@ -45,10 +45,28 @@ const HOOK_CONFIG_FILE_LOOKUP = new Map<string, HookConfigFileName>(
 	Object.values(HookConfigFileName).map((name) => [name.toLowerCase(), name]),
 );
 
+const SUPPORTED_HOOK_FILE_EXTENSIONS = new Set([
+	"",
+	".sh",
+	".bash",
+	".zsh",
+	".js",
+	".mjs",
+	".cjs",
+	".ts",
+	".mts",
+	".cts",
+	".py",
+]);
+
 export function toHookConfigFileName(
 	fileName: string,
 ): HookConfigFileName | undefined {
-	const key = basename(fileName, extname(fileName)).trim().toLowerCase();
+	const extension = extname(fileName).toLowerCase();
+	if (!SUPPORTED_HOOK_FILE_EXTENSIONS.has(extension)) {
+		return undefined;
+	}
+	const key = basename(fileName, extension).trim().toLowerCase();
 	return HOOK_CONFIG_FILE_LOOKUP.get(key);
 }
 

package/src/index.node.ts

@@ -100,6 +100,9 @@ export {
 	OCI_HEADER_OPC_REQUEST_ID,
 	refreshOcaToken,
 } from "./auth/oca";
+export async function loadOpenTelemetryAdapter() {
+	return import("./telemetry/opentelemetry.js");
+}
 export { startLocalOAuthServer } from "./auth/server";
 export type {
 	OAuthCredentials,

package/src/index.ts

@@ -19,6 +19,7 @@ export type {
 	BasicLogger,
 	ConnectorHookEvent,
 	HookSessionContext,
+	ITelemetryService,
 	RpcAddProviderActionRequest,
 	RpcChatMessage,
 	RpcChatRunTurnRequest,
@@ -38,6 +39,12 @@ export type {
 	RpcSaveProviderSettingsActionRequest,
 	SessionLineage,
 	TeamProgressProjectionEvent,
+	TelemetryArray,
+	TelemetryMetadata,
+	TelemetryObject,
+	TelemetryPrimitive,
+	TelemetryProperties,
+	TelemetryValue,
 	ToolPolicy,
 } from "@clinebot/shared";
 export {
@@ -85,25 +92,6 @@ export {
 	ChatSummarySchema,
 	ChatViewStateSchema,
 } from "./chat/chat-schema";
-export {
-	ALL_DEFAULT_TOOL_NAMES,
-	type AskQuestionExecutor,
-	type CreateBuiltinToolsOptions,
-	type CreateDefaultToolsOptions,
-	createBuiltinTools,
-	createDefaultExecutors,
-	createDefaultTools,
-	createDefaultToolsWithPreset,
-	createToolPoliciesWithPreset,
-	type DefaultExecutorsOptions,
-	type DefaultToolName,
-	DefaultToolNames,
-	type DefaultToolsConfig,
-	type ToolExecutors,
-	type ToolPolicyPresetName,
-	type ToolPresetName,
-	ToolPresets,
-} from "./default-tools";
 export {
 	hasMcpSettingsFile,
 	InMemoryMcpManager,
@@ -135,6 +123,34 @@ export {
 	buildTeamProgressSummary,
 	toTeamProgressLifecycleEvent,
 } from "./team";
+export type { ITelemetryAdapter } from "./telemetry/ITelemetryAdapter";
+export {
+	LoggerTelemetryAdapter,
+	type LoggerTelemetryAdapterOptions,
+} from "./telemetry/LoggerTelemetryAdapter";
+export {
+	TelemetryService,
+	type TelemetryServiceOptions,
+} from "./telemetry/TelemetryService";
+export {
+	ALL_DEFAULT_TOOL_NAMES,
+	type AskQuestionExecutor,
+	type CreateBuiltinToolsOptions,
+	type CreateDefaultToolsOptions,
+	createBuiltinTools,
+	createDefaultExecutors,
+	createDefaultTools,
+	createDefaultToolsWithPreset,
+	createToolPoliciesWithPreset,
+	type DefaultExecutorsOptions,
+	type DefaultToolName,
+	DefaultToolNames,
+	type DefaultToolsConfig,
+	type ToolExecutors,
+	type ToolPolicyPresetName,
+	type ToolPresetName,
+	ToolPresets,
+} from "./tools";
 // Compatibility barrel (legacy imports).
 export type { RuntimeEnvironment, SessionEvent, StoredMessages } from "./types";
 export type { SessionStatus } from "./types/common";

package/src/providers/local-provider-service.ts

@@ -35,6 +35,7 @@ type StoredModelsFile = {
 					name: string;
 					supportsVision?: boolean;
 					supportsAttachments?: boolean;
+					supportsReasoning?: boolean;
 				}
 			>;
 		}
@@ -132,6 +133,24 @@ async function writeModelsFile(
 	await writeFile(filePath, `${JSON.stringify(state, null, 2)}\n`, "utf8");
 }
 
+function toRpcProviderModel(
+	modelId: string,
+	info: {
+		name?: string;
+		capabilities?: string[];
+		thinkingConfig?: unknown;
+	},
+): RpcProviderModel {
+	return {
+		id: modelId,
+		name: info.name ?? modelId,
+		supportsAttachments: info.capabilities?.includes("files"),
+		supportsVision: info.capabilities?.includes("images"),
+		supportsReasoning:
+			info.capabilities?.includes("reasoning") || info.thinkingConfig != null,
+	};
+}
+
 function toProviderCapabilities(
 	capabilities: RpcProviderCapability[] | undefined,
 ): Array<"reasoning" | "prompt-cache" | "tools"> | undefined {
@@ -352,6 +371,7 @@ export async function addLocalProvider(
 	const modelsState = await readModelsFile(modelsPath);
 	const supportsVision = capabilities?.includes("vision") ?? false;
 	const supportsAttachments = supportsVision;
+	const supportsReasoning = capabilities?.includes("reasoning") ?? false;
 	modelsState.providers[providerId] = {
 		provider: {
 			name: providerName,
@@ -368,6 +388,7 @@ export async function addLocalProvider(
 					name: modelId,
 					supportsVision,
 					supportsAttachments,
+					supportsReasoning,
 				},
 			]),
 		),
@@ -394,12 +415,13 @@ export async function listLocalProviders(
 	const providerItems = await Promise.all(
 		ids.map(async (id): Promise<RpcProviderListItem> => {
 			const info = await models.getProvider(id);
+			const providerModels = await getLocalProviderModels(id);
 			const persistedSettings = state.providers[id]?.settings;
 			const providerName = info?.name ?? titleCaseFromId(id);
 			return {
 				id,
 				name: providerName,
-				models: null,
+				models: providerModels.models.length,
 				color: stableColor(id),
 				letter: createLetter(providerName),
 				enabled: Boolean(persistedSettings),
@@ -413,6 +435,7 @@ export async function listLocalProviders(
 				defaultModelId: info?.defaultModelId,
 				authDescription: "This provider uses API keys for authentication.",
 				baseUrlDescription: "The base endpoint to use for provider requests.",
+				modelList: providerModels.models,
 			};
 		}),
 	);
@@ -430,12 +453,7 @@ export async function getLocalProviderModels(
 	const modelMap = await models.getModelsForProvider(id);
 	const items = Object.entries(modelMap)
 		.sort(([a], [b]) => a.localeCompare(b))
-		.map(([modelId, info]) => ({
-			id: modelId,
-			name: info.name ?? modelId,
-			supportsAttachments: info.capabilities?.includes("files"),
-			supportsVision: info.capabilities?.includes("images"),
-		}));
+		.map(([modelId, info]) => toRpcProviderModel(modelId, info));
 	return {
 		providerId: id,
 		models: items,

package/src/runtime/hook-file-hooks.test.ts

@@ -17,6 +17,22 @@ async function createWorkspaceWithHook(
 }
 
 describe("createHookConfigFileHooks", () => {
+	it("ignores example hook files", async () => {
+		const { workspace } = await createWorkspaceWithHook(
+			"PreToolUse.example",
+			'echo \'HOOK_CONTROL\t{"cancel":true,"context":"should-not-run"}\'\n',
+		);
+		try {
+			const hooks = createHookConfigFileHooks({
+				cwd: workspace,
+				workspacePath: workspace,
+			});
+			expect(hooks).toBeUndefined();
+		} finally {
+			await rm(workspace, { recursive: true, force: true });
+		}
+	});
+
 	it("executes extensionless legacy hook files via bash fallback", async () => {
 		const { workspace } = await createWorkspaceWithHook(
 			"PreToolUse",
@@ -103,4 +119,35 @@ describe("createHookConfigFileHooks", () => {
 			await rm(workspace, { recursive: true, force: true });
 		}
 	});
+
+	it("executes python hook files", async () => {
+		const { workspace } = await createWorkspaceWithHook(
+			"PreToolUse.py",
+			'print(\'HOOK_CONTROL\\t{"cancel": false, "context": "python-ok"}\')\n',
+		);
+		try {
+			const hooks = createHookConfigFileHooks({
+				cwd: workspace,
+				workspacePath: workspace,
+			});
+			expect(hooks?.onToolCallStart).toBeTypeOf("function");
+			const control = await hooks?.onToolCallStart?.({
+				agentId: "agent_1",
+				conversationId: "conv_1",
+				parentAgentId: null,
+				iteration: 1,
+				call: {
+					id: "call_1",
+					name: "read_file",
+					input: { path: "README.md" },
+				},
+			});
+			expect(control).toMatchObject({
+				cancel: false,
+				context: "python-ok",
+			});
+		} finally {
+			await rm(workspace, { recursive: true, force: true });
+		}
+	});
 });

package/src/runtime/hook-file-hooks.ts

@@ -323,6 +323,9 @@ function inferHookCommand(path: string): string[] {
 	) {
 		return ["bun", "run", path];
 	}
+	if (lowered.endsWith(".py")) {
+		return ["python3", path];
+	}
 	// Default to bash for legacy hook files with no extension/shebang.
 	return ["/bin/bash", path];
 }

package/src/runtime/runtime-builder.test.ts

@@ -3,6 +3,7 @@ import { tmpdir } from "node:os";
 import { join } from "node:path";
 import type { Tool } from "@clinebot/agents";
 import { describe, expect, it } from "vitest";
+import { TelemetryService } from "../telemetry/TelemetryService";
 import { DefaultRuntimeBuilder } from "./runtime-builder";
 
 function makeSpawnTool(): Tool {
@@ -55,6 +56,25 @@ describe("DefaultRuntimeBuilder", () => {
 		expect(runtime.logger).toBe(logger);
 	});
 
+	it("forwards telemetry for downstream runtime consumers", () => {
+		const telemetry = new TelemetryService();
+		const runtime = new DefaultRuntimeBuilder().build({
+			config: {
+				providerId: "anthropic",
+				modelId: "claude-sonnet-4-6",
+				apiKey: "key",
+				systemPrompt: "test",
+				cwd: process.cwd(),
+				enableTools: false,
+				enableSpawnAgent: false,
+				enableAgentTeams: false,
+				telemetry,
+			},
+		});
+
+		expect(runtime.telemetry).toBe(telemetry);
+	});
+
 	it("uses readonly preset in plan mode", () => {
 		const runtime = new DefaultRuntimeBuilder().build({
 			config: {

package/src/runtime/runtime-builder.ts

@@ -14,6 +14,7 @@ import {
 	type SkillConfig,
 	type UserInstructionConfigWatcher,
 } from "../agents";
+import { SqliteTeamStore } from "../storage/sqlite-team-store";
 import {
 	createBuiltinTools,
 	DEFAULT_MODEL_TOOL_ROUTING_RULES,
@@ -22,8 +23,7 @@ import {
 	type ToolExecutors,
 	ToolPresets,
 	type ToolRoutingRule,
-} from "../default-tools";
-import { SqliteTeamStore } from "../storage/sqlite-team-store";
+} from "../tools";
 import type { CoreAgentMode, CoreSessionConfig } from "../types/config";
 import type {
 	RuntimeBuilder,
@@ -522,6 +522,7 @@ export class DefaultRuntimeBuilder implements RuntimeBuilder {
 		return {
 			tools,
 			logger: logger ?? config.logger,
+			telemetry: input.telemetry ?? config.telemetry,
 			teamRuntime,
 			completionGuard,
 			shutdown: (reason: string) => {

package/src/runtime/runtime-parity.test.ts

@@ -3,7 +3,7 @@ import { tmpdir } from "node:os";
 import { join } from "node:path";
 import type { Tool } from "@clinebot/agents";
 import { describe, expect, it } from "vitest";
-import { createBuiltinTools } from "../default-tools";
+import { createBuiltinTools } from "../tools";
 import { DefaultRuntimeBuilder } from "./runtime-builder";
 
 type LegacyConfig = {

package/src/runtime/session-runtime.ts

@@ -5,15 +5,16 @@ import type {
 	AgentTeamsRuntime,
 	Tool,
 } from "@clinebot/agents";
-import type { BasicLogger } from "@clinebot/shared";
+import type { BasicLogger, ITelemetryService } from "@clinebot/shared";
 import type { UserInstructionConfigWatcher } from "../agents";
-import type { ToolExecutors } from "../default-tools";
+import type { ToolExecutors } from "../tools";
 import type { CoreSessionConfig } from "../types/config";
 
 export interface BuiltRuntime {
 	tools: Tool[];
 	hooks?: AgentHooks;
 	logger?: BasicLogger;
+	telemetry?: ITelemetryService;
 	teamRuntime?: AgentTeamsRuntime;
 	completionGuard?: () => string | undefined;
 	shutdown: (reason: string) => Promise<void> | void;
@@ -29,6 +30,7 @@ export interface RuntimeBuilderInput {
 	userInstructionWatcher?: UserInstructionConfigWatcher;
 	defaultToolExecutors?: Partial<ToolExecutors>;
 	logger?: BasicLogger;
+	telemetry?: ITelemetryService;
 }
 
 export interface RuntimeBuilder {

package/src/session/default-session-manager.test.ts

@@ -3,6 +3,7 @@ import { tmpdir } from "node:os";
 import { join } from "node:path";
 import type { AgentResult } from "@clinebot/agents";
 import { describe, expect, it, vi } from "vitest";
+import { TelemetryService } from "../telemetry/TelemetryService";
 import { SessionSource } from "../types/common";
 import type { CoreSessionConfig } from "../types/config";
 import { DefaultSessionManager } from "./default-session-manager";
@@ -70,6 +71,77 @@ function createConfig(
 }
 
 describe("DefaultSessionManager", () => {
+	it("emits session lifecycle telemetry when configured", async () => {
+		const sessionId = "sess-telemetry";
+		const manifest = createManifest(sessionId);
+		const adapter = {
+			name: "test",
+			emit: vi.fn(),
+			emitRequired: vi.fn(),
+			recordCounter: vi.fn(),
+			recordHistogram: vi.fn(),
+			recordGauge: vi.fn(),
+			isEnabled: vi.fn(() => true),
+			flush: vi.fn().mockResolvedValue(undefined),
+			dispose: vi.fn().mockResolvedValue(undefined),
+		};
+		const telemetry = new TelemetryService({
+			adapters: [adapter],
+			distinctId: distinctId,
+		});
+		const sessionService = {
+			ensureSessionsDir: vi.fn().mockReturnValue("/tmp/sessions"),
+			createRootSessionWithArtifacts: vi.fn().mockResolvedValue({
+				manifestPath: "/tmp/manifest.json",
+				transcriptPath: "/tmp/transcript.log",
+				hookPath: "/tmp/hook.log",
+				messagesPath: "/tmp/messages.json",
+				manifest,
+			}),
+			persistSessionMessages: vi.fn(),
+			updateSessionStatus: vi.fn().mockResolvedValue({
+				updated: true,
+				endedAt: "2026-01-01T00:00:05.000Z",
+			}),
+			writeSessionManifest: vi.fn(),
+			listSessions: vi.fn().mockResolvedValue([]),
+			deleteSession: vi.fn().mockResolvedValue({ deleted: true }),
+		};
+		const runtimeBuilder = {
+			build: vi.fn().mockReturnValue({
+				tools: [],
+				shutdown: vi.fn(),
+			}),
+		};
+		const agent = {
+			run: vi.fn().mockResolvedValue(createResult()),
+			continue: vi.fn().mockResolvedValue(createResult()),
+			getMessages: vi.fn().mockReturnValue([]),
+			abort: vi.fn(),
+			shutdown: vi.fn().mockResolvedValue(undefined),
+		};
+		const manager = new DefaultSessionManager({
+			distinctId,
+			sessionService: sessionService as never,
+			runtimeBuilder: runtimeBuilder as never,
+			createAgent: () => agent as never,
+			telemetry,
+		});
+
+		await manager.start({
+			config: createConfig({ telemetry, sessionId }),
+			prompt: "hello",
+		});
+
+		expect(adapter.emit).toHaveBeenCalledWith(
+			"session.started",
+			expect.objectContaining({
+				sessionId,
+				distinct_id: distinctId,
+			}),
+		);
+	});
+
 	it("runs a non-interactive prompt and persists messages/status", async () => {
 		const sessionId = "sess-1";
 		const manifest = createManifest(sessionId);