@azure-tools/typespec-azure-resource-manager 0.69.0 → 0.69.1

package/dist/src/rules/arm-agent-base-type-child-resources.js

@@ -0,0 +1,94 @@
+import { createRule, getNamespaceFullName, paramMessage } from "@typespec/compiler";
+import { getParentResource } from "@typespec/rest";
+import { getAzureBaseTypes } from "../base-types.js";
+import { getArmResources } from "../resource.js";
+export const armAgentBaseTypeChildResourcesRule = createRule({
+    name: "arm-agent-base-type-child-resources",
+    severity: "warning",
+    description: "Resources decorated with @azureBaseType for the Agent base type must have both a Conversation and a Response child resource.",
+    url: "https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-agent-base-type-child-resources",
+    messages: {
+        default: paramMessage `Agent resources must have both a Conversation and a Response child resource. Missing: ${"missing"}.`,
+    },
+    create(context) {
+        return {
+            root: (program) => {
+                const resources = getArmResources(program);
+                // Identify agent resources
+                const agentResources = resources.filter((r) => hasAgentBaseType(r.typespecType));
+                for (const agentResource of agentResources) {
+                    // Find child resources whose @parentResource points to this agent
+                    const children = resources.filter((r) => {
+                        const parent = getParentResource(context.program, r.typespecType);
+                        return parent === agentResource.typespecType;
+                    });
+                    let hasConversation = false;
+                    let hasResponse = false;
+                    for (const child of children) {
+                        const childProps = child.typespecType.properties.get("properties");
+                        if (childProps?.type.kind === "Model") {
+                            if (isConversationProperties(childProps.type)) {
+                                hasConversation = true;
+                            }
+                            if (isResponseProperties(childProps.type)) {
+                                hasResponse = true;
+                            }
+                        }
+                    }
+                    const missing = [];
+                    if (!hasConversation)
+                        missing.push("Conversation");
+                    if (!hasResponse)
+                        missing.push("Response");
+                    if (missing.length > 0) {
+                        context.reportDiagnostic({
+                            format: { missing: missing.join(", ") },
+                            target: agentResource.typespecType,
+                        });
+                    }
+                }
+            },
+        };
+        function hasAgentBaseType(model) {
+            const directTypes = getAzureBaseTypes(context.program, model);
+            if (directTypes && isAgent(directTypes))
+                return true;
+            if (model.sourceModels) {
+                for (const source of model.sourceModels) {
+                    const sourceTypes = getAzureBaseTypes(context.program, source.model);
+                    if (sourceTypes && isAgent(sourceTypes))
+                        return true;
+                }
+            }
+            return false;
+        }
+        function isAgent(types) {
+            return types.some((bt) => bt.baseType === "Agent");
+        }
+        function isConversationProperties(model) {
+            return checkModelName(model, "ConversationProperties");
+        }
+        function isResponseProperties(model) {
+            return checkModelName(model, "ResponseProperties");
+        }
+        function checkModelName(model, name) {
+            if (model.name === name) {
+                const ns = model.namespace ? getNamespaceFullName(model.namespace) : "";
+                if (ns === "Azure.ResourceManager.BaseTypes.Agents")
+                    return true;
+            }
+            if (model.baseModel) {
+                if (checkModelName(model.baseModel, name))
+                    return true;
+            }
+            if (model.sourceModels) {
+                for (const source of model.sourceModels) {
+                    if (checkModelName(source.model, name))
+                        return true;
+                }
+            }
+            return false;
+        }
+    },
+});
+//# sourceMappingURL=arm-agent-base-type-child-resources.js.map

package/dist/src/rules/arm-agent-base-type-child-resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arm-agent-base-type-child-resources.js","sourceRoot":"","sources":["../../../src/rules/arm-agent-base-type-child-resources.ts"],"names":[],"mappings":"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"}

package/dist/src/rules/arm-agent-base-type-lifecycle-operations.d.ts

@@ -0,0 +1,4 @@
+export declare const armAgentBaseTypeLifecycleOperationsRule: import("@typespec/compiler").LinterRuleDefinition<"arm-agent-base-type-lifecycle-operations", {
+    readonly default: import("@typespec/compiler").CallableMessage<["resourceName", "missing"]>;
+}, Record<string, never>>;
+//# sourceMappingURL=arm-agent-base-type-lifecycle-operations.d.ts.map

