@wildix/wim-wilma-client 0.0.12 → 3.1.12

package/dist-types/models/models_0.d.ts

@@ -1,50 +1,5 @@
-import { WilmaServiceException as __BaseException } from "./WilmaServiceException";
-import { ExceptionOptionType as __ExceptionOptionType } from "@smithy/smithy-client";
-import { DocumentType as __DocumentType } from "@smithy/types";
-/**
- * @public
- */
-export declare class ForbiddenException extends __BaseException {
-    readonly name: "ForbiddenException";
-    readonly $fault: "client";
-    /**
-     * @internal
-     */
-    constructor(opts: __ExceptionOptionType<ForbiddenException, __BaseException>);
-}
-/**
- * @public
- */
-export declare class NotFoundException extends __BaseException {
-    readonly name: "NotFoundException";
-    readonly $fault: "client";
-    /**
-     * @internal
-     */
-    constructor(opts: __ExceptionOptionType<NotFoundException, __BaseException>);
-}
-/**
- * @public
- */
-export declare class ValidationException extends __BaseException {
-    readonly name: "ValidationException";
-    readonly $fault: "client";
-    /**
-     * @internal
-     */
-    constructor(opts: __ExceptionOptionType<ValidationException, __BaseException>);
-}
-/**
- * @public
- */
-export interface AgentKnowledgeBase {
-    knowledgeBaseId?: string | undefined;
-    /**
-     * Additional instructions for when the agent should use this knowledge base.
-     * @public
-     */
-    instructions?: string | undefined;
-}
+import type { DocumentType as __DocumentType } from "@smithy/types";
+import type { AgentVariableType, ChatFeedbackScore, GuidelineScope, SandboxNetworkAccess, SkillFileKind, WebSearchContextSize, WilmaFileScope, WilmaGrantPermission, WilmaVisibility } from "./enums";
 /**
  * @public
  */
@@ -97,13 +52,16 @@ export declare namespace AgentToolVariableHandler {
         predefined?: never;
         $unknown: [string, any];
     }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
     interface Visitor<T> {
         auto: (value: AgentToolVariableAutoHandler) => T;
         guided: (value: AgentToolVariableGuidedHandler) => T;
         predefined: (value: AgentToolVariablePredefinedHandler) => T;
         _: (name: string, value: any) => T;
     }
-    const visit: <T>(value: AgentToolVariableHandler, visitor: Visitor<T>) => T;
 }
 /**
  * @public
@@ -116,6 +74,83 @@ export interface AgentToolVariable {
     name: string;
     handler?: AgentToolVariableHandler | undefined;
 }
+/**
+ * Invoke another agent as a dedicated execution with its OWN sandbox and state (not a task/sub-agent copy of the caller). The called agent runs independently and returns its result.
+ * @public
+ */
+export interface AgentCallCapability {
+    /**
+     * The agent to invoke.
+     * @public
+     */
+    agentId: string;
+    variables?: AgentToolVariable[] | undefined;
+}
+/**
+ * @public
+ */
+export interface AgentKnowledgeBase {
+    knowledgeBaseId?: string | undefined;
+    /**
+     * Additional instructions for when the agent should use this knowledge base.
+     * @public
+     */
+    instructions?: string | undefined;
+}
+/**
+ * Vercel Sandbox configuration. Kept minimal for now: CPU and network only.
+ * @public
+ */
+export interface AgentVercelSandboxOptions {
+    /**
+     * Number of vCPUs to allocate (2048 MB memory each).
+     * @public
+     */
+    vcpus?: number | undefined;
+    /**
+     * Network access. Defaults to deny-all.
+     * @public
+     */
+    network?: SandboxNetworkAccess | undefined;
+    /**
+     * Domains allowed when network = ALLOWLIST.
+     * @public
+     */
+    allowedDomains?: string[] | undefined;
+}
+/**
+ * Embedded sandbox: shell + file tools backed by an execution environment. Provider is a union; only Vercel is supported for now.
+ * @public
+ */
+export type AgentSandboxCapability = AgentSandboxCapability.VercelMember | AgentSandboxCapability.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace AgentSandboxCapability {
+    /**
+     * Vercel Sandbox configuration. Kept minimal for now: CPU and network only.
+     * @public
+     */
+    interface VercelMember {
+        vercel: AgentVercelSandboxOptions;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        vercel?: never;
+        $unknown: [string, any];
+    }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
+    interface Visitor<T> {
+        vercel: (value: AgentVercelSandboxOptions) => T;
+        _: (name: string, value: any) => T;
+    }
+}
 /**
  * @public
  */
