@tangle-network/agent-interface 0.10.0 → 0.11.0

package/LICENSE

@@ -1,11 +1,21 @@
-Copyright (c) 2025 Tangle Network
+MIT License
 
-All rights reserved.
+Copyright (c) 2026 Tangle Network
 
-This software and associated documentation files (the "Software") are proprietary
-and confidential. No part of this Software may be reproduced, distributed, or
-transmitted in any form or by any means, including photocopying, recording, or
-other electronic or mechanical methods, without the prior written permission of
-Tangle Network.
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
-For licensing inquiries, contact: hello@tangle.tools
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,31 @@
+# @tangle-network/agent-interface
+
+Shared TypeScript types and zod schemas that define the contract between Tangle
+agents, the sidecar, and provider adapters: capabilities, agent profiles,
+message parts, and harness descriptors. This is the canonical home for those
+shapes; higher-level packages import from here rather than redefining them.
+
+The only runtime dependency is `zod` (used for the schema exports).
+
+## Install
+
+```bash
+pnpm add @tangle-network/agent-interface
+```
+
+## Usage
+
+```ts
+import type { BackendCapabilities, ProviderCapabilities } from "@tangle-network/agent-interface";
+
+const caps: ProviderCapabilities = {
+  supportsVision: true,
+  supportsLogprobs: false,
+  supportsToolCalls: true,
+  supportsComputerUse: false,
+};
+```
+
+## License
+
+MIT

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,7 +1,8 @@
 {
   "name": "@tangle-network/agent-interface",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "type": "module",
+  "license": "MIT",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -11,8 +12,19 @@
       "default": "./dist/index.js"
     }
   },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tangle-network/agent-sdk.git",
+    "directory": "packages/agent-interface"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
   "files": [
-    "dist"
+    "dist",
+    "README.md",
+    "LICENSE"
   ],
   "dependencies": {
     "zod": "4.4.3"
@@ -23,6 +35,7 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
+    "check-types": "tsc --noEmit",
     "clean": "rm -rf dist"
   }
 }