feat: make agent-version optional, clarify npm/pip pinning behavior

Make agent-version optional for all source types. Update description
to clarify that for npm/pip agents it pins the installed package
version, and is not used for git or object agents.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: jason-rl

action.yml

@@ -21,8 +21,8 @@ inputs:
     required: false
 
   agent-version:
-    description: 'The version of the Agent. Must be a semver string (e.g., "2.0.65") or a SHA.'
-    required: true
+    description: 'For npm/pip agents, pins the installed package version (e.g., "2.0.65"). Not used for git or object agents. Must be a semver string or SHA when provided.'
+    required: false
 
   # Git source inputs
   git-repository:

dist/index.js

@@ -90,7 +90,7 @@ async function deployGitAgent(
   const agent = await client.api.post<unknown, AgentResponse>('/v1/agents', {
     body: {
       name: agentName,
-      version: inputs.agentVersion,
+      ...(inputs.agentVersion && { version: inputs.agentVersion }),
       ...(inputs.isPublic !== undefined && { is_public: inputs.isPublic }),
       source: {
         type: 'git',
@@ -139,7 +139,7 @@ async function deployTarAgent(
   const agent = await client.api.post<unknown, AgentResponse>('/v1/agents', {
     body: {
       name: agentName,
-      version: inputs.agentVersion,
+      ...(inputs.agentVersion && { version: inputs.agentVersion }),
       ...(inputs.isPublic !== undefined && { is_public: inputs.isPublic }),
       source: {
         type: 'object',
@@ -188,7 +188,7 @@ async function deployFileAgent(
   const agent = await client.api.post<unknown, AgentResponse>('/v1/agents', {
     body: {
       name: agentName,
-      version: inputs.agentVersion,
+      ...(inputs.agentVersion && { version: inputs.agentVersion }),
       ...(inputs.isPublic !== undefined && { is_public: inputs.isPublic }),
       source: {
         type: 'object',
@@ -234,7 +234,7 @@ async function deployNpmAgent(
   const agent = await client.api.post<unknown, AgentResponse>('/v1/agents', {
     body: {
       name: agentName,
-      version: inputs.agentVersion,
+      ...(inputs.agentVersion && { version: inputs.agentVersion }),
       ...(inputs.isPublic !== undefined && { is_public: inputs.isPublic }),
       source: {
         type: 'npm',
@@ -276,7 +276,7 @@ async function deployPipAgent(
   const agent = await client.api.post<unknown, AgentResponse>('/v1/agents', {
     body: {
       name: agentName,
-      version: inputs.agentVersion,
+      ...(inputs.agentVersion && { version: inputs.agentVersion }),
       ...(inputs.isPublic !== undefined && { is_public: inputs.isPublic }),
       source: {
         type: 'pip',

dist/index.js.map

@@ -7,7 +7,7 @@ export interface ActionInputs {
   apiKey: string;
   sourceType: SourceType;
   agentName?: string;
-  agentVersion: string;
+  agentVersion?: string;
   gitRepository?: string;
   gitRef?: string;
   path?: string;
@@ -36,7 +36,7 @@ export function getInputs(): ActionInputs {
     apiKey: core.getInput('api-key', { required: true }),
     sourceType,
     agentName: core.getInput('agent-name') || undefined,
-    agentVersion: core.getInput('agent-version', { required: true }),
+    agentVersion: core.getInput('agent-version') || undefined,
     gitRepository: core.getInput('git-repository') || undefined,
     gitRef: core.getInput('git-ref') || undefined,
     path: core.getInput('path') || undefined,
@@ -57,7 +57,7 @@ export function getInputs(): ActionInputs {
 
   // Hidden: if called from runloopai/runloop, set is_public based on "public:" version prefix
   const { owner, repo } = github.context.repo;
-  if (owner === 'runloopai' && repo === 'runloop') {
+  if (owner === 'runloopai' && repo === 'runloop' && inputs.agentVersion) {
     if (inputs.agentVersion.startsWith('public:')) {
       inputs.agentVersion = inputs.agentVersion.slice('public:'.length);
       inputs.isPublic = true;
@@ -132,8 +132,10 @@ export function validateInputs(inputs: ActionInputs): void {
     throw new Error('api-key cannot be empty');
   }
 
-  // Validate agentVersion format (semver or SHA)
-  validateAgentVersion(inputs.agentVersion);
+  // Validate agentVersion format (semver or SHA) if provided
+  if (inputs.agentVersion) {
+    validateAgentVersion(inputs.agentVersion);
+  }
 
   // Validate objectTtlDays if provided
   if (inputs.objectTtlDays !== undefined) {