@redplanethq/sdk 0.1.18 → 0.1.20

package/dist/index.d.mts

@@ -385,6 +385,20 @@ declare class McpAuthParams {
     server_url: string;
 }
 
+/** A single config field declared by a widget */
+interface WidgetConfigField {
+    key: string;
+    label: string;
+    type: 'input' | 'select';
+    placeholder?: string;
+    required?: boolean;
+    /** Options for select fields only */
+    options?: Array<{
+        label: string;
+        value: string;
+    }>;
+    default?: string;
+}
 interface WidgetRenderContext {
     placement: 'tui' | 'webapp';
     pat: string;
@@ -394,6 +408,8 @@ interface WidgetRenderContext {
         name?: string;
     }>;
     baseUrl: string;
+    /** Config values supplied by the agent or by the user via the config form */
+    config?: Record<string, string>;
     /** Call to trigger a TUI re-render after updating internal state (TUI only) */
     requestRender?: () => void;
 }
@@ -404,6 +420,8 @@ interface WidgetMeta {
     description: string;
     support: Array<'tui' | 'webapp'>;
     tuiPlacement?: 'overview' | 'below-input';
+    /** Declares config fields the widget accepts; drives the config form when agent omits them */
+    configSchema?: WidgetConfigField[];
 }
 /**
  * A zero-argument React function component (webapp placement).
@@ -463,7 +481,7 @@ interface ToolUIRenderContext {
  */
 interface ToolUI {
     supported_tools: string[];
-    render(toolName: string, input: ToolInput, result: ToolResult | null, context: ToolUIRenderContext, submitInput: (input: ToolInput) => void): Promise<ToolUIComponent>;
+    render(toolName: string, input: ToolInput, result: ToolResult | null, context: ToolUIRenderContext, submitInput: (input: ToolInput) => void, onDecline: () => void): Promise<ToolUIComponent>;
 }
 /**
  * Shape exported by an integration's frontend.js bundle.
@@ -1115,10 +1133,61 @@ declare const GetDocumentResponseSchema: z.ZodObject<{
     };
 }>;
 type GetDocumentResponse = z.infer<typeof GetDocumentResponseSchema>;
+declare const GetSkillInputSchema: z.ZodObject<{
+    skillId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    skillId?: string;
+}, {
+    skillId?: string;
+}>;
+type GetSkillInput = z.infer<typeof GetSkillInputSchema>;
+declare const GetSkillResponseSchema: z.ZodObject<{
+    skill: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        createdAt: z.ZodOptional<z.ZodString>;
+        sessionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodString;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        createdAt: z.ZodOptional<z.ZodString>;
+        sessionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodString;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        createdAt: z.ZodOptional<z.ZodString>;
+        sessionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.ZodTypeAny, "passthrough">>>;
+}, "strip", z.ZodTypeAny, {
+    skill?: {
+        source?: string;
+        sessionId?: string;
+        title?: string;
+        id?: string;
+        createdAt?: string;
+    } & {
+        [k: string]: unknown;
+    };
+}, {
+    skill?: {
+        source?: string;
+        sessionId?: string;
+        title?: string;
+        id?: string;
+        createdAt?: string;
+    } & {
+        [k: string]: unknown;
+    };
+}>;
+type GetSkillResponse = z.infer<typeof GetSkillResponseSchema>;
 declare const GatewayAgentInfoSchema: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
     description: z.ZodString;
+    baseUrl: z.ZodString;
     tools: z.ZodArray<z.ZodString, "many">;
     platform: z.ZodNullable<z.ZodString>;
     hostname: z.ZodNullable<z.ZodString>;
@@ -1129,6 +1198,7 @@ declare const GatewayAgentInfoSchema: z.ZodObject<{
     id?: string;
     name?: string;
     description?: string;
+    baseUrl?: string;
     platform?: string;
     hostname?: string;
 }, {
@@ -1137,15 +1207,45 @@ declare const GatewayAgentInfoSchema: z.ZodObject<{
     id?: string;
     name?: string;
     description?: string;
+    baseUrl?: string;
     platform?: string;
     hostname?: string;
 }>;
+declare const RegisterGatewayRequestSchema: z.ZodObject<{
+    intent: z.ZodLiteral<"register">;
+    baseUrl: z.ZodString;
+    securityKey: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name?: string;
+    description?: string;
+    baseUrl?: string;
+    intent?: "register";
+    securityKey?: string;
+}, {
+    name?: string;
+    description?: string;
+    baseUrl?: string;
+    intent?: "register";
+    securityKey?: string;
+}>;
+type RegisterGatewayRequest = z.infer<typeof RegisterGatewayRequestSchema>;
+declare const RegisterGatewayResponseSchema: z.ZodObject<{
+    gatewayId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    gatewayId?: string;
+}, {
+    gatewayId?: string;
+}>;
+type RegisterGatewayResponse = z.infer<typeof RegisterGatewayResponseSchema>;
 type GatewayAgentInfo = z.infer<typeof GatewayAgentInfoSchema>;
 declare const GetGatewaysResponseSchema: z.ZodObject<{
     gateways: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         name: z.ZodString;
         description: z.ZodString;
+        baseUrl: z.ZodString;
         tools: z.ZodArray<z.ZodString, "many">;
         platform: z.ZodNullable<z.ZodString>;
         hostname: z.ZodNullable<z.ZodString>;
@@ -1156,6 +1256,7 @@ declare const GetGatewaysResponseSchema: z.ZodObject<{
         id?: string;
         name?: string;
         description?: string;
+        baseUrl?: string;
         platform?: string;
         hostname?: string;
     }, {
@@ -1164,6 +1265,7 @@ declare const GetGatewaysResponseSchema: z.ZodObject<{
         id?: string;
         name?: string;
         description?: string;
+        baseUrl?: string;
         platform?: string;
         hostname?: string;
     }>, "many">;
@@ -1174,6 +1276,7 @@ declare const GetGatewaysResponseSchema: z.ZodObject<{
         id?: string;
         name?: string;
         description?: string;
+        baseUrl?: string;
         platform?: string;
         hostname?: string;
     }[];
@@ -1184,44 +1287,12 @@ declare const GetGatewaysResponseSchema: z.ZodObject<{
         id?: string;
         name?: string;
         description?: string;
+        baseUrl?: string;
         platform?: string;
         hostname?: string;
     }[];
 }>;
 type GetGatewaysResponse = z.infer<typeof GetGatewaysResponseSchema>;
-declare const ExecuteGatewayInputSchema: z.ZodObject<{
-    gatewayId: z.ZodString;
-    intent: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    gatewayId?: string;
-    intent?: string;
-}, {
-    gatewayId?: string;
-    intent?: string;
-}>;
-type ExecuteGatewayInput = z.infer<typeof ExecuteGatewayInputSchema>;
-declare const ExecuteGatewayToolInputSchema: z.ZodObject<{
-    gatewayId: z.ZodString;
-    toolName: z.ZodString;
-    params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-}, "strip", z.ZodTypeAny, {
-    params?: Record<string, unknown>;
-    gatewayId?: string;
-    toolName?: string;
-}, {
-    params?: Record<string, unknown>;
-    gatewayId?: string;
-    toolName?: string;
-}>;
-type ExecuteGatewayToolInput = z.infer<typeof ExecuteGatewayToolInputSchema>;
-declare const ExecuteGatewayResponseSchema: z.ZodObject<{
-    result: z.ZodUnknown;
-}, "strip", z.ZodTypeAny, {
-    result?: unknown;
-}, {
-    result?: unknown;
-}>;
-type ExecuteGatewayResponse = z.infer<typeof ExecuteGatewayResponseSchema>;
 declare const AuthorizationCodeResponseSchema: z.ZodObject<{
     authorizationCode: z.ZodString;
     url: z.ZodString;
@@ -1288,12 +1359,12 @@ declare class CoreClient {
     getSessionId(): Promise<string>;
     getDocuments(params?: GetDocumentsInput): Promise<GetDocumentsResponse>;
     getDocument(params: GetDocumentInput): Promise<GetDocumentResponse>;
+    getSkill(params: GetSkillInput): Promise<GetSkillResponse>;
     getGateways(): Promise<GetGatewaysResponse>;
-    executeGateway(params: ExecuteGatewayInput): Promise<ExecuteGatewayResponse>;
-    executeGatewayTool(params: ExecuteGatewayToolInput): Promise<ExecuteGatewayResponse>;
+    registerGateway(input: Omit<RegisterGatewayRequest, "intent">): Promise<RegisterGatewayResponse>;
     getAuthorizationCode(): Promise<AuthorizationCodeResponse>;
     exchangeToken(params: TokenExchangeInput): Promise<TokenExchangeResponse>;
     checkAuth(): Promise<MeResponse>;
 }
 
-export { APIKeyParams, ActionStatus, ActionStatusEnum, type AddEpisodeParams, type AddEpisodeResult, type AdjacentChunks, type AuthType, type AuthorizationCodeResponse, AuthorizationCodeResponseSchema, COMPACTED_SESSION_NODE_PROPERTIES, ClaudeModels, type CompactedSessionNode, type Config, CoreClient, CoreClientError, type CoreClientOptions, type CreatePatternParams, type DocumentNode, DocumentSchema, ENTITY_NODE_PROPERTIES, EPISODIC_NODE_PROPERTIES, EXPLICIT_PATTERN_TYPES, type EntityNode, type EntityType, EntityTypes, type EpisodeSearchResult, EpisodeType, EpisodeTypeEnum, type EpisodeWithProvenance, type EpisodicNode, type EpisodicNodeWithoutEmbeddings, type ExecuteGatewayInput, ExecuteGatewayInputSchema, type ExecuteGatewayResponse, ExecuteGatewayResponseSchema, type ExecuteGatewayToolInput, ExecuteGatewayToolInputSchema, type ExecuteIntegrationActionInput, ExecuteIntegrationActionInputSchema, type ExecuteIntegrationActionResponse, ExecuteIntegrationActionResponseSchema, type ExplicitPatternType, type ExtractedTripleData, type FrontendExport, GRAPH_ASPECTS, type GatewayAgentInfo, GatewayAgentInfoSchema, GeminiModels, type GetDocumentInput, GetDocumentInputSchema, type GetDocumentResponse, GetDocumentResponseSchema, type GetDocumentsInput, GetDocumentsInputSchema, type GetDocumentsResponse, GetDocumentsResponseSchema, type GetGatewaysResponse, GetGatewaysResponseSchema, type GetIntegrationActionsInput, GetIntegrationActionsInputSchema, type GetIntegrationActionsResponse, GetIntegrationActionsResponseSchema, type GetIntegrationsConnectedResponse, GetIntegrationsConnectedResponseSchema, type GraphAspect, IMPLICIT_PATTERN_TYPES, type Identifier, type ImplicitPatternType, type IngestInput, IngestInputSchema, type IngestResponse, IngestResponseSchema, IntegrationAccountSchema, IntegrationCLI, type IntegrationEventPayload, IntegrationEventType, LLMMappings, LLMModelEnum, LLMModelType, McpAuthParams, type MeResponse, MeResponseSchema, type Message, type MessageType, OAuth2Params, OpenAIModels, PATTERN_TYPES, type Param, type PatternConfirmationParams, type PatternDetectionResult, type PatternType, QUALITY_THRESHOLDS, type QualityFilterResult, type RerankConfig, STATEMENT_NODE_PROPERTIES, type SearchInput, SearchInputSchema, type SearchOptions, type SearchResponse, SearchResponseSchema, type SpaceAssignmentResult, type SpaceDeletionResult, type SpaceNode, type SpacePattern, Spec, type StatementAspect, StatementAspects, type StatementNode, type StatementWithSource, type TokenExchangeInput, TokenExchangeInputSchema, type TokenExchangeResponse, TokenExchangeResponseSchema, type ToolContent, type ToolInput, type ToolInputPrimitive, type ToolInputValue, type ToolResult, type ToolUI, type ToolUIComponent, type ToolUIRenderContext, type Triple, type TuiToolUIComponent, type TuiWidgetComponent, type UserConfirmationStatus, UserTypeEnum, VOICE_ASPECTS, type VoiceAspect, type VoiceAspectNode, type WebToolUIComponent, type WebWidgetComponent, type WidgetComponent, type WidgetMeta, type WidgetRenderContext, type WidgetSpec };
+export { APIKeyParams, ActionStatus, ActionStatusEnum, type AddEpisodeParams, type AddEpisodeResult, type AdjacentChunks, type AuthType, type AuthorizationCodeResponse, AuthorizationCodeResponseSchema, COMPACTED_SESSION_NODE_PROPERTIES, ClaudeModels, type CompactedSessionNode, type Config, CoreClient, CoreClientError, type CoreClientOptions, type CreatePatternParams, type DocumentNode, DocumentSchema, ENTITY_NODE_PROPERTIES, EPISODIC_NODE_PROPERTIES, EXPLICIT_PATTERN_TYPES, type EntityNode, type EntityType, EntityTypes, type EpisodeSearchResult, EpisodeType, EpisodeTypeEnum, type EpisodeWithProvenance, type EpisodicNode, type EpisodicNodeWithoutEmbeddings, type ExecuteIntegrationActionInput, ExecuteIntegrationActionInputSchema, type ExecuteIntegrationActionResponse, ExecuteIntegrationActionResponseSchema, type ExplicitPatternType, type ExtractedTripleData, type FrontendExport, GRAPH_ASPECTS, type GatewayAgentInfo, GatewayAgentInfoSchema, GeminiModels, type GetDocumentInput, GetDocumentInputSchema, type GetDocumentResponse, GetDocumentResponseSchema, type GetDocumentsInput, GetDocumentsInputSchema, type GetDocumentsResponse, GetDocumentsResponseSchema, type GetGatewaysResponse, GetGatewaysResponseSchema, type GetIntegrationActionsInput, GetIntegrationActionsInputSchema, type GetIntegrationActionsResponse, GetIntegrationActionsResponseSchema, type GetIntegrationsConnectedResponse, GetIntegrationsConnectedResponseSchema, type GetSkillInput, GetSkillInputSchema, type GetSkillResponse, GetSkillResponseSchema, type GraphAspect, IMPLICIT_PATTERN_TYPES, type Identifier, type ImplicitPatternType, type IngestInput, IngestInputSchema, type IngestResponse, IngestResponseSchema, IntegrationAccountSchema, IntegrationCLI, type IntegrationEventPayload, IntegrationEventType, LLMMappings, LLMModelEnum, LLMModelType, McpAuthParams, type MeResponse, MeResponseSchema, type Message, type MessageType, OAuth2Params, OpenAIModels, PATTERN_TYPES, type Param, type PatternConfirmationParams, type PatternDetectionResult, type PatternType, QUALITY_THRESHOLDS, type QualityFilterResult, type RegisterGatewayRequest, RegisterGatewayRequestSchema, type RegisterGatewayResponse, RegisterGatewayResponseSchema, type RerankConfig, STATEMENT_NODE_PROPERTIES, type SearchInput, SearchInputSchema, type SearchOptions, type SearchResponse, SearchResponseSchema, type SpaceAssignmentResult, type SpaceDeletionResult, type SpaceNode, type SpacePattern, Spec, type StatementAspect, StatementAspects, type StatementNode, type StatementWithSource, type TokenExchangeInput, TokenExchangeInputSchema, type TokenExchangeResponse, TokenExchangeResponseSchema, type ToolContent, type ToolInput, type ToolInputPrimitive, type ToolInputValue, type ToolResult, type ToolUI, type ToolUIComponent, type ToolUIRenderContext, type Triple, type TuiToolUIComponent, type TuiWidgetComponent, type UserConfirmationStatus, UserTypeEnum, VOICE_ASPECTS, type VoiceAspect, type VoiceAspectNode, type WebToolUIComponent, type WebWidgetComponent, type WidgetComponent, type WidgetConfigField, type WidgetMeta, type WidgetRenderContext, type WidgetSpec };

package/dist/index.d.ts

@@ -385,6 +385,20 @@ declare class McpAuthParams {
     server_url: string;
 }
 
+/** A single config field declared by a widget */
+interface WidgetConfigField {
+    key: string;
+    label: string;
+    type: 'input' | 'select';
+    placeholder?: string;
+    required?: boolean;
+    /** Options for select fields only */
+    options?: Array<{
+        label: string;
+        value: string;
+    }>;
+    default?: string;
+}
 interface WidgetRenderContext {
     placement: 'tui' | 'webapp';
     pat: string;
@@ -394,6 +408,8 @@ interface WidgetRenderContext {
         name?: string;
     }>;
     baseUrl: string;
+    /** Config values supplied by the agent or by the user via the config form */
+    config?: Record<string, string>;
     /** Call to trigger a TUI re-render after updating internal state (TUI only) */
     requestRender?: () => void;
 }
