@squidcloud/client 1.0.480 → 1.0.482

package/dist/internal-common/src/public-types/ai-agent.public-types.d.ts

@@ -715,6 +715,13 @@ export declare const AGENT_STATUS_TITLE_CALLING_AI_FUNCTION = "Calling AI Functi
  * @category AI
  */
 export declare const AGENT_STATUS_TITLE_INSPECTING_KB_METADATA = "Inspecting Knowledge Base Metadata";
+/**
+ * Status update title broadcast when the agent invokes the knowledge-graph query callable (offered
+ * automatically for graph-enabled KBs). Distinct from {@link AGENT_STATUS_TITLE_ACCESSING_KB} so a
+ * caller can tell graph navigation apart from an ordinary KB search.
+ * @category AI
+ */
+export declare const AGENT_STATUS_TITLE_QUERYING_KB_GRAPH = "Querying Knowledge Base Graph";
 /**
  * Status update title broadcast when the agent queries a spreadsheet file callable.
  * @category AI
@@ -845,6 +852,19 @@ export interface UpsertContextStatusSuccess extends BaseUpsertContextStatus {
  * @category AI
  */
 export type UpsertContextErrorCode = 'DUPLICATE_CONTENT';
+/**
+ * The existing context a `DUPLICATE_CONTENT` rejection points at — where the byte-identical original
+ * already lives.
+ * @category AI
+ */
+export interface UpsertContextDuplicateOf {
+    /** The id of the already-stored context whose content is byte-identical to the rejected request. */
+    contextId: string;
+    /** The existing context's source reference (file name / URL), when it has one. */
+    reference?: string;
+    /** The existing context's `folderPath` metadata, when it was ingested with a folder path. */
+    folderPath?: string;
+}
 /**
  * Status of an individual context item after it failed to upsert.
  *
@@ -858,6 +878,12 @@ export interface UpsertContextStatusError extends BaseUpsertContextStatus {
     errorMessage: string;
     /** Machine-readable code for the failure, when one applies. */
     errorCode?: UpsertContextErrorCode;
+    /**
+     * The existing context this request duplicated, when `errorCode` is `DUPLICATE_CONTENT`. Lets a caller
+     * point the user at where the original already lives (e.g. its folder) instead of only reporting the
+     * rejection. `reference`/`folderPath` are present when the existing context carries them.
+     */
+    duplicateOf?: UpsertContextDuplicateOf;
 }
 /**
  * Status of an individual context item after attempting to upsert it.