package/dist/src/rules/arm-agent-base-type-lifecycle-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arm-agent-base-type-lifecycle-operations.d.ts","sourceRoot":"","sources":["../../../src/rules/arm-agent-base-type-lifecycle-operations.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,uCAAuC;;yBAiGlD,CAAC"}

package/dist/src/rules/arm-agent-base-type-lifecycle-operations.js

@@ -0,0 +1,99 @@
+import { createRule, getNamespaceFullName, paramMessage } from "@typespec/compiler";
+import { getParentResource } from "@typespec/rest";
+import { getAzureBaseTypes } from "../base-types.js";
+import { getArmResources } from "../resource.js";
+export const armAgentBaseTypeLifecycleOperationsRule = createRule({
+    name: "arm-agent-base-type-lifecycle-operations",
+    severity: "warning",
+    description: "Conversation and Response child resources of an Agent must define create, read, update, and delete lifecycle operations.",
+    url: "https://azure.github.io/typespec-azure/docs/libraries/azure-resource-manager/rules/arm-agent-base-type-lifecycle-operations",
+    messages: {
+        default: paramMessage `Resource "${"resourceName"}" is missing required lifecycle operations: ${"missing"}.`,
+    },
+    create(context) {
+        return {
+            root: (program) => {
+                const resources = getArmResources(program);
+                // Identify agent resources
+                const agentResources = resources.filter((r) => hasAgentBaseType(r.typespecType));
+                for (const agentResource of agentResources) {
+                    // Find child resources whose @parentResource points to this agent
+                    const children = resources.filter((r) => {
+                        const parent = getParentResource(context.program, r.typespecType);
+                        return parent === agentResource.typespecType;
+                    });
+                    for (const child of children) {
+                        const childProps = child.typespecType.properties.get("properties");
+                        if (childProps?.type.kind !== "Model")
+                            continue;
+                        const isConversation = isConversationProperties(childProps.type);
+                        const isResponse = isResponseProperties(childProps.type);
+                        if (!isConversation && !isResponse)
+                            continue;
+                        // Check lifecycle operations
+                        const lifecycle = child.operations.lifecycle;
+                        const missing = [];
+                        if (!lifecycle.createOrUpdate)
+                            missing.push("create");
+                        if (!lifecycle.read)
+                            missing.push("read");
+                        if (!lifecycle.update)
+                            missing.push("update");
+                        if (!lifecycle.delete)
+                            missing.push("delete");
+                        if (missing.length > 0) {
+                            context.reportDiagnostic({
+                                format: {
+                                    resourceName: child.typespecType.name,
+                                    missing: missing.join(", "),
+                                },
+                                target: child.typespecType,
+                            });
+                        }
+                    }
+                }
+            },
+        };
+        function hasAgentBaseType(model) {
+            const directTypes = getAzureBaseTypes(context.program, model);
+            if (directTypes && isAgent(directTypes))
+                return true;
+            if (model.sourceModels) {
+                for (const source of model.sourceModels) {
+                    const sourceTypes = getAzureBaseTypes(context.program, source.model);
+                    if (sourceTypes && isAgent(sourceTypes))
+                        return true;
+                }
+            }
+            return false;
+        }
+        function isAgent(types) {
+            return types.some((bt) => bt.baseType === "Agent");
+        }
+        function isConversationProperties(model) {
+            return checkModelName(model, "ConversationProperties");
+        }
+        function isResponseProperties(model) {
+            return checkModelName(model, "ResponseProperties");
+        }
+        function checkModelName(model, name) {
+            if (model.name === name) {
+                const ns = model.namespace ? getNamespaceFullName(model.namespace) : "";
+                if (ns === "Azure.ResourceManager.BaseTypes.Agents")
+                    return true;
+            }
+            if (model.baseModel) {
+                if (checkModelName(model.baseModel, name))
+                    return true;
+            }
+            if (model.sourceModels) {
+                for (const source of model.sourceModels) {
+                    if (checkModelName(source.model, name))
+                        return true;
+                }
+            }
+            return false;
+        }
+    },
+});
+//# sourceMappingURL=arm-agent-base-type-lifecycle-operations.js.map

