agent-def 0.0.2-alpha.1 → 0.1.1

package/README.md

@@ -1,4 +1,12 @@
-# agent-def
+<p align="center">
+<a href="https://artinet.io"><img src="https://img.shields.io/badge/website-artinet.io-black" alt="Website"></a>
+<a href="https://www.npmjs.com/package/agent-def"><img src="https://img.shields.io/npm/v/agent-def?color=black" alt="Version"></a>
+<a href="https://www.npmjs.com/package/agent-def"><img src="https://img.shields.io/npm/dt/agent-def?color=black" alt="Downloads"></a>
+<a><img src="https://img.shields.io/badge/License-Apache_2.0-black.svg" alt="License"></a>
+<a href="https://snyk.io/test/npm/agent-def"><img src="https://snyk.io/test/npm/agent-def/badge.svg" alt="Known Vulnerabilities"></a>
+</p>
+
+<h1 align="center"><em>agent-def</em></h1>
 
 A standardized, portable definition format for collaborative AI agents.
 

package/dist/src/definition.d.ts

@@ -40,16 +40,16 @@ export type Group = z.output<typeof GroupSchema>;
  * id: backend-architect
  * name: Backend System Architect
  * description: Design RESTful APIs and microservice architectures
- * model: openai/gpt-4
+ * modelId: openai/gpt-4
  * version: "1.0.0"
- * toolIds:
- *   - filesystem
- *   - database-analyzer
+ * toolUris:
+ *   - mcp:filesystem
+ *   - mcp:database-analyzer
  * groupIds:
- *   - team:backend
+ *   - us:east:1:team:backend
  *   - project:api-v2
- * agentIds:
- *   - database-specialist
+ * agentUris:
+ *   - agents:example:database-specialist
  *   - security-auditor
  * instructions: |
  *   You are a backend system architect specializing in scalable API design...
