feat: add code_configuration schema for ZIP upload deployment

agentschema-emitter/lib/model/container.tsp

@@ -23,6 +23,26 @@ alias EnvironmentVariables = Record<EnvironmentVariable> | Named<
 
 alias AgentProtocol = "responses" | "activity" | string;
 
+alias DependencyResolution = "bundled" | "remote_build" | string;
+
+/**
+ * Configuration for code-based (ZIP upload) deployment of a hosted agent.
+ * When present, the agent source code is uploaded directly instead of building a container image.
+ */
+model CodeConfiguration {
+  @doc("Runtime identifier for code execution (e.g., 'python_3_11', 'dotnet_8').")
+  @sample(#{ runtime: "python_3_11" })
+  runtime: string;
+
+  @doc("The entry point file for the agent (e.g., 'main.py' for Python, 'HelloWorld.dll' for .NET).")
+  @sample(#{ entryPoint: "main.py" })
+  entryPoint: string;
+
+  @doc("How package dependencies are resolved at deployment time.")
+  @sample(#{ dependencyResolution: "remote_build" })
+  dependencyResolution?: DependencyResolution;
+}
+
 /*
  * A record mapping for a single protocol and its version.
  */
@@ -81,4 +101,7 @@ model ContainerAgent extends AgentDefinition {
     environmentVariables: #[#{ name: "MY_ENV_VAR", value: "my-value" }],
   })
   environmentVariables?: EnvironmentVariables;
+
+  @doc("Configuration for code-based (ZIP upload) deployment. When present, agent source code is uploaded directly instead of building a container image.")
+  codeConfiguration?: CodeConfiguration;
 }

docs/src/content/docs/reference/AgentDefinition.md

@@ -52,6 +52,7 @@ classDiagram
         +string dockerfilePath
         +ContainerResources resources
         +EnvironmentVariable[] environmentVariables
+        +CodeConfiguration codeConfiguration
     }
     AgentDefinition <|-- ContainerAgent
 ```

docs/src/content/docs/reference/CodeConfiguration.md

@@ -0,0 +1,44 @@
+---
+title: "CodeConfiguration"
+description: "Documentation for the CodeConfiguration type."
+slug: "reference/codeconfiguration"
+---
+
+Configuration for code-based (ZIP upload) deployment of a hosted agent.
+When present, the agent source code is uploaded directly instead of building a container image.
+
+## Class Diagram
+
+```mermaid
+---
+title: CodeConfiguration
+config:
+  look: handDrawn
+  theme: colorful
+  class:
+    hideEmptyMembersBox: true
+---
+classDiagram
+    class CodeConfiguration {
+
+        +string runtime
+        +string entryPoint
+        +string dependencyResolution
+    }
+```
+
+## Yaml Example
+
+```yaml
+runtime: python_3_11
+entryPoint: main.py
+dependencyResolution: remote_build
+```
+
+## Properties
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| runtime | string | Runtime identifier for code execution (e.g., 'python_3_11', 'dotnet_8'). |
+| entryPoint | string | The entry point file for the agent (e.g., 'main.py' for Python, 'HelloWorld.dll' for .NET). |
+| dependencyResolution | string | How package dependencies are resolved at deployment time. |

docs/src/content/docs/reference/ContainerAgent.md

@@ -38,6 +38,7 @@ classDiagram
         +string dockerfilePath
         +ContainerResources resources
         +EnvironmentVariable[] environmentVariables
+        +CodeConfiguration codeConfiguration
     }
     class ProtocolVersionRecord {
         +string protocol
@@ -54,6 +55,12 @@ classDiagram
         +string value
     }
     ContainerAgent *-- EnvironmentVariable
+    class CodeConfiguration {
+        +string runtime
+        +string entryPoint
+        +string dependencyResolution
+    }
+    ContainerAgent *-- CodeConfiguration
 ```
 
 ## Yaml Example
@@ -83,6 +90,7 @@ environmentVariables:
 | dockerfilePath | string | Path to a Dockerfile for deployment. Can be relative to the working directory or an absolute path. |
 | resources | [ContainerResources](../containerresources/) | Resource allocation for the container |
 | environmentVariables | [EnvironmentVariable[]](../environmentvariable/) | Environment variables to set in the container |
+| codeConfiguration | [CodeConfiguration](../codeconfiguration/) | Configuration for code-based (ZIP upload) deployment. When present, agent source code is uploaded directly instead of building a container image. |
 
 ## Composed Types
 
@@ -91,3 +99,4 @@ The following types are composed within `ContainerAgent`:
 - [ProtocolVersionRecord](../protocolversionrecord/)
 - [ContainerResources](../containerresources/)
 - [EnvironmentVariable](../environmentvariable/)
+- [CodeConfiguration](../codeconfiguration/)

docs/src/content/docs/reference/README.md

@@ -244,6 +244,12 @@ classDiagram
         +string name
         +string value
     }