package/dist/src/rules/arm-agent-base-type-lifecycle-operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arm-agent-base-type-lifecycle-operations.js","sourceRoot":"","sources":["../../../src/rules/arm-agent-base-type-lifecycle-operations.ts"],"names":[],"mappings":"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"}

package/dist/src/state.d.ts

@@ -30,5 +30,6 @@ export declare const ArmStateKeys: {
     armExternalType: symbol;
     inlineAzureType: symbol;
     genericResource: symbol;
+    azureBaseTypes: symbol;
 };
 //# sourceMappingURL=state.d.ts.map

package/dist/src/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/state.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCxB,CAAC"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/state.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCxB,CAAC"}

package/dist/src/state.js

@@ -39,5 +39,7 @@ export const ArmStateKeys = {
     armExternalType: azureResourceManagerCreateStateSymbol("armExternalType"),
     inlineAzureType: azureResourceManagerCreateStateSymbol("inlineAzureType"),
     genericResource: azureResourceManagerCreateStateSymbol("genericResource"),
+    // base-types.ts
+    azureBaseTypes: azureResourceManagerCreateStateSymbol("azureBaseTypes"),
 };
 //# sourceMappingURL=state.js.map

package/dist/src/state.js.map

@@ -1 +1 @@
-{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/state.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,qBAAqB;AACrB,2DAA2D;AAC3D,SAAS,qCAAqC,CAAC,IAAY;IACzD,OAAO,MAAM,CAAC,GAAG,CAAC,gDAAgD,IAAI,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,gBAAgB,EAAE,qCAAqC,CAAC,kBAAkB,CAAC;IAC3E,qBAAqB,EAAE,qCAAqC,CAAC,uBAAuB,CAAC;IACrF,qBAAqB,EAAE,qCAAqC,CAAC,uBAAuB,CAAC;IACrF,2BAA2B,EAAE,qCAAqC,CAAC,6BAA6B,CAAC;IACjG,qBAAqB,EAAE,qCAAqC,CAAC,oBAAoB,CAAC;IAClF,YAAY,EAAE,qCAAqC,CAAC,cAAc,CAAC;IACnE,oBAAoB,EAAE,qCAAqC,CAAC,sBAAsB,CAAC;IACnF,wBAAwB,EAAE,qCAAqC,CAAC,0BAA0B,CAAC;IAC3F,qBAAqB,EAAE,qCAAqC,CAAC,uBAAuB,CAAC;IACrF,cAAc,EAAE,qCAAqC,CAAC,gBAAgB,CAAC;IACvE,eAAe,EAAE,qCAAqC,CAAC,iBAAiB,CAAC;IACzE,wBAAwB,EAAE,qCAAqC,CAAC,0BAA0B,CAAC;IAC3F,qBAAqB,EAAE,qCAAqC,CAAC,uBAAuB,CAAC;IAErF,cAAc;IACd,oBAAoB,EAAE,qCAAqC,CAAC,sBAAsB,CAAC;IACnF,kBAAkB,EAAE,qCAAqC,CAAC,oBAAoB,CAAC;IAC/E,qBAAqB,EAAE,qCAAqC,CAAC,uBAAuB,CAAC;IACrF,gBAAgB,EAAE,qCAAqC,CAAC,qBAAqB,CAAC;IAC9E,kBAAkB,EAAE,qCAAqC,CAAC,qBAAqB,CAAC;IAChF,mBAAmB,EAAE,qCAAqC,CAAC,qBAAqB,CAAC;IACjF,UAAU,EAAE,qCAAqC,CAAC,YAAY,CAAC;IAC/D,aAAa,EAAE,qCAAqC,CAAC,eAAe,CAAC;IACrE,iBAAiB,EAAE,qCAAqC,CAAC,mBAAmB,CAAC;IAE7E,uBAAuB;IACvB,iBAAiB,EAAE,qCAAqC,CAAC,mBAAmB,CAAC;IAC7E,oBAAoB,EAAE,qCAAqC,CAAC,sBAAsB,CAAC;IAEnF,oCAAoC;IACpC,oBAAoB,EAAE,qCAAqC,CAAC,sBAAsB,CAAC;IACnF,mBAAmB,EAAE,qCAAqC,CAAC,qBAAqB,CAAC;IACjF,sBAAsB,EAAE,qCAAqC,CAAC,wBAAwB,CAAC;IACvF,gBAAgB,EAAE,qCAAqC,CAAC,kBAAkB,CAAC;IAC3E,eAAe,EAAE,qCAAqC,CAAC,iBAAiB,CAAC;IACzE,eAAe,EAAE,qCAAqC,CAAC,iBAAiB,CAAC;IACzE,eAAe,EAAE,qCAAqC,CAAC,iBAAiB,CAAC;CAC1E,CAAC"}
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/state.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,qBAAqB;AACrB,2DAA2D;AAC3D,SAAS,qCAAqC,CAAC,IAAY;IACzD,OAAO,MAAM,CAAC,GAAG,CAAC,gDAAgD,IAAI,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,gBAAgB,EAAE,qCAAqC,CAAC,kBAAkB,CAAC;IAC3E,qBAAqB,EAAE,qCAAqC,CAAC,uBAAuB,CAAC;IACrF,qBAAqB,EAAE,qCAAqC,CAAC,uBAAuB,CAAC;IACrF,2BAA2B,EAAE,qCAAqC,CAAC,6BAA6B,CAAC;IACjG,qBAAqB,EAAE,qCAAqC,CAAC,oBAAoB,CAAC;IAClF,YAAY,EAAE,qCAAqC,CAAC,cAAc,CAAC;IACnE,oBAAoB,EAAE,qCAAqC,CAAC,sBAAsB,CAAC;IACnF,wBAAwB,EAAE,qCAAqC,CAAC,0BAA0B,CAAC;IAC3F,qBAAqB,EAAE,qCAAqC,CAAC,uBAAuB,CAAC;IACrF,cAAc,EAAE,qCAAqC,CAAC,gBAAgB,CAAC;IACvE,eAAe,EAAE,qCAAqC,CAAC,iBAAiB,CAAC;IACzE,wBAAwB,EAAE,qCAAqC,CAAC,0BAA0B,CAAC;IAC3F,qBAAqB,EAAE,qCAAqC,CAAC,uBAAuB,CAAC;IAErF,cAAc;IACd,oBAAoB,EAAE,qCAAqC,CAAC,sBAAsB,CAAC;IACnF,kBAAkB,EAAE,qCAAqC,CAAC,oBAAoB,CAAC;IAC/E,qBAAqB,EAAE,qCAAqC,CAAC,uBAAuB,CAAC;IACrF,gBAAgB,EAAE,qCAAqC,CAAC,qBAAqB,CAAC;IAC9E,kBAAkB,EAAE,qCAAqC,CAAC,qBAAqB,CAAC;IAChF,mBAAmB,EAAE,qCAAqC,CAAC,qBAAqB,CAAC;IACjF,UAAU,EAAE,qCAAqC,CAAC,YAAY,CAAC;IAC/D,aAAa,EAAE,qCAAqC,CAAC,eAAe,CAAC;IACrE,iBAAiB,EAAE,qCAAqC,CAAC,mBAAmB,CAAC;IAE7E,uBAAuB;IACvB,iBAAiB,EAAE,qCAAqC,CAAC,mBAAmB,CAAC;IAC7E,oBAAoB,EAAE,qCAAqC,CAAC,sBAAsB,CAAC;IAEnF,oCAAoC;IACpC,oBAAoB,EAAE,qCAAqC,CAAC,sBAAsB,CAAC;IACnF,mBAAmB,EAAE,qCAAqC,CAAC,qBAAqB,CAAC;IACjF,sBAAsB,EAAE,qCAAqC,CAAC,wBAAwB,CAAC;IACvF,gBAAgB,EAAE,qCAAqC,CAAC,kBAAkB,CAAC;IAC3E,eAAe,EAAE,qCAAqC,CAAC,iBAAiB,CAAC;IACzE,eAAe,EAAE,qCAAqC,CAAC,iBAAiB,CAAC;IACzE,eAAe,EAAE,qCAAqC,CAAC,iBAAiB,CAAC;IAEzE,gBAAgB;IAChB,cAAc,EAAE,qCAAqC,CAAC,gBAAgB,CAAC;CACxE,CAAC"}

package/dist/src/tsp-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tsp-index.d.ts","sourceRoot":"","sources":["../../src/tsp-index.ts"],"names":[],"mappings":"AAmCA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"tsp-index.d.ts","sourceRoot":"","sources":["../../src/tsp-index.ts"],"names":[],"mappings":"AAqCA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC"}

