@valon-technologies/gestalt 0.0.1-alpha.17 → 0.0.1-alpha.18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valon-technologies/gestalt",
-  "version": "0.0.1-alpha.17",
+  "version": "0.0.1-alpha.18",
   "description": "TypeScript SDK for Gestalt executable providers",
   "type": "module",
   "repository": {

package/src/agent.ts

@@ -65,7 +65,9 @@ import {
   type ListAgentProviderTurnEventsRequest,
   type ListAgentProviderTurnsRequest,
   type ListedAgentTool,
+  type ResolveAgentConnectionRequest,
   type ResolveAgentProviderInteractionRequest,
+  type ResolvedAgentConnection,
   type ResolvedAgentTool,
   type UpdateAgentProviderSessionRequest,
 } from "./internal/gen/v1/agent_pb.ts";
@@ -114,7 +116,9 @@ export type {
   ListAgentProviderTurnEventsRequest,
   ListAgentProviderTurnsRequest,
   ListedAgentTool,
+  ResolveAgentConnectionRequest,
   ResolveAgentProviderInteractionRequest,
+  ResolvedAgentConnection,
   ResolvedAgentTool,
   UpdateAgentProviderSessionRequest,
 };
@@ -461,6 +465,13 @@ export class AgentHost {
   ): Promise<ListAgentToolsResponse> {
     return await this.client.listTools(request);
   }
+
+  /** Resolves a configured agent connection for the current turn. */
+  async resolveConnection(
+    request: ResolveAgentConnectionRequest,
+  ): Promise<ResolvedAgentConnection> {
+    return await this.client.resolveConnection(request);
+  }
 }
 
 function agentHostTransportOptions(rawTarget: string): {

package/src/api.ts

@@ -26,6 +26,13 @@ export interface Access {
   role: string;
 }
 
+/**
+ * Describes public host metadata available to provider code.
+ */
+export interface Host {
+  publicBaseUrl: string;
+}
+
 /**
  * Request metadata forwarded to provider handlers by the Gestalt runtime.
  */
@@ -35,6 +42,7 @@ export interface Request {
   subject: Subject;
   credential: Credential;
   access: Access;
+  host: Host;
   idempotencyKey: string;
   // Workflow callback metadata uses a JSON-style lowerCamelCase object such as
   // runId, target.plugin.pluginName, trigger.scheduleId, and trigger.event.specVersion.
@@ -106,6 +114,7 @@ export function request(
   workflow: Record<string, unknown> = {},
   invocationToken = "",
   idempotencyKey = "",
+  host: Partial<Host> = {},
 ): Request {
   return {
     token,
@@ -131,6 +140,9 @@ export function request(
     workflow: {
       ...workflow,
     },
+    host: {
+      publicBaseUrl: host.publicBaseUrl ?? "",
+    },
     invocationToken,
     idempotencyKey: idempotencyKey.trim(),
   };

package/src/authorization.ts

@@ -80,7 +80,8 @@ export class AuthorizationClient {
       ...(transportOptions.nodeOptions
         ? {
             nodeOptions: {
-              createConnection: () => connect(transportOptions.nodeOptions!.path),
+              createConnection: () =>
+                connect({ path: transportOptions.nodeOptions!.path }),
             },
           }
         : {}),

package/src/cache.ts

@@ -139,7 +139,8 @@ export class Cache {
       ...(transportOptions.nodeOptions
         ? {
             nodeOptions: {
-              createConnection: () => connect(transportOptions.nodeOptions!.path),
+              createConnection: () =>
+                connect({ path: transportOptions.nodeOptions!.path }),
             },
           }
         : {}),

package/src/http-subject.ts

@@ -1,4 +1,4 @@
-import type { Access, Credential, MaybePromise, Subject } from "./api.ts";
+import type { Access, Credential, Host, MaybePromise, Subject } from "./api.ts";
 
 /**
  * Verified hosted HTTP request metadata passed into optional plugin-local
@@ -26,6 +26,7 @@ export interface HTTPSubjectResolutionContext {
   subject: Subject;
   credential: Credential;
   access: Access;
+  host: Host;
   workflow: Record<string, unknown>;
 }
 
@@ -96,6 +97,9 @@ export function cloneHTTPSubjectResolutionContext(
     access: {
       ...input.access,
     },
+    host: {
+      ...input.host,
+    },
     workflow: {
       ...input.workflow,
     },

package/src/index.ts

@@ -52,6 +52,7 @@ export {
   responseBrand,
   request,
   type Access,
+  type Host,
   type MaybePromise,
   type Credential,
   type OperationResult,
@@ -363,7 +364,9 @@ export {
   type ListAgentProviderTurnEventsRequest,
   type ListAgentProviderTurnsRequest,
   type ListedAgentTool,
+  type ResolveAgentConnectionRequest,
   type ResolveAgentProviderInteractionRequest,
+  type ResolvedAgentConnection,
   type ResolvedAgentTool,
   type UpdateAgentProviderSessionRequest,
 } from "./agent.ts";

package/src/indexeddb.ts

@@ -536,7 +536,8 @@ export class IndexedDB {
       ...(transportOptions.nodeOptions
         ? {
             nodeOptions: {
-              createConnection: () => connect(transportOptions.nodeOptions!.path),
+              createConnection: () =>
+                connect({ path: transportOptions.nodeOptions!.path }),
             },
           }
         : {}),