@raindrop-ai/claude-code 0.0.18 → 0.0.20

package/dist/index.d.cts

@@ -35,6 +35,69 @@ type SpanIds = {
     spanIdB64: string;
     parentSpanIdB64?: string;
 };
+/** Kept structural so public integration declarations do not depend on private schemas. */
+type AppGitOptions = {
+    commitSha?: string | null;
+    commitDirty?: boolean | null;
+    branch?: string | null;
+    detectBranch?: boolean;
+    sourceDirectory?: string;
+    autoDetect?: boolean;
+};
+type AppGitSnapshot = Readonly<Record<string, unknown>>;
+type AppGitEnvironment = Readonly<Record<string, string | undefined>>;
+type AppGitLocalResult = {
+    commitSha?: string;
+    commitDirty?: boolean;
+    branch?: string;
+};
+type AppGitOperationOwner = string;
+type AppGitLocalResolver = (sourceDirectory: string | undefined, detectBranch: boolean, completed: (result: AppGitLocalResult) => void) => () => void;
+/** One client owns its defaults; operation snapshots never wait for discovery. */
+declare class AppGitContextImpl {
+    private defaults;
+    private explicit;
+    private explicitKeys;
+    private cancel;
+    private disposed;
+    private operations;
+    private operationOverflow;
+    private detectBranch;
+    private replayBranch;
+    private disabled;
+    constructor(options: AppGitOptions | false | undefined, runtime?: {
+        allowLocalGit?: boolean;
+        resolveLocal?: AppGitLocalResolver;
+        env?: AppGitEnvironment;
+        captureLegacyReplayBranch?: boolean;
+        allowDiscovery?: boolean;
+    });
+    private accept;
+    snapshot(properties?: Readonly<Record<string, unknown>>): AppGitSnapshot;
+    /** Safe defaults when no operation/span start was observed; never infer identity. */
+    snapshotExplicit(properties?: Readonly<Record<string, unknown>>, eventId?: string): AppGitSnapshot;
+    /** Existing replay branch reporting stays separate from opt-in event properties. */
+    snapshotForReplay(): AppGitSnapshot;
+    /** Merge a frozen span snapshot without losing client-authored provenance. */
+    mergeSnapshot(base: AppGitSnapshot, properties?: Readonly<Record<string, unknown>>, explicitKeys?: ReadonlySet<string>): AppGitSnapshot;
+    /** Shippers belonging to one client share this bounded operation registry. */
+    forOperation(eventId: string | undefined, properties?: Readonly<Record<string, unknown>>, owner?: AppGitOperationOwner): AppGitSnapshot;
+    releaseOperation(eventId: string, owner: AppGitOperationOwner): void;
+    finishOperation(eventId: string): void;
+    dispose(): void;
+}
+/** Structural at package boundaries: public SDK bundles contain independent copies of core. */
+type AppGitContext = Pick<AppGitContextImpl, "snapshot" | "snapshotForReplay" | "forOperation" | "finishOperation" | "dispose"> & {
+    snapshotExplicit?: AppGitContextImpl["snapshotExplicit"];
+    mergeSnapshot?: AppGitContextImpl["mergeSnapshot"];
+    releaseOperation?: (eventId: string, owner: AppGitOperationOwner) => void;
+};
+declare const AppGitContext: typeof AppGitContextImpl;
+declare function createAppGitContext(options?: AppGitOptions | false, runtime?: {
+    allowLocalGit?: boolean;
+    captureLegacyReplayBranch?: boolean;
+    allowDiscovery?: boolean;
+}): AppGitContext;
 type Attachment = {
     type: string;
     role: string;
@@ -45,6 +108,10 @@ type IdentifyInput = {
     userId: string;
     traits?: Record<string, unknown>;
 };
+type EventUsage = {
+    promptTokens?: number;
+    completionTokens?: number;
+};
 type Patch = {
     eventName?: string;
     userId?: string;
@@ -52,7 +119,10 @@ type Patch = {
     input?: string;
     output?: string;
     model?: string;
+    usage?: EventUsage;
+    error?: unknown;
     properties?: Record<string, unknown>;
+    featureFlags?: Record<string, string>;
     attachments?: Attachment[];
     isPending?: boolean;
     timestamp?: string;
@@ -69,6 +139,9 @@ type SignalInput = {
     after?: string;
 };
 type EventShipperOptions = {
+    appGit?: AppGitOptions | false;
+    /** Share with the trace shipper so one operation uses one source snapshot. */
+    appGitContext?: AppGitContext;
     writeKey?: string;
     endpoint?: string;
     enabled?: boolean;
@@ -100,6 +173,9 @@ type EventShipperOptions = {
     maxTextFieldChars?: number;
 };
 declare class EventShipper$1 {
+    private appGitContext;
+    private ownsAppGitContext;
+    private readonly appGitOwner;
     private baseUrl;
     private writeKey?;
     private enabled;
@@ -130,6 +206,7 @@ declare class EventShipper$1 {
     /** URL of the local debugger / Workshop daemon, when one is reachable. */
     private localDebuggerUrl;
     constructor(opts: EventShipperOptions);
+    protected ownAppGitContextForShutdown(): void;
     isDebugEnabled(): boolean;
     private authHeaders;
     private requestHeaders;
@@ -149,12 +226,7 @@ declare class EventShipper$1 {
      */
     private requestOpts;
     patch(eventId: string, patch: Patch): Promise<void>;
-    finish(eventId: string, patch: {
-        output?: string;
-        model?: string;
-        properties?: Record<string, unknown>;
-        userId?: string;
-    }): Promise<void>;
+    finish(eventId: string, patch: Pick<Patch, "output" | "model" | "usage" | "error" | "properties" | "featureFlags" | "userId">): Promise<void>;
     flush(): Promise<void>;
     shutdown(): Promise<void>;
     trackSignal(signal: SignalInput): Promise<void>;
@@ -188,6 +260,8 @@ type InternalSpan = {
     attributes: Array<OtlpKeyValue | undefined>;
 };
 type TraceShipperOptions = {
+    appGit?: AppGitOptions | false;
+    appGitContext?: AppGitContext;
     writeKey?: string;
     endpoint?: string;
     enabled?: boolean;
@@ -256,6 +330,13 @@ type TraceShipperOptions = {
     maxTextFieldChars?: number;
 };
 declare class TraceShipper$1 {
+    private appGitContext;
+    protected ownsAppGitContext: boolean;
+    private readonly appGitOwner;
+    private appGitEventIds;
+    private appGitActiveSpans;
+    private appGitCaptured;
+    private appGitAdded;
     private baseUrl;
     private writeKey?;
     private enabled;
@@ -327,6 +408,9 @@ declare class TraceShipper$1 {
             spanIdB64: string;
         };
         eventId: string;
+        userId?: string;
+        convoId?: string;
+        eventName?: string;
         operationId?: string;
         attributes?: Array<OtlpKeyValue | undefined>;
         startTimeUnixNano?: string;
@@ -345,6 +429,9 @@ declare class TraceShipper$1 {
             spanIdB64: string;
         };
         eventId: string;
+        userId?: string;
+        convoId?: string;
+        eventName?: string;
         startTimeUnixNano: string;
         endTimeUnixNano: string;
         attributes?: Array<OtlpKeyValue | undefined>;
@@ -428,6 +515,14 @@ declare class TraceShipper extends TraceShipper$1 {
     enqueue(span: OtlpSpan): void;
 }
 
+type AppGitFileOptions = {
+    commit_sha?: string | null;
+    commit_dirty?: boolean | null;
+    branch?: string | null;
+    detect_branch?: boolean;
+    source_directory?: string;
+    auto_detect?: boolean;
+};
 interface SelfDiagnosticsSignalDef {
     description: string;
     sentiment?: "POSITIVE" | "NEGATIVE";
@@ -447,6 +542,7 @@ interface ConfigFile {
     event_name?: string;
     custom_properties?: Record<string, unknown>;
     self_diagnostics?: SelfDiagnosticsConfig;
+    app_git?: AppGitFileOptions | false;
 }
 interface RaindropConfig {
     writeKey: string;
@@ -465,6 +561,8 @@ interface RaindropConfig {
     eventName: string;
     customProperties: Record<string, unknown>;
     selfDiagnostics?: SelfDiagnosticsConfig;
+    /** Application Git identity override. false disables enrichment. */
+    appGit?: AppGitOptions | false;
 }
 /**
  * Load config with precedence (low -> high):
@@ -525,7 +623,7 @@ declare function mapHookToRaindrop(payload: HookPayload, config: MapperConfig, e
 declare function extractAppendSystemPrompt(args: string[]): string | undefined;
 
 declare const PACKAGE_NAME = "@raindrop-ai/claude-code";
-declare const PACKAGE_VERSION = "0.0.13";
+declare const PACKAGE_VERSION: string;
 
 /** A tool call extracted from an assistant message content block. */
 interface LLMToolCall {
@@ -619,9 +717,11 @@ interface LocalDebuggerResult {
 declare function detectLocalDebugger(debug: boolean): Promise<LocalDebuggerResult>;
 /**
  * Mirror an event payload to the local debugger's track_partial endpoint.
- * Fire-and-forget — errors are silently swallowed.
+ * Must be awaited: Claude Code hooks call process.exit as soon as handleHook
+ * returns, so a fire-and-forget fetch is killed before it leaves the socket.
+ * Errors are swallowed — observability must never fail the hook.
  */
-declare function mirrorEventToLocalDebugger(baseUrl: string, payload: Record<string, unknown>, debug: boolean): void;
+declare function mirrorEventToLocalDebugger(baseUrl: string, payload: Record<string, unknown>, debug: boolean): Promise<void>;
 
 interface ResolvedSignal {
     description: string;
@@ -677,4 +777,4 @@ declare const TOOL_SCHEMA: {
 };
 declare function startMcpServer(): Promise<void>;
 
-export { DEFAULT_CATEGORY_KEYS, EventShipper, type HookPayload, type LLMCallPhase, type LLMToolCall, type LocalDebuggerResult, type MapperConfig, PACKAGE_NAME, PACKAGE_VERSION, type RaindropConfig, type SelfDiagnosticsConfig, type SelfDiagnosticsSignalDef, type SetupScope, TOOL_SCHEMA, TraceShipper, type TranscriptSummary, detectLocalDebugger, executeTool, extractAppendSystemPrompt, getConfigPath, loadConfig, mapHookToRaindrop, mirrorEventToLocalDebugger, normalizeSignals, parseTranscript, resolveCurrentEventId, resolveToolConfig, startMcpServer, transcriptToProperties, updateConfig };
+export { type AppGitOptions, DEFAULT_CATEGORY_KEYS, EventShipper, type HookPayload, type LLMCallPhase, type LLMToolCall, type LocalDebuggerResult, type MapperConfig, PACKAGE_NAME, PACKAGE_VERSION, type RaindropConfig, type SelfDiagnosticsConfig, type SelfDiagnosticsSignalDef, type SetupScope, TOOL_SCHEMA, TraceShipper, type TranscriptSummary, createAppGitContext, detectLocalDebugger, executeTool, extractAppendSystemPrompt, getConfigPath, loadConfig, mapHookToRaindrop, mirrorEventToLocalDebugger, normalizeSignals, parseTranscript, resolveCurrentEventId, resolveToolConfig, startMcpServer, transcriptToProperties, updateConfig };

package/dist/index.d.ts

@@ -35,6 +35,69 @@ type SpanIds = {
     spanIdB64: string;
     parentSpanIdB64?: string;
 };
+/** Kept structural so public integration declarations do not depend on private schemas. */
+type AppGitOptions = {
+    commitSha?: string | null;
+    commitDirty?: boolean | null;
+    branch?: string | null;
+    detectBranch?: boolean;
+    sourceDirectory?: string;
+    autoDetect?: boolean;
+};
+type AppGitSnapshot = Readonly<Record<string, unknown>>;
+type AppGitEnvironment = Readonly<Record<string, string | undefined>>;
+type AppGitLocalResult = {
+    commitSha?: string;
+    commitDirty?: boolean;
+    branch?: string;
+};
+type AppGitOperationOwner = string;
+type AppGitLocalResolver = (sourceDirectory: string | undefined, detectBranch: boolean, completed: (result: AppGitLocalResult) => void) => () => void;
+/** One client owns its defaults; operation snapshots never wait for discovery. */
+declare class AppGitContextImpl {
+    private defaults;
+    private explicit;
+    private explicitKeys;
+    private cancel;
+    private disposed;
+    private operations;
+    private operationOverflow;
+    private detectBranch;
+    private replayBranch;
+    private disabled;
+    constructor(options: AppGitOptions | false | undefined, runtime?: {
+        allowLocalGit?: boolean;
+        resolveLocal?: AppGitLocalResolver;
+        env?: AppGitEnvironment;
+        captureLegacyReplayBranch?: boolean;
+        allowDiscovery?: boolean;
+    });
+    private accept;
+    snapshot(properties?: Readonly<Record<string, unknown>>): AppGitSnapshot;
+    /** Safe defaults when no operation/span start was observed; never infer identity. */
+    snapshotExplicit(properties?: Readonly<Record<string, unknown>>, eventId?: string): AppGitSnapshot;
+    /** Existing replay branch reporting stays separate from opt-in event properties. */
+    snapshotForReplay(): AppGitSnapshot;
+    /** Merge a frozen span snapshot without losing client-authored provenance. */
+    mergeSnapshot(base: AppGitSnapshot, properties?: Readonly<Record<string, unknown>>, explicitKeys?: ReadonlySet<string>): AppGitSnapshot;
+    /** Shippers belonging to one client share this bounded operation registry. */
+    forOperation(eventId: string | undefined, properties?: Readonly<Record<string, unknown>>, owner?: AppGitOperationOwner): AppGitSnapshot;
+    releaseOperation(eventId: string, owner: AppGitOperationOwner): void;
+    finishOperation(eventId: string): void;
+    dispose(): void;
+}
+/** Structural at package boundaries: public SDK bundles contain independent copies of core. */
+type AppGitContext = Pick<AppGitContextImpl, "snapshot" | "snapshotForReplay" | "forOperation" | "finishOperation" | "dispose"> & {
+    snapshotExplicit?: AppGitContextImpl["snapshotExplicit"];
+    mergeSnapshot?: AppGitContextImpl["mergeSnapshot"];
+    releaseOperation?: (eventId: string, owner: AppGitOperationOwner) => void;
+};
+declare const AppGitContext: typeof AppGitContextImpl;
+declare function createAppGitContext(options?: AppGitOptions | false, runtime?: {
+    allowLocalGit?: boolean;
+    captureLegacyReplayBranch?: boolean;
+    allowDiscovery?: boolean;
+}): AppGitContext;
 type Attachment = {
     type: string;
     role: string;
@@ -45,6 +108,10 @@ type IdentifyInput = {
     userId: string;
     traits?: Record<string, unknown>;
 };
+type EventUsage = {
+    promptTokens?: number;
+    completionTokens?: number;
+};
 type Patch = {
     eventName?: string;
     userId?: string;
@@ -52,7 +119,10 @@ type Patch = {
     input?: string;
     output?: string;
     model?: string;
+    usage?: EventUsage;
+    error?: unknown;
     properties?: Record<string, unknown>;
+    featureFlags?: Record<string, string>;
     attachments?: Attachment[];
     isPending?: boolean;
     timestamp?: string;
@@ -69,6 +139,9 @@ type SignalInput = {
     after?: string;
 };
 type EventShipperOptions = {
+    appGit?: AppGitOptions | false;
+    /** Share with the trace shipper so one operation uses one source snapshot. */
+    appGitContext?: AppGitContext;
     writeKey?: string;
     endpoint?: string;
     enabled?: boolean;
@@ -100,6 +173,9 @@ type EventShipperOptions = {
     maxTextFieldChars?: number;
 };
 declare class EventShipper$1 {
+    private appGitContext;
+    private ownsAppGitContext;
+    private readonly appGitOwner;
     private baseUrl;
     private writeKey?;
     private enabled;
@@ -130,6 +206,7 @@ declare class EventShipper$1 {
     /** URL of the local debugger / Workshop daemon, when one is reachable. */
     private localDebuggerUrl;
     constructor(opts: EventShipperOptions);
+    protected ownAppGitContextForShutdown(): void;
     isDebugEnabled(): boolean;
     private authHeaders;
     private requestHeaders;
@@ -149,12 +226,7 @@ declare class EventShipper$1 {
      */
     private requestOpts;
     patch(eventId: string, patch: Patch): Promise<void>;
-    finish(eventId: string, patch: {
-        output?: string;
-        model?: string;
-        properties?: Record<string, unknown>;
-        userId?: string;
-    }): Promise<void>;
+    finish(eventId: string, patch: Pick<Patch, "output" | "model" | "usage" | "error" | "properties" | "featureFlags" | "userId">): Promise<void>;
     flush(): Promise<void>;
     shutdown(): Promise<void>;
     trackSignal(signal: SignalInput): Promise<void>;
@@ -188,6 +260,8 @@ type InternalSpan = {
     attributes: Array<OtlpKeyValue | undefined>;
 };
 type TraceShipperOptions = {
+    appGit?: AppGitOptions | false;
+    appGitContext?: AppGitContext;
     writeKey?: string;
     endpoint?: string;
     enabled?: boolean;
@@ -256,6 +330,13 @@ type TraceShipperOptions = {
     maxTextFieldChars?: number;
 };
 declare class TraceShipper$1 {
+    private appGitContext;
+    protected ownsAppGitContext: boolean;
+    private readonly appGitOwner;
+    private appGitEventIds;
+    private appGitActiveSpans;
+    private appGitCaptured;
+    private appGitAdded;
     private baseUrl;
     private writeKey?;
     private enabled;
@@ -327,6 +408,9 @@ declare class TraceShipper$1 {
             spanIdB64: string;
         };
         eventId: string;
+        userId?: string;
+        convoId?: string;
+        eventName?: string;
         operationId?: string;
         attributes?: Array<OtlpKeyValue | undefined>;
         startTimeUnixNano?: string;
@@ -345,6 +429,9 @@ declare class TraceShipper$1 {
             spanIdB64: string;
         };
         eventId: string;
+        userId?: string;
+        convoId?: string;
+        eventName?: string;
         startTimeUnixNano: string;
         endTimeUnixNano: string;
         attributes?: Array<OtlpKeyValue | undefined>;
@@ -428,6 +515,14 @@ declare class TraceShipper extends TraceShipper$1 {
     enqueue(span: OtlpSpan): void;
 }
 
+type AppGitFileOptions = {
+    commit_sha?: string | null;
+    commit_dirty?: boolean | null;
+    branch?: string | null;
+    detect_branch?: boolean;
+    source_directory?: string;
+    auto_detect?: boolean;
+};
 interface SelfDiagnosticsSignalDef {
     description: string;
     sentiment?: "POSITIVE" | "NEGATIVE";
@@ -447,6 +542,7 @@ interface ConfigFile {
     event_name?: string;
     custom_properties?: Record<string, unknown>;
     self_diagnostics?: SelfDiagnosticsConfig;
+    app_git?: AppGitFileOptions | false;
 }
 interface RaindropConfig {
     writeKey: string;
@@ -465,6 +561,8 @@ interface RaindropConfig {
     eventName: string;
     customProperties: Record<string, unknown>;
     selfDiagnostics?: SelfDiagnosticsConfig;
+    /** Application Git identity override. false disables enrichment. */
+    appGit?: AppGitOptions | false;
 }
 /**
  * Load config with precedence (low -> high):
@@ -525,7 +623,7 @@ declare function mapHookToRaindrop(payload: HookPayload, config: MapperConfig, e
 declare function extractAppendSystemPrompt(args: string[]): string | undefined;
 
 declare const PACKAGE_NAME = "@raindrop-ai/claude-code";
-declare const PACKAGE_VERSION = "0.0.13";
+declare const PACKAGE_VERSION: string;
 
 /** A tool call extracted from an assistant message content block. */
 interface LLMToolCall {
@@ -619,9 +717,11 @@ interface LocalDebuggerResult {
 declare function detectLocalDebugger(debug: boolean): Promise<LocalDebuggerResult>;
 /**
  * Mirror an event payload to the local debugger's track_partial endpoint.
- * Fire-and-forget — errors are silently swallowed.
+ * Must be awaited: Claude Code hooks call process.exit as soon as handleHook
+ * returns, so a fire-and-forget fetch is killed before it leaves the socket.
+ * Errors are swallowed — observability must never fail the hook.
  */
-declare function mirrorEventToLocalDebugger(baseUrl: string, payload: Record<string, unknown>, debug: boolean): void;
+declare function mirrorEventToLocalDebugger(baseUrl: string, payload: Record<string, unknown>, debug: boolean): Promise<void>;
 
 interface ResolvedSignal {
     description: string;
@@ -677,4 +777,4 @@ declare const TOOL_SCHEMA: {
 };
 declare function startMcpServer(): Promise<void>;
 
-export { DEFAULT_CATEGORY_KEYS, EventShipper, type HookPayload, type LLMCallPhase, type LLMToolCall, type LocalDebuggerResult, type MapperConfig, PACKAGE_NAME, PACKAGE_VERSION, type RaindropConfig, type SelfDiagnosticsConfig, type SelfDiagnosticsSignalDef, type SetupScope, TOOL_SCHEMA, TraceShipper, type TranscriptSummary, detectLocalDebugger, executeTool, extractAppendSystemPrompt, getConfigPath, loadConfig, mapHookToRaindrop, mirrorEventToLocalDebugger, normalizeSignals, parseTranscript, resolveCurrentEventId, resolveToolConfig, startMcpServer, transcriptToProperties, updateConfig };
+export { type AppGitOptions, DEFAULT_CATEGORY_KEYS, EventShipper, type HookPayload, type LLMCallPhase, type LLMToolCall, type LocalDebuggerResult, type MapperConfig, PACKAGE_NAME, PACKAGE_VERSION, type RaindropConfig, type SelfDiagnosticsConfig, type SelfDiagnosticsSignalDef, type SetupScope, TOOL_SCHEMA, TraceShipper, type TranscriptSummary, createAppGitContext, detectLocalDebugger, executeTool, extractAppendSystemPrompt, getConfigPath, loadConfig, mapHookToRaindrop, mirrorEventToLocalDebugger, normalizeSignals, parseTranscript, resolveCurrentEventId, resolveToolConfig, startMcpServer, transcriptToProperties, updateConfig };