package/dist/src/tsp-index.js

@@ -1,3 +1,4 @@
+import { $azureBaseType } from "./base-types.js";
 import { $armCommonTypesVersion, $externalTypeRef } from "./common-types.js";
 import { $armLibraryNamespace, $armProviderNamespace, $useLibraryNamespace } from "./namespace.js";
 import { $armOperationRoute, $armResourceAction, $armResourceCheckExistence, $armResourceCollectionAction, $armResourceCreateOrUpdate, $armResourceDelete, $armResourceList, $armResourceRead, $armResourceUpdate, $renamePathParameter, } from "./operations.js";
@@ -30,6 +31,9 @@ export const $decorators = {
         resourceBaseType: $resourceBaseType,
         identifiers: $identifiers,
     },
+    "Azure.ResourceManager.BaseTypes": {
+        azureBaseType: $azureBaseType,
+    },
     "Azure.ResourceManager.Legacy": {
         customAzureResource: $customAzureResource,
         externalTypeRef: $externalTypeRef,

package/dist/src/tsp-index.js.map

@@ -1 +1 @@
-{"version":3,"file":"tsp-index.js","sourceRoot":"","sources":["../../src/tsp-index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACnG,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,QAAQ,EACR,eAAe,EACf,SAAS,EACT,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,UAAU,EACV,qBAAqB,EACrB,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,gBAAgB;AAChB,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,uBAAuB,EAAE;QACvB,2BAA2B,EAAE,4BAA4B;QACzD,oBAAoB,EAAE,qBAAqB;QAC3C,oBAAoB,EAAE,qBAAqB;QAC3C,mBAAmB,EAAE,oBAAoB;QACzC,mBAAmB,EAAE,oBAAoB;QACzC,SAAS,EAAE,UAAU;QACrB,cAAc,EAAE,eAAe;QAC/B,oBAAoB,EAAE,qBAAqB;QAC3C,gBAAgB,EAAE,iBAAiB;QACnC,qBAAqB,EAAE,sBAAsB;QAC7C,iBAAiB,EAAE,kBAAkB;QACrC,iBAAiB,EAAE,kBAAkB;QACrC,yBAAyB,EAAE,0BAA0B;QACrD,eAAe,EAAE,gBAAgB;QACjC,iBAAiB,EAAE,kBAAkB;QACrC,iBAAiB,EAAE,kBAAkB;QACrC,eAAe,EAAE,gBAAgB;QACjC,yBAAyB,EAAE,0BAA0B;QACrD,qBAAqB,EAAE,sBAAsB;QAC7C,qBAAqB,EAAE,sBAAsB;QAC7C,kBAAkB,EAAE,mBAAmB;QACvC,gBAAgB,EAAE,iBAAiB;QACnC,WAAW,EAAE,YAAY;KACe;IAC1C,8BAA8B,EAAE;QAC9B,mBAAmB,EAAE,oBAAoB;QACzC,eAAe,EAAE,gBAAgB;QACjC,iBAAiB,EAAE,kBAAkB;QACrC,eAAe,EAAE,gBAAgB;QACjC,mBAAmB,EAAE,oBAAoB;QACzC,OAAO,EAAE,QAAQ;QACjB,QAAQ,EAAE,SAAS;QACnB,cAAc,EAAE,eAAe;KACe;CACjD,CAAC"}
+{"version":3,"file":"tsp-index.js","sourceRoot":"","sources":["../../src/tsp-index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACnG,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,QAAQ,EACR,eAAe,EACf,SAAS,EACT,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,UAAU,EACV,qBAAqB,EACrB,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,gBAAgB;AAChB,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,uBAAuB,EAAE;QACvB,2BAA2B,EAAE,4BAA4B;QACzD,oBAAoB,EAAE,qBAAqB;QAC3C,oBAAoB,EAAE,qBAAqB;QAC3C,mBAAmB,EAAE,oBAAoB;QACzC,mBAAmB,EAAE,oBAAoB;QACzC,SAAS,EAAE,UAAU;QACrB,cAAc,EAAE,eAAe;QAC/B,oBAAoB,EAAE,qBAAqB;QAC3C,gBAAgB,EAAE,iBAAiB;QACnC,qBAAqB,EAAE,sBAAsB;QAC7C,iBAAiB,EAAE,kBAAkB;QACrC,iBAAiB,EAAE,kBAAkB;QACrC,yBAAyB,EAAE,0BAA0B;QACrD,eAAe,EAAE,gBAAgB;QACjC,iBAAiB,EAAE,kBAAkB;QACrC,iBAAiB,EAAE,kBAAkB;QACrC,eAAe,EAAE,gBAAgB;QACjC,yBAAyB,EAAE,0BAA0B;QACrD,qBAAqB,EAAE,sBAAsB;QAC7C,qBAAqB,EAAE,sBAAsB;QAC7C,kBAAkB,EAAE,mBAAmB;QACvC,gBAAgB,EAAE,iBAAiB;QACnC,WAAW,EAAE,YAAY;KACe;IAC1C,iCAAiC,EAAE;QACjC,aAAa,EAAE,cAAc;KACoB;IACnD,8BAA8B,EAAE;QAC9B,mBAAmB,EAAE,oBAAoB;QACzC,eAAe,EAAE,gBAAgB;QACjC,iBAAiB,EAAE,kBAAkB;QACrC,eAAe,EAAE,gBAAgB;QACjC,mBAAmB,EAAE,oBAAoB;QACzC,OAAO,EAAE,QAAQ;QACjB,QAAQ,EAAE,SAAS;QACnB,cAAc,EAAE,eAAe;KACe;CACjD,CAAC"}

package/lib/arm.tsp

@@ -12,6 +12,8 @@ import "./legacy-types/arm.legacy.tsp";
 import "./common-types/common-types.tsp";
 import "./extension/extension.tsp";
 import "./backcompat.tsp";
+import "./base-types/base-types.tsp";
+import "./base-types/agent.tsp";
 import "./private.decorators.tsp";
 import "./models.tsp";
 import "./operations.tsp";

package/lib/base-types/agent.tsp

@@ -0,0 +1,351 @@
+import "./base-types.tsp";
+
+using Azure.ResourceManager;
+using Azure.ResourceManager.BaseTypes;
+using Azure.ResourceManager.Private;
+using TypeSpec.Rest;
+
+namespace Azure.ResourceManager.BaseTypes.Agents;
+
+// ============================================================================
+// Agent Tool Types
+// ============================================================================
+
+/**
+ * A tool binding for an agent (Appliance deployment model).
+ * All properties are read-only (the appliance owns and reports state).
+ */
+model AgentToolTypeAppliance {
+  /** Tool type discriminator. Must be one of the publicly documented Azure AI Foundry tool types. */
+  @visibility(Lifecycle.Read)
+  type: string;
+
+  /** Tool name/identifier. */
+  @visibility(Lifecycle.Read)
+  name: string;
+}
+
+/**
+ * A tool binding for an agent (Platform deployment model).
+ * All properties have default visibility (the client owns these fields).
+ */
+model AgentToolTypePlatform {
+  /** Tool type discriminator. Must be one of the publicly documented Azure AI Foundry tool types. */
+  type: string;
+
+  /** Tool name/identifier. */
+  name: string;
+}
+
+// ============================================================================
+// Agent Definition
+// ============================================================================
+
+/**
+ * Inline agent definition describing the model and behavior of the agent.
+ * This model is used only as a constraint for template parameters.
+ */
+internal model AgentDefinition {
+  /** Model identifier (RP-defined). */
+  `model`: string;
+
+  /** System prompt / behavioral instructions for the agent. */
+  instructions: string;
+}
+
+/**
+ * Appliance deployment model of AgentDefinition.
+ * Properties controlled by `@baseTypeOptional` are invisible when the corresponding
+ * template parameter is false, or read-only when present.
+ * @template HasModelDeploymentRef Whether the modelDeploymentRef property is present.
+ * @template HasInstructions Whether the instructions property is present.
+ */
+model AgentDefinitionAppliance<
+  HasModelDeploymentRef extends valueof boolean = false,
+  HasInstructions extends valueof boolean = false
+> {
+  /** Model identifier (RP-defined). */
+  @visibility(Lifecycle.Read)
+  `model`: string;
+
+  /** System prompt / behavioral instructions for the agent. */
+  @baseTypeOptional(HasInstructions, true)
+  instructions: string;
+
+  /** Optional RP-specific reference to an underlying model deployment. */
+  @baseTypeOptional(HasModelDeploymentRef, true)
+  modelDeploymentRef?: string;
+}
+
+/**
+ * Platform deployment model of AgentDefinition.
+ * Properties controlled by `@baseTypeOptional` are invisible when the corresponding
+ * template parameter is false, or have default visibility when present.
+ * @template HasModelDeploymentRef Whether the modelDeploymentRef property is present.
+ * @template HasInstructions Whether the instructions property is present.
+ */
+model AgentDefinitionPlatform<
+  HasModelDeploymentRef extends valueof boolean = false,
+  HasInstructions extends valueof boolean = false
+> {
+  /** Model identifier (RP-defined). */
+  `model`: string;
+
+  /** System prompt / behavioral instructions for the agent. */
+  @baseTypeOptional(HasInstructions, false)
+  instructions: string;
+
+  /** Optional RP-specific reference to an underlying model deployment. */
+  @baseTypeOptional(HasModelDeploymentRef, false)
+  modelDeploymentRef?: string;
+}
+
+// ============================================================================
+// Agent Properties (resource property bag)
+// ============================================================================
+
+/**
+ * Required properties for an agent resource.
+ * This model is used only as a constraint for template parameters.
+ */
+internal model AgentProperties {
+  /** ARM-managed. Must include the base type descriptor for this resource. */
+  @visibility(Lifecycle.Read)
+  baseTypes: BaseTypeInfo[];
+
+  /** Human-friendly name. */
+  displayName: string;
+
+  /** Purpose/behavior summary. */
+  description: string;
+
+  /** Inline agent definition (must extend AgentDefinition). */
+  definition: AgentDefinition;
+}
+
+/**
+ * Appliance deployment model of AgentProperties.
+ * All properties are read-only (the appliance owns and reports state).
+ * @template AgentDefinitionType The user-defined agent definition model (must extend AgentDefinition).
+ */
+model AgentPropertiesAppliance<AgentDefinitionType extends AgentDefinition> {
+  /** ARM-managed. Must include the base type descriptor for this resource. */
+  @visibility(Lifecycle.Read)
+  baseTypes: BaseTypeInfo[];
+
+  /** Human-friendly name. */
+  @visibility(Lifecycle.Read)
+  displayName: string;
+
+  /** Purpose/behavior summary. */
+  @visibility(Lifecycle.Read)
+  description: string;
+
+  /** Inline agent definition. */
+  @visibility(Lifecycle.Read)
+  definition: AgentDefinitionType;
+
+  /** Tool bindings. Read-only in the Appliance deployment model. */
+  @visibility(Lifecycle.Read)
+  tools?: AgentToolTypeAppliance[];
+}
+
+/**
+ * Platform deployment model of AgentProperties.
+ * Properties have default visibility (the client owns these fields).
+ * baseTypes remains ARM-managed and read-only.
+ * @template AgentDefinitionType The user-defined agent definition model (must extend AgentDefinition).
+ */
+model AgentPropertiesPlatform<AgentDefinitionType extends AgentDefinition> {
+  /** ARM-managed. Must include the base type descriptor for this resource. */
+  @visibility(Lifecycle.Read)
+  baseTypes: BaseTypeInfo[];
+
+  /** Human-friendly name. */
+  displayName: string;
+
+  /** Purpose/behavior summary. */
+  description: string;
+
+  /** Inline agent definition. */
+  definition: AgentDefinitionType;
+
+  /** Tool bindings. Writable in the Platform deployment model. */
+  tools?: AgentToolTypePlatform[];
+}
+
+// ============================================================================
+// Conversation Types
+// ============================================================================
+
+/**
+ * Properties for a conversation resource holding the items and metadata
+ * exchanged between a client and an agent.
+ */
+model ConversationProperties {
+  /** Unique conversation identifier. Read-only (set by the service on creation). */
+  @visibility(Lifecycle.Read)
+  conversationId?: string;
+
+  /** Timestamp of when the conversation was created. Read-only. */
+  @visibility(Lifecycle.Read)
+  createdAt?: unixTimestamp32;
+}
+
+/**
+ * A single input message provided to the model.
+ */
+model InputMessage {
+  /** The role of the message author (for example, user, system, or developer). */
+  role: string;
+
+  /** The content of the input message. */
+  content: string;
+}
+
+/** Mix-in for input type discriminator. */
+model InputTypeProperty {
+  /** The input type discriminator. */
+  type?: string = "message";
+}
+
+/** Output from a conversation. */
+model ConversationOutput {
+  /** The output identifier. */
+  id: string;
+}
+
+// ============================================================================
+// Response Types
+// ============================================================================
+
+/**
+ * The status of a response.
+ */
+@Azure.Core.lroStatus
+union ResponseStatus {
+  /** The response completed successfully. */
+  @Azure.Core.lroSucceeded
+  Completed: "completed",
+
+  /** The response failed. */
+  @Azure.Core.lroFailed
+  Failed: "failed",
+
+  /** The response was cancelled. */
+  @Azure.Core.lroCanceled
+  Cancelled: "cancelled",
+
+  /** The response is incomplete. */
+  Incomplete: "incomplete",
+
+  /** The response is queued for execution. */
+  Queued: "queued",
+
+  /** The response is in progress. */
+  InProgress: "in_progress",
+
+  string,
+}
+
+/**
+ * Properties for a response generated by an agent for a given input,
+ * including its output, status, and usage.
+ */
+model ResponseProperties {
+  /** Unique response identifier. Read-only (set by the service). */
+  @visibility(Lifecycle.Read)
+  responseId?: string;
+
+  /** Timestamp of when the response was created. Read-only. */
+  @visibility(Lifecycle.Read)
+  createdAt?: unixTimestamp32;
+
+  /** Model ID used to generate the response. May be specified on request to override the agent default; read-only in GET. */
+  `model`?: string;
+
+  /** The status of the response. Read-only. */
+  @visibility(Lifecycle.Read)
+  status?: ResponseStatus;
+
+  /** Content input to the model. Required on create. */
+  input: InputMessage;
+}
+
+/**
+ * An item produced in the response output, such as a message or tool call.
+ */
+model ResponseOutputItem {
+  /** Unique identifier of the output item. */
+  @visibility(Lifecycle.Read)
+  id?: string;
+
+  /** The output item type (for example, message or tool call). */
+  @visibility(Lifecycle.Read)
+  type?: string;
+
+  /** The role associated with the output item. */
+  @visibility(Lifecycle.Read)
+  role?: string;
+
+  /** The status of the output item. */
+  @visibility(Lifecycle.Read)
+  status?: ResponseStatus;
+
+  /** The content of the output item. */
+  @visibility(Lifecycle.Read)
+  content?: string;
+}
+
+/** Mix-in for the output property. */
+model ResponseOutputProperty {
+  /** Output items (messages, tool calls, etc.). Read-only. */
+  @visibility(Lifecycle.Read)
+  output: ResponseOutputItem[];
+}
+
+/** Mix-in for the previousResponseId property. */
+model PreviousResponseProperty {
+  /** ID of a previous response for multi-turn chaining. Writable on create. */
+  previousResponseId?: string;
+}
+
+/** Mix-in for response instructions. */
+model ResponseInstructionsProperty {
+  /** System/developer message for this response. Writable on create; overrides agent-level instructions for this invocation. */
+  instructions?: string;
+}
+
+// ============================================================================
+// Resource Templates
+// ============================================================================
+
+/**
+ * Model template for an Agent tracked resource.
+ * Applies the Agent base type decorator automatically.
+ * @template Properties RP-specific properties for the agent (must extend AgentProperties)
+ */
+@azureBaseType(#{ baseType: "Agent", version: "2024-06-01" })
+model Agent<Properties extends AgentProperties> is TrackedResource<Properties>;
+
+/**
+ * Model template for a Conversation child resource of an Agent.
+ * @template Properties RP-specific properties for the conversation (must extend ConversationProperties)
+ * @template AgentResource The parent Agent resource type
+ */
+@parentResource(AgentResource)
+model AgentConversation<
+  Properties extends ConversationProperties,
+  AgentResource extends Foundations.Resource
+> is ProxyResource<Properties>;
+
+/**
+ * Model template for a Response child resource of an Agent.
+ * @template Properties RP-specific properties for the response (must extend ResponseProperties)
+ * @template AgentResource The parent Agent resource type
+ */
+@parentResource(AgentResource)
+model AgentResponse<
+  Properties extends ResponseProperties,
+  AgentResource extends Foundations.Resource
+> is ProxyResource<Properties>;