+    class CodeConfiguration {
+
+        +string runtime
+        +string entryPoint
+        +string dependencyResolution
+    }
     class ContainerAgent {
 
         +string kind
@@ -252,6 +258,7 @@ classDiagram
         +string dockerfilePath
         +ContainerResources resources
         +EnvironmentVariable[] environmentVariables
+        +CodeConfiguration codeConfiguration
     }
     class Resource {
       <<abstract>>
@@ -326,6 +333,7 @@ classDiagram
     ContainerAgent *-- ProtocolVersionRecord
     ContainerAgent *-- ContainerResources
     ContainerAgent *-- EnvironmentVariable
+    ContainerAgent *-- CodeConfiguration
     AgentManifest *-- AgentDefinition
     AgentManifest *-- PropertySchema
     AgentManifest *-- Resource

runtime/csharp/AgentSchema.Tests/CodeConfigurationConversionTests.cs

@@ -0,0 +1,133 @@
+
+using Xunit;
+
+#pragma warning disable IDE0130
+namespace AgentSchema;
+#pragma warning restore IDE0130
+
+
+public class CodeConfigurationConversionTests
+{   
+    [Fact]
+    public void LoadYamlInput()
+    {
+        string yamlData = """
+runtime: python_3_11
+entryPoint: main.py
+dependencyResolution: remote_build
+
+""";
+
+        var instance = CodeConfiguration.FromYaml(yamlData);
+
+        Assert.NotNull(instance);
+        Assert.Equal("python_3_11", instance.Runtime);
+        Assert.Equal("main.py", instance.EntryPoint);
+        Assert.Equal("remote_build", instance.DependencyResolution);
+    }
+
+    [Fact]
+    public void LoadJsonInput()
+    {
+        string jsonData = """
+{
+  "runtime": "python_3_11",
+  "entryPoint": "main.py",
+  "dependencyResolution": "remote_build"
+}
+""";
+
+        var instance = CodeConfiguration.FromJson(jsonData);
+        Assert.NotNull(instance);
+        Assert.Equal("python_3_11", instance.Runtime);
+        Assert.Equal("main.py", instance.EntryPoint);
+        Assert.Equal("remote_build", instance.DependencyResolution);
+    }
+
+    [Fact]
+    public void RoundtripJson()
+    {
+        // Test that FromJson -> ToJson -> FromJson produces equivalent data
+        string jsonData = """
+{
+  "runtime": "python_3_11",
+  "entryPoint": "main.py",
+  "dependencyResolution": "remote_build"
+}
+""";
+
+        var original = CodeConfiguration.FromJson(jsonData);
+        Assert.NotNull(original);
+
+        var json = original.ToJson();
+        Assert.False(string.IsNullOrEmpty(json));
+
+        var reloaded = CodeConfiguration.FromJson(json);
+        Assert.NotNull(reloaded);
+        Assert.Equal("python_3_11", reloaded.Runtime);
+        Assert.Equal("main.py", reloaded.EntryPoint);
+        Assert.Equal("remote_build", reloaded.DependencyResolution);
+    }
+
+    [Fact]
+    public void RoundtripYaml()
+    {
+        // Test that FromYaml -> ToYaml -> FromYaml produces equivalent data
+        string yamlData = """
+runtime: python_3_11
+entryPoint: main.py
+dependencyResolution: remote_build
+
+""";
+
+        var original = CodeConfiguration.FromYaml(yamlData);
+        Assert.NotNull(original);
+
+        var yaml = original.ToYaml();
+        Assert.False(string.IsNullOrEmpty(yaml));
+
+        var reloaded = CodeConfiguration.FromYaml(yaml);
+        Assert.NotNull(reloaded);
+        Assert.Equal("python_3_11", reloaded.Runtime);
+        Assert.Equal("main.py", reloaded.EntryPoint);
+        Assert.Equal("remote_build", reloaded.DependencyResolution);
+    }
+
+    [Fact]
+    public void ToJsonProducesValidJson()
+    {
+        string jsonData = """
+{
+  "runtime": "python_3_11",
+  "entryPoint": "main.py",
+  "dependencyResolution": "remote_build"
+}
+""";
+
+        var instance = CodeConfiguration.FromJson(jsonData);
+        var json = instance.ToJson();
+
+        // Verify it's valid JSON by parsing it
+        var parsed = System.Text.Json.JsonDocument.Parse(json);
+        Assert.NotNull(parsed);
+    }
+
+    [Fact]
+    public void ToYamlProducesValidYaml()
+    {
+        string yamlData = """
+runtime: python_3_11
+entryPoint: main.py
+dependencyResolution: remote_build
+
+""";
+
+        var instance = CodeConfiguration.FromYaml(yamlData);
+        var yaml = instance.ToYaml();
+
+        // Verify it's valid YAML by parsing it
+        var deserializer = new YamlDotNet.Serialization.DeserializerBuilder().Build();
+        var parsed = deserializer.Deserialize<object>(yaml);
+        Assert.NotNull(parsed);
+    }
+}