@latitude-data/openclaw-telemetry 0.0.1

package/dist/plugin.d.ts

@@ -0,0 +1,117 @@
+//#region src/config.d.ts
+interface Config {
+  apiKey: string;
+  baseUrl: string;
+  project: string;
+  enabled: boolean;
+  debug: boolean;
+}
+//#endregion
+//#region src/logger.d.ts
+interface Logger {
+  debug: (msg: string) => void;
+  warn: (msg: string) => void;
+}
+//#endregion
+//#region src/types.d.ts
+interface OpenClawLlmUsage {
+  input?: number;
+  output?: number;
+  cacheRead?: number;
+  cacheWrite?: number;
+  total?: number;
+}
+interface LlmCallRecord {
+  runId: string;
+  sessionId: string;
+  sessionKey: string | undefined;
+  agentId: string | undefined;
+  provider: string;
+  requestModel: string;
+  responseModel: string | undefined;
+  resolvedRef: string | undefined;
+  systemPrompt: string | undefined;
+  prompt: string;
+  historyMessages: unknown[];
+  imagesCount: number;
+  assistantTexts: string[];
+  lastAssistant: unknown;
+  usage: OpenClawLlmUsage | undefined;
+  startMs: number;
+  endMs: number | undefined;
+  error: string | undefined;
+  toolCalls: ToolCallRecord[];
+}
+interface ToolCallRecord {
+  toolCallId: string;
+  toolName: string;
+  params: Record<string, unknown>;
+  result: unknown;
+  error: string | undefined;
+  startMs: number;
+  endMs: number | undefined;
+  durationMs: number | undefined;
+  agentId: string | undefined;
+}
+interface RunRecord {
+  runId: string;
+  sessionId: string | undefined;
+  sessionKey: string | undefined;
+  agentId: string | undefined;
+  workspaceDir: string | undefined;
+  messageProvider: string | undefined;
+  trigger: string | undefined;
+  channelId: string | undefined;
+  modelProviderId: string | undefined;
+  modelId: string | undefined;
+  startMs: number;
+  endMs: number | undefined;
+  success: boolean | undefined;
+  error: string | undefined;
+  llmCalls: LlmCallRecord[];
+  /**
+   * Tool calls queued by `before_tool_call` but not yet matched to an `llm_call`
+   * because the most recent `llm_output` has already closed the call for this
+   * runId. Retained so `after_tool_call` can still complete the record.
+   */
+  orphanTools: ToolCallRecord[];
+}
+//#endregion
+//#region src/plugin.d.ts
+/**
+ * Minimal structural type for OpenClaw's plugin API — only the fields we
+ * touch. We avoid importing from `openclaw/plugin-sdk` so the package stays
+ * usable when OpenClaw isn't installed (the CLI and tests don't need it),
+ * and so we're robust to small signature changes across OpenClaw versions.
+ */
+interface OpenClawPluginApiLike {
+  logger?: Logger;
+  on: <K extends string>(hookName: K, handler: (event: unknown, ctx: unknown) => unknown, opts?: {
+    priority?: number;
+  }) => void;
+}
+interface RegisterOptions {
+  /** Override the config, mostly for tests. */
+  config?: Config;
+  /** Override the logger. */
+  logger?: Logger;
+  /**
+   * Hook to observe the emitted run right before it's posted. Used by tests;
+   * not a stable public API.
+   */
+  onEmit?: (run: RunRecord) => void;
+}
+/**
+ * Register the Latitude plugin against an OpenClaw plugin API. OpenClaw calls
+ * this once at plugin activation; we wire up `llm_input`, `llm_output`, tool
+ * and lifecycle hooks to stream traces to Latitude.
+ *
+ * Every handler is fire-and-forget on OpenClaw's side (see
+ * `src/plugins/hooks.ts` — runLlmInput/runLlmOutput are documented as
+ * parallel and wrapped with `.catch()` at the call site in attempt.ts), so
+ * nothing we do here can slow the agent loop.
+ */
+declare function registerLatitudePlugin(api: OpenClawPluginApiLike, opts?: RegisterOptions): void;
+//#endregion
+export { OpenClawPluginApiLike, RegisterOptions, registerLatitudePlugin as default };
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","names":[],"sources":["../src/config.ts","../src/logger.ts","../src/types.ts","../src/plugin.ts"],"mappings":";UAAiB,MAAA;EACf,MAAA;EACA,OAAA;EACA,OAAA;EACA,OAAA;EACA,KAAA;AAAA;;;UCHe,MAAA;EACf,KAAA,GAAQ,GAAA;EACR,IAAA,GAAO,GAAA;AAAA;;;UCwDQ,gBAAA;EACf,KAAA;EACA,MAAA;EACA,SAAA;EACA,UAAA;EACA,KAAA;AAAA;AAAA,UA4De,aAAA;EACf,KAAA;EACA,SAAA;EACA,UAAA;EACA,OAAA;EACA,QAAA;EACA,YAAA;EACA,aAAA;EACA,WAAA;EACA,YAAA;EACA,MAAA;EACA,eAAA;EACA,WAAA;EACA,cAAA;EACA,aAAA;EACA,KAAA,EAAO,gBAAA;EACP,OAAA;EACA,KAAA;EACA,KAAA;EACA,SAAA,EAAW,cAAA;AAAA;AAAA,UAGI,cAAA;EACf,UAAA;EACA,QAAA;EACA,MAAA,EAAQ,MAAA;EACR,MAAA;EACA,KAAA;EACA,OAAA;EACA,KAAA;EACA,UAAA;EACA,OAAA;AAAA;AAAA,UAGe,SAAA;EACf,KAAA;EACA,SAAA;EACA,UAAA;EACA,OAAA;EACA,YAAA;EACA,eAAA;EACA,OAAA;EACA,SAAA;EACA,eAAA;EACA,OAAA;EACA,OAAA;EACA,KAAA;EACA,OAAA;EACA,KAAA;EACA,QAAA,EAAU,aAAA;;;;;;EAMV,WAAA,EAAa,cAAA;AAAA;;;;;;;;;UC9JE,qBAAA;EACf,MAAA,GAAS,MAAA;EACT,EAAA,qBACE,QAAA,EAAU,CAAA,EACV,OAAA,GAAU,KAAA,WAAgB,GAAA,uBAC1B,IAAA;IAAS,QAAA;EAAA;AAAA;AAAA,UAII,eAAA;EF7BM;EE+BrB,MAAA,GAAS,MAAA;EF/BY;EEiCrB,MAAA,GAAS,MAAA;EFhCD;;;;EEqCR,MAAA,IAAU,GAAA,EAAK,SAAA;AAAA;;;ADoBjB;;;;;;;;iBCPwB,sBAAA,CAAuB,GAAA,EAAK,qBAAA,EAAuB,IAAA,GAAM,eAAA"}