@@ -404,6 +420,8 @@ interface WidgetMeta {
     description: string;
     support: Array<'tui' | 'webapp'>;
     tuiPlacement?: 'overview' | 'below-input';
+    /** Declares config fields the widget accepts; drives the config form when agent omits them */
+    configSchema?: WidgetConfigField[];
 }
 /**
  * A zero-argument React function component (webapp placement).
@@ -463,7 +481,7 @@ interface ToolUIRenderContext {
  */
 interface ToolUI {
     supported_tools: string[];
-    render(toolName: string, input: ToolInput, result: ToolResult | null, context: ToolUIRenderContext, submitInput: (input: ToolInput) => void): Promise<ToolUIComponent>;
+    render(toolName: string, input: ToolInput, result: ToolResult | null, context: ToolUIRenderContext, submitInput: (input: ToolInput) => void, onDecline: () => void): Promise<ToolUIComponent>;
 }
 /**
  * Shape exported by an integration's frontend.js bundle.
@@ -1115,10 +1133,61 @@ declare const GetDocumentResponseSchema: z.ZodObject<{
     };
 }>;
 type GetDocumentResponse = z.infer<typeof GetDocumentResponseSchema>;
+declare const GetSkillInputSchema: z.ZodObject<{
+    skillId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    skillId?: string;
+}, {
+    skillId?: string;
+}>;
+type GetSkillInput = z.infer<typeof GetSkillInputSchema>;
+declare const GetSkillResponseSchema: z.ZodObject<{
+    skill: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        createdAt: z.ZodOptional<z.ZodString>;
+        sessionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodString;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        createdAt: z.ZodOptional<z.ZodString>;
+        sessionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodString;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        createdAt: z.ZodOptional<z.ZodString>;
+        sessionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.ZodTypeAny, "passthrough">>>;
+}, "strip", z.ZodTypeAny, {
+    skill?: {
+        source?: string;
+        sessionId?: string;
+        title?: string;
+        id?: string;
+        createdAt?: string;
+    } & {
+        [k: string]: unknown;
+    };
+}, {
+    skill?: {
+        source?: string;
+        sessionId?: string;
+        title?: string;
+        id?: string;
+        createdAt?: string;
+    } & {
+        [k: string]: unknown;
+    };
+}>;
+type GetSkillResponse = z.infer<typeof GetSkillResponseSchema>;
 declare const GatewayAgentInfoSchema: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
     description: z.ZodString;
+    baseUrl: z.ZodString;
     tools: z.ZodArray<z.ZodString, "many">;
     platform: z.ZodNullable<z.ZodString>;
     hostname: z.ZodNullable<z.ZodString>;
@@ -1129,6 +1198,7 @@ declare const GatewayAgentInfoSchema: z.ZodObject<{
     id?: string;
     name?: string;
     description?: string;
+    baseUrl?: string;
     platform?: string;
     hostname?: string;
 }, {
@@ -1137,15 +1207,45 @@ declare const GatewayAgentInfoSchema: z.ZodObject<{
     id?: string;
     name?: string;
     description?: string;
+    baseUrl?: string;
     platform?: string;
     hostname?: string;
 }>;
+declare const RegisterGatewayRequestSchema: z.ZodObject<{
+    intent: z.ZodLiteral<"register">;
+    baseUrl: z.ZodString;
+    securityKey: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name?: string;
+    description?: string;
+    baseUrl?: string;
+    intent?: "register";
+    securityKey?: string;
+}, {
+    name?: string;
+    description?: string;
+    baseUrl?: string;
+    intent?: "register";
+    securityKey?: string;
+}>;
+type RegisterGatewayRequest = z.infer<typeof RegisterGatewayRequestSchema>;
+declare const RegisterGatewayResponseSchema: z.ZodObject<{
+    gatewayId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    gatewayId?: string;
+}, {
+    gatewayId?: string;
+}>;
+type RegisterGatewayResponse = z.infer<typeof RegisterGatewayResponseSchema>;
 type GatewayAgentInfo = z.infer<typeof GatewayAgentInfoSchema>;
 declare const GetGatewaysResponseSchema: z.ZodObject<{
     gateways: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         name: z.ZodString;
         description: z.ZodString;
+        baseUrl: z.ZodString;
         tools: z.ZodArray<z.ZodString, "many">;
         platform: z.ZodNullable<z.ZodString>;
         hostname: z.ZodNullable<z.ZodString>;
@@ -1156,6 +1256,7 @@ declare const GetGatewaysResponseSchema: z.ZodObject<{
         id?: string;
         name?: string;
         description?: string;
+        baseUrl?: string;
         platform?: string;
         hostname?: string;
     }, {
@@ -1164,6 +1265,7 @@ declare const GetGatewaysResponseSchema: z.ZodObject<{
         id?: string;
         name?: string;
         description?: string;
+        baseUrl?: string;
         platform?: string;
         hostname?: string;
     }>, "many">;
@@ -1174,6 +1276,7 @@ declare const GetGatewaysResponseSchema: z.ZodObject<{
         id?: string;
         name?: string;
         description?: string;
+        baseUrl?: string;
         platform?: string;
         hostname?: string;
     }[];
@@ -1184,44 +1287,12 @@ declare const GetGatewaysResponseSchema: z.ZodObject<{
         id?: string;
         name?: string;
         description?: string;
+        baseUrl?: string;
         platform?: string;
         hostname?: string;
     }[];
 }>;
 type GetGatewaysResponse = z.infer<typeof GetGatewaysResponseSchema>;
-declare const ExecuteGatewayInputSchema: z.ZodObject<{
-    gatewayId: z.ZodString;
-    intent: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    gatewayId?: string;
-    intent?: string;
-}, {
-    gatewayId?: string;
-    intent?: string;
-}>;
-type ExecuteGatewayInput = z.infer<typeof ExecuteGatewayInputSchema>;
-declare const ExecuteGatewayToolInputSchema: z.ZodObject<{
-    gatewayId: z.ZodString;
-    toolName: z.ZodString;
-    params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-}, "strip", z.ZodTypeAny, {
-    params?: Record<string, unknown>;
-    gatewayId?: string;
-    toolName?: string;
-}, {
-    params?: Record<string, unknown>;
-    gatewayId?: string;
-    toolName?: string;
-}>;
-type ExecuteGatewayToolInput = z.infer<typeof ExecuteGatewayToolInputSchema>;
-declare const ExecuteGatewayResponseSchema: z.ZodObject<{
-    result: z.ZodUnknown;
-}, "strip", z.ZodTypeAny, {
-    result?: unknown;
-}, {
-    result?: unknown;
-}>;
-type ExecuteGatewayResponse = z.infer<typeof ExecuteGatewayResponseSchema>;
 declare const AuthorizationCodeResponseSchema: z.ZodObject<{
     authorizationCode: z.ZodString;
     url: z.ZodString;
@@ -1288,12 +1359,12 @@ declare class CoreClient {
     getSessionId(): Promise<string>;
     getDocuments(params?: GetDocumentsInput): Promise<GetDocumentsResponse>;
     getDocument(params: GetDocumentInput): Promise<GetDocumentResponse>;
+    getSkill(params: GetSkillInput): Promise<GetSkillResponse>;
     getGateways(): Promise<GetGatewaysResponse>;
-    executeGateway(params: ExecuteGatewayInput): Promise<ExecuteGatewayResponse>;
-    executeGatewayTool(params: ExecuteGatewayToolInput): Promise<ExecuteGatewayResponse>;
+    registerGateway(input: Omit<RegisterGatewayRequest, "intent">): Promise<RegisterGatewayResponse>;
     getAuthorizationCode(): Promise<AuthorizationCodeResponse>;
     exchangeToken(params: TokenExchangeInput): Promise<TokenExchangeResponse>;
     checkAuth(): Promise<MeResponse>;
 }
 
-export { APIKeyParams, ActionStatus, ActionStatusEnum, type AddEpisodeParams, type AddEpisodeResult, type AdjacentChunks, type AuthType, type AuthorizationCodeResponse, AuthorizationCodeResponseSchema, COMPACTED_SESSION_NODE_PROPERTIES, ClaudeModels, type CompactedSessionNode, type Config, CoreClient, CoreClientError, type CoreClientOptions, type CreatePatternParams, type DocumentNode, DocumentSchema, ENTITY_NODE_PROPERTIES, EPISODIC_NODE_PROPERTIES, EXPLICIT_PATTERN_TYPES, type EntityNode, type EntityType, EntityTypes, type EpisodeSearchResult, EpisodeType, EpisodeTypeEnum, type EpisodeWithProvenance, type EpisodicNode, type EpisodicNodeWithoutEmbeddings, type ExecuteGatewayInput, ExecuteGatewayInputSchema, type ExecuteGatewayResponse, ExecuteGatewayResponseSchema, type ExecuteGatewayToolInput, ExecuteGatewayToolInputSchema, type ExecuteIntegrationActionInput, ExecuteIntegrationActionInputSchema, type ExecuteIntegrationActionResponse, ExecuteIntegrationActionResponseSchema, type ExplicitPatternType, type ExtractedTripleData, type FrontendExport, GRAPH_ASPECTS, type GatewayAgentInfo, GatewayAgentInfoSchema, GeminiModels, type GetDocumentInput, GetDocumentInputSchema, type GetDocumentResponse, GetDocumentResponseSchema, type GetDocumentsInput, GetDocumentsInputSchema, type GetDocumentsResponse, GetDocumentsResponseSchema, type GetGatewaysResponse, GetGatewaysResponseSchema, type GetIntegrationActionsInput, GetIntegrationActionsInputSchema, type GetIntegrationActionsResponse, GetIntegrationActionsResponseSchema, type GetIntegrationsConnectedResponse, GetIntegrationsConnectedResponseSchema, type GraphAspect, IMPLICIT_PATTERN_TYPES, type Identifier, type ImplicitPatternType, type IngestInput, IngestInputSchema, type IngestResponse, IngestResponseSchema, IntegrationAccountSchema, IntegrationCLI, type IntegrationEventPayload, IntegrationEventType, LLMMappings, LLMModelEnum, LLMModelType, McpAuthParams, type MeResponse, MeResponseSchema, type Message, type MessageType, OAuth2Params, OpenAIModels, PATTERN_TYPES, type Param, type PatternConfirmationParams, type PatternDetectionResult, type PatternType, QUALITY_THRESHOLDS, type QualityFilterResult, type RerankConfig, STATEMENT_NODE_PROPERTIES, type SearchInput, SearchInputSchema, type SearchOptions, type SearchResponse, SearchResponseSchema, type SpaceAssignmentResult, type SpaceDeletionResult, type SpaceNode, type SpacePattern, Spec, type StatementAspect, StatementAspects, type StatementNode, type StatementWithSource, type TokenExchangeInput, TokenExchangeInputSchema, type TokenExchangeResponse, TokenExchangeResponseSchema, type ToolContent, type ToolInput, type ToolInputPrimitive, type ToolInputValue, type ToolResult, type ToolUI, type ToolUIComponent, type ToolUIRenderContext, type Triple, type TuiToolUIComponent, type TuiWidgetComponent, type UserConfirmationStatus, UserTypeEnum, VOICE_ASPECTS, type VoiceAspect, type VoiceAspectNode, type WebToolUIComponent, type WebWidgetComponent, type WidgetComponent, type WidgetMeta, type WidgetRenderContext, type WidgetSpec };
+export { APIKeyParams, ActionStatus, ActionStatusEnum, type AddEpisodeParams, type AddEpisodeResult, type AdjacentChunks, type AuthType, type AuthorizationCodeResponse, AuthorizationCodeResponseSchema, COMPACTED_SESSION_NODE_PROPERTIES, ClaudeModels, type CompactedSessionNode, type Config, CoreClient, CoreClientError, type CoreClientOptions, type CreatePatternParams, type DocumentNode, DocumentSchema, ENTITY_NODE_PROPERTIES, EPISODIC_NODE_PROPERTIES, EXPLICIT_PATTERN_TYPES, type EntityNode, type EntityType, EntityTypes, type EpisodeSearchResult, EpisodeType, EpisodeTypeEnum, type EpisodeWithProvenance, type EpisodicNode, type EpisodicNodeWithoutEmbeddings, type ExecuteIntegrationActionInput, ExecuteIntegrationActionInputSchema, type ExecuteIntegrationActionResponse, ExecuteIntegrationActionResponseSchema, type ExplicitPatternType, type ExtractedTripleData, type FrontendExport, GRAPH_ASPECTS, type GatewayAgentInfo, GatewayAgentInfoSchema, GeminiModels, type GetDocumentInput, GetDocumentInputSchema, type GetDocumentResponse, GetDocumentResponseSchema, type GetDocumentsInput, GetDocumentsInputSchema, type GetDocumentsResponse, GetDocumentsResponseSchema, type GetGatewaysResponse, GetGatewaysResponseSchema, type GetIntegrationActionsInput, GetIntegrationActionsInputSchema, type GetIntegrationActionsResponse, GetIntegrationActionsResponseSchema, type GetIntegrationsConnectedResponse, GetIntegrationsConnectedResponseSchema, type GetSkillInput, GetSkillInputSchema, type GetSkillResponse, GetSkillResponseSchema, type GraphAspect, IMPLICIT_PATTERN_TYPES, type Identifier, type ImplicitPatternType, type IngestInput, IngestInputSchema, type IngestResponse, IngestResponseSchema, IntegrationAccountSchema, IntegrationCLI, type IntegrationEventPayload, IntegrationEventType, LLMMappings, LLMModelEnum, LLMModelType, McpAuthParams, type MeResponse, MeResponseSchema, type Message, type MessageType, OAuth2Params, OpenAIModels, PATTERN_TYPES, type Param, type PatternConfirmationParams, type PatternDetectionResult, type PatternType, QUALITY_THRESHOLDS, type QualityFilterResult, type RegisterGatewayRequest, RegisterGatewayRequestSchema, type RegisterGatewayResponse, RegisterGatewayResponseSchema, type RerankConfig, STATEMENT_NODE_PROPERTIES, type SearchInput, SearchInputSchema, type SearchOptions, type SearchResponse, SearchResponseSchema, type SpaceAssignmentResult, type SpaceDeletionResult, type SpaceNode, type SpacePattern, Spec, type StatementAspect, StatementAspects, type StatementNode, type StatementWithSource, type TokenExchangeInput, TokenExchangeInputSchema, type TokenExchangeResponse, TokenExchangeResponseSchema, type ToolContent, type ToolInput, type ToolInputPrimitive, type ToolInputValue, type ToolResult, type ToolUI, type ToolUIComponent, type ToolUIRenderContext, type Triple, type TuiToolUIComponent, type TuiWidgetComponent, type UserConfirmationStatus, UserTypeEnum, VOICE_ASPECTS, type VoiceAspect, type VoiceAspectNode, type WebToolUIComponent, type WebWidgetComponent, type WidgetComponent, type WidgetConfigField, type WidgetMeta, type WidgetRenderContext, type WidgetSpec };

package/dist/index.js

@@ -550,10 +550,17 @@ var GetDocumentInputSchema = zod.z.object({
 var GetDocumentResponseSchema = zod.z.object({
   document: DocumentSchema.nullable()
 });
+var GetSkillInputSchema = zod.z.object({
+  skillId: zod.z.string()
+});
+var GetSkillResponseSchema = zod.z.object({
+  skill: DocumentSchema.nullable()
+});
 var GatewayAgentInfoSchema = zod.z.object({
   id: zod.z.string(),
   name: zod.z.string(),
   description: zod.z.string(),
+  baseUrl: zod.z.string(),
   tools: zod.z.array(zod.z.string()),
   platform: zod.z.string().nullable(),
   hostname: zod.z.string().nullable(),
@@ -562,20 +569,18 @@ var GatewayAgentInfoSchema = zod.z.object({
     "DISCONNECTED"
   ])
 });
-var GetGatewaysResponseSchema = zod.z.object({
-  gateways: zod.z.array(GatewayAgentInfoSchema)
-});
-var ExecuteGatewayInputSchema = zod.z.object({
-  gatewayId: zod.z.string(),
-  intent: zod.z.string()
+var RegisterGatewayRequestSchema = zod.z.object({
+  intent: zod.z.literal("register"),
+  baseUrl: zod.z.string().url(),
+  securityKey: zod.z.string().min(10),
+  name: zod.z.string().min(1).max(64).optional(),
+  description: zod.z.string().max(500).optional()
 });
-var ExecuteGatewayToolInputSchema = zod.z.object({
-  gatewayId: zod.z.string(),
-  toolName: zod.z.string(),
-  params: zod.z.record(zod.z.unknown())
+var RegisterGatewayResponseSchema = zod.z.object({
+  gatewayId: zod.z.string()
 });
-var ExecuteGatewayResponseSchema = zod.z.object({
-  result: zod.z.unknown()
+var GetGatewaysResponseSchema = zod.z.object({
+  gateways: zod.z.array(GatewayAgentInfoSchema)
 });
 var AuthorizationCodeResponseSchema = zod.z.object({
   authorizationCode: zod.z.string(),
@@ -631,10 +636,15 @@ var CoreClient = class {
     if (!response.ok) {
       let errorMessage;
       try {
-        const errorBody = await response.json();
-        errorMessage = errorBody.error || JSON.stringify(errorBody);
+        const rawText = await response.text();
+        try {
+          const errorBody = JSON.parse(rawText);
+          errorMessage = errorBody.error || JSON.stringify(errorBody);
+        } catch {
+          errorMessage = rawText || `HTTP ${response.status}`;
+        }
       } catch {
-        errorMessage = await response.text();
+        errorMessage = `HTTP ${response.status}`;
       }
       throw new CoreClientError(errorMessage, response.status);
     }
@@ -658,10 +668,15 @@ var CoreClient = class {
     if (!response.ok) {
       let errorMessage;
       try {
-        const errorBody = await response.json();
-        errorMessage = errorBody.error || JSON.stringify(errorBody);
+        const rawText = await response.text();
+        try {
+          const errorBody = JSON.parse(rawText);
+          errorMessage = errorBody.error || JSON.stringify(errorBody);
+        } catch {
+          errorMessage = rawText || `HTTP ${response.status}`;
+        }
       } catch {
-        errorMessage = await response.text();
+        errorMessage = `HTTP ${response.status}`;
       }
       throw new CoreClientError(errorMessage, response.status);
     }
@@ -755,6 +770,13 @@ var CoreClient = class {
     return this.request("GET", `/api/v1/documents/${params.documentId}`);
   }
   /**
+  * Get a single skill by ID.
+  * GET /api/v1/skills/:skillId
+  */
+  async getSkill(params) {
+    return this.request("GET", `/api/v1/skills/${params.skillId}`);
+  }
+  /**
   * List all connected gateways for the workspace.
   * GET /api/v1/gateways
   */