@@ -57,7 +57,7 @@ export type Group = z.output<typeof GroupSchema>;
  * ```
  */
 export declare const AgentDefinitionSchema: z.ZodObject<{
-    uri: z.ZodString;
+    uri: z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
     protocolVersion: z.ZodOptional<z.ZodDefault<z.ZodString>>;
     name: z.ZodString;
     description: z.ZodString;
@@ -97,8 +97,8 @@ export declare const AgentDefinitionSchema: z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
         type: z.ZodLiteral<"apiKey">;
         in: z.ZodEnum<{
-            header: "header";
             query: "query";
+            header: "header";
             cookie: "cookie";
         }>;
         name: z.ZodString;
@@ -161,12 +161,10 @@ export declare const AgentDefinitionSchema: z.ZodObject<{
         signature: z.ZodString;
         header: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strip>>>;
+    schemaVersion: z.ZodLiteral<"0.1.0">;
     id: z.ZodOptional<z.ZodString>;
     modelId: z.ZodOptional<z.ZodString>;
-    modelUri: z.ZodOptional<z.ZodString>;
-    toolIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
     toolUris: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    agentIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
     agentUris: z.ZodOptional<z.ZodArray<z.ZodString>>;
     groupIds: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
         id: z.ZodString;
@@ -220,7 +218,7 @@ export type AgentDefinition = z.output<typeof AgentDefinitionSchema>;
  * ```
  */
 export declare const AgentConfigurationSchema: z.ZodObject<{
-    uri: z.ZodString;
+    uri: z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
     protocolVersion: z.ZodOptional<z.ZodDefault<z.ZodString>>;
     name: z.ZodString;
     description: z.ZodString;
@@ -260,8 +258,8 @@ export declare const AgentConfigurationSchema: z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
         type: z.ZodLiteral<"apiKey">;
         in: z.ZodEnum<{
-            header: "header";
             query: "query";
+            header: "header";
             cookie: "cookie";
         }>;
         name: z.ZodString;
@@ -324,12 +322,10 @@ export declare const AgentConfigurationSchema: z.ZodObject<{
         signature: z.ZodString;
         header: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strip>>>;
+    schemaVersion: z.ZodLiteral<"0.1.0">;
     id: z.ZodOptional<z.ZodString>;
     modelId: z.ZodOptional<z.ZodString>;
-    modelUri: z.ZodOptional<z.ZodString>;
-    toolIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
     toolUris: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    agentIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
     agentUris: z.ZodOptional<z.ZodArray<z.ZodString>>;
     groupIds: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
         id: z.ZodString;
@@ -346,7 +342,7 @@ export declare const AgentConfigurationSchema: z.ZodObject<{
         type: z.ZodDefault<z.ZodLiteral<"a2a">>;
         info: z.ZodObject<{
             id: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-            uri: z.ZodString;
+            uri: z.ZodOptional<z.ZodString>;
             protocolVersion: z.ZodDefault<z.ZodString>;
             name: z.ZodString;
             description: z.ZodString;
@@ -386,8 +382,8 @@ export declare const AgentConfigurationSchema: z.ZodObject<{
                 description: z.ZodOptional<z.ZodString>;
                 type: z.ZodLiteral<"apiKey">;
                 in: z.ZodEnum<{
-                    header: "header";
                     query: "query";
+                    header: "header";
                     cookie: "cookie";
                 }>;
                 name: z.ZodString;
@@ -461,7 +457,7 @@ export declare const AgentConfigurationSchema: z.ZodObject<{
         type: z.ZodDefault<z.ZodLiteral<"a2a">>;
         info: z.ZodObject<{
             id: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-            uri: z.ZodString;
+            uri: z.ZodOptional<z.ZodString>;
             protocolVersion: z.ZodDefault<z.ZodString>;
             name: z.ZodString;
             description: z.ZodString;
@@ -501,8 +497,8 @@ export declare const AgentConfigurationSchema: z.ZodObject<{
                 description: z.ZodOptional<z.ZodString>;
                 type: z.ZodLiteral<"apiKey">;
                 in: z.ZodEnum<{
-                    header: "header";
                     query: "query";
+                    header: "header";
                     cookie: "cookie";
                 }>;
                 name: z.ZodString;
@@ -576,7 +572,7 @@ export declare const AgentConfigurationSchema: z.ZodObject<{
         type: z.ZodDefault<z.ZodLiteral<"mcp">>;
         info: z.ZodObject<{
             id: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-            uri: z.ZodString;
+            uri: z.ZodOptional<z.ZodString>;
             implementation: z.ZodObject<{
                 version: z.ZodString;
                 websiteUrl: z.ZodOptional<z.ZodString>;
@@ -715,10 +711,10 @@ export declare const AgentConfigurationSchema: z.ZodObject<{
             command: z.ZodString;
             args: z.ZodArray<z.ZodString>;
         }, z.core.$strip>, z.ZodString, z.ZodUnknown]>>;
-        info: z.ZodObject<{
+        info: z.ZodOptional<z.ZodObject<{
             id: z.ZodOptional<z.ZodOptional<z.ZodOptional<z.ZodString>>>;
-            uri: z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
-            implementation: z.ZodNonOptional<z.ZodOptional<z.ZodObject<{
+            uri: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            implementation: z.ZodOptional<z.ZodObject<{
                 version: z.ZodString;
                 websiteUrl: z.ZodOptional<z.ZodString>;
                 description: z.ZodOptional<z.ZodString>;
@@ -733,7 +729,7 @@ export declare const AgentConfigurationSchema: z.ZodObject<{
                 }, z.core.$strip>>>;
                 name: z.ZodString;
                 title: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>>>;
+            }, z.core.$strip>>;
             serverCapabilities: z.ZodOptional<z.ZodObject<{
                 experimental: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodCustom<object, object>>>;
                 logging: z.ZodOptional<z.ZodCustom<object, object>>;
@@ -843,7 +839,7 @@ export declare const AgentConfigurationSchema: z.ZodObject<{
                 title: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>>;
             instructions: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-        }, z.core.$strip>;
+        }, z.core.$strip>>;
     }, z.core.$strip>]>]>>>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, z.core.$strip>;

package/dist/src/definition.js

@@ -45,16 +45,16 @@ export const GroupSchema = z.object({
  * id: backend-architect
  * name: Backend System Architect
  * description: Design RESTful APIs and microservice architectures
- * model: openai/gpt-4
+ * modelId: openai/gpt-4
  * version: "1.0.0"
- * toolIds:
- *   - filesystem
- *   - database-analyzer
+ * toolUris:
+ *   - mcp:filesystem
+ *   - mcp:database-analyzer
  * groupIds:
- *   - team:backend
+ *   - us:east:1:team:backend
  *   - project:api-v2
- * agentIds:
- *   - database-specialist
+ * agentUris:
+ *   - agents:example:database-specialist
  *   - security-auditor
  * instructions: |
  *   You are a backend system architect specializing in scalable API design...
@@ -67,7 +67,14 @@ export const AgentDefinitionSchema = Runtime.AgentInfoSchema.partial({
     capabilities: true,
     defaultInputModes: true,
     defaultOutputModes: true,
-}).extend({
+})
+    .required({
+    uri: true,
+})
+    .extend({
+    schemaVersion: z
+        .literal("0.1.0")
+        .describe("The schema version of the agent definition"),
     /**
      * Optional agent ID - will be generated if not provided
      *
@@ -84,31 +91,6 @@ export const AgentDefinitionSchema = Runtime.AgentInfoSchema.partial({
      * @example "deepseek-ai/DeepSeek-R1"
      */
     modelId: z.string().optional().describe("Model identifier"),
-    /**
-     * Optional model specification
-     *
-     * Specifies the LLM model to use for this agent.
-     *
-     * @example "openai/gpt-4o-mini"
-     * @example "anthropic/claude-3-opus-20241022"
-     * @example "deepseek-ai/DeepSeek-R1"
-     */
-    modelUri: z.string().optional().describe(`"Model URI"`),
-    /**
-     * Tool IDs that this agent can use
-     *
-     * A flexible list of tool identifiers that reference MCP servers, in-memory
-     * functions, or any other tool providers available in the runtime environment.
-     * Tools are resolved by the agent runtime based on these IDs.
-     *
-     * @example ["filesystem", "web-search", "code-analyzer"]
-     * @example ["mcp-server-git", "mcp-server-postgres", "custom-api-client"]
-     * @deprecated use toolUris instead
-     */
-    toolIds: z
-        .array(z.string())
-        .optional()
-        .describe("List of tool ids that this agent can use"),
     /**
      * Tool IDs that this agent can use
      *
@@ -123,22 +105,6 @@ export const AgentDefinitionSchema = Runtime.AgentInfoSchema.partial({
         .array(z.string())
         .optional()
         .describe("List of tool ids that this agent can use"),
-    /**
-     * Agent IDs that this agent can call
-     *
-     * Explicitly defines which other agents this agent has permission to invoke.
-     * These could be local agent instances, remote agent servers, or any agent
-     * accessible in the runtime environment. This provides explicit access control
-     * separate from group membership.
-     *
-     * @example ["database-specialist", "security-auditor", "code-reviewer"]
-     * @example ["agent://team-lead", "https://agents.example.com/research"]
-     * @deprecated use agentUris instead
-     */
-    agentIds: z
-        .array(z.string())
-        .optional()
-        .describe("The agent ids that this agent can call"),
     /**
      * Agent IDs that this agent can call
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-def",
-  "version": "0.0.2-alpha.1",
+  "version": "0.1.1",
   "description": "A standardized definition for collaborative agents.",
   "main": "dist/src/definition.js",
   "module": "dist/src/definition.js",
@@ -18,7 +18,7 @@
     "generate:schema": "tsx ./scripts/generate-schema.ts",
     "lint": "eslint .",
     "clean": "rimraf dist",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run clean && npm i && npm run generate:schema && npm run build"
   },
   "keywords": [
     "artinet",
@@ -32,12 +32,12 @@
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/the-artinet-project/agent-def.git"
+    "url": "git+https://github.com/the-artinet-project/artinet.git"
   },
   "bugs": {
-    "url": "https://github.com/the-artinet-project/agent-def/issues"
+    "url": "https://github.com/the-artinet-project/artinet/issues"
   },
-  "homepage": "https://github.com/the-artinet-project/agent-def#readme",
+  "homepage": "https://artinet.io",
   "files": [
     "./dist/**/*",
     "./package.json",
@@ -61,8 +61,8 @@
     "zod-to-json-schema": "^3.25.0"
   },
   "dependencies": {
-    "@artinet/sdk": "^0.6.0-preview.2",
-    "@artinet/types": "^0.0.9-alpha.4",
+    "@artinet/sdk": "^0.6.0",
+    "@artinet/types": "^0.0.9",
     "zod": "^3.25"
   }
 }