@caplets/core 0.27.0 → 0.28.0

package/dist/attach/api.d.ts

@@ -1,5 +1,11 @@
 import type { CapletsEngine } from "../engine";
 import type { CapletShadowingPolicy } from "../config";
+import type { NativeCapletsService } from "../native/service";
+export declare const CAPLETS_ATTACH_SESSION_HEADER = "caplets-attach-session-id";
+export type AttachSessionMetadata = {
+    projectRoot?: string | undefined;
+    projectConfigPath?: string | undefined;
+};
 export type AttachExportKind = "caplet" | "tool" | "resource" | "resourceTemplate" | "prompt" | "completion";
 export type AttachInvokeRequest = {
     revision: string;
@@ -105,6 +111,8 @@ export type AttachProjection = {
     routes: Map<string, AttachRoute>;
 };
 export declare function buildAttachProjection(engine: CapletsEngine): Promise<AttachProjection>;
+export declare function buildNativeAttachProjection(service: NativeCapletsService): Promise<AttachProjection>;
+export declare function invokeNativeAttachExport(service: NativeCapletsService, projection: AttachProjection, request: AttachInvokeRequest): Promise<unknown>;
 export declare function invokeAttachExport(engine: CapletsEngine, projection: AttachProjection, request: AttachInvokeRequest): Promise<unknown>;
 export declare function attachErrorResponse(error: unknown): {
     status: 400 | 404 | 409 | 500;

package/dist/cli/code-mode.d.ts

@@ -3,6 +3,7 @@ export type CodeModeCliOptions = {
     configPath?: string | undefined;
     projectConfigPath?: string | undefined;
     authDir?: string | undefined;
+    telemetryStateDir?: string | undefined;
     inlineCode?: string | undefined;
     file?: string | undefined;
     timeoutMs?: number | undefined;
@@ -14,6 +15,6 @@ export type CodeModeCliOptions = {
     setExitCode: (code: number) => void;
 };
 export declare function runCodeModeCli(options: CodeModeCliOptions): Promise<void>;
-export declare function runCodeModeReplCli(options: Pick<CodeModeCliOptions, "env" | "configPath" | "projectConfigPath" | "authDir" | "sessionId" | "recoveryRef" | "json" | "writeOut" | "setExitCode">): Promise<void>;
-export declare function codeModeTypesCli(options: Pick<CodeModeCliOptions, "env" | "configPath" | "projectConfigPath" | "authDir" | "json" | "writeOut">): Promise<void>;
+export declare function runCodeModeReplCli(options: Pick<CodeModeCliOptions, "env" | "configPath" | "projectConfigPath" | "authDir" | "telemetryStateDir" | "sessionId" | "recoveryRef" | "json" | "writeOut" | "setExitCode">): Promise<void>;
+export declare function codeModeTypesCli(options: Pick<CodeModeCliOptions, "env" | "configPath" | "projectConfigPath" | "authDir" | "telemetryStateDir" | "json" | "writeOut">): Promise<void>;
 export declare function readCodeModeCliCode(options: Pick<CodeModeCliOptions, "inlineCode" | "file" | "readStdin">): Promise<string>;

package/dist/cli/commands.d.ts

@@ -32,8 +32,9 @@ export declare const cliCommands: {
     readonly config: "config";
     readonly auth: "auth";
     readonly vault: "vault";
+    readonly telemetry: "telemetry";
 };
-export declare const topLevelCommandNames: readonly ["serve", "daemon", "code-mode", "attach", "remote", "cloud", "init", "setup", "doctor", "list", "install", "add", "inspect", "check-backend", "list-tools", "search-tools", "get-tool", "call-tool", "list-resources", "search-resources", "list-resource-templates", "read-resource", "list-prompts", "search-prompts", "get-prompt", "complete", "config", "auth", "vault", "completion"];
+export declare const topLevelCommandNames: readonly ["serve", "daemon", "code-mode", "attach", "remote", "cloud", "init", "setup", "doctor", "list", "install", "add", "inspect", "check-backend", "list-tools", "search-tools", "get-tool", "call-tool", "list-resources", "search-resources", "list-resource-templates", "read-resource", "list-prompts", "search-prompts", "get-prompt", "complete", "config", "auth", "vault", "telemetry", "completion"];
 export declare const cliSubcommands: {
     readonly add: readonly ["cli", "mcp", "openapi", "google-discovery", "graphql", "http"];
     readonly auth: readonly ["login", "logout", "list", "refresh"];
@@ -44,6 +45,7 @@ export declare const cliSubcommands: {
     readonly config: readonly ["path", "paths"];
     readonly daemon: readonly ["install", "uninstall", "start", "restart", "stop", "status", "logs"];
     readonly setup: readonly ["codex", "claude-code", "opencode", "pi", "mcp-client"];
+    readonly telemetry: readonly ["status", "enable", "disable", "delete-id", "rotate-id", "debug"];
     readonly vault: readonly ["set", "get", "list", "delete", "access"];
 };
 export declare const cliNestedSubcommands: {

package/dist/cli.d.ts

@@ -4,6 +4,7 @@ import { type AttachServeOptions } from "./attach/options";
 import type { ProjectBindingWebSocketFactory } from "./project-binding/transport";
 import { type DaemonOperationOptions } from "./daemon";
 import { type ServeOptions } from "./serve";
+import { TelemetryDebugSink } from "./telemetry";
 export { initConfig, starterConfig } from "./cli/init";
 export { installCaplets, normalizeGitRepo } from "./cli/install";
 export { addCliCaplet, addGoogleDiscoveryCaplet, addGraphqlCaplet, addHttpCaplet, addMcpCaplet, addOpenApiCaplet, } from "./cli/add";
@@ -15,6 +16,9 @@ type CliIO = {
     signal?: AbortSignal;
     projectBindingWebSocketFactory?: ProjectBindingWebSocketFactory;
     authDir?: string;
+    telemetryStateDir?: string;
+    stderrIsTTY?: boolean;
+    telemetryDebugSink?: TelemetryDebugSink;
     version?: string;
     setExitCode?: (code: number) => void;
     serve?: (options: ServeOptions) => Promise<void>;

package/dist/code-mode/types.d.ts

@@ -35,6 +35,7 @@ export type CodeModeRunMeta = {
     durationMs: number;
     timeoutMs: number;
     maxTimeoutMs: number;
+    anyCapletInvoked: boolean;
     sessionId?: string | null;
     sessionStatus?: CodeModeSessionStatus | null;
     recoveryRef?: string | null;

package/dist/{completion-1wDjwHkC.js → completion-CjE0EnbF.js}

@@ -1,4 +1,5 @@
-import { Hn as __exportAll, It as DEFAULT_AUTH_DIR, Kt as resolveProjectConfigPath, Lt as DEFAULT_COMPLETION_CACHE_DIR, Ut as resolveCapletsRoot, Wt as resolveConfigPath, lt as loadConfigWithSources } from "./service-BGGiZLHa.js";
+import { r as __exportAll } from "./rolldown-runtime-CE-6LUnI.js";
+import { Dt as loadConfigWithSources, cn as resolveCapletsRoot, dn as resolveProjectConfigPath, en as DEFAULT_AUTH_DIR, ln as resolveConfigPath, tn as DEFAULT_COMPLETION_CACHE_DIR } from "./service-BfPCRxQ9.js";
 import { d as CapletsError } from "./validation-CWzd2gtn.js";
 import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
@@ -42,7 +43,8 @@ const cliCommands = {
 	complete: "complete",
 	config: "config",
 	auth: "auth",
-	vault: "vault"
+	vault: "vault",
+	telemetry: "telemetry"
 };
 const topLevelCommandNames = [
 	cliCommands.serve,
@@ -74,6 +76,7 @@ const topLevelCommandNames = [
 	cliCommands.config,
 	cliCommands.auth,
 	cliCommands.vault,
+	cliCommands.telemetry,
 	cliCommands.completion
 ];
 const cliSubcommands = {
@@ -117,6 +120,14 @@ const cliSubcommands = {
 		"pi",
 		"mcp-client"
 	],
+	[cliCommands.telemetry]: [
+		"status",
+		"enable",
+		"disable",
+		"delete-id",
+		"rotate-id",
+		"debug"
+	],
 	[cliCommands.vault]: [
 		"set",
 		"get",

package/dist/config/paths.d.ts

@@ -5,17 +5,26 @@ export declare function defaultStateBaseDir(env?: PathEnv, home?: string, platfo
 export declare function defaultCacheBaseDir(env?: PathEnv, home?: string, platform?: Platform): string;
 export declare function defaultConfigPath(env?: PathEnv, home?: string, platform?: Platform): string;
 export declare function defaultAuthDir(env?: PathEnv, home?: string, platform?: Platform): string;
+export declare function defaultTelemetryStateDir(env?: PathEnv, home?: string, platform?: Platform): string;
+export declare function defaultTelemetryIdentityPath(env?: PathEnv, home?: string, platform?: Platform): string;
+export declare function defaultTelemetryNoticePath(env?: PathEnv, home?: string, platform?: Platform): string;
+export declare function defaultTelemetryDeliveryHealthPath(env?: PathEnv, home?: string, platform?: Platform): string;
 export declare function defaultArtifactDir(env?: PathEnv, home?: string, platform?: Platform): string;
 export declare function defaultCompletionCacheDir(env?: PathEnv, home?: string, platform?: Platform): string;
 export declare function defaultObservedOutputShapeCacheDir(env?: PathEnv, home?: string, platform?: Platform): string;
 export declare const DEFAULT_CONFIG_PATH: string;
 export declare const DEFAULT_AUTH_DIR: string;
 export declare const DEFAULT_ARTIFACT_DIR: string;
+export declare const DEFAULT_TELEMETRY_STATE_DIR: string;
+export declare const DEFAULT_TELEMETRY_IDENTITY_PATH: string;
+export declare const DEFAULT_TELEMETRY_NOTICE_PATH: string;
+export declare const DEFAULT_TELEMETRY_DELIVERY_HEALTH_PATH: string;
 export declare const DEFAULT_COMPLETION_CACHE_DIR: string;
 export declare const DEFAULT_OBSERVED_OUTPUT_SHAPE_CACHE_DIR: string;
 export declare const PROJECT_CONFIG_FILE: string;
 export declare function resolveConfigPath(path?: string): string;
 export declare function resolveProjectConfigPath(cwd?: string): string;
 export declare function resolveCapletsRoot(configPath?: string): string;
+export declare function resolveTelemetryStateDir(path?: string): string;
 export declare function resolveProjectCapletsRoot(cwd?: string): string;
 export {};

package/dist/config.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { FileVaultStore, type VaultConfigOrigin } from "./vault";
-export { DEFAULT_AUTH_DIR, DEFAULT_COMPLETION_CACHE_DIR, DEFAULT_CONFIG_PATH, PROJECT_CONFIG_FILE, defaultCacheBaseDir, defaultCompletionCacheDir, resolveCapletsRoot, resolveConfigPath, resolveProjectCapletsRoot, resolveProjectConfigPath, } from "./config/paths";
+export { DEFAULT_AUTH_DIR, DEFAULT_COMPLETION_CACHE_DIR, DEFAULT_CONFIG_PATH, DEFAULT_TELEMETRY_STATE_DIR, PROJECT_CONFIG_FILE, defaultCacheBaseDir, defaultCompletionCacheDir, defaultTelemetryStateDir, resolveCapletsRoot, resolveConfigPath, resolveProjectCapletsRoot, resolveProjectConfigPath, resolveTelemetryStateDir, } from "./config/paths";
 export type RemoteAuthConfig = {
     type: "none";
 } | {
@@ -281,6 +281,7 @@ export type CompletionConfig = {
 };
 export type CapletsConfig = {
     version: 1;
+    telemetry?: boolean | undefined;
     options: CapletsOptions;
     namespaceAliases: NamespaceAliasesConfig;
     mcpServers: Record<string, CapletServerConfig>;
@@ -338,6 +339,7 @@ export declare const configFileSchema: z.ZodObject<{
     version: z.ZodDefault<z.ZodLiteral<1>>;
     defaultSearchLimit: z.ZodDefault<z.ZodNumber>;
     maxSearchLimit: z.ZodDefault<z.ZodNumber>;
+    telemetry: z.ZodOptional<z.ZodBoolean>;
     completion: z.ZodDefault<z.ZodObject<{
         discoveryTimeoutMs: z.ZodDefault<z.ZodNumber>;
         overallTimeoutMs: z.ZodDefault<z.ZodNumber>;

package/dist/engine.d.ts

@@ -1,6 +1,8 @@
 import { type CapletConfig, type CapletsConfig, type LocalOverlayConfigWarning } from "./config";
 import { type ObservedOutputShapeKey, type ObservedOutputShapeStore } from "./observed-output-shapes";
 import { type ExposureSnapshot } from "./exposure/discovery";
+import { type RuntimeMode } from "./telemetry";
+import type { TelemetryDebugSink, TelemetryDispatcher, TelemetrySurface, TelemetryVisibility } from "./telemetry";
 export type CapletsEngineOptions = {
     configPath?: string;
     projectConfigPath?: string;
@@ -18,6 +20,14 @@ export type CapletsEngineOptions = {
     observedOutputShapeCacheDir?: string | undefined;
     projectFingerprint?: string | undefined;
     vaultRecoveryTarget?: "global" | "remote" | undefined;
+    telemetryStateDir?: string | undefined;
+    telemetryEnv?: NodeJS.ProcessEnv | undefined;
+    telemetrySurface?: TelemetrySurface | undefined;
+    telemetryVisibility?: TelemetryVisibility | undefined;
+    telemetryRuntimeMode?: RuntimeMode | undefined;
+    telemetryIntegration?: "opencode" | "pi" | "native" | "unknown" | undefined;
+    telemetryDebugSink?: TelemetryDebugSink | undefined;
+    telemetryDispatcher?: TelemetryDispatcher | undefined;
 };
 export type CapletsEngineReloadEvent = {
     previous: CapletsConfig;
@@ -41,6 +51,8 @@ export declare class CapletsEngine {
     private readonly observedOutputShapeStore;
     private readonly observedOutputShapeScope;
     private readonly projectFingerprint;
+    private readonly telemetry;
+    private readonly telemetryExecuteExposureMode;
     private readonly reloadListeners;
     private lastExposureSnapshot;
     private watchers;
@@ -65,6 +77,10 @@ export declare class CapletsEngine {
     readDirectResource(serverId: string, downstreamUri: string): Promise<unknown>;
     getDirectPrompt(serverId: string, promptName: string, args: Record<string, unknown>): Promise<unknown>;
     completeCliWords(words: string[]): Promise<string[]>;
+    captureCodeModeOutcome(envelope: unknown, options: {
+        started: number;
+        timeoutMs?: number | undefined;
+    }): Promise<void>;
     close(): Promise<void>;
     private listCompletionTools;
     private listTools;
@@ -80,4 +96,6 @@ export declare class CapletsEngine {
     private watchEntry;
     private watchDirectoryTree;
     private scheduleWatcherRefresh;
+    private captureReliabilityError;
+    private captureToolActivation;
 }