@@ -125,12 +160,61 @@ export interface AgentTool {
      * @public
      */
     id: string;
-    variables?: (AgentToolVariable)[] | undefined;
+    variables?: AgentToolVariable[] | undefined;
+}
+/**
+ * Server-side fetch of a URL, returning its readable text/markdown to the model.
+ * @public
+ */
+export interface AgentWebFetchCapability {
+    /**
+     * Restrict fetches to these domains. Empty list means any domain is allowed.
+     * @public
+     */
+    allowedDomains?: string[] | undefined;
+}
+/**
+ * @public
+ */
+export interface WebSearchUserLocation {
+    /**
+     * ISO 3166-1 alpha-2 country code, e.g. 'US'.
+     * @public
+     */
+    country?: string | undefined;
+    region?: string | undefined;
+    city?: string | undefined;
+    /**
+     * IANA timezone, e.g. 'Europe/Rome'.
+     * @public
+     */
+    timezone?: string | undefined;
+}
+/**
+ * Model-native web search (OpenAI web_search, Google googleSearch). The provider tool is selected from the agent model.
+ * @public
+ */
+export interface AgentWebSearchCapability {
+    /**
+     * Context size hint. Defaults to medium.
+     * @public
+     */
+    contextSize?: WebSearchContextSize | undefined;
+    /**
+     * Restrict results to these domains where the provider supports it.
+     * @public
+     */
+    allowedDomains?: string[] | undefined;
+    /**
+     * Bias results to a user location where the provider supports it.
+     * @public
+     */
+    userLocation?: WebSearchUserLocation | undefined;
 }
 /**
  * @public
  */
-export type AgentCapability = AgentCapability.KbMember | AgentCapability.ToolMember | AgentCapability.$UnknownMember;
+export type AgentCapability = AgentCapability.AgentMember | AgentCapability.KbMember | AgentCapability.SandboxMember | AgentCapability.ToolMember | AgentCapability.WebFetchMember | AgentCapability.WebSearchMember | AgentCapability.$UnknownMember;
 /**
  * @public
  */
