@tangle-network/agent-interface 0.9.0 → 0.10.1

package/dist/agent-profile.d.ts

@@ -94,7 +94,7 @@ export interface AgentProfileResources {
  *   - `ultracode` — maximum (claude-code's "ultracode" run mode; codex's `max` reconciles here).
  * A backend without a matching native tier clamps to its nearest (e.g. codex maps `xhigh`/`ultracode` → `high`).
  */
-export type ReasoningEffort = 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'ultracode';
+export type ReasoningEffort = "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "ultracode";
 /**
  * Model selection hints for backends.
  */
@@ -200,6 +200,25 @@ export interface AgentProfileMcpServer {
     enabled?: boolean;
     metadata?: Record<string, unknown>;
 }
+/**
+ * Hub-managed integration grant. The sandbox runtime resolves each declared
+ * connection/capability pair into an MCP tool backed by Tangle Hub policy.
+ */
+export interface AgentProfileConnection {
+    /**
+     * Hub connection id selected by the user, for example a connected Gmail
+     * account.
+     */
+    connectionId: string;
+    /**
+     * Capability paths explicitly granted to the agent.
+     */
+    capabilities: string[];
+    /**
+     * Optional MCP server alias. Must be unique after profile merge.
+     */
+    alias?: string;
+}
 /**
  * Public provider-neutral agent profile contract.
  */
@@ -213,6 +232,7 @@ export interface AgentProfile {
     permissions?: Record<string, AgentProfilePermission>;
     tools?: Record<string, boolean>;
     mcp?: Record<string, AgentProfileMcpServer>;
+    connections?: AgentProfileConnection[];
     subagents?: Record<string, AgentSubagentProfile>;
     resources?: AgentProfileResources;
     hooks?: Record<string, AgentProfileHookCommand[]>;

package/dist/agent-profile.js

@@ -43,6 +43,11 @@ function mergeRecord(base, overlay) {
         ...(overlay ?? {}),
     };
 }
+function mergeOptionalArrays(base, overlay) {
+    if (!base && !overlay)
+        return undefined;
+    return [...(base ?? []), ...(overlay ?? [])];
+}
 /**
  * Merge two public AgentProfile values.
  *
@@ -92,6 +97,7 @@ export function mergeAgentProfiles(base, overlay) {
         permissions: mergeRecord(base?.permissions, overlay?.permissions),
         tools: mergeRecord(base?.tools, overlay?.tools),
         mcp: mergeRecord(base?.mcp, overlay?.mcp),
+        connections: mergeOptionalArrays(base?.connections, overlay?.connections),
         subagents: mergeRecord(base?.subagents, overlay?.subagents),
         resources: mergedResources,
         hooks: mergeRecord(base?.hooks, overlay?.hooks),

package/dist/profile-schema.d.ts

@@ -192,6 +192,11 @@ export declare const agentProfileMcpServerSchema: z.ZodObject<{
     enabled: z.ZodOptional<z.ZodBoolean>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
+export declare const agentProfileConnectionSchema: z.ZodObject<{
+    connectionId: z.ZodString;
+    capabilities: z.ZodArray<z.ZodString>;
+    alias: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 /**
  * The complete provider-neutral agent profile schema — the runtime validator for
  * the canonical {@link AgentProfile} TS contract. Kept structurally in lock-step
@@ -246,6 +251,11 @@ export declare const agentProfileSchema: z.ZodObject<{
         enabled: z.ZodOptional<z.ZodBoolean>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strip>>>;
+    connections: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        connectionId: z.ZodString;
+        capabilities: z.ZodArray<z.ZodString>;
+        alias: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
     subagents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
         prompt: z.ZodOptional<z.ZodString>;

package/dist/profile-schema.js

@@ -1,5 +1,9 @@
 import { z } from "zod";
-export const agentProfilePermissionValueSchema = z.enum(["allow", "deny", "ask"]);
+export const agentProfilePermissionValueSchema = z.enum([
+    "allow",
+    "deny",
+    "ask",
+]);
 export const agentProfilePermissionSchema = z.union([
     agentProfilePermissionValueSchema,
     z.record(z.string(), agentProfilePermissionValueSchema),
@@ -37,7 +41,9 @@ export const agentProfileModelHintsSchema = z.object({
     default: z.string().optional(),
     small: z.string().optional(),
     provider: z.string().optional(),
-    reasoningEffort: z.enum(['none', 'minimal', 'low', 'medium', 'high', 'xhigh', 'ultracode']).optional(),
+    reasoningEffort: z
+        .enum(["none", "minimal", "low", "medium", "high", "xhigh", "ultracode"])
+        .optional(),
     metadata: z.record(z.string(), z.unknown()).optional(),
 });
 export const agentProfilePromptSchema = z.object({
@@ -85,6 +91,11 @@ export const agentProfileMcpServerSchema = z.object({
     enabled: z.boolean().optional(),
     metadata: z.record(z.string(), z.unknown()).optional(),
 });
+export const agentProfileConnectionSchema = z.object({
+    connectionId: z.string().min(1),
+    capabilities: z.array(z.string().min(1)).min(1),
+    alias: z.string().min(1).optional(),
+});
 /**
  * The complete provider-neutral agent profile schema — the runtime validator for
  * the canonical {@link AgentProfile} TS contract. Kept structurally in lock-step
@@ -100,9 +111,12 @@ export const agentProfileSchema = z.object({
     permissions: z.record(z.string(), agentProfilePermissionSchema).optional(),
     tools: z.record(z.string(), z.boolean()).optional(),
     mcp: z.record(z.string(), agentProfileMcpServerSchema).optional(),
+    connections: z.array(agentProfileConnectionSchema).optional(),
     subagents: z.record(z.string(), agentSubagentProfileSchema).optional(),
     resources: agentProfileResourcesSchema.optional(),
-    hooks: z.record(z.string(), z.array(agentProfileHookCommandSchema)).optional(),
+    hooks: z
+        .record(z.string(), z.array(agentProfileHookCommandSchema))
+        .optional(),
     modes: z.record(z.string(), agentProfileModeSchema).optional(),
     confidential: agentProfileConfidentialSchema.optional(),
     metadata: z.record(z.string(), z.unknown()).optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-interface",
-  "version": "0.9.0",
+  "version": "0.10.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",