feat: implement application call api

Author: ikesnowy

src/Cnblogs.DashScope.Core/ApplicationDocReference.cs

@@ -0,0 +1,20 @@
+namespace Cnblogs.DashScope.Core;
+
+/// <summary>
+/// One reference for application output.
+/// </summary>
+/// <param name="IndexId">The index id of the doc.</param>
+/// <param name="Title">Text slice title.</param>
+/// <param name="DocId">Unique id of the doc been referenced.</param>
+/// <param name="DocName">Name of the doc been referenced.</param>
+/// <param name="Text">Referenced content.</param>
+/// <param name="Images">Image URLs beed referenced.</param>
+/// <param name="PageNumber">Page numbers of referenced content belongs to.</param>
+public record ApplicationDocReference(
+    string IndexId,
+    string Title,
+    string DocId,
+    string DocName,
+    string Text,
+    List<string>? Images,
+    List<int>? PageNumber);

src/Cnblogs.DashScope.Core/ApplicationInput.cs

@@ -0,0 +1,48 @@
+namespace Cnblogs.DashScope.Core;
+
+/// <summary>
+/// Inputs for application call.
+/// </summary>
+public class ApplicationInput
+{
+    /// <summary>
+    /// The prompt for model to generate response upon. Optional when <see cref="Messages"/> has been set.
+    /// </summary>
+    /// <remarks>
+    /// Prompt will be appended to <see cref="Messages"/> when both set.
+    /// </remarks>
+    public string? Prompt { get; set; } = null;
+
+    /// <summary>
+    /// The session id for conversation history. This will be ignored if <see cref="Messages"/> has been set.
+    /// </summary>
+    public string? SessionId { get; set; } = null;
+
+    /// <summary>
+    /// The conversation history.
+    /// </summary>
+    public IEnumerable<ApplicationMessage>? Messages { get; set; } = null;
+
+    /// <summary>
+    /// The id of memory when enabled.
+    /// </summary>
+    public string? MemoryId { get; set; } = null;
+
+    /// <summary>
+    /// List of image urls for inputs.
+    /// </summary>
+    public IEnumerable<string>? ImageList { get; set; }
+}
+
+/// <summary>
+/// Inputs for application call.
+/// </summary>
+/// <typeparam name="TBizContent">User defined custom content.</typeparam>
+public class ApplicationInput<TBizContent> : ApplicationInput
+    where TBizContent : class
+{
+    /// <summary>
+    /// User defined content.
+    /// </summary>
+    public TBizContent? Content { get; set; } = null;
+}

src/Cnblogs.DashScope.Core/ApplicationMessage.cs

@@ -0,0 +1,30 @@
+namespace Cnblogs.DashScope.Core;
+
+/// <summary>
+/// A single message for application call.
+/// </summary>
+/// <param name="Role">The role of this message belongs to.</param>
+/// <param name="Content">The content of the message.</param>
+public record ApplicationMessage(string Role, string Content)
+{
+    /// <summary>
+    /// Creates a user message.
+    /// </summary>
+    /// <param name="content">Content of the message.</param>
+    /// <returns></returns>
+    public static ApplicationMessage User(string content) => new("user", content);
+
+    /// <summary>
+    /// Creates a system message.
+    /// </summary>
+    /// <param name="content">Content of the message.</param>
+    /// <returns></returns>
+    public static ApplicationMessage System(string content) => new("system", content);
+
+    /// <summary>
+    /// Creates a assistant message.
+    /// </summary>
+    /// <param name="content">Content of the message.</param>
+    /// <returns></returns>
+    public static ApplicationMessage Assistant(string content) => new("assistant", content);
+}

src/Cnblogs.DashScope.Core/ApplicationModelUsage.cs

@@ -0,0 +1,9 @@
+namespace Cnblogs.DashScope.Core;
+
+/// <summary>
+/// Token usages for one model.
+/// </summary>
+/// <param name="ModelId">The id of the model.</param>
+/// <param name="InputTokens">Total input tokens of this model.</param>
+/// <param name="OutputTokens">Total output tokens from this model.</param>
+public record ApplicationModelUsage(string ModelId, int InputTokens, int OutputTokens);

src/Cnblogs.DashScope.Core/ApplicationOutput.cs

@@ -0,0 +1,16 @@
+namespace Cnblogs.DashScope.Core;
+
+/// <summary>
+/// The output of application call.
+/// </summary>
+/// <param name="Text">Output text from application.</param>
+/// <param name="FinishReason">Finish reason from application.</param>
+/// <param name="SessionId">Unique id of current session.</param>
+/// <param name="Thoughts">Thoughts from application.</param>
+/// <param name="DocReferences">Doc references from application output.</param>
+public record ApplicationOutput(
+    string Text,
+    string FinishReason,
+    string SessionId,
+    List<ApplicationOutputThought>? Thoughts,
+    List<ApplicationDocReference>? DocReferences);