@@ -138,11 +222,71 @@ export declare namespace AgentCapability {
     interface ToolMember {
         tool: AgentTool;
         kb?: never;
+        sandbox?: never;
+        webSearch?: never;
+        webFetch?: never;
+        agent?: never;
         $unknown?: never;
     }
     interface KbMember {
         tool?: never;
         kb: AgentKnowledgeBase;
+        sandbox?: never;
+        webSearch?: never;
+        webFetch?: never;
+        agent?: never;
+        $unknown?: never;
+    }
+    /**
+     * Embedded sandbox: shell + file tools backed by an execution environment. Provider is a union; only Vercel is supported for now.
+     * @public
+     */
+    interface SandboxMember {
+        tool?: never;
+        kb?: never;
+        sandbox: AgentSandboxCapability;
+        webSearch?: never;
+        webFetch?: never;
+        agent?: never;
+        $unknown?: never;
+    }
+    /**
+     * Model-native web search (OpenAI web_search, Google googleSearch). The provider tool is selected from the agent model.
+     * @public
+     */
+    interface WebSearchMember {
+        tool?: never;
+        kb?: never;
+        sandbox?: never;
+        webSearch: AgentWebSearchCapability;
+        webFetch?: never;
+        agent?: never;
+        $unknown?: never;
+    }
+    /**
+     * Server-side fetch of a URL, returning its readable text/markdown to the model.
+     * @public
+     */
+    interface WebFetchMember {
+        tool?: never;
+        kb?: never;
+        sandbox?: never;
+        webSearch?: never;
+        webFetch: AgentWebFetchCapability;
+        agent?: never;
+        $unknown?: never;
+    }
+    /**
+     * Invoke another agent as a dedicated execution with its OWN sandbox and state (not a task/sub-agent copy of the caller). The called agent runs independently and returns its result.
+     * @public
+     */
+    interface AgentMember {
+        tool?: never;
+        kb?: never;
+        sandbox?: never;
+        webSearch?: never;
+        webFetch?: never;
+        agent: AgentCallCapability;
         $unknown?: never;
     }
     /**
@@ -151,30 +295,26 @@ export declare namespace AgentCapability {
     interface $UnknownMember {
         tool?: never;
         kb?: never;
+        sandbox?: never;
+        webSearch?: never;
+        webFetch?: never;
+        agent?: never;
         $unknown: [string, any];
     }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
     interface Visitor<T> {
         tool: (value: AgentTool) => T;
         kb: (value: AgentKnowledgeBase) => T;
+        sandbox: (value: AgentSandboxCapability) => T;
+        webSearch: (value: AgentWebSearchCapability) => T;
+        webFetch: (value: AgentWebFetchCapability) => T;
+        agent: (value: AgentCallCapability) => T;
         _: (name: string, value: any) => T;
     }
-    const visit: <T>(value: AgentCapability, visitor: Visitor<T>) => T;
 }
-/**
- * @public
- * @enum
- */
-export declare const AgentVariableType: {
-    readonly BOOLEAN: "boolean";
-    readonly NUMBER: "number";
-    readonly NUMBER_ARRAY: "number_array";
-    readonly STRING: "string";
-    readonly STRING_ARRAY: "string_array";
-};
-/**
- * @public
- */
-export type AgentVariableType = typeof AgentVariableType[keyof typeof AgentVariableType];
 /**
  * @public
  */
@@ -194,9 +334,18 @@ export interface Agent {
      */
     category?: string | undefined;
     instructions: string;
-    guidelines?: (string)[] | undefined;
-    variables?: (AgentVariable)[] | undefined;
-    capabilities?: (AgentCapability)[] | undefined;
+    /**
+     * @deprecated Use `skills` instead. Guidelines are eagerly injected; skills use progressive disclosure.
+     * @public
+     */
+    guidelines?: string[] | undefined;
+    /**
+     * Skills attached to this agent (progressive disclosure; replaces guidelines).
+     * @public
+     */
+    skills?: string[] | undefined;
+    variables?: AgentVariable[] | undefined;
+    capabilities?: AgentCapability[] | undefined;
     /**
      * AI model specification using URI format for provider, model and parameters. Examples: 'default', 'google://gemini-3-flash-preview', 'openai://gpt-4o?timeout=30&temperature=0.7', 'openai://gpt-4.1'
      * @public
@@ -216,6 +365,44 @@ export interface AgentExecutionError {
      */
     message: string;
 }
+/**
+ * A file produced (or shared) by an agent during a session. Content lives in S3; download via the Files API.
+ * @public
+ */
+export interface WilmaFile {
+    /**
+     * Nano-id file identifier (12 characters).
+     * @public
+     */
+    id: string;
+    name: string;
+    /**
+     * MIME type, e.g. 'text/csv'.
+     * @public
+     */
+    contentType?: string | undefined;
+    /**
+     * Size in bytes.
+     * @public
+     */
+    size?: number | undefined;
+    /**
+     * Intended audience. Defaults to USER.
+     * @public
+     */
+    scope?: WilmaFileScope | undefined;
+    /**
+     * Agent that created the file.
+     * @public
+     */
+    agentId?: string | undefined;
+    /**
+     * Session that created the file.
+     * @public
+     */
+    sessionId?: string | undefined;
+    createdAt: string;
+}
 /**
  * @public
  */
@@ -230,6 +417,11 @@ export interface AgentExecutionResult {
      * @public
      */
     error: AgentExecutionError;
+    /**
+     * Files created by the agent during execution (downloadable via the Files API).
+     * @public
+     */
+    files?: WilmaFile[] | undefined;
 }
 /**
  * @public
@@ -261,18 +453,6 @@ export interface Chat {
     createdAt: string;
     updatedAt?: string | undefined;
 }
-/**
- * @public
- * @enum
- */
-export declare const ChatFeedbackScore: {
-    readonly DISLIKE: "DISLIKE";
-    readonly LIKE: "LIKE";
-};
-/**
- * @public
- */
-export type ChatFeedbackScore = typeof ChatFeedbackScore[keyof typeof ChatFeedbackScore];
 /**
  * @public
  */
@@ -287,8 +467,8 @@ export interface ChatFeedback {
  */
 export interface ChatHistory {
     version: string;
-    messages: (__DocumentType)[];
-    mentions?: (__DocumentType)[] | undefined;
+    messages: __DocumentType[];
+    mentions?: __DocumentType[] | undefined;
 }
 /**
  * @public
@@ -301,9 +481,18 @@ export interface CreateAgentInput {
      */
     category?: string | undefined;
     instructions: string;
-    guidelines?: (string)[] | undefined;
-    variables?: (AgentVariable)[] | undefined;
-    capabilities?: (AgentCapability)[] | undefined;
+    /**
+     * @deprecated Use `skills` instead. Guidelines are eagerly injected; skills use progressive disclosure.
+     * @public
+     */
+    guidelines?: string[] | undefined;
+    /**
+     * Skills attached to this agent (progressive disclosure; replaces guidelines).
+     * @public
+     */
+    skills?: string[] | undefined;
+    variables?: AgentVariable[] | undefined;
+    capabilities?: AgentCapability[] | undefined;
     /**
      * AI model specification using URI format for provider, model and parameters. Examples: 'default', 'google://gemini-3-flash-preview', 'openai://gpt-4o?timeout=30&temperature=0.7', 'openai://gpt-4.1'
      * @public
@@ -317,18 +506,6 @@ export interface CreateAgentInput {
 export interface CreateAgentOutput {
     agent: Agent;
 }
-/**
- * @public
- * @enum
- */
-export declare const WilmaGrantPermission: {
-    readonly EDIT: "edit";
-    readonly VIEW: "view";
-};
-/**
- * @public
- */
-export type WilmaGrantPermission = typeof WilmaGrantPermission[keyof typeof WilmaGrantPermission];
 /**
  * @public
  */
@@ -355,12 +532,15 @@ export declare namespace WilmaGrantPrincipal {
         groupId?: never;
         $unknown: [string, any];
     }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
     interface Visitor<T> {
         userId: (value: string) => T;
         groupId: (value: string) => T;
         _: (name: string, value: any) => T;
     }
-    const visit: <T>(value: WilmaGrantPrincipal, visitor: Visitor<T>) => T;
 }
 /**
  * @public
@@ -369,37 +549,13 @@ export interface WilmaGrant {
     permission: WilmaGrantPermission;
     principal: WilmaGrantPrincipal;
 }
-/**
- * @public
- * @enum
- */
-export declare const WilmaVisibility: {
-    readonly EXPLICIT: "explicit";
-    readonly ORGANIZATION: "organization";
-};
-/**
- * @public
- */
-export type WilmaVisibility = typeof WilmaVisibility[keyof typeof WilmaVisibility];
 /**
  * @public
  */
 export interface WilmaAccess {
     visibility?: WilmaVisibility | undefined;
-    grants?: (WilmaGrant)[] | undefined;
+    grants?: WilmaGrant[] | undefined;
 }
-/**
- * @public
- * @enum
- */
-export declare const GuidelineScope: {
-    readonly ORGANIZATION: "ORGANIZATION";
-    readonly PERSONAL: "PERSONAL";
-};
-/**
- * @public
- */
-export type GuidelineScope = typeof GuidelineScope[keyof typeof GuidelineScope];
 /**
  * @public
  */
@@ -487,6 +643,114 @@ export interface GuidelineDirectoryInfo {
 export interface CreateGuidelinesDirectoryOutput {
     directory: GuidelineDirectoryInfo;
 }
+/**
+ * @public
+ */
+export interface CreateSkillInput {
+    name: string;
+    description: string;
+    /**
+     * The SKILL.md body (instructions). Progressive disclosure: loaded on demand via load_skill.
+     * @public
+     */
+    content: string;
+    company?: string | undefined;
+    user?: string | undefined;
+}
+/**
+ * A file bundled with a skill. Content is stored in S3 and uploaded/downloaded via presigned URLs.
+ * @public
+ */
+export interface SkillFile {
+    /**
+     * Relative path of a bundled file inside the skill, e.g. 'scripts/run.py'. No '..'.
+     * @public
+     */
+    path: string;
+    kind: SkillFileKind;
+    /**
+     * MIME type, e.g. 'text/x-python'.
+     * @public
+     */
+    contentType?: string | undefined;
+    /**
+     * chmod +x when materialised in the sandbox (scripts).
+     * @public
+     */
+    executable?: boolean | undefined;
+    /**
+     * Size in bytes.
+     * @public
+     */
+    size?: number | undefined;
+    /**
+     * SHA-256 of the file content.
+     * @public
+     */
+    checksum?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface Skill {
+    name: string;
+    description: string;
+    /**
+     * The SKILL.md body (instructions). Progressive disclosure: loaded on demand via load_skill.
+     * @public
+     */
+    content: string;
+    id: string;
+    createdAt: string;
+    createdBy: string;
+    createdByName: string;
+    updatedAt?: string | undefined;
+    /**
+     * Bundled files (references, scripts, resources).
+     * @public
+     */
+    files?: SkillFile[] | undefined;
+}
+/**
+ * @public
+ */
+export interface CreateSkillOutput {
+    skill: Skill;
+}
+/**
+ * @public
+ */
+export interface CreateSkillFileUploadInput {
+    company?: string | undefined;
+    user?: string | undefined;
+    skillId: string;
+    /**
+     * Relative path of a bundled file inside the skill, e.g. 'scripts/run.py'. No '..'.
+     * @public
+     */
+    path: string;
+    kind: SkillFileKind;
+    contentType?: string | undefined;
+    executable?: boolean | undefined;
+    size: number;
+    checksum: string;
+}
+/**
+ * @public
+ */
+export interface CreateSkillFileUploadOutput {
+    /**
+     * A file bundled with a skill. Content is stored in S3 and uploaded/downloaded via presigned URLs.
+     * @public
+     */
+    file: SkillFile;
+    /**
+     * Presigned PUT URL the client uploads bytes to.
+     * @public
+     */
+    uploadUrl: string;
+    expiresAt: string;
+}
 /**
  * @public
  */
@@ -520,6 +784,23 @@ export interface DeleteChatInput {
  */
 export interface DeleteChatOutput {
 }
+/**
+ * @public
+ */
+export interface DeleteFileInput {
+    company?: string | undefined;
+    user?: string | undefined;
+    /**
+     * Nano-id file identifier (12 characters).
+     * @public
+     */
+    fileId: string;
+}
+/**
+ * @public
+ */
+export interface DeleteFileOutput {
+}
 /**
  * @public
  */
@@ -566,6 +847,37 @@ export interface DeleteGuidelinesDirectoryInput {
  */
 export interface DeleteGuidelinesDirectoryOutput {
 }
+/**
+ * @public
+ */
+export interface DeleteSkillInput {
+    company?: string | undefined;
+    user?: string | undefined;
+    skillId: string;
+}
+/**
+ * @public
+ */
+export interface DeleteSkillOutput {
+}
+/**
+ * @public
+ */
+export interface DeleteSkillFileInput {
+    company?: string | undefined;
+    user?: string | undefined;
+    skillId: string;
+    /**
+     * Relative path of a bundled file inside the skill, e.g. 'scripts/run.py'. No '..'.
+     * @public
+     */
+    path: string;
+}
+/**
+ * @public
+ */
+export interface DeleteSkillFileOutput {
+}
 /**
  * @public
  */
@@ -589,6 +901,38 @@ export interface DislikeAnswerInput {
  */
 export interface DislikeAnswerOutput {
 }
+/**
+ * @public
+ */
+export interface DownloadFileInput {
+    company?: string | undefined;
+    user?: string | undefined;
+    /**
+     * Nano-id file identifier (12 characters).
+     * @public
+     */
+    fileId: string;
+}
+/**
+ * @public
+ */
+export interface DownloadFileOutput {
+    /**
+     * Presigned download URL.
+     * @public
+     */
+    url: string;
+    /**
+     * ISO-8601 expiry of the URL.
+     * @public
+     */
+    expiresAt: string;
+    /**
+     * A file produced (or shared) by an agent during a session. Content lives in S3; download via the Files API.
+     * @public
+     */
+    file: WilmaFile;
+}
 /**
  * @public
  */
@@ -615,6 +959,21 @@ export interface ExecuteAgentInput {
      * @public
      */
     user?: string | undefined;
+    /**
+     * Parent agent id that invoked this execution (agent-to-agent calls).
+     * @public
+     */
+    parentAgentId?: string | undefined;
+    /**
+     * Parent session id that invoked this execution.
+     * @public
+     */
+    parentSessionId?: string | undefined;
+    /**
+     * Files (by id) created by another agent to make available to this execution.
+     * @public
+     */
+    files?: string[] | undefined;
 }
 /**
  * @public
@@ -662,6 +1021,28 @@ export interface GetChatOutput {
     chat: Chat;
     history: ChatHistory;
 }
+/**
+ * @public
+ */
+export interface GetFileInput {
+    company?: string | undefined;
+    user?: string | undefined;
+    /**
+     * Nano-id file identifier (12 characters).
+     * @public
+     */
+    fileId: string;
+}
+/**
+ * @public
+ */
+export interface GetFileOutput {
+    /**
+     * A file produced (or shared) by an agent during a session. Content lives in S3; download via the Files API.
+     * @public
+     */
+    file: WilmaFile;
+}
 /**
  * @public
  */
@@ -734,10 +1115,10 @@ export interface OrganizationToolIntegration {
  * @public
  */
 export interface GetOrganizationSettingsOutput {
-    agents?: (OrganizationAgentIntegration)[] | undefined;
-    tools?: (OrganizationToolIntegration)[] | undefined;
-    knowledgeBases?: (OrganizationKnowledgeBaseIntegration)[] | undefined;
-    guidelines?: (OrganizationGuidelineIntegration)[] | undefined;
+    agents?: OrganizationAgentIntegration[] | undefined;
+    tools?: OrganizationToolIntegration[] | undefined;
+    knowledgeBases?: OrganizationKnowledgeBaseIntegration[] | undefined;
+    guidelines?: OrganizationGuidelineIntegration[] | undefined;
 }
 /**
  * @public
@@ -764,13 +1145,13 @@ export interface UserAboutSettings {
  * @public
  */
 export interface UserGuidelinesSettings {
-    disabled?: (string)[] | undefined;
+    disabled?: string[] | undefined;
 }
 /**
  * @public
  */
 export interface UserIntegrationsSettings {
-    disabled?: (string)[] | undefined;
+    disabled?: string[] | undefined;
 }
 /**
  * @public
@@ -784,11 +1165,45 @@ export interface UserStyleSettings {
 export interface GetSettingsOutput {
     style?: UserStyleSettings | undefined;
     about?: UserAboutSettings | undefined;
-    agents?: (AgentInfo)[] | undefined;
-    guidelines?: (Guideline)[] | undefined;
+    agents?: AgentInfo[] | undefined;
+    guidelines?: Guideline[] | undefined;
     guidelinesSettings?: UserGuidelinesSettings | undefined;
     integrations?: UserIntegrationsSettings | undefined;
 }
+/**
+ * @public
+ */
+export interface GetSkillInput {
+    company?: string | undefined;
+    user?: string | undefined;
+    skillId: string;
+}
+/**
+ * @public
+ */
+export interface GetSkillOutput {
+    skill: Skill;
+}
+/**
+ * @public
+ */
+export interface GetSkillFileDownloadInput {
+    company?: string | undefined;
+    user?: string | undefined;
+    skillId: string;
+    /**
+     * Relative path of a bundled file inside the skill, e.g. 'scripts/run.py'. No '..'.
+     * @public
+     */
+    path: string;
+}
+/**
+ * @public
+ */
+export interface GetSkillFileDownloadOutput {
+    url: string;
+    expiresAt: string;
+}
 /**
  * @public
  */
@@ -847,7 +1262,7 @@ export interface ListAgentFeedbacksInput {
  * @public
  */
 export interface ListAgentFeedbacksOutput {
-    feedbacks: (ChatFeedback)[];
+    feedbacks: ChatFeedback[];
     lastEvaluatedKey?: string | undefined;
 }
 /**
@@ -860,7 +1275,7 @@ export interface ListAgentsInput {
  * @public
  */
 export interface ListAgentsOutput {
-    agents: (Agent)[];
+    agents: Agent[];
 }
 /**
  * @public
@@ -872,7 +1287,7 @@ export interface ListAgentsNamesInput {
  * @public
  */
 export interface ListAgentsNamesOutput {
-    agents: (AgentInfo)[];
+    agents: AgentInfo[];
 }
 /**
  * @public
@@ -894,7 +1309,7 @@ export interface ListChatsInput {
  * @public
  */
 export interface ListChatsOutput {
-    chats: (Chat)[];
+    chats: Chat[];
     lastEvaluatedKey?: string | undefined;
 }
 /**
@@ -912,7 +1327,7 @@ export interface ListFeedbacksInput {
  * @public
  */
 export interface ListFeedbacksOutput {
-    feedbacks: (ChatFeedback)[];
+    feedbacks: ChatFeedback[];
     lastEvaluatedKey?: string | undefined;
 }
 /**
@@ -934,7 +1349,7 @@ export interface ListGuidelinesInput {
  * @public
  */
 export interface ListGuidelinesOutput {
-    guidelines: (Guideline)[];
+    guidelines: Guideline[];
 }
 /**
  * @public
@@ -955,7 +1370,7 @@ export interface ListGuidelinesDirectoriesInput {
  * @public
  */
 export interface ListGuidelinesDirectoriesOutput {
-    directories: (GuidelineDirectoryInfo)[];
+    directories: GuidelineDirectoryInfo[];
 }
 /**
  * @public
@@ -976,7 +1391,37 @@ export interface ListGuidelinesNamesInput {
  * @public
  */
 export interface ListGuidelinesNamesOutput {
-    guidelines: (GuidelineInfo)[];
+    guidelines: GuidelineInfo[];
+}
+/**
+ * @public
+ */
+export interface ListSkillsInput {
+    company?: string | undefined;
+    user?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface SkillInfo {
+    id: string;
+    createdAt: string;
+    createdBy: string;
+    createdByName: string;
+    updatedAt?: string | undefined;
+    name: string;
+    description: string;
+    /**
+     * Number of bundled files.
+     * @public
+     */
+    fileCount?: number | undefined;
+}
+/**
+ * @public
+ */
+export interface ListSkillsOutput {
+    skills: SkillInfo[];
 }
 /**
  * @public
@@ -987,19 +1432,19 @@ export interface PatchOrganizationSettingsInput {
      * @public
      */
     company?: string | undefined;
-    agents?: (OrganizationAgentIntegration)[] | undefined;
-    tools?: (OrganizationToolIntegration)[] | undefined;
-    knowledgeBases?: (OrganizationKnowledgeBaseIntegration)[] | undefined;
-    guidelines?: (OrganizationGuidelineIntegration)[] | undefined;
+    agents?: OrganizationAgentIntegration[] | undefined;
+    tools?: OrganizationToolIntegration[] | undefined;
+    knowledgeBases?: OrganizationKnowledgeBaseIntegration[] | undefined;
+    guidelines?: OrganizationGuidelineIntegration[] | undefined;
 }
 /**
  * @public
  */
 export interface PatchOrganizationSettingsOutput {
-    agents?: (OrganizationAgentIntegration)[] | undefined;
-    tools?: (OrganizationToolIntegration)[] | undefined;
-    knowledgeBases?: (OrganizationKnowledgeBaseIntegration)[] | undefined;
-    guidelines?: (OrganizationGuidelineIntegration)[] | undefined;
+    agents?: OrganizationAgentIntegration[] | undefined;
+    tools?: OrganizationToolIntegration[] | undefined;
+    knowledgeBases?: OrganizationKnowledgeBaseIntegration[] | undefined;
+    guidelines?: OrganizationGuidelineIntegration[] | undefined;
 }
 /**
  * @public
@@ -1026,8 +1471,8 @@ export interface PatchSettingsInput {
 export interface PatchSettingsOutput {
     style?: UserStyleSettings | undefined;
     about?: UserAboutSettings | undefined;
-    agents?: (AgentInfo)[] | undefined;
-    guidelines?: (Guideline)[] | undefined;
+    agents?: AgentInfo[] | undefined;
+    guidelines?: Guideline[] | undefined;
     guidelinesSettings?: UserGuidelinesSettings | undefined;
     integrations?: UserIntegrationsSettings | undefined;
 }
@@ -1042,9 +1487,18 @@ export interface UpdateAgentInput {
      */
     category?: string | undefined;
     instructions: string;
-    guidelines?: (string)[] | undefined;
-    variables?: (AgentVariable)[] | undefined;
-    capabilities?: (AgentCapability)[] | undefined;
+    /**
+     * @deprecated Use `skills` instead. Guidelines are eagerly injected; skills use progressive disclosure.
+     * @public
+     */
+    guidelines?: string[] | undefined;
+    /**
+     * Skills attached to this agent (progressive disclosure; replaces guidelines).
+     * @public
+     */
+    skills?: string[] | undefined;
+    variables?: AgentVariable[] | undefined;
+    capabilities?: AgentCapability[] | undefined;
     /**
      * AI model specification using URI format for provider, model and parameters. Examples: 'default', 'google://gemini-3-flash-preview', 'openai://gpt-4o?timeout=30&temperature=0.7', 'openai://gpt-4.1'
      * @public
@@ -1143,3 +1597,24 @@ export interface UpdateGuidelinesDirectoryInput {
 export interface UpdateGuidelinesDirectoryOutput {
     directory: GuidelineDirectoryInfo;
 }
+/**
+ * @public
+ */
+export interface UpdateSkillInput {
+    name: string;
+    description: string;
+    /**
+     * The SKILL.md body (instructions). Progressive disclosure: loaded on demand via load_skill.
+     * @public
+     */
+    content: string;
+    company?: string | undefined;
+    user?: string | undefined;
+    skillId: string;
+}
+/**
+ * @public
+ */
+export interface UpdateSkillOutput {
+    skill: Skill;
+}