graphlit-client 1.0.20260301004 → 1.0.20260302002

package/dist/client.d.ts

@@ -1008,9 +1008,12 @@ declare class Graphlit {
      * @param includeDetails - Whether to include details, optional.
      * @param correlationId - The tenant correlation identifier, optional.
      * @param persona - The persona to use, optional.
+     * @param instructions - Per-turn instructions to inject into guidance, optional.
+     * @param scratchpad - Per-turn scratchpad text to inject, optional. Merged with conversation scratchpad.
+     * @param skills - Skill references to inject into the agent's context window, optional.
      * @returns The formatted conversation.
      */
-    formatConversation(prompt: string, id?: string, specification?: Types.EntityReferenceInput, tools?: Types.ToolDefinitionInput[], systemPrompt?: string, includeDetails?: boolean, correlationId?: string, persona?: Types.EntityReferenceInput, instructions?: string): Promise<Types.FormatConversationMutation>;
+    formatConversation(prompt: string, id?: string, specification?: Types.EntityReferenceInput, tools?: Types.ToolDefinitionInput[], systemPrompt?: string, includeDetails?: boolean, correlationId?: string, persona?: Types.EntityReferenceInput, instructions?: string, scratchpad?: string, skills?: Types.EntityReferenceInput[]): Promise<Types.FormatConversationMutation>;
     /**
      * Completes a conversation with an external LLM response.
      * @param completion - The completion text from the external LLM.
@@ -1053,9 +1056,12 @@ declare class Graphlit {
      * @param includeDetails - Whether to include details, optional.
      * @param correlationId - The tenant correlation identifier, optional.
      * @param persona - The persona to use, optional.
+     * @param instructions - Per-turn instructions to inject into guidance, optional.
+     * @param scratchpad - Per-turn scratchpad text to inject, optional. Merged with conversation scratchpad.
+     * @param skills - Skill references to inject into the agent's context window, optional.
      * @returns The conversation response.
      */
-    promptConversation(prompt: string, id?: string, specification?: Types.EntityReferenceInput, mimeType?: string, data?: string, tools?: Types.ToolDefinitionInput[], requireTool?: boolean, systemPrompt?: string, includeDetails?: boolean, correlationId?: string, persona?: Types.EntityReferenceInput, instructions?: string): Promise<Types.PromptConversationMutation>;
+    promptConversation(prompt: string, id?: string, specification?: Types.EntityReferenceInput, mimeType?: string, data?: string, tools?: Types.ToolDefinitionInput[], requireTool?: boolean, systemPrompt?: string, includeDetails?: boolean, correlationId?: string, persona?: Types.EntityReferenceInput, instructions?: string, scratchpad?: string, skills?: Types.EntityReferenceInput[]): Promise<Types.PromptConversationMutation>;
     /**
      * Continues a conversation with tool responses.
      * @param id - The conversation ID.
@@ -1369,6 +1375,93 @@ declare class Graphlit {
      * @returns The matching persons.
      */
     lookupPersons(linkedInUrl?: string, email?: string): Promise<Types.LookupPersonsQuery>;
+    /**
+     * Creates a skill.
+     * @param skill - The skill to create.
+     * @param correlationId - The tenant correlation identifier, optional.
+     * @returns The created skill.
+     */
+    createSkill(skill: Types.SkillInput, correlationId?: string): Promise<Types.CreateSkillMutation>;
+    /**
+     * Updates a skill.
+     * @param skill - The skill to update.
+     * @returns The updated skill.
+     */
+    updateSkill(skill: Types.SkillUpdateInput): Promise<Types.UpdateSkillMutation>;
+    /**
+     * Creates or updates a skill.
+     * @param skill - The skill to create or update.
+     * @returns The created or updated skill.
+     */
+    upsertSkill(skill: Types.SkillInput): Promise<Types.UpsertSkillMutation>;
+    /**
+     * Deletes a skill.
+     * @param id - The ID of the skill to delete.
+     * @returns The deleted skill.
+     */
+    deleteSkill(id: string): Promise<Types.DeleteSkillMutation>;
+    /**
+     * Deletes multiple skills.
+     * @param ids - The IDs of the skills to delete.
+     * @param isSynchronous - Whether this mutation is synchronous.
+     * @returns The deleted skills.
+     */
+    deleteSkills(ids: string[], isSynchronous?: boolean): Promise<Types.DeleteSkillsMutation>;
+    /**
+     * Deletes all skills based on the provided filter criteria.
+     * @param filter - The filter criteria to apply when deleting skills.
+     * @param isSynchronous - Whether this mutation is synchronous.
+     * @param correlationId - The tenant correlation identifier, optional.
+     * @returns The result of the deletion.
+     */
+    deleteAllSkills(filter?: Types.SkillFilter, isSynchronous?: boolean, correlationId?: string): Promise<Types.DeleteAllSkillsMutation>;
+    /**
+     * Enables a skill.
+     * @param id - The ID of the skill to enable.
+     * @returns The enabled skill.
+     */
+    enableSkill(id: string): Promise<Types.EnableSkillMutation>;
+    /**
+     * Disables a skill.
+     * @param id - The ID of the skill to disable.
+     * @returns The disabled skill.
+     */
+    disableSkill(id: string): Promise<Types.DisableSkillMutation>;
+    /**
+     * Lookup a skill given its ID.
+     * @param id - ID of the skill.
+     * @param correlationId - The tenant correlation identifier, optional.
+     * @returns The skill.
+     */
+    getSkill(id: string, correlationId?: string): Promise<Types.GetSkillQuery>;
+    /**
+     * Retrieves skills based on the provided filter criteria.
+     * @param filter - The filter criteria to apply when retrieving skills.
+     * @param correlationId - The tenant correlation identifier, optional.
+     * @returns The skills.
+     */
+    querySkills(filter?: Types.SkillFilter, correlationId?: string): Promise<Types.QuerySkillsQuery>;
+    /**
+     * Counts skills based on the provided filter criteria.
+     * @param filter - The filter criteria to apply when counting skills.
+     * @param correlationId - The tenant correlation identifier, optional.
+     * @returns The count of skills.
+     */
+    countSkills(filter?: Types.SkillFilter, correlationId?: string): Promise<Types.CountSkillsQuery>;
+    /**
+     * Adds skills to one or more collections.
+     * @param skills - The skills to add.
+     * @param collections - The collections to add the skills to.
+     * @returns The updated collections.
+     */
+    addSkillsToCollections(skills: Types.EntityReferenceInput[], collections: Types.EntityReferenceInput[]): Promise<Types.AddSkillsToCollectionsMutation>;
+    /**
+     * Removes skills from a collection.
+     * @param skills - The skills to remove.
+     * @param collection - The collection to remove the skills from.
+     * @returns The updated collection.
+     */
+    removeSkillsFromCollection(skills: Types.EntityReferenceInput[], collection: Types.EntityReferenceInput): Promise<Types.RemoveSkillsFromCollectionMutation>;
     /**
      * Prompts multiple specifications and returns the best response.
      * @param prompt - The prompt to send to each specification.

package/dist/client.js

@@ -1863,9 +1863,12 @@ class Graphlit {
      * @param includeDetails - Whether to include details, optional.
      * @param correlationId - The tenant correlation identifier, optional.
      * @param persona - The persona to use, optional.
+     * @param instructions - Per-turn instructions to inject into guidance, optional.
+     * @param scratchpad - Per-turn scratchpad text to inject, optional. Merged with conversation scratchpad.
+     * @param skills - Skill references to inject into the agent's context window, optional.
      * @returns The formatted conversation.
      */
-    async formatConversation(prompt, id, specification, tools, systemPrompt, includeDetails, correlationId, persona, instructions) {
+    async formatConversation(prompt, id, specification, tools, systemPrompt, includeDetails, correlationId, persona, instructions, scratchpad, skills) {
         return this.mutateAndCheckError(Documents.FormatConversation, {
             prompt: prompt,
             id: id,
@@ -1876,6 +1879,8 @@ class Graphlit {
             includeDetails: includeDetails,
             correlationId: correlationId,
             instructions: instructions,
+            scratchpad: scratchpad,
+            skills: skills,
         });
     }
     /**
@@ -1943,9 +1948,12 @@ class Graphlit {
      * @param includeDetails - Whether to include details, optional.
      * @param correlationId - The tenant correlation identifier, optional.
      * @param persona - The persona to use, optional.
+     * @param instructions - Per-turn instructions to inject into guidance, optional.
+     * @param scratchpad - Per-turn scratchpad text to inject, optional. Merged with conversation scratchpad.
+     * @param skills - Skill references to inject into the agent's context window, optional.
      * @returns The conversation response.
      */
-    async promptConversation(prompt, id, specification, mimeType, data, tools, requireTool, systemPrompt, includeDetails, correlationId, persona, instructions) {
+    async promptConversation(prompt, id, specification, mimeType, data, tools, requireTool, systemPrompt, includeDetails, correlationId, persona, instructions, scratchpad, skills) {
         return this.mutateAndCheckError(Documents.PromptConversation, {
             prompt: prompt,
             id: id,
@@ -1959,6 +1967,8 @@ class Graphlit {
             includeDetails: includeDetails,
             correlationId: correlationId,
             instructions: instructions,
+            scratchpad: scratchpad,
+            skills: skills,
         });
     }
     /**
@@ -2425,6 +2435,126 @@ class Graphlit {
             email: email,
         });
     }
+    // ──────────────────────────────────────────────────────────────────────────
+    // Skills
+    // NOTE: Types (SkillInput, SkillUpdateInput, SkillFilter, etc.) and
+    // Documents (CreateSkill, UpdateSkill, etc.) will be generated by codegen
+    // once the API schema is published. Until then these methods will show
+    // TypeScript errors — that is expected.
+    // ──────────────────────────────────────────────────────────────────────────
+    /**
+     * Creates a skill.
+     * @param skill - The skill to create.
+     * @param correlationId - The tenant correlation identifier, optional.
+     * @returns The created skill.
+     */
+    async createSkill(skill, correlationId) {
+        return this.mutateAndCheckError(Documents.CreateSkill, { skill: skill, correlationId: correlationId });
+    }
+    /**
+     * Updates a skill.
+     * @param skill - The skill to update.
+     * @returns The updated skill.
+     */
+    async updateSkill(skill) {
+        return this.mutateAndCheckError(Documents.UpdateSkill, { skill: skill });
+    }
+    /**
+     * Creates or updates a skill.
+     * @param skill - The skill to create or update.
+     * @returns The created or updated skill.
+     */
+    async upsertSkill(skill) {
+        return this.mutateAndCheckError(Documents.UpsertSkill, { skill: skill });
+    }
+    /**
+     * Deletes a skill.
+     * @param id - The ID of the skill to delete.
+     * @returns The deleted skill.
+     */
+    async deleteSkill(id) {
+        return this.mutateAndCheckError(Documents.DeleteSkill, { id: id });
+    }
+    /**
+     * Deletes multiple skills.
+     * @param ids - The IDs of the skills to delete.
+     * @param isSynchronous - Whether this mutation is synchronous.
+     * @returns The deleted skills.
+     */
+    async deleteSkills(ids, isSynchronous) {
+        return this.mutateAndCheckError(Documents.DeleteSkills, { ids: ids, isSynchronous: isSynchronous });
+    }
+    /**
+     * Deletes all skills based on the provided filter criteria.
+     * @param filter - The filter criteria to apply when deleting skills.
+     * @param isSynchronous - Whether this mutation is synchronous.
+     * @param correlationId - The tenant correlation identifier, optional.
+     * @returns The result of the deletion.
+     */
+    async deleteAllSkills(filter, isSynchronous, correlationId) {
+        return this.mutateAndCheckError(Documents.DeleteAllSkills, { filter: filter, isSynchronous: isSynchronous, correlationId: correlationId });
+    }
+    /**
+     * Enables a skill.
+     * @param id - The ID of the skill to enable.
+     * @returns The enabled skill.
+     */
+    async enableSkill(id) {
+        return this.mutateAndCheckError(Documents.EnableSkill, { id: id });
+    }
+    /**
+     * Disables a skill.
+     * @param id - The ID of the skill to disable.
+     * @returns The disabled skill.
+     */
+    async disableSkill(id) {
+        return this.mutateAndCheckError(Documents.DisableSkill, { id: id });
+    }
+    /**
+     * Lookup a skill given its ID.
+     * @param id - ID of the skill.
+     * @param correlationId - The tenant correlation identifier, optional.
+     * @returns The skill.
+     */
+    async getSkill(id, correlationId) {
+        return this.queryAndCheckError(Documents.GetSkill, { id: id, correlationId: correlationId });
+    }
+    /**
+     * Retrieves skills based on the provided filter criteria.
+     * @param filter - The filter criteria to apply when retrieving skills.
+     * @param correlationId - The tenant correlation identifier, optional.
+     * @returns The skills.
+     */
+    async querySkills(filter, correlationId) {
+        return this.queryAndCheckError(Documents.QuerySkills, { filter: filter, correlationId: correlationId });
+    }
+    /**
+     * Counts skills based on the provided filter criteria.
+     * @param filter - The filter criteria to apply when counting skills.
+     * @param correlationId - The tenant correlation identifier, optional.
+     * @returns The count of skills.
+     */
+    async countSkills(filter, correlationId) {
+        return this.queryAndCheckError(Documents.CountSkills, { filter: filter, correlationId: correlationId });
+    }
+    /**
+     * Adds skills to one or more collections.
+     * @param skills - The skills to add.
+     * @param collections - The collections to add the skills to.
+     * @returns The updated collections.
+     */
+    async addSkillsToCollections(skills, collections) {
+        return this.mutateAndCheckError(Documents.AddSkillsToCollections, { skills: skills, collections: collections });
+    }
+    /**
+     * Removes skills from a collection.
+     * @param skills - The skills to remove.
+     * @param collection - The collection to remove the skills from.
+     * @returns The updated collection.
+     */
+    async removeSkillsFromCollection(skills, collection) {
+        return this.mutateAndCheckError(Documents.RemoveSkillsFromCollection, { skills: skills, collection: collection });
+    }
     /**
      * Prompts multiple specifications and returns the best response.
      * @param prompt - The prompt to send to each specification.
@@ -5075,7 +5205,7 @@ class Graphlit {
                 });
                 // Start the streaming conversation
                 // fullSpec is guaranteed non-null here — the !fullSpec check above returns early
-                await this.executeStreamingAgent(prompt, actualConversationId, fullSpec, tools, toolHandlers, uiAdapter, maxRounds, abortSignal, mimeType, data, correlationId, persona, options?.contextStrategy, options?.instructions);
+                await this.executeStreamingAgent(prompt, actualConversationId, fullSpec, tools, toolHandlers, uiAdapter, maxRounds, abortSignal, mimeType, data, correlationId, persona, options?.contextStrategy, options?.instructions, options?.scratchpad, options?.skills);
             }, abortSignal);
         }
         catch (error) {
@@ -5121,7 +5251,7 @@ class Graphlit {
     /**
      * Execute the streaming agent workflow with tool calling loop
      */
-    async executeStreamingAgent(prompt, conversationId, specification, tools, toolHandlers, uiAdapter, maxRounds, abortSignal, mimeType, data, correlationId, persona, contextStrategy, instructions) {
+    async executeStreamingAgent(prompt, conversationId, specification, tools, toolHandlers, uiAdapter, maxRounds, abortSignal, mimeType, data, correlationId, persona, contextStrategy, instructions, scratchpad, skills) {
         // Collects artifact content IDs from tool handlers (e.g. code_execution).
         // Handlers register async ingestion promises; we await all of them before
         // completeConversation so the IDs are available without blocking the LLM.
@@ -5141,7 +5271,7 @@ class Graphlit {
             conversationId,
         });
         // Format conversation once at the beginning
-        const formatResponse = await this.formatConversation(prompt, conversationId, { id: specification.id }, tools, undefined, true, correlationId, persona, instructions);
+        const formatResponse = await this.formatConversation(prompt, conversationId, { id: specification.id }, tools, undefined, true, correlationId, persona, instructions, scratchpad, skills);
         const formattedMessage = formatResponse.formatConversation?.message;
         const conversationHistory = formatResponse.formatConversation?.details?.messages;
         if (!formattedMessage?.message) {
@@ -5952,6 +6082,7 @@ class Graphlit {
             // Resolve or create Agent entity
             let agentSpec = specification;
             let agentFilter;
+            let agentScratchpad;
             if (agentId) {
                 const agentResponse = await this.getAgent(agentId, options?.correlationId);
                 const agent = agentResponse.agent;
@@ -5968,6 +6099,9 @@ class Graphlit {
                 if (agent.filter) {
                     agentFilter = agent.filter;
                 }
+                if (agent.scratchpad) {
+                    agentScratchpad = agent.scratchpad;
+                }
             }
             else {
                 // Create ephemeral agent
@@ -6134,7 +6268,7 @@ class Graphlit {
                 }
                 else {
                     // Formatted path: call formatConversation
-                    const formatResponse = await this.formatConversation(turn === 0 ? prompt : "Continue.", conversationId, agentSpec, allTools, undefined, true, options?.correlationId, options?.persona, turnInstructions);
+                    const formatResponse = await this.formatConversation(turn === 0 ? prompt : "Continue.", conversationId, agentSpec, allTools, undefined, true, options?.correlationId, options?.persona, turnInstructions, agentScratchpad, options?.skills);
                     const formattedMessage = formatResponse.formatConversation?.message;
                     const conversationHistory = formatResponse.formatConversation?.details?.messages;
                     const formatDetails = formatResponse.formatConversation?.details;

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

@@ -31,6 +31,7 @@ export declare const UpdateCategory: import("graphql").DocumentNode;
 export declare const UpsertCategory: import("graphql").DocumentNode;
 export declare const AddContentsToCollections: import("graphql").DocumentNode;
 export declare const AddConversationsToCollections: import("graphql").DocumentNode;
+export declare const AddSkillsToCollections: import("graphql").DocumentNode;
 export declare const CountCollections: import("graphql").DocumentNode;
 export declare const CreateCollection: import("graphql").DocumentNode;
 export declare const DeleteAllCollections: import("graphql").DocumentNode;
@@ -40,6 +41,7 @@ export declare const GetCollection: import("graphql").DocumentNode;
 export declare const QueryCollections: import("graphql").DocumentNode;
 export declare const RemoveContentsFromCollection: import("graphql").DocumentNode;
 export declare const RemoveConversationsFromCollection: import("graphql").DocumentNode;
+export declare const RemoveSkillsFromCollection: import("graphql").DocumentNode;
 export declare const UpdateCollection: import("graphql").DocumentNode;
 export declare const CountConnectors: import("graphql").DocumentNode;
 export declare const CreateConnector: import("graphql").DocumentNode;
@@ -389,6 +391,17 @@ export declare const QueryReposClusters: import("graphql").DocumentNode;
 export declare const UpdateRepo: import("graphql").DocumentNode;
 export declare const MapWeb: import("graphql").DocumentNode;
 export declare const SearchWeb: import("graphql").DocumentNode;
+export declare const CountSkills: import("graphql").DocumentNode;
+export declare const CreateSkill: import("graphql").DocumentNode;
+export declare const DeleteAllSkills: import("graphql").DocumentNode;
+export declare const DeleteSkill: import("graphql").DocumentNode;
+export declare const DeleteSkills: import("graphql").DocumentNode;
+export declare const DisableSkill: import("graphql").DocumentNode;
+export declare const EnableSkill: import("graphql").DocumentNode;
+export declare const GetSkill: import("graphql").DocumentNode;
+export declare const QuerySkills: import("graphql").DocumentNode;
+export declare const UpdateSkill: import("graphql").DocumentNode;
+export declare const UpsertSkill: import("graphql").DocumentNode;
 export declare const CountSoftwares: import("graphql").DocumentNode;
 export declare const CreateSoftware: import("graphql").DocumentNode;
 export declare const DeleteAllSoftwares: import("graphql").DocumentNode;

package/dist/generated/graphql-documents.js

@@ -934,6 +934,20 @@ export const AddConversationsToCollections = gql `
   }
 }
     `;
+export const AddSkillsToCollections = gql `
+    mutation AddSkillsToCollections($skills: [EntityReferenceInput!]!, $collections: [EntityReferenceInput!]!) {
+  addSkillsToCollections(skills: $skills, collections: $collections) {
+    id
+    name
+    state
+    type
+    skills {
+      id
+      name
+    }
+  }
+}
+    `;
 export const CountCollections = gql `
     query CountCollections($filter: CollectionFilter, $correlationId: String) {
   countCollections(filter: $filter, correlationId: $correlationId) {
@@ -1051,6 +1065,20 @@ export const RemoveConversationsFromCollection = gql `
   }
 }
     `;
+export const RemoveSkillsFromCollection = gql `
+    mutation RemoveSkillsFromCollection($skills: [EntityReferenceInput!]!, $collection: EntityReferenceInput!) {
+  removeSkillsFromCollection(skills: $skills, collection: $collection) {
+    id
+    name
+    state
+    type
+    skills {
+      id
+      name
+    }
+  }
+}
+    `;
 export const UpdateCollection = gql `
     mutation UpdateCollection($collection: CollectionUpdateInput!) {
   updateCollection(collection: $collection) {
@@ -4827,6 +4855,7 @@ export const CompleteConversation = gql `
       formattedSources
       formattedObservables
       formattedInstructions
+      formattedScratchpad
       formattedTools
       formattedPersona
       specification
@@ -5174,6 +5203,7 @@ export const ContinueConversation = gql `
       formattedSources
       formattedObservables
       formattedInstructions
+      formattedScratchpad
       formattedTools
       formattedPersona
       specification
@@ -5367,7 +5397,7 @@ export const DeleteConversations = gql `
 }
     `;
 export const FormatConversation = gql `
-    mutation FormatConversation($prompt: String!, $id: ID, $specification: EntityReferenceInput, $persona: EntityReferenceInput, $tools: [ToolDefinitionInput!], $systemPrompt: String, $includeDetails: Boolean, $correlationId: String, $instructions: String) {
+    mutation FormatConversation($prompt: String!, $id: ID, $specification: EntityReferenceInput, $persona: EntityReferenceInput, $tools: [ToolDefinitionInput!], $systemPrompt: String, $includeDetails: Boolean, $correlationId: String, $instructions: String, $scratchpad: String, $skills: [EntityReferenceInput!]) {
   formatConversation(
     prompt: $prompt
     id: $id
@@ -5378,6 +5408,8 @@ export const FormatConversation = gql `
     includeDetails: $includeDetails
     correlationId: $correlationId
     instructions: $instructions
+    scratchpad: $scratchpad
+    skills: $skills
   ) {
     conversation {
       id
@@ -5572,6 +5604,7 @@ export const FormatConversation = gql `
       formattedSources
       formattedObservables
       formattedInstructions
+      formattedScratchpad
       formattedTools
       formattedPersona
       specification
@@ -6292,7 +6325,7 @@ export const Prompt = gql `
 }
     `;
 export const PromptConversation = gql `
-    mutation PromptConversation($prompt: String!, $mimeType: String, $data: String, $id: ID, $specification: EntityReferenceInput, $persona: EntityReferenceInput, $systemPrompt: String, $tools: [ToolDefinitionInput!], $requireTool: Boolean, $includeDetails: Boolean, $correlationId: String, $instructions: String) {
+    mutation PromptConversation($prompt: String!, $mimeType: String, $data: String, $id: ID, $specification: EntityReferenceInput, $persona: EntityReferenceInput, $systemPrompt: String, $tools: [ToolDefinitionInput!], $requireTool: Boolean, $includeDetails: Boolean, $correlationId: String, $instructions: String, $scratchpad: String, $skills: [EntityReferenceInput!]) {
   promptConversation(
     prompt: $prompt
     id: $id
@@ -6306,6 +6339,8 @@ export const PromptConversation = gql `
     includeDetails: $includeDetails
     correlationId: $correlationId
     instructions: $instructions
+    scratchpad: $scratchpad
+    skills: $skills
   ) {
     conversation {
       id
@@ -6500,6 +6535,7 @@ export const PromptConversation = gql `
       formattedSources
       formattedObservables
       formattedInstructions
+      formattedScratchpad
       formattedTools
       formattedPersona
       specification
@@ -16445,6 +16481,132 @@ export const SearchWeb = gql `
   }
 }
     `;
+export const CountSkills = gql `
+    query CountSkills($filter: SkillFilter, $correlationId: String) {
+  countSkills(filter: $filter, correlationId: $correlationId) {
+    count
+  }
+}
+    `;
+export const CreateSkill = gql `
+    mutation CreateSkill($skill: SkillInput!, $correlationId: String) {
+  createSkill(skill: $skill, correlationId: $correlationId) {
+    id
+    name
+    state
+    skillOwner
+  }
+}
+    `;
+export const DeleteAllSkills = gql `
+    mutation DeleteAllSkills($filter: SkillFilter, $isSynchronous: Boolean, $correlationId: String) {
+  deleteAllSkills(
+    filter: $filter
+    isSynchronous: $isSynchronous
+    correlationId: $correlationId
+  ) {
+    id
+    state
+  }
+}
+    `;
+export const DeleteSkill = gql `
+    mutation DeleteSkill($id: ID!) {
+  deleteSkill(id: $id) {
+    id
+    state
+  }
+}
+    `;
+export const DeleteSkills = gql `
+    mutation DeleteSkills($ids: [ID!]!, $isSynchronous: Boolean) {
+  deleteSkills(ids: $ids, isSynchronous: $isSynchronous) {
+    id
+    state
+  }
+}
+    `;
+export const DisableSkill = gql `
+    mutation DisableSkill($id: ID!) {
+  disableSkill(id: $id) {
+    id
+    state
+  }
+}
+    `;
+export const EnableSkill = gql `
+    mutation EnableSkill($id: ID!) {
+  enableSkill(id: $id) {
+    id
+    state
+  }
+}
+    `;
+export const GetSkill = gql `
+    query GetSkill($id: ID!, $correlationId: String) {
+  skill(id: $id, correlationId: $correlationId) {
+    id
+    name
+    creationDate
+    modifiedDate
+    owner {
+      id
+    }
+    state
+    correlationId
+    text
+    skillOwner
+    collections {
+      id
+      name
+    }
+  }
+}
+    `;
+export const QuerySkills = gql `
+    query QuerySkills($filter: SkillFilter, $correlationId: String) {
+  skills(filter: $filter, correlationId: $correlationId) {
+    results {
+      id
+      name
+      creationDate
+      modifiedDate
+      relevance
+      owner {
+        id
+      }
+      state
+      correlationId
+      text
+      skillOwner
+      collections {
+        id
+        name
+      }
+    }
+  }
+}
+    `;
+export const UpdateSkill = gql `
+    mutation UpdateSkill($skill: SkillUpdateInput!) {
+  updateSkill(skill: $skill) {
+    id
+    name
+    state
+    skillOwner
+  }
+}
+    `;
+export const UpsertSkill = gql `
+    mutation UpsertSkill($skill: SkillInput!) {
+  upsertSkill(skill: $skill) {
+    id
+    name
+    state
+    skillOwner
+  }
+}
+    `;
 export const CountSoftwares = gql `
     query CountSoftwares($filter: SoftwareFilter, $correlationId: String) {
   countSoftwares(filter: $filter, correlationId: $correlationId) {

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

@@ -2409,6 +2409,10 @@ export type Collection = {
     owner: Owner;
     /** The relevance score of the collection. */
     relevance?: Maybe<Scalars['Float']['output']>;
+    /** The count of the skills contained by the collection. */
+    skillCount?: Maybe<Scalars['Int']['output']>;
+    /** The skills contained by the collection. */
+    skills?: Maybe<Array<Maybe<Skill>>>;
     /** The state of the collection (i.e. created, finished). */
     state: EntityState;
     /** The collection type. */
@@ -3711,6 +3715,8 @@ export type Conversation = {
     persona?: Maybe<Persona>;
     /** The relevance score of the conversation. */
     relevance?: Maybe<Scalars['Float']['output']>;
+    /** The conversation scratchpad, for storing harness working memory as raw text. */
+    scratchpad?: Maybe<Scalars['String']['output']>;
     /** The LLM specification used by this conversation. */
     specification?: Maybe<Specification>;
     /** The state of the conversation (i.e. created, finished). */
@@ -3753,6 +3759,10 @@ export type ConversationDetails = {
     formattedObservables?: Maybe<Scalars['String']['output']>;
     /** The formatted persona prompt. */
     formattedPersona?: Maybe<Scalars['String']['output']>;
+    /** The formatted scratchpad. */
+    formattedScratchpad?: Maybe<Scalars['String']['output']>;
+    /** The formatted skills content. */
+    formattedSkills?: Maybe<Scalars['String']['output']>;
     /** The formatted sources. */
     formattedSources?: Maybe<Scalars['String']['output']>;
     /** The formatted LLM tools. */
@@ -3864,6 +3874,8 @@ export type ConversationInput = {
     name: Scalars['String']['input'];
     /** The persona used by this conversation, optional. */
     persona?: InputMaybe<EntityReferenceInput>;
+    /** The conversation scratchpad, for storing harness working memory as raw text. */
+    scratchpad?: InputMaybe<Scalars['String']['input']>;
     /** The LLM specification used by this conversation, optional. */
     specification?: InputMaybe<EntityReferenceInput>;
     /** The tool calling definitions. */
@@ -4166,6 +4178,8 @@ export type ConversationUpdateInput = {
     name?: InputMaybe<Scalars['String']['input']>;
     /** The persona used by this conversation, optional. */
     persona?: InputMaybe<EntityReferenceInput>;
+    /** The conversation scratchpad, for storing harness working memory as raw text. */
+    scratchpad?: InputMaybe<Scalars['String']['input']>;
     /** The LLM specification used by this conversation, optional. */
     specification?: InputMaybe<EntityReferenceInput>;
     /** The tool calling definitions. */
@@ -5704,6 +5718,13 @@ export type EntityFeedPropertiesUpdateInput = {
     /** The limit of items to be read from feed, defaults to 100. */
     readLimit?: InputMaybe<Scalars['Int']['input']>;
 };
+/** Entity owner */
+export declare enum EntityOwners {
+    /** Owned by project */
+    Project = "PROJECT",
+    /** Owned by system */
+    System = "SYSTEM"
+}
 /** Represents an entity reference. */
 export type EntityReference = {
     __typename?: 'EntityReference';
@@ -5914,6 +5935,8 @@ export declare enum EntityTypes {
     Repo = "REPO",
     /** Cloud storage site */
     Site = "SITE",
+    /** Skill */
+    Skill = "SKILL",
     /** Software */
     Software = "SOFTWARE",
     /** Model specification */
@@ -13849,6 +13872,8 @@ export type Mutation = {
     addContentsToCollections?: Maybe<Array<Maybe<Collection>>>;
     /** Adds conversations to one or more collections. */
     addConversationsToCollections?: Maybe<Array<Maybe<Collection>>>;
+    /** Adds skills to one or more collections. */
+    addSkillsToCollections?: Maybe<Array<Maybe<Collection>>>;
     /** Approves content, and resumes workflow from the prepared stage (without re-ingesting or re-running the storage gate). */
     approveContent?: Maybe<Content>;
     /** Ask questions about the Graphlit API or SDKs. Can create code samples for any API call. */
@@ -13927,6 +13952,8 @@ export type Mutation = {
     createProduct?: Maybe<Product>;
     /** Creates a new repo. */
     createRepo?: Maybe<Repo>;
+    /** Creates a new skill. */
+    createSkill?: Maybe<Skill>;
     /** Creates a new software. */
     createSoftware?: Maybe<Software>;
     /** Creates a new LLM specification. */
@@ -14005,6 +14032,8 @@ export type Mutation = {
     deleteAllProducts?: Maybe<Array<Maybe<Product>>>;
     /** Bulk deletes repos based on the provided filter criteria. */
     deleteAllRepos?: Maybe<Array<Maybe<Repo>>>;
+    /** Bulk deletes skills based on the provided filter criteria. */
+    deleteAllSkills?: Maybe<Array<Maybe<Skill>>>;
     /** Bulk deletes software based on the provided filter criteria. */
     deleteAllSoftwares?: Maybe<Array<Maybe<Software>>>;
     /** Bulk deletes specifications based on the provided filter criteria. */
@@ -14129,6 +14158,10 @@ export type Mutation = {
     deleteRepo?: Maybe<Repo>;
     /** Bulk deletes repos. */
     deleteRepos?: Maybe<Array<Maybe<Repo>>>;
+    /** Deletes a skill. */
+    deleteSkill?: Maybe<Skill>;
+    /** Bulk deletes skills. */
+    deleteSkills?: Maybe<Array<Maybe<Skill>>>;
     /** Deletes a software. */
     deleteSoftware?: Maybe<Software>;
     /** Bulk deletes software. */
@@ -14157,6 +14190,8 @@ export type Mutation = {
     disableAlert?: Maybe<Alert>;
     /** Disables a feed. */
     disableFeed?: Maybe<Feed>;
+    /** Disables a skill. */
+    disableSkill?: Maybe<Skill>;
     /** Disables a user. */
     disableUser?: Maybe<User>;
     /** Distribute to an external service. */
@@ -14167,6 +14202,8 @@ export type Mutation = {
     enableAlert?: Maybe<Alert>;
     /** Enables a feed. */
     enableFeed?: Maybe<Feed>;
+    /** Enables a skill. */
+    enableSkill?: Maybe<Skill>;
     /** Enables a user. */
     enableUser?: Maybe<User>;
     /** Enriches organizations matching the filter criteria using the specified enrichment connector. */
@@ -14237,6 +14274,8 @@ export type Mutation = {
     removeContentsFromCollection?: Maybe<Collection>;
     /** Removes conversations from a collection. */
     removeConversationsFromCollection?: Maybe<Collection>;
+    /** Removes skills from a collection. */
+    removeSkillsFromCollection?: Maybe<Collection>;
     /** Research contents via web research based on provided filter criteria. */
     researchContents?: Maybe<StringResult>;
     /** Resolves duplicate entities into a single primary entity using LLM reasoning. Returns clusters of suggested groupings if resolution is not executed. */
@@ -14343,6 +14382,8 @@ export type Mutation = {
     updateProject?: Maybe<Project>;
     /** Updates a repo. */
     updateRepo?: Maybe<Repo>;
+    /** Updates an existing skill. */
+    updateSkill?: Maybe<Skill>;
     /** Updates a software. */
     updateSoftware?: Maybe<Software>;
     /** Updates an existing LLM specification. */
@@ -14363,6 +14404,8 @@ export type Mutation = {
     upsertEmotion?: Maybe<Emotion>;
     /** Upserts a label. */
     upsertLabel?: Maybe<Label>;
+    /** Upserts a skill. */
+    upsertSkill?: Maybe<Skill>;
     /** Upserts an LLM specification. */
     upsertSpecification?: Maybe<Specification>;
     /** Upserts a view. */
@@ -14382,6 +14425,10 @@ export type MutationAddConversationsToCollectionsArgs = {
     collections: Array<EntityReferenceInput>;
     conversations: Array<EntityReferenceInput>;
 };
+export type MutationAddSkillsToCollectionsArgs = {
+    collections: Array<EntityReferenceInput>;
+    skills: Array<EntityReferenceInput>;
+};
 export type MutationApproveContentArgs = {
     id: Scalars['ID']['input'];
 };
@@ -14518,6 +14565,10 @@ export type MutationCreateProductArgs = {
 export type MutationCreateRepoArgs = {
     repo: RepoInput;
 };
+export type MutationCreateSkillArgs = {
+    correlationId?: InputMaybe<Scalars['String']['input']>;
+    skill: SkillInput;
+};
 export type MutationCreateSoftwareArgs = {
     software: SoftwareInput;
 };
@@ -14697,6 +14748,11 @@ export type MutationDeleteAllReposArgs = {
     filter?: InputMaybe<RepoFilter>;
     isSynchronous?: InputMaybe<Scalars['Boolean']['input']>;
 };
+export type MutationDeleteAllSkillsArgs = {
+    correlationId?: InputMaybe<Scalars['String']['input']>;
+    filter?: InputMaybe<SkillFilter>;
+    isSynchronous?: InputMaybe<Scalars['Boolean']['input']>;
+};
 export type MutationDeleteAllSoftwaresArgs = {
     correlationId?: InputMaybe<Scalars['String']['input']>;
     filter?: InputMaybe<SoftwareFilter>;
@@ -14919,6 +14975,13 @@ export type MutationDeleteReposArgs = {
     ids: Array<Scalars['ID']['input']>;
     isSynchronous?: InputMaybe<Scalars['Boolean']['input']>;
 };
+export type MutationDeleteSkillArgs = {
+    id: Scalars['ID']['input'];
+};
+export type MutationDeleteSkillsArgs = {
+    ids: Array<Scalars['ID']['input']>;
+    isSynchronous?: InputMaybe<Scalars['Boolean']['input']>;
+};
 export type MutationDeleteSoftwareArgs = {
     id: Scalars['ID']['input'];
 };
@@ -14972,6 +15035,9 @@ export type MutationDisableAlertArgs = {
 export type MutationDisableFeedArgs = {
     id: Scalars['ID']['input'];
 };
+export type MutationDisableSkillArgs = {
+    id: Scalars['ID']['input'];
+};
 export type MutationDisableUserArgs = {
     id: Scalars['ID']['input'];
 };
@@ -14993,6 +15059,9 @@ export type MutationEnableAlertArgs = {
 export type MutationEnableFeedArgs = {
     id: Scalars['ID']['input'];
 };
+export type MutationEnableSkillArgs = {
+    id: Scalars['ID']['input'];
+};
 export type MutationEnableUserArgs = {
     id: Scalars['ID']['input'];
 };
@@ -15045,6 +15114,8 @@ export type MutationFormatConversationArgs = {
     instructions?: InputMaybe<Scalars['String']['input']>;
     persona?: InputMaybe<EntityReferenceInput>;
     prompt: Scalars['String']['input'];
+    scratchpad?: InputMaybe<Scalars['String']['input']>;
+    skills?: InputMaybe<Array<EntityReferenceInput>>;
     specification?: InputMaybe<EntityReferenceInput>;
     systemPrompt?: InputMaybe<Scalars['String']['input']>;
     tools?: InputMaybe<Array<ToolDefinitionInput>>;
@@ -15172,6 +15243,8 @@ export type MutationPromptConversationArgs = {
     persona?: InputMaybe<EntityReferenceInput>;
     prompt: Scalars['String']['input'];
     requireTool?: InputMaybe<Scalars['Boolean']['input']>;
+    scratchpad?: InputMaybe<Scalars['String']['input']>;
+    skills?: InputMaybe<Array<EntityReferenceInput>>;
     specification?: InputMaybe<EntityReferenceInput>;
     systemPrompt?: InputMaybe<Scalars['String']['input']>;
     tools?: InputMaybe<Array<ToolDefinitionInput>>;
@@ -15234,6 +15307,10 @@ export type MutationRemoveConversationsFromCollectionArgs = {
     collection: EntityReferenceInput;
     conversations: Array<EntityReferenceInput>;
 };
+export type MutationRemoveSkillsFromCollectionArgs = {
+    collection: EntityReferenceInput;
+    skills: Array<EntityReferenceInput>;
+};
 export type MutationResearchContentsArgs = {
     connector: ContentPublishingConnectorInput;
     correlationId?: InputMaybe<Scalars['String']['input']>;
@@ -15455,6 +15532,9 @@ export type MutationUpdateProjectArgs = {
 export type MutationUpdateRepoArgs = {
     repo: RepoUpdateInput;
 };
+export type MutationUpdateSkillArgs = {
+    skill: SkillUpdateInput;
+};
 export type MutationUpdateSoftwareArgs = {
     software: SoftwareUpdateInput;
 };
@@ -15488,6 +15568,9 @@ export type MutationUpsertLabelArgs = {
     correlationId?: InputMaybe<Scalars['String']['input']>;
     label: LabelInput;
 };
+export type MutationUpsertSkillArgs = {
+    skill: SkillInput;
+};
 export type MutationUpsertSpecificationArgs = {
     specification: SpecificationInput;
 };
@@ -18522,6 +18605,8 @@ export type Query = {
     countProducts?: Maybe<CountResult>;
     /** Counts repos based on the provided filter criteria. */
     countRepos?: Maybe<CountResult>;
+    /** Counts skills based on the provided filter criteria. */
+    countSkills?: Maybe<CountResult>;
     /** Counts software based on the provided filter criteria. */
     countSoftwares?: Maybe<CountResult>;
     /** Counts specifications based on the provided filter criteria. */
@@ -18708,6 +18793,10 @@ export type Query = {
     sharePointFolders?: Maybe<SharePointFolderResults>;
     /** Retrieves available SharePoint document libraries. */
     sharePointLibraries?: Maybe<SharePointLibraryResults>;
+    /** Lookup a skill given its ID. */
+    skill?: Maybe<Skill>;
+    /** Retrieves skills based on the provided filter criteria. */
+    skills?: Maybe<SkillResults>;
     /** Retrieves available Slack channels. */
     slackChannels?: Maybe<StringResults>;
     /** Lookup software given its ID. */
@@ -18956,6 +19045,10 @@ export type QueryCountReposArgs = {
     correlationId?: InputMaybe<Scalars['String']['input']>;
     filter?: InputMaybe<RepoFilter>;
 };
+export type QueryCountSkillsArgs = {
+    correlationId?: InputMaybe<Scalars['String']['input']>;
+    filter?: InputMaybe<SkillFilter>;
+};
 export type QueryCountSoftwaresArgs = {
     correlationId?: InputMaybe<Scalars['String']['input']>;
     filter?: InputMaybe<SoftwareFilter>;
@@ -19364,6 +19457,14 @@ export type QuerySharePointFoldersArgs = {
 export type QuerySharePointLibrariesArgs = {
     properties: SharePointLibrariesInput;
 };
+export type QuerySkillArgs = {
+    correlationId?: InputMaybe<Scalars['String']['input']>;
+    id: Scalars['ID']['input'];
+};
+export type QuerySkillsArgs = {
+    correlationId?: InputMaybe<Scalars['String']['input']>;
+    filter?: InputMaybe<SkillFilter>;
+};
 export type QuerySlackChannelsArgs = {
     properties: SlackChannelsInput;
 };
@@ -20693,6 +20794,99 @@ export declare enum SiteTypes {
     /** Watch cloud storage site */
     Watch = "WATCH"
 }
+/** Represents a skill. */
+export type Skill = {
+    __typename?: 'Skill';
+    /** The collections this skill belongs to. */
+    collections?: Maybe<Array<Maybe<Collection>>>;
+    /** The tenant correlation identifier. */
+    correlationId?: Maybe<Scalars['String']['output']>;
+    /** The creation date of the skill. */
+    creationDate: Scalars['DateTime']['output'];
+    /** The description of the skill. */
+    description?: Maybe<Scalars['String']['output']>;
+    /** The ID of the skill. */
+    id: Scalars['ID']['output'];
+    /** The modified date of the skill. */
+    modifiedDate?: Maybe<Scalars['DateTime']['output']>;
+    /** The name of the skill. */
+    name: Scalars['String']['output'];
+    /** The owner of the skill. */
+    owner: Owner;
+    /** The relevance score of the skill. */
+    relevance?: Maybe<Scalars['Float']['output']>;
+    /** The skill owner. */
+    skillOwner?: Maybe<EntityOwners>;
+    /** The state of the skill (i.e. created, finished). */
+    state: EntityState;
+    /** The Markdown text body of the skill. */
+    text: Scalars['String']['output'];
+};
+/** Represents a filter for skills. */
+export type SkillFilter = {
+    /** Filter by collections. */
+    collections?: InputMaybe<Array<EntityReferenceFilter>>;
+    /** Filter by creation date recent timespan. For example, a timespan of one day will return skill(s) created in the last 24 hours. */
+    createdInLast?: InputMaybe<Scalars['TimeSpan']['input']>;
+    /** Filter skill(s) by their creation date range. */
+    creationDateRange?: InputMaybe<DateRangeFilter>;
+    /** The sort direction for query results. */
+    direction?: InputMaybe<OrderDirectionTypes>;
+    /** Filter by whether the skill belongs to any collections. */
+    hasCollections?: InputMaybe<Scalars['Boolean']['input']>;
+    /** Filter skill(s) by their unique ID. */
+    id?: InputMaybe<Scalars['ID']['input']>;
+    /** Limit the number of skill(s) to be returned. Defaults to 100. */
+    limit?: InputMaybe<Scalars['Int']['input']>;
+    /** Filter skill(s) by their modified date range. */
+    modifiedDateRange?: InputMaybe<DateRangeFilter>;
+    /** Filter by modified date recent timespan. For example, a timespan of one day will return skill(s) modified in the last 24 hours. */
+    modifiedInLast?: InputMaybe<Scalars['TimeSpan']['input']>;
+    /** Filter skill(s) by their name. */
+    name?: InputMaybe<Scalars['String']['input']>;
+    /** Skip the specified number of skill(s) from the beginning of the result set. Only supported on keyword search. */
+    offset?: InputMaybe<Scalars['Int']['input']>;
+    /** The sort order for query results. */
+    orderBy?: InputMaybe<OrderByTypes>;
+    /** The relevance score threshold for vector and hybrid search. Results below this threshold will be filtered out. Hybrid search defaults to 0.006. Vector search defaults to 0.54, or 0.78 for OpenAI Ada-002, or 0.61 for Google embedding models. Not applicable to keyword search. */
+    relevanceThreshold?: InputMaybe<Scalars['Float']['input']>;
+    /** Filter skill(s) by searching for similar text. */
+    search?: InputMaybe<Scalars['String']['input']>;
+    /** Filter by skill owners. */
+    skillOwners?: InputMaybe<Array<EntityOwners>>;
+    /** Filter skill(s) by their states. */
+    states?: InputMaybe<Array<EntityState>>;
+};
+/** Represents a skill. */
+export type SkillInput = {
+    /** The collections to add this skill to. */
+    collections?: InputMaybe<Array<EntityReferenceInput>>;
+    /** The description of the skill. */
+    description?: InputMaybe<Scalars['String']['input']>;
+    /** The name of the skill. */
+    name: Scalars['String']['input'];
+    /** The skill owner. */
+    skillOwner?: InputMaybe<EntityOwners>;
+    /** The Markdown text body of the skill. */
+    text: Scalars['String']['input'];
+};
+/** Represents skill query results. */
+export type SkillResults = {
+    __typename?: 'SkillResults';
+    /** The list of skill query results. */
+    results?: Maybe<Array<Skill>>;
+};
+/** Represents a skill. */
+export type SkillUpdateInput = {
+    /** The description of the skill. */
+    description?: InputMaybe<Scalars['String']['input']>;
+    /** The ID of the skill to update. */
+    id: Scalars['ID']['input'];
+    /** The name of the skill. */
+    name?: InputMaybe<Scalars['String']['input']>;
+    /** The Markdown text body of the skill. */
+    text?: InputMaybe<Scalars['String']['input']>;
+};
 export declare enum SlackAuthenticationTypes {
     Connector = "CONNECTOR",
     Token = "TOKEN"
@@ -23886,6 +24080,25 @@ export type AddConversationsToCollectionsMutation = {
         } | null> | null;
     } | null> | null;
 };
+export type AddSkillsToCollectionsMutationVariables = Exact<{
+    skills: Array<EntityReferenceInput> | EntityReferenceInput;
+    collections: Array<EntityReferenceInput> | EntityReferenceInput;
+}>;
+export type AddSkillsToCollectionsMutation = {
+    __typename?: 'Mutation';
+    addSkillsToCollections?: Array<{
+        __typename?: 'Collection';
+        id: string;
+        name: string;
+        state: EntityState;
+        type?: CollectionTypes | null;
+        skills?: Array<{
+            __typename?: 'Skill';
+            id: string;
+            name: string;
+        } | null> | null;
+    } | null> | null;
+};
 export type CountCollectionsQueryVariables = Exact<{
     filter?: InputMaybe<CollectionFilter>;
     correlationId?: InputMaybe<Scalars['String']['input']>;
@@ -24038,6 +24251,25 @@ export type RemoveConversationsFromCollectionMutation = {
         } | null> | null;
     } | null;
 };
+export type RemoveSkillsFromCollectionMutationVariables = Exact<{
+    skills: Array<EntityReferenceInput> | EntityReferenceInput;
+    collection: EntityReferenceInput;
+}>;
+export type RemoveSkillsFromCollectionMutation = {
+    __typename?: 'Mutation';
+    removeSkillsFromCollection?: {
+        __typename?: 'Collection';
+        id: string;
+        name: string;
+        state: EntityState;
+        type?: CollectionTypes | null;
+        skills?: Array<{
+            __typename?: 'Skill';
+            id: string;
+            name: string;
+        } | null> | null;
+    } | null;
+};
 export type UpdateCollectionMutationVariables = Exact<{
     collection: CollectionUpdateInput;
 }>;
@@ -28314,6 +28546,7 @@ export type CompleteConversationMutation = {
             formattedSources?: string | null;
             formattedObservables?: string | null;
             formattedInstructions?: string | null;
+            formattedScratchpad?: string | null;
             formattedTools?: string | null;
             formattedPersona?: string | null;
             specification?: string | null;
@@ -28689,6 +28922,7 @@ export type ContinueConversationMutation = {
             formattedSources?: string | null;
             formattedObservables?: string | null;
             formattedInstructions?: string | null;
+            formattedScratchpad?: string | null;
             formattedTools?: string | null;
             formattedPersona?: string | null;
             specification?: string | null;
@@ -28915,6 +29149,8 @@ export type FormatConversationMutationVariables = Exact<{
     includeDetails?: InputMaybe<Scalars['Boolean']['input']>;
     correlationId?: InputMaybe<Scalars['String']['input']>;
     instructions?: InputMaybe<Scalars['String']['input']>;
+    scratchpad?: InputMaybe<Scalars['String']['input']>;
+    skills?: InputMaybe<Array<EntityReferenceInput> | EntityReferenceInput>;
 }>;
 export type FormatConversationMutation = {
     __typename?: 'Mutation';
@@ -29131,6 +29367,7 @@ export type FormatConversationMutation = {
             formattedSources?: string | null;
             formattedObservables?: string | null;
             formattedInstructions?: string | null;
+            formattedScratchpad?: string | null;
             formattedTools?: string | null;
             formattedPersona?: string | null;
             specification?: string | null;
@@ -29960,6 +30197,8 @@ export type PromptConversationMutationVariables = Exact<{
     includeDetails?: InputMaybe<Scalars['Boolean']['input']>;
     correlationId?: InputMaybe<Scalars['String']['input']>;
     instructions?: InputMaybe<Scalars['String']['input']>;
+    scratchpad?: InputMaybe<Scalars['String']['input']>;
+    skills?: InputMaybe<Array<EntityReferenceInput> | EntityReferenceInput>;
 }>;
 export type PromptConversationMutation = {
     __typename?: 'Mutation';
@@ -30176,6 +30415,7 @@ export type PromptConversationMutation = {
             formattedSources?: string | null;
             formattedObservables?: string | null;
             formattedInstructions?: string | null;
+            formattedScratchpad?: string | null;
             formattedTools?: string | null;
             formattedPersona?: string | null;
             specification?: string | null;
@@ -42104,6 +42344,173 @@ export type SearchWebQuery = {
         }> | null;
     } | null;
 };
+export type CountSkillsQueryVariables = Exact<{
+    filter?: InputMaybe<SkillFilter>;
+    correlationId?: InputMaybe<Scalars['String']['input']>;
+}>;
+export type CountSkillsQuery = {
+    __typename?: 'Query';
+    countSkills?: {
+        __typename?: 'CountResult';
+        count?: any | null;
+    } | null;
+};
+export type CreateSkillMutationVariables = Exact<{
+    skill: SkillInput;
+    correlationId?: InputMaybe<Scalars['String']['input']>;
+}>;
+export type CreateSkillMutation = {
+    __typename?: 'Mutation';
+    createSkill?: {
+        __typename?: 'Skill';
+        id: string;
+        name: string;
+        state: EntityState;
+        skillOwner?: EntityOwners | null;
+    } | null;
+};
+export type DeleteAllSkillsMutationVariables = Exact<{
+    filter?: InputMaybe<SkillFilter>;
+    isSynchronous?: InputMaybe<Scalars['Boolean']['input']>;
+    correlationId?: InputMaybe<Scalars['String']['input']>;
+}>;
+export type DeleteAllSkillsMutation = {
+    __typename?: 'Mutation';
+    deleteAllSkills?: Array<{
+        __typename?: 'Skill';
+        id: string;
+        state: EntityState;
+    } | null> | null;
+};
+export type DeleteSkillMutationVariables = Exact<{
+    id: Scalars['ID']['input'];
+}>;
+export type DeleteSkillMutation = {
+    __typename?: 'Mutation';
+    deleteSkill?: {
+        __typename?: 'Skill';
+        id: string;
+        state: EntityState;
+    } | null;
+};
+export type DeleteSkillsMutationVariables = Exact<{
+    ids: Array<Scalars['ID']['input']> | Scalars['ID']['input'];
+    isSynchronous?: InputMaybe<Scalars['Boolean']['input']>;
+}>;
+export type DeleteSkillsMutation = {
+    __typename?: 'Mutation';
+    deleteSkills?: Array<{
+        __typename?: 'Skill';
+        id: string;
+        state: EntityState;
+    } | null> | null;
+};
+export type DisableSkillMutationVariables = Exact<{
+    id: Scalars['ID']['input'];
+}>;
+export type DisableSkillMutation = {
+    __typename?: 'Mutation';
+    disableSkill?: {
+        __typename?: 'Skill';
+        id: string;
+        state: EntityState;
+    } | null;
+};
+export type EnableSkillMutationVariables = Exact<{
+    id: Scalars['ID']['input'];
+}>;
+export type EnableSkillMutation = {
+    __typename?: 'Mutation';
+    enableSkill?: {
+        __typename?: 'Skill';
+        id: string;
+        state: EntityState;
+    } | null;
+};
+export type GetSkillQueryVariables = Exact<{
+    id: Scalars['ID']['input'];
+    correlationId?: InputMaybe<Scalars['String']['input']>;
+}>;
+export type GetSkillQuery = {
+    __typename?: 'Query';
+    skill?: {
+        __typename?: 'Skill';
+        id: string;
+        name: string;
+        creationDate: any;
+        modifiedDate?: any | null;
+        state: EntityState;
+        correlationId?: string | null;
+        text: string;
+        skillOwner?: EntityOwners | null;
+        owner: {
+            __typename?: 'Owner';
+            id: string;
+        };
+        collections?: Array<{
+            __typename?: 'Collection';
+            id: string;
+            name: string;
+        } | null> | null;
+    } | null;
+};
+export type QuerySkillsQueryVariables = Exact<{
+    filter?: InputMaybe<SkillFilter>;
+    correlationId?: InputMaybe<Scalars['String']['input']>;
+}>;
+export type QuerySkillsQuery = {
+    __typename?: 'Query';
+    skills?: {
+        __typename?: 'SkillResults';
+        results?: Array<{
+            __typename?: 'Skill';
+            id: string;
+            name: string;
+            creationDate: any;
+            modifiedDate?: any | null;
+            relevance?: number | null;
+            state: EntityState;
+            correlationId?: string | null;
+            text: string;
+            skillOwner?: EntityOwners | null;
+            owner: {
+                __typename?: 'Owner';
+                id: string;
+            };
+            collections?: Array<{
+                __typename?: 'Collection';
+                id: string;
+                name: string;
+            } | null> | null;
+        }> | null;
+    } | null;
+};
+export type UpdateSkillMutationVariables = Exact<{
+    skill: SkillUpdateInput;
+}>;
+export type UpdateSkillMutation = {
+    __typename?: 'Mutation';
+    updateSkill?: {
+        __typename?: 'Skill';
+        id: string;
+        name: string;
+        state: EntityState;
+        skillOwner?: EntityOwners | null;
+    } | null;
+};
+export type UpsertSkillMutationVariables = Exact<{
+    skill: SkillInput;
+}>;
+export type UpsertSkillMutation = {
+    __typename?: 'Mutation';
+    upsertSkill?: {
+        __typename?: 'Skill';
+        id: string;
+        name: string;
+        state: EntityState;
+        skillOwner?: EntityOwners | null;
+    } | null;
+};
 export type CountSoftwaresQueryVariables = Exact<{
     filter?: InputMaybe<SoftwareFilter>;
     correlationId?: InputMaybe<Scalars['String']['input']>;

package/dist/generated/graphql-types.js

@@ -919,6 +919,14 @@ export var EntityExtractionServiceTypes;
      */
     EntityExtractionServiceTypes["OpenAiImage"] = "OPEN_AI_IMAGE";
 })(EntityExtractionServiceTypes || (EntityExtractionServiceTypes = {}));
+/** Entity owner */
+export var EntityOwners;
+(function (EntityOwners) {
+    /** Owned by project */
+    EntityOwners["Project"] = "PROJECT";
+    /** Owned by system */
+    EntityOwners["System"] = "SYSTEM";
+})(EntityOwners || (EntityOwners = {}));
 /** Entity resolution strategy */
 export var EntityResolutionStrategyTypes;
 (function (EntityResolutionStrategyTypes) {
@@ -1064,6 +1072,8 @@ export var EntityTypes;
     EntityTypes["Repo"] = "REPO";
     /** Cloud storage site */
     EntityTypes["Site"] = "SITE";
+    /** Skill */
+    EntityTypes["Skill"] = "SKILL";
     /** Software */
     EntityTypes["Software"] = "SOFTWARE";
     /** Model specification */

package/dist/types/agent.d.ts

@@ -68,6 +68,10 @@ export interface StreamAgentOptions {
     contextStrategy?: ContextStrategy;
     /** Harness-injected instructions appended to the formatted conversation (e.g. wind-down, stuck intervention). */
     instructions?: string;
+    /** Harness-injected scratchpad text, merged with conversation scratchpad. Placed right before user-prompt. */
+    scratchpad?: string;
+    /** Skill references to inject into the agent's context window. Retrieved via querySkills, passed by reference. */
+    skills?: EntityReferenceInput[];
 }
 export interface ToolCallResult {
     id: string;
@@ -144,6 +148,8 @@ export interface RunAgentOptions {
     smoothingEnabled?: boolean;
     chunkingStrategy?: "character" | "word" | "sentence";
     smoothingDelay?: number;
+    /** Skill references to inject into the agent's context window. Retrieved via querySkills, passed by reference. */
+    skills?: EntityReferenceInput[];
 }
 /** Quality assessment scores from LLM-as-judge post-run evaluation. */
 export interface QualityAssessment {

package/package.json

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