src/Cnblogs.DashScope.Core/ApplicationOutputThought.cs

@@ -0,0 +1,24 @@
+namespace Cnblogs.DashScope.Core;
+
+/// <summary>
+/// The model thought output.
+/// </summary>
+/// <param name="Thought">The thought content of the model.</param>
+/// <param name="ActionType">Type of the action. e.g. <c>agentRag</c>, <c>reasoning</c>.</param>
+/// <param name="ActionName">The name of the action.</param>
+/// <param name="Action">The action been executed.</param>
+/// <param name="ActionInputStream">The streaming result of action input.</param>
+/// <param name="ActionInput">The input of the action.</param>
+/// <param name="Observation">Lookup or plugin output.</param>
+/// <param name="ReasoningContent">Reasoning output when using DeepSeek-R1.</param>
+/// <param name="Arguments">Arguments of the action.</param>
+public record ApplicationOutputThought(
+    string? Thought,
+    string? ActionType,
+    string? ActionName,
+    string? Action,
+    string? ActionInputStream,
+    string? ActionInput,
+    string? Observation,
+    string? ReasoningContent,
+    string? Arguments);

src/Cnblogs.DashScope.Core/ApplicationParameters.cs

@@ -0,0 +1,37 @@
+namespace Cnblogs.DashScope.Core;
+
+/// <summary>
+/// Parameters for application call.
+/// </summary>
+public class ApplicationParameters : IIncrementalOutputParameter, ISeedParameter, IProbabilityParameter
+{
+    /// <inheritdoc />
+    public bool? IncrementalOutput { get; set; }
+
+    /// <summary>
+    /// Output format for flow application. Can be <c>full_thoughts</c> or <c>agent_format</c>. Defaults to <c>full_thoughts</c>.
+    /// </summary>
+    public string? FlowStreamMode { get; set; }
+
+    /// <summary>
+    /// Options for RAG applications.
+    /// </summary>
+    public ApplicationRagOptions? RagOptions { get; set; }
+
+    /// <inheritdoc />
+    public ulong? Seed { get; set; }
+
+    /// <inheritdoc />
+    public float? TopP { get; set; }
+
+    /// <inheritdoc />
+    public int? TopK { get; set; }
+
+    /// <inheritdoc />
+    public float? Temperature { get; set; }
+
+    /// <summary>
+    /// Controls whether output contains think block.
+    /// </summary>
+    public bool? HasThoughts { get; set; }
+}

src/Cnblogs.DashScope.Core/ApplicationRagOptions.cs

@@ -0,0 +1,39 @@
+using System.Text.Json;
+
+namespace Cnblogs.DashScope.Core;
+
+/// <summary>
+/// Options for RAG application.
+/// </summary>
+public class ApplicationRagOptions
+{
+    /// <summary>
+    /// The pipelines to search from.
+    /// </summary>
+    public IEnumerable<string>? PipelineIds { get; set; }
+
+    /// <summary>
+    /// The ids of file to reference from.
+    /// </summary>
+    public IEnumerable<string>? FileIds { get; set; }
+
+    /// <summary>
+    /// Metadata filter for non-structured files.
+    /// </summary>
+    public JsonElement? MetadataFilter { get; set; }
+
+    /// <summary>
+    /// Tag filter for non-structured files.
+    /// </summary>
+    public IEnumerable<string>? Tags { get; set; }
+
+    /// <summary>
+    /// Filter for structured files.
+    /// </summary>
+    public JsonElement? StructuredFilter { get; set; }
+
+    /// <summary>
+    /// File ids for current session.
+    /// </summary>
+    public IEnumerable<string>? SessionFileIds { get; set; }
+}

src/Cnblogs.DashScope.Core/ApplicationRequest.cs

@@ -0,0 +1,17 @@
+namespace Cnblogs.DashScope.Core;
+
+/// <summary>
+/// Request body for an application all.
+/// </summary>
+public class ApplicationRequest
+{
+    /// <summary>
+    /// Content of this call.
+    /// </summary>
+    public required ApplicationInput Input { get; init; }
+
+    /// <summary>
+    /// Optional configurations.
+    /// </summary>
+    public required ApplicationParameters? Parameters { get; init; }
+}

src/Cnblogs.DashScope.Core/ApplicationResponse.cs

@@ -0,0 +1,16 @@
+namespace Cnblogs.DashScope.Core;
+
+/// <summary>
+/// Response of application call.
+/// </summary>
+/// <param name="RequestId">Unique id of this request.</param>
+/// <param name="Code">Error code. Null when request is successful.</param>
+/// <param name="Message">Error message. Null when request is successful.</param>
+/// <param name="Output">The output of application call.</param>
+/// <param name="Usage">Token usage of this application call.</param>
+public record ApplicationResponse(
+    string RequestId,
+    string? Code,
+    string? Message,
+    ApplicationOutput Output,
+    ApplicationUsage Usage);