graphlit-client 1.0.20260416002 → 1.0.20260418002

package/dist/client.d.ts

@@ -3012,9 +3012,30 @@ declare class Graphlit {
      */
     private reconstructTurnResults;
     /**
-     * Extract task_complete summary from intermediate messages.
+     * Detect whether task_complete was invoked in a single list of tool calls.
+     *
+     * Recognizes two invocation shapes:
+     *   1. Direct — a tool call whose `name` is `"task_complete"`.
+     *   2. Wrapped — a tool call whose arguments JSON has shape
+     *      `{ tool: "task_complete", parameters: { summary?, ... } }`. This is
+     *      the common pattern used by dynamic-toolset clients that expose a
+     *      single meta-executor (often named `execute_tool`) at the top level
+     *      and route every underlying tool through it.
+     *
+     * Detection is invocation-agnostic: whether the model called task_complete
+     * directly or via a meta-executor, the harness treats the turn as complete
+     * and surfaces the provided summary. Callers that only register a direct
+     * top-level task_complete still work — the wrapped path is simply inert
+     * when no meta-executor is in use.
+     */
+    private detectTaskComplete;
+    /**
+     * Scan a list of messages for a task_complete invocation. Returns the first
+     * match found across all tool calls in all messages. Convenience wrapper
+     * over `detectTaskComplete` for the streamAgent loop, which works with
+     * `intermediateMessages` rather than a single tool-call list.
      */
-    private extractTaskCompleteSummary;
+    private detectTaskCompleteInMessages;
     /**
      * Run LLM-as-judge quality assessment on a completed agent run.
      */

package/dist/client.js

@@ -7168,7 +7168,8 @@ class Graphlit {
                 }
                 // 9. Build TurnResult
                 const turnDuration = Date.now() - turnStart;
-                const taskCompleteThisTurn = loopResult.toolCallNames.includes("task_complete");
+                const taskCompleteInfo = this.detectTaskCompleteInMessages(loopResult.intermediateMessages);
+                const taskCompleteThisTurn = taskCompleteInfo.called;
                 const turnToolNames = [...new Set(loopResult.toolCallNames)].sort();
                 const turnResult = {
                     turnNumber: turn,
@@ -7196,8 +7197,7 @@ class Graphlit {
                 // 11. Evaluate turn
                 // a. task_complete called?
                 if (taskCompleteThisTurn) {
-                    // Extract summary from task_complete arguments
-                    taskCompleteSummary = this.extractTaskCompleteSummary(loopResult.intermediateMessages);
+                    taskCompleteSummary = taskCompleteInfo.summary;
                     status = "completed";
                     break;
                 }
@@ -7382,32 +7382,82 @@ class Graphlit {
                 toolCalls: [...new Set(toolNames)].sort(),
                 toolCallCount: toolNames.length,
                 durationMs: computePersistedToolRoundDurationMs(assistantMsg.toolCalls) ?? 0,
-                taskComplete: toolNames.includes("task_complete"),
+                taskComplete: this.detectTaskComplete(assistantMsg.toolCalls).called,
                 errors: toolErrors.length > 0 ? toolErrors : undefined,
             });
         }
         return results;
     }
     /**
-     * Extract task_complete summary from intermediate messages.
-     */
-    extractTaskCompleteSummary(messages) {
-        for (const msg of messages) {
-            if (msg.toolCalls) {
-                for (const tc of msg.toolCalls) {
-                    if (tc && tc.name === "task_complete" && tc.arguments) {
-                        try {
-                            const args = JSON.parse(tc.arguments);
-                            return args.summary ?? undefined;
-                        }
-                        catch {
-                            return undefined;
-                        }
+     * Detect whether task_complete was invoked in a single list of tool calls.
+     *
+     * Recognizes two invocation shapes:
+     *   1. Direct — a tool call whose `name` is `"task_complete"`.
+     *   2. Wrapped — a tool call whose arguments JSON has shape
+     *      `{ tool: "task_complete", parameters: { summary?, ... } }`. This is
+     *      the common pattern used by dynamic-toolset clients that expose a
+     *      single meta-executor (often named `execute_tool`) at the top level
+     *      and route every underlying tool through it.
+     *
+     * Detection is invocation-agnostic: whether the model called task_complete
+     * directly or via a meta-executor, the harness treats the turn as complete
+     * and surfaces the provided summary. Callers that only register a direct
+     * top-level task_complete still work — the wrapped path is simply inert
+     * when no meta-executor is in use.
+     */
+    detectTaskComplete(toolCalls) {
+        if (!toolCalls)
+            return { called: false };
+        for (const tc of toolCalls) {
+            if (!tc)
+                continue;
+            // Direct invocation
+            if (tc.name === "task_complete") {
+                if (!tc.arguments)
+                    return { called: true };
+                try {
+                    const args = JSON.parse(tc.arguments);
+                    return {
+                        called: true,
+                        summary: typeof args.summary === "string" ? args.summary : undefined,
+                    };
+                }
+                catch {
+                    return { called: true };
+                }
+            }
+            // Meta-executor wrapping (e.g. execute_tool({ tool: "task_complete", parameters: {...} }))
+            if (tc.arguments) {
+                try {
+                    const args = JSON.parse(tc.arguments);
+                    if (args.tool === "task_complete") {
+                        const params = args.parameters ?? {};
+                        return {
+                            called: true,
+                            summary: typeof params.summary === "string" ? params.summary : undefined,
+                        };
                     }
                 }
+                catch {
+                    // Not JSON — skip
+                }
             }
         }
-        return undefined;
+        return { called: false };
+    }
+    /**
+     * Scan a list of messages for a task_complete invocation. Returns the first
+     * match found across all tool calls in all messages. Convenience wrapper
+     * over `detectTaskComplete` for the streamAgent loop, which works with
+     * `intermediateMessages` rather than a single tool-call list.
+     */
+    detectTaskCompleteInMessages(messages) {
+        for (const msg of messages) {
+            const result = this.detectTaskComplete(msg.toolCalls);
+            if (result.called)
+                return result;
+        }
+        return { called: false };
     }
     /**
      * Run LLM-as-judge quality assessment on a completed agent run.

package/dist/generated/graphql-documents.js

@@ -2187,6 +2187,7 @@ export const DescribeEncodedImage = gql `
         fileMetadata
         relativeFolderPath
         masterUri
+        markdownUri
         imageUri
         textUri
         audioUri
@@ -2342,6 +2343,7 @@ export const DescribeImage = gql `
         fileMetadata
         relativeFolderPath
         masterUri
+        markdownUri
         imageUri
         textUri
         audioUri
@@ -2710,6 +2712,7 @@ export const GetContent = gql `
     fileMetadata
     relativeFolderPath
     masterUri
+    markdownUri
     imageUri
     textUri
     audioUri
@@ -3615,6 +3618,7 @@ export const LookupContents = gql `
       fileMetadata
       relativeFolderPath
       masterUri
+      markdownUri
       imageUri
       textUri
       audioUri
@@ -4095,6 +4099,7 @@ export const PublishContents = gql `
       fileMetadata
       relativeFolderPath
       masterUri
+      markdownUri
       imageUri
       textUri
       audioUri
@@ -4244,6 +4249,7 @@ export const PublishText = gql `
       fileMetadata
       relativeFolderPath
       masterUri
+      markdownUri
       imageUri
       textUri
       audioUri
@@ -4385,6 +4391,7 @@ export const QueryContents = gql `
       fileSize
       relativeFolderPath
       masterUri
+      markdownUri
       imageUri
       textUri
       audioUri
@@ -4838,6 +4845,7 @@ export const QueryContentsObservations = gql `
       fileSize
       relativeFolderPath
       masterUri
+      markdownUri
       imageUri
       textUri
       audioUri
@@ -5502,6 +5510,7 @@ export const AskGraphlit = gql `
           fileMetadata
           relativeFolderPath
           masterUri
+          markdownUri
           imageUri
           textUri
           audioUri
@@ -5697,6 +5706,7 @@ export const CompleteConversation = gql `
           fileMetadata
           relativeFolderPath
           masterUri
+          markdownUri
           imageUri
           textUri
           audioUri
@@ -5897,6 +5907,7 @@ export const CompleteConversation = gql `
             fileMetadata
             relativeFolderPath
             masterUri
+            markdownUri
             imageUri
             textUri
             audioUri
@@ -6057,6 +6068,7 @@ export const ContinueConversation = gql `
           fileMetadata
           relativeFolderPath
           masterUri
+          markdownUri
           imageUri
           textUri
           audioUri
@@ -6257,6 +6269,7 @@ export const ContinueConversation = gql `
             fileMetadata
             relativeFolderPath
             masterUri
+            markdownUri
             imageUri
             textUri
             audioUri
@@ -6470,6 +6483,7 @@ export const FormatConversation = gql `
           fileMetadata
           relativeFolderPath
           masterUri
+          markdownUri
           imageUri
           textUri
           audioUri
@@ -6670,6 +6684,7 @@ export const FormatConversation = gql `
             fileMetadata
             relativeFolderPath
             masterUri
+            markdownUri
             imageUri
             textUri
             audioUri
@@ -6836,6 +6851,7 @@ export const GetConversation = gql `
           fileMetadata
           relativeFolderPath
           masterUri
+          markdownUri
           imageUri
           textUri
           audioUri
@@ -6985,6 +7001,7 @@ export const GetConversation = gql `
             fileMetadata
             relativeFolderPath
             masterUri
+            markdownUri
             imageUri
             textUri
             audioUri
@@ -7407,6 +7424,7 @@ export const Prompt = gql `
           fileMetadata
           relativeFolderPath
           masterUri
+          markdownUri
           imageUri
           textUri
           audioUri
@@ -7578,6 +7596,7 @@ export const PromptConversation = gql `
           fileMetadata
           relativeFolderPath
           masterUri
+          markdownUri
           imageUri
           textUri
           audioUri
@@ -7778,6 +7797,7 @@ export const PromptConversation = gql `
             fileMetadata
             relativeFolderPath
             masterUri
+            markdownUri
             imageUri
             textUri
             audioUri
@@ -7934,6 +7954,7 @@ export const PublishConversation = gql `
       fileMetadata
       relativeFolderPath
       masterUri
+      markdownUri
       imageUri
       textUri
       audioUri
@@ -8701,6 +8722,7 @@ export const ReviseContent = gql `
           fileMetadata
           relativeFolderPath
           masterUri
+          markdownUri
           imageUri
           textUri
           audioUri
@@ -8864,6 +8886,7 @@ export const ReviseEncodedImage = gql `
           fileMetadata
           relativeFolderPath
           masterUri
+          markdownUri
           imageUri
           textUri
           audioUri
@@ -9026,6 +9049,7 @@ export const ReviseImage = gql `
           fileMetadata
           relativeFolderPath
           masterUri
+          markdownUri
           imageUri
           textUri
           audioUri
@@ -9188,6 +9212,7 @@ export const ReviseText = gql `
           fileMetadata
           relativeFolderPath
           masterUri
+          markdownUri
           imageUri
           textUri
           audioUri
@@ -18764,6 +18789,7 @@ export const PromptSpecifications = gql `
           fileMetadata
           relativeFolderPath
           masterUri
+          markdownUri
           imageUri
           textUri
           audioUri

package/dist/generated/graphql-types.d.ts

@@ -3477,8 +3477,10 @@ export type Content = {
     links?: Maybe<Array<LinkReference>>;
     /** The geo-location of the content. */
     location?: Maybe<Point>;
-    /** The content text formatted as Markdown.  Contains either the extracted text for files, posts, etc., or the raw text for messages, emails, etc. Export is bounded by stored token count. */
+    /** The content text formatted as Markdown. Returns the persisted frontmatter-aware Markdown export when available, and otherwise falls back to on-demand export. Export is bounded by stored token count. */
     markdown?: Maybe<Scalars['String']['output']>;
+    /** The persisted Markdown export URI of the content. This references the frontmatter-aware Markdown file written under the content folder. */
+    markdownUri?: Maybe<Scalars['URL']['output']>;
     /** The master rendition URI of the content. This references a cached rendition of the source content. */
     masterUri?: Maybe<Scalars['URL']['output']>;
     /** The content meeting metadata. */
@@ -6916,6 +6918,8 @@ export declare enum EntityTypes {
     Project = "PROJECT",
     /** Rendition */
     Rendition = "RENDITION",
+    /** Replica */
+    Replica = "REPLICA",
     /** Code repository */
     Repo = "REPO",
     /** Cloud storage site */
@@ -28898,6 +28902,7 @@ export type DescribeEncodedImageMutation = {
                 fileMetadata?: string | null;
                 relativeFolderPath?: string | null;
                 masterUri?: any | null;
+                markdownUri?: any | null;
                 imageUri?: any | null;
                 textUri?: any | null;
                 audioUri?: any | null;
@@ -29062,6 +29067,7 @@ export type DescribeImageMutation = {
                 fileMetadata?: string | null;
                 relativeFolderPath?: string | null;
                 masterUri?: any | null;
+                markdownUri?: any | null;
                 imageUri?: any | null;
                 textUri?: any | null;
                 audioUri?: any | null;
@@ -29417,6 +29423,7 @@ export type GetContentQuery = {
         fileMetadata?: string | null;
         relativeFolderPath?: string | null;
         masterUri?: any | null;
+        markdownUri?: any | null;
         imageUri?: any | null;
         textUri?: any | null;
         audioUri?: any | null;
@@ -30436,6 +30443,7 @@ export type LookupContentsQuery = {
             fileMetadata?: string | null;
             relativeFolderPath?: string | null;
             masterUri?: any | null;
+            markdownUri?: any | null;
             imageUri?: any | null;
             textUri?: any | null;
             audioUri?: any | null;
@@ -31015,6 +31023,7 @@ export type PublishContentsMutation = {
             fileMetadata?: string | null;
             relativeFolderPath?: string | null;
             masterUri?: any | null;
+            markdownUri?: any | null;
             imageUri?: any | null;
             textUri?: any | null;
             audioUri?: any | null;
@@ -31178,6 +31187,7 @@ export type PublishTextMutation = {
             fileMetadata?: string | null;
             relativeFolderPath?: string | null;
             masterUri?: any | null;
+            markdownUri?: any | null;
             imageUri?: any | null;
             textUri?: any | null;
             audioUri?: any | null;
@@ -31316,6 +31326,7 @@ export type QueryContentsQuery = {
             fileSize?: any | null;
             relativeFolderPath?: string | null;
             masterUri?: any | null;
+            markdownUri?: any | null;
             imageUri?: any | null;
             textUri?: any | null;
             audioUri?: any | null;
@@ -31836,6 +31847,7 @@ export type QueryContentsObservationsQuery = {
             fileSize?: any | null;
             relativeFolderPath?: string | null;
             masterUri?: any | null;
+            markdownUri?: any | null;
             imageUri?: any | null;
             textUri?: any | null;
             audioUri?: any | null;
@@ -32642,6 +32654,7 @@ export type AskGraphlitMutation = {
                     fileMetadata?: string | null;
                     relativeFolderPath?: string | null;
                     masterUri?: any | null;
+                    markdownUri?: any | null;
                     imageUri?: any | null;
                     textUri?: any | null;
                     audioUri?: any | null;
@@ -32857,6 +32870,7 @@ export type CompleteConversationMutation = {
                     fileMetadata?: string | null;
                     relativeFolderPath?: string | null;
                     masterUri?: any | null;
+                    markdownUri?: any | null;
                     imageUri?: any | null;
                     textUri?: any | null;
                     audioUri?: any | null;
@@ -33073,6 +33087,7 @@ export type CompleteConversationMutation = {
                         fileMetadata?: string | null;
                         relativeFolderPath?: string | null;
                         masterUri?: any | null;
+                        markdownUri?: any | null;
                         imageUri?: any | null;
                         textUri?: any | null;
                         audioUri?: any | null;
@@ -33245,6 +33260,7 @@ export type ContinueConversationMutation = {
                     fileMetadata?: string | null;
                     relativeFolderPath?: string | null;
                     masterUri?: any | null;
+                    markdownUri?: any | null;
                     imageUri?: any | null;
                     textUri?: any | null;
                     audioUri?: any | null;
@@ -33461,6 +33477,7 @@ export type ContinueConversationMutation = {
                         fileMetadata?: string | null;
                         relativeFolderPath?: string | null;
                         masterUri?: any | null;
+                        markdownUri?: any | null;
                         imageUri?: any | null;
                         textUri?: any | null;
                         audioUri?: any | null;
@@ -33702,6 +33719,7 @@ export type FormatConversationMutation = {
                     fileMetadata?: string | null;
                     relativeFolderPath?: string | null;
                     masterUri?: any | null;
+                    markdownUri?: any | null;
                     imageUri?: any | null;
                     textUri?: any | null;
                     audioUri?: any | null;
@@ -33918,6 +33936,7 @@ export type FormatConversationMutation = {
                         fileMetadata?: string | null;
                         relativeFolderPath?: string | null;
                         masterUri?: any | null;
+                        markdownUri?: any | null;
                         imageUri?: any | null;
                         textUri?: any | null;
                         audioUri?: any | null;
@@ -34103,6 +34122,7 @@ export type GetConversationQuery = {
                     fileMetadata?: string | null;
                     relativeFolderPath?: string | null;
                     masterUri?: any | null;
+                    markdownUri?: any | null;
                     imageUri?: any | null;
                     textUri?: any | null;
                     audioUri?: any | null;
@@ -34266,6 +34286,7 @@ export type GetConversationQuery = {
                         fileMetadata?: string | null;
                         relativeFolderPath?: string | null;
                         masterUri?: any | null;
+                        markdownUri?: any | null;
                         imageUri?: any | null;
                         textUri?: any | null;
                         audioUri?: any | null;
@@ -34756,6 +34777,7 @@ export type PromptMutation = {
                     fileMetadata?: string | null;
                     relativeFolderPath?: string | null;
                     masterUri?: any | null;
+                    markdownUri?: any | null;
                     imageUri?: any | null;
                     textUri?: any | null;
                     audioUri?: any | null;
@@ -34938,6 +34960,7 @@ export type PromptConversationMutation = {
                     fileMetadata?: string | null;
                     relativeFolderPath?: string | null;
                     masterUri?: any | null;
+                    markdownUri?: any | null;
                     imageUri?: any | null;
                     textUri?: any | null;
                     audioUri?: any | null;
@@ -35154,6 +35177,7 @@ export type PromptConversationMutation = {
                         fileMetadata?: string | null;
                         relativeFolderPath?: string | null;
                         masterUri?: any | null;
+                        markdownUri?: any | null;
                         imageUri?: any | null;
                         textUri?: any | null;
                         audioUri?: any | null;
@@ -35299,6 +35323,7 @@ export type PublishConversationMutation = {
             fileMetadata?: string | null;
             relativeFolderPath?: string | null;
             masterUri?: any | null;
+            markdownUri?: any | null;
             imageUri?: any | null;
             textUri?: any | null;
             audioUri?: any | null;
@@ -36258,6 +36283,7 @@ export type ReviseContentMutation = {
                     fileMetadata?: string | null;
                     relativeFolderPath?: string | null;
                     masterUri?: any | null;
+                    markdownUri?: any | null;
                     imageUri?: any | null;
                     textUri?: any | null;
                     audioUri?: any | null;
@@ -36432,6 +36458,7 @@ export type ReviseEncodedImageMutation = {
                     fileMetadata?: string | null;
                     relativeFolderPath?: string | null;
                     masterUri?: any | null;
+                    markdownUri?: any | null;
                     imageUri?: any | null;
                     textUri?: any | null;
                     audioUri?: any | null;
@@ -36605,6 +36632,7 @@ export type ReviseImageMutation = {
                     fileMetadata?: string | null;
                     relativeFolderPath?: string | null;
                     masterUri?: any | null;
+                    markdownUri?: any | null;
                     imageUri?: any | null;
                     textUri?: any | null;
                     audioUri?: any | null;
@@ -36778,6 +36806,7 @@ export type ReviseTextMutation = {
                     fileMetadata?: string | null;
                     relativeFolderPath?: string | null;
                     masterUri?: any | null;
+                    markdownUri?: any | null;
                     imageUri?: any | null;
                     textUri?: any | null;
                     audioUri?: any | null;
@@ -48388,6 +48417,7 @@ export type PromptSpecificationsMutation = {
                     fileMetadata?: string | null;
                     relativeFolderPath?: string | null;
                     masterUri?: any | null;
+                    markdownUri?: any | null;
                     imageUri?: any | null;
                     textUri?: any | null;
                     audioUri?: any | null;

package/dist/generated/graphql-types.js

@@ -1196,6 +1196,8 @@ export var EntityTypes;
     EntityTypes["Project"] = "PROJECT";
     /** Rendition */
     EntityTypes["Rendition"] = "RENDITION";
+    /** Replica */
+    EntityTypes["Replica"] = "REPLICA";
     /** Code repository */
     EntityTypes["Repo"] = "REPO";
     /** Cloud storage site */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "graphlit-client",
-  "version": "1.0.20260416002",
+  "version": "1.0.20260418002",
   "description": "Graphlit API Client for TypeScript",
   "type": "module",
   "main": "./dist/client.js",