@openhands/agent-canvas 1.13.0 → 1.14.0

package/dist/stores/error-message-store.d.ts

@@ -1,3 +1,4 @@
+import type { ErrorClassification } from "@openhands/typescript-client";
 /**
  * "connection" errors auto-clear once connectivity recovers; "conversation"
  * errors (e.g. a wrong API key) are sticky and clear only on an explicit user
@@ -13,9 +14,10 @@ interface ErrorMessageState {
      * null for errors that carry no code (connection errors, plain strings).
      */
     errorCode: string | null;
+    errorClassification: ErrorClassification | null;
 }
 interface ErrorMessageActions {
-    setErrorMessage: (message: string, type?: ErrorMessageType, code?: string | null) => void;
+    setErrorMessage: (message: string, type?: ErrorMessageType, code?: string | null, classification?: ErrorClassification | null) => void;
     removeErrorMessage: () => void;
     /** Clears the error only when it is a transient connection error. */
     clearConnectionError: () => void;

package/dist/stores/error-message-store.js

@@ -3,13 +3,15 @@ import { create as e } from "../node_modules/zustand/esm/react.js";
 var t = {
 	errorMessage: null,
 	errorType: null,
-	errorCode: null
+	errorCode: null,
+	errorClassification: null
 }, n = e((e) => ({
 	...t,
-	setErrorMessage: (t, n = "conversation", r = null) => e(() => ({
+	setErrorMessage: (t, n = "conversation", r = null, i = null) => e(() => ({
 		errorMessage: t,
 		errorType: n,
-		errorCode: r
+		errorCode: r,
+		errorClassification: i
 	})),
 	removeErrorMessage: () => e(() => ({ ...t })),
 	clearConnectionError: () => e((e) => e.errorType === "connection" ? { ...t } : e)

package/dist/stores/error-message-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"error-message-store.js","names":[],"sources":["../../src/stores/error-message-store.ts"],"sourcesContent":["import { create } from \"zustand\";\n\n/**\n * \"connection\" errors auto-clear once connectivity recovers; \"conversation\"\n * errors (e.g. a wrong API key) are sticky and clear only on an explicit user\n * action (dismiss, retry, new message).\n */\nexport type ErrorMessageType = \"connection\" | \"conversation\";\n\ninterface ErrorMessageState {\n  errorMessage: string | null;\n  errorType: ErrorMessageType | null;\n  /**\n   * Structured error code from a ConversationErrorEvent/ServerErrorEvent (e.g.\n   * \"ACPAuthRequired\"), used to render a code-specific header + recovery action.\n   * null for errors that carry no code (connection errors, plain strings).\n   */\n  errorCode: string | null;\n}\n\ninterface ErrorMessageActions {\n  setErrorMessage: (\n    message: string,\n    type?: ErrorMessageType,\n    code?: string | null,\n  ) => void;\n  removeErrorMessage: () => void;\n  /** Clears the error only when it is a transient connection error. */\n  clearConnectionError: () => void;\n}\n\ntype ErrorMessageStore = ErrorMessageState & ErrorMessageActions;\n\nconst initialState: ErrorMessageState = {\n  errorMessage: null,\n  errorType: null,\n  errorCode: null,\n};\n\nexport const useErrorMessageStore = create<ErrorMessageStore>((set) => ({\n  ...initialState,\n\n  setErrorMessage: (\n    message: string,\n    type: ErrorMessageType = \"conversation\",\n    code: string | null = null,\n  ) =>\n    set(() => ({\n      errorMessage: message,\n      errorType: type,\n      errorCode: code,\n    })),\n\n  removeErrorMessage: () => set(() => ({ ...initialState })),\n\n  clearConnectionError: () =>\n    set((state) =>\n      state.errorType === \"connection\" ? { ...initialState } : state,\n    ),\n}));\n"],"mappings":";;AAiCA,IAAM,IAAkC;CACtC,cAAc;CACd,WAAW;CACX,WAAW;AACb,GAEa,IAAuB,GAA2B,OAAS;CACtE,GAAG;CAEH,kBACE,GACA,IAAyB,gBACzB,IAAsB,SAEtB,SAAW;EACT,cAAc;EACd,WAAW;EACX,WAAW;CACb,EAAE;CAEJ,0BAA0B,SAAW,EAAE,GAAG,EAAa,EAAE;CAEzD,4BACE,GAAK,MACH,EAAM,cAAc,eAAe,EAAE,GAAG,EAAa,IAAI,CAC3D;AACJ,EAAE"}
+{"version":3,"file":"error-message-store.js","names":[],"sources":["../../src/stores/error-message-store.ts"],"sourcesContent":["import { create } from \"zustand\";\nimport type { ErrorClassification } from \"@openhands/typescript-client\";\n\n/**\n * \"connection\" errors auto-clear once connectivity recovers; \"conversation\"\n * errors (e.g. a wrong API key) are sticky and clear only on an explicit user\n * action (dismiss, retry, new message).\n */\nexport type ErrorMessageType = \"connection\" | \"conversation\";\n\ninterface ErrorMessageState {\n  errorMessage: string | null;\n  errorType: ErrorMessageType | null;\n  /**\n   * Structured error code from a ConversationErrorEvent/ServerErrorEvent (e.g.\n   * \"ACPAuthRequired\"), used to render a code-specific header + recovery action.\n   * null for errors that carry no code (connection errors, plain strings).\n   */\n  errorCode: string | null;\n  errorClassification: ErrorClassification | null;\n}\n\ninterface ErrorMessageActions {\n  setErrorMessage: (\n    message: string,\n    type?: ErrorMessageType,\n    code?: string | null,\n    classification?: ErrorClassification | null,\n  ) => void;\n  removeErrorMessage: () => void;\n  /** Clears the error only when it is a transient connection error. */\n  clearConnectionError: () => void;\n}\n\ntype ErrorMessageStore = ErrorMessageState & ErrorMessageActions;\n\nconst initialState: ErrorMessageState = {\n  errorMessage: null,\n  errorType: null,\n  errorCode: null,\n  errorClassification: null,\n};\n\nexport const useErrorMessageStore = create<ErrorMessageStore>((set) => ({\n  ...initialState,\n\n  setErrorMessage: (\n    message: string,\n    type: ErrorMessageType = \"conversation\",\n    code: string | null = null,\n    classification: ErrorClassification | null = null,\n  ) =>\n    set(() => ({\n      errorMessage: message,\n      errorType: type,\n      errorCode: code,\n      errorClassification: classification,\n    })),\n\n  removeErrorMessage: () => set(() => ({ ...initialState })),\n\n  clearConnectionError: () =>\n    set((state) =>\n      state.errorType === \"connection\" ? { ...initialState } : state,\n    ),\n}));\n"],"mappings":";;AAoCA,IAAM,IAAkC;CACtC,cAAc;CACd,WAAW;CACX,WAAW;CACX,qBAAqB;AACvB,GAEa,IAAuB,GAA2B,OAAS;CACtE,GAAG;CAEH,kBACE,GACA,IAAyB,gBACzB,IAAsB,MACtB,IAA6C,SAE7C,SAAW;EACT,cAAc;EACd,WAAW;EACX,WAAW;EACX,qBAAqB;CACvB,EAAE;CAEJ,0BAA0B,SAAW,EAAE,GAAG,EAAa,EAAE;CAEzD,4BACE,GAAK,MACH,EAAM,cAAc,eAAe,EAAE,GAAG,EAAa,IAAI,CAC3D;AACJ,EAAE"}

package/dist/types/git-sync.d.ts

@@ -0,0 +1,51 @@
+export interface GitSyncStatus {
+    enabled: boolean;
+    repo_url: string;
+    branch: string;
+    path: string;
+    encryption_enabled: boolean;
+    /** Seconds between automatic syncs; 0 means manual-only. */
+    interval_seconds: number;
+    last_synced_commit: string | null;
+    last_synced_at: string | null;
+    last_error: string | null;
+    last_error_at: string | null;
+    dirty_count: number;
+    /**
+     * Whether a sync cycle is running right now, including one the backend's own
+     * interval started. A cycle reports its outcome only once it ends, so
+     * without this the page cannot tell a sync in flight from one that never
+     * started. Absent on automation backends that predate the field.
+     */
+    sync_in_progress?: boolean;
+    sync_started_at?: string | null;
+}
+export interface GitSyncConfigUpdateRequest {
+    enabled?: boolean | null;
+    interval_seconds?: number | null;
+    repo_url?: string | null;
+    branch?: string | null;
+    path?: string | null;
+    token?: string | null;
+    encryption_key?: string | null;
+    author_name?: string | null;
+    author_email?: string | null;
+}
+export interface GitSyncTriggerResponse {
+    triggered: boolean;
+}
+/**
+ * Whether a configuration can reach its repo, from `POST /v1/git-sync/check`.
+ *
+ * `ok` is about reachability only -- the backend runs a single `git ls-remote`
+ * rather than a sync, so a token without write scope passes here and still
+ * fails at push time, and the encryption key is never exercised.
+ * `branch_exists: false` alongside `ok: true` is normal for a repo that has
+ * never been synced: the first cycle creates the branch.
+ */
+export interface GitSyncCheckResponse {
+    ok: boolean;
+    branch_exists: boolean;
+    /** git's own failure output, with credentials in the URL redacted. */
+    detail: string | null;
+}

package/dist/utils/error-handler.cjs

@@ -1,2 +1,2 @@
-require("../_virtual/_rolldown/runtime.cjs");const e=require("../services/telemetry.cjs");function t({message:t,source:n,metadata:r={}}){e.trackException(Error(t),{error_source:n||`unknown`,...r})}exports.trackError=t;
+require("../_virtual/_rolldown/runtime.cjs");const e=require("../services/telemetry.cjs");var t=new Set([`error_source`,`error_kind`,`error_id`,`error_telemetry`]);function n({source:n,metadata:r={},classification:i}){let a=Object.fromEntries(Object.entries(r).filter(([e])=>!t.has(e))),o=i?.kind||`unknown`,s=typeof r.eventId==`string`?r.eventId:void 0;s!=null&&delete a.eventId;let c=i?.error_id??s;e.trackEvent(`error_outcome`,{...a,current_url:window.location.href,error_source:n||`unknown`,error_kind:o,...c==null?{}:{error_id:c},error_telemetry:o===`internal`||o===`unknown`?`diagnostic`:`outcome`})}exports.trackError=n;
 //# sourceMappingURL=error-handler.cjs.map

package/dist/utils/error-handler.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"error-handler.cjs","names":[],"sources":["../../src/utils/error-handler.ts"],"sourcesContent":["import { trackException } from \"#/services/telemetry\";\n\ninterface ErrorDetails {\n  message: string;\n  source?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport function trackError({ message, source, metadata = {} }: ErrorDetails) {\n  const error = new Error(message);\n  void trackException(error, {\n    error_source: source || \"unknown\",\n    ...metadata,\n  });\n}\n"],"mappings":"0FAQA,SAAgB,EAAW,CAAE,UAAS,SAAQ,WAAW,CAAC,GAAmB,CAE3E,EAAK,eADa,MAAM,CACJ,EAAO,CACzB,aAAc,GAAU,UACxB,GAAG,CACL,CAAC,CACH"}
+{"version":3,"file":"error-handler.cjs","names":[],"sources":["../../src/utils/error-handler.ts"],"sourcesContent":["import { trackEvent } from \"#/services/telemetry\";\nimport type { ErrorClassification } from \"@openhands/typescript-client\";\n\ninterface ErrorDetails {\n  source?: string;\n  metadata?: Record<string, unknown>;\n  classification?: ErrorClassification | null;\n}\n\nconst RESERVED_ERROR_KEYS = new Set([\n  \"error_source\",\n  \"error_kind\",\n  \"error_id\",\n  \"error_telemetry\",\n]);\n\nexport function trackError({\n  source,\n  metadata = {},\n  classification,\n}: ErrorDetails) {\n  // Reserved outcome fields are derived from `source`/`classification` and\n  // must not be overridable through arbitrary caller metadata.\n  const extra = Object.fromEntries(\n    Object.entries(metadata).filter(([key]) => !RESERVED_ERROR_KEYS.has(key)),\n  );\n  const kind = classification?.kind || \"unknown\";\n  // Promote a caller-provided `eventId` to the reserved `error_id` dimension as\n  // a fallback so unclassified errors stay correlatable with server-side logs.\n  const promotedEventId =\n    typeof metadata.eventId === \"string\" ? metadata.eventId : undefined;\n  if (promotedEventId != null) {\n    delete extra.eventId;\n  }\n  const errorId = classification?.error_id ?? promotedEventId;\n\n  void trackEvent(\"error_outcome\", {\n    ...extra,\n    current_url: window.location.href,\n    error_source: source || \"unknown\",\n    error_kind: kind,\n    // Keep diagnostic errors correlatable without capturing raw messages.\n    ...(errorId != null ? { error_id: errorId } : {}),\n    error_telemetry:\n      kind === \"internal\" || kind === \"unknown\" ? \"diagnostic\" : \"outcome\",\n  });\n}\n"],"mappings":"0FASA,IAAM,EAAsB,IAAI,IAAI,CAClC,eACA,aACA,WACA,iBACF,CAAC,EAED,SAAgB,EAAW,CACzB,SACA,WAAW,CAAC,EACZ,kBACe,CAGf,IAAM,EAAQ,OAAO,YACnB,OAAO,QAAQ,CAAQ,EAAE,QAAQ,CAAC,KAAS,CAAC,EAAoB,IAAI,CAAG,CAAC,CAC1E,EACM,EAAO,GAAgB,MAAQ,UAG/B,EACJ,OAAO,EAAS,SAAY,SAAW,EAAS,QAAU,IAAA,GACxD,GAAmB,MACrB,OAAO,EAAM,QAEf,IAAM,EAAU,GAAgB,UAAY,EAE5C,EAAK,WAAW,gBAAiB,CAC/B,GAAG,EACH,YAAa,OAAO,SAAS,KAC7B,aAAc,GAAU,UACxB,WAAY,EAEZ,GAAI,GAAW,KAA+B,CAAC,EAAzB,CAAE,SAAU,CAAQ,EAC1C,gBACE,IAAS,YAAc,IAAS,UAAY,aAAe,SAC/D,CAAC,CACH"}

package/dist/utils/error-handler.d.ts

@@ -1,7 +1,8 @@
+import type { ErrorClassification } from "@openhands/typescript-client";
 interface ErrorDetails {
-    message: string;
     source?: string;
     metadata?: Record<string, unknown>;
+    classification?: ErrorClassification | null;
 }
-export declare function trackError({ message, source, metadata }: ErrorDetails): void;
+export declare function trackError({ source, metadata, classification, }: ErrorDetails): void;
 export {};

package/dist/utils/error-handler.js

@@ -1,12 +1,25 @@
-import { trackException as e } from "../services/telemetry.js";
+import { trackEvent as e } from "../services/telemetry.js";
 //#region src/utils/error-handler.ts
-function t({ message: t, source: n, metadata: r = {} }) {
-	e(Error(t), {
+var t = new Set([
+	"error_source",
+	"error_kind",
+	"error_id",
+	"error_telemetry"
+]);
+function n({ source: n, metadata: r = {}, classification: i }) {
+	let a = Object.fromEntries(Object.entries(r).filter(([e]) => !t.has(e))), o = i?.kind || "unknown", s = typeof r.eventId == "string" ? r.eventId : void 0;
+	s != null && delete a.eventId;
+	let c = i?.error_id ?? s;
+	e("error_outcome", {
+		...a,
+		current_url: window.location.href,
 		error_source: n || "unknown",
-		...r
+		error_kind: o,
+		...c == null ? {} : { error_id: c },
+		error_telemetry: o === "internal" || o === "unknown" ? "diagnostic" : "outcome"
 	});
 }
 //#endregion
-export { t as trackError };
+export { n as trackError };
 
 //# sourceMappingURL=error-handler.js.map

package/dist/utils/error-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"error-handler.js","names":[],"sources":["../../src/utils/error-handler.ts"],"sourcesContent":["import { trackException } from \"#/services/telemetry\";\n\ninterface ErrorDetails {\n  message: string;\n  source?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport function trackError({ message, source, metadata = {} }: ErrorDetails) {\n  const error = new Error(message);\n  void trackException(error, {\n    error_source: source || \"unknown\",\n    ...metadata,\n  });\n}\n"],"mappings":";;AAQA,SAAgB,EAAW,EAAE,YAAS,WAAQ,cAAW,CAAC,KAAmB;CAE3E,EADkB,MAAM,CACJ,GAAO;EACzB,cAAc,KAAU;EACxB,GAAG;CACL,CAAC;AACH"}
+{"version":3,"file":"error-handler.js","names":[],"sources":["../../src/utils/error-handler.ts"],"sourcesContent":["import { trackEvent } from \"#/services/telemetry\";\nimport type { ErrorClassification } from \"@openhands/typescript-client\";\n\ninterface ErrorDetails {\n  source?: string;\n  metadata?: Record<string, unknown>;\n  classification?: ErrorClassification | null;\n}\n\nconst RESERVED_ERROR_KEYS = new Set([\n  \"error_source\",\n  \"error_kind\",\n  \"error_id\",\n  \"error_telemetry\",\n]);\n\nexport function trackError({\n  source,\n  metadata = {},\n  classification,\n}: ErrorDetails) {\n  // Reserved outcome fields are derived from `source`/`classification` and\n  // must not be overridable through arbitrary caller metadata.\n  const extra = Object.fromEntries(\n    Object.entries(metadata).filter(([key]) => !RESERVED_ERROR_KEYS.has(key)),\n  );\n  const kind = classification?.kind || \"unknown\";\n  // Promote a caller-provided `eventId` to the reserved `error_id` dimension as\n  // a fallback so unclassified errors stay correlatable with server-side logs.\n  const promotedEventId =\n    typeof metadata.eventId === \"string\" ? metadata.eventId : undefined;\n  if (promotedEventId != null) {\n    delete extra.eventId;\n  }\n  const errorId = classification?.error_id ?? promotedEventId;\n\n  void trackEvent(\"error_outcome\", {\n    ...extra,\n    current_url: window.location.href,\n    error_source: source || \"unknown\",\n    error_kind: kind,\n    // Keep diagnostic errors correlatable without capturing raw messages.\n    ...(errorId != null ? { error_id: errorId } : {}),\n    error_telemetry:\n      kind === \"internal\" || kind === \"unknown\" ? \"diagnostic\" : \"outcome\",\n  });\n}\n"],"mappings":";;AASA,IAAM,IAAsB,IAAI,IAAI;CAClC;CACA;CACA;CACA;AACF,CAAC;AAED,SAAgB,EAAW,EACzB,WACA,cAAW,CAAC,GACZ,qBACe;CAGf,IAAM,IAAQ,OAAO,YACnB,OAAO,QAAQ,CAAQ,EAAE,QAAQ,CAAC,OAAS,CAAC,EAAoB,IAAI,CAAG,CAAC,CAC1E,GACM,IAAO,GAAgB,QAAQ,WAG/B,IACJ,OAAO,EAAS,WAAY,WAAW,EAAS,UAAU,KAAA;CAC5D,AAAI,KAAmB,QACrB,OAAO,EAAM;CAEf,IAAM,IAAU,GAAgB,YAAY;CAE5C,EAAgB,iBAAiB;EAC/B,GAAG;EACH,aAAa,OAAO,SAAS;EAC7B,cAAc,KAAU;EACxB,YAAY;EAEZ,GAAI,KAAW,OAA+B,CAAC,IAAzB,EAAE,UAAU,EAAQ;EAC1C,iBACE,MAAS,cAAc,MAAS,YAAY,eAAe;CAC/D,CAAC;AACH"}

package/dist/utils/format-model-name.cjs

@@ -1,2 +1,2 @@
-require("../_virtual/_rolldown/runtime.cjs");var e=`Free`,t={"openhands/glm-5.2":`OpenHands GLM-5.2 (free)`,"openhands/deepseek-v4-flash":`OpenHands DeepSeek V4 Flash (free)`,"openhands/minimax-m2.7":`OpenHands MiniMax M2.7 (free)`},n=`Free OpenHands models: ${Object.keys(t).join(`, `)}. Other provider endpoints with similar model names may require separate billing.`,r=e=>!!(e&&e in t);function i(e){return e?r(e)?t[e]:e:null}function a(e){return e?r(e)?t[e]:e.split(`/`).pop()||e:null}exports.FREE_MODEL_BADGE_LABEL=e,exports.FREE_OPENHANDS_MODEL_NOTE=n,exports.formatModelNameForDisplay=i,exports.formatNativeModelName=a,exports.isFreeOpenHandsModel=r;
+require("../_virtual/_rolldown/runtime.cjs");var e=`Free`,t={"openhands/kimi-k3":`OpenHands Kimi K3 (free)`,"openhands/glm-5.2":`OpenHands GLM-5.2 (free)`,"openhands/deepseek-v4-flash":`OpenHands DeepSeek V4 Flash (free)`,"openhands/minimax-m2.7":`OpenHands MiniMax M2.7 (free)`},n=`Free OpenHands models: ${Object.keys(t).join(`, `)}. Other provider endpoints with similar model names may require separate billing.`,r=e=>!!(e&&e in t);function i(e){return e?r(e)?t[e]:e:null}function a(e){return e?r(e)?t[e]:e.split(`/`).pop()||e:null}exports.FREE_MODEL_BADGE_LABEL=e,exports.FREE_OPENHANDS_MODEL_NOTE=n,exports.formatModelNameForDisplay=i,exports.formatNativeModelName=a,exports.isFreeOpenHandsModel=r;
 //# sourceMappingURL=format-model-name.cjs.map

package/dist/utils/format-model-name.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"format-model-name.cjs","names":[],"sources":["../../src/utils/format-model-name.ts"],"sourcesContent":["export const FREE_MODEL_BADGE_LABEL = \"Free\";\n\nexport const FREE_OPENHANDS_MODELS = {\n  \"openhands/glm-5.2\": \"OpenHands GLM-5.2 (free)\",\n  \"openhands/deepseek-v4-flash\": \"OpenHands DeepSeek V4 Flash (free)\",\n  \"openhands/minimax-m2.7\": \"OpenHands MiniMax M2.7 (free)\",\n} as const;\n\nexport const FREE_OPENHANDS_MODEL_IDS = Object.keys(FREE_OPENHANDS_MODELS);\nexport const FREE_OPENHANDS_MODEL_NOTE = `Free OpenHands models: ${FREE_OPENHANDS_MODEL_IDS.join(\n  \", \",\n)}. Other provider endpoints with similar model names may require separate billing.`;\n\nexport const isFreeOpenHandsModel = (\n  model: string | null | undefined,\n): model is keyof typeof FREE_OPENHANDS_MODELS =>\n  Boolean(model && model in FREE_OPENHANDS_MODELS);\n\nexport function formatModelNameForDisplay(\n  model: string | null | undefined,\n): string | null {\n  if (!model) return null;\n  return isFreeOpenHandsModel(model) ? FREE_OPENHANDS_MODELS[model] : model;\n}\n\nexport function formatProviderModelNameForDisplay(\n  provider: string | null | undefined,\n  model: string | null | undefined,\n): string | null {\n  if (!model) return null;\n  const fullModel = provider ? `${provider}/${model}` : model;\n  return isFreeOpenHandsModel(fullModel)\n    ? FREE_OPENHANDS_MODELS[fullModel]\n    : model;\n}\n\n/**\n * Format a native (OpenHands-kind) routing model string for display, stripping\n * the provider route prefix (e.g. ``\"anthropic/claude-sonnet-4-5-20250929\"`` →\n * ``\"claude-sonnet-4-5-20250929\"``, ``\"litellm_proxy/openai/gpt-4o\"`` →\n * ``\"gpt-4o\"``) so a conversation chip shows a meaningful model name rather than\n * the full routing path.\n *\n * Returns ``null`` for an empty/nullish input, and falls back to the original\n * string when stripping the prefix would leave nothing (e.g. a trailing slash)\n * — never an empty string, which would collapse the chip text.\n *\n * Display-only: unlike {@link deriveProfileNameFromModel} this does not sanitize\n * to an identifier, so it keeps the real model id intact for the chip.\n */\nexport function formatNativeModelName(\n  model: string | null | undefined,\n): string | null {\n  if (!model) return null;\n  if (isFreeOpenHandsModel(model)) return FREE_OPENHANDS_MODELS[model];\n  const lastSegment = model.split(\"/\").pop();\n  return lastSegment || model;\n}\n"],"mappings":"6CAAA,IAAa,EAAyB,OAEzB,EAAwB,CACnC,oBAAqB,2BACrB,8BAA+B,qCAC/B,yBAA0B,+BAC5B,EAGa,EAA4B,0BADD,OAAO,KAAK,CACe,EAAyB,KAC1F,IACF,EAAE,mFAEW,EACX,GAEA,GAAQ,GAAS,KAAS,GAE5B,SAAgB,EACd,EACe,CAEf,OADK,EACE,EAAqB,CAAK,EAAI,EAAsB,GAAS,EADjD,IAErB,CA2BA,SAAgB,EACd,EACe,CAIf,OAHK,EACD,EAAqB,CAAK,EAAU,EAAsB,GAC1C,EAAM,MAAM,GAAG,EAAE,IAC9B,GAAe,EAHH,IAIrB"}
+{"version":3,"file":"format-model-name.cjs","names":[],"sources":["../../src/utils/format-model-name.ts"],"sourcesContent":["export const FREE_MODEL_BADGE_LABEL = \"Free\";\n\nexport const FREE_OPENHANDS_MODELS = {\n  \"openhands/kimi-k3\": \"OpenHands Kimi K3 (free)\",\n  \"openhands/glm-5.2\": \"OpenHands GLM-5.2 (free)\",\n  \"openhands/deepseek-v4-flash\": \"OpenHands DeepSeek V4 Flash (free)\",\n  \"openhands/minimax-m2.7\": \"OpenHands MiniMax M2.7 (free)\",\n} as const;\n\nexport const FREE_OPENHANDS_MODEL_IDS = Object.keys(FREE_OPENHANDS_MODELS);\nexport const FREE_OPENHANDS_MODEL_NOTE = `Free OpenHands models: ${FREE_OPENHANDS_MODEL_IDS.join(\n  \", \",\n)}. Other provider endpoints with similar model names may require separate billing.`;\n\nexport const isFreeOpenHandsModel = (\n  model: string | null | undefined,\n): model is keyof typeof FREE_OPENHANDS_MODELS =>\n  Boolean(model && model in FREE_OPENHANDS_MODELS);\n\nexport function formatModelNameForDisplay(\n  model: string | null | undefined,\n): string | null {\n  if (!model) return null;\n  return isFreeOpenHandsModel(model) ? FREE_OPENHANDS_MODELS[model] : model;\n}\n\nexport function formatProviderModelNameForDisplay(\n  provider: string | null | undefined,\n  model: string | null | undefined,\n): string | null {\n  if (!model) return null;\n  const fullModel = provider ? `${provider}/${model}` : model;\n  return isFreeOpenHandsModel(fullModel)\n    ? FREE_OPENHANDS_MODELS[fullModel]\n    : model;\n}\n\n/**\n * Format a native (OpenHands-kind) routing model string for display, stripping\n * the provider route prefix (e.g. ``\"anthropic/claude-sonnet-4-5-20250929\"`` →\n * ``\"claude-sonnet-4-5-20250929\"``, ``\"litellm_proxy/openai/gpt-4o\"`` →\n * ``\"gpt-4o\"``) so a conversation chip shows a meaningful model name rather than\n * the full routing path.\n *\n * Returns ``null`` for an empty/nullish input, and falls back to the original\n * string when stripping the prefix would leave nothing (e.g. a trailing slash)\n * — never an empty string, which would collapse the chip text.\n *\n * Display-only: unlike {@link deriveProfileNameFromModel} this does not sanitize\n * to an identifier, so it keeps the real model id intact for the chip.\n */\nexport function formatNativeModelName(\n  model: string | null | undefined,\n): string | null {\n  if (!model) return null;\n  if (isFreeOpenHandsModel(model)) return FREE_OPENHANDS_MODELS[model];\n  const lastSegment = model.split(\"/\").pop();\n  return lastSegment || model;\n}\n"],"mappings":"6CAAA,IAAa,EAAyB,OAEzB,EAAwB,CACnC,oBAAqB,2BACrB,oBAAqB,2BACrB,8BAA+B,qCAC/B,yBAA0B,+BAC5B,EAGa,EAA4B,0BADD,OAAO,KAAK,CACe,EAAyB,KAC1F,IACF,EAAE,mFAEW,EACX,GAEA,GAAQ,GAAS,KAAS,GAE5B,SAAgB,EACd,EACe,CAEf,OADK,EACE,EAAqB,CAAK,EAAI,EAAsB,GAAS,EADjD,IAErB,CA2BA,SAAgB,EACd,EACe,CAIf,OAHK,EACD,EAAqB,CAAK,EAAU,EAAsB,GAC1C,EAAM,MAAM,GAAG,EAAE,IAC9B,GAAe,EAHH,IAIrB"}

package/dist/utils/format-model-name.d.ts

@@ -1,5 +1,6 @@
 export declare const FREE_MODEL_BADGE_LABEL = "Free";
 export declare const FREE_OPENHANDS_MODELS: {
+    readonly "openhands/kimi-k3": "OpenHands Kimi K3 (free)";
     readonly "openhands/glm-5.2": "OpenHands GLM-5.2 (free)";
     readonly "openhands/deepseek-v4-flash": "OpenHands DeepSeek V4 Flash (free)";
     readonly "openhands/minimax-m2.7": "OpenHands MiniMax M2.7 (free)";

package/dist/utils/format-model-name.js

@@ -1,5 +1,6 @@
 //#region src/utils/format-model-name.ts
 var e = "Free", t = {
+	"openhands/kimi-k3": "OpenHands Kimi K3 (free)",
 	"openhands/glm-5.2": "OpenHands GLM-5.2 (free)",
 	"openhands/deepseek-v4-flash": "OpenHands DeepSeek V4 Flash (free)",
 	"openhands/minimax-m2.7": "OpenHands MiniMax M2.7 (free)"

package/dist/utils/format-model-name.js.map

@@ -1 +1 @@
-{"version":3,"file":"format-model-name.js","names":[],"sources":["../../src/utils/format-model-name.ts"],"sourcesContent":["export const FREE_MODEL_BADGE_LABEL = \"Free\";\n\nexport const FREE_OPENHANDS_MODELS = {\n  \"openhands/glm-5.2\": \"OpenHands GLM-5.2 (free)\",\n  \"openhands/deepseek-v4-flash\": \"OpenHands DeepSeek V4 Flash (free)\",\n  \"openhands/minimax-m2.7\": \"OpenHands MiniMax M2.7 (free)\",\n} as const;\n\nexport const FREE_OPENHANDS_MODEL_IDS = Object.keys(FREE_OPENHANDS_MODELS);\nexport const FREE_OPENHANDS_MODEL_NOTE = `Free OpenHands models: ${FREE_OPENHANDS_MODEL_IDS.join(\n  \", \",\n)}. Other provider endpoints with similar model names may require separate billing.`;\n\nexport const isFreeOpenHandsModel = (\n  model: string | null | undefined,\n): model is keyof typeof FREE_OPENHANDS_MODELS =>\n  Boolean(model && model in FREE_OPENHANDS_MODELS);\n\nexport function formatModelNameForDisplay(\n  model: string | null | undefined,\n): string | null {\n  if (!model) return null;\n  return isFreeOpenHandsModel(model) ? FREE_OPENHANDS_MODELS[model] : model;\n}\n\nexport function formatProviderModelNameForDisplay(\n  provider: string | null | undefined,\n  model: string | null | undefined,\n): string | null {\n  if (!model) return null;\n  const fullModel = provider ? `${provider}/${model}` : model;\n  return isFreeOpenHandsModel(fullModel)\n    ? FREE_OPENHANDS_MODELS[fullModel]\n    : model;\n}\n\n/**\n * Format a native (OpenHands-kind) routing model string for display, stripping\n * the provider route prefix (e.g. ``\"anthropic/claude-sonnet-4-5-20250929\"`` →\n * ``\"claude-sonnet-4-5-20250929\"``, ``\"litellm_proxy/openai/gpt-4o\"`` →\n * ``\"gpt-4o\"``) so a conversation chip shows a meaningful model name rather than\n * the full routing path.\n *\n * Returns ``null`` for an empty/nullish input, and falls back to the original\n * string when stripping the prefix would leave nothing (e.g. a trailing slash)\n * — never an empty string, which would collapse the chip text.\n *\n * Display-only: unlike {@link deriveProfileNameFromModel} this does not sanitize\n * to an identifier, so it keeps the real model id intact for the chip.\n */\nexport function formatNativeModelName(\n  model: string | null | undefined,\n): string | null {\n  if (!model) return null;\n  if (isFreeOpenHandsModel(model)) return FREE_OPENHANDS_MODELS[model];\n  const lastSegment = model.split(\"/\").pop();\n  return lastSegment || model;\n}\n"],"mappings":";AAAA,IAAa,IAAyB,QAEzB,IAAwB;CACnC,qBAAqB;CACrB,+BAA+B;CAC/B,0BAA0B;AAC5B,GAGa,IAA4B,0BADD,OAAO,KAAK,CACe,EAAyB,KAC1F,IACF,EAAE,oFAEW,KACX,MAEA,GAAQ,KAAS,KAAS;AAE5B,SAAgB,EACd,GACe;CAEf,OADK,IACE,EAAqB,CAAK,IAAI,EAAsB,KAAS,IADjD;AAErB;AA2BA,SAAgB,EACd,GACe;CAIf,OAHK,IACD,EAAqB,CAAK,IAAU,EAAsB,KAC1C,EAAM,MAAM,GAAG,EAAE,IAC9B,KAAe,IAHH;AAIrB"}
+{"version":3,"file":"format-model-name.js","names":[],"sources":["../../src/utils/format-model-name.ts"],"sourcesContent":["export const FREE_MODEL_BADGE_LABEL = \"Free\";\n\nexport const FREE_OPENHANDS_MODELS = {\n  \"openhands/kimi-k3\": \"OpenHands Kimi K3 (free)\",\n  \"openhands/glm-5.2\": \"OpenHands GLM-5.2 (free)\",\n  \"openhands/deepseek-v4-flash\": \"OpenHands DeepSeek V4 Flash (free)\",\n  \"openhands/minimax-m2.7\": \"OpenHands MiniMax M2.7 (free)\",\n} as const;\n\nexport const FREE_OPENHANDS_MODEL_IDS = Object.keys(FREE_OPENHANDS_MODELS);\nexport const FREE_OPENHANDS_MODEL_NOTE = `Free OpenHands models: ${FREE_OPENHANDS_MODEL_IDS.join(\n  \", \",\n)}. Other provider endpoints with similar model names may require separate billing.`;\n\nexport const isFreeOpenHandsModel = (\n  model: string | null | undefined,\n): model is keyof typeof FREE_OPENHANDS_MODELS =>\n  Boolean(model && model in FREE_OPENHANDS_MODELS);\n\nexport function formatModelNameForDisplay(\n  model: string | null | undefined,\n): string | null {\n  if (!model) return null;\n  return isFreeOpenHandsModel(model) ? FREE_OPENHANDS_MODELS[model] : model;\n}\n\nexport function formatProviderModelNameForDisplay(\n  provider: string | null | undefined,\n  model: string | null | undefined,\n): string | null {\n  if (!model) return null;\n  const fullModel = provider ? `${provider}/${model}` : model;\n  return isFreeOpenHandsModel(fullModel)\n    ? FREE_OPENHANDS_MODELS[fullModel]\n    : model;\n}\n\n/**\n * Format a native (OpenHands-kind) routing model string for display, stripping\n * the provider route prefix (e.g. ``\"anthropic/claude-sonnet-4-5-20250929\"`` →\n * ``\"claude-sonnet-4-5-20250929\"``, ``\"litellm_proxy/openai/gpt-4o\"`` →\n * ``\"gpt-4o\"``) so a conversation chip shows a meaningful model name rather than\n * the full routing path.\n *\n * Returns ``null`` for an empty/nullish input, and falls back to the original\n * string when stripping the prefix would leave nothing (e.g. a trailing slash)\n * — never an empty string, which would collapse the chip text.\n *\n * Display-only: unlike {@link deriveProfileNameFromModel} this does not sanitize\n * to an identifier, so it keeps the real model id intact for the chip.\n */\nexport function formatNativeModelName(\n  model: string | null | undefined,\n): string | null {\n  if (!model) return null;\n  if (isFreeOpenHandsModel(model)) return FREE_OPENHANDS_MODELS[model];\n  const lastSegment = model.split(\"/\").pop();\n  return lastSegment || model;\n}\n"],"mappings":";AAAA,IAAa,IAAyB,QAEzB,IAAwB;CACnC,qBAAqB;CACrB,qBAAqB;CACrB,+BAA+B;CAC/B,0BAA0B;AAC5B,GAGa,IAA4B,0BADD,OAAO,KAAK,CACe,EAAyB,KAC1F,IACF,EAAE,oFAEW,KACX,MAEA,GAAQ,KAAS,KAAS;AAE5B,SAAgB,EACd,GACe;CAEf,OADK,IACE,EAAqB,CAAK,IAAI,EAAsB,KAAS,IADjD;AAErB;AA2BA,SAAgB,EACd,GACe;CAIf,OAHK,IACD,EAAqB,CAAK,IAAU,EAAsB,KAC1C,EAAM,MAAM,GAAG,EAAE,IAC9B,KAAe,IAHH;AAIrB"}

package/dist/utils/transcript-export/load-complete-events.cjs

@@ -1,2 +1,2 @@
-require("../../_virtual/_rolldown/runtime.cjs");var e=(e,t)=>(e.timestamp??``).localeCompare(t.timestamp??``),t=async(t,n,r)=>{let i=[],a=new Set,o=new Set,s,c,l=!1,u=!1;for(;;){let e=await n({limit:100,sortOrder:`TIMESTAMP_DESC`,strictPagination:!0,...c?{pageId:c}:{},...s?{timestampLt:s}:{}});if(!Array.isArray(e.items))throw Error(`Invalid transcript history response: expected page.items to be an array.`);i.push(...e.items);let t,d=!1;if(e.items.forEach(e=>{a.has(e.id??``)||(e.id&&a.add(e.id),d=!0),(!t||(e.timestamp??``)<t)&&(t=e.timestamp??``)}),e.next_page_id){if(o.has(e.next_page_id))throw Error(`Transcript history pagination repeated a page cursor.`);o.add(e.next_page_id),c=e.next_page_id,s=void 0,l=!0;continue}if(l&&!u||e.items.length<100)break;if(r===void 0)throw Error(`Transcript history pagination cannot prove that all events were loaded.`);if(!t||s&&(!d||t>=s))throw Error(`Transcript history pagination did not advance.`);c=void 0,s=t,u=!0}let d=new Map;i.slice().reverse().forEach(e=>{d.has(e.id??``)||e.id&&d.set(e.id,e)}),t.forEach(e=>{d.has(e.id??``)||e.id&&d.set(e.id,e)});let f=[...d.values()].sort(e);if(r!==void 0&&a.size<r)throw Error(`Transcript history is incomplete: expected ${r} persisted events, received ${a.size}.`);return f};exports.loadCompleteTranscriptEvents=t;
+require("../../_virtual/_rolldown/runtime.cjs");var e=(e,t)=>(e.timestamp??``).localeCompare(t.timestamp??``),t=async(t,n,r)=>{let i=[],a=new Set,o=[],s=0,c=new Set,l,u,d=!1,f=!1;for(;;){let e=await n({limit:100,sortOrder:`TIMESTAMP_DESC`,strictPagination:!0,...u?{pageId:u}:{},...l?{timestampLt:l}:{}});if(!Array.isArray(e.items))throw Error(`Invalid transcript history response: expected page.items to be an array.`);i.push(...e.items);let t,o=!1;if(e.items.forEach(e=>{a.has(e.id??``)||(e.id?a.add(e.id):s+=1,o=!0),(!t||(e.timestamp??``)<t)&&(t=e.timestamp??``)}),e.next_page_id){if(c.has(e.next_page_id))throw Error(`Transcript history pagination repeated a page cursor.`);c.add(e.next_page_id),u=e.next_page_id,l=void 0,d=!0;continue}if(d&&!f||e.items.length<100)break;if(r===void 0)throw Error(`Transcript history pagination cannot prove that all events were loaded.`);if(!t||l&&(!o||t>=l))throw Error(`Transcript history pagination did not advance.`);u=void 0,l=t,f=!0}let p=new Map;i.slice().reverse().forEach(e=>{if(e.id!==void 0){p.has(e.id)||p.set(e.id,e);return}o.push(e)}),t.forEach(e=>{if(e.id!==void 0){p.has(e.id)||p.set(e.id,e);return}o.push(e)});let m=[...o,...p.values()].sort(e);if(r!==void 0&&a.size+s<r)throw Error(`Transcript history is incomplete: expected ${r} persisted events, received ${a.size+s}.`);return m};exports.loadCompleteTranscriptEvents=t;
 //# sourceMappingURL=load-complete-events.cjs.map

package/dist/utils/transcript-export/load-complete-events.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"load-complete-events.cjs","names":[],"sources":["../../../src/utils/transcript-export/load-complete-events.ts"],"sourcesContent":["import type { OpenHandsEvent } from \"#/types/agent-server/core\";\n\nexport const TRANSCRIPT_HISTORY_PAGE_SIZE = 100;\n\ninterface TranscriptEventSearchOptions {\n  limit: number;\n  sortOrder: \"TIMESTAMP_DESC\";\n  pageId?: string;\n  timestampLt?: string;\n  strictPagination: true;\n}\n\ninterface TranscriptEventPage {\n  items: OpenHandsEvent[];\n  next_page_id?: string | null;\n}\n\ntype SearchTranscriptEvents = (\n  options: TranscriptEventSearchOptions,\n) => Promise<TranscriptEventPage>;\n\nconst compareEventTimestamps = (\n  first: OpenHandsEvent,\n  second: OpenHandsEvent,\n): number => (first.timestamp ?? \"\").localeCompare(second.timestamp ?? \"\");\n\n/**\n * Loads the persisted history from the newest page back to the beginning,\n * then merges any live store events that have not persisted yet. The timestamp\n * anchor matches the chat's existing history pagination, while id-based\n * de-duplication keeps the result stable if pages overlap.\n */\nexport const loadCompleteTranscriptEvents = async (\n  loadedEvents: OpenHandsEvent[],\n  searchEvents: SearchTranscriptEvents,\n  expectedEventCount?: number,\n): Promise<OpenHandsEvent[]> => {\n  const persistedDescending: OpenHandsEvent[] = [];\n  const fetchedEventIds = new Set<string>();\n  const seenPageIds = new Set<string>();\n  let oldestTimestamp: string | undefined;\n  let pageId: string | undefined;\n  let usedCursor = false;\n  let usingTimestampFallback = false;\n\n  while (true) {\n    const page = await searchEvents({\n      limit: TRANSCRIPT_HISTORY_PAGE_SIZE,\n      sortOrder: \"TIMESTAMP_DESC\",\n      strictPagination: true,\n      ...(pageId ? { pageId } : {}),\n      ...(oldestTimestamp ? { timestampLt: oldestTimestamp } : {}),\n    });\n\n    if (!Array.isArray(page.items)) {\n      throw new Error(\n        \"Invalid transcript history response: expected page.items to be an array.\",\n      );\n    }\n\n    persistedDescending.push(...page.items);\n    let pageOldestTimestamp: string | undefined;\n    let addedEvent = false;\n    page.items.forEach((event) => {\n      if (!fetchedEventIds.has(event.id ?? \"\")) {\n        if (event.id) fetchedEventIds.add(event.id);\n        addedEvent = true;\n      }\n      if (\n        !pageOldestTimestamp ||\n        (event.timestamp ?? \"\") < pageOldestTimestamp\n      ) {\n        pageOldestTimestamp = event.timestamp ?? \"\";\n      }\n    });\n\n    if (page.next_page_id) {\n      if (seenPageIds.has(page.next_page_id)) {\n        throw new Error(\n          \"Transcript history pagination repeated a page cursor.\",\n        );\n      }\n      seenPageIds.add(page.next_page_id);\n      pageId = page.next_page_id;\n      oldestTimestamp = undefined;\n      usedCursor = true;\n      continue;\n    }\n\n    // Once a server supplies a cursor, a page without a next cursor is an\n    // explicit exhaustion signal, even when the final page is exactly full.\n    if (usedCursor && !usingTimestampFallback) break;\n    if (page.items.length < TRANSCRIPT_HISTORY_PAGE_SIZE) break;\n\n    // Some older servers omit cursors for filtered searches. A timestamp\n    // fallback is safe to attempt only when an independent event count can\n    // prove completeness; otherwise fail instead of exporting a partial tail.\n    if (expectedEventCount === undefined) {\n      throw new Error(\n        \"Transcript history pagination cannot prove that all events were loaded.\",\n      );\n    }\n    if (!pageOldestTimestamp) {\n      throw new Error(\"Transcript history pagination did not advance.\");\n    }\n    if (\n      oldestTimestamp &&\n      (!addedEvent || pageOldestTimestamp >= oldestTimestamp)\n    ) {\n      throw new Error(\"Transcript history pagination did not advance.\");\n    }\n\n    pageId = undefined;\n    oldestTimestamp = pageOldestTimestamp;\n    usingTimestampFallback = true;\n  }\n\n  const eventsById = new Map<string, OpenHandsEvent>();\n  persistedDescending\n    .slice()\n    .reverse()\n    .forEach((event) => {\n      if (!eventsById.has(event.id ?? \"\"))\n        if (event.id) eventsById.set(event.id, event);\n    });\n  loadedEvents.forEach((event) => {\n    if (!eventsById.has(event.id ?? \"\"))\n      if (event.id) eventsById.set(event.id, event);\n  });\n  // Array.prototype.sort is stable, so equal-timestamp events keep the causal\n  // order returned by the server/store rather than being reordered by id.\n  const completeEvents = [...eventsById.values()].sort(compareEventTimestamps);\n  if (\n    expectedEventCount !== undefined &&\n    fetchedEventIds.size < expectedEventCount\n  ) {\n    throw new Error(\n      `Transcript history is incomplete: expected ${expectedEventCount} persisted events, received ${fetchedEventIds.size}.`,\n    );\n  }\n  return completeEvents;\n};\n"],"mappings":"gDAqBA,IAAM,GACJ,EACA,KACY,EAAM,WAAa,IAAI,cAAc,EAAO,WAAa,EAAE,EAQ5D,EAA+B,MAC1C,EACA,EACA,IAC8B,CAC9B,IAAM,EAAwC,CAAC,EACzC,EAAkB,IAAI,IACtB,EAAc,IAAI,IACpB,EACA,EACA,EAAa,GACb,EAAyB,GAE7B,OAAa,CACX,IAAM,EAAO,MAAM,EAAa,CAC9B,MAAA,IACA,UAAW,iBACX,iBAAkB,GAClB,GAAI,EAAS,CAAE,QAAO,EAAI,CAAC,EAC3B,GAAI,EAAkB,CAAE,YAAa,CAAgB,EAAI,CAAC,CAC5D,CAAC,EAED,GAAI,CAAC,MAAM,QAAQ,EAAK,KAAK,EAC3B,MAAU,MACR,0EACF,EAGF,EAAoB,KAAK,GAAG,EAAK,KAAK,EACtC,IAAI,EACA,EAAa,GAcjB,GAbA,EAAK,MAAM,QAAS,GAAU,CACvB,EAAgB,IAAI,EAAM,IAAM,EAAE,IACjC,EAAM,IAAI,EAAgB,IAAI,EAAM,EAAE,EAC1C,EAAa,KAGb,CAAC,IACA,EAAM,WAAa,IAAM,KAE1B,EAAsB,EAAM,WAAa,GAE7C,CAAC,EAEG,EAAK,aAAc,CACrB,GAAI,EAAY,IAAI,EAAK,YAAY,EACnC,MAAU,MACR,uDACF,EAEF,EAAY,IAAI,EAAK,YAAY,EACjC,EAAS,EAAK,aACd,EAAkB,IAAA,GAClB,EAAa,GACb,QACF,CAKA,GADI,GAAc,CAAC,GACf,EAAK,MAAM,OAAA,IAAuC,MAKtD,GAAI,IAAuB,IAAA,GACzB,MAAU,MACR,yEACF,EAKF,GAHI,CAAC,GAIH,IACC,CAAC,GAAc,GAAuB,GAEvC,MAAU,MAAM,gDAAgD,EAGlE,EAAS,IAAA,GACT,EAAkB,EAClB,EAAyB,EAC3B,CAEA,IAAM,EAAa,IAAI,IACvB,EACG,MAAM,EACN,QAAQ,EACR,QAAS,GAAU,CACb,EAAW,IAAI,EAAM,IAAM,EAAE,GAC5B,EAAM,IAAI,EAAW,IAAI,EAAM,GAAI,CAAK,CAChD,CAAC,EACH,EAAa,QAAS,GAAU,CACzB,EAAW,IAAI,EAAM,IAAM,EAAE,GAC5B,EAAM,IAAI,EAAW,IAAI,EAAM,GAAI,CAAK,CAChD,CAAC,EAGD,IAAM,EAAiB,CAAC,GAAG,EAAW,OAAO,CAAC,EAAE,KAAK,CAAsB,EAC3E,GACE,IAAuB,IAAA,IACvB,EAAgB,KAAO,EAEvB,MAAU,MACR,8CAA8C,EAAmB,8BAA8B,EAAgB,KAAK,EACtH,EAEF,OAAO,CACT"}
+{"version":3,"file":"load-complete-events.cjs","names":[],"sources":["../../../src/utils/transcript-export/load-complete-events.ts"],"sourcesContent":["import type { OpenHandsEvent } from \"#/types/agent-server/core\";\n\nexport const TRANSCRIPT_HISTORY_PAGE_SIZE = 100;\n\ninterface TranscriptEventSearchOptions {\n  limit: number;\n  sortOrder: \"TIMESTAMP_DESC\";\n  pageId?: string;\n  timestampLt?: string;\n  strictPagination: true;\n}\n\ninterface TranscriptEventPage {\n  items: OpenHandsEvent[];\n  next_page_id?: string | null;\n}\n\ntype SearchTranscriptEvents = (\n  options: TranscriptEventSearchOptions,\n) => Promise<TranscriptEventPage>;\n\nconst compareEventTimestamps = (\n  first: OpenHandsEvent,\n  second: OpenHandsEvent,\n): number => (first.timestamp ?? \"\").localeCompare(second.timestamp ?? \"\");\n\n/**\n * Loads the persisted history from the newest page back to the beginning,\n * then merges any live store events that have not persisted yet. The timestamp\n * anchor matches the chat's existing history pagination, while id-based\n * de-duplication keeps the result stable if pages overlap.\n */\nexport const loadCompleteTranscriptEvents = async (\n  loadedEvents: OpenHandsEvent[],\n  searchEvents: SearchTranscriptEvents,\n  expectedEventCount?: number,\n): Promise<OpenHandsEvent[]> => {\n  const persistedDescending: OpenHandsEvent[] = [];\n  const fetchedEventIds = new Set<string>();\n  // Id-less events can't be de-duplicated by id, so keep a separate ordered\n  // list and a count so they survive the merge and count toward completeness.\n  const idLessEvents: OpenHandsEvent[] = [];\n  let idLessPersisted = 0;\n  const seenPageIds = new Set<string>();\n  let oldestTimestamp: string | undefined;\n  let pageId: string | undefined;\n  let usedCursor = false;\n  let usingTimestampFallback = false;\n\n  while (true) {\n    const page = await searchEvents({\n      limit: TRANSCRIPT_HISTORY_PAGE_SIZE,\n      sortOrder: \"TIMESTAMP_DESC\",\n      strictPagination: true,\n      ...(pageId ? { pageId } : {}),\n      ...(oldestTimestamp ? { timestampLt: oldestTimestamp } : {}),\n    });\n\n    if (!Array.isArray(page.items)) {\n      throw new Error(\n        \"Invalid transcript history response: expected page.items to be an array.\",\n      );\n    }\n\n    persistedDescending.push(...page.items);\n    let pageOldestTimestamp: string | undefined;\n    let addedEvent = false;\n    page.items.forEach((event) => {\n      if (!fetchedEventIds.has(event.id ?? \"\")) {\n        if (event.id) {\n          fetchedEventIds.add(event.id);\n        } else {\n          idLessPersisted += 1;\n        }\n        addedEvent = true;\n      }\n      if (\n        !pageOldestTimestamp ||\n        (event.timestamp ?? \"\") < pageOldestTimestamp\n      ) {\n        pageOldestTimestamp = event.timestamp ?? \"\";\n      }\n    });\n\n    if (page.next_page_id) {\n      if (seenPageIds.has(page.next_page_id)) {\n        throw new Error(\n          \"Transcript history pagination repeated a page cursor.\",\n        );\n      }\n      seenPageIds.add(page.next_page_id);\n      pageId = page.next_page_id;\n      oldestTimestamp = undefined;\n      usedCursor = true;\n      continue;\n    }\n\n    // Once a server supplies a cursor, a page without a next cursor is an\n    // explicit exhaustion signal, even when the final page is exactly full.\n    if (usedCursor && !usingTimestampFallback) break;\n    if (page.items.length < TRANSCRIPT_HISTORY_PAGE_SIZE) break;\n\n    // Some older servers omit cursors for filtered searches. A timestamp\n    // fallback is safe to attempt only when an independent event count can\n    // prove completeness; otherwise fail instead of exporting a partial tail.\n    if (expectedEventCount === undefined) {\n      throw new Error(\n        \"Transcript history pagination cannot prove that all events were loaded.\",\n      );\n    }\n    if (!pageOldestTimestamp) {\n      throw new Error(\"Transcript history pagination did not advance.\");\n    }\n    if (\n      oldestTimestamp &&\n      (!addedEvent || pageOldestTimestamp >= oldestTimestamp)\n    ) {\n      throw new Error(\"Transcript history pagination did not advance.\");\n    }\n\n    pageId = undefined;\n    oldestTimestamp = pageOldestTimestamp;\n    usingTimestampFallback = true;\n  }\n\n  const eventsById = new Map<string, OpenHandsEvent>();\n  persistedDescending\n    .slice()\n    .reverse()\n    .forEach((event) => {\n      if (event.id !== undefined) {\n        if (!eventsById.has(event.id)) {\n          eventsById.set(event.id, event);\n        }\n        return;\n      }\n      idLessEvents.push(event);\n    });\n  loadedEvents.forEach((event) => {\n    if (event.id !== undefined) {\n      if (!eventsById.has(event.id)) {\n        eventsById.set(event.id, event);\n      }\n      return;\n    }\n    idLessEvents.push(event);\n  });\n  // Array.prototype.sort is stable, so equal-timestamp events keep the causal\n  // order returned by the server/store rather than being reordered by id.\n  const completeEvents = [...idLessEvents, ...eventsById.values()].sort(\n    compareEventTimestamps,\n  );\n  if (\n    expectedEventCount !== undefined &&\n    fetchedEventIds.size + idLessPersisted < expectedEventCount\n  ) {\n    throw new Error(\n      `Transcript history is incomplete: expected ${expectedEventCount} persisted events, received ${fetchedEventIds.size + idLessPersisted}.`,\n    );\n  }\n  return completeEvents;\n};\n"],"mappings":"gDAqBA,IAAM,GACJ,EACA,KACY,EAAM,WAAa,IAAI,cAAc,EAAO,WAAa,EAAE,EAQ5D,EAA+B,MAC1C,EACA,EACA,IAC8B,CAC9B,IAAM,EAAwC,CAAC,EACzC,EAAkB,IAAI,IAGtB,EAAiC,CAAC,EACpC,EAAkB,EAChB,EAAc,IAAI,IACpB,EACA,EACA,EAAa,GACb,EAAyB,GAE7B,OAAa,CACX,IAAM,EAAO,MAAM,EAAa,CAC9B,MAAA,IACA,UAAW,iBACX,iBAAkB,GAClB,GAAI,EAAS,CAAE,QAAO,EAAI,CAAC,EAC3B,GAAI,EAAkB,CAAE,YAAa,CAAgB,EAAI,CAAC,CAC5D,CAAC,EAED,GAAI,CAAC,MAAM,QAAQ,EAAK,KAAK,EAC3B,MAAU,MACR,0EACF,EAGF,EAAoB,KAAK,GAAG,EAAK,KAAK,EACtC,IAAI,EACA,EAAa,GAkBjB,GAjBA,EAAK,MAAM,QAAS,GAAU,CACvB,EAAgB,IAAI,EAAM,IAAM,EAAE,IACjC,EAAM,GACR,EAAgB,IAAI,EAAM,EAAE,EAE5B,GAAmB,EAErB,EAAa,KAGb,CAAC,IACA,EAAM,WAAa,IAAM,KAE1B,EAAsB,EAAM,WAAa,GAE7C,CAAC,EAEG,EAAK,aAAc,CACrB,GAAI,EAAY,IAAI,EAAK,YAAY,EACnC,MAAU,MACR,uDACF,EAEF,EAAY,IAAI,EAAK,YAAY,EACjC,EAAS,EAAK,aACd,EAAkB,IAAA,GAClB,EAAa,GACb,QACF,CAKA,GADI,GAAc,CAAC,GACf,EAAK,MAAM,OAAA,IAAuC,MAKtD,GAAI,IAAuB,IAAA,GACzB,MAAU,MACR,yEACF,EAKF,GAHI,CAAC,GAIH,IACC,CAAC,GAAc,GAAuB,GAEvC,MAAU,MAAM,gDAAgD,EAGlE,EAAS,IAAA,GACT,EAAkB,EAClB,EAAyB,EAC3B,CAEA,IAAM,EAAa,IAAI,IACvB,EACG,MAAM,EACN,QAAQ,EACR,QAAS,GAAU,CAClB,GAAI,EAAM,KAAO,IAAA,GAAW,CACrB,EAAW,IAAI,EAAM,EAAE,GAC1B,EAAW,IAAI,EAAM,GAAI,CAAK,EAEhC,MACF,CACA,EAAa,KAAK,CAAK,CACzB,CAAC,EACH,EAAa,QAAS,GAAU,CAC9B,GAAI,EAAM,KAAO,IAAA,GAAW,CACrB,EAAW,IAAI,EAAM,EAAE,GAC1B,EAAW,IAAI,EAAM,GAAI,CAAK,EAEhC,MACF,CACA,EAAa,KAAK,CAAK,CACzB,CAAC,EAGD,IAAM,EAAiB,CAAC,GAAG,EAAc,GAAG,EAAW,OAAO,CAAC,EAAE,KAC/D,CACF,EACA,GACE,IAAuB,IAAA,IACvB,EAAgB,KAAO,EAAkB,EAEzC,MAAU,MACR,8CAA8C,EAAmB,8BAA8B,EAAgB,KAAO,EAAgB,EACxI,EAEF,OAAO,CACT"}

package/dist/utils/transcript-export/load-complete-events.js

@@ -1,37 +1,45 @@
 var e = (e, t) => (e.timestamp ?? "").localeCompare(t.timestamp ?? ""), t = async (t, n, r) => {
-	let i = [], a = /* @__PURE__ */ new Set(), o = /* @__PURE__ */ new Set(), s, c, l = !1, u = !1;
+	let i = [], a = /* @__PURE__ */ new Set(), o = [], s = 0, c = /* @__PURE__ */ new Set(), l, u, d = !1, f = !1;
 	for (;;) {
 		let e = await n({
 			limit: 100,
 			sortOrder: "TIMESTAMP_DESC",
 			strictPagination: !0,
-			...c ? { pageId: c } : {},
-			...s ? { timestampLt: s } : {}
+			...u ? { pageId: u } : {},
+			...l ? { timestampLt: l } : {}
 		});
 		if (!Array.isArray(e.items)) throw Error("Invalid transcript history response: expected page.items to be an array.");
 		i.push(...e.items);
-		let t, d = !1;
+		let t, o = !1;
 		if (e.items.forEach((e) => {
-			a.has(e.id ?? "") || (e.id && a.add(e.id), d = !0), (!t || (e.timestamp ?? "") < t) && (t = e.timestamp ?? "");
+			a.has(e.id ?? "") || (e.id ? a.add(e.id) : s += 1, o = !0), (!t || (e.timestamp ?? "") < t) && (t = e.timestamp ?? "");
 		}), e.next_page_id) {
-			if (o.has(e.next_page_id)) throw Error("Transcript history pagination repeated a page cursor.");
-			o.add(e.next_page_id), c = e.next_page_id, s = void 0, l = !0;
+			if (c.has(e.next_page_id)) throw Error("Transcript history pagination repeated a page cursor.");
+			c.add(e.next_page_id), u = e.next_page_id, l = void 0, d = !0;
 			continue;
 		}
-		if (l && !u || e.items.length < 100) break;
+		if (d && !f || e.items.length < 100) break;
 		if (r === void 0) throw Error("Transcript history pagination cannot prove that all events were loaded.");
-		if (!t || s && (!d || t >= s)) throw Error("Transcript history pagination did not advance.");
-		c = void 0, s = t, u = !0;
+		if (!t || l && (!o || t >= l)) throw Error("Transcript history pagination did not advance.");
+		u = void 0, l = t, f = !0;
 	}
-	let d = /* @__PURE__ */ new Map();
+	let p = /* @__PURE__ */ new Map();
 	i.slice().reverse().forEach((e) => {
-		d.has(e.id ?? "") || e.id && d.set(e.id, e);
+		if (e.id !== void 0) {
+			p.has(e.id) || p.set(e.id, e);
+			return;
+		}
+		o.push(e);
 	}), t.forEach((e) => {
-		d.has(e.id ?? "") || e.id && d.set(e.id, e);
+		if (e.id !== void 0) {
+			p.has(e.id) || p.set(e.id, e);
+			return;
+		}
+		o.push(e);
 	});
-	let f = [...d.values()].sort(e);
-	if (r !== void 0 && a.size < r) throw Error(`Transcript history is incomplete: expected ${r} persisted events, received ${a.size}.`);
-	return f;
+	let m = [...o, ...p.values()].sort(e);
+	if (r !== void 0 && a.size + s < r) throw Error(`Transcript history is incomplete: expected ${r} persisted events, received ${a.size + s}.`);
+	return m;
 };
 //#endregion
 export { t as loadCompleteTranscriptEvents };

package/dist/utils/transcript-export/load-complete-events.js.map

@@ -1 +1 @@
-{"version":3,"file":"load-complete-events.js","names":[],"sources":["../../../src/utils/transcript-export/load-complete-events.ts"],"sourcesContent":["import type { OpenHandsEvent } from \"#/types/agent-server/core\";\n\nexport const TRANSCRIPT_HISTORY_PAGE_SIZE = 100;\n\ninterface TranscriptEventSearchOptions {\n  limit: number;\n  sortOrder: \"TIMESTAMP_DESC\";\n  pageId?: string;\n  timestampLt?: string;\n  strictPagination: true;\n}\n\ninterface TranscriptEventPage {\n  items: OpenHandsEvent[];\n  next_page_id?: string | null;\n}\n\ntype SearchTranscriptEvents = (\n  options: TranscriptEventSearchOptions,\n) => Promise<TranscriptEventPage>;\n\nconst compareEventTimestamps = (\n  first: OpenHandsEvent,\n  second: OpenHandsEvent,\n): number => (first.timestamp ?? \"\").localeCompare(second.timestamp ?? \"\");\n\n/**\n * Loads the persisted history from the newest page back to the beginning,\n * then merges any live store events that have not persisted yet. The timestamp\n * anchor matches the chat's existing history pagination, while id-based\n * de-duplication keeps the result stable if pages overlap.\n */\nexport const loadCompleteTranscriptEvents = async (\n  loadedEvents: OpenHandsEvent[],\n  searchEvents: SearchTranscriptEvents,\n  expectedEventCount?: number,\n): Promise<OpenHandsEvent[]> => {\n  const persistedDescending: OpenHandsEvent[] = [];\n  const fetchedEventIds = new Set<string>();\n  const seenPageIds = new Set<string>();\n  let oldestTimestamp: string | undefined;\n  let pageId: string | undefined;\n  let usedCursor = false;\n  let usingTimestampFallback = false;\n\n  while (true) {\n    const page = await searchEvents({\n      limit: TRANSCRIPT_HISTORY_PAGE_SIZE,\n      sortOrder: \"TIMESTAMP_DESC\",\n      strictPagination: true,\n      ...(pageId ? { pageId } : {}),\n      ...(oldestTimestamp ? { timestampLt: oldestTimestamp } : {}),\n    });\n\n    if (!Array.isArray(page.items)) {\n      throw new Error(\n        \"Invalid transcript history response: expected page.items to be an array.\",\n      );\n    }\n\n    persistedDescending.push(...page.items);\n    let pageOldestTimestamp: string | undefined;\n    let addedEvent = false;\n    page.items.forEach((event) => {\n      if (!fetchedEventIds.has(event.id ?? \"\")) {\n        if (event.id) fetchedEventIds.add(event.id);\n        addedEvent = true;\n      }\n      if (\n        !pageOldestTimestamp ||\n        (event.timestamp ?? \"\") < pageOldestTimestamp\n      ) {\n        pageOldestTimestamp = event.timestamp ?? \"\";\n      }\n    });\n\n    if (page.next_page_id) {\n      if (seenPageIds.has(page.next_page_id)) {\n        throw new Error(\n          \"Transcript history pagination repeated a page cursor.\",\n        );\n      }\n      seenPageIds.add(page.next_page_id);\n      pageId = page.next_page_id;\n      oldestTimestamp = undefined;\n      usedCursor = true;\n      continue;\n    }\n\n    // Once a server supplies a cursor, a page without a next cursor is an\n    // explicit exhaustion signal, even when the final page is exactly full.\n    if (usedCursor && !usingTimestampFallback) break;\n    if (page.items.length < TRANSCRIPT_HISTORY_PAGE_SIZE) break;\n\n    // Some older servers omit cursors for filtered searches. A timestamp\n    // fallback is safe to attempt only when an independent event count can\n    // prove completeness; otherwise fail instead of exporting a partial tail.\n    if (expectedEventCount === undefined) {\n      throw new Error(\n        \"Transcript history pagination cannot prove that all events were loaded.\",\n      );\n    }\n    if (!pageOldestTimestamp) {\n      throw new Error(\"Transcript history pagination did not advance.\");\n    }\n    if (\n      oldestTimestamp &&\n      (!addedEvent || pageOldestTimestamp >= oldestTimestamp)\n    ) {\n      throw new Error(\"Transcript history pagination did not advance.\");\n    }\n\n    pageId = undefined;\n    oldestTimestamp = pageOldestTimestamp;\n    usingTimestampFallback = true;\n  }\n\n  const eventsById = new Map<string, OpenHandsEvent>();\n  persistedDescending\n    .slice()\n    .reverse()\n    .forEach((event) => {\n      if (!eventsById.has(event.id ?? \"\"))\n        if (event.id) eventsById.set(event.id, event);\n    });\n  loadedEvents.forEach((event) => {\n    if (!eventsById.has(event.id ?? \"\"))\n      if (event.id) eventsById.set(event.id, event);\n  });\n  // Array.prototype.sort is stable, so equal-timestamp events keep the causal\n  // order returned by the server/store rather than being reordered by id.\n  const completeEvents = [...eventsById.values()].sort(compareEventTimestamps);\n  if (\n    expectedEventCount !== undefined &&\n    fetchedEventIds.size < expectedEventCount\n  ) {\n    throw new Error(\n      `Transcript history is incomplete: expected ${expectedEventCount} persisted events, received ${fetchedEventIds.size}.`,\n    );\n  }\n  return completeEvents;\n};\n"],"mappings":"AAqBA,IAAM,KACJ,GACA,OACY,EAAM,aAAa,IAAI,cAAc,EAAO,aAAa,EAAE,GAQ5D,IAA+B,OAC1C,GACA,GACA,MAC8B;CAC9B,IAAM,IAAwC,CAAC,GACzC,oBAAkB,IAAI,IAAY,GAClC,oBAAc,IAAI,IAAY,GAChC,GACA,GACA,IAAa,IACb,IAAyB;CAE7B,SAAa;EACX,IAAM,IAAO,MAAM,EAAa;GAC9B,OAAA;GACA,WAAW;GACX,kBAAkB;GAClB,GAAI,IAAS,EAAE,UAAO,IAAI,CAAC;GAC3B,GAAI,IAAkB,EAAE,aAAa,EAAgB,IAAI,CAAC;EAC5D,CAAC;EAED,IAAI,CAAC,MAAM,QAAQ,EAAK,KAAK,GAC3B,MAAU,MACR,0EACF;EAGF,EAAoB,KAAK,GAAG,EAAK,KAAK;EACtC,IAAI,GACA,IAAa;EAcjB,IAbA,EAAK,MAAM,SAAS,MAAU;GAK5B,AAJK,EAAgB,IAAI,EAAM,MAAM,EAAE,MACjC,EAAM,MAAI,EAAgB,IAAI,EAAM,EAAE,GAC1C,IAAa,MAGb,CAAC,MACA,EAAM,aAAa,MAAM,OAE1B,IAAsB,EAAM,aAAa;EAE7C,CAAC,GAEG,EAAK,cAAc;GACrB,IAAI,EAAY,IAAI,EAAK,YAAY,GACnC,MAAU,MACR,uDACF;GAKF,AAHA,EAAY,IAAI,EAAK,YAAY,GACjC,IAAS,EAAK,cACd,IAAkB,KAAA,GAClB,IAAa;GACb;EACF;EAKA,IADI,KAAc,CAAC,KACf,EAAK,MAAM,SAAA,KAAuC;EAKtD,IAAI,MAAuB,KAAA,GACzB,MAAU,MACR,yEACF;EAKF,IAHI,CAAC,KAIH,MACC,CAAC,KAAc,KAAuB,IAEvC,MAAU,MAAM,gDAAgD;EAKlE,AAFA,IAAS,KAAA,GACT,IAAkB,GAClB,IAAyB;CAC3B;CAEA,IAAM,oBAAa,IAAI,IAA4B;CAQnD,AAPA,EACG,MAAM,EACN,QAAQ,EACR,SAAS,MAAU;EAClB,AAAK,EAAW,IAAI,EAAM,MAAM,EAAE,KAC5B,EAAM,MAAI,EAAW,IAAI,EAAM,IAAI,CAAK;CAChD,CAAC,GACH,EAAa,SAAS,MAAU;EAC9B,AAAK,EAAW,IAAI,EAAM,MAAM,EAAE,KAC5B,EAAM,MAAI,EAAW,IAAI,EAAM,IAAI,CAAK;CAChD,CAAC;CAGD,IAAM,IAAiB,CAAC,GAAG,EAAW,OAAO,CAAC,EAAE,KAAK,CAAsB;CAC3E,IACE,MAAuB,KAAA,KACvB,EAAgB,OAAO,GAEvB,MAAU,MACR,8CAA8C,EAAmB,8BAA8B,EAAgB,KAAK,EACtH;CAEF,OAAO;AACT"}
+{"version":3,"file":"load-complete-events.js","names":[],"sources":["../../../src/utils/transcript-export/load-complete-events.ts"],"sourcesContent":["import type { OpenHandsEvent } from \"#/types/agent-server/core\";\n\nexport const TRANSCRIPT_HISTORY_PAGE_SIZE = 100;\n\ninterface TranscriptEventSearchOptions {\n  limit: number;\n  sortOrder: \"TIMESTAMP_DESC\";\n  pageId?: string;\n  timestampLt?: string;\n  strictPagination: true;\n}\n\ninterface TranscriptEventPage {\n  items: OpenHandsEvent[];\n  next_page_id?: string | null;\n}\n\ntype SearchTranscriptEvents = (\n  options: TranscriptEventSearchOptions,\n) => Promise<TranscriptEventPage>;\n\nconst compareEventTimestamps = (\n  first: OpenHandsEvent,\n  second: OpenHandsEvent,\n): number => (first.timestamp ?? \"\").localeCompare(second.timestamp ?? \"\");\n\n/**\n * Loads the persisted history from the newest page back to the beginning,\n * then merges any live store events that have not persisted yet. The timestamp\n * anchor matches the chat's existing history pagination, while id-based\n * de-duplication keeps the result stable if pages overlap.\n */\nexport const loadCompleteTranscriptEvents = async (\n  loadedEvents: OpenHandsEvent[],\n  searchEvents: SearchTranscriptEvents,\n  expectedEventCount?: number,\n): Promise<OpenHandsEvent[]> => {\n  const persistedDescending: OpenHandsEvent[] = [];\n  const fetchedEventIds = new Set<string>();\n  // Id-less events can't be de-duplicated by id, so keep a separate ordered\n  // list and a count so they survive the merge and count toward completeness.\n  const idLessEvents: OpenHandsEvent[] = [];\n  let idLessPersisted = 0;\n  const seenPageIds = new Set<string>();\n  let oldestTimestamp: string | undefined;\n  let pageId: string | undefined;\n  let usedCursor = false;\n  let usingTimestampFallback = false;\n\n  while (true) {\n    const page = await searchEvents({\n      limit: TRANSCRIPT_HISTORY_PAGE_SIZE,\n      sortOrder: \"TIMESTAMP_DESC\",\n      strictPagination: true,\n      ...(pageId ? { pageId } : {}),\n      ...(oldestTimestamp ? { timestampLt: oldestTimestamp } : {}),\n    });\n\n    if (!Array.isArray(page.items)) {\n      throw new Error(\n        \"Invalid transcript history response: expected page.items to be an array.\",\n      );\n    }\n\n    persistedDescending.push(...page.items);\n    let pageOldestTimestamp: string | undefined;\n    let addedEvent = false;\n    page.items.forEach((event) => {\n      if (!fetchedEventIds.has(event.id ?? \"\")) {\n        if (event.id) {\n          fetchedEventIds.add(event.id);\n        } else {\n          idLessPersisted += 1;\n        }\n        addedEvent = true;\n      }\n      if (\n        !pageOldestTimestamp ||\n        (event.timestamp ?? \"\") < pageOldestTimestamp\n      ) {\n        pageOldestTimestamp = event.timestamp ?? \"\";\n      }\n    });\n\n    if (page.next_page_id) {\n      if (seenPageIds.has(page.next_page_id)) {\n        throw new Error(\n          \"Transcript history pagination repeated a page cursor.\",\n        );\n      }\n      seenPageIds.add(page.next_page_id);\n      pageId = page.next_page_id;\n      oldestTimestamp = undefined;\n      usedCursor = true;\n      continue;\n    }\n\n    // Once a server supplies a cursor, a page without a next cursor is an\n    // explicit exhaustion signal, even when the final page is exactly full.\n    if (usedCursor && !usingTimestampFallback) break;\n    if (page.items.length < TRANSCRIPT_HISTORY_PAGE_SIZE) break;\n\n    // Some older servers omit cursors for filtered searches. A timestamp\n    // fallback is safe to attempt only when an independent event count can\n    // prove completeness; otherwise fail instead of exporting a partial tail.\n    if (expectedEventCount === undefined) {\n      throw new Error(\n        \"Transcript history pagination cannot prove that all events were loaded.\",\n      );\n    }\n    if (!pageOldestTimestamp) {\n      throw new Error(\"Transcript history pagination did not advance.\");\n    }\n    if (\n      oldestTimestamp &&\n      (!addedEvent || pageOldestTimestamp >= oldestTimestamp)\n    ) {\n      throw new Error(\"Transcript history pagination did not advance.\");\n    }\n\n    pageId = undefined;\n    oldestTimestamp = pageOldestTimestamp;\n    usingTimestampFallback = true;\n  }\n\n  const eventsById = new Map<string, OpenHandsEvent>();\n  persistedDescending\n    .slice()\n    .reverse()\n    .forEach((event) => {\n      if (event.id !== undefined) {\n        if (!eventsById.has(event.id)) {\n          eventsById.set(event.id, event);\n        }\n        return;\n      }\n      idLessEvents.push(event);\n    });\n  loadedEvents.forEach((event) => {\n    if (event.id !== undefined) {\n      if (!eventsById.has(event.id)) {\n        eventsById.set(event.id, event);\n      }\n      return;\n    }\n    idLessEvents.push(event);\n  });\n  // Array.prototype.sort is stable, so equal-timestamp events keep the causal\n  // order returned by the server/store rather than being reordered by id.\n  const completeEvents = [...idLessEvents, ...eventsById.values()].sort(\n    compareEventTimestamps,\n  );\n  if (\n    expectedEventCount !== undefined &&\n    fetchedEventIds.size + idLessPersisted < expectedEventCount\n  ) {\n    throw new Error(\n      `Transcript history is incomplete: expected ${expectedEventCount} persisted events, received ${fetchedEventIds.size + idLessPersisted}.`,\n    );\n  }\n  return completeEvents;\n};\n"],"mappings":"AAqBA,IAAM,KACJ,GACA,OACY,EAAM,aAAa,IAAI,cAAc,EAAO,aAAa,EAAE,GAQ5D,IAA+B,OAC1C,GACA,GACA,MAC8B;CAC9B,IAAM,IAAwC,CAAC,GACzC,oBAAkB,IAAI,IAAY,GAGlC,IAAiC,CAAC,GACpC,IAAkB,GAChB,oBAAc,IAAI,IAAY,GAChC,GACA,GACA,IAAa,IACb,IAAyB;CAE7B,SAAa;EACX,IAAM,IAAO,MAAM,EAAa;GAC9B,OAAA;GACA,WAAW;GACX,kBAAkB;GAClB,GAAI,IAAS,EAAE,UAAO,IAAI,CAAC;GAC3B,GAAI,IAAkB,EAAE,aAAa,EAAgB,IAAI,CAAC;EAC5D,CAAC;EAED,IAAI,CAAC,MAAM,QAAQ,EAAK,KAAK,GAC3B,MAAU,MACR,0EACF;EAGF,EAAoB,KAAK,GAAG,EAAK,KAAK;EACtC,IAAI,GACA,IAAa;EAkBjB,IAjBA,EAAK,MAAM,SAAS,MAAU;GAS5B,AARK,EAAgB,IAAI,EAAM,MAAM,EAAE,MACjC,EAAM,KACR,EAAgB,IAAI,EAAM,EAAE,IAE5B,KAAmB,GAErB,IAAa,MAGb,CAAC,MACA,EAAM,aAAa,MAAM,OAE1B,IAAsB,EAAM,aAAa;EAE7C,CAAC,GAEG,EAAK,cAAc;GACrB,IAAI,EAAY,IAAI,EAAK,YAAY,GACnC,MAAU,MACR,uDACF;GAKF,AAHA,EAAY,IAAI,EAAK,YAAY,GACjC,IAAS,EAAK,cACd,IAAkB,KAAA,GAClB,IAAa;GACb;EACF;EAKA,IADI,KAAc,CAAC,KACf,EAAK,MAAM,SAAA,KAAuC;EAKtD,IAAI,MAAuB,KAAA,GACzB,MAAU,MACR,yEACF;EAKF,IAHI,CAAC,KAIH,MACC,CAAC,KAAc,KAAuB,IAEvC,MAAU,MAAM,gDAAgD;EAKlE,AAFA,IAAS,KAAA,GACT,IAAkB,GAClB,IAAyB;CAC3B;CAEA,IAAM,oBAAa,IAAI,IAA4B;CAanD,AAZA,EACG,MAAM,EACN,QAAQ,EACR,SAAS,MAAU;EAClB,IAAI,EAAM,OAAO,KAAA,GAAW;GAC1B,AAAK,EAAW,IAAI,EAAM,EAAE,KAC1B,EAAW,IAAI,EAAM,IAAI,CAAK;GAEhC;EACF;EACA,EAAa,KAAK,CAAK;CACzB,CAAC,GACH,EAAa,SAAS,MAAU;EAC9B,IAAI,EAAM,OAAO,KAAA,GAAW;GAC1B,AAAK,EAAW,IAAI,EAAM,EAAE,KAC1B,EAAW,IAAI,EAAM,IAAI,CAAK;GAEhC;EACF;EACA,EAAa,KAAK,CAAK;CACzB,CAAC;CAGD,IAAM,IAAiB,CAAC,GAAG,GAAc,GAAG,EAAW,OAAO,CAAC,EAAE,KAC/D,CACF;CACA,IACE,MAAuB,KAAA,KACvB,EAAgB,OAAO,IAAkB,GAEzC,MAAU,MACR,8CAA8C,EAAmB,8BAA8B,EAAgB,OAAO,EAAgB,EACxI;CAEF,OAAO;AACT"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openhands/agent-canvas",
-  "version": "1.13.0",
+  "version": "1.14.0",
   "description": "Agent Canvas UI for OpenHands - run AI coding agents with a visual interface",
   "license": "MIT",
   "private": false,

package/scripts/check-translation-completeness.cjs

@@ -17,6 +17,9 @@ const IDENTICAL_VALUE_ALLOWLIST = new Set([
   'API$TAVILY_KEY_EXAMPLE',
   'API$TVLY_KEY_EXAMPLE',
   'AUTOMATIONS$DOWNLOAD_TARBALL',
+  'AUTOMATIONS$GIT_SYNC$BRANCH_PLACEHOLDER',
+  'AUTOMATIONS$GIT_SYNC$PATH_PLACEHOLDER',
+  'AUTOMATIONS$GIT_SYNC$REPO_URL_PLACEHOLDER',
   'BACKEND$CLOUD_TITLE',
   'BACKEND$VERSION_LABEL',
   'BRANDING$OPENHANDS',

package/scripts/dev-with-automation.mjs

@@ -46,7 +46,7 @@
 
 import { spawn, spawnSync } from "node:child_process";
 import { mkdirSync, existsSync, readFileSync } from "node:fs";
-import { join, resolve, dirname } from "node:path";
+import { join, resolve, dirname, isAbsolute } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { homedir } from "node:os";
 import { setTimeout as delay } from "node:timers/promises";
@@ -252,6 +252,7 @@ ENVIRONMENT VARIABLES:
   PORT                        Alternative to --port
   OH_AUTOMATION_GIT_REF       Git ref for automation (overrides default version)
   OH_AUTOMATION_VERSION       Specific PyPI version for automation (default: ${DEFAULT_AUTOMATION_VERSION})
+  OH_AUTOMATION_LOCAL_PATH    Absolute path to a local automation checkout (overridden only by --automation-git-ref)
   OH_AGENT_SERVER_LOCAL_PATH  Absolute path to a local software-agent-sdk checkout (highest precedence)
   OH_AGENT_SERVER_GIT_REF     Git ref for agent-server SDK (overrides default version)
   OH_AGENT_SERVER_VERSION     Specific PyPI version for agent-server
@@ -270,10 +271,34 @@ ACCESS POINTS:
 `);
 }
 
+/**
+ * Fail fast on an unusable OH_AUTOMATION_LOCAL_PATH instead of letting
+ * `uv run --project <bad path>` exit on its own -- that leaves the rest of the
+ * stack up and the automations UI just reporting "backend unavailable", with
+ * nothing pointing at the env var. Mirrors validateLocalAgentServerPath.
+ */
+function validateLocalAutomationPath(localPath) {
+  if (!isAbsolute(localPath)) {
+    throw new Error(
+      `OH_AUTOMATION_LOCAL_PATH must be an absolute path, got: ${localPath}`,
+    );
+  }
+  if (!existsSync(localPath)) {
+    throw new Error(`OH_AUTOMATION_LOCAL_PATH does not exist: ${localPath}`);
+  }
+  const projectFile = join(localPath, "pyproject.toml");
+  if (!existsSync(projectFile)) {
+    throw new Error(
+      `OH_AUTOMATION_LOCAL_PATH is not a Python project (no pyproject.toml): ${projectFile}`,
+    );
+  }
+}
+
 /**
  * Build the uvx command for running automation backend.
  *
  * Environment variables (highest precedence first):
+ * - OH_AUTOMATION_LOCAL_PATH: Absolute path to a local checkout
  * - OH_AUTOMATION_GIT_REF: Git commit SHA or branch name
  * - OH_AUTOMATION_VERSION: Specific PyPI version (e.g., "1.0.0a1")
  *
@@ -282,6 +307,7 @@ ACCESS POINTS:
  * git branch or commit instead.
  */
 function buildAutomationCommand(env = process.env) {
+  const localPath = env.OH_AUTOMATION_LOCAL_PATH;
   const gitRef = env.OH_AUTOMATION_GIT_REF;
   const version = env.OH_AUTOMATION_VERSION;
   const repoUrl = env.OH_AUTOMATION_REPO || DEFAULT_AUTOMATION_REPO;
@@ -289,6 +315,25 @@ function buildAutomationCommand(env = process.env) {
   const uvxArgs = [];
   let source = "";
 
+  if (localPath) {
+    // Run straight from a local checkout via `uv run --project`, so
+    // uncommitted working-tree changes are picked up. Outranks the other
+    // automation env vars, mirroring OH_AGENT_SERVER_LOCAL_PATH for the
+    // agent-server SDK; buildConfig drops it when --automation-git-ref asks
+    // for a specific ref.
+    return {
+      command: "uv",
+      args: [
+        "run",
+        "--project",
+        localPath,
+        "uvicorn",
+        "openhands.automation.app:app",
+      ],
+      source: `local (${localPath})`,
+    };
+  }
+
   if (gitRef) {
     // Use git ref - refresh to ensure latest commit is fetched
     const gitUrl = `git+${repoUrl}@${gitRef}`;
@@ -331,6 +376,17 @@ async function buildConfig(args, env = process.env) {
   // Apply args to env for buildAutomationCommand
   if (args.automationGitRef) {
     env.OH_AUTOMATION_GIT_REF = args.automationGitRef;
+    // An explicit flag outranks an ambient env var. Otherwise someone with
+    // OH_AUTOMATION_LOCAL_PATH exported in their shell profile would run their
+    // own working tree while believing they were reproducing against the ref
+    // they just passed.
+    if (env.OH_AUTOMATION_LOCAL_PATH) {
+      logStep(
+        "automation",
+        `--automation-git-ref ${args.automationGitRef} overrides OH_AUTOMATION_LOCAL_PATH (${env.OH_AUTOMATION_LOCAL_PATH})`,
+      );
+      delete env.OH_AUTOMATION_LOCAL_PATH;
+    }
   }
   if (args.automationRepo) {
     env.OH_AUTOMATION_REPO = args.automationRepo;
@@ -730,17 +786,34 @@ function getFrontendBackend(config) {
 }
 
 function buildViteBackendEnv(config, env = process.env) {
-  const backendBaseUrl = config.launchAgentServer
-    ? `http://127.0.0.1:${config.ingressPort}`
-    : (env.VITE_BACKEND_BASE_URL ?? "http://127.0.0.1:8000");
+  // VITE_BACKEND_HOST tells the Vite dev-server proxy (vite.config.ts) where
+  // to forward /api, /sockets, etc.  It is NOT read by the frontend at
+  // runtime, so it is safe to keep as an absolute address.
+  //
+  // VITE_BACKEND_BASE_URL is intentionally left unset so the frontend falls
+  // back to window.location.origin (same-origin) at runtime — matching the
+  // behaviour of dev:static / agent-canvas and keeping the dev server
+  // portable across localhost, LAN hosts, SSH tunnels, and ngrok.
   const backendHost = config.launchAgentServer
     ? `127.0.0.1:${config.ingressPort}`
-    : (env.VITE_BACKEND_HOST ?? new URL(backendBaseUrl).host);
+    : (env.VITE_BACKEND_HOST ??
+      env.VITE_BACKEND_BASE_URL?.replace(/^https?:\/\//, "") ??
+      "127.0.0.1:8000");
 
-  return {
-    VITE_BACKEND_HOST: backendHost,
-    VITE_BACKEND_BASE_URL: backendBaseUrl,
-  };
+  const env_out = { VITE_BACKEND_HOST: backendHost };
+
+  // If the user supplied VITE_BACKEND_BASE_URL with an https:// scheme and
+  // did not explicitly set VITE_USE_TLS, propagate the HTTPS intent so the
+  // Vite proxy forwards over TLS instead of plain HTTP.
+  if (
+    !config.launchAgentServer &&
+    env.VITE_BACKEND_BASE_URL?.startsWith("https://") &&
+    env.VITE_USE_TLS === undefined
+  ) {
+    env_out.VITE_USE_TLS = "true";
+  }
+
+  return env_out;
 }
 
 function buildAgentServerAutomationEnv(config) {
@@ -1330,6 +1403,21 @@ async function main(options = {}) {
     }
   }
 
+  // Same for the automation checkout -- skipped when --automation-git-ref was
+  // passed, since buildConfig drops the env var in favor of the explicit flag.
+  if (
+    !args.frontendOnly &&
+    !args.automationGitRef &&
+    process.env.OH_AUTOMATION_LOCAL_PATH
+  ) {
+    try {
+      validateLocalAutomationPath(process.env.OH_AUTOMATION_LOCAL_PATH);
+    } catch (error) {
+      logError(error instanceof Error ? error.message : String(error));
+      process.exit(1);
+    }
+  }
+
   // Build config with dynamic port allocation
   const config = await buildConfig(args);
   if (viteWorkingDir) config.viteWorkingDir = viteWorkingDir;
@@ -1504,6 +1592,7 @@ export {
   registerShutdownHook,
   spawnService,
   commandExists,
+  validateLocalAutomationPath,
   logService,
   logStep,
   logSuccess,