feat: make agent-version optional, clarify npm/pip pinning behavior (#13)

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,16 +21,16 @@ 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.1.123"). Not used for git or object agents.'
+    required: false
 
   # Git source inputs
   git-repository:
     description: 'Git repository URL (optional override, defaults to current repository)'
     required: false
 
   git-ref:
-    description: 'Git ref (branch/tag/commit SHA). Defaults to current commit or release tag'
+    description: 'Git ref (branch or tag). Defaults to current ref or release tag'
     required: false
 
   # NPM source inputs

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,9 +132,6 @@ export function validateInputs(inputs: ActionInputs): void {
     throw new Error('api-key cannot be empty');
   }
 
-  // Validate agentVersion format (semver or SHA)
-  validateAgentVersion(inputs.agentVersion);
-
   // Validate objectTtlDays if provided
   if (inputs.objectTtlDays !== undefined) {
     if (isNaN(inputs.objectTtlDays) || inputs.objectTtlDays <= 0) {
@@ -170,23 +167,3 @@ export function resolvePath(inputPath: string): string {
 
   return path.isAbsolute(inputPath) ? inputPath : path.join(workspace, inputPath);
 }
-
-// Semver pattern: major.minor.patch with optional pre-release and build metadata
-const SEMVER_REGEX = /^\d+\.\d+\.\d+(-[\w.-]+)?(\+[\w.-]+)?$/;
-
-// Git SHA pattern: 7-40 hex characters (short or full SHA)
-const SHA_REGEX = /^[a-f0-9]{7,40}$/i;
-
-function validateAgentVersion(version: string): void {
-  if (!version || version.trim().length === 0) {
-    throw new Error('agent-version cannot be empty');
-  }
-
-  const trimmed = version.trim();
-
-  if (!SEMVER_REGEX.test(trimmed) && !SHA_REGEX.test(trimmed)) {
-    throw new Error(
-      `Invalid agent-version: "${version}". Must be a semver string (e.g., "2.0.65") or a git SHA (7-40 hex characters).`
-    );
-  }
-}