@@ -762,26 +784,17 @@ var CoreClient = class {
     return this.request("GET", "/api/v1/gateways");
   }
   /**
-  * Run a gateway sub-agent with an intent and return the final text result.
-  * POST /api/v1/gateways/:gatewayId/execute
-  */
-  async executeGateway(params) {
-    return this.request("POST", `/api/v1/gateways/${params.gatewayId}/execute`, {
-      body: {
-        intent: params.intent
-      }
-    });
-  }
-  /**
-  * Proxy a single tool call to a gateway via server websocket.
-  * POST /api/v1/gateways/:gatewayId/execute  (mode: "tool")
+  * Register a self-hosted gateway with the workspace.
+  * POST /api/v1/gateways  (body: { intent: "register", baseUrl, securityKey, name?, description? })
+  *
+  * The webapp probes the gateway's `/verify` to confirm reachability and
+  * that the supplied key matches its stored hash before persisting.
   */
-  async executeGatewayTool(params) {
-    return this.request("POST", `/api/v1/gateways/${params.gatewayId}/execute`, {
+  async registerGateway(input) {
+    return this.request("POST", "/api/v1/gateways", {
       body: {
-        mode: "tool",
-        toolName: params.toolName,
-        params: params.params
+        intent: "register",
+        ...input
       }
     });
   }
@@ -831,9 +844,6 @@ exports.EPISODIC_NODE_PROPERTIES = EPISODIC_NODE_PROPERTIES;
 exports.EXPLICIT_PATTERN_TYPES = EXPLICIT_PATTERN_TYPES;
 exports.EntityTypes = EntityTypes;
 exports.EpisodeType = EpisodeType;
-exports.ExecuteGatewayInputSchema = ExecuteGatewayInputSchema;
-exports.ExecuteGatewayResponseSchema = ExecuteGatewayResponseSchema;
-exports.ExecuteGatewayToolInputSchema = ExecuteGatewayToolInputSchema;
 exports.ExecuteIntegrationActionInputSchema = ExecuteIntegrationActionInputSchema;
 exports.ExecuteIntegrationActionResponseSchema = ExecuteIntegrationActionResponseSchema;
 exports.GRAPH_ASPECTS = GRAPH_ASPECTS;
@@ -847,6 +857,8 @@ exports.GetGatewaysResponseSchema = GetGatewaysResponseSchema;
 exports.GetIntegrationActionsInputSchema = GetIntegrationActionsInputSchema;
 exports.GetIntegrationActionsResponseSchema = GetIntegrationActionsResponseSchema;
 exports.GetIntegrationsConnectedResponseSchema = GetIntegrationsConnectedResponseSchema;
+exports.GetSkillInputSchema = GetSkillInputSchema;
+exports.GetSkillResponseSchema = GetSkillResponseSchema;
 exports.IMPLICIT_PATTERN_TYPES = IMPLICIT_PATTERN_TYPES;
 exports.IngestInputSchema = IngestInputSchema;
 exports.IngestResponseSchema = IngestResponseSchema;
@@ -858,6 +870,8 @@ exports.OAuth2Params = OAuth2Params;
 exports.OpenAIModels = OpenAIModels;
 exports.PATTERN_TYPES = PATTERN_TYPES;
 exports.QUALITY_THRESHOLDS = QUALITY_THRESHOLDS;
+exports.RegisterGatewayRequestSchema = RegisterGatewayRequestSchema;
+exports.RegisterGatewayResponseSchema = RegisterGatewayResponseSchema;
 exports.STATEMENT_NODE_PROPERTIES = STATEMENT_NODE_PROPERTIES;
 exports.SearchInputSchema = SearchInputSchema;
 exports.SearchResponseSchema = SearchResponseSchema;